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.