Enum ImageFit 

pub enum ImageFit {
    Contain,
    Cover,
    Fill,
    None,
}

How a raster image projects into the rect resolved for its El. Mirrors CSS object-fit. The El rect (after padding) is the “viewport”; the image is the “content”.

Variants

Contain

Scale uniformly so the image fits inside the rect, preserving aspect ratio. Letterbox bands appear on the side that runs short. Default — matches the CSS default for <img> in most frameworks.

Cover

Scale uniformly so the image covers the rect, preserving aspect ratio. Excess on the longer axis is clipped via the El’s scissor (the destination rect can extend past the El’s content area; draw_ops clips it back).

Fill

Stretch the image to the rect, ignoring aspect ratio.

None

No scaling — paint at the image’s natural pixel size, anchored top-left within the rect. Excess clips via the scissor.

Implementations

impl ImageFit

pub fn project(self, nw: u32, nh: u32, rect: Rect) -> Rect

Project an image of natural size (nw, nh) into rect according to this fit. The returned rect is where the image should paint; for Cover / None it may extend past rect and the caller is expected to scissor-clip to rect.

Trait Implementations

impl Clone for ImageFit

fn clone(&self) -> ImageFit

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageFit

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

Formats the value using the given formatter.

impl Default for ImageFit

fn default() -> ImageFit

Returns the “default value” for a type.

impl PartialEq for ImageFit

fn eq(&self, other: &ImageFit) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ImageFit

impl Eq for ImageFit

impl StructuralPartialEq for ImageFit