Extract Timelapse Video Segments from Procreate Canvas

Procreate records the creation process as multiple MP4 video segments stored inside the .procreate canvas archive. This function extracts those segments and archives them in CDN vault for downstream processing.

Usage

extract_video_segments(artist, artwork, fp = NULL)

Arguments

artist

Character. Artist UUID identifying the creator.

artwork

Character. Artwork UUID for this piece.

fp

Character. Optional local file path to the .procreate canvas. If NULL (default), retrieves the canvas from CDN.

Value

NULL invisibly. The function's purpose is the side effect of uploading videos.zip to CDN vault.

Details

These segments are later merged into a continuous timelapse video by [extract_timelapse()]. Preserving the original segments in vault allows re-processing if needed and provides forensic evidence of creation.

## Segment Detection Video segments are identified by: - File extension `.mp4` - Filename starting with "segment" - Non-zero file size

Segments are sorted by their embedded timestamps to maintain creation order.

## CDN Storage The extracted segments are bundled into `videos.zip` and stored at `uploads/<artist>/<artwork>/videos.zip` in art-vault.

Functions

• extract_video_segments(): Extract video segments and archive to CDN vault

Idempotency

If videos.zip already exists in CDN vault, the function skips upload and logs a warning. This prevents duplicate processing.

See also

[extract_timelapse()] for processing segments into final video

Other extraction functions: extract_creation_window(), pl-extract-createdate, pl-extract-evidence, pl-extract-meta, pl-extract-signature, pl-extract-stats, pl-extract-timelapse