GLBINDTEXTURES(3G)

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

✨ GLBINDTEXTURES ✨

Okay bestie, so this is the manual for glBindTextures from the OpenGL family — it's giving "level up your texture game" energy and honestly? Iconic. 💅

It binds one or more named textures to a sequence of consecutive texture units. Let's get into it. 🫶

📜 C SPECIFICATION 📜

void glBindTextures(GLuint first, GLsizei count,
                    const GLuint *textures);

🎀 PARAMETERS 🎀

  • first — the first texture unit you're binding a texture to. Like, where the party starts. 🎉
  • count — how many textures you're binding. The guest list size, basically.
  • textures — the address of an array of names of existing texture objects. Not new names, existing ones — remember that, it matters later. 😭

💖 DESCRIPTION 💖

So glBindTextures binds an array of existing texture objects to a specified number of consecutive texture units. count tells it how many texture objects have their names chillin' in the array textures. That many texture names get read from the array and bound to the count consecutive texture units starting from first. The target (aka the type of texture) is deduced from the texture object itself, and each texture gets bound to the corresponding target of the texture unit. It's doing the detective work for you, slay. 🔍✨

If the name zero appears in the textures array, any existing binding to any target of that texture unit is reset and the default texture for that target is bound in its place. Zero means "clear the vibes," basically. Any non-zero entry in textures must be the name of an existing texture object — no cap, that's the rule. If textures is NULL then it's as if an appropriately sized array containing only zeros had been specified. Ghosting all of them at once. 💀

With the exception that the active texture selector maintains its current value, glBindTextures is equivalent to this pseudo code:

for (i = 0; i < count; i++) {
    GLuint texture;
    if (textures == NULL) {
        texture = 0;
    } else {
        texture = textures[i];
    }
    glActiveTexture(GL_TEXTURE0 + first + i);
    if (texture != 0) {
        GLenum target = /* target of textures[i] */;
        glBindTexture(target, textures[i]);
    } else {
        for (target in all supported targets) {
            glBindTexture(target, 0);
        }
    }
}

Each entry in textures gets checked individually, and if it's found to be invalid, the state for that texture unit will not be changed and an error will be generated. But here's the tea: the state for the other texture units referenced by the command will still be updated. So one bad apple doesn't ruin the whole batch. 🍎✨

👑 NOTES 👑

glBindTextures is available only if the GL version is 4.4 or higher. Older GL? Sorry bestie, not invited to this party. 🙈

Also important: because glBindTextures cannot create new textures (even if a name passed has been previously generated by a call to glGenTextures()), names passed to glBindTextures must have been bound at least once previously via a call to glBindTexture(). Generating a name is not the same as actually binding it — don't let that trip you up, fr fr. 😤

💀 ERRORS 💀

  • GL_INVALID_OPERATION is generated if first + count is greater than the number of texture image units supported by the implementation. You overshot the texture units, babe. 😭
  • GL_INVALID_OPERATION is generated if any value in textures is not zero or the name of an existing texture object. Random number? Not a vibe. Blocked. 🚫

🔍 ASSOCIATED GETS 🔍

glGet() with argument GL_TEXTURE_BINDING_1D, GL_TEXTURE_BINDING_2D, GL_TEXTURE_BINDING_3D, GL_TEXTURE_BINDING_1D_ARRAY, GL_TEXTURE_BINDING_2D_ARRAY, GL_TEXTURE_BINDING_RECTANGLE, GL_TEXTURE_BINDING_BUFFER, GL_TEXTURE_BINDING_CUBE_MAP, GL_TEXTURE_BINDING_CUBE_MAP, GL_TEXTURE_BINDING_CUBE_MAP_ARRAY, GL_TEXTURE_BINDING_2D_MULTISAMPLE, or GL_TEXTURE_BINDING_2D_MULTISAMPLE_ARRAY. That's the full roster, bestie — collect them all. 🌈

(Yes, GL_TEXTURE_BINDING_CUBE_MAP is listed twice in the original. We don't question the ancients. We just vibe. 🧚)

🌟 VERSION SUPPORT 🌟

glBindTextures said "not today" to everything before 4.4. Here's the vibe check:

┌────────────────┬───────────────────────────────────────────────────────────────┐
│                │                OpenGL Version                                 │
├────────────────┼─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┬─────┤
│ Function       │ 2.0 │ 2.1 │ 3.0 │ 3.1 │ 3.2 │ 3.3 │ 4.0 │ 4.1 │ 4.2 │ 4.3 │ 4.4 │ 4.5 │
│ /              │     │     │     │     │     │     │     │     │     │     │     │     │
│ Feature        │     │     │     │     │     │     │     │     │     │     │     │     │
│ Name           │     │     │     │     │     │     │     │     │     │     │     │     │
├────────────────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┼─────┤
│ glBindTextures │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  -  │  ✔  │  ✔  │
└────────────────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┴─────┘

Two glorious checkmarks and a whole lot of dashes. 4.4 and 4.5 only, periodt. 💅

🦋 SEE ALSO 🦋

glBindTexture(), glDeleteTextures(), glGenTextures(), glGet(), glGetTexParameter(), glIsTexture(), glTexImage1D(), glTexImage2D(), glTexImage2DMultisample(), glTexImage3D(), glTexImage3DMultisample(), glTexBuffer(), glTexParameter() — go read up on these too, iykyk. 📚✨

Copyright © 2013-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/.

Also, again, just to make it crystal clear: Copyright © 2013-2014 Khronos Group. 💜

Okay that's the whole thing! Manual source was a big ol' [FIXME: source] (lol) and this version was dated 08/09/2021. Love that journey for us. Go bind those textures, bestie — you're the main character now. 🎀👑✨💖
📦 where this page comes from