SceneGraph components are compiled as the application is started. All SceneGraph component files (with the extension *.xml)
, and any related BrightScript files (with the extension *.brs)
, in the pkg:/components
directory, are compiled.
BrightScript files in the pkg:/components
directory are compiled in the same way as BrightScript files in the pkg:/source
directory. The SceneGraph component files are compiled by creating a list of component names for the application, based on the name
attribute of the <component> element of each file. These component names are checked for validity as instances of the components are created in the application. This check is case-sensitive: the component name to be created must exactly match a name in the component name list, including case. The application begins to create instances of SceneGraph components starting with a component extended from a scene node class (either Scene or OverhangPanelSetScene). See Component Initialization Order for a description of the process that creates component instances.
Important
There must be only one SceneGraph component extended from a scene node class in the pkg:/components
directory. All component names in an application should be unique to avoid the possibility of creating an instance of an unwanted component definition.