refactor(node): de-Qt oaknode and wrap it in a pure C ABI

- copy engine/node (188 files) to src/node/src, de-Qt in waves:
  core infra (Node/Param/Value/Variant/mathtypes), project/serializer,
  block/output, color, effect leaves, generator, gizmo/plugins
- strip QObject/signals/slots: notifications move to the facade's
  oakengine_event channel, ownership becomes explicit (unique_ptr,
  add_keyframe/add_gizmo), sender() replaced by current_gizmo
- QVariant replaced by olive::Variant, Qt math types by POD mathtypes,
  QXmlStreamReader/Writer by oakcommon's expat-based classes
- sink VideoParams/SubtitleParams/LoopMode/ColorTransform to oakcommon
  (M3.5); polygon/text rasterization behind backend hooks
- pure C ABI in include/node + src/node/c_api (oaknode_ prefix,
  OAKNODE_E_* codes, undoable variants take OakUndoCommand out-params)
- fix Project::clear() root_ reset + disconnect assert, Sequence
  TrackList leak
- 96 gtest cases green in standalone build (build-oaknode)
- docs: signal/slot handling strategy + M3 implementation status
This commit is contained in:
2026-08-05 23:55:54 +08:00
parent c50017127b
commit d77348ad9f
375 changed files with 59682 additions and 1 deletions
+92
View File
@@ -80,3 +80,95 @@ M3 阶段判据(放宽版):oaknode 目录就位、C API 实现、oaknode_g
- 枚举序数:NodeValue::Type ⇄ oak_node_value_type 映射表(已在
nodevaluehandle.h 钉过一次,oaknode 测试再钉一次,防两侧漂移)。
- `oaknode_debug_alive_count()` 泄漏断言。
## 实施现状(2026-08-05)
M3 已落地并可独立构建、测试全绿(96 个用例全部通过,无 skip)。
以下为与上文计划的实际差异。
### 最终目录结构
- `src/node/src/` — 去 Qt 化 C++ 实现(`olive::` 命名空间),target
`oaknode`(SHARED);平铺结构,`src/node/src` 为 include 根,
模块内 include 无前缀(`"value.h"`、`"block/block.h"`)。
- `src/node/c_api/` — 纯 C ABI 包装(node/group/keyframe/factory/
traverser/project/folder/footage/serializer/block/track/sequence/
colormanager 共 13 个 .cpp + 内部头 `valueconvert.h`/`alivecount.h`),
通过 `target_sources` 合并进 `oaknode`,不单独成库。
- `src/node/tests/` — gtest,单一 target `oaknode-gtest`(13 个
_test.cpp + 共享夹具 `testnode.h`),`gtest_discover_tests`
(`DISCOVERY_MODE PRE_TEST`)。
- `include/node/`(仓库根)— 公共 C 头:`error.h` + node/group/
keyframe/factory/traverser/project/folder/footage/serializer/block/
track/sequence/colormanager.h。
- `src/node/standalone/CMakeLists.txt` — 独立构建 driver(见下)。
- `src/node/DEQT.md` — 去Qt化替换约定与逐波次裁决记录。
- `src/node/transition/` — 过渡 stub 头(见「实际依赖」)。
### 独立构建与测试
```sh
cmake -S src/node/standalone -B build-oaknode
cmake --build build-oaknode -j
ctest --test-dir build-oaknode --output-on-failure
```
driver 照 src/common/standalone 模式:EXPAT/OpenColorIO/OpenImageIO
用 Homebrew 的 config 包(`find_package(... CONFIG)`)并映射到
`${OCIO_LIBRARIES}` 等变量;`add_subdirectory` 引入真实 in-repo
target(core→olivecore、ffmpeg_bridge、src/undo→oakundo、
src/common→oakcommon,各自 BUILD_TESTS 关闭),不再链接预构建
dylib;禁用 OpenTimelineIO(`/opt/otio` 的 `@loader_path` 问题,
oaknode 不需要)。
### 实际依赖
- Oak 内部:oakcommon(XML/Current/工具)、oakundo(UndoCommand/
UndoStack)、olivecore(`olive::core::Rational/Color/Bezier` 等
C ABI 包装,真实符号)、ffmpeg_bridge(经 oakcommon 间接)。
- 第三方:EXPAT、OpenColorIO、OpenImageIO、Imath(头)、FFmpeg
(经 ffmpeg_bridge 间接)、GTest(仅测试)。
- **transition stub 机制**(裁决 A):对尚未拆分的
render/codec/timeline/audio/pluginSupport 模块的引用允许悬空——
头文件由 `src/node/transition/` 的过渡 stub/转发头提供(engine 头
仍是 Qt 版),符号经 `-undefined dynamic_lookup`(macOS)留到
运行时解析。测试进程启动时必须能解析这些符号:oaknode-gtest
链接真实 target(olivecore/oakcommon/oakundo + OCIO/OIIO/Imath
dylib)并 `-Wl,-force_load` 预构建的
`build/third_party/openfx/HostSupport/libOfxHost.a`(OFX 符号与
typeinfo,否则二进制启动即崩,PRE_TEST 发现模式也会挂;路径用
`find_library` 定位,可由 `OAKNODE_OFX_HOST_ARCHIVE` 覆盖)。
- ColorManager 构造时需要有效 OCIO 配置(`:/ocioconf` qrc 提取是
Qt 资源遗留、必然失败):ctest 经 `ENVIRONMENT OCIO=...` 指向
`engine/render/ocioconf/config.ocio`,colormanager_test 另用
`OAK_OCIO_TEST_CONFIG` 编译定义兜底。
### 与冻结 C API 的主要差异
- 函数族命名与约定照 oakcommon/oakundo 既有契约:`oaknode_<族>_<动词>`,
int 错误码 + out 参数,字符串两段式 buffer;undoable 变体成对
(`_undoable` 后缀,部分经 `OakUndoCommand *` 尾参)。
- §2 冻结表中**跳过/未实现**的函数族:
- Sequence 的 workarea/markers 族(timeline 边界类型
TimelineMarker/TimelineWorkArea 未拆,留 M4);
- ProjectSerializer 的落盘 save/load(按计划迁 oakstorage M10),
本模块只实现内存形态 `save_to_xml`/`load_from_xml` + SaveData/
LoadData 句柄;
- Node 的 `oak_node_value` 句柄族未单独成族,输入值经
`oaknode_node_get/set_input[_string][_undoable]` 直接收发;
- 无任何事件订阅接口(与 §2 特殊约定 2 一致)。
- `oaknode_debug_alive_count()` 泄漏断言已实现并在测试中使用。
### 已知问题
- `NodeGroupAddInputPassthrough` 的上游 bug 原样保留(未修,待裁决)。
- polygon/text 光栅化后端钩子(PathFillBackend/TextMeasureBackend/
TextRenderBackend)未安装前输出空白;footage 离线警示帧丢失文字
叠层;track 默认高度固化为 13px——均为被迫行为差异,见
`notes.md`「oaknode 去Qt化的删除与语义变更」。
- 去Qt化顺带修了三个上游 bug(行为与旧版不同):
`Project::clear()` 重置 `root_`(可重新 initialize)、clear 删除
顺序修正(不再触发 disconnect_edge 的 parent assert)、
`Sequence` 析构删除三个 `TrackList`(原泄漏)。详见 notes.md。
- 库本体对 transition stub 模块的符号悬空在 M7/M9 复核前是预期
状态;禁止新增对 render/codec/timeline/audio/pluginSupport 的引用。