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#).

CreateFolder( Target, [Name], [Folder] );

Parameter	Type	Description
Target	String	Name of the folder under which the new folder will be created.
Name	String	Name for the new folder. A suffix is appended to the name if there's already such a folder at the given location.
Folder	CollectionItem	The newly created folder. Not Implemented.

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