Protoco...xt::DPMS(3)

🌸 NAME 🌸

X11::Protocol::Ext::DPMS — a Perl module for the X11 Protocol DPMS Extension 💖

okay so real talk, this little icon lives in the User Contributed Perl Documentation section of the manual, and honestly? she's giving "small but powerful." periodt ✨

---

🎀 SYNOPSIS 🎀

bestie, here's the whole vibe in three lines:

use X11::Protocol;
$x = X11::Protocol->new();
$x->init_extension('DPMS');

that's it. that's the ritual. load it up, make your X11::Protocol object, then init_extension('DPMS') and you're in. no cap 💅

---

🦋 DESCRIPTION 🦋

so this module is literally here to control the DPMS features of compliant monitors ✨ like, the power-saving sleepy-time stuff your screen does. your monitor has to be "compliant" for this to work, which is the polite way of saying "it has to actually support DPMS, iykyk."

---

🫶 SYMBOLIC CONSTANTS 🫶

this extension adds the constant type DPMSPowerLevels, with values as defined in the standard. that's the whole tea — the actual values come straight from the standard, not from this module 🙈

---

🔥 REQUESTS 🔥

this extension adds several requests, and you call them exactly like this:

$x->DPMSGetVersion => ($major, $minor)

$x->DPMSCapable => ($capable)

$x->DPMSGetTimeouts => ($standby_timeout, $suspend_timeout, $off_timeout)

$x->DPMSSetTimeouts($standby_timeout, $suspend_timeout, $off_timeout) => ()

$x->DPMSEnable => ()

$x->DPMSDisable => ()

$x->DPMSForceLevel($power_level) => ()

$x->DPMSInfo => ($power_level,$state)

okay let's break the group chat down because these are all iconic in their own way:

• $x->DPMSGetVersion => ($major, $minor) — grabs the version, hands you $major and $minor. she's the intro slide 💜
• $x->DPMSCapable => ($capable) — asks the question we're all wondering: is this monitor actually DPMS-capable? you get $capable back. the vibe check of the whole extension, fr fr 🌈
• $x->DPMSGetTimeouts => ($standby_timeout, $suspend_timeout, $off_timeout) — three timeouts, one call. $standby_timeout, $suspend_timeout, $off_timeout. the holy trinity of nap time 😭
• $x->DPMSSetTimeouts($standby_timeout, $suspend_timeout, $off_timeout) => () — same three, but now you're the one setting them. note the => () — she returns nothing, she simply acts 👑
• $x->DPMSEnable => () — turns the whole thing on. returns () because she doesn't owe you an explanation 💅
• $x->DPMSDisable => () — turns it off. also returns (). main character energy either way ⭐
• $x->DPMSForceLevel($power_level) => () — forces a specific $power_level. no negotiating, no asking nicely. returns () 🔥
• $x->DPMSInfo => ($power_level,$state) — tells you the current $power_level and $state. the receipts request, honestly 🍓

---

💀 AUTHOR 💀

Jay Kominek <jay.kominek@colorado.edu> — we stan a legend 🫶

---

🌟 SEE ALSO 🌟

• perl(1)
• X11::Protocol
• X Display Power Management Signaling (DPMS) Extension (X Consortium Standard)

---

ngl if you got this far you're basically a DPMS expert now. go put your monitor to sleep responsibly 💖

perl v5.42.0 🦋 dated 2024-03-04 🦋 and that's the whole page, bestie — mwah 💋✨