Syntax

   FACTORY_DEF <ReaderKeyword> RasterCreationFactory
   [FACTORY_NAME <factory name>]
   [WIDTH <number of columns>]
   [HEIGHT <number of rows>]
   [GENERAL_CELL_TYPE <numeric or color>] // not implemented
   [CELL_ELEMENT_TYPE <size of a cell>]
   [CREATE_PALETTE (YES|NO)]
   [BAND_COLOR_MODEL <color model>]
   [PALETTE_COLOR_MODEL <color model>]
   [PALETTE_KEY_TYPE <size of key>]
   [X_CELL_ORIGIN <floating-point number>]
   [Y_CELL_ORIGIN <floating-point number>]
   [X_SPACING <floating-point number>]
   [Y_SPACING <floating-point number>]
   [X_UPPER_LEFT_COORD <floating-point number>]
   [Y_UPPER_LEFT_COORD <floating-point number>]
   [X_LOWER_LEFT_COORD <floating-point number>]
   [Y_LOWER_LEFT_COORD <floating-point number>]
   [X_LOWER_RIGHT_COORD <floating-point number>]
   [Y_LOWER_RIGHT_COORD <floating-point number>]
   [ROTATION <floating-point number>]
   [NODATA_COLOR_VALUE <3comma-separated floating-point>]
   [MIN_COLOR_VALUE <3comma-separated floating-point>]
   [MAX_COLOR_VALUE <3comma-separated floating-point>]
   [NODATA_NUMERIC_VALUE <floating-point number>]
   [MIN_NUMERIC_VALUE <floating-point number>]
   [MAX_NUMERIC_VALUE <floating-point number>]
   [NODATA_ALPHA_VALUE <floating-point number>]
   [MIN_ALPHA_VALUE <floating-point number>]
   [MAX_ALPHA_VALUE <floating-point number>]
   [RASTER_TYPE (Single_Value | Checkered_Pattern | Checkerboard)]
   [OUTPUT CREATED FEATURE_TYPE <feature type>
      [<attribute name> <attribute value>]*
      [<feature function>]*]*

Overview

   This factory creates a feature with a raster of the specified size with 
   general values using the parameters supplied. It is useful for creating a 
   very large image with a user-specified width and height. This factory can 
   create one of three raster types: 

      A single-value raster contains only one single numeric/color value 
      throughout the whole raster. 

      A checkered-value raster has alternating numeric/color values arranged in 
      a gradient throughout the whole raster.

      A checkerboard raster has alternating blocks of minimum and maximum values 
      arranged in a standard eight by eight checkerboard configuration. The 
      number of rows and columns specify the total size of the raster, and the 
      rows and columns per color block, which is variable. If the number of rows 
      and columns specified are not multiples of eight, the leftover space will 
      be filled with either nodata values or the minimum value, if no nodata 
      value was specified.

      The random-value raster type is now deprecated and no longer supported.

   WIDTH and HEIGHT are integer values starting from 1. WIDTH and HEIGHT 
   virtually have no maximum values; however, the largest 4-byte integer size in 
   a 32-bit machine limits the values of WIDTH and HEIGHT. 

   GENERAL_CELL_TYPE can be either Numeric or Color. If Numeric is chosen, 
   NODATA_NUMERIC_VALUE, MIN_NUMERIC_VALUE, and MAX_NUMERIC_VALUE should be 
   used. If Color is chosen, NODATA_COLOR_VALUE, NODATA_ALPHA_VALUE, 
   MIN_COLOR_VALUE, MIN_ALPHA_VALUE, MAX_COLOR_VALUE, and MAX_ALPHA_VALUE should 
   be used.

   NODATA_NUMERIC_VALUE, or NODATA_COLOR_VALUE and NODATA_ALPHA_VALUE are 
   optional.

   CREATE_PALETTE is either 'Yes' or 'No'. If this parameter is not specified it 
   will default to 'No'.

   BAND_COLOR_MODEL is useful for setting the color type. Options are any one 
   of:

      RGBA_4BYTE
      RGB_3BYTE
      RGBA_8BYTE
      RGB_6BYTE
      RED_1BYTE
      GREEN_1BYTE
      BLUE_1BYTE
      ALPHA_1BYTE
      GRAY_1BYTE
      RED_2BYTE
      GREEN_2BYTE
      BLUE_2BYTE
      ALPHA_2BYTE
      GRAY_2BYTE

   CELL_ELEMENT_TYPE is useful for setting the color type. Options are any one 
   of:

      Real_64_Bits
      Real_32_Bits
      UInt_64_Bits
      UInt_32_Bits
      UInt_16_Bits
      UInt_8_Bits
      Int_64_Bits
      Int_32_Bits
      Int_16_Bits
      Int_8_Bits

   PALETTE_KEY_TYPE is useful for setting the palette's key type. Options are 
   any one of: 

      UInt_8_Bits
      UInt_16_Bits
      UInt_32_Bits

   PALETTE_COLOR_TYPE is useful for setting the palette's value type. Options 
   are any one of: 

      RGB_3BYTE
      RGBA_4BYTE
      RGB_6BYTE
      RGBA_8BYTE
      GRAY_1BYTE
      GRAY_2BYTE
      STRING

   X_CELL_ORIGIN, Y_CELL_ORIGIN, X_SPACING, Y_SPACING, X_UPPER_LEFT_COORD, and 
   Y_UPPER_LEFT_COORD are geographic information. They are required to have some 
   values. Particularly, X_SPACING and Y_SPACING cannot be lesser than or equal 
   to zero. 

   RASTER_TYPE sets the kind of raster being generated. 

      A Single_Value RASTER_TYPE will produce a raster of MAX_COLOR_VALUE with 
      MAX_ALPHA_VALUE of WIDTH by HEIGHT. The values in the _COLOR_VALUE boxes 
      must be in triple zero to one floating-point values separated by commas. 
      The values in the _NUMERIC_VALUE boxes must be within the range of the 
      CELL_ELEMENT_TYPE. 

      A Checkered_Pattern RASTER_TYPE d by c will produce a raster with each 
      pixel alternating between MIN_COLOR_VALUE and a gradient. 

      A Checkerboard RASTER_TYPE will produce a raster with alternating blocks 
      of minimum and maximum value pixels, with a total of eight blocks in the 
      horizontal and vertical directions. If the number of rows and columns 
      specified are not evenly divisible by eight, the raster will be padded 
      with nodata values at the right-hand side and the bottom.

      Note: When selecting greyscale color models, the minimum, maximum and 
      nodata values used for the raster are the values of the red component for 
      each parameter.

   See below for a description of the other types of output clauses that are 
   supported.

Output Tags

   The RasterCreationFactory supports the following output tag.
   
   CREATED
   
      The raster feature being created by the factory.

TO BE RESOLVED

   X_LOWER_LEFT_COORD, Y_LOWER_LEFT_COORD, ROTATION,X_LOWER_RIGHT_COORD, 
   Y_LOWER_RIGHT_COORD clauses added to Syntax section above, but not 
   documented.