Jpeg2000DataSet.Band Property
Picks a single band of a multi-band JPEG 2000 image to load.
Syntax
public System.Int32 Band { get; set; }Property Value
Default: -1
Index of band to read (starting from 0); or -1, meaning all bands.
This property can only be modified before the dataset has been initialized. Attempting to modify it after initialization will cause an exception to be thrown.
Remarks
The band property lets you pick a single band of a multi-band JPEG 2000 image to load. The default value of -1 causes all bands to be read into a 32-bit RGBA raster. Otherwise, the dataset will only read one band from each JPEG2000 image, as follows:
value | band |
|---|---|
band = 0 | Red band |
band = 1 | Green band |
band = 2 | Blue band |
band = 3 | Alpha band |
This property can be useful when you know that different sources of information is encoded into the bands. For example, an image could have the red band represent elevation and the blue band represent radar coverage.
It is also possible for a JPEG 2000 image to have more than four bands. For such images, this property makes it possible to read other bands than the first four ones.
Another situation where this property is useful is when working with JPEG 2000 images with 16-bit bands. With band -1, these images will be loaded as RGBA rasters. However, this causes a loss of precision, since Engine RGBA rasters always have 8-bit bands. Using this property to read only one band lets you read it as a single-band 16-bit Engine raster, without any loss of precision.
Platforms
Windows, Linux, Android