Struct ImageView 

pub struct ImageView<'a> {
    pub data: &'a [u8],
    pub width: usize,
    pub height: usize,
    pub stride: usize,
}

A view into an image buffer with explicit stride support. This allows handling NumPy arrays with padding or non-standard layouts.

Fields

data: &'a [u8]

The raw image data slice.

width: usize

The width of the image in pixels.

height: usize

The height of the image in pixels.

stride: usize

The stride (bytes per row) of the image.

Implementations

impl<'a> ImageView<'a>

pub fn new( data: &'a [u8], width: usize, height: usize, stride: usize, ) -> Result<Self, String>

Create a new ImageView after validating that the buffer size matches the dimensions and stride.

pub fn has_simd_padding(&self) -> bool

Returns true if the image buffer has sufficient padding for safe SIMD gather operations.

Some SIMD kernels (e.g. AVX2 gather) may perform 32-bit loads on 8-bit data, which can read up to 3 bytes past the end of the logical buffer.

pub fn get_row(&self, y: usize) -> &[u8]

Safe accessor for a specific row.

pub fn get_pixel(&self, x: usize, y: usize) -> u8

Get a pixel value at (x, y) with boundary clamping.

pub unsafe fn get_pixel_unchecked(&self, x: usize, y: usize) -> u8

Get a pixel value at (x, y) without bounds checking.

Safety

Caller must ensure x < width and y < height.

pub fn sample_bilinear(&self, x: f64, y: f64) -> f64

Sample pixel value with bilinear interpolation at sub-pixel coordinates.

pub unsafe fn sample_bilinear_unchecked(&self, x: f64, y: f64) -> f64

Sample pixel value with bilinear interpolation at sub-pixel coordinates without bounds checking.

Safety

Caller must ensure 0.0 <= x <= width - 1.001 and 0.0 <= y <= height - 1.001 such that floor(x), floor(x)+1, floor(y), floor(y)+1 are all valid indices.

pub fn sample_gradient_bilinear(&self, x: f64, y: f64) -> [f64; 2]

Compute the gradient [gx, gy] at sub-pixel coordinates using bilinear interpolation.

pub fn decimate_to<'b>( &self, factor: usize, output: &'b mut [u8], ) -> Result<ImageView<'b>, String>

Create a decimated copy of the image by subsampling every factor pixels.

The output buffer must have size at least (width/factor) * (height/factor).

pub fn upscale_to<'b>( &self, factor: usize, output: &'b mut [u8], ) -> Result<ImageView<'b>, String>

Create an upscaled copy of the image using bilinear interpolation.

The output buffer must have size at least (width*factor) * (height*factor).

Trait Implementations

impl<'a> Clone for ImageView<'a>

fn clone(&self) -> ImageView<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for ImageView<'a>