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

NAME

6       gltext - draws text spinning around in 3D
7

SYNOPSIS

9       gltext [--display host:display.screen] [--window] [--root] [--window-id
10       number]  [--visual  visual]  [--delay  microseconds]  [--text   string]
11       [--program  command] [--wander] [--no-wander] [--spin axes] [--no-spin]
12       [--front] [--no-front] [--wireframe] [--fps]
13

DESCRIPTION

15       The gltext program draws some text spinning around in 3D, using a  font
16       that appears to be made of solid tubes.
17

OPTIONS

19       gltext accepts the following options:
20
21       --window
22               Draw on a newly-created window.  This is the default.
23
24       --root  Draw on the root window.
25
26       --window-id number
27               Draw on the specified window.
28
29       --install
30               Install a private colormap for the window.
31
32       --visual visual
33               Specify  which  visual  to use.  Legal values are the name of a
34               visual class, or the id number (decimal or hex) of  a  specific
35               visual.
36
37       --text string
38               The  text  to  display.   This  may  contain  newlines,  but it
39               shouldn't be very long.  The default is to display the  machine
40               name and OS version.
41
42               This  may  also  be  a  format string acceptable to date(1) and
43               strftime(3), in which case, it will be updated once  a  second.
44               So  to  make this program display a spinning digital clock, you
45               could do this:
46
47                    gltext -text "%A%n%d %b %Y%n%l:%M:%S %p"
48
49               To include a literal `%', you must double it: `%%'.
50
51               See the man page for strftime(3) for more details.
52
53       --program command
54               The given program is run, and  its  output  is  displayed.   If
55               specified,  this  overrides --text.  The output of this program
56               will be repeatedely displayed, with new pages of text  shifting
57               in  every  few seconds.  Lines should be relatively short.  You
58               might try:
59
60                    -program 'xscreensaver-text --cols 20'
61
62
63       --maxlines
64               Set the number of lines of text to display.  By default, gltext
65               will  print  8 lines of text at a time.  Use this option to in‐
66               crease or decrease that number.  Be aware that  gltext  is  de‐
67               signed  to  work with a fairly small amount of text, so setting
68               this value too high might result in slow performance or strange
69               behaviour stemming from buffer overflows.  Increase at your own
70               risk.
71
72       --mono  Display the text in a monospace font.  Default is  a  variable-
73               width font.
74
75       --no-mono
76               Display  the  text  in  a variable-width font.  This is the de‐
77               fault.
78
79       --wander
80               Move the text around the screen.  This is the default.
81
82       --no-wander
83               Keep the text centered on the screen.
84
85       --wander-speed
86               Sets the speed at which the text wanders  around.   Default  is
87               0.02.
88
89       --spin  Which  axes  around which the text should spin.  The default is
90               "XYZ", meaning rotate it freely in space.  "--spin Z" would ro‐
91               tate  the text in the plane of the screen while not rotating it
92               into or out of the screen; etc.
93
94       --no-spin
95               Don't spin the text at all: the same as --spin "".
96
97       --front When spinning, never spin all the way around  or  upside  down:
98               always face mostly forward so that the text is easily readable.
99
100       --no-front
101               Allow  spins  to go all the way around or upside down.  This is
102               the default.
103
104       --wireframe
105               Render in wireframe instead of solid.
106
107       --fps   Display the current frame rate, CPU load, and polygon count.
108
109       --scale Sets the scale at which the text is  rendered.   Bigger  values
110               will  result  in  bigger  text;  smaller  values will result in
111               smaller text.  The default value is 0.01.
112

ENVIRONMENT

114       DISPLAY to get the default host and display number.
115
116       XENVIRONMENT
117               to get the name of a resource file that  overrides  the  global
118               resources stored in the RESOURCE_MANAGER property.
119
120       XSCREENSAVER_WINDOW
121               The window ID to use with --root.
122

SEE ALSO

124       X(1), xscreensaver(1) xscreensaver-text(6x)
125
127       Copyright © 2001-2014 by Jamie Zawinski.  Permission to use, copy, mod‐
128       ify, distribute, and sell this software and its documentation  for  any
129       purpose  is  hereby  granted without fee, provided that the above copy‐
130       right notice appear in all copies and that both that  copyright  notice
131       and this permission notice appear in supporting documentation.  No rep‐
132       resentations are made about the suitability of this  software  for  any
133       purpose.  It is provided "as is" without express or implied warranty.
134

AUTHOR

136       Jamie Zawinski <jwz@jwz.org>
137
138
139
140X Version 11               6.08-1.fc39 (17-Oct-2023)                gltext(6x)
Impressum