dtscreen(1X)

dtscreen - the SGI Common Desktop Environment animated screen savers

As shipped in IRIX 6.5.22. Added in IRIX 6.5.19.

     NAME
          dtscreen - the SGI Common Desktop Environment animated
          screen savers

     SYNOPSIS
          dtscreen [ -display dsp ] [ -delay usecs ]

           [ -batchcount num ] [ -saturation 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 imbedded
          in the style manager's session lock customization dialog.
          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 manager.

          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
               motions".
          -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 motions".


        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 ALSO
          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 customization. Provides the methods by
                         which additional screen saver clients may be
                         integrated into the desktop.