1 |
perry |
1 |
ppmtoicr |
|
|
2 |
!!!ppmtoicr |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
EXAMPLES |
|
|
8 |
BUGS |
|
|
9 |
SEE ALSO |
|
|
10 |
AUTHOR |
|
|
11 |
---- |
|
|
12 |
!!NAME |
|
|
13 |
|
|
|
14 |
|
|
|
15 |
ppmtoicr - convert a portable pixmap into NCSA ICR format |
|
|
16 |
!!SYNOPSIS |
|
|
17 |
|
|
|
18 |
|
|
|
19 |
__ppmtoicr__ [[__-windowname__ ''name''] |
|
|
20 |
[[__-expand__ ''expand''] [[__-display__ |
|
|
21 |
''display''] [[__-rle__] [[''ppmfile''] |
|
|
22 |
!!DESCRIPTION |
|
|
23 |
|
|
|
24 |
|
|
|
25 |
Reads a portable pixmap file as input. Produces an NCSA |
|
|
26 |
Telnet Interactive Color Raster graphic file as output. If |
|
|
27 |
''ppmfile'' is not supplied, ''ppmtoicr'' will read |
|
|
28 |
from standard input. |
|
|
29 |
|
|
|
30 |
|
|
|
31 |
Interactive Color Raster (ICR) is a protocol for displaying |
|
|
32 |
raster graphics on workstation screens. The protocol is |
|
|
33 |
implemented in NCSA Telnet for the Macintosh version 2.3. |
|
|
34 |
The ICR protocol shares characteristics of the Tektronix |
|
|
35 |
graphics terminal emulation protocol. For example, escape |
|
|
36 |
sequences are used to control the display. |
|
|
37 |
|
|
|
38 |
|
|
|
39 |
''ppmtoicr'' will output the appropriate sequences to |
|
|
40 |
create a window of the dimensions of the input pixmap, |
|
|
41 |
create a colormap of up to 256 colors on the display, then |
|
|
42 |
load the picture data into the window. |
|
|
43 |
|
|
|
44 |
|
|
|
45 |
Note that there is no icrtoppm tool - this transformation is |
|
|
46 |
one way. |
|
|
47 |
!!OPTIONS |
|
|
48 |
|
|
|
49 |
|
|
|
50 |
__-windowname__''name'' |
|
|
51 |
|
|
|
52 |
|
|
|
53 |
Output will be displayed in ''name'' (Default is to use |
|
|
54 |
''ppmfile'' or |
|
|
55 |
'' |
|
|
56 |
|
|
|
57 |
|
|
|
58 |
__-expand__''expand'' |
|
|
59 |
|
|
|
60 |
|
|
|
61 |
Output will be expanded on display by factor ''expand'' |
|
|
62 |
(For example, a value of 2 will cause four pixels to be |
|
|
63 |
displayed for every input pixel.) |
|
|
64 |
|
|
|
65 |
|
|
|
66 |
__-display__''display'' |
|
|
67 |
|
|
|
68 |
|
|
|
69 |
Output will be displayed on screen numbered |
|
|
70 |
''display'' |
|
|
71 |
|
|
|
72 |
|
|
|
73 |
__-rle__ Use run-length encoded format for display. (This |
|
|
74 |
will nearly always result in a quicker display, but may skew |
|
|
75 |
the colormap.) |
|
|
76 |
!!EXAMPLES |
|
|
77 |
|
|
|
78 |
|
|
|
79 |
To display a ''ppm'' file using the |
|
|
80 |
protocol: |
|
|
81 |
|
|
|
82 |
|
|
|
83 |
ppmtoicr ppmfile |
|
|
84 |
This will create a window named ''ppmfile'' on the display with the correct dimensions for ''ppmfile,'' create and download a colormap of up to 256 colors, and download the picture into the window. The same effect may be achieved by the following sequence: |
|
|
85 |
|
|
|
86 |
|
|
|
87 |
ppmtoicr ppmfile |
|
|
88 |
To display a GIF file using the protocol in a window titled after the input file, zoom the displayed image by a factor of 2, and run-length encode the data: |
|
|
89 |
|
|
|
90 |
|
|
|
91 |
giftopnm giffile | ppmtoicr -w giffile -r -e 2 |
|
|
92 |
!!BUGS |
|
|
93 |
|
|
|
94 |
|
|
|
95 |
The protocol uses frequent ''fflush'' calls to speed up |
|
|
96 |
display. If the output is saved to a file for later display |
|
|
97 |
via ''cat,'' drawing will be much slower. In either case, |
|
|
98 |
increasing the Blocksize limit on the display will speed up |
|
|
99 |
transmission substantially. |
|
|
100 |
!!SEE ALSO |
|
|
101 |
|
|
|
102 |
|
|
|
103 |
__ppm(5)__ |
|
|
104 |
|
|
|
105 |
|
|
|
106 |
''NCSA Telnet for the Macintosh'', University of Illinois |
|
|
107 |
at Urbana-Champaign (1989) |
|
|
108 |
!!AUTHOR |
|
|
109 |
|
|
|
110 |
|
|
|
111 |
Copyright (C) 1990 by Kanthan Pillay |
|
|
112 |
(svpillay@Princeton.EDU), Princeton University Computing and |
|
|
113 |
Information Technology. |
|
|
114 |
---- |