auto-editor-transitions

转场

--transition KIND:DURATION[:MIN-CUT] 会在 auto-editor 生成的每个切点，以及时间线的起点和终点添加转场。视频和音频转场会关联在一起：它们覆盖相同的时长。

auto-editor video.mp4 --transition dissolve:1sec        # cross-dissolves, fades at the ends
auto-editor video.mp4 --transition push:0.5sec          # a Premiere Pro transition
auto-editor video.mp4 --transition clock-wipe:1sec:0    # at every cut, however short
auto-editor video.mp4 --transition constant-power:1sec  # audio crossfade kind; video dissolves

• DURATION：每个转场的时长（0.5sec，或直接使用帧数）。
• MIN-CUT（默认值为 1sec）：跳过已移除的源片段短于此时长的切点，这样剪掉短暂停顿时会保留硬切，而不会造成卡顿。 0 表示在每个切点都添加转场。

转场会使用剪掉的素材（手柄），因此：

• 如果片段或被移除的部分太短，无法支持转场，转场可能会缩短或跳过；
• 被移除部分中的内容会在转场中途显示。如果不想让观众看到这些填充内容，请缩短转场时长或调高 MIN-CUT。

类型

包含 Premiere Pro 中的所有转场，名称采用 Premiere 中的名称并转换为小写，单词之间用连字符分隔。Legacy 文件夹中与新版转场同名的转场会以 -legacy 结尾。它们使用 Premiere 的默认设置播放。

分组	类型
溶解	dissolve、additive-dissolve、blur-dissolve、burn-alpha、dip-to-black、dip-to-color、dip-to-white、film-dissolve、luma-fade、morph-cut、mosaic
动画	block-motion、flip-motion、fold-motion、pop-motion、pull-motion、spin-motion、spring-motion、travel-motion
纹理与扭曲	chaos、earthquake、flicker、glass、glitch、grunge、kaleidoscope、liquid-distortion、tv-power、vhs-damage
灯光与模糊	burn-chroma、chroma-leak、cross-zoom、directional-blur、flare、flash、glow、lens-blur、light-leak、light-sweep、phosphor、radial-blur、ray、solarize、stripe、zoom-blur
滑动	3d-roll、film-roll、push、roll、slide、split、stretch、whip
智能工具	motion-camera、motion-tween、shape-dissolve、shape-flow
文字	text-animator、typewriter
变换	3d-spin、3d-spinback、frame、louver、mirror、page-peel、slice、wave
擦除	clock-wipe、linear-wipe、neon-wipe、panel-wipe、plateau-wipe、radial-wipe、soft-wipe、star-wipe、stretch-wipe
沉浸式视频	vr-chroma-leaks、vr-gradient-wipe、vr-iris-wipe、vr-light-leaks、vr-light-rays、vr-mobius-zoom、vr-random-blocks、vr-spherical-blur
旧版	additive-dissolve-legacy、barn-doors、center-split、clock-wipe-legacy、cross-dissolve-legacy、cross-zoom-legacy、dip-to-black-legacy、dip-to-white-legacy、film-dissolve-legacy、inset、iris-box、iris-cross、iris-diamond、iris-round、non-additive-dissolve、push-legacy、radial-wipe-legacy、slide-legacy、split-legacy、whip-legacy、wipe
已弃用（Premiere 中不再列出）	band-slide、checker-wipe、cube-spin、flip-over、gradient-wipe、page-peel-obsolete、page-turn、venetian-blinds

dip-to-color 会转场至时间线的背景颜色（-bg）。

音频。 视频类型会为音频添加普通交叉淡化。音频还有 3 种专用类型：dissolve（Premiere 的 Constant Gain；也接受 constant-gain）、constant-power 和 exponential-fade。指定其中一种时，视频仍会使用交叉溶解。

与 Premiere 的接近程度。 auto-editor 会自行渲染所有类型。逐帧与 Premiere 渲染结果比较时，push、clock-wipe 和 barn-doors 的差异在编码噪声范围内，page-peel 也很接近；其他类型尚未测量。普通溶解和擦除预计会比较接近，而 glitch 或 light-leak 这类自行生成噪点和颜色的效果则会有所不同。要获得 Premiere 的精确效果，请使用 premiere-otio 导出，然后交由 Premiere 渲染。

逐转场控制：v3 时间线

--transition 会在所有位置使用同一种类型。若要在每个剪辑点使用不同类型或时长，请导出 v3 时间线，编辑其 transitions 键，然后渲染：

auto-editor video.mp4 --transition dissolve:0.5sec --export v3 -o edit.v3
# edit edit.v3, then:
auto-editor edit.v3 -o out.mp4

"transitions": {
  "v": [[{"kind": "push", "at": 300, "dur": 15, "alignment": "center"}]],
  "a": [[{"kind": "constant-power", "at": 300, "dur": 15, "alignment": "center"}]]
}

at 是时间线中的剪辑点帧数，dur 是时长帧数，而 alignment 可以是 start（从片段起点淡入）、center（在相邻片段之间的剪辑点两侧进行转场）或 end（在片段终点淡出）。视频轨道使用视频类型；音频轨道使用 dissolve、constant-power 或 exponential-fade。请参阅 https://auto-editor.com/docs/v3。

在编辑器中导出

导出格式	导出内容
premiere-otio	所有类型，均以 Premiere 自带转场的形式导出。对于已过时的类型，Premiere 仍可读取 page-turn 和 page-peel-obsolete；其他类型会作为叠化发送，因为 Premiere 会将其丢弃并留下剪辑点。
premiere、resolve-fcp7（FCP7 XML）	交叉叠化；淡入淡出（作为 Dip to Color Dissolve，Premiere 会将其识别为 Dip to Black 或 Dip to White）；wipe（作为 Edge Wipe）；音频的 Cross Fade (0dB) 或 (+3dB)。其他类型均会变为叠化。
final-cut-pro、resolve（FCPXML）	Cross Dissolve 主干转场。
shotcut、kdenlive	同轨叠化和交叉淡化，以及片段结尾处的淡化滤镜。
v3	所有类型，保持不变。

要将这些类型导入 Premiere，请使用 premiere-otio。v1、v2 和 clip-sequence 导出会丢弃转场；片段序列中的文件彼此独立，因此它们之间的转场没有意义。

导入

FCP7 XML 和 FCPXML 导入会读取这些格式指定的转场：Cross Dissolve、Additive Dissolve、Dip to Color Dissolve（根据其颜色区分黑色或白色）、Edge Wipe、各种 Iris、Page Curl、Star、Cross Fade (0dB/+3dB)，以及 Premiere 通常使用的名称。无法识别的名称会以叠化播放。

操作示例

auto-editor talk.mp4 --transition dissolve:0.3sec           # soft cuts in a talking-head video
auto-editor vlog.mp4 --transition whip:0.4sec:2sec          # whips, only where 2s+ was removed
auto-editor podcast.mp3 --transition constant-power:0.2sec  # audio-only: smooth crossfades
auto-editor video.mp4 --transition push:0.5sec --export premiere-otio   # finish in Premiere

关于剪辑本身（编辑方法、边距、节奏），请参阅 auto-editor 技能。关于编辑器导出的一般信息，请参阅 auto-editor-export 技能。