Adobe ATMOSPHERE User Manual page 249

237
ADOBE ATMOSPHERE
User Guide
Solid Objects
A solid object is a scene element that contains a hierarchy of primitives that include boxes, cones, walls, fl oors, anchor
points, entry points and groups that contain other primitives. In the Atmosphere application the primitives may be
edited and moved relative to each other. In the Player application, the primitives will have been combined together
into a single fi xed shape. This shape, the 'solid object' , may be animated and used to do physics, but the primitives will
be fi xed in their position relative to the solid object.
The tree of primitives is accessed using the "rootPrimitive" property, and may be searched using the "fi nd" function.
Alternatively, you may fi nd a named object within a solid object using the "getPrimitive" function.
Primitives
A primitive is an object that represents a single geometrical entity in the Builder, such as a cone, box, fl oor or wall.
Other primitives include anchors and entry points that may be used to specify positions and orientations to a script.
Primitives that have geometry contain an array of "face" objects which correspond to the planar polygons of the
primitive. Primitives may also have on-click methods attached to them to enable interaction.
Faces
A face object of a primitive represents a single planar region of that primitive, and may have an associated surface
texture.
Surface Textures
A surface texture is an object that contains the mapping between a face and a texture map. This mapping includes the
rotation angle, size and position of the texture relative to the surface. It also contains a reference to the texture object
which stores the actual image.
Textures
A texture is an object that stores an image, and which is used by a 'surface texture' to be mapped onto a primitive.
Viewpoint Objects
A Viewpoint object is an element in the scene hierarchy which contains an imported object specifi ed by a Viewpoint
MTX fi le (which may have an associated MTS fi le). A Viewpoint object contains a single MTSScene object, which is
the root of the Viewpoint scene hierarchy. A Viewpoint scene contains a hierarchy of "instances". An instance contains
a transformation and reference to a piece of Viewpoint geometry (a polygon mesh) as well as an array of child
instances. Viewpoint instances also contain an array of MTSMaterial objects that describe how a piece of geometry
is textured and rendered. Viewpoint surfaces may be textured using static images (MTSTexture) or SWF animations.
Viewpoint objects may have rich materials including bump mapping and environment mapping, but do not take part
in static lighting computations in the Atmosphere application. Viewpoint objects do not receive dynamic shadows in
the Player.