Packages
 In this topic

*Methods

 

Packages   PreviousThis Package
Package com.ms.directX   Previous This
Package

 


Interface IUserVisualCallback

public interface IUserVisualCallback extends IUnknown
{
  // Methods
  public void callbackUserVisual(Direct3dRMUserVisual uv,
        IUnknown arg, int[] r, Direct3dRMDevice d,
        Direct3dRMViewport v);
}

Use with Direct3dRM.createUserVisual and Direct3dRMUserVisual.init to set the callback function to be called to render an application-defined visual.

IUnknown
  |
  +--IUserVisualCallback

Methods

callbackUserVisual

public void callbackUserVisual(Direct3dRMUserVisual uv, IUnknown arg, int[]
        r, Direct3dRMDevice d, Direct3dRMViewport v);

Alerts an application that supplies user-visual objects that it should execute the execute buffer. This function is application-defined.

Return Value:

No return value.

ParameterDescription
uv The Direct3dRMUserVisual object.
Arg Application-defined data passed to this callback function.
r An array variable that contains a value of user visual reason type:
D3DRMUSERVISUAL_CANSEE
The application should set this parameter to TRUE if the user-visual object is visible in the viewport. In this case, the application uses the device specified in the v parameter.
D3DRMUSERVISUAL_RENDER
The application should render the user-visual element. In this case, the application uses the device specified in the d parameter.
d A Direct3dRMDevice object used to render the Direct3dRMUserVisual object.
v A Direct3dRMViewport object used to determine whether the Direct3dRMUserVisual object is visible.

Remarks:

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

upnrm.gif © 1998 Microsoft Corporation. All rights reserved. Terms of use.