home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / NETWORK / netpbm_docs.lzh / NETPBM / DOCS / ppmtoicr.1 < prev    next >
Text File  |  1996-11-18  |  3KB  |  112 lines
  1. .TH ppmtoicr 1 "30 July 1990"
  2. .IX ppmtoicr
  3. .SH NAME
  4. ppmtoicr - convert a portable pixmap into NCSA ICR format 
  5. .SH SYNOPSIS
  6. .B ppmtoicr
  7. .RB [ -windowname
  8. .IR name ]
  9. .RB [ -expand
  10. .IR expand ]
  11. .RB [ -display
  12. .IR display ]
  13. .RB [ -rle ]
  14. .RI [ ppmfile ]
  15. .SH DESCRIPTION
  16. Reads a portable pixmap file as input.
  17. Produces an NCSA Telnet Interactive Color Raster graphic file as output.
  18. .IX "NCSA ICR"
  19. If
  20. .I ppmfile
  21. is not supplied, 
  22. .I ppmtoicr
  23. will read from standard input.
  24. .PP
  25. Interactive Color Raster (ICR) is a protocol for displaying raster
  26. graphics on workstation screens. The protocol is implemented in NCSA
  27. Telnet for the Macintosh version 2.3.
  28. .IX Macintosh
  29. The ICR protocol shares
  30. characteristics of the Tektronix graphics terminal emulation protocol.
  31. .IX Tektronix
  32. For example, escape sequences are used to control the display.
  33. .PP
  34. .I ppmtoicr
  35. will output the appropriate sequences to create a window of the
  36. dimensions of the input pixmap,
  37. create a colormap of up to 256
  38. colors on the display, then load the picture data into the window.
  39. .PP
  40. Note that there is no icrtoppm tool - this transformation is one way.
  41. .SH OPTIONS
  42. .TP 14
  43. .BI -windowname name
  44. Output will be displayed in
  45. .I name
  46. (Default is to use
  47. .I ppmfile
  48. or "untitled" if standard input is read.)
  49. .TP
  50. .BI -expand expand
  51. Output will be expanded on display by factor 
  52. .I expand
  53. (For example, a value of 2 will cause four pixels to be displayed for
  54. every input pixel.)
  55. .TP
  56. .BI -display display
  57. Output will be displayed on screen numbered 
  58. .I display
  59. .TP
  60. .B -rle
  61. Use run-length encoded format for display. (This will nearly always
  62. result in a quicker display, but may skew the colormap.)
  63. .SH EXAMPLES
  64. To display a
  65. .I ppm
  66. file using the protocol:
  67. .nf
  68.     ppmtoicr ppmfile
  69. .fi
  70. This will create a window named 
  71. .I ppmfile
  72. on the display with the correct dimensions for
  73. .I ppmfile,
  74. create and download a colormap of up
  75. to 256 colors, and download the picture into the window. The same effect
  76. may be achieved by the following sequence:
  77. .nf
  78.     ppmtoicr ppmfile > filename
  79.     cat filename
  80. .fi
  81. To display a GIF 
  82. file using the protocol in a window titled after the input file, zoom
  83. the displayed image by a factor of 2, and
  84. run-length encode the data:
  85. .nf
  86.     giftoppm giffile | ppmtoicr -w giffile -r -e 2
  87. .fi
  88. .SH BUGS
  89. .PP
  90. The protocol uses frequent 
  91. .I fflush
  92. calls to speed up display. If the
  93. output is saved to a file for later display via
  94. .I cat,
  95. drawing will be
  96. much slower. In either case, increasing the Blocksize limit on the
  97. display will speed up transmission substantially.
  98. .SH SEE ALSO
  99. .BR ppm(5)
  100. .LP
  101. .IR "NCSA Telnet for the Macintosh" ,
  102. University of Illinois at Urbana-Champaign (1989)
  103. .SH AUTHOR
  104. Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU),
  105. Princeton University Computing and Information Technology.
  106. .\" Permission to use, copy, modify, and distribute this software and its
  107. .\" documentation for any purpose and without fee is hereby granted, provided
  108. .\" that the above copyright notice appear in all copies and that both that
  109. .\" copyright notice and this permission notice appear in supporting
  110. .\" documentation.  This software is provided "as is" without express or
  111. .\" implied warranty.
  112.