home *** CD-ROM | disk | FTP | other *** search
/ Otherware / Otherware_1_SB_Development.iso / amiga / video / render / radiance.lzh / ray / doc / cat1 / ximage.doc < prev    next >
Encoding:
Text File  |  1991-11-24  |  3.4 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XIMAGE(1)                USER COMMANDS                  XIMAGE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      ximage - RADIANCE driver for X window system
  10.  
  11. SYNOPSIS
  12.      ximage [ =geometry ][ -c ncolors ][ -d ][ -b  ][  -m  ][  -g
  13.      gamma ][ -f ][ -e +/-stops ] pixfile
  14.  
  15. DESCRIPTION
  16.      Ximage takes the RADIANCE picture file pixfile and  displays
  17.      it  on  an  X  window  server.   The -c option specifies the
  18.      number of colors to use (default fills color table).  The -d
  19.      option  turns  off  color dithering.  The -b option displays
  20.      the image in black and white  (greyscale).   The  -m  option
  21.      forces  monochrome  output.   The  -g  option  specifies the
  22.      exponent used in gamma correction; the default value is 2.0.
  23.      The  -f option stores a Pixmap on the server side for faster
  24.      refresh.  This may  not  work  with  large  images  on  some
  25.      servers.   The  -e option specifies an exposure compensation
  26.      in f-stops (powers of two).  Only integer stops are allowed,
  27.      for efficiency.
  28.  
  29.      If no pixfile is given, input is read  from  stdin  provided
  30.      either  the  -b or -m option is in effect.  However, many of
  31.      the commands given below will not work.
  32.  
  33. COMMANDS
  34.      Once a picture is displayed, the user may perform  a  number
  35.      of  operations.   Some of the operations make use of an area
  36.      of interest, defined by pressing a mouse button and dragging
  37.      the  cursor  over a section of the image.  Pressing a button
  38.      and immediately releasing it defines a single point  as  the
  39.      area of interest.  A command is a single character.
  40.  
  41.      q         Quit program.
  42.  
  43.      <space>   Redraw the area of interest.
  44.  
  45.      ^R        Redraw the entire image.
  46.  
  47.      <return>  Display the radiance averaged  over  the  area  of
  48.                interest.
  49.  
  50.      l         Display  the  luminance  value  in  the  area   of
  51.                interest.
  52.  
  53.      c         Display the color in the area of interest.
  54.  
  55.      p         Display the x and y location of the cursor.
  56.  
  57.      i         Identify identical pixels by  assigning  a  random
  58.                color  at the cursor position.  This is useful for
  59.                displaying contours, especially when combined with
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XIMAGE(1)                USER COMMANDS                  XIMAGE(1)
  71.  
  72.  
  73.  
  74.                the -b option.
  75.  
  76.      t         Print the ray origin and direction for  the  given
  77.                cursor  location.   This  can  be used as input to
  78.                rtrace(1) to get additional information about  the
  79.                image (ie. pipe the output of ximage into rtrace).
  80.  
  81.      =         Adjust the exposure to the area  of  interest.   A
  82.                crude  adjustment  is  made  immediately,  and the
  83.                number of stops is printed while  the  colors  are
  84.                resampled.   After  a few seconds to a minute, the
  85.                final  image  is  redisplayed.   If  the  area  of
  86.                interest  is  already  within 1 stop of the ideal,
  87.                the bell is sounded and no adjustment is made.
  88.  
  89.      In addition to the commands listed  above,  the  control  or
  90.      shift key may be held while the cursor is dragged to reposi-
  91.      tion the image within the window.
  92.  
  93. AUTHORS
  94.      Greg Ward
  95.      Paul Heckbert provided the code for color quantization
  96.  
  97. SEE ALSO
  98.      aedimage(1), pfilt(1), rpict(1), rtrace(1)
  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. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.