ppmtoicr(1)

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

NAME

6       ppmtoicr - convert a PPM image into NCSA ICR format
7
8

SYNOPSIS

10       ppmtoicr
11
12       [-windowname name]
13
14       [-expand expand]
15
16       [-display display]
17
18       [-rle]
19
20       [ppmfile]
21
22
23

DESCRIPTION

25       This program is part of Netpbm(1).
26
27       ppmtoicr  reads  a PPM file as input.  Produces an NCSA Telnet Interac‐
28       tive Color Raster graphic file as output.
29
30       If ppmfile is not supplied, ppmtoicr reads from Standard Input.
31
32       Interactive Color Raster (ICR) is  a  protocol  for  displaying  raster
33       graphics  on  workstation  screens. The protocol is implemented in NCSA
34       Telnet for the Macintosh version 2.3.  The ICR protocol shares  charac‐
35       teristics  of  the Tektronix graphics terminal emulation protocol.  For
36       example, escape sequences are used to control the display.
37
38       ppmtoicr will output the appropriate sequences to create  a  window  of
39       the  dimensions of the input image, create a colormap of up to 256 col‐
40       ors on the display, then load the picture data into the window.
41
42       Note that there is no icrtoppm tool - this transformation is one way.
43
44
45

OPTIONS

47       -windowname name
48              Output will be displayed in name (Default is to use  ppmfile  or
49              "untitled" if the input is from Standard Input).
50
51
52       -expand expand
53              Output  will  be expanded on display by factor expand (For exam‐
54              ple, a value of 2 will cause four pixels  to  be  displayed  for
55              every input pixel.)
56
57
58       -display display
59              Output will be displayed on screen numbered display
60
61
62
63
64

EXAMPLES

66       To display a PPM file named ppmfile using the protocol:
67
68           ppmtoicr ppmfile
69
70       This will create a window named ppmfile on the display with the correct
71       dimensions for ppmfile, create and download a colormap  of  up  to  256
72       colors,  and download the picture into the window.  You may achieve the
73       same effect with the following sequence:
74
75           ppmtoicr ppmfile > filename
76           cat filename
77
78       To display a GIF file using the protocol in a window titled  after  the
79       input  file,  zoom the displayed image by a factor of 2, and run-length
80       encode the data:
81
82           giftopnm giffile | ppmtoicr -w giffile -r -e 2
83
84

LIMITATIONS

86       The protocol uses frequent fflush() calls to speed up display.  If  you
87       save the output to a file for later display via cat, ppmtoicr will draw
88       much more slowly.  In either case, increasing the  blocksize  limit  on
89       the display will speed up transmission substantially.
90
91
92

HISTORY

102       Until Netpbm 10.71 (June 2015), there was  a  -rle  option  documented,
103       which  was said to cause the output to use run length encoding compres‐
104       sion.  But because of a simple  bug  in  option  processing  code,  the
105       option  never  had  any  effect.  And the compression code did not look
106       like it worked anyway and would take a fair  amount  of  work  to  fix.
107       Because  it was unlikely anyone would ever use this program again, much
108       less want to use run length encoding, we removed it from the documenta‐
109       tion rather than fix the code.
110
111
112

AUTHOR

114       Copyright  (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU), Prince‐
115       ton University Computing and Information Technology.
116

DOCUMENT SOURCE

118       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
119       source.  The master documentation is at
120
121              http://netpbm.sourceforge.net/doc/ppmtoicr.html
122
123netpbm documentation             05 June 2015          Ppmtoicr User Manual(0)