README

   1 Imageviewer program is designed to allow the viewing of raw, headerless YUV
   2 files that are encountered in video processing and broadcast applications.
   3
   4 The source data can be a single video frame in a file, a set of numerically
   5 named files forming a sequence of frames, or many frames concatenated into
   6 a single large file.
   7
   8 The aim of the program is to display the image 'correctly' :-
   9
  10 * Colour matrixing is derived from first principles.
  11
  12 * 1/2, 1/2 filters are used to upsample chrominance to 4:4:4 for display
  13
  14 * Images can be viewed using 'video' or 'computer' number ranges
  15
  16 * Full screen mode allows an unscaled pixel-for-pixel display if graphics
  17   mode and monitor pixel counts are the same. Poor scaling implementations
  18   on graphics cards or in flat panel displays can be avoided by using
  19   pixel-for-pixel modes.
  20
  21 Imageviewer provides compatibility with a wide range of YUV formats:
  22
  23 FourCC code     Description
  24 -----------     -----------
  25 I420            YUV planar 8 bit data
  26
  27 YV12            YVU planar 8 bit data
  28
  29 UYVY            UYVY multiplexed 8 bit data
  30
  31 V210            UYVY multiplexed 10 bit data, 3 components packed into 32 bits
  32
  33 V216            UYVY multiplexed 8-16 bit data, little endian,
  34                                 data packed to the most significant bits
  35
  36 UY16*           UYVY multiplexed 8-16 bit data, big endian,
  37                                 data packed to the least significant bits
  38
  39 YYY8*                   Luminance only 8 bit data.
  40                                 As I420/YV12 but with no chrominance planes.
  41
  42 YY16*                   Luminance only 16 bit data. Little endian,
  43                                 data packed to the most significant bits.
  44
  45 16P4*                   YCbCr Planar 4:4:4 16 bit data. Big endian,
  46                                 data packed to the most significant bits.
  47
  48 16P2*                   YCbCr Planar 4:2:2 16 bit data. Big endian,
  49                                 data packed to the most significant bits.
  50
  51 16P0*                   YCbCr Planar 4:2:0 16 bit data. Big endian,
  52                                 data packed to the most significant bits.
  53
  54 RGB     RGB packed 24 bits per pixel
  55
  56 RGBA    RGBA packed 32 bits per pixel (alpha information ignored)
  57
  58 *This format is not a formal FourCC code, but has been encountered in the wild.
  59
  60 Additional limited support is provided for PPM and PGM formats with
  61 bit depths up to 16 bits. No commonly available viewer provides bit depths
  62 greater than 8 bits for PPM/PGM formats.
  63
  64 More details about these formats, and further instructions for Imageviewer are
  65 available from the 'Help' menu.