Struct MultiBandBuffer 

pub struct MultiBandBuffer { /* private fields */ }

A multi-band raster buffer holding multiple single-band buffers.

All bands must share identical dimensions and data type.

Implementations

impl MultiBandBuffer

pub fn from_bands( bands: Vec<RasterBuffer>, colors: Vec<ColorInterpretation>, ) -> Result<Self>

Create a MultiBandBuffer from individual band buffers and color interpretations.

All bands must have the same width, height, and data type.

Errors

Returns an error if bands have mismatched dimensions or data types, or if the color interpretation count doesn’t match the band count.

pub fn from_interleaved( data: &[u8], width: u64, height: u64, band_count: u32, data_type: RasterDataType, nodata: NoDataValue, ) -> Result<Self>

Create a MultiBandBuffer from interleaved (BIP) data.

Deinterleaves band-interleaved-by-pixel data into separate band buffers.

Errors

Returns an error if the data size doesn’t match dimensions × band_count × type_size.

pub fn from_bsq( data: &[u8], width: u64, height: u64, band_count: u32, data_type: RasterDataType, nodata: NoDataValue, ) -> Result<Self>

Create a MultiBandBuffer from band-sequential (BSQ) data.

Errors

Returns an error if the data size doesn’t match dimensions × band_count × type_size.

pub fn from_bil( data: &[u8], width: u64, height: u64, band_count: u32, data_type: RasterDataType, nodata: NoDataValue, ) -> Result<Self>

Create a MultiBandBuffer from Band-Interleaved-by-Line (BIL) data.

Rearranges BIL-layout bytes into the internal BSQ (band-sequential) representation.

BIL layout: for each row r and then each band b, the width * pixel_size bytes for that (row, band) slice are contiguous:

[row0_band0_col0..colN, row0_band1_col0..colN, …, row0_bandN_col0..colN,
 row1_band0_col0..colN, row1_band1_col0..colN, …, rowH_bandN_col0..colN]

Errors

Returns an error if the data size doesn’t match width × height × band_count × pixel_size.

pub fn band_count(&self) -> u32

Returns the number of bands.

pub fn width(&self) -> u64

Returns the width in pixels (same for all bands).

pub fn height(&self) -> u64

Returns the height in pixels (same for all bands).

pub fn data_type(&self) -> RasterDataType

Returns the data type (same for all bands).

pub fn layout(&self) -> PixelLayout

Returns the pixel layout.

pub fn set_band_nodata(&mut self, band: u32, nodata: NoDataValue) -> Result<()>

Set per-band nodata override value.

pub fn band(&self, band: u32) -> Result<BandRef<'_>>

Get a reference to a specific band buffer.

Errors

Returns an error if band is out of range.

pub fn band_mut(&mut self, band: u32) -> Result<&mut RasterBuffer>

Get a mutable reference to a specific band buffer.

Errors

Returns an error if band is out of range.

pub fn bands(&self) -> BandIterator<'_>

Returns a lazy iterator over all bands.

pub fn to_interleaved(&self) -> Vec<u8>

Interleave all bands into a single BIP byte buffer.

Returns pixels in band-interleaved-by-pixel order: R₁G₁B₁ R₂G₂B₂ …

pub fn to_bsq(&self) -> Vec<u8>

Flatten all bands into BSQ byte buffer.

Returns band-sequential data: all of band 0, then all of band 1, etc.

pub fn to_bil(&self) -> Vec<u8>

Emits the buffer data in Band-Interleaved-by-Line (BIL) layout.

BIL layout: for each row r and then each band b, all width * pixel_size bytes for that (row, band) slice are written contiguously:

[row0_band0, row0_band1, …, row0_bandN, row1_band0, …, rowH_bandN]

pub fn compute_all_statistics(&self) -> Result<Vec<BufferStatistics>>

Compute statistics for all bands.

Errors

Returns an error if statistics computation fails for any band.

pub fn into_bands(self) -> Vec<RasterBuffer>

Consume and return the inner band buffers.

Trait Implementations

impl Clone for MultiBandBuffer

fn clone(&self) -> MultiBandBuffer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for MultiBandBuffer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.