Struct Image 

pub struct Image<Handle = Handle> { /* private fields */ }

Available on crate feature image only.

A frame that displays an image while keeping aspect ratio.

Example

use iced::widget::image;

enum Message {
    // ...
}

fn view(state: &State) -> Element<'_, Message> {
    image("ferris.png").into()
}

Implementations

impl<Handle> Image<Handle>

pub fn new(handle: impl Into<Handle>) -> Self

Creates a new Image with the given path.

pub fn width(self, width: impl Into<Length>) -> Self

Sets the width of the Image boundaries.

pub fn height(self, height: impl Into<Length>) -> Self

Sets the height of the Image boundaries.

pub fn expand(self, expand: bool) -> Self

Sets whether the Image should try to fill as much space available as possible while keeping aspect ratio and without allocating extra space in any axis with a Length::Shrink sizing strategy.

This is similar to using Length::Fill for both the width and the height, but without the downside of blank space.

pub fn content_fit(self, content_fit: ContentFit) -> Self

Sets the ContentFit of the Image.

Defaults to ContentFit::Contain

pub fn filter_method(self, filter_method: FilterMethod) -> Self

Sets the FilterMethod of the Image.

pub fn rotation(self, rotation: impl Into<Rotation>) -> Self

Applies the given Rotation to the Image.

pub fn opacity(self, opacity: impl Into<f32>) -> Self

Sets the opacity of the Image.

It should be in the [0.0, 1.0] range—0.0 meaning completely transparent, and 1.0 meaning completely opaque.

pub fn scale(self, scale: impl Into<f32>) -> Self

Sets the scale of the Image.

The region of the Image drawn will be scaled from the center by the given scale factor. This can be useful to create certain effects and animations, like smooth zoom in / out.

pub fn crop(self, region: Rectangle<u32>) -> Self

Crops the Image to the given region described by the Rectangle in absolute coordinates.

Cropping is done before applying any transformation or ContentFit. In practice, this means that cropping an Image with this method should produce the same result as cropping it externally (e.g. with an image editor) and creating a new Handle for the cropped version.

However, this method is much more efficient; since it just leverages scissoring during rendering and no image cropping actually takes place. Instead, it reuses the existing image allocations and should be as efficient as not cropping at all!

The region coordinates will be clamped to the image dimensions, if necessary.

pub fn border_radius(self, border_radius: impl Into<Radius>) -> Self

Sets the border::Radius of the Image.

Currently, it will only be applied around the rectangular bounding box of the Image.

pub fn alt(self, text: impl Into<String>) -> Self

Sets the alt text of the Image.

This is the accessible name announced by screen readers. It should be a short phrase describing the image content.

pub fn description(self, description: impl Into<String>) -> Self

Sets an extended description of the Image.

This supplements the alt text with additional context for assistive technology, when the alt text alone is not sufficient.

Trait Implementations

impl<'a, Message, Theme, Renderer, Handle> From<Image<Handle>> for Element<'a, Message, Theme, Renderer>

where Renderer: Renderer<Handle = Handle>, Handle: Clone + 'a,

fn from(image: Image<Handle>) -> Element<'a, Message, Theme, Renderer>

Converts to this type from the input type.

impl<Message, Theme, Renderer, Handle> Widget<Message, Theme, Renderer> for Image<Handle>

where Renderer: Renderer<Handle = Handle>, Handle: Clone,

fn size(&self) -> Size<Length>

Returns the Size of the Widget in lengths.

fn layout( &mut self, _tree: &mut Tree, renderer: &Renderer, limits: &Limits, ) -> Node

Returns the layout::Node of the Widget.

fn draw( &self, _tree: &Tree, renderer: &mut Renderer, _theme: &Theme, _style: &Style, layout: Layout<'_>, _cursor: Cursor, _viewport: &Rectangle, )

Draws the Widget using the associated Renderer.

fn operate( &mut self, _tree: &mut Tree, layout: Layout<'_>, _renderer: &Renderer, operation: &mut dyn Operation, )

Applies an Operation to the Widget.

fn size_hint(&self) -> Size<Length>

Returns a Size hint for laying out the Widget.

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn children(&self) -> Vec<Tree>

Returns the state Tree of the children of the Widget.

fn diff(&self, tree: &mut Tree)

Reconciles the Widget with the provided Tree.

fn update( &mut self, _tree: &mut Tree, _event: &Event, _layout: Layout<'_>, _cursor: Cursor, _renderer: &Renderer, _shell: &mut Shell<'_, Message>, _viewport: &Rectangle, )

Processes a runtime Event.

fn mouse_interaction( &self, _tree: &Tree, _layout: Layout<'_>, _cursor: Cursor, _viewport: &Rectangle, _renderer: &Renderer, ) -> Interaction

Returns the current mouse::Interaction of the Widget.

fn overlay<'a>( &'a mut self, _tree: &'a mut Tree, _layout: Layout<'a>, _renderer: &Renderer, _viewport: &Rectangle, _translation: Vector, ) -> Option<Element<'a, Message, Theme, Renderer>>

Returns the overlay of the Widget, if there is any.