Image Sequences

The imagesequence and image32fsequence ImageProvider delivers frames from a series of images named in ascending numerical order. You can specify a filename template (e.g. "shotseq-$frame.tif"), where as the token $frame will be replace with the current frame number. An additional offset that is added to the frame number can be optionally specified. Frame number will be zero-padded, the default are "5" digit frame numbers.

An image32fsequence works the same as a regular Image Sequence (imagesequence), except that is uses 32-bit floating point TIFF images. 32-bit floating point images are used primarily for UV texture mapping (see the section Texturemapping32f in Transformations)

Field name	Type	Description
Required fields
type	ImageProvider.Type	imagesequence or imagesequence32f
source	FileLocation	A FileLocation indicating the source. See note below about token substitutions.
Optional fields
padding	int	Number of digits in the frame number. Default: 5. Will be zero padded.
offset	int	Numeric offset the will be added to the frame number.

Source path token substitution

The following tokens will be substituted in the FileLocation source:

Token	Substitution
$sessionid	This will be replace with a unique session ID, or with the token ID requesting the video
$frame	Will be substituted with the current frame number in the scene
$variable	Will be substituted with the value of a query parameter. The name of the parameter can be specified in a "variable" block

Example

{
    "scenes": [
        {
            "numframes": 25,
            "tracks": [
                {
                    "content": {
                        "type": "imagesequence",
                        "source": {
                            "path": "userdata/shotseq-$frame.tif"
                            "padding": 4,
                            "offset": 50
                        },
                    }
                }
            ]
        }
    ],
    "params": {
        "vparams": {
            "width": 640,
            "height": 480
        }
    }
}