ClipContainer.AddRelation

Introduced

v4.0

Description

Adds a relation between two clip objects' TimeControls. The relation is by default between the StartOffset, ClipIn and ClipOut values of the master and slave clip.

Please take note that this method will fail if the addition of a new relation would create an evaluation cycle. For instance, let say that you have three clips A, B and C. If you already have ClipRelations between A-B and between B-C then attempting to add a ClipRelation between C-A will fail.

Scripting Syntax

oReturn = ClipContainer.AddRelation( MasterClip, SlaveClip, [Name] );

Return Value

The newly created ClipRelation object.

Parameters

Parameter	Type	Description
MasterClip	Clip	The master clip object.
SlaveClip	Clip	The slave clip object.
Name	String	The name of the new clip relation

Examples

JScript Example

/*
See the example for the ClipContainer.NestedRelations property.
*/