/* 

	This example shows how to get the resolved path

	on each member of the external files list and how to 

	change the path on the fly.

	Note: To see the UNC path in action, change the location 

	of the NewFile variable to a valid UNC path 

	(for example, "\\\\mymachine\\toto\\Man_Face.emdl") that is 

	mapped to a drive letter (such as Q:) and rerun the example.

*/

NewScene( null, false );

// ---------------------------------------------------------------------------

// 	Setup

//

// First import a model so we have some external files to find

var FPath = XSIUtils.BuildPath(

	Application.InstallationPath( siFactoryPath ),

	"Data", "XSI_SAMPLES", "Models", "Man_Face.emdl"

);

var oISIVTColl = ImportModel( FPath, null, true );

// Now copy the reference-model file to a local directory

var NewFile = "C:\\temp\\Man_Face.emdl";

var fso = new ActiveXObject( "Scripting.FileSystemObject" );

fso.CopyFile( FPath, NewFile, true );

// ---------------------------------------------------------------------------

// 	Using the FileReference Object

//

// Get the collection of all external files on the scene

var oModel = oISIVTColl.Value("Value");

var l_extFileList = oModel.ExternalFiles;

// Loop through the list and change only the 

// referenced model file to point to the one we put in c:\temp

for ( var i=0; i<l_extFileList.Count; i++ ) {

	// Get the FileReference object and print the path

	printFileInfo( l_extFileList(i) );

	// Change the path to point to the temp directory

	if ( l_extFileList(i).FileType == "Models" ) {

		// Make sure the original path exists, change it to 

		// the new one, and print the new path for confirmation

		if ( l_extFileList(i).FileExists() ) {

			var OldPath = l_extFileList(i).Path;

			Application.LogMessage( "ORIGINAL PATH: " + OldPath );

			l_extFileList(i).Path = NewFile;

			Application.LogMessage( "MODIFIED PATH: " + l_extFileList(i).Path );

			// Restore original name

			l_extFileList(i).Path = OldPath;

		}

	}

}

// ---------------------------------------------------------------------------

// 	Convenience function

//

function printFileInfo( in_file ) {

	try {

		Application.LogMessage( Application.ClassName(in_file) );

	} catch(e) {

		if ( typeof(in_file).toLowerCase() == "object" ) {

			Application.LogMessage( in_file.FileType );

		} else {

			Application.LogMessage( typeof(in_file) );

		}

	}

	if ( 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

		Application.LogMessage( "ORIGINAL: " + o_path );

		Application.LogMessage( "RESOLVED: " + r_path ); 

		Application.LogMessage( "UNC     : " + u_path );

	} else {

		Application.LogMessage( "Skipping non-existent file" );

	}

}

// ---------------------------------------------------------------------------

// 	OUTPUT

//

// INFO : FileReference

// INFO : ORIGINAL: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl

// INFO : RESOLVED: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl

// INFO : UNC     : <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl

// INFO : ORIGINAL PATH: <factory_path>\Data\XSI_SAMPLES\Models\Man_Face.emdl

// INFO : MODIFIED PATH: C:\temp\Man_Face.emdl

// INFO : FileReference

// INFO : Skipping non-existent file