When the Storyboard SDK is used to contribute new render extensions, it is desirable to have those render extensions available within the Storyboard Designer environment so that application designers can use the render extensions and configure their properties. To do this, an render extension template file describing the name and properties of the render extension can be created. It is not possible to present a visual display of the render extension within Storyboard Designer so a placeholder image is presented in its place.
Render extension template files are added to individual projects and should be placed
in the templates directory of the project and should use
the file extension sbrt (Storyboard Render Template)
The format of a render extension template file (sbat) file is as follows:
<rendertemplates>
<template name="NAME">
<arguments>
<element name="ARG_NAME" type="ARG_TYPE" />
... as many elements as there are arguments ...
</arguments>
</template>
... as many templates as there are actions ...
</rendertemplates>
Where the fields NAME, ARG_NAME and ARG_TYPE are defined as
This is the name of the render extension as it appears in the Storyboard Engine runtime (gapp) file.
This is the name of an argument option as it appears in the Storyboard Engine runtime (gapp) file.
This is the type of the argument and can be one of the following:
A boolean true/false value. An optional attribute, 'default' can be used to specify the default value.
A color value. An optional attribute, 'default' can be used to specify the default value as a hexadecimal value (0xRRGGBB).
A file string. An optional 'extensions' argument list contains a list
of comma separated filter file extensions, without leading dots for example
extensions="gif;png;bmp"
A numeric floating point value. An optional attribute, 'default', can be used to specify the default value. The range of the number can also be limited using the optional 'min' and 'max' attributes
A numeric integer value. An optional attribute, 'default', can be used to specify the default value. The range of the number can also be limited using the optional 'min' and 'max' attributes
A text string value. An optional attribute, 'default' can be used to specify the default string value.
When the template file is placed in the templates directory, the new
render extensions will be automatically loaded into Designer the next time the project is opened.