about summary refs log tree commit diff
path: root/ppmtosixel.html
diff options
context:
space:
mode:
authorgiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
committergiraffedata <giraffedata@9d0c8265-081b-0410-96cb-a4ca84ce46f8>2006-12-25 03:06:05 +0000
commit1017cbebe5d5edd859e0fddad0a8600f509f4821 (patch)
tree78bdf336648566f7a7d55f42837357dea3dd674c /ppmtosixel.html
parent16f2ac126651015a376eba864a3a35f738b0b25a (diff)
downloadnetpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.gz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.tar.xz
netpbm-mirror-1017cbebe5d5edd859e0fddad0a8600f509f4821.zip
Place user guide into Subversion repository
git-svn-id: http://svn.code.sf.net/p/netpbm/code/userguide@181 9d0c8265-081b-0410-96cb-a4ca84ce46f8
Diffstat (limited to 'ppmtosixel.html')
-rw-r--r--ppmtosixel.html100
1 files changed, 100 insertions, 0 deletions
diff --git a/ppmtosixel.html b/ppmtosixel.html
new file mode 100644
index 00000000..e9b6d63a
--- /dev/null
+++ b/ppmtosixel.html
@@ -0,0 +1,100 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<HTML><HEAD><TITLE>Ppmtosixel User Manual</TITLE></HEAD>
+<BODY>
+<H1>ppmtosixel</H1>
+Updated: 26 April 1991
+<BR>
+<A HREF="#index">Table Of Contents</A>
+
+<A NAME="lbAB">&nbsp;</A>
+<H2>NAME</H2>
+
+ppmtosixel - convert a PPM image to 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>
+
+<p>This program is part of <a href="index.html">Netpbm</a>.
+
+<p><b>ppmtosixel</b> reads a PPM image as input and 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,
+<b>ppmtosixel</b> rescales them to maxval 100.  A printer control
+header and a color assignment table begin the SIX file.  Image data is
+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><B>-raw</B>
+
+<DD>If you specify this, 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><B>-margin</B>
+
+<DD>If you don't specify <B>-margin</B>, the image will start at the
+left margin (of the window, paper, or whatever).  If you <em>do</em>
+specify <B>-margin</B>, a 1.5 inch left margin will offset the image.
+
+</DL>
+
+<A NAME="lbAF">&nbsp;</A>
+<H2>PRINTING</H2>
+
+<p>Generally, sixel files must reach the printer unfiltered.
+Use the lpr -x option or <b>cat filename &gt; /dev/tty0?</b>.
+
+<A NAME="lbAG">&nbsp;</A>
+<H2>LIMITATIONS</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="ppm.html">ppm</A>
+
+<A NAME="lbAI">&nbsp;</A>
+<H2>AUTHOR</H2>
+
+Copyright (C) 1991 by Rick Vinci.
+
+<HR>
+<A NAME="index">&nbsp;</A>
+<H2>Table Of Contents</H2>
+<UL>
+<LI><A HREF="#lbAB">NAME</A>
+<LI><A HREF="#lbAC">SYNOPSIS</A>
+<LI><A HREF="#lbAD">DESCRIPTION</A>
+<LI><A HREF="#lbAE">OPTIONS</A>
+<LI><A HREF="#lbAF">PRINTING</A>
+<LI><A HREF="#lbAG">LIMITATIONS</A>
+<LI><A HREF="#lbAH">SEE ALSO</A>
+<LI><A HREF="#lbAI">AUTHOR</A>
+</UL>
+</BODY>
+</HTML>