// ****************************************************************************
//  FILE:              general_raster_template.hdr
//
//  DESCRIPTION:  This is a template keyword list for loading a general
//                raster image into ossim.
//
//                This file should be renamed as such:
//                If the raster image is called "foo.ras" this header file
//                should be named "foo.hdr" to be automatically picked up
//                during the ossim->file->open.
//
//      C++ comments are allowed throughout the keyword list file.
//     
//      A keyword is always delimited by a colon. After the keyword there
//      are parameters associated with the keyword. Note that NOT all 
//      keywords use a parameter.  The keywords are independent of order.
//      For multiple-image keywords, sequential numbers are used prior to
//      the colon to match keywords to a particular image.
//
//      The format is as follows:
//
//            keyword: <option> [parameter]
//
//   KEYWORDS:
// ****************************************************************************

// ***
// Source raster image file.  Required keyword.
// Note:  This can be a relative path to the directory that the ossim
//        application was launched.  If in doubt, always use an absolute path.
image_file: ksc1_256.raw
// ***

// ***
// Overview image file.  Not required; however, preferred if zooming out is
// desired.
//
// Note:  The command line application "img2rr" can be used to build a 
//        reduced resolution data set file.
// Example: img2rr /data/image1/image1.kwl /data/image1/image_ovr.tif
//
// overview_file:  /data/image1/image1_ovr.tif
// ***

// ***
// Pixel type.  Not required.  Default = uchar (unsigned_char).
// Valid types: uchar, ushort16, sshort16, ushort11, float
// uchar = unsigned char, ushort16 = unsigned short 16 bit,
// sshort = signed short 16 bit, ushort11 = unsigned short 11 bit data,
// float = 16 bit floating points.
pixel_type:  uchar
// ***


// ***
// Interleave type.  Not required.  Default = bil (band interleaved by line).
// Valid types:  bil, bip, bsq, and bsq_multi_file.
interleave_type:  bil
// ***


// ***
// Number of bands.  Not required.  Default = 1.
number_bands:  1
// ***


// ***
// Number of lines in image.  This is required.
number_lines:  256
// ***


// ***
// Number of samples in image.  This is required.
number_samples:  256
// ***


// ***
// NOTE: Using the valid start/stop line/sample you can cut any rectangle
//       from a raster file.
// ***

// ***
// Valid start line.  Not required.  Default is 0
// NOTE:  image rectangles are zero based (first pixel 0, 0)
// valid_start_line:  0
// ***

// ***
// Valid start sample.  Not required.  Default is 0
// NOTE:  image rectangles are zero based (first pixel 0, 0)
// valid_start_sample:  0
// ***

// ***
// Valid stop line.  Not required.  Default is number of lines - 1.
// NOTE:  image rectangles are zero based (last pixel: numberOfLines - 1)
// valid_stop_line:  99
// ***

// ***
// Valid stop sample.  Not required.  Default is number of samples - 1.
// NOTE:  image rectangles are zero based (last pixel: numberOfSamples - 1)
// valid_stop_sample:  99
// ***

// ***
// Model image start line.  Not required.  Default is 0.  Allows the user
// to define the image start sample of image relative to geometry file.
// model_image_start_line: 0
// ***

// ***
// Model image stop line.  Not required.  Default is image_lines - 1.
// Allows the user to define the image stop line relative to geometry file.
// model_image_stop_line: 99
// ***

// ***
// Model image start sample.  Not required.  Default is 0.  Allows the user
// to define the image start sample relative to geometry file.
// model_image_start_sample: 0
// ***

// ***
// Model image stop sample.  Not required.  Default is image_samples - 1.
// Allows the user to define the image stop sample relative to geometry file.
// model_image_stop_sample: 99
// ***


// ***
// Header size.  Not required.  Default is 0.  This will be the
// number of bytes bypassed in the image file.
// header_size: 0
// ***

// ***
// Set nulls mode.  Not required.  Default = mode 0.
// mode 0:  Will do nothing to the pixels on ingest.
// mode 1:  Will flip all zeroes on ingest to the minimum value of the
//          pixel type.
// mode 2:  If turned on the code will walk the image line in both
//          directions to determine the edges of the image.  
//          Any pixels outside of the edge will be set to the null value of the
//          pixel type.  
set_fill_to_nulls_mode: 0
// set_fill_to_nulls_mode: 1
// set_fill_to_nulls_mode: 2
// ***


// ***
// Pixels to chop.  Not required.  Defaulted to zero.  This allows the user
// to specify pixels on the edge of the imageline to null out.  This can
// be used to eliminate resampling error from the edge of the image while
// not changing the image dimensions.
// pixels_to_chop:
// ***