v1.5

Creates a new folder. Folders can be used to organize your scene data. They can be created under other folders or items that support folders like the Clips and Sources (under the Project). Folders can also be created under the Animation Mixer in order to organize your clips.

Note: This command uses output arguments. C# and some scripting languages (such as JScript, PerlScript and Python) don't support arguments passed by reference so you need to use the best workaround for your situation:

For scripting languages this command returns an ISIVTCollection which you can use to get the output arguments.

For C# you can use the XSIApplication.ExecuteCommand method to call this command. ExecuteCommand packs the output arguments into a C# System.Object containing an Array of the output arguments (see Calling Commands from C#).

VBScript Example

' 
' This example moves all .jpg image clips 
' under a new folder called JPEG
'
' create an image clip
Dim clipFile
clipFile = Application.InstallationPath( siFactoryPath ) _
        & "\Data\XSI_SAMPLES\Pictures\bottom_teeth.jpg"
CreateImageClip clipFile
' Create a folder named JPEG
CreateFolder "Clips", "JPEG"
' Move all jpeg clips under the JPEG folder
MoveToFolder "Clips.JPEG", "Clips." & "*_jpg"

MoveToFolder RemoveFolder RemoveFromFolder