link_cels
Destructive
Merge selected frames into one shared cel so a single drawing appears on all of them, letting edits to any linked frame update every frame at once.
Instructions
Make several frames share one image, which is how a held pose is authored.
A linked cel is one image appearing on several frames: editing any of them edits all
of them, and the file stores the image once instead of once per frame. Use it for a
pose that genuinely repeats, such as the two extremes of a cycle that return to the
same drawing.
**The first listed frame's image is the one kept.** Every other listed frame loses
whatever was drawn on it and shows the first frame's image instead, which is the point
of linking and is not undoable from here, so check with `get_cel` first if the frames
differ.
To hold a pose for longer rather than to repeat a drawing, lengthen the frame instead
(`set_frame_duration`, or `apply_timing_curve`): a duration costs nothing, while a
repeated frame shifts every tag index.
Returns the layer's link groups: the frames that now share an image, in groups.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| layer | Yes | ||
| frames | Yes | ||
| filename | Yes |