CreateImageClip2

Introduced

v4.0

Description

Creates and adds a new image source and a new image clip, the new clip pointing to the new source and inspect the new clip. If the file texture is a media file such as an Advanced Authoring Format (AAF) composition that contains multiple tracks, one shared image source will be created for the composition file itself, and one individual Image Clip objects will created for each track it contains. For all other file formats (including layered PhotoShop files), a single image clip will be created and returned.

Scripting Syntax

oReturn = CreateImageClip2( [FileName], [Name] );

Return Value

Returns an XSICollection that contains the list of newly created Image Clips.

Parameters

Parameter Type Description
FileName String Full path of the image source.

Default Value: Filename argument handler will pop up if nothing specified.

Name String The name to use for the new clip.

Default Value: If no name is supplied, then a default value will be used.

Examples

VBScript Example

set NewClips = CreateImageClip2("c:\windows\clock.avi" )

if IsEmpty( NewClips ) then

	logmessage "Failed To Create Image Clips"

else

	logmessage NewClips

End If

See Also

AddImageClip AddImageSource SIAddImageSource CreateImageBasedLightingPass