GLRENDERBUFFERSTORAG(3G)

💅 GLRENDERBUFFERSTORAG(3G) — bestie edition

ok so first things first: this is a page from the 3G manual section (yep, the OpenGL one), and the header even has a lil [FIXME: manual] placeholder in it, which, honestly? iconic messy. anyways, buckle up 🎀

---

✨ NAME ✨

glRenderbufferStorage, glNamedRenderbufferStorage — establish data storage, format and dimensions of a renderbuffer object's image 🖼️

like literally, these two functions set up the actual storage for a renderbuffer's image, plus its format and its dimensions. that's the whole vibe.

---

🧾 C SPECIFICATION 🧾

no cap, here's the exact signatures, character for character:

void glRenderbufferStorage(GLenum target, GLenum internalformat,
                           GLsizei width, GLsizei height);

void glNamedRenderbufferStorage(GLuint renderbuffer,
                                GLenum internalformat, GLsizei width,
                                GLsizei height);

---

🌸 PARAMETERS 🌸

• target — specifies a binding target of the allocation for the glRenderbufferStorage function. must be GL_RENDERBUFFER. that's it, that's the only valid answer bestie 💅
• renderbuffer — specifies the name of the renderbuffer object for the glNamedRenderbufferStorage function. 👑
• internalformat — specifies the internal format to use for the renderbuffer object's image.
• width — specifies the width of the renderbuffer, in pixels. 📏
• height — specifies the height of the renderbuffer, in pixels. 📐

---

🦋 DESCRIPTION 🦋

ok so the tea ☕: glRenderbufferStorage is equivalent to calling glRenderbufferStorageMultisample() with the samples set to zero. and glNamedRenderbufferStorage is equivalent to calling glNamedRenderbufferStorageMultisample with the samples set to zero. so like, the multisample versions but with zero samples. slay, but make it single-sample ✨

for glRenderbufferStorage, the target of the operation, specified by target, must be GL_RENDERBUFFER. for glNamedRenderbufferStorage, renderbuffer must be a name of an existing renderbuffer object — like, it has to actually exist, no imaginary friends 🙈

internalformat specifies the internal format to be used for the renderbuffer object's storage, and it must be a color-renderable, depth-renderable, or stencil-renderable format. width and height are the dimensions, in pixels, of the renderbuffer. both width and height must be less than or equal to the value of GL_MAX_RENDERBUFFER_SIZE. respectfully, do not test this 🫶

upon success, glRenderbufferStorage and glNamedRenderbufferStorage delete any existing data store for the renderbuffer image, and the contents of the data store after calling glRenderbufferStorage are undefined. so yeah — the old data is gone gone, and what's in there after? nobody knows. mystery era 💀

---

💀 ERRORS 💀

here's where it gets real, bestie. these are the ways your call can fail:

• GL_INVALID_ENUM is generated by glRenderbufferStorage if target is not GL_RENDERBUFFER.
• GL_INVALID_OPERATION is generated by glNamedRenderbufferStorage if renderbuffer is not the name of an existing renderbuffer object.
• GL_INVALID_VALUE is generated if either of width or height is negative, or greater than the value of GL_MAX_RENDERBUFFER_SIZE. (negative pixels?? be so fr 😭)
• GL_INVALID_ENUM is generated if internalformat is not a color-renderable, depth-renderable, or stencil-renderable format.
• GL_OUT_OF_MEMORY is generated if the GL is unable to create a data store of the requested size.

---

🌈 VERSION SUPPORT 🌈

the original has this in a big grid — Function/Feature Name down the side, OpenGL Version 2.0 through 4.5 across the top — but grids are ugly in a terminal so here's the same info, gorgeous and readable 💖

glNamedRenderbufferStorage

• 2.0 — -
• 2.1 — -
• 3.0 — -
• 3.1 — -
• 3.2 — -
• 3.3 — -
• 4.0 — -
• 4.1 — -
• 4.2 — -
• 4.3 — -
• 4.4 — -
• 4.5 — ✔

like, it's a 4.5 only babe. it simply did not exist before then 🎀

glRenderbufferStorage

• 2.0 — -
• 2.1 — -
• 3.0 — ✔
• 3.1 — ✔
• 3.2 — ✔
• 3.3 — ✔
• 4.0 — ✔
• 4.1 — ✔
• 4.2 — ✔
• 4.3 — ✔
• 4.4 — ✔
• 4.5 — ✔

from 3.0 onward, it ate and left no crumbs 🔥

---

👀 SEE ALSO 👀

go read these next, iykyk:

• glGenRenderbuffers()
• glBindRenderbuffer()
• glNamedRenderbufferStorageMultisample
• glRenderbufferStorageMultisample()
• glFramebufferRenderbuffer()
• glDeleteRenderbuffers()

---

©️ COPYRIGHT ©️

Copyright © 2010-2014 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.

and again, because the page says it twice and i keep every detail, periodt:

Copyright © 2010-2014 Khronos Group

---

mwah 💋 that's the page!! the footer says [FIXME: source] and dates it 08/09/2021, and it's the GLRENDERBUFFERSTORAG(3G) page from your 3G manual. go forth and allocate responsibly, bestie 🫶✨