Unix/Linux Go Back    


CentOS 7.0 - man page for ppmtoicr (centos section 0)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Ppmtoicr User Manual(0) 						  Ppmtoicr User Manual(0)

NAME
       ppmtoicr - convert a PPM image into NCSA ICR format

SYNOPSIS
       ppmtoicr

       [-windowname name]

       [-expand expand]

       [-display display]

       [-rle]

       [ppmfile]

DESCRIPTION
       This program is part of Netpbm(1)

       ppmtoicr  reads	a  PPM	file  as input.  Produces an NCSA Telnet Interactive Color Raster
       graphic file as output.

       If ppmfile is not supplied, ppmtoicr reads 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 image, 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 name
	      Output  will  be	displayed in name (Default is to use ppmfile or 'untitled' if the
	      input is from Standard Input).

       -expand expand
	      Output will be expanded on display by factor expand (For example, a value of 2 will
	      cause four pixels to be displayed for every input pixel.)

       -display display
	      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 named ppmfile 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.  You may achieve the same effect with 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

LIMITATIONS
       The  protocol uses frequent fflush() calls to speed up display.	If you save the output to
       a file for later display via cat, ppmtoicr will draw much more slowly.	In  either  case,
       increasing the blocksize limit on the display will speed up transmission substantially.

SEE ALSO
       ppm(1)

       NCSA Telnet for the Macintosh, University of Illinois at Urbana-Champaign (1989)

AUTHOR
       Copyright  (C)  1990 by Kanthan Pillay (svpillay@Princeton.EDU), Princeton University Com-
       puting and Information Technology.

netpbm documentation			   30 July 1990 		  Ppmtoicr User Manual(0)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 06:07 PM.