Struct Player 

pub struct Player {
    pub attrs: Attrs,
    pub last_frame_time: Option<Instant>,
}

Playback state manager (does NOT own Project)

Player manages playback state only. Project is passed by reference to methods that need it. PlayaApp owns the single Project instance.

Attrs keys:

• active_comp: Uuid (optional, missing key = None)
• previous_comp_history: List (most recent last)
• is_playing: Bool
• fps_base: Float (persistent base FPS)
• fps_play: Float (temporary playback FPS)
• loop_enabled: Bool
• play_direction: Float (1.0 forward, -1.0 backward)
• selected_seq_idx: Option stored as Int (missing key = None)

Fields

attrs: Attrs

All serializable player state

last_frame_time: Option<Instant>

Last frame timestamp (runtime-only, not serializable)

Implementations

impl Player

pub fn new() -> Self

Create new player with defaults (no Project - that’s in PlayaApp)

pub fn attach_schema(&mut self)

Attach schema after deserialization

pub fn active_comp(&self) -> Option<Uuid>

Get active comp UUID

pub fn previous_comp_history(&self) -> Vec<Uuid>

Get previous comp history (most recent last)

pub fn take_previous_comp(&mut self) -> Option<Uuid>

Pop the last previous comp (for U key navigation back)

pub fn is_playing(&self) -> bool

Check if playing

pub fn set_is_playing(&mut self, playing: bool)

Set playing state

pub fn fps_base(&self) -> f32

Get base FPS

pub fn set_fps_base(&mut self, fps: f32)

Set base FPS

pub fn fps_play(&self) -> f32

Get playback FPS

pub fn set_fps_play(&mut self, fps: f32)

Set playback FPS

pub fn loop_enabled(&self) -> bool

Check if loop is enabled

pub fn set_loop_enabled(&mut self, enabled: bool)

Set loop enabled

pub fn play_direction(&self) -> f32

Get play direction (1.0 forward, -1.0 backward)

pub fn selected_seq_idx(&self) -> Option<usize>

Get selected sequence index

pub fn set_selected_seq_idx(&mut self, idx: Option<usize>)

Set selected sequence index

pub fn total_frames(&self, project: &Project) -> i32

Get total frames of active node (work area frame count)

pub fn play_range(&self, project: &Project) -> (i32, i32)

Get current play range of active node (start, end), or (0, 0) if none.

pub fn set_play_range(&mut self, start: i32, end: i32, project: &mut Project)

Set play range of active comp in global comp frame indices (inclusive).

pub fn current_frame(&self, project: &Project) -> i32

Get current frame index from active comp

pub fn get_current_frame(&self, project: &Project) -> Option<Frame>

Get current frame as owned Frame (Composed) Uses GPU compositor (main thread only)

pub fn set_active_comp( &mut self, comp_uuid: Option<Uuid>, project: &mut Project, )

Switch to a different composition by UUID.

Updates active_comp and emits CurrentFrameChanged event. Stops playback during transition.

Selection reset: Resets project selection to just this comp. Prevents multi-selection accumulation when adding new clips or switching between comps (e.g., double-click on timeline layer).

pub fn update(&mut self, project: &mut Project) -> Option<i32>

Update playback state. Returns Some(new_frame) if frame changed, None otherwise. Caller should emit SetFrameEvent for unified frame change handling.

pub fn stop(&mut self)

Stop playback (always stops, doesn’t toggle)

pub fn to_start(&mut self, project: &mut Project)

Rewind to start

pub fn to_end(&mut self, project: &mut Project)

Skip to end

pub fn set_frame(&mut self, frame: i32, project: &mut Project)

Set current frame (emits CompEvent::CurrentFrameChanged).

Clamps to full comp timeline [comp.start..=comp.end], not play_range, so scrubbing/timeline can move outside work area while playback still respects play_range.

pub fn step(&mut self, count: i32, project: &mut Project)

Step by N frames (positive = forward, negative = backward) Respects play range and loop_enabled setting

pub fn jog_forward(&mut self)

Jog forward (L, >, ArrowRight)

pub fn jog_backward(&mut self)

Jog backward (J, <, ArrowLeft)

pub fn increase_fps_base(&mut self)

Increase base FPS to next preset (-/+ keys, Keypad)

pub fn decrease_fps_base(&mut self)

Decrease base FPS to previous preset (-/+ keys, Keypad)

pub fn reset_settings(&mut self)

Reset settings

Trait Implementations

impl Clone for Player

fn clone(&self) -> Player

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Player

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

Formats the value using the given formatter.

impl Default for Player

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Player

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Player

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.