Struct druid::ImageBuf

pub struct ImageBuf { /* private fields */ }

An in-memory pixel buffer.

Contains raw bytes, dimensions, and image format (ImageFormat).

Implementations

impl ImageBuf

pub fn empty() -> ImageBuf

Create an empty image buffer.

pub fn from_raw( pixels: impl Into<Arc<[u8]>>, format: ImageFormat, width: usize, height: usize ) -> ImageBuf

Creates a new image buffer from an array of bytes.

format specifies the pixel format of the pixel data, which must have length width * height * format.bytes_per_pixel().

Panics

Panics if the pixel data has the wrong length.

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

Returns the raw pixel data of this image buffer.

pub fn raw_pixels_shared(&self) -> Arc<[u8]>

Returns a shared reference to the raw pixel data of this image buffer.

pub fn format(&self) -> ImageFormat

Returns the format of the raw pixel data.

pub fn width(&self) -> usize

The width, in pixels, of this image.

pub fn height(&self) -> usize

The height, in pixels, of this image.

pub fn size(&self) -> Size

The size of this image, in pixels.

pub fn pixel_colors(&self) -> impl Iterator<Item = impl Iterator<Item = Color>>

Returns an iterator over the pixels in this image.

The return value is an iterator over “rows”, where each “row” is an iterator over the color of the pixels in that row.

pub fn to_image<Ctx>(&self, ctx: &mut Ctx) -> <Ctx as RenderContext>::Imagewhere Ctx: RenderContext,

Converts this buffer an image that is optimized for drawing into a RenderContext.

pub fn ptr_eq(&self, other: &ImageBuf) -> bool

Returns true if the two ImageBufs refer to the same memory location.

impl ImageBuf

pub fn from_dynamic_image(image_data: DynamicImage) -> ImageBuf

Load an image from a DynamicImage from the image crate

pub fn from_dynamic_image_with_alpha(image_data: DynamicImage) -> ImageBuf

Load an image from a DynamicImage with alpha

pub fn from_dynamic_image_without_alpha(image_data: DynamicImage) -> ImageBuf

Load an image from a DynamicImage without alpha

pub fn from_data( raw_image: &[u8] ) -> Result<ImageBuf, Box<dyn Error + Sync + Send + 'static, Global>>

Attempt to load an image from raw bytes.

If the image crate can’t decode an image from the data an error will be returned.

pub fn from_file<P>( path: P ) -> Result<ImageBuf, Box<dyn Error + Sync + Send + 'static, Global>>where P: AsRef<Path>,

Attempt to load an image from the file at the provided path.

Trait Implementations

impl Clone for ImageBuf

fn clone(&self) -> ImageBuf

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Data for ImageBuf

fn same(&self, other: &Self) -> bool

Determine whether two values are the same.

impl Debug for ImageBuf

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

Formats the value using the given formatter.

impl Default for ImageBuf

fn default() -> ImageBuf

Returns the “default value” for a type.