Syntax

   @AddRasterBand([REJECTABLE], <interpretation>, <cell value>[, <nodata value>)
   
Arguments

   REJECTABLE

      Specifies if the function will supply a rejection code and message
      to the invalid feature and output it to the rejected port, or will
      fail upon being supplied invalid features.

      A feature can be rejected for the following reasons:
         - The feature has invalid geometry

   <interpretation>   
      The desired interpretation for the added band, including data type and bit 
      depth.
      
      Range: (RED8|RED16|GREEN8|GREEN16|BLUE8|BLUE16|ALPHA8|ALPHA16|GRAY8|GRAY16|
              INT8|INT16|INT32|INT64|UINT8|UINT16|UINT32|UINT64| REAL32|REAL64)
      
   <cell value>   
      The value that will be used for all cells in the added band.
      
      Range: Numeric
      
   <nodata value>   
      The nodata value for the band. If left blank, the band will not be given a 
      nodata value.
      
      Range: Numeric

Description

   The @AddRasterBand function is used to add a new band to a raster. The added 
   band will have the same value in all cells. Furthermore, the added band will 
   have the same raster-level properties as other bands in the raster (i.e. 
   number of rows/columns, cell spacing, cell origin, etc.).
   
   For example, if you had a raster with RGB bands, but you wanted to write the 
   raster as RGBA, you could use this function to add an Alpha band to the 
   raster.
   
   The <interpretation> parameter specifies the desired interpretation for the 
   added band.
   
   The <cell value> parameter sets the value that will be used for all cells in 
   the added band.
   
   The <nodata value> parameter sets the band's nodata value. If a nodata value 
   is not desired, this parameter may be left blank.
   
   Input features must contain raster geometries only.