Microsoft DirectX 8.0

IAMTimelineTransable Object

Adds transitions to an object in Microsoft® DirectShow® Editing Services (DES). Applies to objects that can have transitions applied to them, such as tracks, compositions, and groups. An object that supports transitions can have any number of transitions, but the transitions must not overlap in time.

Note  Audio does not support transitions.

Methods

GetNextTransNot supported for Visual Basic.
GetNextTrans2Retrieves the first transition that appears at the specified time or later.
GetTransAtTimeNot supported for Visual Basic.
GetTransAtTime2Retrieves the transition nearest to the specified time, according to specified boundary conditions.
TransAddAdds a transition to the object.
TransGetCountRetrieves the number of transitions on this object.

GetNextTrans Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Not supported for Visual Basic.

Syntax

object.GetNextTrans(
    ppTrans As AMTimelineObj,
    pInOut As <Unsupported variant type>
)

GetNextTrans2 Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Retrieves the first transition that appears at the specified time or later.

Syntax

object.GetNextTrans2(
    ppTrans As IAMTimelineObj,
    pInOut As Double
)

Parts

object
Object expression that evaluates to an IAMTimelineTransable object.
ppTrans
The AMTimelineObj object that receives the transition.
pInOut
On input, this parameter specifies the time from which to find the transition. On output, if a transition is retrieved, this parameter is set to the stop time of the transition.

Error Codes

If the method fails, an error is raised.

Remarks

The start time of the transition might be less than the time that you specify in pInOut, if the transition spans the specified time.

GetTransAtTime Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Not supported for Visual Basic.

Syntax

object.GetTransAtTime(
    ppObj As AMTimelineObj, 
    Time As <Unsupported variant type>, 
    SearchDirection As Long
)

GetTransAtTime2 Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Retrieves the transition nearest to the specified time, according to specified boundary conditions.

Syntax

object.GetTransAtTime2(
    ppObj As AMTimelineObj, 
    Time As Double, 
    SearchDirection As Long
)

Parts

object
Object expression that evaluates to an IAMTimelineTransable object.
ppObj
The IAMTimelineObj object that receives the transition.
Time
Time from which to begin the search, in seconds.
SearchDirection
Member of the DEXTERF_TRACK_SEARCH_FLAGS enumerated type that specifies the boundary conditions for the search.

Error Codes

If the method fails, an error is raised, and Err.Number is set to the following value:

E_INVALIDARGInvalid argument.

TransAdd Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Adds a transition to the object. An object can have multiple transitions, but they must not overlap in time. Transitions must fall within the time boundaries of the object.

Syntax

object.TransAdd(
    pTrans As AMTimelineObj
)

Parts

object
Object expression that evaluates to an IAMTimelineTransable object.
pTrans
The AMTimelineObj object that specifies the transition to add.

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

E_INVALIDARGCannot insert the transition.
E_NOINTERFACEpTrans is not a transition.

Remarks

If the transition overlaps an existing transition, the method raises an E_INVALIDARG error.

TransGetCount Method (IAMTimelineTransable Object)

IAMTimelineTransable Object

Retrieves the number of transitions on this object.

Syntax

object.TransGetCount(
    pCount As Long
)

Parts

object
Object expression that evaluates to an IAMTimelineTransable object.
pCount
Variable that receives the number of transitions.

Error Codes

If the method fails, an error is raised.