summaryrefslogtreecommitdiffstats
path: root/upstream/opensuse-leap-15-6/man1/ppmtosixel.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/opensuse-leap-15-6/man1/ppmtosixel.1')
-rw-r--r--upstream/opensuse-leap-15-6/man1/ppmtosixel.191
1 files changed, 91 insertions, 0 deletions
diff --git a/upstream/opensuse-leap-15-6/man1/ppmtosixel.1 b/upstream/opensuse-leap-15-6/man1/ppmtosixel.1
new file mode 100644
index 00000000..49f0203f
--- /dev/null
+++ b/upstream/opensuse-leap-15-6/man1/ppmtosixel.1
@@ -0,0 +1,91 @@
+\
+.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
+.\" Do not hand-hack it! If you have bug fixes or improvements, please find
+.\" the corresponding HTML page on the Netpbm website, generate a patch
+.\" against that, and send it to the Netpbm maintainer.
+.TH "Ppmtosixel User Manual" 0 "26 April 1991" "netpbm documentation"
+
+.UN lbAB
+.SH NAME
+
+ppmtosixel - convert a PPM image to DEC sixel format
+
+.UN lbAC
+.SH SYNOPSIS
+
+\fBppmtosixel\fP
+
+[\fB-raw\fP]
+
+[\fB-margin\fP]
+
+[\fIppmfile\fP]
+
+.UN lbAD
+.SH DESCRIPTION
+.PP
+This program is part of
+.BR "Netpbm" (1)\c
+\&.
+.PP
+\fBppmtosixel\fP 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.
+.PP
+If RGB values from the PPM file do not have maxval=100,
+\fBppmtosixel\fP 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.
+
+.UN lbAE
+.SH OPTIONS
+
+
+.TP
+\fB-raw\fP
+If you specify this, each pixel will be explicitly described in
+the image file. If \fB-raw\fP is not specified, output will default
+to compressed format in which identical adjacent pixels are replaced
+by "repeat pixel" commands. A raw file is often an order of
+magnitude larger than a compressed file and prints much slower.
+
+.TP
+\fB-margin\fP
+If you don't specify \fB-margin\fP, the image will start at the
+left margin (of the window, paper, or whatever). If you \fIdo\fP
+specify \fB-margin\fP, a 1.5 inch left margin will offset the image.
+
+
+
+.UN lbAF
+.SH PRINTING
+.PP
+Generally, sixel files must reach the printer unfiltered.
+Use the lpr -x option or \fBcat filename > /dev/tty0?\fP.
+
+.UN lbAG
+.SH LIMITATIONS
+
+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.
+
+.UN lbAH
+.SH SEE ALSO
+.BR "ppm" (5)\c
+\&
+
+.UN lbAI
+.SH AUTHOR
+
+Copyright (C) 1991 by Rick Vinci.
+.SH DOCUMENT SOURCE
+This manual page was generated by the Netpbm tool 'makeman' from HTML
+source. The master documentation is at
+.IP
+.B http://netpbm.sourceforge.net/doc/ppmtosixel.html
+.PP \ No newline at end of file