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.

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 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 operate( &mut self, _tree: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation, )

Applies an [Operation] to the [Widget].

fn update( &mut self, _tree: &mut Tree, _event: &Event, _layout: Layout<'_>, _cursor: Cursor, _renderer: &Renderer, _clipboard: &mut dyn Clipboard, _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.