GLGETCOLORTABLEPARAMETER(3G)

💖 NAME 💖

glGetColorTableParameterfv, glGetColorTableParameteriv — bestie, these two are how you get your color lookup table parameters. That's the whole job. Pulling the tea out of a color table. 🫖✨

This one lives in the 3G manual, so you know it's GL business.

---

✨ C SPECIFICATION ✨

void glGetColorTableParameterfv( GLenum target,
                                 GLenum pname,
                                 GLfloat *params )
void glGetColorTableParameteriv( GLenum target,
                                 GLenum pname,
                                 GLint *params )

Notice the vibe: one takes GLfloat *, one takes GLint *. Same energy, different pointer. Pick your fighter. 💅

---

🎀 PARAMETERS 🎀

• target — which color table we're snooping on, queen. It must be one of: GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, GL_POST_COLOR_MATRIX_COLOR_TABLE, GL_PROXY_COLOR_TABLE, GL_PROXY_POST_CONVOLUTION_COLOR_TABLE, GL_PROXY_POST_COLOR_MATRIX_COLOR_TABLE. That's it, that's the list, no substitutes. 🙅‍♀️
• pname — the symbolic name of a color lookup table parameter, like the label on the lil container. It must be one of: GL_COLOR_TABLE_BIAS, GL_COLOR_TABLE_SCALE, GL_COLOR_TABLE_FORMAT, GL_COLOR_TABLE_WIDTH, GL_COLOR_TABLE_RED_SIZE, GL_COLOR_TABLE_GREEN_SIZE, GL_COLOR_TABLE_BLUE_SIZE, GL_COLOR_TABLE_ALPHA_SIZE, GL_COLOR_TABLE_LUMINANCE_SIZE, or GL_COLOR_TABLE_INTENSITY_SIZE.
• params — a pointer to an array where the values of the parameter get stored. Like, you hand it an empty lil box and it fills the box. 📦

---

🌸 DESCRIPTION 🌸

Returns parameters specific to target (a color table). Simple as that, fr fr.

When pname is set to GL_COLOR_TABLE_SCALE or GL_COLOR_TABLE_BIAS, glGetColorTableParameter returns the color table scale or bias parameters for the table specified by target. For these queries, target must be set to GL_COLOR_TABLE, GL_POST_CONVOLUTION_COLOR_TABLE, or GL_POST_COLOR_MATRIX_COLOR_TABLE, and params points to an array of four elements, which receive the scale or bias factors for red, green, blue, and alpha — in that order. Order matters bestie, don't scramble the alphabet of colors. 🌈

glGetColorTableParameter can also be used to retrieve the (there is literally a gap in the original text here, no cap — a word got lost in the source, so I'm leaving the gap right where it is) and size parameters for a color table. For these queries, set target to either the color table target or the proxy color table target. The and size parameters are set by glColorTable.

The following table lists the and size parameters that may be queried. For each symbolic constant listed below for pname, params must point to an array of the given length, and receive the values indicated. 👑

• GL_COLOR_TABLE_FORMAT — N = 1 — Internal (e.g. GL_RGBA)
• GL_COLOR_TABLE_WIDTH — N = 1 — Number of elements in table
• GL_COLOR_TABLE_RED_SIZE — N = 1 — Size of red component, in bits
• GL_COLOR_TABLE_GREEN_SIZE — N = 1 — Size of green component
• GL_COLOR_TABLE_BLUE_SIZE — N = 1 — Size of blue component
• GL_COLOR_TABLE_ALPHA_SIZE — N = 1 — Size of alpha component
• GL_COLOR_TABLE_LUMINANCE_SIZE — N = 1 — Size of luminance component
• GL_COLOR_TABLE_INTENSITY_SIZE — N = 1 — Size of intensity component

(Yes, every single one of them is N = 1. Eight constants, eight lonely lil 1s. Consistent queen behavior. 💅)

---

💀 NOTES 💀

glGetColorTableParameter is present only if GL_ARB_imaging shows up when glGetString is called with an argument of GL_EXTENSIONS. So like, vibe check your extensions first or this whole thing is just a rumor. 🔍

---

🚨 ERRORS 🚨

• GL_INVALID_ENUM is generated if target or pname is not an acceptable value. Wrong name, no game. 🙈
• GL_INVALID_OPERATION is generated if glGetColorTableParameter is executed between the execution of glBegin and the corresponding execution of glEnd. Do not try this inside a glBegin/glEnd sandwich, it will not slay, it will just error at you. 😭

---

👀 SEE ALSO 👀

glColorTable(3G), glTexParameter(3G), glColorTableParameter(3G)

---

Okay that's the whole page bestie, go forth and query your color tables responsibly. 🦋

Signing off from the GLGETCOLORTABLEPARAMETER(3G) page — that's the 3G manual name up top and down at the bottom, no date and no version number in sight, just the title doing its lil cameo twice. Iconic, honestly. 💜✨