ppmtoicr(1) General Commands Manual ppmtoicr(1)
NAME
ppmtoicr - convert a portable pixmap into NCSA ICR format
SYNOPSIS
ppmtoicr [-windowname name] [-expand expand] [-display display] [-rle]
[ppmfile]
DESCRIPTION
Reads a portable pixmap file as input. Produces an NCSA Telnet Inter-
active Color Raster graphic file as output. If ppmfile is not sup-
plied, ppmtoicr will read from standard input.
Interactive Color Raster (ICR) is a protocol for displaying raster
graphics on workstation screens. The protocol is implemented in NCSA
Telnet for the Macintosh version 2.3. The ICR protocol shares charac-
teristics of the Tektronix graphics terminal emulation protocol. For
example, escape sequences are used to control the display.
ppmtoicr will output the appropriate sequences to create a window of
the dimensions of the input pixmap, create a colormap of up to 256 col-
ors on the display, then load the picture data into the window.
Note that there is no icrtoppm tool - this transformation is one way.
OPTIONS
-windownamename
Output will be displayed in name (Default is to use ppm-
file or "untitled" if standard input is read.)
-expandexpand Output will be expanded on display by factor expand (For
example, a value of 2 will cause four pixels to be dis-
played for every input pixel.)
-displaydisplay
Output will be displayed on screen numbered display
-rle Use run-length encoded format for display. (This will
nearly always result in a quicker display, but may skew
the colormap.)
EXAMPLES
To display a ppm file using the protocol:
ppmtoicr ppmfile
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:
ppmtoicr ppmfile > filename
cat filename
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:
giftopnm giffile | ppmtoicr -w giffile -r -e 2
BUGS
The protocol uses frequent fflush calls to speed up display. If the
output is saved to a file for later display via cat, drawing will be
much slower. In either case, increasing the Blocksize limit on the dis-
play will speed up transmission substantially.
SEE ALSO
ppm(5)
NCSA Telnet for the Macintosh, University of Illinois at Urbana-Cham-
paign (1989)
AUTHOR
Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU), Prince-
ton University Computing and Information Technology.
30 July 1990 ppmtoicr(1)
Generated by dwww version 1.14 on Wed Jan 22 15:23:11 CET 2025.