Crate nv_view 

nv-view

Camera view-state, PTZ modeling, and motion-aware epoch management for the NextVision runtime.

This crate handles the fundamental challenge of video perception on moving cameras: when the camera’s view changes, spatial relationships between frames change and temporal state may become invalid.

Core types

• ViewState — the current best estimate of the camera’s view.
• ViewSnapshot — a read-only, Arc-wrapped snapshot given to stages.
• ViewEpoch / ViewVersion — monotonic counters for discontinuity and change tracking.
• CameraMotionState — whether the camera is stable, moving, or unknown.
• TransitionPhase — where in a motion transition the current frame sits.

User extension points

• ViewStateProvider — supplies motion information each frame (telemetry or inferred).
• EpochPolicy — controls the response to detected camera motion.
• ViewBoundContext — binds user data to a specific view for staleness checks.

Re-exports

pub use bound::BoundContextValidity;

pub use bound::ViewBoundContext;

pub use camera_motion::CameraMotionState;

pub use camera_motion::MotionSource;

pub use epoch::DefaultEpochPolicy;

pub use epoch::EpochDecision;

pub use epoch::EpochPolicy;

pub use epoch::EpochPolicyContext;

pub use provider::MotionPollContext;

pub use provider::MotionReport;

pub use provider::ViewStateProvider;

pub use ptz::PtzEvent;

pub use ptz::PtzTelemetry;

pub use transform::GlobalTransformEstimate;

pub use transform::TransformEstimationMethod;

pub use transition::TransitionPhase;

pub use validity::ContextValidity;

pub use validity::DegradationReason;

pub use view_state::ViewEpoch;

pub use view_state::ViewSnapshot;

pub use view_state::ViewState;

pub use view_state::ViewVersion;

Modules

bound

View-bound context: binding user data to a specific camera view.

camera_motion

Camera motion state and motion source types.

epoch

Epoch policy trait and default implementation.

provider

ViewStateProvider trait and motion report types.

ptz

PTZ telemetry types and discrete control events.

transform

Global transform estimate types.

transition

Transition phase state machine for camera motion events.

validity

Context validity and degradation reasons.

view_state

Core view state types: ViewState, ViewSnapshot, ViewEpoch, ViewVersion.