GLCREATEFRAMEBUFFERS(3G)

πŸ’… GLCREATEFRAMEBUFFERS(3G) β€” the "make me some framebuffers" page

okay bestie so this is GLCREATEFRAMEBUFFERS(3G), and it lives in the [FIXME: manual] manual (yes the manual name is literally [FIXME: manual], we don't ask questions, we just vibe). This is your girl explaining how to birth brand-new framebuffer objects into the world. ✨


🌸 NAME 🌸

glCreateFramebuffers β€” create framebuffer objects. that's it. that's the whole name. iconic of it honestly.


πŸŽ€ C SPECIFICATION πŸŽ€

like, the literal signature, don't touch it:

void glCreateFramebuffers(GLsizei n, GLuint *framebuffers);

πŸ¦‹ PARAMETERS πŸ¦‹

  • n β€” how many framebuffer objects you want to create. the count. the amount. the number of little guys you're bringing into existence πŸ’–
  • framebuffers β€” an array where the names of your shiny new framebuffer objects get stored. it's giving "output goes here," main character energy.

✨ DESCRIPTION ✨

okay so here's the tea πŸ“: glCreateFramebuffers hands you back n previously unused framebuffer names, dropped straight into framebuffers, and each one represents a brand-new framebuffer object that's initialized to the default state. fresh out the box. no cap. 🫢


πŸ’€ ERRORS πŸ’€

  • GL_INVALID_VALUE is generated if n is negative.

like bestie. you cannot make a negative number of framebuffers. that's not a thing. don't do that. 😭


πŸ‘‘ VERSION SUPPORT πŸ‘‘

listen, I know manpages love a table, but we're doing this cute instead. here's the vibe check across every OpenGL version, 2.0 all the way to 4.5:

  • OpenGL 2.0 β€” - (nope)
  • OpenGL 2.1 β€” - (nope)
  • OpenGL 3.0 β€” - (nope)
  • OpenGL 3.1 β€” - (nope)
  • OpenGL 3.2 β€” - (nope)
  • OpenGL 3.3 β€” - (nope)
  • OpenGL 4.0 β€” - (nope)
  • OpenGL 4.1 β€” - (nope)
  • OpenGL 4.2 β€” - (nope)
  • OpenGL 4.3 β€” - (nope)
  • OpenGL 4.4 β€” - (nope)
  • OpenGL 4.5 β€” βœ” (yes bestie, this one's the moment πŸ”₯)

so for the function glCreateFramebuffers, it's a 4.5-only situation. everything before that? not invited to the party. periodt. πŸ’…


🌈 SEE ALSO 🌈

go read these next, iykyk:

  • glGenFramebuffers()
  • glBindFramebuffer()
  • glFramebufferRenderbuffer()
  • glFramebufferTexture()
  • glFramebufferTexture1D
  • glFramebufferTexture2D
  • glFramebufferTexture3D
  • glFramebufferTextureLayer()
  • glDeleteFramebuffers()
  • glIsFramebuffer()

gotta give credit where it's due, no plagiarism here:

Copyright Β© 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 they really meant it:

Copyright Β© 2014 Khronos Group

aaaand that's the whole page bestie πŸŽ€ mwah. this was [FIXME: source], dated 08/09/2021, and you've been reading GLCREATEFRAMEBUFFERS(3G) β€” go forth and glCreateFramebuffers responsibly, ily πŸ’œπŸ¦‹

πŸ“¦ where this page comes from