SE_rasterattr_set_interleave

Indicates the band interleave for the source pixel data or sets the band interleave for the storage of the pixel data.

Usage syntax

LONG SE_rasterattr_set_interleave (SE_RASTERATTR handle, BOOL is_source_data, SE_RASTER_INTERLEAVE_TYPE type);

Parameters
handle The SE_RASTERATTR handle
is_source_data Set this parameter to TRUE to indicate which interleave should be used to read the source data. Set the parameter to FALSE to indicate which interleave the ArcSDE raster is to be written in.
type The interleave type, defaults to SE_RASTER_INTERLEAVE_BSQ.
Description

SE_rasterattr_set_interleave sets the type of band interleave that will be used to read or write the pixel data. Setting is_source_data parameter to TRUE indicates which band interleave of the source data. Setting the is_source_data parameter to FALSE indicates which band interleave is used to stored the ArcSDE pixel data.

The band interleave enumeration SE_RASTER_INTERLEAVE_TYPE contains the following types:

SE_RASTER_INTERLEAVE_BSQ band sequential
SE_RASTER_INTERLEAVE_BIP interleave by pixel


Setting the interleave to SE_RASTER_INTERLEAVE_BIP and setting the is_source_data parameter to FALSE indicates that the data should be stored in band interleave pixel format. Storing the data in band interleave pixel format is only supported for 3 band 8-bit data. When the data is stored this way it is actually stored in an integrated single band. When JPEG and JPEG2000 compression is applied to pixel data stored this way, the compression factor is actually greater than when it is stored as separate bands using band sequential interleave.

Returns

SE_SUCCESS
SE_INVALID_POINTER

SE_INVALID_RASTERATTR_OBJECT

SE_NET_FAILURE

SE_SDE_NOT_STARTED