Microsoft DirectX 8.0

AMTimelineTrans Object

Provides methods for manipulating transitions in Microsoft® DirectShow® Editing Services (DES).

A transition is a progression between one layer and the rendered composite of all the layers with a lower priority. The AMTimelineTrans object is a wrapper for any two-input Microsoft® DirectX® Transform object. To specify the DirectX Transform object, call the AMTimelineObj.SetSubObjectGUID method.

Timeline objects that can have transitions support the IAMTimelineTransable object.

Methods

GetCutPointNot supported for Visual Basic.
GetCutPoint2Retrieves the cut point.
GetCutsOnlyDetermines whether the transition is rendered as a cut.
GetSwapInputsDetermines whether the transition inputs are swapped.
SetCutPointNot supported for Visual Basic.
SetCutPoint2Sets the cut point.
SetCutsOnlySpecifies whether the transition is rendered as a cut.
SetSwapInputsSpecifies whether the transition inputs are swapped.

GetCutPoint Method (AMTimelineTrans Object)

AMTimelineTrans Object

Not supported for Visual Basic.

Syntax

object.GetCutPoint(
    pTLTime As <Unsupported variant type>
)

GetCutPoint2 Method (AMTimelineTrans Object)

AMTimelineTrans Object

Retrieves the cut point. If you render a transition as a cut, the cut point is the time when the transition cuts from one source to the next. By default, this value is the middle of the transition. For example, in a transition that spans two seconds, the default cut point is one second into the transition.

Syntax

object.GetCutPoint2(
    pTLTime As Double
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
pTLTime
Variable that receives the cut point, relative to the start time of the transition, in seconds.

Error Codes

If the method fails, an error is raised.

See Also

SetCutPoint2, GetCutsOnly, AMTimeline.TransitionsEnabled

GetCutsOnly Method (AMTimelineTrans Object)

AMTimelineTrans Object

Determines whether the transition is rendered as a cut. If so, the transition occurs instantaneously at the cut point.

Syntax

object.GetCutsOnly(
    pVal As Long
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
pVal
Variable that receives a value indicating whether the transition is rendered as a cut. If non-zero, the transition is an instantaneous cut. If zero, the transition occurs over its normal duration.

Error Codes

If the method fails, an error is raised.

See Also

SetCutsOnly, GetCutPoint, AMTimeline.TransitionsEnabled

GetSwapInputs Method (AMTimelineTrans Object)

AMTimelineTrans Object

Determines whether the transition inputs are swapped.

By default, a transition goes from the composite of all lower-priority layers to the layer where the transition resides. You can reverse this progression, so the transition goes from the layer where it resides back to the composite of lower-priority layers.

Syntax

object.GetSwapInputs(
    pVal As Long
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
pVal
Variable that receives a value indicating whether inputs are swapped. If the value is zero, the transition goes from the composite of all lower-priority layers to the transition layer. If the value is non-zero, the transition goes in the opposite direction. The default value is zero.

Error Codes

If the method fails, an error is raised.

SetCutPoint Method (AMTimelineTrans Object)

AMTimelineTrans Object

Not supported for Visual Basic.

Syntax

object.SetCutPoint(
    TLTime As <Unsupported variant type>
)

SetCutPoint2 Method (AMTimelineTrans Object)

AMTimelineTrans Object

Sets the cut point. If you render a transition as a cut, the cut point is the time when the transition cuts from one source to the next. By default, the cut point is the middle of the transition. For example, in a transition that spans two seconds, the default cut point is one second into the transition.

Syntax

object.SetCutPoint2(
    TLTime As Double
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
TLTime
Cut point relative to the start of the transition, in seconds.

Error Codes

If the method fails, an error is raised.

SetCutsOnly Method (AMTimelineTrans Object)

AMTimelineTrans Object

Specifies whether the transition is rendered as a cut. If so, the transition occurs instantly at the cut point. If a transition takes a long time to render, you might want to preview it as a cut to speed preview.

Syntax

object.SetCutsOnly(
    Val As Long
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
Val
Value that specifies whether to render the transition as a cut. If zero, the transition is rendered as an instantaneous cut. If non-zero, the transition renders over its normal duration.

Error Codes

If the method fails, an error is raised.

SetSwapInputs Method (AMTimelineTrans Object)

AMTimelineTrans Object

Specifies whether the transition inputs are swapped.

By default, a transition goes from the composite of all lower-priority layers to the layer where the transition resides. You can reverse this progression, so the transition goes from the layer where it resides back to the composite of lower-priority layers.

Syntax

object.SetSwapInputs(
    Val As Long
)

Parts

object
Object expression that evaluates to an AMTimelineTrans object.
Val
Value that specifies whether the inputs are swapped. If zero, the transition goes from the composite of all lower-priority layers to the transition layer. If non-zero, the transition goes in the opposite direction.

Error Codes

If the method fails, an error is raised.

Remarks

This method does not change the direction of the visual effect. For example, a left-to-right wipe will still go from left to right.