GLGENTEXTURES(3G)

🌸 NAME 🌸

okay so bestie, this is glGenTextures from the GLGENTEXTURES(3G) manual page β€” yes, section 3G, and the header is lowkey giving [FIXME: manual] placeholder realness πŸ’…. The whole point: glGenTextures - generate texture names. Periodt. Slay. ✨

✨ C SPECIFICATION ✨

void glGenTextures(GLsizei n, GLuint * textures);

πŸŽ€ PARAMETERS πŸŽ€

  • n β€” specifies the number of texture names to be generated. It's the "how many, bestie" number.
  • textures β€” specifies an array in which the generated texture names are stored. This is where the generated names get dropped. 🫢

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so glGenTextures gives you n texture names in textures. Big vibe check: there is no guarantee that the names form a contiguous set of integers β€” they don't have to be a cute little 1, 2, 3, 4 run. But it is guaranteed that none of the returned names was in use immediately before the call to glGenTextures. No cap, that part is stated. πŸ”₯

Generated textures start with no dimensionality. They assume the dimensionality of the texture target to which they are first bound (see glBindTexture()). It's giving "I'll figure out my whole personality after you bind me" energy 😭.

Texture names returned by a call to glGenTextures are not returned by subsequent calls, unless they are first deleted with glDeleteTextures(). So don't expect the same names to come back later β€” they're literally taken until you delete them. πŸŽ€

πŸ’€ ERRORS πŸ’€

  • GL_INVALID_VALUE is generated if n is negative. That's the only error listed, bestie β€” negative n fails the vibe check, fr fr. πŸ’…

πŸ” ASSOCIATED GETS πŸ”

  • glIsTexture() β€” iykyk, that's the associated get.

πŸ‘‘ VERSION SUPPORT πŸ‘‘

Version vibe check, bestie: the function/feature name is glGenTextures, and it is supported in every OpenGL version listed here. All the checkmarks ate, no skips β€” highkey iconic. ✨

  • glGenTextures β€” OpenGL 2.0 βœ”, 2.1 βœ”, 3.0 βœ”, 3.1 βœ”, 3.2 βœ”, 3.3 βœ”, 4.0 βœ”, 4.1 βœ”, 4.2 βœ”, 4.3 βœ”, 4.4 βœ”, 4.5 βœ”.

🌈 SEE ALSO 🌈

  • glBindTexture()
  • glCopyTexImage1D()
  • glCopyTexImage2D()
  • glDeleteTextures()
  • glGet()
  • glGetTexParameter()
  • glTexImage1D()
  • glTexImage2D()
  • glTexImage3D()
  • glTexParameter()

Copyright Β© 1991-2006 Silicon Graphics, Inc. Copyright Β© 2010-2014 Khronos Group.

This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

Copyright Β© 1991-2006 Silicon Graphics, Inc.

Copyright Β© 2010-2014 Khronos Group

okay that's the whole page! final sign-off vibes: source/version [FIXME: source], date 08/09/2021, title GLGENTEXTURES(3G) β€” ngl, mwah πŸ’‹βœ¨

πŸ“¦ where this page comes from