Transitions, stabilize & batch

#addTransition

##Single-clip fade (**no **secondVideo****)

type: 'fade' only.

1await painter.createVideo({2  source: './intro.mp4',3  addTransition: {4    type: 'fade',5    duration: 1,6    direction: 'in',7    outputPath: './intro-softstart.mp4',8  },9  onProgress: (p) => console.log(p.percent),10});

##Between two videos (xfade)

Requires secondVideo. Videos scaled to max width × max height, then xfade placed so transition spans last duration seconds of source.

type maps to xfade transition names; direction refines wipe/slide/zoom variants (see advanced topic).

1await painter.createVideo({2  source: './shot-a.mp4',3  addTransition: {4    type: 'fade',5    duration: 0.75,6    secondVideo: './shot-b.mp4',7    outputPath: './ab.mp4',8  },9});

#stabilize

What it does: Two-pass vidstab when FFmpeg supports it (vidstabdetect → vidstabtransform).

If vidstab fails, falls back to hqdn3d spatial/temporal smoothing (not true mechanical stabilisation).

1await painter.createVideo({2  source: './walking.mp4',3  stabilize: {4    outputPath: './walking-stable.mp4',5    smoothing: 12,6  },7});

#batch

See Compositing — same caveats (**output paths inside each **operations****).