.TH ppmtopj 1 "13 July 1991"
.IX ppmtopj
.SH NAME
ppmtopj - convert a portable pixmap to an HP PaintJet file
.SH SYNOPSIS
.B ppmtopj
.RB [-gamma
.IR val ]
.RB [ -xpos
.IR val ]
.RB [ -ypos
.IR val ]
.RB [ -back
.BR dark | lite ]
.RB [ -rle ]
.RB [ -center ]
.RB [ -render
.BR none|snap|bw|dither|diffuse|monodither|monodiffuse|clusterdither|monoclusterdither ]
.RI [ ppmfile ]
.SH DESCRIPTION
Reads a portable pixmap as input and converts it into a format suitable
to be printed by an HP PaintJet printer.
.PP
For best results, the input file should be in 8-color RGB form;
i.e. it should have only
the 8 binary combinations of full-on and full-off primaries.
You could get this by sending the input file through
.I ppmquant -map
with a map file such as:
.nf
    P3
    8 1
    255
    0 0 0      255 0 0    0 255 0    0 0 255
    255 255 0  255 0 255  0 255 255  255 255 255
.fi
Or else you could use use
.I ppmdither -red 2 -green 2 -blue 2.
.SH OPTIONS
.TP 14
.B -rle
Run length encode the image.
(This can result in larger images)
.TP
.B -back
Enhance the foreground by indicating if the background is light or
dark compated to the foreground.
.TP
.BI -render " alg"
Use an internal rendering algorithm (default dither).
.TP
.BI -gamma " int"
Gamma correct the image using the integet parameter as a gamma (default 0).
.TP
.B -center
Center the image to an 8.5 by 11 page
.TP
.BI -xpos " pos"
Move by pos pixels in the x direction.
.TP
.BI -ypos " pos"
Move by pos pixels in the y direction.
.SH REFERENCES
HP PaintJet XL Color Graphics Printer User's Guide
.SH "SEE ALSO"
pnmdepth(1), ppmquant(1), ppmdither(1), ppm(5)
.SH BUGS
Most of the options have not been tested because of the price of the paper.
.SH AUTHOR
Copyright (C) 1991 by Christos Zoulas.
.\" Permission to use, copy, modify, and distribute this software and its
.\" documentation for any purpose and without fee is hereby granted, provided
.\" that the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.  This software is provided "as is" without express or
.\" implied warranty.