Skip to contents

Validate Procreate Canvas File Structure

Source: R/canvas-validate-structure.R
valid-canvas.Rd

Use these functions for quick validation before more expensive operations. They check only structural requirements (correct ZIP format, required internal files) without analyzing content. For creative evidence assessment, use [assess_procreate_canvas()] instead.

A valid Procreate canvas must be a ZIP archive containing: - A non-empty `Document.archive` file (serialized canvas state) - At least one of: `video/` directory (timelapse segments) OR `layers/` or `data/` directory (tile storage)

Usage

is_procreate_file(path)

is_procreate_dir(path)

Arguments

path

Character. Absolute or relative path to validate. For `is_procreate_file()`: path to a .procreate file (ZIP archive). For `is_procreate_dir()`: path to an already-extracted directory. The path must exist; non-existent paths return FALSE.

Value

Logical. TRUE if the path contains valid Procreate structure, FALSE otherwise. Returns FALSE (not an error) for non-existent paths, wrong file types, or corrupted archives.

Details

Performs structural validation to confirm a file is a legitimate Procreate canvas before processing. This prevents pipeline failures on corrupted or non-Procreate files.

Functions

  • is_procreate_file(): Checks for a Procreate file. Returns TRUE if file exists, is a parsable zip with `.procreate` extension, and contains the expected structure.

  • is_procreate_dir(): Checks whether `path` is an extracted Procreate directory. Returns TRUE if directory exists and contains expected members.

See also

[assess_procreate_canvas()] for creative evidence assessment

Other canvas validation functions: assess_procreate_canvas(), verify_creation_period()