DragonFly On-Line Manual Pages

XSTARROLL(1)           DragonFly General Commands Manual          XSTARROLL(1)

NAME
       XStarRoll - Letters fly to far, far, far away.

SYNOPSIS
       xstarroll [parameter1] [parameter2] ...

DESCRIPTION
       XStarRoll is a simple demonstration program for X11. Letters and
       pixmaps fly to far, far, far away. You can fly optional letters and
       pixmaps, and use XStarRoll as a background picture.

       If a parameter is a pixmap filename, XStarRoll reads it and flies the
       pixmap, or, if the parameter is a text filename, XStarRoll reads it and
       flies letters in it, or else, xstarroll flies the parameter as it is.

       You can send letters to XStarRoll through the standard input.

OPTIONS
       (X-ToolKit Options)
       -display, -geometry, -name, -font, -fg and -bg are available.

       --
       End of options. XStarRoll ignores following options.

       -
       Read letters from the standard input.

       -help, -h
       Output this Message.

       -root, -r
       Draw the picture on the root window of the display.

       -noroot, -nr
       Open a new window and draw the picture on it. (Default)

       -quit, -q
       Draw the picture and exit.

       -noquit, -nq
       XStarRoll does not exit. (Default)

       -blur, -b
       Letters fly to the farther, become the more blurred. (Default)

       -noblur, -nb
       Letters do not become blurred.

       -fill
       Fill all dots entirely.

       -source-width [x], -sw [x]
       Specify the width of the source picture for a pixel.

       -width [x], -w [x]
       Specify the width of the source picture for a letter. Default value is
       40.

       -length-x [x], -lx [x]
       Specify the length parameter of X-direction for drawing. Default value
       is same as the size of the source picture.

       -length-y [x], -ly [x]
       Specify the length parameter of Y-direction for drawing. Default value
       is 100.

       -space [x], -sp [x]
       Specify the space between lines. Default value is 1.

       -scroll [x], -sc [x]
       Specify the speed and direction of the scroll. Default value is 1.

       -start [x], -st [x]
       Specify the start point. Default value is 0.

       -wait [x], -wt [x]
       Specify the wait time for a micro second. Default value is 0.

KEY OPERATIONS
       [Up], [Down], [Right], [Left]
       Change the length parameters for drawing.

       [a], [d]
       Change the speed of the scroll.

       [p], [n], [PageUp], [PageDown]
       Scroll the picture.

       [s]
       Return to the start point.

       [q]
       Quit.

EXAMPLES
       % ls -l | xstarroll
       - XStarRoll flies the output of ls.

       % echo "This is XStarRoll." | xstarroll
       % xstarroll "This is XStarRoll."
       - XStarRoll flies "This is XStarRoll.".

       % echo "is" | xstarroll "This" - "XStarRoll."
       - XStarRoll flies "This", "is" and "XStarRoll.".

       % xstarroll sample.txt
       - XStarRoll flies letters in a file "sample.txt".

       % xstarroll sample.xpm
       - XStarRoll flies a pixmap "sample.xpm".

       % xstarroll "This is XStarRoll." sample1.txt sample1.xpm sample2.txt
       sample2.xpm ...
       - XStarRoll flies "This is XStarRoll.", flies letters in a file
       sample1.txt, flies a pixmap sample1.xpm, flies letters in a file
       sample2.txt, flies a pixmap sample2.xpm ...

       If the head of letters is a Tab code or "#center", XStarRoll flies
       letters at the center of the screen.

SEE ALSO
       X(1)

AUTHOR
       Programed by Sakai Hiroaki.
       E-Mail:sakai@miya.ee.kagu.sut.ac.jp
       http://wwwmiya.ee.kagu.sut.ac.jp/~sakai/myfreesoft.html

COPYRIGHT
       XStarRoll Copyright (c) 1998 Sakai Hiroaki.
       All Rights Reserved.

       XStarRoll is a free software. You may copy or distribute the original
       XStarRoll freely. But, you may not modify or distribute the original
       XStarRoll without permission of the author.

X Version 11                       Release 6                      XSTARROLL(1)