Struct Camera 

pub(crate) struct Camera {
    pub(crate) vantage: Vantage,
    pub(crate) viewport: Rect,
    pub(crate) safe: Rect,
    target: Option<Vantage>,
    pub(crate) worked: CameraWork,
}

The session’s camera: where it stands, where it is easing to, the screen it is shown on and the part of that the chrome leaves clear.

Fields

vantage: Vantage

viewport: Rect

The screen rect the canvas is laid out into.

safe: Rect

The part of the viewport the floating chrome leaves clear, or Rect::NOTHING where nothing has measured any.

target: Option<Vantage>

Where a framing is easing to, while one is.

worked: CameraWork

Implementations

impl Camera

pub(crate) fn resting() -> Self

fn framing_rect(&self) -> Rect

Where a framing centres and sizes itself: the region the chrome left, or the whole viewport where no chrome has reported any.

pub(crate) fn visible(&self) -> Rect

The world rect the viewport currently shows.

pub(crate) fn stand_at(&mut self, vantage: Vantage)

Stand exactly here. Any framing still easing is abandoned: what is asked for is the framing now, and letting the old one finish would walk the camera off it.

pub(crate) fn fit_to_rect(&mut self, content: Rect)

Frame content to fill the view, snapping immediately. Used for an authored camera rect and for layer changes: the block path changed underneath, so animating across unrelated content is jarring rather than helpful.

pub(crate) fn fit_content(&mut self, content: Rect)

Fit the level’s whole contents in view — the double-click gesture. Unlike an authored camera rect this leaves a fixed FIT_BORDER_CELLS gutter (so nothing sits against the edge) and is capped at FRAME_MAX_ZOOM (so a nearly empty level doesn’t leap to a huge magnification).

pub(crate) fn focus_on(&mut self, content: Rect, glide: Glide)

Frame a single subject — a block picked from the navigator, the region an undo just changed — capping the zoom so a small one doesn’t blow up to fill the whole view.

pub(crate) fn bring_into_view(&mut self, content: Rect, glide: Glide)

Bring content into view with the gentlest move that reaches it: nothing at all when it is already visible, otherwise a pan — the zoom is only touched for content that cannot fit at this one. What a paste lands is content the viewer has never seen, so the alternative to this is content that arrives off-screen and reads as having not arrived.

fn frame_rect(&mut self, content: Rect, max_zoom: Zoom, glide: Glide)

fn glide_to(&mut self, vantage: Vantage, glide: Glide)

pub(crate) fn ease(&mut self, dt: Duration) -> bool

Advance a framing in progress by one frame that took dt, easing toward the target with a frame-rate-independent exponential approach. Answers whether it is still under way — a host that draws on demand asks for another frame while it is.

pub(crate) fn moved(&mut self, moved: Move)

What the host’s pointer did to the camera. Manual control, so it cancels a framing in progress and names the undo entry.

fn zoom_about(&mut self, factor: Factor, anchor: Pos2)

pub(crate) fn zoom_step(&mut self, step: ZoomStep, anchor: Option<Pos2>)

One keyboard zoom step, about anchor (the pointer) or the viewport center when the pointer is elsewhere.

Trait Implementations

impl Clone for Camera

fn clone(&self) -> Camera

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Camera

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

Formats the value using the given formatter.

impl Copy for Camera