## Scene.GetExternalFile

### Introduced

v5.0

### Description

Returns a FileReference object which corresponds to the specified GUID.
Note: Only source files are in the external file list (for example, graphics files, audio files, referenced model files, etc.).

### C# Syntax

    FileReference Scene.GetExternalFile( String in_Guid );

### Scripting Syntax

    oReturn = Scene.GetExternalFile();

### Return Value

FileReference

### Examples

#### JScript Example

    /*

    	This JScript example demonstrates how to get the external file matching the specified GUID

    */

    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 );

    // Get the GUID of the first file related to the current (active) scene

    var oFilePath = Application.ActiveProject.ActiveScene.ExternalFiles(0);

    printFileInfo( oFilePath );

    var sGuid = oFilePath.GUID;

    // Use that GUID to get the same object

    var oFilePath2 = Application.ActiveProject.ActiveScene.GetExternalFile( sGuid );

    // The 2 filespaths are the same!

    printFileInfo( oFilePath2 );

    // Expected result (your GUIDs will be different from the ones below, of course):

    //INFO : FileType: Pictures

    //INFO : FileExists: 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

    //INFO : GUID    : {C3416DDC-F75C-421F-9415-CD689DE8DF37}

    //INFO : FileType: Pictures

    //INFO : FileExists: 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

    //INFO : GUID    : {C3416DDC-F75C-421F-9415-CD689DE8DF37}

    // Helper function to print info about the specified FileReference object

    function printFileInfo( in_file ) {

    	// Verifying that this is a good object

    	LogMessage( "FileType: " + in_file.FileType );

    	LogMessage( "FileExists: " + 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;

    	// Get the GUID

    	var s_GUID = o_path.GUID;

    	// Print all results

    	LogMessage( "ORIGINAL: " + o_path );

    	LogMessage( "RESOLVED: " + r_path );

    	LogMessage( "UNC     : " + u_path );

    	LogMessage( "GUID    : " + s_GUID );

    }

### See Also

Model.ExternalFiles Scene.ExternalFiles FileReference.GUID FileReference FileReferenceCollection CopyExtFilesIntoProject