1starwars(6x) XScreenSaver manual starwars(6x)
2
6 starwars - draws a perspective text crawl, like at the beginning of the
7 movie
8
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
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
22 starwars accepts the following options:
23 -window Draw on a newly-created window. This is the default.
25 -root Draw on the root window.
27 -install
29 Install a private colormap for the window.
30 -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 -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 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 In other words, programs like fortune(1) will work, but pro‐
51 grams like top(1) won't.
52 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 -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 -columns integer
67 How many columns of text should be visible on the bottom line
68 of the screen. Default: 60.
69 Only one of -columns and -size may be specified; if both are
71 specified, -columns takes priority.
72 -wrap Word-wrap lines when they reach the rightmost column. This is
74 the default.
75 -no-wrap
77 Do not word-wrap: just let the lines go off the right side of
78 the screen.
79 -left | -center | -right
81 Whether to align the text flush left, centered, or flush right.
82 The default is centered.
83 -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 -spin float
89 The star field on the background slowly rotates. This is how
90 fast. The default is 0.03.
91 -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 -delay usecs
98 The delay between steps of the animation; default is 40000
99 (1/25th second.)
100 -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 Default: -*-utopia-bold-r-normal-*-*-720-*-*-*-*-iso8859-1
109 -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 -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 -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 -fps Display the current frame rate, CPU load, and polygon count.
128
130 DISPLAY to get the default host and display number.
131 XENVIRONMENT
133 to get the name of a resource file that overrides the global
134 resources stored in the RESOURCE_MANAGER property.
135
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
152 Jamie Zawinski <jwz@jwz.org> and Claudio Matauoka <claudio@hell‐
153 labs.org>
154X Version 11 5.15-3.fc14 (18-Oct-2011) starwars(6x)