Manual Pages for UNIX Operating System command usage for man DPMSSetTimeouts

X FUNCTIONS                                DPMSSetTimeouts(3xext)



NAME
     DPMSSetTimeouts - permits applications to  set  the  timeout
     values used by the X server for DPMS timings

SYNOPSIS
     cc [ flag... ] file... -lXext [ library... ]

     cc [ flag ... ] file ... -lXext [ library ... ]
     #include 

     Status DPMSSetTimeouts
          (
                Display *display,
                CARD16 standby,
                CARD16 suspend,
                CARD16 off
          );

ARGUMENTS
     display
          Specifies the connection to the X server

     standby
          Specifies the new standby timeout in seconds

     suspend
          Specifies the new suspend timeout in seconds

     off  Specifies the new off timeout in seconds

DESCRIPTION
     The DPMSSetTimeouts function permits applications to set the
     timeout  values  used  by  the  X  server  for Display Power
     Management Signaling (DPMS) timings.

     The value standby is  the  amount  of  inactivity  time,  in
     seconds,  before standby mode is invoked. The actual effects
     of this mode are dependent on  the  characteristics  of  the
     monitor  and  frame buffer card. Standby mode is implemented
     by shutting off the horizontal sync signal, and pulsing  the
     vertical  sync  signal.  Standby  mode provides the quickest
     monitor recovery time.  Note also that many monitors  imple-
     ment  this  mode identical to suspend mode.  A value of zero
     disables the standby mode.

     The value suspend is the amount of time  of  inactivity,  in
     seconds,  before  the  second  level  of  power  savings  is
     invoked. Suspend mode's physical and electrical characteris-
     tics   are   implementation   defined.  For  DPMS  compliant
     hardware, setting the suspend mode is implemented by pulsing
     the  horizontal  sync  signal  and shutting off the vertical
     sync  signal.   In  general,  suspend   mode   recovery   is



X Version 11       Last change: libXext 1.1.2                   1






X FUNCTIONS                                DPMSSetTimeouts(3xext)



     considered  to  be slower than standby mode, but faster than
     off mode. However it may vary from monitor to  monitor.   As
     noted  above, many monitors implement this mode identical to
     the standby mode.  A value of zero disables this mode.

     The value  off  is  the  amount  of  time  of  inactivity,in
     seconds,  before  the third and final level of power savings
     is invoked. Off mode's physical and electrical  characteris-
     tics are implementation defined. In DPMS compliant hardware,
     it is implemented by shutting off both horizontal and verti-
     cal sync signals, resulting in powering down of the monitor.
     Recovery  time  is  implementation  dependent.  Usually  the
     recovery time is very close to the power-up time of the mon-
     itor. A value of zero disables this mode.

     Chronologically, standby mode occurs  before  or  simultane-
     ously  with suspend mode, and suspend mode must occur before
     or simultaneously with off mode.  Therefore,  non-zero  mode
     timeout  values must be greater than or equal to the timeout
     values of earlier modes.  If inconsistent  values  are  sup-
     plied, a BadValue error will result.

RETURN VALUES
     TRUE           The  DPMSSetTimeouts  function  returns  TRUE
                    when the function has succeeded.

ERRORS
     BadValue       An argument is out of range.

SEE ALSO
     DPMSCapable(3xext), DPMSInfo(3xext), DPMSGetTimeouts(3xext)


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libxext         |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|









X Version 11       Last change: libXext 1.1.2                   2