3D Lingo Dictionary > L-N > loadFile() |
![]() ![]() ![]() |
loadFile()
Syntax
member(whichCastmember
).loadFile(fileName
{,
overwrite
,
generateUniqueNames
})
Description
3D cast member command; imports the assets of the W3D file, fileName
, into the cast member.
The optional overwrite
parameter indicates whether the assets of the W3D file replace the assets of the cast member (TRUE
) or are added to the assets of the cast member (FALSE
). The default value of overwrite
is TRUE
.
If the optional generateUniqueNames
parameter is set to TRUE
, any element in the W3D file with the same name as a corresponding element in the cast member is renamed. If generateUniqueNames
is FALSE
, elements in the cast member are overwritten by corresponding elements in the W3D file with the same name. The default value of generateUniqueNames
is TRUE.
The cast member's state
property must be either -1 (error) or 4 (loaded) before the loadFile
command is used.
Example
This statement imports the contents of the file named Truck.W3d into the cast member named Roadway. The contents of Truck.W3d will be added to the contents of Roadway. If any imported objects have the same names as objects already in Roadway, Director will create new names for them.
member("Roadway").loadFile("Truck.W3d", FALSE, TRUE)
This statement imports the contents of the file named Chevy.W3d into the cast member named Roadway. Chevy.W3d is in a folder named Models one level down from the movie. The contents of Roadway will be replaced by the contents of Chevy.W3d. The third parameter is irrelevant because the value of the second parameter is TRUE
.
member("Roadway").loadFile(the moviePath & "Models\Chevy.W3d", TRUE, TRUE)
See also
![]() ![]() ![]() |