Scripting: CreateImageClip2

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