ppmtosixel(1)

1Ppmtosixel User Manual(0)                            Ppmtosixel User Manual(0)
2
3
4

NAME

6       ppmtosixel - convert a PPM image to DEC sixel format
7
8

SYNOPSIS

10       ppmtosixel
11
12       [-raw]
13
14       [-margin]
15
16       [ppmfile]
17
18

DESCRIPTION

20       This program is part of Netpbm(1).
21
22       ppmtosixel reads a PPM image as input and produces sixel commands (SIX)
23       as output.  The output is formatted for color printing, e.g. for a  DEC
24       LJ250 color inkjet printer.
25
26       If  RGB  values  from  the  PPM file do not have maxval=100, ppmtosixel
27       rescales them to maxval 100.  A printer  control  header  and  a  color
28       assignment  table  begin  the  SIX file.  Image data is in a compressed
29       format by default.  A printer control footer ends the image file.
30
31

OPTIONS

33       In addition to the options common to all programs  based  on  libnetpbm
34       (most notably -quiet, see
35        Common Options ⟨index.html#commonoptions⟩ ), ppmtosixel recognizes the
36       following command line options:
37
38
39
40       -raw   If you specify this, each pixel will be explicitly described  in
41              the  image  file.  If -raw is not specified, output will default
42              to compressed format in  which  identical  adjacent  pixels  are
43              replaced  by  "repeat  pixel"  commands.  A raw file is often an
44              order of magnitude larger than a compressed file and prints much
45              slower.
46
47
48       -margin
49              If  you  don't specify -margin, the image will start at the left
50              margin (of the window, paper, or whatever).  If you  do  specify
51              -margin, a 1.5 inch left margin will offset the image.
52
53
54
55

PRINTING

57       Generally,  sixel files must reach the printer unfiltered.  Use the lpr
58       -x option or cat filename > /dev/tty0?.
59
60

LIMITATIONS

62       Upon rescaling, truncation of the least significant bits of RGB  values
63       may  result  in  poor color conversion.  If the original PPM maxval was
64       greater than 100, rescaling also reduces the image  depth.   While  the
65       actual  RGB  values  from  the  ppm file are more or less retained, the
66       color palette of the LJ250 may not match the  colors  on  your  screen.
67       This seems to be a printer limitation.
68
69

AUTHOR

75       Copyright (C) 1991 by Rick Vinci.
76

DOCUMENT SOURCE

78       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
79       source.  The master documentation is at
80
81              http://netpbm.sourceforge.net/doc/ppmtosixel.html
82
83netpbm documentation             26 April 1991       Ppmtosixel User Manual(0)