Kinesis SoftwareKineticFusion

[Show Table of Contents]

8 Working With RVML Documents

[Hide Table of Contents]

8.4 Putting it all Together

Each RVML document has a single Movie element under which there are a number of elements that define the different sections of the movie.

8.4.1 DataSources

The DataSources element defines all non-default data sources that are available to the Attribute Expression Language and Template evaluation engine. Defining external data sources allows a user to parameterize the movie with dynamic data that is sourced from outside the RVML document while being able to provide defaults for data that is not explicitly available. More information on data sources can be found in the RVML Reference under 'Constructing Dynamic RVML Content'.

8.4.2 ActionScriptSettings

The ActionScriptSettings element allows the RVML document author to override system configuration settings for a single RVML document. A document-specific class path can be specified, classes can explicitly included or excluded from the output SWF, and logging and ActionScript 2.0 settings can be toggled on or off. This element is optional and, when not specified, all setting revert to the global application settings.

8.4.3 Repository

There can be zero or more Repository elements within an RVML document. Each Repository elements defines a set of external resources that may be referenced in the movie. In general, all resources that are defined but not referenced by other symbols in the movie are not included in the output SWF. The only exception to this is for Font references that have the 'forceOutput' attribute set to 'true' - this ensures that fonts that are indirectly referenced are also included (for example, in HTML fields).

8.4.4 ImportSymbols

The ImportSymbols element is optional. When specified it is a container for ImportSymbol elements that specify the name and location of all external symbols from shared libraries that need to be imported into the output SWF at runtime.

8.4.5 Components

The Components element is optional. When specified it is a container for Component elements that specify the name of all SWC components that are required for the movie. Frequently SWC components contain other components - for example, the Flash V2 Menu component has the Flash V2 Button component embedded within it. In cases where SWC components contain other SWC components, only the enclosing component needs to be defined. Should both be defined, KineticFusion will automatically discard any duplicates when outputting the SWF.

8.4.6 Definitions

The Definitions element is rarely empty. All displayable symbols such as Shape, Button, EditField and MovieClip are defined under the Definitions element. There is no restriction on the order that symbols are defined.

8.4.7 ExportSymbols

The ExportSymbols element is optional. When specified it is a container for ExportSymbol elements that specify the symbol name and export ID for all exported symbols.

8.4.8 InitClipActions

The InitClipActions element is optional. InitClip actions are ActionScript blocks that are executed when the associated MovieClip symbols is defined. All InitClip action blocks under this element are executed in the order in which they are defined.

It is also possible to define InitClip actions within a MovieClip symbol - in this case it is necessary to explicitly define the order in which the actions are executed, if the ActionScript depends on any other classes.

8.4.9 Timeline

The final element of an RVML document is the main Timeline element. This is where all the symbols used in the movie are added to the stage, initialized and animated.