Presets, transitions, stabilize & batch caveats

See also: Transcode & export presets (exportPreset, convert, compress) · Transitions & stabilize · Progress callback.

#exportPreset

Calls convertVideo with fixed resolution / fps / bitrate / format presets.

Names matched case-insensitively.

1await painter.createVideo({2  source: './master.mp4',3  exportPreset: {4    preset: 'tiktok',5    outputPath: './out/vertical.mp4',6  },7  onProgress: (p) => console.log(`${p.percent}%`),8});

#stabilize

Two-pass vidstab when available:

1. vidstabdetect → transforms .trf
2. vidstabtransform=smoothing=N (**default smoothing 10)

Fallback: hqdn3d spatial/temporal denoise if analyse/transform throws.

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

#addTransition

##Fade-in / fade-out single clip

type: 'fade' without secondVideo:

1await painter.createVideo({2  source: './clip.mp4',3  addTransition: {4    type: 'fade',5    duration: 1.5,6    direction: 'in',7    outputPath: './clip-fadein.mp4',8  },9});

##Between two clips (xfade)

Requires secondVideo. Videos scaled to max(width)×max(height) then xfade at offset = duration(video1) - duration (transition straddles cut point).

type → xfade transition name mapping (defaults fade):

1await painter.createVideo({2  source: './a.mp4',3  addTransition: {4    type: 'fade',5    duration: 0.8,6    secondVideo: './b.mp4',7    outputPath: './ab-crossfade.mp4',8  },9  onProgress: (p) => console.log(p.speed),10});

#batch — recap

Prefer explicit for loops calling createVideo until batchProcessVideos assigns outputs automatically.

#Related ApexPainter helpers (outside createVideo)

These exist on ApexPainter for lower-level control:

• extractFrames(videoSource, options) — always interval mode (ms).
• extractAllFrames — same engine as createVideo.extractAllFrames.
• extractFrameAtTime, extractMultipleFrames — convenience wrappers.
• #createVideoFromFrames / #createVideoLoop — internal; createVideo already exposes createFromFrames / createLoop.

#Operational checklist

1. Install FFmpeg on PATH (ffmpeg, ffprobe).
2. One primary operation key per createVideo call — see router table.
3. source required by TypeScript even when unused (merge, splitScreen, createFromFrames, batch).
4. Windows vs POSIX — detectScenes shell pipeline may need Git Bash / WSL for grep|awk|sed reliability.
5. Heavy ops — reverse, extractAllFrames, stabilize — plan timeouts & disk space (.temp-frames grows).