Scene.ExternalFiles
 
 
 

Scene.ExternalFiles

Introduced

v5.0

Description

Returns a FileReferenceCollection, a collection of FileReference objects containing all external files related to this scene. Only input files are added to this list (for example graphics files, audio files, referenced model files, etc.).

C# Syntax

// get accessor
FileReferenceCollection rtn = Scene.ExternalFiles;

Examples

JScript Example

/*
        This example demonstrates how to get the list 
        of external files associated with the scene.
*/ 
NewScene (0, false);
// First import a model so we have some external files to find
var FPath = InstallationPath( siFactoryPath );
ImportModel( FPath + "\\Data\\XSI_SAMPLES\\Models\\Man_Face.emdl", null, true );
// Enumerate all files related to the current (active) scene
var l_extFileList = Application.ActiveProject.ActiveScene.ExternalFiles;
for ( var i=0; i<l_extFileList.Count; i++ ) {
        printFileInfo( l_extFileList(i) );
}
// ---------------------------------------------------------------------------
//      CONVENIENCE FUNCTION
//
function printFileInfo( in_file ) {
        LogMessage( in_file.FileType );
        LogMessage( in_file.FileExists() );
        // Get the original path 
        var o_path = in_file;
        // Get the resolved path
        var r_path = o_path.ResolvedPath;
        // Get the UNC path
        var u_path = o_path.UNCPath;
        // Print all three results
        LogMessage( "ORIGINAL: " + o_path );
        LogMessage( "RESOLVED: " + r_path ); 
        LogMessage( "UNC     : " + u_path );
}
// Expected result:
//INFO : Models
//INFO : 1
//INFO : ORIGINAL: <factory_location>\Data\XSI_SAMPLES\Models\Man_Face.emdl
//INFO : RESOLVED: <factory_location>\Data\XSI_SAMPLES\Models\Man_Face.emdl
//INFO : UNC     : <factory_location>\Data\XSI_SAMPLES\Models\Man_Face.emdl
//INFO : Pictures
//INFO : 1
//INFO : ORIGINAL: <factory_location>\Application\rsrc\noIcon.pic
//INFO : RESOLVED: <factory_location>\Application\rsrc\noIcon.pic
//INFO : UNC     : <factory_location>\Application\rsrc\noIcon.pic

See Also

Scene.GetExternalFile Model.ExternalFiles FileReference FileReferenceCollection CopyExtFilesIntoProject