Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
dtscreen(user cmd)					    dtscreen(user cmd)

NAME
       dtscreen	-- the Common Desktop Environment animated screen savers

SYNOPSIS
       dtscreen	 [-display  dsp]  [-delay usecs]  [-batchcount num]  [-satura-
       tion value]  [-nice nicelevel]  [-mode mode]

DESCRIPTION
       The dtscreen client supports the	following key tasks.

       - Draws an animated image on a provided window id(s).

       - Does not assume the size of the provided window(s).

       - Provides a set	of selectable animated images.

       - Animation parameters such as nice, speed, number and  saturation  may
       be specified.

       The  dtscreen  client  provides the default screen saver	animations for
       the desktop. When launched, it will query the desktop using the API for
       the  set	for window ids on which	to draw. These window ids could	be the
       cover windows created by	the session manager for	 session  lock,	 or  a
       window  embedded	in the style manager's session lock customization dia-
       log. Once obtained, the dtscreen	client will proceed to draw  in	 these
       windows using the specified options.  If	dtscreen cannot	obtain the set
       of window ids, it will create its own. Normally,	 the  dtscreen	client
       will  be	 invoked directly by the session manager, or by	the style man-
       ager.

       Note that the Session Manager, dtsession, is  responsible  for  locking
       the session and prompting for a password	to unlock.

       The  session  manager  may launch the dtscreen client to	provide	screen
       saver animations	during session lock.  Refer  to	 the  session  manager
       specification  for resources controlling	the launching of screen	savers
       by the session manager.

       The style manager may launch the	dtscreen client	to provide  a  preview
       of  a  screen  saver animation during customization. Refer to the style
       manager specification for information on	 how  to  integrate  a	screen
       saver client such as dtscreen into the desktop.

       The  dtsession  client  provides	 a selectable set of animations. These
       are:

       hop	 Hopalong iterated fractals.

       life	 Conway's game of life.

       qix	 Spinning lines.

       image	 Random	bouncing image.

       swarm	 Swarm of bees.

       rotor	 Rotor

       pyro	 Fireworks.

       flame	 Cosmic	Flame Fractals.

       worm	 Wiggly	Worms.

       random	 Random	mode.

       The dtscreen client animations are based	on xlock(1).

OPTIONS
       -display	dsp

       The display on which animations will be drawn.

       -delay usecs

       The delay option	sets the speed at which	a mode will operate. It	simply
       sets  the  number of microseconds to delay between batches of "hopalong
       pixels",	"qix lines", "life generations", "image	blits",	and "swarm mo-
       tions".

       -batchcount num

       The batchcount option sets the number of	things to do per batch to num.
       In qix mode this	refers to the number of	lines  rendered	 in  the  same
       color.  In hop mode this	refers to the number of	pixels rendered	in the
       same color.  In image mode this refers to the number of X logos on  the
       screen  at  once.   in swarm mode this refers to	the number of bees. In
       life mode it means nothing.

       -saturation value

       The saturation option sets the saturation of the	 color	ramp  used  to
       value. 0	is grayscale, 1	is very	rich color and 0.4 is a	nice pastel.

       -nice nicelevel

       The  nice  option  sets the system nicelevel of the dtscreen process to
       nicelevel.

       -mode mode

       The mode	option specifies which animation should	be  displayed.	Values
       are:

       hop	 Hopalong iterated fractals.

       life	 Conway's game of life.

       qix	 Spinning lines.

       image	 Random	bouncing image.

       swarm	 Swarm of bees.

       rotor	 Rotor

       pyro	 Fireworks.

       flame	 Cosmic	Flame Fractals.

       worm	 Wiggly	Worms.

       random	 Random	mode.

RETURN VALUE
       Exit values are:

       0	 Successful completion.

       >0	 Error condition occurred.

EXAMPLES
   dtscreen -mode swarm
       Display the swarm animation.

RESOURCES
       Name		     ClassClass		 Type	     Default
       mode		     Mode		 String	     swarm
       nice		     Nice		 Int	     16
       delay		     Delay		 Int	     1000
       batchcount	     Batchcount		 Int	     100
       saturation	     Saturation		 Float	     1.0
       hop.delay	     Delay		 Int	     0
       hop.batchcount	     Batchcount		 Int	     1000
       hop.saturation	     Saturation		 Float	     1
       image.delay	     Delay		 Int	     2000000
       image.batchcount	     Batchcount		 Int	     8
       image.saturation	     Saturation		 Float	     0.2
       qix.delay	     Delay		 Int	     30000
       qix.batchcount	     Batchcount		 Int	     64
       qix.saturation	     Saturation		 Float	     1
       life.delay	     Delay		 Int	     1000000
       life.batchcount	     Batchcount		 Int	     1
       life.saturation	     Saturation		 Float	     1
       swarm.delay	     Delay		 Int	     10000
       swarm.batchcount	     Batchcount		 Int	     100
       swarm.saturation	     Saturation		 Float	     1
       rotor.delay	     Delay		 Int	     10000
       rotor.batchcount	     Batchcount		 Int	     4
       rotor.saturation	     Saturation		 Float	     0.4
       pyro.delay	     Delay		 Int	     15000
       pyro.batchcount	     Batchcount		 Int	     40
       pyro.saturation	     Saturation		 Float	     1.0
       flame.delay	     Delay		 Int	     10000
       flame.batchcount	     Batchcount		 Int	     20
       flame.saturation	     Saturation		 Float	     1.0
       worm.delay	     Delay		 Int	     10000
       worm.batchcount	     Batchcount		 Int	     20
       worm.saturation	     Saturation		 Float	     1.0

   delay
       The delay option	sets the speed at which	a mode will operate. It	simply
       sets the	number of microseconds to delay	between	batches	 of  "hopalong
       pixels",	"qix lines", "life generations", "image	blits",	and "swarm mo-
       tions".

   batchcount
       The batchcount option sets the number of	things to do per batch to num.
       In  qix	mode  this  refers to the number of lines rendered in the same
       color.  In hop mode this	refers to the number of	pixels rendered	in the
       same  color.  In	image mode this	refers to the number of	X logos	on the
       screen at once.	in swarm mode this refers to the number	 of  bees.  In
       life mode it means nothing.

   saturation
       The  saturation	option	sets  the saturation of	the color ramp used to
       value. 0	is grayscale, 1	is very	rich color and 0.4 is a	nice pastel.

   nice
       The nice	option sets the	system nicelevel of the	 dtscreen  process  to
       nicelevel.

   mode
       The  mode  option specifies which animation should be displayed.	Values
       are:

       hop	 Hopalong iterated fractals.

       life	 Conway's game of life.

       qix	 Spinning lines.

       image	 Random	bouncing image.

       swarm	 Swarm of bees.

       rotor	 Rotor

       pyro	 Fireworks.

       flame	 Cosmic	Flame Fractals.

       worm	 Wiggly	Worms.

       random	 Random	mode.

SEE
       dtsession Launches the dtscreen client during  session  lock.  Provides
		 resources  that  can be used to control this event. Locks and
		 unlocks a session.

       dtstyle	 Launched the dtscreen client during session  lock  customiza-
		 tion.	Provides  the methods by which additional screen saver
		 clients may be	integrated into	the desktop.

							    dtscreen(user cmd)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | RETURN VALUE | EXAMPLES | RESOURCES | SEE

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=dtscreen&sektion=1&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help