GLPOINTSIZE(3G)

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

💖 GLPOINTSIZE (3G) 💖

okay bestie, so this one's from the 3G manual section — yeah, the OpenGL one — and it's literally just about making your points bigger or smaller. one function, one float, so much slay potential. let's go ✨

🎀 NAME 🎀

glPointSize — specify the diameter of rasterized points

no cap, that's the whole job description. she sets the diameter, she minds her business 💅

🌸 C SPECIFICATION 🌸

void glPointSize(GLfloat size);

that's it. that's the girl. one GLfloat, one dream 🦋

💜 PARAMETERS 💜

  • size — specifies the diameter of rasterized points. the initial value is 1. and yes, that's the starting number before you come in and start messing with it 🙈

✨ DESCRIPTION ✨

so, glPointSize specifies the rasterized diameter of points. like, the actual size of the little dots once they hit the screen 💫

here's the tea though — it depends on point size mode, so pay attention:

  • if point size mode is disabled (check out glEnable() with parameter GL_PROGRAM_POINT_SIZE), then this size value is the one that gets used to rasterize points.
  • otherwise — meaning the mode is enabled — the value written to the shading language built-in variable gl_PointSize is what gets used instead.

so like, your glPointSize call is lowkey just the backup plan in that second case. iykyk 😭

🦋 NOTES 🦋

  • the point size you specified with glPointSize is always returned when GL_POINT_SIZE is queried. always. she's consistent 👑
  • clamping and rounding for points have no effect on the specified value. none. zero. the value lives exactly as you left it, periodt ✨

🔥 ERRORS 🔥

  • GL_INVALID_VALUE is generated if size is less than or equal to 0. so like... don't pass zero. don't pass negative. that's the vibe check she fails 💀

🌈 ASSOCIATED GETS 🌈

  • glGet() with argument GL_POINT_SIZE_RANGE
  • glGet() with argument GL_POINT_SIZE_GRANULARITY
  • glGet() with argument GL_POINT_SIZE
  • glGet() with argument GL_POINT_FADE_THRESHOLD_SIZE
  • glIsEnabled() with argument GL_PROGRAM_POINT_SIZE

all the receipts you could ever want 🧾💖

⭐ VERSION SUPPORT ⭐

okay so the original had this big cute grid with Function / Feature Name down the side, OpenGL Version across the top, versions 2.0, 2.1, 3.0, 3.1, 3.2, 3.3, 4.0, 4.1, 4.2, 4.3, 4.4, 4.5 — and glPointSize is a check mark ✔ in every single one of them. she ate and left no crumbs 👑

  • glPointSize — ✔ 2.0
  • glPointSize — ✔ 2.1
  • glPointSize — ✔ 3.0
  • glPointSize — ✔ 3.1
  • glPointSize — ✔ 3.2
  • glPointSize — ✔ 3.3
  • glPointSize — ✔ 4.0
  • glPointSize — ✔ 4.1
  • glPointSize — ✔ 4.2
  • glPointSize — ✔ 4.3
  • glPointSize — ✔ 4.4
  • glPointSize — ✔ 4.5

twelve for twelve, literally iconic 🌟

💫 SEE ALSO 💫

  • glEnable()
  • glPointParameter()

go read those next, bestie, they're the friend group 🫶

Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2014 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.

and then, because they really wanted you to remember it, here it is again:

Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2014 Khronos Group

lowkey warning bestie: size less than or equal to 0 → GL_INVALID_VALUE. no exceptions, no mercy 💀

okay that's the whole page, mwah 💋 — this cutie came from [FIXME: source], stamped 08/09/2021, and yes she's still GLPOINTSIZE(3G). go forth and size those points, queen 🌸👑💖

📦 where this page comes from