Skip to main content

ZoomPanView

Struct ZoomPanView 

Source
pub struct ZoomPanView { /* private fields */ }
Expand description

Zoom and pan over content: pinch or Cmd/Ctrl with the wheel to zoom, a drag or the wheel to move, a double click between fit and 100%, and the keys +, -, 0, 1 and the arrows (with Shift, further). A thrown drag coasts to a stop, which asks for frames only meanwhile and never happens with reduced motion. The content cannot leave the view.

Content is an image or a closure that draws from where the view puts it, not a laid out view: the runtime has no transform for a subtree, and scaling one by Motion::effect would neither move what can be clicked nor paint children whose unscaled place is off screen. A closure can still reuse any drawing through Scene::apply_effect.

While a gesture runs it paints without a build. If nothing else in the UI reads the ZoomView, it costs no rebuilds at all, however big the screen around it.

use ravenrs_core::ImageData;
use ravenrs_reactive::State;
use ravenrs_widgets::{Minimap, ZoomControl, ZoomPanView, ZoomView};

let view = State::new(ZoomView::fit());
let stage = ZoomPanView::image(view.binding(), photo());
let controls = ZoomControl::new(view.binding());
let map = Minimap::image(view.binding(), photo());

Implementations§

Source§

impl ZoomPanView

Source

pub fn image(view: Binding<ZoomView>, image: ImageData) -> Self

Shows an image, with one unit of content per pixel of it.

Source

pub fn custom( view: Binding<ZoomView>, content: Size, draw: impl Fn(ZoomPanPaint, &mut Scene) + 'static, ) -> Self

Shows what draw draws, for content of this size in units of the caller.

Source

pub fn size(self, width: f32, height: f32) -> Self

Fixed size in logical pixels, instead of taking the free space.

Source

pub fn grow(self, grow: f32) -> Self

How much of the free space along the parent stack it takes (1 by default).

Source

pub fn range(self, least: f32, most: f32) -> Self

The least and the most scale, where 1 is 100%. By default, it goes down to what shows the whole content and up to 1600%. What shows the whole content is always in range.

Source

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

Lets a thrown drag coast (on by default).

Source

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

The name screen readers announce, instead of the one in Labels.

Trait Implementations§

Source§

impl Debug for ZoomPanView

Source§

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

Formats the value using the given formatter. Read more
Source§

impl View for ZoomPanView

Source§

fn build(&self, cx: &mut BuildCx<'_>) -> NodeId

Creates this view’s node for the current build.
Source§

fn type_name(&self) -> &'static str

The name the diagnostics panel shows this view’s cost under.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> ErasedDestructor for T
where T: 'static,

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<V> ViewExt for V
where V: View,

Source§

fn padding(self, padding: impl Into<Insets>) -> Styled<Self>

Adds padding inside the box, in logical pixels.
Source§

fn background(self, fill: impl Into<Fill>) -> Styled<Self>

Paints a background behind the content.
Source§

fn frame(self, width: Option<f32>, height: Option<f32>) -> Styled<Self>

Fixes the width and/or height in logical pixels; None keeps the content size.
Source§

fn width(self, width: f32) -> Styled<Self>

Fixes the width in logical pixels.
Source§

fn height(self, height: f32) -> Styled<Self>

Fixes the height in logical pixels.
Source§

fn grow(self, grow: f32) -> Styled<Self>

Takes a share of the free space in the parent stack.
Source§

fn stretch(self) -> Styled<Self>

Stretches across the parent stack’s cross axis.
Source§

fn centered(self) -> Styled<Self>

Centers the content inside the box.
Source§

fn tooltip(self, text: impl Into<String>) -> Tooltip<Self>

Shows text above the view while the pointer is over it; see Tooltip.
Source§

fn opacity(self, opacity: f32) -> Faded<Self>

Draws the view and everything in it at this opacity, from 0.0 to 1.0, easing to it when it changes. Layout and input stay as they are; see Faded.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more