Animated Image Import

Overview

Converts an animated GIF into a document that can connect directly to the existing Aseprite processing nodes. It preserves each frame's individual duration, such as 40 ms or 120 ms, which makes it suitable for effects and UI animations with uneven timing.

Usage tips

• Select a GIF, then check the first frame through preview and confirm its length with frame_count and total_duration_ms.
• Connect ase to nodes such as ase_frame_select or aseprite_export.
• GIF_LOOP_METADATA_NOT_PRESERVED in warnings does not mean the images or timing failed to import. It only reports that the GIF loop-count metadata is not stored in the PixPipeline document.

Common mistakes

• Very large GIFs, more than 4,096 frames, or a total duration above 24 hours are rejected for safety. Split or resize the source asset first.
• GIF delta frames are composited into complete images before storage. This node is not intended for editing the original GIF compression structure.

Related nodes

• image_sequence_import — use when the animation is supplied as separate still files
• ase_frame_select — extract a particular imported frame as an image
• aseprite_export — save the edited result as an Aseprite document