auto-editor-transitions

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Transitions

转场

--transition KIND:DURATION[:MIN-CUT]
puts a transition at each cut auto-editor makes, and at the start and end of the timeline. The video and audio transitions are linked: they cover the same span.
bash
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
    : how long each transition lasts (
    0.5sec
    , or a bare frame count).
  • MIN-CUT
    (default
    1sec
    ): skip cuts whose removed source is shorter than this, so trimming a short pause stays a hard cut instead of a stutter.
    0
    transitions at every cut.
A transition draws on the footage that was cut out (its handles), so:
  • it may be shortened, or skipped, when a clip or the removed stretch is too short to support it;
  • whatever was in the removed stretch shows mid-transition. If that's filler you don't want seen, keep transitions short or raise
    MIN-CUT
    .
--transition KIND:DURATION[:MIN-CUT]
会在 auto-editor 执行的每个剪切点以及时间线的开头和结尾添加转场。视频和音频转场相互绑定:它们覆盖相同的区间。
bash
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
    时,在每个剪切点都添加转场。
转场会使用被剪掉的素材(其 handles),因此:
  • 当某个片段或被移除的区间太短、无法支持完整转场时,转场可能会被缩短或跳过;
  • 被移除区间中的内容会在转场过程中显现。如果这些内容是你不想看到的填充素材,请缩短转场时长或提高
    MIN-CUT
    。

Kinds

类型

Every transition Premiere Pro has, under its Premiere name in lowercase with dashes. Those in its Legacy folder that share a name with a newer one end in
-legacy
. They play at Premiere's default settings.
GroupKinds
Dissolve
dissolve
,
additive-dissolve
,
blur-dissolve
,
burn-alpha
,
dip-to-black
,
dip-to-color
,
dip-to-white
,
film-dissolve
,
luma-fade
,
morph-cut
,
mosaic
Animation
block-motion
,
flip-motion
,
fold-motion
,
pop-motion
,
pull-motion
,
spin-motion
,
spring-motion
,
travel-motion
Grunge & Distort
chaos
,
earthquake
,
flicker
,
glass
,
glitch
,
grunge
,
kaleidoscope
,
liquid-distortion
,
tv-power
,
vhs-damage
Lights & Blurs
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
Slide
3d-roll
,
film-roll
,
push
,
roll
,
slide
,
split
,
stretch
,
whip
Smart Tools
motion-camera
,
motion-tween
,
shape-dissolve
,
shape-flow
Text
text-animator
,
typewriter
Transformers
3d-spin
,
3d-spinback
,
frame
,
louver
,
mirror
,
page-peel
,
slice
,
wave
Wipe
clock-wipe
,
linear-wipe
,
neon-wipe
,
panel-wipe
,
plateau-wipe
,
radial-wipe
,
soft-wipe
,
star-wipe
,
stretch-wipe
Immersive Video
vr-chroma-leaks
,
vr-gradient-wipe
,
vr-iris-wipe
,
vr-light-leaks
,
vr-light-rays
,
vr-mobius-zoom
,
vr-random-blocks
,
vr-spherical-blur
Legacy
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
Obsolete (no longer listed in Premiere)
band-slide
,
checker-wipe
,
cube-spin
,
flip-over
,
gradient-wipe
,
page-peel-obsolete
,
page-turn
,
venetian-blinds
dip-to-color
dips to the timeline's background color (
-bg
).
Audio. A video kind gives the audio a plain crossfade. Audio has three kinds of its own:
dissolve
(Premiere's Constant Gain;
constant-gain
is accepted too),
constant-power
and
exponential-fade
. Naming one of those keeps the video a cross-dissolve.
How close to Premiere. auto-editor renders every kind itself. Compared frame by frame with Premiere's own renders,
push
,
clock-wipe
and
barn-doors
match to within encoding noise and
page-peel
is close; the others haven't been measured. Expect simple dissolves and wipes to be near, and effects like
glitch
or
light-leak
, which draw their own noise and colors, to differ. For Premiere's exact look, export with
premiere-otio
and let Premiere render them.
包含 Premiere Pro 的所有转场,名称沿用 Premiere 中的名称,并转换为带连字符的小写形式。Legacy 文件夹中与较新转场同名的项目以
-legacy
结尾。它们均按 Premiere 的默认设置播放。
分组类型
叠化(Dissolve)
dissolve
,
additive-dissolve
,
blur-dissolve
,
burn-alpha
,
dip-to-black
,
dip-to-color
,
dip-to-white
,
film-dissolve
,
luma-fade
,
morph-cut
,
mosaic
动画(Animation)
block-motion
,
flip-motion
,
fold-motion
,
pop-motion
,
pull-motion
,
spin-motion
,
spring-motion
,
travel-motion
污损与扭曲(Grunge & Distort)
chaos
,
earthquake
,
flicker
,
glass
,
glitch
,
grunge
,
kaleidoscope
,
liquid-distortion
,
tv-power
,
vhs-damage
光效与模糊(Lights & Blurs)
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
滑动(Slide)
3d-roll
,
film-roll
,
push
,
roll
,
slide
,
split
,
stretch
,
whip
智能工具(Smart Tools)
motion-camera
,
motion-tween
,
shape-dissolve
,
shape-flow
文本(Text)
text-animator
,
typewriter
变形(Transformers)
3d-spin
,
3d-spinback
,
frame
,
louver
,
mirror
,
page-peel
,
slice
,
wave
擦除(Wipe)
clock-wipe
,
linear-wipe
,
neon-wipe
,
panel-wipe
,
plateau-wipe
,
radial-wipe
,
soft-wipe
,
star-wipe
,
stretch-wipe
沉浸式视频(Immersive Video)
vr-chroma-leaks
,
vr-gradient-wipe
,
vr-iris-wipe
,
vr-light-leaks
,
vr-light-rays
,
vr-mobius-zoom
,
vr-random-blocks
,
vr-spherical-blur
旧版(Legacy)
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
)。
音频。 视频类型的转场会让音频使用普通交叉淡化。音频有三种专用类型:
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 渲染。

Per-transition control: v3 timelines

逐转场控制:v3 时间线

--transition
uses one kind everywhere. For a different kind or length at each cut, export a v3 timeline, edit its
transitions
key, and render it:
bash
auto-editor video.mp4 --transition dissolve:0.5sec --export v3 -o edit.v3
--transition
会在所有位置使用同一种类型。如果要在每个剪切点使用不同类型或不同时长,请导出 v3 时间线,编辑其中的
transitions
键,然后渲染:
bash
auto-editor video.mp4 --transition dissolve:0.5sec --export v3 -o edit.v3

edit edit.v3, then:

edit edit.v3, then:

auto-editor edit.v3 -o out.mp4

```json
"transitions": {
  "v": [[{"kind": "push", "at": 300, "dur": 15, "alignment": "center"}]],
  "a": [[{"kind": "constant-power", "at": 300, "dur": 15, "alignment": "center"}]]
}
at
is the edit point in timeline frames,
dur
the length in frames, and
alignment
is
start
(a fade in from a clip's start),
center
(across a cut between adjacent clips) or
end
(a fade out at a clip's end). Video tracks take video kinds; audio tracks take
dissolve
,
constant-power
or
exponential-fade
. See https://auto-editor.com/docs/v3.
auto-editor edit.v3 -o out.mp4

```json
"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。

In editor exports

在编辑器导出中的表现

ExportWhat arrives
premiere-otio
Every kind, as Premiere's own transitions. Of the obsolete kinds, Premiere still reads
page-turn
and
page-peel-obsolete
; the others are sent as a dissolve, since Premiere would drop them and leave a cut.
premiere
,
resolve-fcp7
(FCP7 XML)
Cross Dissolve; the dips (as Dip to Color Dissolve, which Premiere reads as its Dip to Black or White);
wipe
(as Edge Wipe); Cross Fade (0dB) or (+3dB) for audio. Every other kind becomes a dissolve.
final-cut-pro
,
resolve
(FCPXML)
Cross Dissolve spine transitions.
shotcut
,
kdenlive
Same-track dissolves and crossfades, fade filters at the ends.
v3
Every kind, unchanged.
To bring the kinds into Premiere, use
premiere-otio
.
v1
,
v2
and
clip-sequence
exports drop transitions; a clip sequence's files are separate, so a transition between them has no meaning.
导出格式最终得到的转场
premiere-otio
所有类型均作为 Premiere 原生转场。对于废弃类型,Premiere 仍能读取
page-turn
和
page-peel-obsolete
;其余类型会作为叠化发送,因为 Premiere 会丢弃这些类型并留下硬切。
premiere
,
resolve-fcp7
(FCP7 XML)
Cross Dissolve;各种 dip(作为 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 spine 转场。
shotcut
,
kdenlive
同轨叠化和交叉淡化,并在首尾添加淡化滤镜。
v3
所有类型均保持不变。
若要将各种转场带入 Premiere,请使用
premiere-otio
。
v1
、
v2
和
clip-sequence
导出会丢弃转场;clip sequence 的文件彼此分离,因此它们之间的转场没有意义。

Importing

导入

FCP7 XML and FCPXML imports read the transitions those formats name: Cross Dissolve, Additive Dissolve, Dip to Color Dissolve (black or white by its color), Edge Wipe, the Irises, Page Curl, Star, Cross Fade (0dB/+3dB), and Premiere's names generally. A name it doesn't know plays as a dissolve.
导入 FCP7 XML 和 FCPXML 时,会读取这些格式中明确指定的转场:Cross Dissolve、Additive Dissolve、Dip to Color Dissolve(根据颜色为黑色或白色)、Edge Wipe、各类 Irises、Page Curl、Star、Cross Fade (0dB/+3dB),以及大多数 Premiere 名称。遇到无法识别的名称时,会将其作为叠化播放。

Recipes

示例

bash
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
For cutting itself (edit methods, margins, pace), see the auto-editor skill. For editor exports in general, see the auto-editor-export skill.
bash
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 skill。有关编辑器导出的一般说明,请参阅 auto-editor-export skill。