Short:    DPMS manager for CyberGraphX. V1.0.
Author:   Magnus Holmgren (cmh@lls.se)
Uploader: Magnus Holmgren (cmh@lls.se)
Type:     util/cdity


Introduction
============

CGXDPMS - Now there's an acronym for you. ;) CGX stands for CyberGraphX,
and DPMS stands for Display Power Management Signaling. So, this is a
program that uses the DPMS feature in CyberGraphX.

Anyway, this is a small program I hacked together the other day (hence the
brief documentation ;). It is a small commodity that uses the DPMS function
in your graphics card and monitor. I wrote it since the DPMS program I had
seen was a bit large, and more importantly, didn't support all DPMS levels
available in CyberGraphX. Hence CGXDPMS, which supports all three DPMS
levels (and is a bit smaller).

CGXDPMS can be used in addition to a normal screen blanker.


Requirements
============

First of all, you need a graphics card and a monitor that supports DPMS.
You also need CyberGraphX (or compatible) installed. Other than that,
nothing special is required (except AmigaOS then).

If you use this with a graphics card that do support DPMS, but the monitor
does not, I don't know what will happen. If anything gets damaged, don't
blame me. And this brings us to...


No warranty
===========

There is no warranty for this software package. Although the author has
tried to prevent errors he can't guarantee that the software package
described in this document is 100% reliable. You are therefore using this
material at your own risk. The author cannot be made responsible for any
damage which is caused by using this software package.


Usage
=====

The following arguments can be specified on the command line, or as
tooltypes:

CX_PRIORITY
	The priority (within Commodities). Changing this will probably not
	change the behaviour in any way, since CGXDPMS doesn't have any
	hotkey yet, but...

STANDBYTIME
	The number of minutes of inactivity to wait before the (optional)
	standby mode should be activated. Default is 15 minutes. Specifying
	0 will make CGXDPMS skip this mode.

SUSPENDTIME
	The number of minutes of inactivity to wait before the suspended
	mode should be activated. This time starts counting after the
	standby mode is activated (if at all). Default is 15 minutes.
	Specifying 0 will make CGXDPMS skip this mode.

OFFTIME
	The number of minutes of inactivity to wait before the off mode
	should be activated (erh ;). This time starts counting after the
	standby mode is activated (if at all). Default is 15 minutes.
	Specifying 0 will make CGXDPMS skip this mode.

	Note: Setting all the above times to zero is rather pointless to
	do, don't you think? ;)

SENDSHIFT
	In order to stop a possible screen blanker from doing any
	uneccessary work, CGXDPMS will regularly emulate the pressing of
	the left shift key while the monitor is not "on". This should keep
	any screen blanker from going into action.

	Pressing the shift key shouldn't cause any problems, but here you
	can decide if it should be done or not.

SHIFTTIME
	The number of minutes to wait between the emulated shift pressings.
	Default is 1.

NOMOUSE
	If specified, then the CGXDPMS will not turn the monitor on when
	the mouse is moved. This only affects CGXDPMS while the monitor is
	not "on".


The DONOTWAIT tooltype in the icon is for the Workbench, when placed in the
Workbench startup drawer.


Todo?
=====

Things that could be added, but I didn't consider to be important at the
moment:

 o CGXDPMS assumes that it is the graphics card of the Workbench screen
   that should signal for power saving. Maybe this should be configurable
   (in the form of the name of a public screen), and also include support
   for multiple screens (for those with multiple cards).

 o A hotkey to go into power saving mode.


Author and other things
=======================

CGXDPMS was written in 1997 by Magnus Holmgren. It is public domain (source
included, though not very well documented ;), so you can do anything you
like with it (although credits would be appriciated ;). Contact address:

Snail mail:

	Magnus Holmgren
	Kvarnbergsvägen 5
	S-444 47  Stenungsund
	SWEDEN

Electronic mail:

	cmh@lls.se
	2:203/512.10@fidonet

	http://www.lls.se/~cmh/


Version history
===============

1.0	May 7, 1997

	Initial release.