GGITERM(1)GGITERM(1)NAMEggiterm - Terminal emulator for GGI
SYNOPSISggiterm [OPTIONS]
DESCRIPTIONggiterm is a terminal emulator for the GGI graphics library. It uses
freetype to display internationalized and (depending on the color
depth) antialiased text. It is also backwards compatible with the wide‐
spread DEC vt100 terminal, but features nifty additions to the old
standard, like colors.
OPTIONS-d, --debuglevel n
If ggiterm was compiled with debugging enabled, this option se‐
lects the subsystem(s) to debug. You can debug more than one
subsystem by adding the corresponding numbers.
0 Disable debugging (this is the default).
1 Initialization. Lets you know all about mode negociation, font
parsing, or memory allocation.
2 Input. Debug everything that is sent to the slave program.
4 Output. Debug what the slave process sends to ggiterm in re‐
turn.
8 Freetype. Details the innards of freetype rendering.
16 History. See how ggiterm stores and retrieves characters.
32 Functions. Debug every function call inside ggiterm.
Be warned, debugging can dramatically slow down execution. In
this case it is strongly recommended to redirect the output to a
file for later analysis.
-e, --exec program [ARGS]
Lets you specify the program and arguments ggiterm will execute
instead of the default shell.
This option must be the last on the command line.
-f, --font filename
If this option is not provided, ggiterm will use the default GGI
font. In this case, no antialiasing is available, and only the
ASCII character set is garanteed to be present. You won't be
able to display accented or non latin characters.
filename is a file which must contain a fixed width font. It can
be in any format supported by the freetype library. The most
commonly found are True Type fonts (.ttf).
The author suggests Microsoft Courier New (widely available), or
Monofur from Tobias Kohler (much more fun and available for free
athttp://www.dafont.com). Both have graphical drawing characters
and allow underlining.
-h, --help
Show a short summary of the available options.
-m, --mode
Specify the graphics mode to set. This is a convenient alterna‐
tive to using the GGI_DEFMODE variable. The format is the same.
-s, --font-size n
The font size to use for displaying text. Unfortunately this pa‐
rameter does not correspond to the character's size in pixels,
but rather to some internal metrics used by the font designer.
So, for a given value, the size of the characters will vary from
one font to another.
The default value is 12.
Currently this option does nothing if used with the default GGI
font.
-v, --version
Print version and exit.
EMULATIONggiterm recognizes escape sequences described by the ggiterm termin‐
fo/termcap entry, and accordingly sets the TERM environment variable to
"ggiterm". This entry is basically the vt100 entry, with a few extra
capabilities to allow color handling and to speed up the rendering by
using GGI facilities.
This means that ggiterm is backwards compatible with the vt100 specifi‐
cation. So, on a system which doesn't have the ggiterm entry, you can
always set TERM to "vt100" and have a working ggiterm, however with re‐
duced functionality.
Warning
This is by no means a complete vt100 emulation. Programs which
directly send vt100 escape sequences to the terminal will with‐
out any doubt run into severe problems. Those are fortunately
rare nowadays. Most terminal-based programs rely on curses-like
libraries and will thus run fine.
ENVIRONMENTggiterm sets the TERM variable to "ggiterm" (see above).
The value of the SHELL variable is used to determine which shell should
be spawned by ggiterm.
If not specified otherwise, ggiterm uses the default GGI target. In
most cases this should be just fine. If you wish to provide more op‐
tions or force a particular target, you will have to set the GGI_DIS‐
PLAY and/or the GGI_DEFMODE variables (see the GGI documentation).
Example
$ GGI_DISPLAY=X:-noaccel GGI_DEFMODE=800x600 ggiterm--font cour.ttf
SEE ALSOlibggi(7)AUTHORggiterm was written by Aurelien Reynaud.
GGITERM(1)