Jerrad Pierce > Text-FIGlet > charmap.pl

Download:
Text-FIGlet-2.19.3.tgz

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Source  

NAME ^

charmap.pl - display a FIGfont with associated codes

SYNOPSIS ^

charmap.pl [ -d=fontdirectory ] [ -f=fontfile ] [ -help ] [ -w=outputwidth ]

DESCRIPTION ^

Charmap doesn't tell you anything you can't find out by viewing a font in your favorite pager. However, it does have a few advantages.

OPTIONS ^

-d=fontdirectory

Change the default font directory. FIGlet looks for fonts first in the default directory and then in the current directory. If the -d option is not specified, FIGlet uses the directory that was specified when it was compiled. To find out which directory this is, use the -I2 option.

-f=fontfile

Select the font. The .flf suffix may be left off of fontfile, in which case FIGlet automatically appends it. FIGlet looks for the file first in the default font directory and then in the current directory, or, if fontfile was given as a full pathname, in the given directory. If the -f option is not specified, FIGlet uses the font that was specified when it was compiled. To find out which font this is, use the -I3 option.

-w=outputwidth

These options control the outputwidth, or the screen width FIGlet assumes when formatting its output. FIGlet uses the outputwidth to determine when to break lines and how to center the output. Normally, FIGlet assumes 80 columns so that people with wide terminals won't annoy the people they e-mail FIGlet output to. -w sets the outputwidth to the given integer. An outputwidth of 1 is a special value that tells FIGlet to print each non- space character, in its entirety, on a separate line, no matter how wide it is. Another special outputwidth is -1, it means to not wrap.

ENVIRONMENT ^

charmap.pl will make use of these environment variables if present

FIGFONT

The default font to load. It should reside in the directory specified by FIGLIB.

FIGLIB

The default location of fonts.

FILES ^

FIGlet home page

 http://st-www.cs.uiuc.edu/users/chai/figlet.html
 http://mov.to/figlet/

FIGlet font files, these can be found at

 http://www.internexus.net/pub/figlet/
 ftp://wuarchive.wustl.edu/graphics/graphics/misc/figlet/
 ftp://ftp.plig.org/pub/figlet/

CAVEATS ^

The Text::Wrap in perl 5.6 or earlier operate on bytes, consequently the display of characters greater than 0x100 end up wrapped across two rows.

SEE ALSO ^

figlet, Text::FIGlet

AUTHOR ^

Jerrad Pierce <jpierce@cpan.org>|<webmaster@pthbb.org>

syntax highlighting: