Struct GraphState 

pub struct GraphState { /* private fields */ }

View-owned native clock for a portable motion-value graph. Keep this state alive and notify after source/control changes.

Implementations

impl GraphState

pub fn now(&self, cx: &App) -> Duration

Native monotonic control time, zero before the first frame.

pub fn frame(&mut self, window: &mut Window, cx: &App) -> &MotionGraph

Samples once in the owning view, before reading all bound values.

Methods from Deref<Target = MotionGraph>

pub fn source(&mut self, value: f64) -> ValueId

Adds a finite scalar source. Panics for non-finite values.

pub fn derive( &mut self, inputs: &[ValueId], map: impl Fn(&[f64]) -> f64 + 'static, ) -> Result<ValueId, GraphError>

Adds an automatically updated, multi-input mapping. An empty input list is a constant. The mapper must return finite values and must not edit this graph.

Errors

Returns Identity for inputs from another graph.

Panics

Panics if the mapping returns a non-finite value, during setup or sampling.

pub fn get(&self, id: ValueId) -> Result<f64, GraphError>

Last sampled presentation. Does not advance the graph.

pub fn velocity(&self, id: ValueId) -> Result<f64, GraphError>

Last sampled velocity, including finite-difference derived velocities.

pub fn animate( &mut self, id: ValueId, target: f64, transition: Transition, now: Duration, ) -> Result<(), GraphError>

Retargets a source with the shared spring/tween solver. Identical declarations do not produce new start/cancel events. Panics for non-finite destinations.

pub fn set( &mut self, id: ValueId, value: f64, now: Duration, ) -> Result<(), GraphError>

Directly edits a source, with optional retained pointer velocity. This is batched: dependants and listeners update on the next sample.

pub fn jump( &mut self, id: ValueId, value: f64, now: Duration, ) -> Result<(), GraphError>

Cancels a source trajectory and clears momentum on the next sample.

pub fn subscribe( &mut self, id: ValueId, callback: impl FnMut(MotionEvent) + 'static, ) -> Result<GraphSubscription, GraphError>

Listens to sampled changes and lifecycle events. Store the returned handle.

pub fn sample(&mut self, now: Duration, reduced_motion: bool)

Advances sources, then derived dependencies, then dispatches listeners. Multiple writes coalesce to one change event per value and sample. Backward timestamps hold. Reduced motion settles sources using the shared policy.

pub fn is_animating(&self) -> bool

Whether any source or dependant requires another frame.

pub fn target( &self, base: Target, bindings: &[(Property, ValueId)], ) -> Result<Target, GraphError>

Binds sampled values to declared target properties. Values are saturated to drawable bounds; opacity is clamped and dimensions are non-negative.

pub fn typed_source<T, const N: usize>(&mut self, value: T) -> [ValueId; N]

where T: MotionData<N>,

Adds the numeric channels of a typed value, allocating only during setup. Panics for invalid channels as source does.

pub fn typed_value<T, const N: usize>( &self, template: T, ids: [ValueId; N], ) -> Result<T, GraphError>

where T: MotionData<N>,

Reconstructs a typed value from automatically sampled/derived channels.

pub fn animate_typed<T, const N: usize>( &mut self, ids: [ValueId; N], target: T, transition: Transition, now: Duration, ) -> Result<(), GraphError>

where T: MotionData<N>,

Retargets typed source channels transactionally. Invalid or derived IDs leave all sources unchanged; values/velocities use the shared solver.

Trait Implementations

impl Debug for GraphState

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

Formats the value using the given formatter.

impl Default for GraphState

fn default() -> Self

Returns the “default value” for a type.

impl Deref for GraphState

type Target = MotionGraph

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl DerefMut for GraphState

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.