1Ppmtoicr User Manual(0) Ppmtoicr User Manual(0)
2
6 ppmtoicr - convert a PPM image into NCSA ICR format
7
10 ppmtoicr
11 [-windowname name]
13 [-expand expand]
15 [-display display]
17 [ppmfile]
19 Minimum unique abbreviation of option is acceptable. You may use dou‐
21 ble hyphens instead of single hyphen to denote options. You may use
22 white space in place of the equals sign to separate an option name from
23 its value.
24
28 This program is part of Netpbm(1).
29 ppmtoicr reads a PPM file as input. Produces an NCSA Telnet Interac‐
31 tive Color Raster graphic file as output.
32 If ppmfile is not supplied, ppmtoicr reads from Standard Input.
34 Interactive Color Raster (ICR) is a protocol for displaying raster
36 graphics on workstation screens. The protocol is implemented in NCSA
37 Telnet for the Macintosh version 2.3. The ICR protocol shares charac‐
38 teristics of the Tektronix graphics terminal emulation protocol. For
39 example, escape sequences are used to control the display.
40 ppmtoicr will output the appropriate sequences to create a window of
42 the dimensions of the input image, create a colormap of up to 256 col‐
43 ors on the display, then load the picture data into the window.
44 Note that there is no icrtoppm tool - this transformation is one way.
46
49 In addition to the options common to all programs based on libnetpbm
50 (most notably -quiet, see
51 Common Options ⟨index.html#commonoptions⟩ ), ppmtoicr recognizes the
52 following command line options:
53 -windowname name
57 Output will be displayed in name.
58 name must be printable characters, and not '^'.
60 Default is to use the input file name if specified on the com‐
62 mand line or
63 "untitled" if the input is from Standard Input. In the former
64 case, any
65 unprintable character or '^' in the file name becomes a
66 '.' in the window name.
67 -expand expand
70 Output will be expanded on display by factor expand (For exam‐
71 ple, a value of 2 will cause four pixels to be displayed for ev‐
72 ery input pixel.)
73 -display display
76 Output will be displayed on screen numbered display
77
82 To display a PPM file named ppmfile using the protocol:
83 ppmtoicr ppmfile
85 This will create a window named ppmfile on the display with the correct
88 dimensions for ppmfile, create and download a colormap of up to 256
89 colors, and download the picture into the window. You may achieve the
90 same effect with the following sequence:
91 ppmtoicr ppmfile > filename
93 cat filename
94 To display a GIF file using the protocol in a window titled after the
97 input file, zoom the displayed image by a factor of 2:
98 giftopnm giffile | ppmtoicr -windowname=giffile -expand=2
100
104 The protocol uses frequent fflush() calls to speed up display. If you
105 save the output to a file for later display via cat, ppmtoicr will draw
106 much more slowly. In either case, increasing the blocksize limit on
107 the display will speed up transmission substantially.
108
111 ppm(1)
112 NCSA Telnet for the Macintosh, University of Illinois at Urbana-Cham‐
114 paign (1989)
115
118 Until Netpbm 10.71 (June 2015), there was a -rle option documented,
119 which was said to cause the output to use run length encoding compres‐
120 sion. But because of a simple bug in option processing code, the op‐
121 tion never had any effect. And the compression code did not look like
122 it worked anyway and would take a fair amount of work to fix. Because
123 it was unlikely anyone would ever use this program again, much less
124 want to use run length encoding, we removed it from the documentation
125 rather than fix the code.
126
129 Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU), Prince‐
130 ton University Computing and Information Technology.
131
133 This manual page was generated by the Netpbm tool 'makeman' from HTML
134 source. The master documentation is at
135 http://netpbm.sourceforge.net/doc/ppmtoicr.html
137netpbm documentation 17 July 2022 Ppmtoicr User Manual(0)