man-pages/man1/ppmtosixel.1.html
2021-03-31 01:06:50 +01:00

118 lines
2.9 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of ppmtosixel</TITLE>
</HEAD><BODY>
<H1>ppmtosixel</H1>
Section: User Commands (1)<BR>Updated: 26 April 1991<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="ixAAB"></A>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
ppmtosixel - convert a portable pixmap into DEC sixel format
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>ppmtosixel</B>
[<B>-raw</B>]
[<B>-margin</B>]
[<I>ppmfile</I>]
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
Reads a portable pixmap as input.
Produces sixel commands (SIX) as output.
The output is formatted for color printing, e.g. for a DEC LJ250 color
inkjet printer.
<P>
If RGB values from the PPM file do not have maxval=100,
the RGB values are rescaled.
A printer control header and a color assignment table begin the SIX file.
Image data is written in a compressed format by default.
A printer control footer ends the image file.
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<DL COMPACT>
<DT id="1"><B>-raw</B>
<DD>
If specified, each pixel will be explicitly described in the image file.
If
<B>-raw</B>
is not specified, output will default to compressed format in which
identical adjacent pixels are replaced by &quot;repeat pixel&quot; commands.
A raw file is often an order of magnitude larger than a compressed
file and prints much slower.
<DT id="2"><B>-margin</B>
<DD>
If
<B>-margin</B>
is not specified, the image will be start at the left margin
(of the window, paper, or whatever).
If
<B>-margin</B>
is specified, a 1.5 inch left margin will offset the image.
</DL>
<A NAME="lbAF">&nbsp;</A>
<H2>PRINTING</H2>
Generally, sixel files must reach the printer unfiltered.
Use the lpr -x option or cat filename &gt; /dev/tty0?.
<A NAME="lbAG">&nbsp;</A>
<H2>BUGS</H2>
Upon rescaling, truncation of the least significant bits of RGB values
may result in poor color conversion.
If the original PPM maxval was greater than 100, rescaling also
reduces the image depth.
While the actual RGB values from the ppm file are more or less
retained, the color palette of the LJ250 may not match the colors
on your screen.
This seems to be a printer limitation.
<A NAME="lbAH">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?5+ppm">ppm</A>(5)
<A NAME="lbAI">&nbsp;</A>
<H2>AUTHOR</H2>
Copyright (C) 1991 by Rick Vinci.
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="3"><A HREF="#lbAB">NAME</A><DD>
<DT id="4"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="5"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="6"><A HREF="#lbAE">OPTIONS</A><DD>
<DT id="7"><A HREF="#lbAF">PRINTING</A><DD>
<DT id="8"><A HREF="#lbAG">BUGS</A><DD>
<DT id="9"><A HREF="#lbAH">SEE ALSO</A><DD>
<DT id="10"><A HREF="#lbAI">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:25 GMT, March 31, 2021
</BODY>
</HTML>