.TH clt2pbm 1 "2014-01-06" "hxtools" "hxtools"
.SH Name
.PP
clt2pbm \(em convert Consoleet text bitmaps to PBM Portable Bitmap
.SH Syntax
.PP
\fBclt2pbm\fP [[\fB\-x\fP \fIscale\fP [\fB\-y\fP \fIscale\fP]|\fB\-s\fP
\fIscale\fP] [\fIfile\fP...]
.SH Description
.PP
clt2pbm takes a Consoleet text bitmap file and converts it to Portable Bitmap
(netpbm) P1 format, optionally upscaling it in the process in either or both
dimensions.
.PP
For each file given on the command line, a new file will be created, which has
the ".txt" extension of the original file removed (if any) and ".pbm" appended.
If no filenames are given, the program reads from stdin and writes to stdout.
.SH Options
.TP
\fB\-s\fP \fIfactor\fP
Scale by the given positive integral factor in both the x and y directions.
This overrides any \fB\-x\fP or \fB\-y\fP options.
.TP
\fB\-x\fP \fIfactor\fP
Scale by the given positive integral factor in the horizontal direction.
.TP
\fB\-y\fP \fIfactor\fP
Scale by the given positive integral factor in the vertical direction.
.SH The Consoleet bitmap format
.PP
The Consoleet text bitmap format is very similar to PBM itself. Instead of "P1"
as in PBM, a CLT file begins with "PCLT" on the first line. In the second line,
width and height of the bitmap in pixels is given. What follow is the bitmap
data: Each "off" pixel is represented by the 2-character string ".." or "  "
(any space character considered by \fBisspace\fP(3)). Each "on" pixel is
represented by any other 2-character string \(em for contrast, a "large"
character is usually chosen, such as '#'. Each row of pixels is terminated by a
newline, like in PBM.
.nf
	PCLT
	9 7
	..................
	....WW....##..##..
	..WW..WW..##..##..
	..WW..WW..####....
	..WW..WW..##..##..
	....WW....##..##..
	..................
.fi
.SH See also
.PP
\fBhxtools\fP(7), \fBfnt2bdf\fP(1)