home *** CD-ROM | disk | FTP | other *** search
/ Mega A/V / mega_av.zip / mega_av / GRAPHUTL / PBMPLUS.ZIP / PPMTOICR.MAN < prev    next >
Text File  |  1991-08-11  |  5KB  |  133 lines
  1.  
  2.  
  3. ppmtoicr(1)                Unix Programmer's Manual                ppmtoicr(1)
  4.  
  5.  
  6. NNNAAAMMMEEE
  7.      ppmtoicr - convert a portable pixmap into NCSA ICR format
  8.  
  9. SSSYYYNNNOOOPPPSSSIIISSS
  10.      ppppppmmmtttoooiiicccrrr [-wwwiiinnndddooowwwnnnaaammmeee _n_a_m_e] [-eeexxxpppaaannnddd _e_x_p_a_n_d]  [-dddiiisssppplllaaayyy  _d_i_s_p_l_a_y]  [-rrrllleee]
  11.      [_p_p_m_f_i_l_e]
  12.  
  13. DDDEEESSSCCCRRRIIIPPPTTTIIIOOONNN
  14.      Reads  a  portable  pixmap  file  as  input.   Produces  an  NCSA  Telnet
  15.      Interactive  Color  Raster  graphic  file  as  output.  If _p_p_m_f_i_l_e is not
  16.      supplied, _p_p_m_t_o_i_c_r will read from standard input.
  17.  
  18.      Interactive Color Raster  (ICR)  is  a  protocol  for  displaying  raster
  19.      graphics  on  workstation  screens.  The  protocol is implemented in NCSA
  20.      Telnet  for  the  Macintosh  version  2.3.  The   ICR   protocol   shares
  21.      characteristics  of  the  Tektronix graphics terminal emulation protocol.
  22.      For example, escape sequences are used to control the display.
  23.  
  24.      _p_p_m_t_o_i_c_r will output the appropriate sequences to create a window of  the
  25.      dimensions  of the input pixmap, create a colormap of up to 256 colors on
  26.      the display, then load the picture data into the window.
  27.  
  28.      Note that there is no icrtoppm tool - this transformation is one way.
  29.  
  30. OOOPPPTTTIIIOOONNNSSS
  31.  
  32.      ---wwwiiinnndddooowwwnnnaaammmeee _n_a_m_e
  33.                    Output will be displayed in _n_a_m_e (Default is to use _p_p_m_f_i_l_e
  34.                    or "untitled" if standard input is read.)
  35.  
  36.      ---eeexxxpppaaannnddd _e_x_p_a_n_d
  37.                    Output will be expanded on display by  factor  _e_x_p_a_n_d  (For
  38.                    example,  a  value  of  2  will  cause  four  pixels  to be
  39.                    displayed for every input pixel.)
  40.  
  41.      ---dddiiisssppplllaaayyy _d_i_s_p_l_a_y
  42.                    Output will be displayed on screen numbered _d_i_s_p_l_a_y
  43.  
  44.      ---rrrllleee          Use run-length  encoded  format  for  display.  (This  will
  45.                    nearly always result in a quicker display, but may skew the
  46.                    colormap.)
  47.  
  48. EEEXXXAAAMMMPPPLLLEEESSS
  49.      To display a _p_p_m file using the protocol:
  50.          ppmtoicr ppmfile
  51.      This will create a window named _p_p_m_f_i_l_e on the display with  the  correct
  52.      dimensions  for  _p_p_m_f_i_l_e,  create  and  download  a colormap of up to 256
  53.      colors, and download the picture into the window. The same effect may  be
  54.      achieved by the following sequence:
  55.          ppmtoicr ppmfile > filename
  56.          cat filename
  57.      To display a GIF file using the protocol in a  window  titled  after  the
  58.      input  file,  zoom  the  displayed image by a factor of 2, and run-length
  59.      encode the data:
  60.          giftoppm giffile | ppmtoicr -w giffile -r -e 2
  61.      _p_p_m_t_o_i_c_r will also read  _p_b_m  and  _p_g_m  files.  The  full  range  of  pbm
  62.  
  63.  
  64.                                 30 July 1990                                 1
  65.  
  66.  
  67.  
  68.  
  69. ppmtoicr(1)                Unix Programmer's Manual                ppmtoicr(1)
  70.  
  71.  
  72.      manipulation routines may  be  applied  to  graphics  for  display  using
  73.      _p_p_m_t_o_i_c_r.  Thus,  a  monochrome  Sun raster file may be viewed in 5 color
  74.      grayscale by the following sequence:
  75.          pnmtorast rasterfile | pnmscale .5 | ppmtoicr
  76.  
  77. BBBUUUGGGSSS
  78.  
  79.      The protocol uses frequent _f_f_l_u_s_h calls  to  speed  up  display.  If  the
  80.      output is saved to a file for later display via _c_a_t, drawing will be much
  81.      slower. In either case, increasing the Blocksize  limit  on  the  display
  82.      will speed up transmission substantially.
  83.  
  84. SSSEEEEEE AAALLLSSSOOO
  85.      ppppppmmm(((555)))
  86.  
  87.      _N_C_S_A _T_e_l_n_e_t _f_o_r _t_h_e _M_a_c_i_n_t_o_s_h, University of Illinois at Urbana-Champaign
  88.      (1989)
  89.  
  90. AAAUUUTTTHHHOOORRR
  91.      Copyright (C) 1990 by Kanthan Pillay (svpillay@Princeton.EDU),  Princeton
  92.      University Computing and Information Technology.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                 30 July 1990                                 2
  131.  
  132.  
  133.