Struct ImageRaster 

pub struct ImageRaster { /* private fields */ }

An opened raster image with georeferencing from a world file.

The entire image is decoded into memory on open. Subsequent read_tile calls slice from the in-memory buffer.

Implementations

impl ImageRaster

pub fn open(image_path: impl AsRef<Path>) -> Result<Self>

Open the image at image_path. Looks for a sidecar world file (.jgw / .pgw / .wld) next to it; errors with ImageError::MissingWorldFile if none found.

CRS defaults to Crs::Unknown; use Self::open_with_crs to set one explicitly (world files don’t carry CRS info).

pub fn open_with_crs(image_path: impl AsRef<Path>, crs: Crs) -> Result<Self>

Same as Self::open but with an explicit CRS — the typical pattern is the caller specifying it via UI / config.

pub fn pixels(&self) -> &[u8]

Hand back the raw pixel buffer (chunky interleaved). Useful for downstream code that wants to encode the same pixels into another format without going through RasterTile (which would copy).

Trait Implementations

impl Debug for ImageRaster

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

Formats the value using the given formatter.

impl RasterLayer for ImageRaster

fn profile(&self) -> &RasterProfile

Layer structure (dimensions, bands, CRS, tile size, pyramid depth).

fn read_tile(&self, level: u8, x: u32, y: u32) -> CoreResult<RasterTile>

Read one tile at the requested pyramid level + tile-grid (x, y) coordinate.

fn pyramid_levels(&self) -> u8

Total number of pyramid levels (≥ 1). Default impl reads from the profile; readers with dynamic pyramid availability can override.