Struct RasterWindow 

pub struct RasterWindow {
    pub col_off: u32,
    pub row_off: u32,
    pub width: u32,
    pub height: u32,
}

A sub-region window into a raster dataset. Defines a rectangular area for reading/writing a portion of raster data.

Fields

col_off: u32

Column offset from the left edge (0-based)

row_off: u32

Row offset from the top edge (0-based)

width: u32

Width of the window in pixels

height: u32

Height of the window in pixels

Implementations

impl RasterWindow

pub fn new(col_off: u32, row_off: u32, width: u32, height: u32) -> Result<Self>

Create a new window. Validates that width and height are > 0.

pub fn full(raster_width: u32, raster_height: u32) -> Result<Self>

Create a window covering the full extent of a raster.

pub fn fits_within(&self, raster_width: u32, raster_height: u32) -> bool

Check if this window fits within a raster of the given dimensions.

pub fn validate_bounds( &self, raster_width: u32, raster_height: u32, ) -> Result<()>

Validate that this window fits within the given raster dimensions. Returns an error if any part is out of bounds.

pub fn pixel_count(&self) -> u64

Total number of pixels in this window.

pub fn intersection(&self, other: &RasterWindow) -> Option<RasterWindow>

Intersect this window with another, returning the overlapping region. Returns None if they don’t overlap.

pub fn union_bounds(&self, other: &RasterWindow) -> RasterWindow

Compute the union bounding box of this window and another.

pub fn contains_pixel(&self, col: u32, row: u32) -> bool

Check if this window contains the given pixel coordinates.

pub fn subdivide( &self, tile_width: u32, tile_height: u32, ) -> Result<Vec<RasterWindow>>

Subdivide this window into tiles of the given size. The last tiles in each row/column may be smaller.

pub fn to_global(&self, local_col: u32, local_row: u32) -> Result<(u32, u32)>

Convert a pixel coordinate from window-local to global raster coordinates.

pub fn to_local(&self, global_col: u32, global_row: u32) -> Option<(u32, u32)>

Convert a pixel coordinate from global raster to window-local coordinates. Returns None if the global coordinate is outside this window.

pub fn extract_from_buffer( &self, source: &[u8], raster_width: u32, bytes_per_pixel: u32, ) -> Result<Vec<u8>>

Extract the bytes for this window from a full-raster band buffer. Assumes row-major layout with bytes_per_pixel bytes per pixel and raster_width pixels per row in the source buffer.

pub fn write_to_buffer( &self, window_data: &[u8], dest: &mut [u8], raster_width: u32, bytes_per_pixel: u32, ) -> Result<()>

Write window data back into a full-raster band buffer.

Trait Implementations

impl Clone for RasterWindow

fn clone(&self) -> RasterWindow

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RasterWindow

impl Debug for RasterWindow

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

Formats the value using the given formatter.

impl Display for RasterWindow

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

Formats the value using the given formatter.

impl Eq for RasterWindow

impl PartialEq for RasterWindow

fn eq(&self, other: &RasterWindow) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for RasterWindow