Discovery & metadata options

#getInfo

What it does: Reads container + primary video stream via ffprobe (duration, size, fps, bitrate, format name). Does not write a file.

When to use: Before cropping/scaling, choosing trim points, or sizing thumbnails.

##Effect of the flag

No other fields on VideoCreationOptions matter for this branch besides source.

##Example

1const painter = new ApexPainter();2 3const info = await painter.createVideo({4  source: './episode.mp4',5  getInfo: true,6});7 8console.log(9  `Duration ${info.duration}s, ${info.width}x${info.height} @ ${info.fps}fps`10);

#detectFormat

What it does: Same metadata as getInfo, plus a video codec tag (h264, vp9, …) from ffprobe stream codec_name.

When to use: Logging, conditional pipelines (“if HEVC, transcode first”), or debugging uploads.

##Options

There are no sub-options — only detectFormat: true.

##Return shape

##Example

1const probe = await painter.createVideo({2  source: './upload.bin', // buffer or path3  detectFormat: true,4});5 6if (probe.codec === 'hevc') {7  console.warn('HEVC — consider converting for web');8}