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

ENVIRONMENT

109       DISPLAY to get the default host and display number.
110
111       XENVIRONMENT
112               to get the name of a resource file that  overrides  the  global
113               resources stored in the RESOURCE_MANAGER property.
114

SEE ALSO

116       X(1), xscreensaver(1) xscreensaver-text(6x)
117

119       Copyright © 2001-2014 by Jamie Zawinski.  Permission to use, copy, mod‐
120       ify, distribute, and sell this software and its documentation  for  any
121       purpose  is  hereby  granted without fee, provided that the above copy‐
122       right notice appear in all copies and that both that  copyright  notice
123       and this permission notice appear in supporting documentation.  No rep‐
124       resentations are made about the suitability of this  software  for  any
125       purpose.  It is provided "as is" without express or implied warranty.
126

AUTHOR

128       Jamie Zawinski <jwz@jwz.org>
129
130
131
132X Version 11               6.04-1.fc36 (06-Jun-2022)                gltext(6x)
Impressum