home *** CD-ROM | disk | FTP | other *** search
/ Encyclopedia of Graphics File Formats Companion / GFF_CD.ISO / formats / brl / spec / bw.txt < prev    next >
Text File  |  1994-06-01  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. BW(5)                     FILE FORMATS                      BW(5)
  5.  
  6.  
  7.  
  8. NAME
  9.      bw - Black and White image file format and utilities
  10.  
  11. FORMAT
  12.      A bw file contains  sequences  of  pixels.   Each  pixel  is
  13.      stored  as  one  unsigned char, and thus ranges in intensity
  14.      from 0 (black) to 255 (white).  The first pixel in a bw file
  15.      is  the  lower left corner of the image.  The pixels proceed
  16.      from left-to-right  across  each  scanline,  with  scanlines
  17.      being written from the bottom to the top of the image.
  18.  
  19.      By convention, bw images are usually square, and thus  their
  20.      dimensions  can  be determined by the file size.  If this is
  21.      not the case, often only the file width need be known  by  a
  22.      program  reading  the  file.   History  has left us with two
  23.      "standard" sizes, 512x512 and the "hires" 1024x1024.  A com-
  24.      mon  practice  for  other  file sizes is to include the file
  25.      width in the filename.
  26.  
  27.      At some time in the future bw files will probably get  self-
  28.      typing  headers so that parameters such as their size can be
  29.      automatically determined by programs.
  30.  
  31. UTILITIES
  32.      bw-fb display a .bw format image on a framebuffer.
  33.      fb-bw produce a .bw file from a framebuffer image.
  34.      bw-pix convert a .bw file to a color .pix file.
  35.      pix-bw convert a color .pix file to a .bw file.
  36.      bwstat gives statistics concerning a .bw file.
  37.      bwhist displays a histogram on a framebuffer.
  38.      bwmod a filter to shift and scale pixel intensities.
  39.      bwdiff yields the difference between two .bw files.
  40.      bwrect extracts an arbitrary rectangle from a .bw file.
  41.      bwcrop maps any quadrilateral in a .bw file into any rectan-
  42.      gle.
  43.      bwrot rotates, reverses, or inverts a .bw file.
  44.      bwscale scales a .bw file larger or smaller.
  45.      bwfilter a variety of 3x3 kernel filters for .bw images.
  46.      bw3-pix merges three .bw files into one .pix file.
  47.      pix-bw3 separates .pix file RGB colors into three .bw files.
  48.  
  49. FILES
  50.      file.bw
  51.  
  52. SEE ALSO
  53.      brlcad(1), pix(5), and above named programs.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sun Release 4.1       Last change: BRL/CAD                      1
  64.  
  65.  
  66.  
  67.