GLUTDEVICEGET(3)

💖 glutDeviceGet — the manual page, but make it cute 💖

okay bestie, welcome to glutDeviceGet from the OpenGLUT manual (section 3, the inputstate corner of the library 🫶). This is the girl who tells you what your devices are doing. Let's get into it ✨

---

🌈 LIBRARY 🌈

OpenGLUT — specifically the inputstate part of it. she lives there 💅

---

✨ SYNOPSIS ✨

#include <openglut.h>

int
glutDeviceGet(GLenum eWhat);

like, one function, one arg, so simple, iconic behavior honestly 👑

---

🎀 PARAMETERS 🎀

• eWhat — the enumerated parameter ID. basically you're telling her which device question you want answered. pick your fighter 🎯

---

💅 DESCRIPTION 💅

So the vibe is: you call her, she goes and fetches system-specific info about the devices attached to your machine. She's nosy in the best way. Here are all the device queries she supports, no cap, all of them:

• GLUT_HAS_JOYSTICK — returns non-zero if there's a joystick. 🕹️
• GLUT_HAS_KEYBOARD — returns non-zero if there's a keyboard. ⌨️
• GLUT_HAS_MOUSE — returns non-zero if there's a mouse. 🐭
• GLUT_HAS_SPACEBALL — returns non-zero if there's a spaceball. 🪐
• GLUT_JOYSTICK_AXES — returns the number of axes the joystick has.
• GLUT_JOYSTICK_POLL_RATE — returns the rate (in GLUT timer ticks?) at which the joystick is polled. yes bestie, the question mark is in the original, she's unsure too 😭
• GLUT_NUM_MOUSE_BUTTONS — returns how many buttons the user's mouse has. click click click 🖱️
• GLUT_OWNS_JOYSTICK — returns non-zero if OpenGLUT believes it has successfully acquired access to the joystick. manifesting that ownership fr fr ✨
• GLUT_DEVICE_IGNORE_KEY_REPEAT — returns non-zero if the current window is set to disable key repeating.
• GLUT_DEVICE_KEY_REPEAT — described as returning the key repeat rate in one place, but actually returns a key repeat mode. the way she lied a little 🙈
• GLUT_HAS_DIAL_AND_BUTTON_BOX — returns non-zero if a dials-and-buttons box is present.
• GLUT_HAS_TABLET — returns non-zero if a tablet is present. ✍️
• GLUT_NUM_BUTTON_BOX_BUTTONS — returns the number of buttons on a dials-and-buttons box, if any.
• GLUT_NUM_DIALS — returns the number of dials on a dials-and-buttons box, if any.
• GLUT_NUM_SPACEBALL_BUTTONS — returns the number of buttons on a spaceball, if any.
• GLUT_NUM_TABLET_BUTTONS — returns the number of buttons on a tablet, if any.

---

🌸 TODO 🌸

stuff she knows she needs to work on, and honestly, growth 💜

• Only supports querying for one joystick. one. singular. monogamous joystick energy.
• Consider moving to a table-based approach rather than a switch(), letting us move to modular functions. glow-up pending ✨

---

💀 BUGS 💀

okay girlies, sit down, this is the part where we're honest:

• Keyboards are optional, but OpenGLUT doesn't detect their absence. she just assumes. bold of her.
• Mice are optional, but OpenGLUT is only able to check for them under WIN32.
• Mice can have a varying number of buttons, but OpenGLUT assumes exactly 3 on UNIX_X11. exactly three. no more, no less, apparently. 😭
• Not all joystick queries are implemented yet. WIP, we love a WIP 🚧
• GLUT_DEVICE_KEY_REPEAT returns the key repeat mode, but the comment says it returns the rate. the comment is lying bestie, iykyk 🙈
• Some things, like joystick poll rates, seem to have insufficient context. Which joystick? Which window? Maybe we assume the current window and the current joystick (or the first one)? she's asking the real questions 🤔
• GLUT_DEVICE_KEY_REPEAT should probably return ogState.KeyRepeat. just saying. put it on the vision board 📝

---

🦋 SEE ALSO 🦋

• glutSetOption(3)
• glutGet(3)
• glutGetModifiers(3)
• glutLayerGet(3)

---

k bye bestie, that's the whole page 💖 this one came out UNDATED and honestly the title field is just UNTITLED() — she's mysterious like that 🎀 go forth and query your devices, you ate 💅✨