Syntax

*AddObject("Part_name", "File_name", "Component", Global/Part/Marker, ["Orienation_name"], X, Y, Z, Z’, X’, Z’’, ScaleX, ScaleY, ScaleZ)

Arguments

Name

Description

Part_name

The name of the part to which the real component image will be attached.  The name must be in double quotes.

File_name

The name of the program .g file containing the real component image.  The name must be in double quotes.

Component

Name of the component image to read from the .g file.  The name must be in double quotes.  A program .g file contains one or more real component images.  See Translators for more information on creating .g files.

Global

Orients the real component image with respect to the global reference frame.

Part

Orients the real component image with respect to the local part reference frame of "Orientation_name".

Marker

Orients the real component image with respect to the local marker reference frame of "Orientation_name".

Orientation_name

Name of the part or marker the object is oriented with (only included if the object is not global)

X, Y, Z

Initial translations

Z’, X’, Z’’

Initial rotations (Euler angles in degrees)

ScaleX, ScaleY, ScaleZ

Initial scaling factors (1.0 == no scaling)

Example

*BeginGraphic()

 • • •

 *AddObject("P/51", "Expl_1.asc.g", "Body",

                         Part, "P/51",

                         55, 73, 21,

                         30, 60, 90,

                         1.0, 1.0, 1.0)

 • • •

*EndGraphic()

Application

MotionView and HyperView windows

Context

*BeginPage()

*BeginGraphic()

Comments

Because Euler angles do not uniquely describe an orientation, the values which appear in the user interface may differ from those specified in the session file, even though the object is correctly aligned.

Rotations occur before translations.

See also

*BeginGraphic()

List of Session Statements