feat(rust): oakcodec/oaktask/oakplugin crates + oakotio + node/render/storage skeletons

- oakcodec: full crate incl. real FFmpeg decode/encode via ffmpeg-next (162 tests, 84.4% cov); new oakcodec_encoding_* metadata family (include/codec/format.h, C++ + Rust sides) - oaktask: manager/tasks/project load-save incl. OTIO via oakotio (82 tests, 86.4% cov); concurrent render loop with reorder buffer - oakplugin: M11 phase 1+2 — self-contained OFX host, GL path, ofxColour, pluginrenderer absorbed as render_driver (99 tests, 81.7% cov); instance.h additions documented - oakotio: native serde-based OTIO read/write (24 tests) - oaknode gap fill: dragger/keyframe-helper/multicam C ABI families (113/113 gtest); fixes a latent NodeInputDragger segfault - oaknode Rust skeleton: 43 built-in node type declarations - oakrender/oakstorage: declaration skeletons (implementation pending) - notes.md: gap analysis + tech-debt ledger
2026-08-09 05:49:15 +08:00
parent 4b24aa9d67
commit cac41d92c1
270 changed files with 68323 additions and 10 deletions
@@ -96,6 +96,74 @@ int oakplugin_instance_cancel(OakPluginInstance instance);
 /** @brief Alive-count for leak assertions in tests. */
 int oakplugin_debug_alive_count(void);

+/*
+ * M11 §4（GL 路径 + render 驱动收编）新增声明。既有签名不变。
+ *
+ * oakrender 的 PluginJob 经本组入口把整帧渲染流程（RoI/RoD、
+ * 多输入收集、isIdentity 短路、参数覆盖、CPU/GL 渲染与输出装配）
+ * 委托给 oakplugin 的 render 驱动（Rust 侧 render_driver 模块，
+ * 语义对照 src/render/src/plugin/pluginrenderer.cpp）。
+ */
+
+/** @brief 一帧渲染任务的参数覆盖条目（参数名 → oaknode_value POD；
+ *         字符串参数走 oakplugin_instance_set_param_string）。 */
+typedef struct oakplugin_job_value {
+    const char *key;
+    oaknode_value value;
+} oakplugin_job_value;
+
+/** @brief 一帧渲染任务的输入 clip 纹理条目。纹理为借用句柄
+ *         （job 内有效）。 */
+typedef struct oakplugin_job_texture {
+    const char *clip;
+    OakRenderTexture texture;
+} oakplugin_job_texture;
+
+/**
+ * @brief beginSequenceRender 括号。oakrender 对同一实例的一批帧先
+ *        begin 后 end，中间逐帧 oakplugin_instance_render_job
+ *        （OFX：render action 由 begin/end sequence render 括号包围）。
+ *        `interactive` 为信息性标记（Phase 2 不传入 action）。
+ */
+int oakplugin_instance_render_begin_sequence(OakPluginInstance instance,
+                                             double start_time,
+                                             double end_time,
+                                             int interactive);
+
+/** @brief endSequenceRender 括号（与 render_begin_sequence 配对）。 */
+int oakplugin_instance_render_end_sequence(OakPluginInstance instance,
+                                           double start_time,
+                                           double end_time,
+                                           int interactive);
+
+/**
+ * @brief 一帧渲染的单一 C ABI 调用（PluginJob 的载体）。
+ *
+ * @param dst  目标纹理（oakrender 创建）。GL 模式下调用方须先把
+ *        dst 附着为渲染器输出目标并保持 GL 上下文 current
+ *        （OFX "OpenGL Current Context" 规则；等价 C++
+ *        PluginRenderer::attach_output_texture）。
+ * @param src  主输入纹理（effect_input_id / SimpleSource；可空句柄）。
+ * @param effect_input_id  job.src 落点的 clip 名（可 NULL）。
+ * @param inputs / input_count  其余输入 clip 的纹理表。
+ * @param values / value_count  参数覆盖表。
+ * @param renderer  GL 渲染器（空句柄 → CPU 路径）。
+ * @param clear_destination / interactive  信息性标记（Phase 2，
+ *        render 驱动暂不处理；上层渲染器负责目标清空）。
+ */
+int oakplugin_instance_render_job(OakPluginInstance instance,
+                                  OakRenderTexture dst,
+                                  double time_seconds,
+                                  int clear_destination,
+                                  int interactive,
+                                  const char *effect_input_id,
+                                  OakRenderTexture src,
+                                  const oakplugin_job_texture *inputs,
+                                  int input_count,
+                                  const oakplugin_job_value *values,
+                                  int value_count,
+                                  OakRenderRenderer renderer);
+
 #ifdef __cplusplus
 }
 #endif