Struct ViewState 

pub struct ViewState {
    pub epoch: ViewEpoch,
    pub version: ViewVersion,
    pub motion: CameraMotionState,
    pub motion_source: MotionSource,
    pub transition: TransitionPhase,
    pub ptz: Option<PtzTelemetry>,
    pub global_transform: Option<GlobalTransformEstimate>,
    pub validity: ContextValidity,
    pub stability_score: f32,
}

The current best estimate of the camera’s view.

Updated every frame by the view system. Stages and output consumers receive a ViewSnapshot (read-only, Arc-wrapped) rather than ViewState directly.

Fields

epoch: ViewEpoch

Current epoch — incremented on significant view discontinuities.

version: ViewVersion

Current version — incremented on every view-state update.

motion: CameraMotionState

Whether the camera is stable, moving, or unknown.

motion_source: MotionSource

How the current motion state was determined.

transition: TransitionPhase

Position in the motion transition state machine.

ptz: Option<PtzTelemetry>

PTZ telemetry, if available.

global_transform: Option<GlobalTransformEstimate>

Global transform estimate (frame-to-reference), if available.

validity: ContextValidity

Whether temporal state is valid under the current view.

stability_score: f32

Stability score in [0.0, 1.0] — 1.0 = fully stable.

Implementations

impl ViewState

pub fn fixed_initial() -> Self

Create the default initial view state for a fixed camera.

pub fn observed_initial() -> Self

Create the default initial view state for an observed camera.

Starts with CameraMotionState::Unknown and ContextValidity::Degraded because no motion data has been received yet. The view system will upgrade to Valid once a provider delivers stable motion data.

Trait Implementations

impl Clone for ViewState

fn clone(&self) -> ViewState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ViewState

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

Formats the value using the given formatter.