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       -raw   If you specify this, each pixel will be explicitly described  in
34              the  image  file.  If -raw is not specified, output will default
35              to compressed format in  which  identical  adjacent  pixels  are
36              replaced  by  'repeat  pixel'  commands.  A raw file is often an
37              order of magnitude larger than a compressed file and prints much
38              slower.
39
40
41       -margin
42              If  you  don't specify -margin, the image will start at the left
43              margin (of the window, paper, or whatever).  If you  do  specify
44              -margin, a 1.5 inch left margin will offset the image.
45
46
47
48

PRINTING

50       Generally,  sixel files must reach the printer unfiltered.  Use the lpr
51       -x option or cat filename > /dev/tty0?.
52
53

LIMITATIONS

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

AUTHOR

68       Copyright (C) 1991 by Rick Vinci.
69
70
71
72netpbm documentation             26 April 1991       Ppmtosixel User Manual(0)