Clip Apply Image

Overview

Applies a clip from keyframe_clip to an image. It reproduces motion recorded as selection movement and transformation on an image at a specified time. This is the image counterpart of clip_apply_path, bridging a clip to its final image.

Usage tips

• The go-to chain is keyframe_clip.clip + source image → clip_apply_image → animation_render. The recorded selection motion is baked into a spritesheet.
• Connect Time Source to progress to synchronize it with rendering. For manual scrubbing, connect Float Input to progress.

Related nodes

• keyframe_clip — supplies the clip to apply
• clip_apply_path — path counterpart
• animation_render — final bake
• time_source — supplies the time

Technical details

The current implementation applies a selection transform recorded by PixelCanvas to the final image using nearest-neighbor sampling.

The important points about the current Clip Apply Image are:

• It does not edit the PixelCanvasDocument itself.
• It operates on a render-domain Image.

The P07 baseline therefore prioritizes these uses:

• Previewing a recorded selection move as-is
• Passing the result to downstream composition and rendering

Non-destructive re-editing of individual layers is not supported at this stage.

Examples

1. PixelCanvas
2. RecordTake
3. KeyframeClip
4. ClipApplyImage

Connections:

• RecordTake.layer -> KeyframeClip.layer
• PixelCanvas.output -> ClipApplyImage.image
• KeyframeClip.clip -> ClipApplyImage.clip
• Float Input.output -> ClipApplyImage.time

Moving Float Input now reapplies the recorded selection transform to the image.

Time and bounds warnings

• The only time input is progress (normalized 0–1). Connect Time Source to progress. The legacy absolute-seconds time pin has been removed; old connections are rewired to progress on load. Unconnected graph time is treated as normalized progress.
• If the current image size differs from the recorded one, selection bounds are safely intersected with the real image. warnings reports bounds_clipped for a partial intersection and bounds_outside when no source pixels remain.