You can find the original/updated Tag reference at http://registry.gimp.org/node/26501 Tag reference ============= Tag syntax ---------- Tags are enclosed in square brackets. The name of the tag goes first and is followed by optional parameters, which must be integer and separated by ":". Example of valid tag: "[roll:1:10]". The tag name doesn't have to be one of the recognized names listed below. Layers that have at least one syntactically correct tag are not considered animation frames and the script skips over them. If a layer has more than one tag, only the first is actually executed. This is because all of recognized tags actually delete the layer after execution. Therefore it is possible to "comment out" a tag by placing an unrecognized tag like "[comment]" before it. Position -------- One of possible tag arguments is position within frame. It is an integer number which might be negative. It describes where exactly to put a new layer within each frame. If position is non-negative, it counts from the top, starting from 0 (0 means at the top of layer stack and so on). If position is negative, it counts from the bottom, with -1 being the bottom of the frame's layer stack. If position is out of range for the given layer stack, it just puts the source layer as far from the top/bottom as possible, i.e. at the bottom/top. Recognized tags --------------- * bg:limit - walks up from the tagged layer, placing copies of it into every untagged frame it encounters. If limit is supplied, at most limit frames are affected. This is useful for static backgrounds. * fg:limit - walks down from the tagged layer, placing copies of it into every untagged frame it encounters. If limit is supplied, at most limit frames are affected. This is the only tag that walks down. It is useful for static foregrounds, such as text. * copy:position:limit - a more general version of bg tag, it allows to specify position within frame (see a section above). The position is -1 by default, which makes "[copy]" equivalent to "[bg]". If limit is supplied, at most limit frames are affected. It is useful when you want to insert a static element at specific position. * roll:position:limit - works like copy if a single layer is tagged with it. However when it tags a layer group, the sublayers are cyclically picked starting from the bottom and inserted into untagged frames at a given position (-1 by default). If limit is supplied, at most limit frames are affected. This tag allows to insert one animation into another. Note to self: make an example for this tag. * splice:position - a less general version of roll, it sets roll's limit to the number of sublayers in a tagged layer group. This means every sublayer is inserted at most once. It is useful for inserting a non-looped animation.
