1starwars(6x)                  XScreenSaver manual                 starwars(6x)
2
3
4

NAME

6       starwars - draws a perspective text crawl, like at the beginning of the
7       movie
8

SYNOPSIS

10       starwars [-display host:display.screen] [-window] [-root] [-visual vis‐
11       ual]  [-delay  microseconds] [-program command] [-size integer ] [-col‐
12       umns integer] [-wrap | -no-wrap] [-left |  -center  |  -right]  [-lines
13       integer]  [-spin  float]  [-steps  integer] [-delay usecs] [-font xlfd]
14       [-no-textures] [-no-smooth] [-no-thick] [-fps]
15

DESCRIPTION

17       The starwars program runs another program to generate a stream of text,
18       then  animates  that text receeding into the background at an angle, in
19       front of a star field.
20

OPTIONS

22       starwars accepts the following options:
23
24       -window Draw on a newly-created window.  This is the default.
25
26       -root   Draw on the root window.
27
28       -install
29               Install a private colormap for the window.
30
31       -visual visual
32               Specify which visual to use.  Legal values are the  name  of  a
33               visual  class,  or the id number (decimal or hex) of a specific
34               visual.
35
36       -program sh-command
37               The command to run to  generate  the  text  to  display.   This
38               option  may  be  any string acceptable to /bin/sh.  The program
39               will be run at the end of a pipe, and any  characters  that  it
40               prints  to  stdout  will be printed on the starwars window.  If
41               the program exits, it will be launched again after we have pro‐
42               cessed all the text it produced.
43
44               Note  that  starwars  is not a terminal emulator: programs that
45               try to directly address the screen will not do what  you  might
46               expect.  This program merely draws the characters on the screen
47               left to right, top to bottom, in perspective.  Lines (may) wrap
48               when they reach the right edge.
49
50               In  other  words,  programs like fortune(1) will work, but pro‐
51               grams like top(1) won't.
52
53               Some examples:
54               starwars -program 'cat /usr/src/linux*/README'
55               starwars -columns 30 -program 'ping www.starwars.com'
56               starwars -left -no-wrap -program 'ps -auxwwf'
57               starwars -left -no-wrap -columns 45 -program 'top -bn1'
58               starwars -left -columns 40 -program 'od -txC /dev/urandom'
59               starwars -font fixed -program 'od -txC /dev/urandom'
60
61       -size integer
62               How large a font to use, in points.  (Well, in  some  arbitrary
63               unit   we're  calling  "points"  for  the  sake  of  argument.)
64               Default: 24.
65
66       -columns integer
67               How many columns of text should be visible on the  bottom  line
68               of the screen.  Default: 60.
69
70               Only  one  of  -columns and -size may be specified; if both are
71               specified, -columns takes priority.
72
73       -wrap   Word-wrap lines when they reach the rightmost column.  This  is
74               the default.
75
76       -no-wrap
77               Do  not  word-wrap: just let the lines go off the right side of
78               the screen.
79
80       -left | -center | -right
81               Whether to align the text flush left, centered, or flush right.
82               The default is centered.
83
84       -lines integer
85               How  many  lines  should  be allowed to be on the screen before
86               they fall off the end.  The default is 125.
87
88       -spin float
89               The star field on the background slowly rotates.  This  is  how
90               fast.  The default is 0.03.
91
92       -steps integer
93               How  many  steps  should  be used to scroll a single line.  The
94               default is 35.  If the animation looks jerky to  you,  increase
95               this number.
96
97       -delay usecs
98               The  delay  between  steps  of  the animation; default is 40000
99               (1/25th second.)
100
101       -font font-name
102               The name of the font to use.  For best effect, this should be a
103               large font (at least 36 points.)  The bigger the font, the bet‐
104               ter looking the characters will be.  Note that the size of this
105               font affects only the clarity of the characters, not their size
106               on the screen: for that, use the -size or -columns options.
107
108               Default: -*-utopia-bold-r-normal-*-*-720-*-*-*-*-iso8859-1
109
110       -no-textures
111               Instead of texture-mapping a real font to render the text,  use
112               a  built-in  font composed of line segments.  On graphics cards
113               without texture support, the line-segment font will  have  much
114               better performance.
115
116       -no-smooth
117               When using the line-segment font, turn off anti-aliasing of the
118               lines used to draw the font.  This will make the text blockier,
119               but may improve performance.
120
121       -no-thick
122               When  using  the line-segment font, turn off use of thick lines
123               for the characters that are close to the foreground.  This will
124               make  the  text appear unnaturally skinny, but may improve per‐
125               formance.
126
127       -fps    Display the current frame rate, CPU load, and polygon count.
128

ENVIRONMENT

130       DISPLAY to get the default host and display number.
131
132       XENVIRONMENT
133               to get the name of a resource file that  overrides  the  global
134               resources stored in the RESOURCE_MANAGER property.
135

SEE ALSO

137       xscreensaver(1),    xscreensaver-text(1),   fortune(1),   phosphor(6x),
138       apple2(6x), fontglide(6x), ljlatest(6x),  dadadodo(1),  webcollage(6x),
139       driftnet(1) EtherPEG, EtherPeek
140
142       Copyright  © 1998-2005 by Jamie Zawinski and Claudio Matsuoka.  Permis‐
143       sion to use, copy, modify, distribute, and sell this software  and  its
144       documentation  for  any purpose is hereby granted without fee, provided
145       that the above copyright notice appear in all copies and that both that
146       copyright  notice and this permission notice appear in supporting docu‐
147       mentation.  No representations are made about the suitability  of  this
148       software  for  any  purpose.  It is provided "as is" without express or
149       implied warranty.
150

AUTHOR

152       Jamie  Zawinski  <jwz@jwz.org>  and  Claudio  Matauoka   <claudio@hell‐
153       labs.org>
154
155
156
157X Version 11               5.45-1.fc33 (10-Dec-2020)              starwars(6x)
Impressum