GLPROGRAMPARAMETER(3G)

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

🌸 NAME 🌸

glProgramParameter — specify a parameter for a program object.

okay bestie, welcome to the GLPROGRAMPARAMETER(3G) manual page — manual name: 3G, and yes the header has [FIXME: manual] energy 💀. This is the whole vibe: one function, its parameters, and the tea on program objects ✨💖

💖 C SPECIFICATION 💖

void glProgramParameteri(GLuint program, GLenum pname, GLint value);

🎀 PARAMETERS 🎀

  • program — specifies the name of a program object whose parameter to modify. like, which program object are we editing? that one 🫶
  • pname — specifies the name of the parameter to modify. the actual setting we're touching, periodt 💅
  • value — specifies the new value of the parameter specified by pname for program. the new setting bestie, no cap ✨

🦋 DESCRIPTION 🦋

okay so glProgramParameter specifies a new value for the parameter nameed by pname for the program object program — and yes, the manpage says nameed, we are not fixing the typo, we are respecting the lore 😭💀

If pname is GL_PROGRAM_BINARY_RETRIEVABLE_HINT, value should be GL_FALSE or GL_TRUE to indicate to the implementation the intention of the application to retrieve the program's binary representation with glGetProgramBinary(). The implementation may use this information to store information that may be useful for a future query of the program's binary. It is recommended to set GL_PROGRAM_BINARY_RETRIEVABLE_HINT for the program to GL_TRUE before calling glLinkProgram(), and using the program at run-time if the binary is to be retrieved later. literally the "hey bestie I might want the binary later" hint 🎀✨

If pname is GL_PROGRAM_SEPARABLE, value must be GL_TRUE or GL_FALSE and indicates whether program can be bound to individual pipeline stages via glUseProgramStages(). A program's GL_PROGRAM_SEPARABLE parameter must be set to GL_TRUE before glLinkProgram() is called in order for it to be usable with a program pipeline object. The initial state of GL_PROGRAM_SEPARABLE is GL_FALSE. so if you want that pipeline-object main character energy, set it before linking, iykyk 💅🔥

🚨 ERRORS 🚨

  • GL_INVALID_OPERATION is generated if program is not the name of an existing program object. not me trying to edit a program object that doesn't exist 😭
  • GL_INVALID_ENUM is generated if pname is not one of the accepted values. wrong parameter name, bestie, denied 💀
  • GL_INVALID_VALUE is generated if value is not a valid value for the parameter named by pname. the value said "not today" 🙈

👀 ASSOCIATED GETS 👀

glGetProgram().

⭐ VERSION SUPPORT ⭐

the version vibe check for glProgramParameteri is literally this:

  • OpenGL 2.0: -
  • OpenGL 2.1: -
  • OpenGL 3.0: -
  • OpenGL 3.1: -
  • OpenGL 3.2: -
  • OpenGL 3.3: -
  • OpenGL 4.0: -
  • OpenGL 4.1: ✔
  • OpenGL 4.2: ✔
  • OpenGL 4.3: ✔
  • OpenGL 4.4: ✔
  • OpenGL 4.5: ✔

so glProgramParameteri ate from 4.1 onward and before that it was a no-show, periodt 💅✨

🔗 SEE ALSO 🔗

glGetProgram(), glGetProgramBinary(), glProgramBinary()

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

xoxo, source: [FIXME: source] — version/date: 08/09/2021 — manual: GLPROGRAMPARAMETER(3G) 💖🫶✨

📦 where this page comes from