Oak Video Editor 节点 — Oak Video Editor Manual
节点¶
Oak 采用基于节点的合成与效果系统。每个片段、效果、转场、合成操作最终都表现为节点图中的节点；通过连接节点的输入与输出，可以灵活地控制画面与声音。
节点图基础¶
节点（Node）：最小的处理单元。节点有若干 输入，并通过自身的计算产生输出。
输入 / 输出：一个节点的输出可作为另一个节点输入的来源。连接后，数据会按帧向下游流动。
上下文（Context）：Sequence、Track、Block、NodeGroup 等都可以作为上下文，用来组织和框选一组节点。双击片段会进入该片段的节点上下文。
关键帧：多数数值、颜色、向量输入都可以随时间变化，形成关键帧动画。
常见内置节点分类¶
项目 / 媒体 / 时间线¶
节点 |
作用 |
|---|---|
素材（Footage） |
引用外部媒体文件，是大多数片段的起点。 |
序列（Sequence） |
时间线对象，包含视频轨、音频轨、字幕轨。 |
轨道（Track） |
同类型轨道的容器，混合其上的所有片段。 |
片段（Clip） |
时间轴上的媒体块。 |
空隙（Gap） |
空白片段，用于占位。 |
字幕（Subtitle） |
字幕块。 |
合并（Merge） |
将两层纹理叠加合成。 |
生成器¶
节点 |
作用 |
|---|---|
纯色（Solid） |
生成指定颜色的画面。 |
文本（Text） |
生成文字层。 |
多边形 / 形状 |
生成矢量形状。 |
噪波（Noise） |
生成噪波纹理。 |
数值（Value） |
输出浮点、整数、向量、颜色、矩阵等数值。 |
几何 / 扭曲¶
节点 |
作用 |
|---|---|
变换（Transform） |
位置、旋转、缩放、锚点、自动缩放、插值。 |
裁剪（Crop） |
裁剪画面。 |
翻转（Flip） |
水平或垂直翻转。 |
四角定位（Corner Pin） |
四角变形。 |
遮罩（Mask） |
创建并羽化遮罩。 |
波纹 / 旋转扭曲 / 平铺 |
各种扭曲效果。 |
颜色 / 调色¶
节点 |
作用 |
|---|---|
OCIO LUT |
加载 |
三色轮（Three-Way Color） |
Shadow / Midtone / Highlight 三色轮调色。 |
OCIO 初级调色（Linear） |
Contrast / Offset / Exposure / Saturation 等参数。 |
显示转换（Display Transform） |
显式 Display / View / Direction 转换。 |
转场¶
节点 |
作用 |
|---|---|
交叉溶解（Cross Dissolve） |
两段素材之间的淡入淡出。 |
浸入颜色（Dip To Color） |
过渡到指定颜色。 |
滤镜 / 键控¶
节点 |
作用 |
|---|---|
模糊（Blur） |
Box / Gaussian / Directional / Radial 模糊。 |
马赛克 |
像素化画面。 |
描边 / 投影 |
形状描边与投影。 |
色度键（Chroma Key） |
基于颜色抠像。 |
色差键（Color Difference Key） |
更精细的抠像。 |
去溢色（Despill） |
去除绿幕溢色。 |
数学 / 时间 / 音频¶
节点 |
作用 |
|---|---|
数学（Math） |
对输入做加减乘除等数学运算。 |
三角函数 |
三角函数运算。 |
时间输入 / 时间重映射 / 时间偏移 |
控制时间相关动画或重映射片段时间。 |
音量（Volume） |
调整音频音量。 |
声像（Pan） |
调整左右声道平衡。 |
节点编辑器操作¶
添加节点¶
在节点编辑器空白处右键 →
添加，选择分类和节点。也可以从 素材管理器 直接把素材拖到节点编辑器，自动生成素材节点。
连接与断开¶
在节点的输出端口按住左键拖到另一个节点的输入端口，即可建立连接。
把已有连线的输入端拖到空白处可断开。
把新节点拖到已有连线上方，会自动插入到连线中间。
选择与移动¶
框选、
Ctrl/Shift多选。选中后按方向键可微移节点位置。
展开 / 折叠¶
节点项可展开显示所有可连接输入。
数组输入（如轨道的
块输入）展开后可看到每个元素。
分组¶
选中多个节点 → 右键 →
分组，会创建一个 节点组（NodeGroup）。分组后，组对外暴露输入透传和输出透传，内部节点仍可双击进入编辑。
右键组 →
取消分组可恢复。
删除¶
选中节点或连线后按
Delete。删除节点时会自动断开所有连接。
关键帧¶
在 参数编辑器 中，参数右侧的圆点即为关键帧开关。
开启关键帧后，移动播放头并修改参数即可自动记录关键帧。
关键帧类型包括：线性（Linear）、保持（Hold）、贝塞尔（Bezier）。
在 曲线编辑器（Curve） 面板中可更精细地编辑关键帧曲线。
OpenFX 插件节点¶
Oak 0.3+ 支持 OpenFX（OFX）插件：
启动时会扫描 OFX 插件路径并把 OFX 插件注册为节点。
在节点编辑器的添加菜单中，OFX 插件会按分类列出。
OFX 参数会自动映射为 Oak 参数类型（整数、浮点、布尔、颜色、向量、下拉、按钮等）。
在节点图中，OFX 插件节点只显示纹理输入，避免节点过高；标量参数请在参数编辑器中调节。
项目保存时会记录插件标识符与路径，加载时会先注册插件再实例化节点。
节点预设与复制¶
选中节点后
Ctrl+C/Ctrl+V可复制节点及其依赖子图。目前没有独立的“节点预设库”，可通过复制粘贴或打包成 节点组 来复用常用效果。
限制与注意事项¶
kPushButton类型参数目前点击事件未真正触发插件动作（OFX 按钮参数仅作为显示）。OFX 音频生成器 / 帧生成器类型插件支持不完整。
节点图最多同时显示 10 个上下文。
颜色节点（OCIO 系列）需要项目色彩管理配置正确，否则可能无法工作。