Microsoft DirectX 8.0 |
Microsoft® DirectShow 編集サービス (DES) のトラック を操作するメソッドを提供する。
トラックには、最終出力でレンダリングされるソースのリストが入る。同じトラック内のソースは、オーバーラップできない。ビデオ トラックは、エフェクトとトランジションの両方を持つことができる。レンダリング エンジンは、トランジションを適用する前にエフェクトを適用する。オーディオ トラックは、エフェクトを持つことはできるが、トランジションを持つことはできない。
詳細については、「タイムライン モデル」を参照すること。
メソッド
AreYouBlank トラックが空白 (ソース オブジェクトが入っていない) かどうかを調べる。 GetNextSrc Visual Basic ではサポートされていない。 GetNextSrc2 トラックで、指定された時間以降に出現する次のソースを検索する。 GetNextSrcEx 指定されたソースに続く次のソースを取得する。 GetSourcesCount トラック内のソースの個数を取得する。 GetSrcAtTime Visual Basic ではサポートされていない。 GetSrcAtTime2 指定された境界条件に従って、指定された時間に最も近いソース オブジェクトを取得する。 InsertSpace Visual Basic ではサポートされていない。 InsertSpace2 指定された時間に存在するすべてのオブジェクトを分割し、その間にスペースを挿入する。 MoveEverythingBy Visual Basic ではサポートされていない。 MoveEverythingBy2 トラックのオブジェクトのうち指定された時間に開始するものをすべて、タイムラインに沿って指定された距離だけ移動する。 SrcAdd トラックにソースを追加する。 ZeroBetween Visual Basic ではサポートされていない。 ZeroBetween2 トラックから、指定された時間の間にあるものをすべて削除する。
トラックが空白 (ソース オブジェクトが入っていない) かどうかを調べる。
構文
object.AreYouBlank( pVal As Long )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- pVal
- トラックがブランクかどうかを指定する値を受け取る変数。ゼロ以外の場合は、オブジェクトは空白であり、ソース オブジェクトは入っていない。ゼロの場合は、トラックは空白ではない。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
Visual Basic ではサポートされていない。
構文
object.GetNextSrc( ppSrc AMTimelineObj, pInOut As <Unsupported variant type> )
トラックで、指定された時間以降に出現する次のソースを検索する。
構文
object.GetNextSrc2( ppSrc As AMTimelineObj, pInOut As Double )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- ppSrc
- ソース オブジェクトを受け取る AMTimelineObj オブジェクト。
- pInOut
- 検索を開始する時間 (秒単位)。ソースが取得された場合、この変数にはそのソースの終了タイムが設定される。ソースが取得されなかった場合、この値は無効になるので、アプリケーションで使用してはならない。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
注意
pInOut で指定された値がソースの開始タイムと終了タイムの間にある場合、メソッドはそのソースを取得する。
指定されたソースに続く次のソースを取得する。
構文
object.GetNextSrcEx( pLast As AMTimelineObj, ppNext As AMTimelineObj )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- pLast
- 前の AMTimelineObj オブジェクト。 トラック内の最初のソースを取得する場合は Nothing。
- ppNext
- 次のソースを受け取る AMTimelineObj オブジェクト。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
トラック内のソースの個数を取得する。
構文
object.GetSourcesCount( pVal As Long )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- pVal
- トラック内のソースの個数を受け取る変数。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
Visual Basic ではサポートされていない。
構文
object.GetSrcAtTime( ppSrc As AMTimelineObj, Time As <Unsupported variant type>, SearchDirection As Long )
指定された境界条件に従って、指定された時間に最も近いソース オブジェクトを取得する。
構文
object.GetSrcAtTime2( ppSrc As AMTimelineObj, Time As Double, SearchDirection As Long )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- ppSrc
- ソースを受け取る AMTimelineObj オブジェクト。
- Time
- 検索を開始する時間 (秒単位)。
- SearchDirection
- DEXTERF_TRACK_SEARCH_FLAGS 列挙型のメンバ。 検索の境界条件を指定する。
エラー コード
メソッドでの処理が失敗するとエラーが発生し、Err.Number には次の値が設定される場合がある。
E_INVALIDARG 無効な引数。
Visual Basic ではサポートされていない。
構文
object.InsertSpace( rtStart As <Unsupported variant type>, rtEnd As <Unsupported variant type> )
指定された時間に存在するすべてのオブジェクトを分割し、その間にスペースを挿入する。
構文
object.InsertSpace2( rtStart As Double, rtEnd As Double )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- rtStart
- 分割を行う時間、また挿入されるスペースの始点 (秒単位)。
- rtEnd
- 挿入されるスペースの終点 (秒単位)。
エラー コード
メソッドでの処理が失敗するとエラーが発生し、Err.Number には次の値が設定される場合がある。
E_INVALIDARG 無効な引数。
Visual Basic ではサポートされていない。
構文
object.MoveEverythingBy( Start As <Unsupported variant type>, MoveBy As <Unsupported variant type> )
トラックのオブジェクトのうち指定された時間に開始するものをすべて、タイムラインに沿って指定された距離だけ移動する。
構文
object.MoveEverythingBy2( Start As Double, MoveBy As Double )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- Start
- 移動の開始タイム (秒単位)。この時間以降に開始するオブジェクトだけが移動される。
- MoveBy
- タイムライン上でオブジェクトを移動する時間の量 (秒単位)。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。
トラックにソースを追加する。
構文
object.SrcAdd( pSrc As AMTimelineObj )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- pSrc
- 追加する AMTimelineObj オブジェクト。
エラー コード
メソッドでの処理が失敗するとエラーが発生し、Err.Number には次の値が設定される場合がある。
E_NOINTERFACE pSrc で指定されているオブジェクトが、ソース オブジェクトではない。
注意
このメソッドを呼び出す前に、ソースの開始タイムと終了タイムを設定する必要がある (AMTimelineObj.SetStartStop メソッドを呼び出す)。
現在 DES は、ビデオ圧縮マネージャ (VCM) CODECで圧縮されたソースは、同時に 75 個までしかレンダリングできない。また、そのようなソースがプロジェクト全体で 75 個を超える場合は、動的な再接続を使わなければ、DES はプロジェクトをプレビューできない。詳細については、「RenderEngine.SetDynamicReconnectLevel」を参照すること。
Visual Basic ではサポートされていない。
構文
object.ZeroBetween( rtStart As <Unsupported variant type>, rtEnd As <Unsupported variant type> )
トラックから、指定された時間の間にあるものをすべて削除する。このメソッドは、指定された時間範囲にかかっているすべてのオブジェクトを分割し、その範囲内にある部分を削除する。
構文
object.ZeroBetween2( rtStart As Double, rtEnd As Double )
パラメータ
- object
- 結果が AMTimelineTrack オブジェクトになるオブジェクト式。
- rtStart
- クリアする範囲の始点 (秒単位)。
- rtEnd
- クリアする範囲の終点 (秒単位)。
エラー コード
メソッドでの処理が失敗すると、エラーが発生する。