Microsoft DirectX 8.0

AMTimelineTrack Object

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

AreYouBlankDetermines whether the track is blank (contains no source objects).
GetNextSrcNot supported for Visual Basic.
GetNextSrc2Searches the track for the next source that appears at the specified time or later.
GetNextSrcExRetrieves the next source after the specified source.
GetSourcesCountRetrieves the number of sources in the track.
GetSrcAtTimeNot supported for Visual Basic.
GetSrcAtTime2Retrieves the source object nearest to the specified time, according to specified boundary conditions.
InsertSpaceNot supported in Visual Basic.
InsertSpace2Splits any objects that exist at the specified time and inserts space between them.
MoveEverythingByNot supported for Visual Basic.
MoveEverythingBy2Moves all objects in the track, starting at a specified time, by a specified distance along the timeline.
SrcAddAdds a source to the track.
ZeroBetweenNot supported for Visual Basic.
ZeroBetween2Removes everything from the track between the specified times.

AreYouBlank Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.

GetNextSrc Method (AMTimelineTrack Object)

AMTimelineTrack Object

Not supported for Visual Basic.

Syntax

object.GetNextSrc(
    ppSrc AMTimelineObj,
    pInOut As <Unsupported variant type>
)

GetNextSrc2 Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.

GetNextSrcEx Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.

GetSourcesCount Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.

GetSrcAtTime Method (AMTimelineTrack Object)

AMTimelineTrack Object

Not supported for Visual Basic.

Syntax

object.GetSrcAtTime(
    ppSrc As AMTimelineObj,
    Time As <Unsupported variant type>,
    SearchDirection As Long
)

GetSrcAtTime2 Method (AMTimelineTrack Object)

AMTimelineTrack Object

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_INVALIDARGInvalid argument.

InsertSpace Method (AMTimelineTrack Object)

AMTimelineTrack Object

Not supported in Visual Basic.

Syntax

object.InsertSpace(
    rtStart As <Unsupported variant type>,
    rtEnd As <Unsupported variant type>
)

InsertSpace2 Method (AMTimelineTrack Object)

AMTimelineTrack Object

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_INVALIDARGInvalid argument.

MoveEverythingBy Method (AMTimelineTrack Object)

AMTimelineTrack Object

Not supported for Visual Basic.

Syntax

object.MoveEverythingBy(
    Start As <Unsupported variant type>,
    MoveBy As <Unsupported variant type>
)

MoveEverythingBy2 Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.

SrcAdd Method (AMTimelineTrack Object)

AMTimelineTrack Object

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_NOINTERFACEThe 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.

ZeroBetween Method (AMTimelineTrack Object)

AMTimelineTrack Object

Not supported for Visual Basic.

Syntax

object.ZeroBetween(
    rtStart As <Unsupported variant type>,
    rtEnd As <Unsupported variant type>
)

ZeroBetween2 Method (AMTimelineTrack Object)

AMTimelineTrack Object

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.