GLGETHISTOGRAMPARAMETER(3G)

✨ GLGETHISTOGRAMPARAMETER ✨

okay bestie, welcome to GLGETHISTOGRAMPARAMETER(3G) 💖 this is the section 3G glow-up of your fave little query function — it's how you peek at histogram parameters without touching anything. no cap, it's giving "tell me everything but don't change a thing" 👑

---

🌸 NAME 🌸

glGetHistogramParameterfv, glGetHistogramParameteriv — get histogram parameters 🎀

---

🦋 C SPECIFICATION 🦋

void glGetHistogramParameterfv( GLenum target,
                                GLenum pname,
                                GLfloat *params )
void glGetHistogramParameteriv( GLenum target,
                                GLenum pname,
                                GLint *params )

two flavors, same energy: one hands you GLfloats, the other hands you GLints. pick your fighter 💅

---

💜 PARAMETERS 💜

• target — has to be one of GL_HISTOGRAM or GL_PROXY_HISTOGRAM. those are the only two vibes allowed here.
• pname — the name of the parameter you're trying to pull. must be one of GL_HISTOGRAM_WIDTH, GL_HISTOGRAM_FORMAT, GL_HISTOGRAM_RED_SIZE, GL_HISTOGRAM_GREEN_SIZE, GL_HISTOGRAM_BLUE_SIZE, GL_HISTOGRAM_ALPHA_SIZE, GL_HISTOGRAM_LUMINANCE_SIZE, or GL_HISTOGRAM_SINK. literally that whole list, no substitutions 🫶
• params — a pointer to storage where the returned values go. you bring the bucket, it fills the bucket 🍓

---

🌈 DESCRIPTION 🌈

so glGetHistogramParameter is the girl who asks the questions. she queries parameter values for the current histogram or for a proxy — that's it, that's the job. ✨

you call her with a target of either:

• GL_HISTOGRAM — to obtain information for the current histogram table
• GL_PROXY_HISTOGRAM — to obtain information from the most recent proxy request

…and then one of these values for the pname argument 👇

• GL_HISTOGRAM_WIDTH — Histogram table width
• GL_HISTOGRAM_FORMAT — Internal
• GL_HISTOGRAM_RED_SIZE — Red component counter size, in bits
• GL_HISTOGRAM_GREEN_SIZE — Green component counter size, in bits
• GL_HISTOGRAM_BLUE_SIZE — Blue component counter size, in bits
• GL_HISTOGRAM_ALPHA_SIZE — Alpha component counter size, in bits
• GL_HISTOGRAM_LUMINANCE_SIZE — Luminance component counter size, in bits
• GL_HISTOGRAM_SINK — Value of the sink parameter

every single one of those, accounted for. the way that list just keeps going and every entry still matters 😭💖

---

🎀 NOTES 🎀

glGetHistogramParameter is present only if GL_ARB_imaging is returned when glGetString is called with an argument of GL_EXTENSIONS. so like… check first, bestie. don't come crying to me if it's not there 🙈

---

💀 ERRORS 💀

• GL_INVALID_ENUM is generated if target is not one of the allowable values. rude of you, honestly.
• GL_INVALID_ENUM is generated if pname is not one of the allowable values. also rude.
• GL_INVALID_OPERATION is generated if glGetHistogramParameter is executed between the execution of glBegin and the corresponding execution of glEnd. do NOT do that. that's the forbidden window, the no-fly zone, the "not me doing a query inside a glBegin/glEnd block" moment 😭

---

👑 SEE ALSO 👑

• glGetHistogram(3G)
• glHistogram(3G)

go read those too, they're iconic, iykyk 🌟

---

and that's the whole page, fr fr — this was GLGETHISTOGRAMPARAMETER(3G), the section 3G edition, brought to you by the fine folks who keep the man pages alive. slay, stay safe, and always check your target 💅✨🦋💜