toilet(1) [debian man page]
toilet(1) General Commands Manual toilet(1) NAME
TOIlet - display large colourful characters SYNOPSIS
toilet [ -hkostvSW ] [ -d fontdirectory ] [ -f fontfile ] [ -F filter ] [ -w outputwidth ] [ -I infocode ] [ -E format ] [ message ] DESCRIPTION
TOIlet prints text using large characters made of smaller characters. It is similar in many ways to FIGlet with additional features such as Unicode handling, colour fonts, filters and various export formats. USAGE
TOIlet either reads its input from the command line or from the standard input. OPTIONS
-f, --font <name> Use the given font instead of the default value. Fonts are .flf or .tlf files stored in the /usr/share/figlet directory. Fonts are looked first in the font directory, then in the current directory. There is also a special built-in font called term that serves as a fallback if no font is available. -d, --directory <dir> Specify the directory in which to look for fonts. The default value is set at build time and usually defaults to /usr/share/figlet. -s, -S, -k, -W, -o Select character composition rules. -S sets smushing (nicely merging glyphs), -k sets kerning (rendering subcharacters as close to each other as possible), -W renders characters at their full width and -o sets overlapping (glyphs slightly overlap the previous one). -s (default behaviour) uses the font's smushing information if any, otherwise forces overlapping, or does nothing if the glyph only has one subcharacter. -w, --width <width> Set the output width. By default, TOIlet will wrap its output at 80 character columns. -t, --termwidth Set the output width to the terminal width. -F, --filter <filters> -F, --filter list --gay, --metal Specify a list of filters to be applied to the output. <filters> is a colon-separated list of filters such as crop:rotate:gay and the special argument list outputs a list of available filters. --gay and --metal are shortcuts to commonly used filters that are guaranteed to exist. Several -F flags can also be specified on the command line, in which case filters will be applied in order of appearance. -E, --export <format> -E, --export list --irc, --html Specify the output format. By default, TOIlet will output UTF-8 text using ANSI colour codes suitable for most terminals such as XTerm or rxvt. <format> is the name of the export format as recognised by libcaca. The special argument list outputs a list of available export formats. --irc and --html are shortcuts to commonly used export formats that are guaranteed to exist. -h, --help Display a short help message and exit. -I, --infocode <code> Print a FIGlet infocode. This flag is only here for FIGlet compatibility, see the figlet manpage for more information about it. -v, --version Output version information and exit. EXAMPLES
toilet Hello World toilet Hello | toilet tail -f /var/log/messages | toilet -f term --gay BUGS
FIGlet compatibility is not complete yet. AUTHOR
TOIlet and this manual page were written by Sam Hocevar <sam@hocevar.net>. There is a webpage available at http://caca.zoy.org/wiki/toilet . SEE ALSO
figlet(6) libcaca @PACKAGE_VERSION@ 2006-11-10 toilet(1)
Check Out this Related Man Page
fontconverter(1X) fontconverter(1X) NAME
fontconverter - Converts user-defined characters (UDCs) into PCF format SYNOPSIS
fontconverter [-merge] [-w width] [-h height] [-udc udc_name] -font 'font_name' [-preload] preload_file OPTIONS
Specifies that command output be merged with an existing PCF font file. When the -merge option is specified, the command does not create a BDF file. See also the entry for the -font option. Specifies the width of the UDC font glyph. Use this option only when input fonts were created with a width smaller than the one specified for the cedit font-editing window. Specifies the height of the UDC font glyph. Use this option only when input fonts were created with a height smaller than the one specified for the cedit font-editing window. Specifies a non-default registry name when the -merge option is not specified. The file names for output files include base_name as the registry compo- nent, to which the fontconverter command automatically appends width and height specifiers and the and file types. The default registry names for UDC fonts vary according to language, as follows: JISX.UDC, for Japanese DEC.CNS.UDC, for Hanyu GB.UDC, for Hanzi When used with the -merge option, specifies the target font file for the merge operation. When used without the -merge option, specifies the font file whose header is used as a reference for generating the header of the standalone output file. Information in the reference font file is also used to determine default characters in the standalone output file. (A default character is a glyph, usually a square, that is displayed when the font file does not contain a glyph for a speci- fied code.) The reference_font parameter is specified using the format registry_width_height, for example: -font 'JISX.UDC_*' Specifies the file name of the input UDC file in a nondefault position on the command line. Include the -preload option only when specifying the preload_file parameter at a command line position other than last. OPERANDS
Specifies the input UDC font file for which PCF and BDF output formats are generated. DESCRIPTION
The fontconverter command creates PCF format font files for user-defined characters (UDCs) that are created by the font editor of the cedit utility. The PCF format font files allow UDCs to be displayed by X and Motif applications. Note You can also use the cgen command to create standalone PCF and BDF format font files and to merge font information into existing PCF format files. The advantage of using the cgen command for a merge operation is that you do not have to use the mkfontdir and xset commands to make information in the merged PCF file available to applications. EXAMPLES
The following example merges the UDC file, udc_font.pre, into the -*-140-*jisx0208* font. The generated output file is named jisx0208-kanji11_14_14.pcf: % fontconverter -merge -font '*-140-*jisx0208*' udc_font.pre The following example creates standalone font files in both PCF and BDF formats. The output files contain the converted result from udc_font.pre plus the default character and header information from font *-140-*jisx0208* but have the charset registry name deckanji.udc: %fontconverter -udc deckanji.udc -font '*-140-*jisx0208*' udc_font.pre FILES
Contains fontconverter error messages. SEE ALSO
Commands: cedit(1), cgen(1) fontconverter(1X)