Struct TransformConfig 

pub struct TransformConfig { /* private fields */ }

Per-view transform-controller configuration, installed via SceneView::transform_controller.

Built the way MagnetismConfig is: Rc’d closures so the view can clone it into every handler, Prop-accepting reactive knobs, one enabled signal.

Implementations

impl TransformConfig

pub fn new() -> Self

A controller with every handle, no ratio lock, corner-anchored scaling, 6 px padding, 9 px handles, a 4 × 4 minimum, body drag on, live preview, t for the keyboard route and edge auto-pan on.

pub fn handles(self, set: TransformHandleSet) -> Self

Which handles the frame offers. Konva’s enabledAnchors.

A handle in the set is still hidden when the selection cannot honour it — see SceneView::transform_controller for the rule. What is drawn is exactly what will happen.

pub fn keep_ratio(self, on: impl Into<Prop<bool>>) -> Self

Keep the selection’s aspect ratio through a resize. Konva’s keepRatio.

pub fn centered_scaling(self, on: impl Into<Prop<bool>>) -> Self

Scale about the frame’s centre rather than the opposite anchor. Konva’s centeredScaling.

pub fn rotation_snaps(self, radians: impl IntoIterator<Item = f32>) -> Self

Absolute angles, in radians, a rotation snaps to when it comes within rotation_snap_tolerance.

pub fn rotation_snap_tolerance(self, radians: f32) -> Self

How close a rotation has to get to a snap before it takes it. Default 5°.

pub fn padding(self, screen_px: f32) -> Self

How far outside the selection the frame is drawn, in screen pixels. Konva’s padding.

This is load-bearing, not decoration: it is what puts the frame band and the handles on pixels a heavyweight card does not own, and therefore what makes them grabbable over one. Setting it below handle_px / 2 lets a handle overlap a card, and a card that claims its own press will then take the grab.

pub fn handle_px(self, px: f32) -> Self

The on-screen size of a handle, in pixels. Default 9.

pub fn min_size(self, w: f32, h: f32) -> Self

The smallest frame a resize will produce, in scene units.

pub fn body_drag(self, on: bool) -> Self

Whether a press on the body of a selected, movable item starts a group move. Default on.

Best-effort over the heavyweight tier by construction: a card that claims its own press — one carrying capture_pointer or its own on_drag — wins it, and this view never sees the gesture. The frame band is the route that always works.

pub fn live_preview(self, mode: LivePreview) -> Self

Whether the items follow the gesture or only the frame does.

pub fn transform_key(self, key: Key) -> Self

The key that enters the keyboard transform mode while the view is focused. Default t, mirroring magnetism’s m.

pub fn edge_pan_px(self, px: f32) -> Self

How close to the viewport edge a pointer gesture has to get before the view starts panning, in screen pixels. Zero turns auto-pan off.

pub fn edge_pan_speed(self, px_per_second: f32) -> Self

Auto-pan speed, in screen pixels per second.

pub fn labels(self, labels: TransformLabels) -> Self

The names the frame and its handles publish to assistive technology.

pub fn enabled(self, on: impl Into<Prop<bool>>) -> Self

Set the enabled state, statically or reactively.

pub fn enabled_signal(&self) -> Signal<bool>

The reactive enabled signal, for a toolbar to read or bind.

pub fn is_enabled(&self) -> bool

Whether the controller is currently enabled.

pub fn on_start( self, f: impl Fn(&TransformSession, &mut EventContext<'_>) + 'static, ) -> Self

Fired once when a gesture begins.

pub fn on_change( self, f: impl Fn(&TransformSession, &mut EventContext<'_>) + 'static, ) -> Self

Fired on every pointer sample and every keyboard step.

pub fn on_end( self, f: impl Fn(&TransformSession, TransformOutcome, &mut EventContext<'_>) + 'static, ) -> Self

Fired once when a gesture finishes, committed or cancelled.

The scene has already been written when the outcome is TransformOutcome::Committed, so this is the hook an app records the delta from — a reversible-edit layer lives above this crate, never inside it.

pub fn chrome( self, f: impl Fn(&mut Canvas, &PaintContext<'_>, &TransformChrome) + 'static, ) -> Self

Replace the built-in chrome painter. Paints in scene coordinates.

Trait Implementations

impl Clone for TransformConfig

fn clone(&self) -> TransformConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransformConfig

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

Formats the value using the given formatter.

impl Default for TransformConfig

fn default() -> Self

Returns the “default value” for a type.