Microsoft DirectX 8.0 |
Provides methods for manipulating tracks in Microsoft® DirectShow® Editing Services (DES).
A track contains a list of sources that are rendered in the final output. Sources within the same track may not overlap. Video tracks can have both effects and transitions. The render engine applies effects before it applies transitions. Audio tracks can have effects, but not transitions.
For more information, see The Timeline Model.
Methods
AreYouBlank Determines whether the track is blank (contains no source objects). GetNextSrc Not supported for Visual Basic. GetNextSrc2 Searches the track for the next source that appears at the specified time or later. GetNextSrcEx Retrieves the next source after the specified source. GetSourcesCount Retrieves the number of sources in the track. GetSrcAtTime Not supported for Visual Basic. GetSrcAtTime2 Retrieves the source object nearest to the specified time, according to specified boundary conditions. InsertSpace Not supported in Visual Basic. InsertSpace2 Splits any objects that exist at the specified time and inserts space between them. MoveEverythingBy Not supported for Visual Basic. MoveEverythingBy2 Moves all objects in the track, starting at a specified time, by a specified distance along the timeline. SrcAdd Adds a source to the track. ZeroBetween Not supported for Visual Basic. ZeroBetween2 Removes everything from the track between the specified times.
Determines whether the track is blank (contains no source objects).
Syntax
object.AreYouBlank( pVal As Long )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- pVal
- Variable that receives a value specifying whether the track is blank. If non-zero, the track is blank and contains no source objects. If zero, the track is not blank.
Error Codes
If the method fails, an error is raised.
Not supported for Visual Basic.
Syntax
object.GetNextSrc( ppSrc AMTimelineObj, pInOut As <Unsupported variant type> )
Searches the track for the next source that appears at the specified time or later.
Syntax
object.GetNextSrc2( ppSrc As AMTimelineObj, pInOut As Double )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- ppSrc
- The AMTimelineObj object that receives the source object.
- pInOut
- Start time for the search, in seconds. If the method retrieves a source, it sets this variable to the stop time of the source. If the method does not retrieve a source, the value becomes invalid and the application should not use it.
Error Codes
If the method fails, an error is raised.
Remarks
If the time specified by pInOut falls between the start and stop times of a source, the method retrieves that source.
Retrieves the next source after the specified source.
Syntax
object.GetNextSrcEx( pLast As AMTimelineObj, ppNext As AMTimelineObj )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- pLast
- The previous AMTimelineObj object, or Nothing to retrieve the first source in the track.
- ppNext
- The AMTimelineObj object that receives the next source.
Error Codes
If the method fails, an error is raised.
Retrieves the number of sources in the track.
Syntax
object.GetSourcesCount( pVal As Long )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- pVal
- Variable that receives the number of sources in the track.
Error Codes
If the method fails, an error is raised.
Not supported for Visual Basic.
Syntax
object.GetSrcAtTime( ppSrc As AMTimelineObj, Time As <Unsupported variant type>, SearchDirection As Long )
Retrieves the source object nearest to the specified time, according to the specified boundary conditions.
Syntax
object.GetSrcAtTime2( ppSrc As AMTimelineObj, Time As Double, SearchDirection As Long )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- ppSrc
- The AMTimelineObj object that receives the source.
- Time
- Start time for 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 can be set to the following value:
E_INVALIDARG Invalid argument.
Not supported in Visual Basic.
Syntax
object.InsertSpace( rtStart As <Unsupported variant type>, rtEnd As <Unsupported variant type> )
Splits any objects that exist at the specified time and inserts space between them.
Syntax
object.InsertSpace2( rtStart As Double, rtEnd As Double )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- rtStart
- Time at which to create the split, and the starting point of the inserted space, in seconds.
- rtEnd
- End point of the inserted space, in seconds.
Error Codes
If the method fails, an error is raised, and Err.Number can be set to the following value:
E_INVALIDARG Invalid argument.
Not supported for Visual Basic.
Syntax
object.MoveEverythingBy( Start As <Unsupported variant type>, MoveBy As <Unsupported variant type> )
Moves all objects in the track, starting at a specified time, by a specified distance along the timeline.
Syntax
object.MoveEverythingBy2( Start As Double, MoveBy As Double )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- Start
- Starting time of the move, in seconds. Only objects that begin at this time or later are moved.
- MoveBy
- Amount of time along the timeline to move the objects, in seconds.
Error Codes
If the method fails, an error is raised.
Adds a source to the track.
Syntax
object.SrcAdd( pSrc As AMTimelineObj )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- pSrc
- The AMTimelineObj object to add.
Error Codes
If the method fails, an error is raised, and Err.Number can be set to the following value:
E_NOINTERFACE The object specified by pSrc is not a source object.
Remarks
Set the source's start and stop times before calling this method. (Call the AMTimelineObj.SetStartStop method.)
Currently, DES cannot simultaneously render more than 75 sources that were compressed with Video Compression Manager (VCM) codecs. Also, if the project as a whole contains more than 75 such sources, you must use dynamic reconnection or DES cannot preview the project. For more information, see RenderEngine.SetDynamicReconnectLevel.
Not supported for Visual Basic.
Syntax
object.ZeroBetween( rtStart As <Unsupported variant type>, rtEnd As <Unsupported variant type> )
Removes everything from the track between the specified times. This method splits any objects that span the specified time range and removes the pieces that fall within the range.
Syntax
object.ZeroBetween2( rtStart As Double, rtEnd As Double )
Parts
- object
- Object expression that evaluates to an AMTimelineTrack object.
- rtStart
- Beginning of the range to clear, in seconds.
- rtEnd
- End of the range to clear, in seconds.
Error Codes
If the method fails, an error is raised.