Struct Vantage 

pub struct Vantage {
    pub zoom: Zoom,
    pub translation: Vec2,
}

The whole of what a view-kind undo entry restores.

The two numbers the view holds, not a world rect — a rect would have to be re-framed against a viewport that may have resized since, which would land the camera somewhere the user never was.

The transform is here rather than in a backend because two backends read it: the on-screen painter converts every draw through it, and a recording canvas has to place its marks where the painter would have.

Fields

zoom: Zoom

translation: Vec2

Implementations

impl Vantage

pub const fn resting() -> Vantage

The camera at rest: unity zoom, no pan.

pub fn world_to_screen(self, origin: Pos2, world: Pos2) -> Pos2

origin is the screen corner the viewport was laid out at.

pub fn screen_to_world(self, origin: Pos2, screen: Pos2) -> Pos2

pub fn remap_rect(self, origin: Pos2, world: Rect) -> Rect

pub fn remap_len(self, len: Bounded<WorldPxBounds>) -> f32

World-space length → screen-space length. The single place a world magnitude (radius, rounding, stroke width, wrap width) loses its unit.

pub fn remap_font(self, font: &Font) -> Font

The same face at the size it is drawn on screen.

pub fn visible(self, viewport: Rect) -> Rect

The world rect viewport shows from here.

pub fn framing( within: Rect, viewport_min: Pos2, content: Rect, max_zoom: Zoom, ) -> Vantage

The vantage that frames content centred in within, a screen region inside the viewport whose corner is viewport_min. within is not necessarily the whole viewport: floating chrome may leave less of it clear, and framing against the raw rect lands the model under the chrome. Padding is the caller’s — it pads content before framing it.

pub fn zoomed_about(self, origin: Pos2, anchor: Pos2, factor: Factor) -> Vantage

The same camera zoomed by factor about anchor (screen space, in a viewport cornered at origin), leaving the world under anchor where it was. Lands inside [Zoom::WORKED_MIN]..=[Zoom::WORKED_MAX] — a user working the camera stays in the band, where a framing may use the whole range.

Trait Implementations

impl Clone for Vantage

fn clone(&self) -> Vantage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Vantage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Vantage

fn deserialize<__D>( __deserializer: __D, ) -> Result<Vantage, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Vantage

fn eq(&self, other: &Vantage) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Vantage

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for Vantage

impl StructuralPartialEq for Vantage