Struct pix_engine::image::Image

pub struct Image { /* private fields */ }

An Image representing a buffer of pixel color values.

Implementations

impl Image

pub fn new(width: u32, height: u32) -> Self

Constructs an empty RGBA Image with given width and height.

pub fn rgba(width: u32, height: u32) -> Self

Constructs an empty RGBA Image with given width and height.

Alias for Image::new.

pub fn rgb(width: u32, height: u32) -> Self

Constructs an empty RGB Image with given width and height.

pub fn from_bytes<B: AsRef<[u8]>>( width: u32, height: u32, bytes: B, format: PixelFormat ) -> PixResult<Self>

Constructs an Image from a u8 slice representing RGB/A values.

Errors

If the bytes length doesn’t match the image dimensions and PixelFormat provided, then an error is returned.

pub fn from_pixels<P: AsRef<[Color]>>( width: u32, height: u32, pixels: P, format: PixelFormat ) -> PixResult<Self>

Constructs an Image from a Color slice representing RGBA values.

Errors

If the pixels length doesn’t match the image dimensions and PixelFormat provided, then an error is returned.

pub fn from_vec( width: u32, height: u32, data: Vec<u8>, format: PixelFormat ) -> Self

Constructs an Image from a Vec<u8> representing RGB/A values.

pub fn from_file<P: AsRef<Path>>(path: P) -> PixResult<Self>

Constructs an Image from a png file.

Errors

If the file format is not supported or extension is not .png, then an error is returned.

pub fn from_read<R: Read>(read: R) -> PixResult<Self>

Constructs an Image from a png reader.

Errors

If the file format is not supported or there is an io::Error reading the file then an error is returned.

pub const fn width(&self) -> u32

Returns the Image width.

pub const fn height(&self) -> u32

Returns the Image height.

pub const fn dimensions(&self) -> (u32, u32)

Returns the Image dimensions as (width, height).

pub const fn pitch(&self) -> usize

Returns the pitch of the image data which is the number of bytes in a row of pixel data, including padding between lines.

pub fn bounding_rect(&self) -> Rect<i32>

Returns the Image bounding Rect positioned at (0, 0).

The width and height of the returned rectangle are clamped to ensure that size does not exceed i32::MAX. This could result in unexpected behavior with drawing routines if the image size is larger than this.

pub fn bounding_rect_offset<P>(&self, offset: P) -> Rect<i32>

where P: Into<Point<i32>>,

Returns the Image bounding Rect positioned at offset.

pub fn center(&self) -> Point<i32>

Returns the center position as Point.

pub fn bytes(&self) -> Bytes<'_>

Returns the Image pixel data as an iterator of u8.

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

Returns the Image pixel data as a u8 slice.

pub fn as_mut_bytes(&mut self) -> &mut [u8]

Returns the Image pixel data as a mutable u8 slice.

pub fn into_bytes(self) -> Vec<u8>

Returns the Image pixel data as a Vec<u8>.

This consumes the Image, so we do not need to copy its contents.

pub fn pixels(&self) -> Pixels<'_>

Returns the Image pixel data as an iterator of Colors.

pub fn into_pixels(self) -> Vec<Color>

Returns the Image pixel data as a Vec<Color>.

Panics

Panics if the image has an invalid sequence of bytes given it’s PixelFormat.

pub fn get_pixel(&self, x: u32, y: u32) -> Color

Returns the color value at the given (x, y) position.

Panics

Panics if the image has an invalid sequence of bytes given it’s PixelFormat, or the (x, y) index is out of range.

pub fn set_pixel<C: Into<Color>>(&mut self, x: u32, y: u32, color: C)

Sets the color value at the given (x, y) position.

pub fn update_bytes<B: AsRef<[u8]>>(&mut self, bytes: B)

Update the Image with a u8 slice representing RGB/A values.

pub const fn format(&self) -> PixelFormat

Returns the Image pixel format.

pub fn save<P>(&self, path: P) -> PixResult<()>

where P: AsRef<Path>,

Save the Image to a png file.

Errors

Returns an error for any of the following: - An io::Error occurs attempting to create the png file. - A png::EncodingError occurs attempting to write image bytes.

Example

fn on_key_pressed(&mut self, s: &mut PixState, event: KeyEvent) -> PixResult<bool> {
    if let Key::S = event.key {
        self.image.save("test_image.png")?;
    }
    Ok(false)
}

Trait Implementations

impl Clone for Image

fn clone(&self) -> Image

Returns a copy 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.

impl Default for Image

fn default() -> Image

Returns the “default value” for a type.

impl From<Image> for Icon

fn from(img: Image) -> Self

Converts to this type from the input type.