| Microsoft DirectX 8.0 |
Provides methods for manipulating transitions in Microsoft® DirectShow® Editing Services (DES).
A transition is a progression between one layer and the rendered composite of all the layers with a lower priority. The AMTimelineTrans object is a wrapper for any two-input Microsoft® DirectX® Transform object. To specify the DirectX Transform object, call the AMTimelineObj.SetSubObjectGUID method.
Timeline objects that can have transitions support the IAMTimelineTransable object.
Methods
GetCutPoint Not supported for Visual Basic. GetCutPoint2 Retrieves the cut point. GetCutsOnly Determines whether the transition is rendered as a cut. GetSwapInputs Determines whether the transition inputs are swapped. SetCutPoint Not supported for Visual Basic. SetCutPoint2 Sets the cut point. SetCutsOnly Specifies whether the transition is rendered as a cut. SetSwapInputs Specifies whether the transition inputs are swapped.
Not supported for Visual Basic.
Syntax
object.GetCutPoint(
pTLTime As <Unsupported variant type>
)
Retrieves the cut point. If you render a transition as a cut, the cut point is the time when the transition cuts from one source to the next. By default, this value is the middle of the transition. For example, in a transition that spans two seconds, the default cut point is one second into the transition.
Syntax
object.GetCutPoint2(
pTLTime As Double
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- pTLTime
- Variable that receives the cut point, relative to the start time of the transition, in seconds.
Error Codes
If the method fails, an error is raised.
See Also
Determines whether the transition is rendered as a cut. If so, the transition occurs instantaneously at the cut point.
Syntax
object.GetCutsOnly(
pVal As Long
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- pVal
- Variable that receives a value indicating whether the transition is rendered as a cut. If non-zero, the transition is an instantaneous cut. If zero, the transition occurs over its normal duration.
Error Codes
If the method fails, an error is raised.
See Also
Determines whether the transition inputs are swapped.
By default, a transition goes from the composite of all lower-priority layers to the layer where the transition resides. You can reverse this progression, so the transition goes from the layer where it resides back to the composite of lower-priority layers.
Syntax
object.GetSwapInputs(
pVal As Long
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- pVal
- Variable that receives a value indicating whether inputs are swapped. If the value is zero, the transition goes from the composite of all lower-priority layers to the transition layer. If the value is non-zero, the transition goes in the opposite direction. The default value is zero.
Error Codes
If the method fails, an error is raised.
Not supported for Visual Basic.
Syntax
object.SetCutPoint(
TLTime As <Unsupported variant type>
)
Sets the cut point. If you render a transition as a cut, the cut point is the time when the transition cuts from one source to the next. By default, the cut point is the middle of the transition. For example, in a transition that spans two seconds, the default cut point is one second into the transition.
Syntax
object.SetCutPoint2(
TLTime As Double
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- TLTime
- Cut point relative to the start of the transition, in seconds.
Error Codes
If the method fails, an error is raised.
Specifies whether the transition is rendered as a cut. If so, the transition occurs instantly at the cut point. If a transition takes a long time to render, you might want to preview it as a cut to speed preview.
Syntax
object.SetCutsOnly(
Val As Long
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- Val
- Value that specifies whether to render the transition as a cut. If zero, the transition is rendered as an instantaneous cut. If non-zero, the transition renders over its normal duration.
Error Codes
If the method fails, an error is raised.
Specifies whether the transition inputs are swapped.
By default, a transition goes from the composite of all lower-priority layers to the layer where the transition resides. You can reverse this progression, so the transition goes from the layer where it resides back to the composite of lower-priority layers.
Syntax
object.SetSwapInputs(
Val As Long
)
Parts
- object
- Object expression that evaluates to an AMTimelineTrans object.
- Val
- Value that specifies whether the inputs are swapped. If zero, the transition goes from the composite of all lower-priority layers to the transition layer. If non-zero, the transition goes in the opposite direction.
Error Codes
If the method fails, an error is raised.
Remarks
This method does not change the direction of the visual effect. For example, a left-to-right wipe will still go from left to right.