The following design conventions apply only for scrolling carousel scenes.

Scrolling carousel scenes are characterized by containing one or more Scroller plug-ins with belonging directors and stop points.

A scrolling carousel scene must be designed according to the following conventions:

  • The Layer setting in the Scroller plug-in editor must be identical to the director holding the in and out stop points.

  • The Element Source in the Scroller plug-in editor must be identical to the in state stop point of the layer director.

  • The out state stop point of the layer director must be named the letter O. All other states are in state stop points.

  • All template containers must be organized under a root container called ticker_templates. It is important to position the ticker_templates container at the top of the root level of the scene tree, as Viz Engine performs a depth-first search when identifying containers. This means that the system starts with the first root container, and searches through all of its sub-containers, before moving on to the second root container, and so on. Keeping template containers high up in the tree structure improves performance.

  • Do not add any containers under the container holding the Scroller plug-in. The scroller generates its own tree structure with copies of the template containers.

See Also