Interface IFrameMoveCallback

public interface IFrameMoveCallback extends IUnknown
{
  // Methods
  public void callbackFrameMove(Direct3dRMFrame f, IUnknown pArgs,
        float delta);
}

Use with Direct3dRMFrame.addMoveCallback and Direct3dRMFrame.deleteMoveCallback to set or remove the callback function to be called when a frame is moved.

IUnknown
  |
  +--IFrameMoveCallback

Methods

callbackFrameMove

public void callbackFrameMove(Direct3dRMFrame f, IUnknown pArgs,
        float delta);

Enables an application to apply customized algorithms when a frame is moved or updated. You can use this callback function to compensate for changing frame rates. This callback function is application-defined.

Return Value:

No return value.

Parameter	Description
f	The Direct3dRMFrame object that is being moved.
pArgs	Application-defined data passed to this callback function.
delta	The amount of change to apply to the movement. There are two components to the change in position of a frame: linear and rotational. The change in each component is equal to velocity_of_component x delta. Although either or both of these velocities can be set relative to any frame, the system automatically converts them to velocities relative to the parent frame for the purpose of applying time deltas.

Remarks:

Your application can synthesize the acceleration of a frame relative to its parent frame. To do so, on each tick, your application should set the velocity of the child frame, relative to itself to (a units per tick) x 1 tick, where a is the required acceleration. This is equal to a x delta units per tick. Internally, a x delta units per tick relative to the child frame is converted to (v + (a x delta )) units per tick relative to the parent frame, where v is the current velocity of the child relative to the parent.

When determining the order in which to call callback functions, the system searches the objects highest in the hierarchy first and then calls their callback functions in the order in which they were created.