Penguin
Recent Changes
Annotated edit history of ppmtoicr(1) version 1, including all changes. View license author blame.
Rev Author # Line
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 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.