Struct widgetry::Image

pub struct Image<'a, 'c> {
    source: Option<Cow<'c, ImageSource<'a>>>,
    tooltip: Option<Text>,
    color: Option<RewriteColor>,
    content_mode: Option<ContentMode>,
    corner_rounding: Option<CornerRounding>,
    padding: Option<EdgeInsets>,
    bg_color: Option<Color>,
    dims: Option<ScreenDims>,
}

A stylable UI component builder which presents vector graphics from an ImageSource.

Fields

source: Option<Cow<'c, ImageSource<'a>>>

tooltip: Option<Text>

color: Option<RewriteColor>

content_mode: Option<ContentMode>

corner_rounding: Option<CornerRounding>

padding: Option<EdgeInsets>

bg_color: Option<Color>

dims: Option<ScreenDims>

Implementations

impl<'a, 'c> Image<'a, 'c>

pub fn empty() -> Self

An Image with no renderable content. Useful for starting a template for creating several similar images using a builder pattern.

pub fn from_path(filename: &'a str) -> Self

Create an SVG Image, read from filename, which is colored to match Style.icon_fg

pub fn from_bytes(labeled_bytes: (&'a str, &'a [u8])) -> Self

Create a new SVG Image from bytes.

• labeled_bytes: is a (label, bytes) tuple you can generate with [include_labeled_bytes!]
• label: a label to describe the bytes for debugging purposes
• bytes: UTF-8 encoded bytes of the SVG

pub fn from_batch(batch: GeomBatch, bounds: Bounds) -> Self

Create a new Image from a GeomBatch.

By default, the given bounds will be used for padding, background, etc.

pub fn source(self, source: ImageSource<'a>) -> Self

Set a new source for the Image’s data.

This will replace any previously set source.

pub fn source_path(self, path: &'a str) -> Self

Set the path to an SVG file for the image.

This will replace any image source previously set.

pub fn source_bytes(self, labeled_bytes: (&'a str, &'a [u8])) -> Self

Set the bytes for the image.

This will replace any image source previously set.

• labeled_bytes: is a (label, bytes) tuple you can generate with [include_labeled_bytes!]
• label: a label to describe the bytes for debugging purposes
• bytes: UTF-8 encoded bytes of the SVG

pub fn source_batch(self, batch: GeomBatch, bounds: Bounds) -> Self

Set the GeomBatch for the button.

This will replace any image source previously set.

This method is useful when doing more complex transforms. For example, to re-write more than one color for your image, do so externally and pass in the resultant GeomBatch here.

pub fn tooltip(self, tooltip: impl Into<Text>) -> Self

Add a tooltip to appear when hovering over the image.

pub fn merged_image_style(&'c self, other: &'c Self) -> Self

Create a new Image based on self, but overriding with any values set on other.

pub fn color<RWC: Into<RewriteColor>>(self, value: RWC) -> Self

Rewrite the color of the image.

pub fn bg_color(self, value: Color) -> Self

Set a background color for the image. Has no effect unless custom dims are explicitly set.

pub fn untinted(self) -> Self

The image’s intrinsic colors will be used, it will not be tinted like Image::icon

pub fn dims<D: Into<ScreenDims>>(self, dims: D) -> Self

Scale the bounds containing the image. If dims are not specified, the image’s intrinsic size will be used, but padding and background settings will be ignored.

See Self::content_mode to control how the image scales to fit its custom bounds.

pub fn content_mode(self, value: ContentMode) -> Self

If a custom dims was set, control how the image should be scaled to its new bounds.

If dims were not specified, the image will not be scaled, so content_mode has no affect.

The default, ContentMode::ScaleAspectFit will only grow as much as it can while maintaining its aspect ratio and not exceeding its bounds

pub fn corner_rounding<R: Into<CornerRounding>>(self, value: R) -> Self

Set independent rounding for each of the image’s corners. Has no effect unless custom dims are explicitly set.

pub fn padding<EI: Into<EdgeInsets>>(self, value: EI) -> Self

Set padding for the image. Has no effect unless custom dims are explicitly set.

pub fn padding_top(self, new_value: f64) -> Self

Padding above the image. Has no effect unless custom dims are explicitly set.

pub fn padding_left(self, new_value: f64) -> Self

Padding to the left of the image. Has no effect unless custom dims are explicitly set.

pub fn padding_bottom(self, new_value: f64) -> Self

Padding below the image. Has no effect unless custom dims are explicitly set.

pub fn padding_right(self, new_value: f64) -> Self

Padding to the right of the image. Has no effect unless custom dims are explicitly set.

pub fn build_batch(&self, ctx: &EventCtx<'_>) -> Option<(GeomBatch, Bounds)>

Render the Image and any styling (padding, background, etc.) to a GeomBatch.

pub fn into_widget(self, ctx: &EventCtx<'_>) -> Widget

Trait Implementations

impl<'a, 'c> Clone for Image<'a, 'c>

fn clone(&self) -> Image<'a, 'c>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a, 'c> Debug for Image<'a, 'c>

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

Formats the value using the given formatter.

impl<'a, 'c> Default for Image<'a, 'c>

fn default() -> Image<'a, 'c>

Returns the “default value” for a type.