Struct iced_graphics::renderer::Renderer

pub struct Renderer<B: Backend, Theme> { /* private fields */ }

A backend-agnostic renderer that supports all the built-in widgets.

Implementations

impl<B: Backend, T> Renderer<B, T>

pub fn new(backend: B) -> Self

Creates a new Renderer from the given Backend.

pub fn backend(&self) -> &B

Returns the Backend of the Renderer.

pub fn draw_primitive(&mut self, primitive: Primitive)

Enqueues the given Primitive in the Renderer for drawing.

pub fn with_primitives(&mut self, f: impl FnOnce(&mut B, &[Primitive]))

Runs the given closure with the Backend and the recorded primitives of the Renderer.

Trait Implementations

impl<B: Debug + Backend, Theme: Debug> Debug for Renderer<B, Theme>

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

Formats the value using the given formatter.

impl<B, T> Renderer for Renderer<B, T>where B: Backend + Text,

type Font = Font

The font type used.

const ICON_FONT: Font = B::ICON_FONT

The icon font of the backend.

const CHECKMARK_ICON: char = B::CHECKMARK_ICON

The char representing a ✔ icon in the ICON_FONT.

const ARROW_DOWN_ICON: char = B::ARROW_DOWN_ICON

The char representing a ▼ icon in the built-in ICON_FONT.

fn default_size(&self) -> f32

Returns the default size of Text.

fn measure(&self, content: &str, size: f32, font: Font, bounds: Size) -> (f32, f32)

Measures the text in the given bounds and returns the minimum boundaries that can fit the contents.

fn hit_test( &self, content: &str, size: f32, font: Font, bounds: Size, point: Point, nearest_only: bool ) -> Option<Hit>

Tests whether the provided point is within the boundaries of text laid out with the given parameters, returning information about the nearest character.

fn fill_text(&mut self, text: Text<'_, Self::Font>)

Draws the given Text.

fn measure_width(&self, content: &str, size: f32, font: Self::Font) -> f32

Measures the width of the text as if it were laid out in a single line.

impl<B, T> Renderer for Renderer<B, T>where B: Backend + Svg,

fn dimensions(&self, handle: &Handle) -> Size<u32>

Returns the default dimensions of an SVG for the given Handle.

fn draw(&mut self, handle: Handle, color: Option<Color>, bounds: Rectangle)

Draws an SVG with the given Handle, an optional Color filter, and inside the provided bounds.

impl<B, T> Renderer for Renderer<B, T>where B: Backend,

type Theme = T

The supported theme of the Renderer.

fn layout<Message>( &mut self, element: &Element<'_, Message, Self>, limits: &Limits ) -> Node

Lays out the elements of a user interface.

fn with_layer(&mut self, bounds: Rectangle, f: impl FnOnce(&mut Self))

Draws the primitives recorded in the given closure in a new layer.

fn with_translation(&mut self, translation: Vector, f: impl FnOnce(&mut Self))

Applies a translation to the primitives recorded in the given closure.

fn fill_quad(&mut self, quad: Quad, background: impl Into<Background>)

Fills a Quad with the provided Background.

fn clear(&mut self)

Clears all of the recorded primitives in the Renderer.

impl<B, T> Renderer for Renderer<B, T>where B: Backend + Image,

type Handle = Handle

The image Handle to be displayed. Iced exposes its own default implementation of a Handle

fn dimensions(&self, handle: &Handle) -> Size<u32>

Returns the dimensions of an image for the given Handle.

fn draw(&mut self, handle: Handle, bounds: Rectangle)

Draws an image with the given Handle and inside the provided bounds.

impl<Message, P, B, T> Widget<Message, Renderer<B, T>> for Canvas<Message, T, P>where P: Program<Message, T>, B: Backend,

Available on crate feature canvas only.

fn tag(&self) -> Tag

Returns the Tag of the Widget.

fn state(&self) -> State

Returns the State of the Widget.

fn width(&self) -> Length

Returns the width of the Widget.

fn height(&self) -> Length

Returns the height of the Widget.

fn layout(&self, _renderer: &Renderer<B, T>, limits: &Limits) -> Node

Returns the layout::Node of the Widget.

fn on_event( &mut self, tree: &mut Tree, event: Event, layout: Layout<'_>, cursor_position: Point, _renderer: &Renderer<B, T>, _clipboard: &mut dyn Clipboard, shell: &mut Shell<'_, Message> ) -> Status

Processes a runtime Event.

fn mouse_interaction( &self, tree: &Tree, layout: Layout<'_>, cursor_position: Point, _viewport: &Rectangle, _renderer: &Renderer<B, T> ) -> Interaction

Returns the current [mouse::Interaction] of the Widget.

fn draw( &self, tree: &Tree, renderer: &mut Renderer<B, T>, theme: &T, _style: &Style, layout: Layout<'_>, cursor_position: Point, _viewport: &Rectangle )

Draws the Widget using the associated Renderer.

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

Returns the state Tree of the children of the Widget.

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

Reconciliates the Widget with the provided Tree.

fn operate( &self, _state: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation<Message> )

Applies an Operation to the Widget.

fn overlay<'a>( &'a mut self, _state: &'a mut Tree, _layout: Layout<'_>, _renderer: &Renderer ) -> Option<Element<'a, Message, Renderer>>

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

impl<'a, Message, B, T> Widget<Message, Renderer<B, T>> for QRCode<'a>where B: Backend,

Available on crate feature qr_code only.

fn width(&self) -> Length

Returns the width of the Widget.

fn height(&self) -> Length

Returns the height of the Widget.

fn layout(&self, _renderer: &Renderer<B, T>, _limits: &Limits) -> Node

Returns the layout::Node of the Widget.

fn draw( &self, _state: &Tree, renderer: &mut Renderer<B, T>, _theme: &T, _style: &Style, layout: Layout<'_>, _cursor_position: Point, _viewport: &Rectangle )

Draws the Widget using the associated Renderer.

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, Global>

Returns the state Tree of the children of the Widget.

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

Reconciliates the Widget with the provided Tree.

fn operate( &self, _state: &mut Tree, _layout: Layout<'_>, _renderer: &Renderer, _operation: &mut dyn Operation<Message> )

Applies an Operation to the Widget.

fn on_event( &mut self, _state: &mut Tree, _event: Event, _layout: Layout<'_>, _cursor_position: Point, _renderer: &Renderer, _clipboard: &mut dyn Clipboard, _shell: &mut Shell<'_, Message> ) -> Status

Processes a runtime Event.

fn mouse_interaction( &self, _state: &Tree, _layout: Layout<'_>, _cursor_position: Point, _viewport: &Rectangle<f32>, _renderer: &Renderer ) -> Interaction

Returns the current [mouse::Interaction] of the Widget.

fn overlay<'a>( &'a mut self, _state: &'a mut Tree, _layout: Layout<'_>, _renderer: &Renderer ) -> Option<Element<'a, Message, Renderer>>

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