W_SETSAVER(3)			WLIB-CALLS			W_SETSAVER(3)

NAME

	w_setsaver()

SYPNOSIS

	#include <Wlib.h>

	short w_setsaver(short seconds);

DESCRIPTION

	 w_setsaver() registers the client as a screen saver to the saver
	where `seconds' is the number of seconds of idle time after which you
	want the screensaver to be activated. this number musn't be smaller
	than 10 seconds.

	 once you've successfully called w_setsaver() you must expect
	EVENT_SAVEON and EVENT_SAVEOFF events which will be send from the
	server and act accordingly. whether you create the window first and
	wait for the server to be activated then or first wait and only create
	a window each time the saver should really be run is your problem. my
	saver do it the seconds way, which may of course fail due to memory
	problems.

	 there's no way of unregistering a screen saver as the server will
	automatically do this if an existing saver terminates.

RETURNS

	- zero if everything is ok

	- anything else if an error occured, for example another saver is
	  already running

SEE ALSO

	wcreate(3)

LAST CHANGED

	12/94 by TeSche, itschere@techfak.uni-bielefeld.de
