| 1 | .de EX \"Begin example |
|---|
| 2 | .ne 5 |
|---|
| 3 | .if n .sp 1 |
|---|
| 4 | .if t .sp .5 |
|---|
| 5 | .nf |
|---|
| 6 | .in +.5i |
|---|
| 7 | .. |
|---|
| 8 | .de EE |
|---|
| 9 | .fi |
|---|
| 10 | .in -.5i |
|---|
| 11 | .if n .sp 1 |
|---|
| 12 | .if t .sp .5 |
|---|
| 13 | .. |
|---|
| 14 | .TH XScreenSaver 1 "30-Oct-99" "X Version 11" |
|---|
| 15 | .SH NAME |
|---|
| 16 | phosphor - simulates an old terminal with long-sustain phosphor |
|---|
| 17 | .SH SYNOPSIS |
|---|
| 18 | .B phosphor |
|---|
| 19 | [\-display \fIhost:display.screen\fP] [\-window] [\-root] [\-install] |
|---|
| 20 | [\-visual \fIvisual\fP] [\-font \fIfont\fP] [\-scale \fIint\fP] |
|---|
| 21 | [\-ticks \fIint\fP] [\-delay \fIusecs\fP] [\-program \fIcommand\fP] |
|---|
| 22 | .SH DESCRIPTION |
|---|
| 23 | The \fIphosphor\fP program draws text on the screen in a very large |
|---|
| 24 | pixelated font that looks like an old low resolution dumb tty. The |
|---|
| 25 | pixels flare and fade out as if the phosphor was very long-sustain. |
|---|
| 26 | .SH OPTIONS |
|---|
| 27 | .I phosphor |
|---|
| 28 | accepts the following options: |
|---|
| 29 | .TP 8 |
|---|
| 30 | .B \-window |
|---|
| 31 | Draw on a newly-created window. This is the default. |
|---|
| 32 | .TP 8 |
|---|
| 33 | .B \-root |
|---|
| 34 | Draw on the root window. |
|---|
| 35 | .TP 8 |
|---|
| 36 | .B \-install |
|---|
| 37 | Install a private colormap for the window. |
|---|
| 38 | .TP 8 |
|---|
| 39 | .B \-visual \fIvisual\fP\fP |
|---|
| 40 | Specify which visual to use. Legal values are the name of a visual class, |
|---|
| 41 | or the id number (decimal or hex) of a specific visual. |
|---|
| 42 | .TP 8 |
|---|
| 43 | .B \-font \fIfont-name\fP |
|---|
| 44 | The X font to use. Phosphor can take any font and scale it up to pixelate |
|---|
| 45 | it. The default is \fIfixed\fP. |
|---|
| 46 | .TP 8 |
|---|
| 47 | .B \-scale \fIint\fP |
|---|
| 48 | How much to scale the font up: in other words, the size in real pixels of |
|---|
| 49 | the simulated pixels. Default 6. |
|---|
| 50 | .TP 8 |
|---|
| 51 | .B \-ticks \fIint\fP |
|---|
| 52 | The number of colors to use when fading to black. Default 20. |
|---|
| 53 | .TP 8 |
|---|
| 54 | .B \-delay \fIusecs\fP |
|---|
| 55 | The speed of the terminal: how long to wait between drawing each character. |
|---|
| 56 | Default 50000, or about 1/20th second. |
|---|
| 57 | .TP 8 |
|---|
| 58 | .B \-program \fIsh-command\fP |
|---|
| 59 | The command to run to generate the text to display. This option may be |
|---|
| 60 | any string acceptable to /bin/sh. The program will be run at the end of |
|---|
| 61 | a pipe, and any characters that it prints to \fIstdout\fP will be printed |
|---|
| 62 | on phosphor's window. The characters will be printed artificially slowly, |
|---|
| 63 | as per the \fI\-delay\fP option above. If the program exits, it will be |
|---|
| 64 | launched again after 5 seconds. |
|---|
| 65 | |
|---|
| 66 | Note that phosphor is \fInot\fP a terminal emulator: programs that try to |
|---|
| 67 | directly address the screen will not do what you might expect. Phosphor |
|---|
| 68 | merely draws the characters on the screen left to right, top to bottom. |
|---|
| 69 | Lines wrap when they reach the right edge, and the screen scrolls when |
|---|
| 70 | characters reach the bottom. |
|---|
| 71 | |
|---|
| 72 | In other words, programs like |
|---|
| 73 | .BR fortune (1) |
|---|
| 74 | will work, but programs like |
|---|
| 75 | .BR top (1) |
|---|
| 76 | won't. |
|---|
| 77 | |
|---|
| 78 | For example: |
|---|
| 79 | .EX |
|---|
| 80 | phosphor -program 'cat /usr/src/linux*/README' |
|---|
| 81 | phosphor -program 'ping localhost' |
|---|
| 82 | phosphor -program 'ps -e' |
|---|
| 83 | phosphor -program 'od -txC -w6 /dev/random' |
|---|
| 84 | .EE |
|---|
| 85 | .SH ENVIRONMENT |
|---|
| 86 | .PP |
|---|
| 87 | .TP 8 |
|---|
| 88 | .B DISPLAY |
|---|
| 89 | to get the default host and display number. |
|---|
| 90 | .TP 8 |
|---|
| 91 | .B XENVIRONMENT |
|---|
| 92 | to get the name of a resource file that overrides the global resources |
|---|
| 93 | stored in the RESOURCE_MANAGER property. |
|---|
| 94 | .SH SEE ALSO |
|---|
| 95 | .BR xscreensaver (1), |
|---|
| 96 | .BR fortune (1), |
|---|
| 97 | .BR apple2 (1), |
|---|
| 98 | .BR starwars (1), |
|---|
| 99 | .BR fontglide (1), |
|---|
| 100 | .BR ljlatest (1), |
|---|
| 101 | .BR dadadodo (1), |
|---|
| 102 | .BR webcollage (1), |
|---|
| 103 | .BR driftnet (1) |
|---|
| 104 | .BR EtherPEG , |
|---|
| 105 | .BR EtherPeek |
|---|
| 106 | .SH COPYRIGHT |
|---|
| 107 | Copyright \(co 1999 by Jamie Zawinski. Permission to use, copy, modify, |
|---|
| 108 | distribute, and sell this software and its documentation for any purpose is |
|---|
| 109 | hereby granted without fee, provided that the above copyright notice appear |
|---|
| 110 | in all copies and that both that copyright notice and this permission notice |
|---|
| 111 | appear in supporting documentation. No representations are made about the |
|---|
| 112 | suitability of this software for any purpose. It is provided "as is" without |
|---|
| 113 | express or implied warranty. |
|---|
| 114 | .SH AUTHOR |
|---|
| 115 | Jamie Zawinski <jwz@jwz.org>, 27-Apr-99. |
|---|
