Files
oak-editor/crates/oaktimeline/src/common.rs
T
Mike-Solar ab1a2e9c7b refactor: drop internal bridge/ffi layers; exporter family lands
Single-lib cleanup: the per-crate src/bridge/ and src/ffi.rs layers are
gone (oakundo/oakcommon/oaknode/oaktimeline/oakcodec/oakaudio/
oakrender/oaktask/oakplugin/oakstorage); cross-crate calls are plain
Rust, CHandle marshalling shrinks to the oakengine boundary, and tests
call the Rust APIs directly (pure C-ABI wrapper tests removed where
the domain layer already covers the behavior).

exporter.h family implemented: oakengine_export_render (CLI contract),
oakengine_export_render_with_params (was a stub), last_error and
progress callback; synchronous path reuses task_create_export +
start_sync. Fixes on the way: oaktask video ticket self-deadlock,
audio params dropped on the export path, codec encoder AAC slicing and
H.264 time base. Real-mp4 tests cover both entry points, progress and
the illegal-argument matrix.

Also: oakstorage session maps null project handles to None (version-
info path), configstore test double literal 3.14 -> 3.15 (clippy PI
lint), oakaudio output callback scratch buffer + env-aware P1 test,
cli media round-trip test uses a generated 16-frame clip (no more
minute-long debug runs).
2026-08-16 00:33:45 +08:00

106 lines
3.4 KiB
Rust

// Oak Video Editor - Non-Linear Video Editor
// Copyright (C) 2026 Oak Team
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program. If not, see <http://www.gnu.org/licenses/>.
//! The shared `Timeline` namespace (`src/timeline/src/timelinecommon.h`):
//! movement/thumbnail/waveform modes and the `EditToInfo` struct.
//!
//! Enum discriminants are value-compatible with both `include/timeline/edit.h`
//! (`OAKTIMELINE_MOVEMENT_*`) and `include/timeline/displaymode.h`
//! (`OAK_TIMELINE_THUMBNAIL_*` / `OAK_TIMELINE_WAVEFORMS_*`); the deleted C
//! ABI export layer used to map between them mechanically.
use oakcore_rs::Rational;
/// `Timeline::MovementMode` (timelinecommon.h).
///
/// `OAKTIMELINE_MOVEMENT_NONE = 0`, `MOVE = 1`, `TRIM_IN = 2`,
/// `TRIM_OUT = 3` (include/timeline/edit.h).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum MovementMode {
/// `k_none`: no movement.
None,
/// `k_move`: slide/position move.
Move,
/// `k_trim_in`: trim the in point.
TrimIn,
/// `k_trim_out`: trim the out point.
TrimOut,
}
impl MovementMode {
/// `Timeline::is_a_trim_mode`: true for `TrimIn`/`TrimOut`.
pub fn is_a_trim_mode(self) -> bool {
matches!(self, MovementMode::TrimIn | MovementMode::TrimOut)
}
/// Map to the `OAKTIMELINE_MOVEMENT_*` C enum value.
pub fn to_c_int(self) -> i32 {
match self {
MovementMode::None => 0,
MovementMode::Move => 1,
MovementMode::TrimIn => 2,
MovementMode::TrimOut => 3,
}
}
/// Map a `OAKTIMELINE_MOVEMENT_*` C enum value back; `None` when the
/// integer is out of range.
pub fn from_c_int(v: i32) -> Option<MovementMode> {
match v {
0 => Some(MovementMode::None),
1 => Some(MovementMode::Move),
2 => Some(MovementMode::TrimIn),
3 => Some(MovementMode::TrimOut),
_ => None,
}
}
}
/// `Timeline::ThumbnailMode` (timelinecommon.h). Discriminants match
/// `OAK_TIMELINE_THUMBNAIL_OFF/IN_OUT/ON` (include/timeline/displaymode.h).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ThumbnailMode {
/// `k_thumbnail_off`: no thumbnails.
Off,
/// `k_thumbnail_in_out`: thumbnail at in/out.
InOut,
/// `k_thumbnail_on`: thumbnails on.
On,
}
/// `Timeline::WaveformMode` (timelinecommon.h). Discriminants match
/// `OAK_TIMELINE_WAVEFORMS_DISABLED/ENABLED` (include/timeline/displaymode.h).
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum WaveformMode {
/// `k_waveforms_disabled`.
Disabled,
/// `k_waveforms_enabled`.
Enabled,
}
/// `Timeline::EditToInfo` (timelinecommon.h): where the nearest block edge
/// falls for a pointer edit. The node references are the single-lib
/// domain handles ([`crate::util::NodeRef`] — `None` where the C ABI
/// used a null handle).
pub struct EditToInfo {
/// Owning track of the nearest block.
pub track: Option<crate::util::NodeRef>,
/// Nearest edit point time.
pub nearest_time: Rational,
/// Nearest block.
pub nearest_block: Option<crate::util::NodeRef>,
}