Microsoft DirectX 8.0 |
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
GetNextTrans Not supported for Visual Basic. GetNextTrans2 Retrieves the first transition that appears at the specified time or later. GetTransAtTime Not supported for Visual Basic. GetTransAtTime2 Retrieves the transition nearest to the specified time, according to specified boundary conditions. TransAdd Adds a transition to the object. TransGetCount Retrieves the number of transitions on this object.
Not supported for Visual Basic.
Syntax
object.GetNextTrans( ppTrans As AMTimelineObj, pInOut As <Unsupported variant type> )
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.
Not supported for Visual Basic.
Syntax
object.GetTransAtTime( ppObj As AMTimelineObj, Time As <Unsupported variant type>, SearchDirection As Long )
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_INVALIDARG Invalid argument.
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_INVALIDARG Cannot insert the transition. E_NOINTERFACE pTrans is not a transition.
Remarks
If the transition overlaps an existing transition, the method raises an E_INVALIDARG error.
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.