CREATE_MULTI_BAND

CREATE_MULTI_BAND

The CREATE_MULTI_BAND command combines multiple loaded single-band imagery files in to a single logical multi-band layer. Each specified single-band layer will be removed from the active layer list and instead be accessible through the multi-band layer. The following parameters are supported:

• LAYER_DESC - description for the newly created multi-band layer
• BAND_FILENAME - specifies the filename or description of a loaded layer to add as a band to the new layer. Add a separate BAND_FILENAME parameter for each band that you want to add in the order that you want them added. Alternatively, you can use the more verbose BAND_EXPORT_SETUP parameter to specify band numbers explicitly.
• BAND_EXPORT_SETUP - allows you to specify the input layer to use for each band. Use the following format to specify what band from what layer to use for a given output band in the new layer: <output_band>?<input_band>?<layer_filename> . For example to assign the 4th (infrared) band in an export from the 1st (red) band in a previously loaded file name C:\data\input_file.tif, use the following parameter: BAND_EXPORT_SETUP="4?1?c:\data\input_file.tif". Note that you need to include a separate BAND_EXPORT_SETUP parameter for each output band you want to add to the multiband image.

See the IMPORT command for other options parameters to apply to the multi-band layer after load.