Deprecated
6.0
Description
As of v6.0, model clips are no longer used to track changes to reference models. Use the Delta system instead.
Creates a model clip using the filename containing the model source. Model clips are used to coordinate the use of different models under different resolutions. Model clips also allow the user to specify which modifications to the model are applied when a referenced model is loaded, as well as give the option to run a script after loading. This command is similar to the SICreateModelClip command, except that
This command can be reproduced by selecting Model->Create - Model->New Model Source. In the Model Source dialog, enter the filenames for the desired resolutions, and set the active resolution to a resolution that has a corresponding model file.
Scripting Syntax
CreateModelClip( [FileName], [Name] )
Parameters
|
Parameter |
Type |
Description |
|
FileName [in/out] |
Full path of the Model source. Default Value: Filename argument handler will pop up if nothing specified. |
|
|
Name |
The name to use for the new clip. Default Value: If no name is supplied, then a default value will be used. |
Return Value
Returns the new clip (a ProjectItem object) wrapped in an ISIVTCollection
Examples
VBScript Example
'--------------------------------------------------------- ' VBScript Example : Creating a model clip. '--------------------------------------------------------- ' Get the filename of a sample model. ManFile = Application.InstallationPath(siFactoryPath) ManFile = ManFile & "\Data\XSI_SAMPLES\Models\Man.emdl" ' Create a clip from the model file, using a name specified CreateModelClip ManFile, "ManModelClip" ' Create a clip from the model file, using the default name (Referenced_Man) CreateModelClip ManFile '--------------------------------------------------------- ' Output from the above script: 'INFO : "4152 - Data loaded from file <InstallationDir>\Data\XSI_SAMPLES\Models\Man.emdl was created with build number: <build> - compatibility version: 200" 'INFO : "4031 - Path Pictures\Char_UV_Texture.gif has been changed to <InstallationDir>\Data\XSI_SAMPLES\Pictures\Char_UV_Texture.gif" 'INFO : "4152 - Data loaded from file <InstallationDir>\Data\XSI_SAMPLES\Models\Man.emdl was created with build number: <build> - compatibility version: 200" 'INFO : "4031 - Path Pictures\Char_UV_Texture.gif has been changed to <InstallationDir>\Data\XSI_SAMPLES\Pictures\Char_UV_Texture.gif" ' Object: ManModelClip.ManModelClip.ManModelClip ' Object: Referenced_Man.ModelClip_Man.ModelSource_Man '---------------------------------------------------------
See Also
SOFTIMAGE|XSI v6.01