GLGENSAMPLERS(3G)

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

✨ NAME ✨

glGenSamplers — generate sampler object names. And yes bestie, you clocked it: this is the GLGENSAMPLERS(3G) manual page, and we're gonna get through it together 💅✨

💻 C SPECIFICATION 💻

void glGenSamplers(GLsizei n, GLuint *samplers);

🎀 PARAMETERS 🎀

  • n — the number of sampler object names you want to generate. Simple as that, no cap 🫶
  • samplers — the array where the generated sampler object names get stored. Basically the lil basket you're putting the names into 🧺✨

🌸 DESCRIPTION 🌸

Okay so glGenSamplers returns n sampler object names in samplers. And listen — there is no guarantee that those names form a contiguous set of integers. Like, they don't have to be all cute and sequential. However, it is guaranteed that none of the returned names was in use immediately before the call to glGenSamplers — so no accidental recycling of a name that was already taken, periodt 🔥

Sampler object names returned by a call to glGenSamplers are not returned by subsequent calls, unless they are first deleted with glDeleteSamplers(). So if you want a name back in the pool, you gotta delete it first, bestie 🗑️✨

The names returned in samplers are marked as used, for the purposes of glGenSamplers only, but they acquire state and type only when they are first bound. So they're like reserved seats at the function, not fully main-character yet 👑🪑💫

📝 NOTES 📝

glGenSamplers is available only if the GL version is 3.3 or higher. Older GL? Not invited to this party, sorry bestie 😭🙈

💀 ERRORS 💀

GL_INVALID_VALUE is generated if n is negative. So yeah, don't pass a negative number unless you're actively trying to summon an error 💀✨

🌈 VERSION SUPPORT 🌈

The support table is giving very "who's invited to the OpenGL version party" energy. Here's the invite list, preserved in full 🎀

  • OpenGL Version columns: 2.0, 2.1, 3.0, 3.1, 3.2, 3.3, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5
  • Function / Feature Name: glGenSamplers
    • 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 🦋

Go bother glBindSampler(), glIsSampler(), and glDeleteSamplers() — they're all in the group chat together 🫶💬

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/.

Copyright © 2010-2014 Khronos Group.

Sign-off time, bestie: the source/version tag is [FIXME: source], the date is 08/09/2021, and the manual is GLGENSAMPLERS(3G) — bye and drink some water 💖💅✨

📦 where this page comes from