IDXEffect interface

This interface generically controls transition settings on all transform objects.

Members

The IDXEffect interface inherits from the IDispatch interface. IDXEffect also has these types of members:

  • Properties

Properties

The IDXEffect interface has these properties.

Property Description

Capabilities

Retrieves a value that indicates specific capabilities of a transition.

Duration

Retrieves the recommended length of time for performing a transition. Sets the suggested duration for the transition.

Progress

Retrieves the setting of the transform's IDXEffect::Progress property. Sets the requested progress made on the transform.

StepResolution

Retrieves the step size that corresponds to the smallest meaningful change for the IDXEffect::Progress property.

 

Remarks

Transitions often produce animated images from static images. There could be other animation properties that the transform needs to produce its output. In this case, you should add these properties to the transform custom interface.

There are two variables that control the development of the effect. The IDXEffect::Progress variable is a number from 0.0 to 1.0 that controls the percentage of the transition to complete. Animation effects are often produced by looping over increasing values for IDXEffect::Progress, producing transform output at each step.

The IDXEffect::get_Duration variable is a suggested time, in seconds, that such a stepwise transition should take. In general, it only provides storage of the time value, and has no control over the transform output. It is up to the transform user to see that the transition over IDXEffect::Progress values happens in the suggested time.

This interface inherits from the IDispatch interface.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Header

Dxtrans.h

IDL

Dxtrans.idl

DLL

Dxtrans.dll