# ppmtoicr(1) - man - phpMan

[ppmtoicr(1)](https://www.chedong.com/phpMan.php/man/ppmtoicr/1/markdown)                            General Commands Manual                           [ppmtoicr(1)](https://www.chedong.com/phpMan.php/man/ppmtoicr/1/markdown)



## 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 Interactive Color Raster
       graphic file as output.  If _ppmfile_ is not supplied, _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 characteristics 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 colors on the display,  then  load  the  picture
       data into the window.

       Note that there is no icrtoppm tool - this transformation is one way.

## OPTIONS
### -windowname
                     Output  will  be  displayed in _name_ (Default is to use _ppmfile_ or "untitled" if
                     standard input is read.)

### -expand
                     will cause four pixels to be displayed for every input pixel.)

### -display
                     Output will be displayed on screen numbered _display_

### -rle
                     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  _ppm__‐
       _file,_  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 Block‐
       size limit on the display will speed up transmission substantially.

## SEE ALSO
### [ppm(5)](https://www.chedong.com/phpMan.php/man/ppm/5/markdown)

       _NCSA_ _Telnet_ _for_ _the_ _Macintosh_, University of Illinois at Urbana-Champaign (1989)

## AUTHOR
       Copyright (C) 1990 by Kanthan Pillay (<svpillay@Princeton.EDU>), Princeton University Computing
       and Information Technology.



                                            30 July 1990                                 [ppmtoicr(1)](https://www.chedong.com/phpMan.php/man/ppmtoicr/1/markdown)