starwars - draws a perspective text crawl, like at the beginning of the movie
starwars [-display host:display.screen] [-window] [-root] [-visual visual] [-delay
microseconds] [-fps] [-program command] [-size integer ] [-columns integer] [-wrap |
-no-wrap] [-left | -center | -right] [-lines integer] [-spin float] [-steps integer]
[-delay usecs] [-no-smooth] [-no-thick]
The starwars program runs another program to generate a stream of text, then animates that
text receeding into the background at an angle, in front of a star field.
starwars accepts the following options:
-window Draw on a newly-created window. This is the default.
-root Draw on the root window.
Install a private colormap for the window.
Specify which visual to use. Legal values are the name of a visual class, or the
id number (decimal or hex) of a specific visual.
The command to run to generate the text to display. This option may be any string
acceptable to /bin/sh. The program will be run at the end of a pipe, and any
characters that it prints to stdout will be printed on the starwars window. If
the program exits, it will be launched again after we have processed all the text
Note that starwars is not a terminal emulator: programs that try to directly
address the screen will not do what you might expect. This program merely draws
the characters on the screen left to right, top to bottom, in perspective. Lines
(may) wrap when they reach the right edge.
In other words, programs like fortune(1) will work, but programs like top(1)
starwars -columns 30 -program \
'wget -qO- http://webcrawler.com/cgi-bin/SearchTicker'
starwars -columns 76 -program 'cat /usr/src/linux/README'
starwars -program 'ping www.starwars.com'
starwars -no-wrap -left -program 'finger @gnu.org'
starwars -no-wrap -left -program 'ps -ef'
How large a font to use, in points. (Well, in some arbitrary unit we're calling
"points" for the sake of argument.) The -columns option overrides this.
How many columns of text should be visible on the bottom line of the screen. The
default is 80. This option overrides the -size option: if you specify a number of
columns, the font will be scaled as needed to fit.
-wrap Word-wrap lines when they reach the rightmost column. This is the default.
Do not word-wrap: just let the lines go off the right side of the screen.
-left | -center | -right
Whether to align the text flush left, centered, or flush right. The default is
How many lines should be allowed to be on the screen before they fall off the end.
The default is 125.
The star field on the background slowly rotates. This is how fast. The default
How many steps should be used to scroll a single line. The default is 35. If the
animation looks jerky to you, increase this number.
The delay between steps of the animation; default is 40000 (1/25th second.)
-fps Display a running tally of how many frames per second are being rendered. In con-
junction with -delay 0, this can be a useful benchmark of your GL performance.
Turn off anti-aliasing of the lines used to draw the font. This will make the
text blockier, but may improve performance.
Turn off use of thick lines for the characters that are close to the foreground.
This will make the text appear unnaturally skinny, but may improve performance.
DISPLAY to get the default host and display number.
to get the name of a resource file that overrides the global resources stored in
the RESOURCE_MANAGER property.
Copyright (C) 1998-2001 by Jamie Zawinski and Claudio Matsuoka. Permission to use, copy,
modify, distribute, and sell this software and its documentation for any purpose is hereby
granted without fee, provided that the above copyright notice appear in all copies and
that both that copyright notice and this permission notice appear in supporting documenta-
tion. No representations are made about the suitability of this software for any purpose.
It is provided "as is" without express or implied warranty.
Jamie Zawinski <email@example.com> and Claudio Matauoka <firstname.lastname@example.org>
X Version 11 25-Jul-98 XScreenSaver(1)