Attaches a Director cast library to the current movie
Usage:
dirCastLibAttach (object me, string castName, string filePath)
Parameters:
castName (string) - a string to identify the newly attached cast library
filePath (string) - the path to an existing Director cast library file
Returns:
(integer) - The success code
Example:
-- example asks user for an existing saved file and loads in the cast library
xtRose = xtra("Rosetta").new( )
strPath = xtRose.dlgFile( 2, the moviepath, "untitled.dat", "Project User Data (*.dat)|*.dat", "dat" )
xtRose.dirCastLibAttach( "UserData", strPath )
Notes:
For cast member xtras, it is up to the individual xtra developer to implement their load and save method. If you plan on attaching cast libraries with xtra cast members, you should thoroughly test for compatibility problems. The recommendation is to hold only native Director cast member types in the cast library.