Struct Image 

pub struct Image { /* private fields */ }

An image representation wrapping NumRS2 arrays.

Images store pixel data as f64 values in the range [0.0, 1.0]. Grayscale images have shape [height, width], RGB images have shape [height, width, 3], and RGBA images have shape [height, width, 4].

Implementations

impl Image

pub fn from_grayscale( width: usize, height: usize, data: &[f64], ) -> Result<Self, NumRs2Error>

Creates a new grayscale image from raw pixel data.

Arguments

• width - Image width in pixels
• height - Image height in pixels
• data - Pixel values in row-major order, expected in [0.0, 1.0]

Errors

Returns NumRs2Error::ValueError if data length does not match width * height

pub fn from_rgb( width: usize, height: usize, data: &[f64], ) -> Result<Self, NumRs2Error>

Creates a new RGB image from raw pixel data.

Arguments

• width - Image width in pixels
• height - Image height in pixels
• data - Pixel values in row-major order with 3 channels per pixel

Errors

Returns NumRs2Error::ValueError if data length does not match width * height * 3

pub fn zeros_grayscale(width: usize, height: usize) -> Self

Creates a grayscale image filled with zeros (black).

Arguments

• width - Image width in pixels
• height - Image height in pixels

pub fn from_array( data: Array<f64>, color_space: ColorSpace, ) -> Result<Self, NumRs2Error>

Creates an image from a pre-built Array and color space.

Arguments

• data - The array containing pixel data
• color_space - The color space of the image

Errors

Returns NumRs2Error::ValueError if the array shape is inconsistent with the color space

pub fn width(&self) -> usize

Returns the width of the image in pixels.

pub fn height(&self) -> usize

Returns the height of the image in pixels.

pub fn color_space(&self) -> ColorSpace

Returns the color space of the image.

pub fn data(&self) -> &Array<f64>

Returns a reference to the underlying array data.

pub fn data_mut(&mut self) -> &mut Array<f64>

Returns a mutable reference to the underlying array data.

pub fn channels(&self) -> usize

Returns the number of channels in the image.

pub fn get_pixel( &self, row: usize, col: usize, channel: usize, ) -> Result<f64, NumRs2Error>

Gets a pixel value at the specified position.

For grayscale images, returns a single value. For RGB images, channel must be specified (0=R, 1=G, 2=B).

Errors

Returns NumRs2Error::IndexError if coordinates are out of bounds

pub fn set_pixel( &mut self, row: usize, col: usize, channel: usize, value: f64, ) -> Result<(), NumRs2Error>

Sets a pixel value at the specified position.

Errors

Returns NumRs2Error::IndexError if coordinates are out of bounds

pub fn to_grayscale(&self) -> Result<Self, NumRs2Error>

Converts an RGB image to grayscale using luminance weights.

Uses the ITU-R BT.709 formula: Y = 0.2126R + 0.7152G + 0.0722*B

Errors

Returns NumRs2Error::InvalidOperation if the image is already grayscale

pub fn clamp(&self) -> Self

Clamps all pixel values to the range [0.0, 1.0].

pub fn to_vec(&self) -> Vec<f64>

Returns the flat pixel data as a vector.

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Image

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

Formats the value using the given formatter.