DPMSForceLevel(3)

💖 DPMSForceLevel — the "go to sleep bestie" button for your monitor 💖

okay so real talk, this one lives in the X FUNCTIONS part of the X world, and it's like... the most direct way to tell a screen "hey. power level. now." No negotiating, no waiting, just vibes deployed immediately. ✨

---

🌸 NAME 🌸

DPMSForceLevel — forces a DPMS capable display into the specified power level

like literally forces it. not a suggestion. a demand. 💅

---

🎀 SYNOPSIS 🎀

cc [ flag ... ] file ... -lXext [ library ... ]
#include <X11/extensions/dpms.h>

Status DPMSForceLevel ( Display *display, CARD16 level );

yes bestie you gotta link -lXext and yes you gotta pull in <X11/extensions/dpms.h> or it's giving nothing. 🫶

---

✨ ARGUMENTS ✨

• display — the connection to the X server, aka your little hotline to the display situation. 📞
• level — the power level you wanna force it to. pick wisely, queen. 👑

---

💫 DESCRIPTION 💫

so the DPMSForceLevel function forces a DPMS capable display into the specified power level. That's the whole assignment. 💖

the level you pass has to be one of these four states, no substitutes:

• DPMSModeOn
• DPMSModeStandby
• DPMSModeSuspend
• DPMSModeOff

anything other than those four? that's a BadValue error, bestie. the server said no. 💀

and one more thing — if DPMS is disabled on the display, trying to set the power level on the display will result in a BadMatch protocol error. so like, if DPMS isn't even turned on, don't come for it. it's not gonna work. 😭

---

🔥 RETURN VALUES 🔥

• TRUE — the DPMSForceLevel function always returns TRUE.

ngl that's it. that's the whole return value list. it's an overachiever with exactly one answer and honestly? iconic. 👑

---

💅 ERRORS 💅

• BadValue — a level other than DPMSModeOn, DPMSModeStandby, DPMSModeSuspend, or DPMSModeOff was specified. you colored outside the lines. 🙈
• BadMatch — DPMS is disabled on the specified display. the door was locked the whole time fr fr. 🚪

---

🌈 SEE ALSO 🌈

the rest of the DPMS friend group, go say hi:

• DPMSCapable(3)
• DPMSInfo(3)
• DPMSGetTimeouts(3)
• DPMSSetTimeouts(3)

---

that's the page bestie, go forth and dim responsibly ✨

this whole thing comes to you from X Version 11, libXext 1.3.6 — mwah, thanks for reading, ily, bye 🎀🦋💜