Files
oak-editor/docs/zh
Mike-Solar d88e2d6ec1 fix(timeline): restore the C++ block length anchors and repair pointer edits
The two BlockCore length setters swapped their anchors relative to the
C++ semantics they document, so the ported edit commands produced wrong
geometry on the live UI paths: roll edits kept the seam still, slides
left negative in-points, and trims wrote the timeline in-point into
media_in (playing the wrong media content).

Adopt three stored-range primitives in block.rs:

- set_length_and_media_out: in fixed, out moves, media untouched
  (resize, trim-out, gaps growing rightward).
- set_length_and_media_in: in fixed, out moves, media_in += old-new
  (resize-with-media-in, splice right half, ripple trim-in).
- set_length_keeping_out (new): out fixed, in moves, media_in +=
  old-new (trim-in body and out-neighbour, slide out-neighbour,
  ripple trim-in of the trailing block).

Point every command at the primitive matching its intent (undopointer,
undogeneral, undoripple, undosplit, graphops, cli, nodeops) and fix the
two real defects the swap hid:

- TrackReplaceBlockWithGapCommand grew a following gap rightward,
  swallowing whatever followed it: the "dragging one clip moves
  unrelated clips" regression. The gap now grows leftward over the
  removed block's span; regression test in domain_test.
- The ripple/splice trims now advance media_in instead of rewriting it,
  and BlockSplitCommand writes both halves' ranges and media
  explicitly (the second half continues from the split point).

Rewrite the KNOWN-SWAP expectations to the correct geometry (roll moves
the seam, slide has no negative in-point, insert-gaps grows rightward,
resize-with-media-in yields media_in = 20) and add the missing media
assertions. TrackSlideCommand documents that the caller positions the
sliding blocks (the stored model has no track layout).
2026-09-24 12:41:29 +08:00
..
2026-01-05 16:22:26 +08:00

home, title, heroImage, heroText, heroFullScreen, tagline, actions, features, footer
home title heroImage heroText heroFullScreen tagline actions features footer
true Oak 视频编辑器 /images/oak-icon.png Oak 视频编辑器 false 现代开源的非线性剪辑器,强调速度与清晰度。
text link type
阅读文档 /zh/build.html primary
text link type
查看工程文件 /zh/project-file-reference.html secondary
title details
快速剪辑 响应式时间线、智能缓存与高效媒体管理。
title details
面向创作者 简洁界面、可配置快捷键与清晰的工程结构。
title details
开源透明 公开开发流程,欢迎社区参与。
Copyright © Oak Video Editor

关于 Oak

Oak 视频编辑器是 Olive 的重命名分支,目标是打造更完善、更友好的剪辑体验。本网站提供构建说明、工程文件参考与测试计划等贡献者文档。

快速开始

  • 按《构建指南》在 Windows/macOS/Linux 上从源码构建。
  • 在《工程文件参考》了解项目数据结构。
  • 在《工程存储架构》了解数据库写穿持久化与持久撤销历史。
  • 按《测试计划》确保发布质量。

下载

v0.4.0

路线图

版本 主题 核心交付物 边界说明
0.3(当前) 插件架构里程碑 OpenFX 宿主支持完整可用 不追求插件数量,追求"任意 OFX 插件加载不崩溃"
0.4 调色、音频与性能 .cube/.3dl 支持、示波器(波形/矢量/直方图)、三向色轮面板、波形自动同步(双系统录音对齐)、BWF 时间码同步、音频表(LUFS/VU)、代理媒体工作流、硬件加速导出(NVENC/VideoToolbox)、批量渲染队列 合并原 0.4-0.6 范围,集中解决调色工作流、音频同步和 4K/8K 可用性
0.5 动画、跟踪与协作 贝塞尔关键帧曲线编辑器、基础点跟踪、画面稳定器、完整 Multicam 角度切换、OpenTimelineIO、EDL/XML 导入导出 合并原 0.7-0.8 范围,集中处理时间线高级能力和外部工具交接
0.6 稳定性里程碑 项目文件格式冻结(向后兼容承诺)、崩溃恢复、Autosave、内存优化 1.0 前的"封版"测试期
1.0 生产就绪 文档完整、安装包、已知问题清单、社区支持渠道 宣告"可用于严肃项目"