Direct3D Fogging Test

The Microsoft® Direct3D® Fogging Test assesses the depth-based and ranged-based fogging capabilities of a Direct3D–capable Microsoft Windows® CE–based display driver. The Direct3D Fogging Test evaluates the following functionality for Direct3D:

  • Rendering, using vertex fog
  • Rendering, using depth-based and ranged-based fog
  • Rendering, using linear, exponential, and squared fog falloff functions
  • Rendering, using fog of varying colors
  • Rendering fogging on primitives, with and without textures

The following table shows the hardware requirements for the Direct3D Fogging 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 Fogging 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_fog.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 Fogging 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.6 megabytes (MB) of free storage memory on the target device. Also verify that there is at least 2.8 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 Fogging Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.