GLACTIVETEXTURE(3G)

📦
version 1.1 · 7 versions
, in centos-stream 9

✨ GLACTIVETEXTURE (3G) — the one where you pick your texture unit ✨

okay so real talk, this is page GLACTIVETEXTURE from manual section 3G, and it's genuinely one of the shorter ones but it's so important bestie, don't skip it 🫶

🌸 NAME 🌸

glActiveTexture — select the active texture unit. that's it. that's the whole job. iconic behavior honestly 💅

🎀 C SPECIFICATION 🎀

void glActiveTexture(GLenum texture);

like, that's the signature. memorise it. it's two words and a parameter, you've got this 💖

🦋 PARAMETERS 🦋

  • texture — which texture unit you're making the active one, bestie. the number of texture units is implementation dependent, but it must be at least 80. and texture has to be one of GL_TEXTUREi, where i ranges from zero all the way up to the value of GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS minus one. the initial value is GL_TEXTURE0 👑
fr fr, at least 80 texture units. your implementation might give you more, but it can never give you fewer. no cap.

💜 DESCRIPTION 💜

so glActiveTexture selects which texture unit all your subsequent texture state calls are gonna affect. it's the "who am I talking to right now" of OpenGL 🌈

the number of texture units an implementation supports is implementation dependent, but again — must be at least 80. got it? at least 80. always. 🧚

🔥 ERRORS 🔥

  • GL_INVALID_ENUM — gets generated if texture is not one of GL_TEXTUREi, where i ranges from zero to the value of GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS minus one. so like, if you colour outside the lines, it will yell at you 😭

🌟 ASSOCIATED GETS 🌟

  • glGet() with argument GL_ACTIVE_TEXTURE
  • glGet() with argument GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS

👑 VERSION SUPPORT 👑

the vibe check on this one: glActiveTexture shows up in every listed version, full sweep, ate and left no crumbs 💀✨

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

(it's the function row; the columns are 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 — and yes, that's a checkmark in every single one 🫶)

🍓 SEE ALSO 🍓

go read these next, bestie, they're all in the same friend group 💖

  • glGenTextures()
  • glBindTexture()
  • glCompressedTexImage1D()
  • glCompressedTexImage2D()
  • glCompressedTexImage3D()
  • glCompressedTexSubImage1D()
  • glCompressedTexSubImage2D()
  • glCompressedTexSubImage3D()
  • glCopyTexImage1D()
  • glCopyTexImage2D()
  • glCopyTexSubImage1D()
  • glCopyTexSubImage2D()
  • glCopyTexSubImage3D()
  • glDeleteTextures() glIsTexture()
  • glTexImage1D()
  • glTexImage2D()
  • glTexImage2DMultisample()
  • glTexImage3D()
  • glTexImage3DMultisample()
  • glTexSubImage1D()
  • glTexSubImage2D()
  • glTexSubImage3D()
  • 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/. (that's the license, don't lose it, it's important 🔒)

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

and that's the page!! source version is [FIXME: source], dated 08/09/2021, manual GLACTIVETEXTURE(3G) — so go forth and select your texture units responsibly, mwah 💋🌸✨

📦 where this page comes from