Direct3D Basic Rasterization Test

The Microsoft® Direct3D® Basic Rasterization Test evaluates the primitive rasterizing capabilities of a Direct3D–capable Microsoft Windows® CE–based display driver. The test assesses the following functionality:

  • Rendering primitives using different vertex formats
  • Rendering both indexed and non-indexed primitives
  • Rendering using pre-transformed and pre-lit, pre-lit, and non-transformed and non-lit vertices
  • Rendering both flat and Gouraud shaded triangles
  • Rendering depth values to the depth buffer
  • Rendering with different face-culling modes
  • Rendering with color dithering

The following table shows the hardware requirements for the Direct3D Basic Rasterization Test.

Requirements Description
Video card with 3D acceleration A video card that supports hardware acceleration of 3D. The test assumes that the driver for the card correctly reports the capabilities of the hardware. The test skips test cases that require a feature that is listed as unsupported in the D3DCAPS8 structure.

The following table shows the software requirements for the Direct3D Basic Rasterization Test.

Requirements Description
Kato.dll Kato logging engine, which is required for logging test data.
Tooltalk.dll Application required by Tux.exe and Kato.dll. Handles the transport between the target device and the development workstation.
D3dc_basicrst.exe Test .exe file.

When you build your Windows CE OS, you must include the Microsoft DirectDraw® and Direct3D features in order to run this test. You can set SYSGEN_DIRECT3D=1 to add the required features to your platform.

The process that verifies whether images are correctly rendered requires the test to render the same scene simultaneously to the software rasterizer and the hardware device. The resulting frames are compared to determine the accuracy of the rendered image. Therefore, the test requires that the reference rasterizer be available in your Windows CE OS. You can set SYSGEN_DIRECT3D_RAST=1 to add the reference rasterizer to your platform.

Note   When you run the Direct3D Basic Rasterization Test, the CETK temporarily copies files to the root directory of the target device. While the test runs, the test dynamically consumes program memory on the target device. Before running the test, verify that there is at least 0.7 megabytes (MB) of free storage memory on the target device. Also verify that there is at least 3.5 MB of free program memory on the target device. If there is not sufficient space in the root directory of the target device or there is not sufficient program memory, the test cannot run.

See Also

Modifying the Direct3D Basic Rasterization Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.