DESCRIPTION

This function runs a perl expression for each layer of an image. The perl expression can use the following variables:

$image

The image.

$d ("drawable")

The current drawable (currently always a layer).

$i, $I ("index")

The index of the current layer. $i counts from 0 to $n-1, i.e. from top to the bottom of the stack with layer #0 being the top of the stack.

$I counts "backwards", i.e. from $n-1 to 0, so layer 0 is at the bottom.

$p, $P ("percent")

Similar to $i, but counts from 0 to 1 (inclusive). $p is equivalent to $i/($n-1) and $P is equivalent to $I/($n-1).

$n ("number of frames")

The number of layers in the image.

$d2 ("drawable")

The drawable2 argument, entirely optional and can be used for anthing you like.

EXAMPLES

The following expression will gradually fade out an animation.

 $d->brightness_contrast ($P * 127, 0);

This little script can be used to merge two animations, $d2 should point to another animation with the same number of frames (only the image is of concern). It does it by copying each frame of the other animation onto the corresponding frame in the current animation and using DARKEN_MODE to combine the frames. You might want to use other modes or maybe $f-set_opacity(50)> for your animation.

 $i2=$d2->get_image;
 $l2=($i2->get_layers)[$i];

 $i2->selection_all;
 $l2->edit_copy;
 $f=$d->edit_paste(0);
 $f->set_mode(DARKEN_ONLY_MODE);
 $f->anchor;