Struct LiveImageHandle 

pub struct LiveImageHandle { /* private fields */ }

A handle to a LiveImage, for the UI thread: the size and status of what it shows, where it shows it, and the mapping between its points and the source’s pixels. Clone is an Rc clone; !Send.

It owns the widget’s Signals from construction, so it works before the widget mounts, and they stay the same across a switch of source. It does not keep the widget alive: once the widget is gone, it has no placement.

Implementations

impl LiveImageHandle

pub fn new() -> Self

A handle for a widget not built yet, which takes it with LiveImage::with_handle.

pub fn widget_id(&self) -> Option<WidgetId>

The widget’s id while it is mounted.

pub fn source(&self) -> Option<LiveImageSource>

The source the widget shows; None until a widget took the handle.

pub fn status(&self) -> Signal<LiveImageStatus>

The source’s status as the window’s last layout saw it: the same Signal across switches of source.

pub fn frame_size(&self) -> Signal<Option<(u32, u32)>>

The frame size layout uses: the source’s buffer, else its size hint, as the window’s last layout saw it. The same Signal across switches of source.

pub fn geometry(&self) -> Option<ImageGeometry>

The placement of the last layout, widget-local: the one paint draws and the mappings below use. None before the first layout, with no frame size, or once the widget is gone.

pub fn map_to_source(&self, local: Point) -> Option<(u32, u32)>

The source pixel whose displayed square contains the widget-local point local; None on the letterbox, outside the widget, or without a placement. A pointer handler’s positions are widget-local.

pub fn map_to_source_clamped(&self, local: Point) -> Option<(u32, u32)>

The source pixel nearest local: the point is clamped into the picture first, for a drag that leaves it. None only without a placement.

pub fn map_to_source_f32(&self, local: Point) -> Option<(f32, f32)>

Continuous source coordinates of local, unclamped: pixel k spans [k, k + 1).

pub fn map_from_source(&self, rect: PixelRect) -> Option<Rect>

Where the source pixels of rect are displayed, widget-local: to place an overlay on what the picture shows.

pub fn stats(&self) -> LiveImageStats

The source’s counters and, while the widget is mounted, its attachment’s; zero attachment counters otherwise.

Trait Implementations

impl Clone for LiveImageHandle

fn clone(&self) -> LiveImageHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LiveImageHandle

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

Formats the value using the given formatter.

impl Default for LiveImageHandle

fn default() -> Self

Returns the “default value” for a type.