Reference/Frame Sequence Format
From Affogato
Affogato uses a custom format to specify arbitrary time ranges.
Contents |
Description
A timerange is a string specifying a sequence of frames. The format is
- frame
- start-end
- start-end@step
- any of the above separated by ',' to specify several frames or ranges
The order is kept stricly which allows for reverse frame output and rendering. When ranges or frames overlap, the first time a frame is found is when it gets inserted into the final sequence. Subsequent occurences of the same frame in the original sequence are ignored.
The start- and end frames of a range are guaranteed to always get inserted into the sequence. Even if <math>|Start Frame-End Frame|-Frame Step\times\Bigg\lfloor\frac{|Start Frame-End Frame|}{Frame Step}\Bigg\rfloor\ne0</math>.
Examples
Frame & Reverse Range
5,6-3
Will result in the sequence:
5,6,4,3
Note that frame 5 is omitted later from the 6—3 range as it was already inserted as the first frame.
Range With Step Size & Single Frames
10-20@3,12,13,22
Will result in the sequence:
10,13,16,19,20,12,22
Note that frame 13 was omitted later as it was already in the range 10—20@3.
