ggiterm man page on aLinux

Man page or keyword search:  
man Server   7435 pages
apropos Keyword Search (all sections)
Output format
aLinux logo
[printable version]

GGITERM(1)							    GGITERM(1)

       ggiterm - Terminal emulator for GGI

       ggiterm [OPTIONS]

       ggiterm	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.

       -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‐

	      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
	      at 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

       -v, --version
	      Print version and exit.

       ggiterm 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.


	      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.

       ggiterm 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).

       $  GGI_DISPLAY=X:-noaccel GGI_DEFMODE=800x600 ggiterm --font cour.ttf


       ggiterm was written by Aurelien Reynaud.


List of man pages available for aLinux

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net