Cast Member Methods - MACROMEDIA DIRECTOR MX 2004-USING DIRECTOR Use Manual

Cast member methods

If the models and model resources you need aren't contained in a particular cast member, the
following methods let you create models and model resources using other 3D cast members
at runtime.
Method
loadFile
(fileName,
Overwrite,
GenerateUnique
Names)
cloneModelFrom
Castmember
(name, model,
castmember)
cloneMotion
FromCastMember
( , ,
name motion
)
castmember
Description
This method loads a W3D format file from
adds all models as children of the world,
fileName,
and updates all palettes.
You can call this method only if the cast member's
state property is either
occurred during a previous attempt to load the file,
or , meaning that media loading is complete. If an
4
attempt is made to call
member is streaming media in, a script error is
generated.
is an optional variable that can be
Overwrite
or :
(1) FALSE (0)
means the old world is replaced by the
TRUE (1)
contents of the file.
means the new file is merged into the
FALSE (0)
existing world.
is a variable that has no
GenerateUniqueNames
meaning unless
Overwrite
If is
Overwrite FALSE (0)
is
GenerateUniqueNames
sharing the same name as existing elements are
assigned a new, algorithmically determined unique
name.
If
GenerateUniqueNames
elements sharing the same name as new elements
being read into the file are replaced by the new
elements.
Performs a deep clone of a model from one cast
member and puts it into another cast member.
The model, its resources, its children, and its
children's resources all are put into the new
cast member.
Performs a deep clone of a motion from one cast
member and puts it into another cast member.
, meaning that an error
-1
while the cast
loadFile
TRUE
is .
FALSE (0)
, then if
, all new elements
TRUE (1)
is , all existing
FALSE (0)
Returns
Nothing if the
operation is
successful, or a script
error if the operation
fails
A model object
A motion object
Cast member methods 345