Struct ImmutableBitmap 

pub struct ImmutableBitmap { /* private fields */ }

Immutable bitmap: pixels that never change.

The bitmap is drawn from an image of premultiplied RGBA pixels, the one format the renderers draw. A bitmap that was created from pixels in another format keeps those as well: it reports their format and is read in it, as a bitmap of the Skia backend, which draws every format it has a color type for.

Implementations

impl ImmutableBitmap

pub fn from_image(image: ImageData) -> Self

Wraps an image of premultiplied RGBA pixels.

pub fn from_stream(stream: &mut dyn Read) -> Result<Self>

Creates an immutable bitmap from the given stream.

pub fn from_stream_to_size( stream: &mut dyn Read, decode_size: i32, horizontal: bool, interpolation_mode: BitmapInterpolationMode, ) -> Result<Self>

Creates an immutable bitmap from a stream, decoded so that its width (horizontal) or height is decode_size.

pub fn resized( src: &ImmutableBitmap, destination_size: PixelSize, interpolation_mode: BitmapInterpolationMode, ) -> Result<Self>

Creates a resized copy of src.

pub fn from_pixels( size: PixelSize, dpi: Vector, stride: i32, format: PixelFormat, alpha_format: AlphaFormat, data: &[u8], ) -> Result<Self>

Creates an immutable bitmap from raw pixel data, which is copied.

data holds |stride| * size.height bytes. A negative stride means the rows are stored bottom-up: the first row of the image is the last row of data.

Panics

Panics when the pixel format is unknown to the backend.

Trait Implementations

impl IBitmapImpl for ImmutableBitmap

fn dpi(&self) -> Vector

The dots per inch (DPI) of the image.

fn pixel_size(&self) -> PixelSize

The size of the bitmap, in device pixels.

fn version(&self) -> i32

Version of the pixel data: incremented whenever the content changes.

fn save( &self, stream: &mut dyn Write, options: &BitmapEncoderOptions, ) -> Result<()>

Saves the bitmap to a stream, encoded as selected by options.

fn dispose(&self)

Releases the bitmap’s resources.

fn as_any(&self) -> &dyn Any

Lets the backend recover its concrete type.

fn as_readable_bitmap(&self) -> Option<&dyn IReadableBitmapImpl>

The bitmap viewed as IReadableBitmapImpl, when its pixels can be read.

impl IDrawableBitmapImpl for ImmutableBitmap

fn image(&self) -> Option<ImageData>

The current pixels of the bitmap as an image of premultiplied RGBA pixels, or None once the bitmap is disposed. The image is kept until the pixels change: drawing a bitmap again copies nothing.

impl IReadableBitmapImpl for ImmutableBitmap

fn format(&self) -> Option<PixelFormat>

The pixel format, if known.

fn alpha_format(&self) -> Option<AlphaFormat>

The alpha format, if known.

fn lock(&self) -> Rc<dyn ILockedFramebuffer>

Locks the pixels for reading (and writing, for writeable bitmaps).