Share via

Modifying the Direct3D Z-Buffering Comparison Test

  • Article

The Direct3D Basic Z-Buffering Comparison Test executes the D3DC_ZCmp [testcase[:testrange]][options]command line on default execution. You can modify the test by editing the command line. For information about how to edit the command line for a test, see Editing the Command Line for a Test. The following table shows the modifications you can make to the test.

To modify the Direct3D Z-Buffering Comparison Test

To Add this command-line parameter
Display the command-line help. 
-?
Run the invalid parameter tests. 
-INV
Specify the device to be used as the source for rendering comparisons.

The default value is HAL.

 
-SRC:<dev>
Specify the device to be used as the reference image for the rendering comparisons.

The default value is REF.

 
-REF:<dev>

The following list shows acceptable values for the <dev> command-line argument.

  • HAL: Basic HAL device
  • TNL: HAL device supporting transformation and lighting
  • MSWHAL: HAL device using mixed software vertex processing
  • MHWHAL: HAL device using mixed hardware vertex processing
  • PUREHAL: Pure HAL device
  • REF: Basic reference rasterizer device
  • TNLREF: Reference rasterizer supporting transformation and lighting
  • MSWREF: Reference rasterizer using mixed software vertex processing
  • MHWREF: Reference rasterizer using mixed hardware vertex processing
  • PUREREF: Pure reference rasterizer

While the test runs, you can use the keyboard keys on your Windows CE-based device to control the flow of test cases. The following table shows the keys you can use to control the test.

Key Action
SPACEBAR Pauses or restarts test
S Single-steps through test
G Restarts test
RIGHT ARROW Executes test in the forward direction
LEFT ARROW Executes test in the reverse direction
F8 Displays results of SCR versus REF comparison

The following table shows the test cases for the Direct3D Z-Buffering Comparison Test.

Test case Description
NeverD16 Renders triangles of varying colors and depths on top of a 16-bit Z-buffer, with the Z-comparison operation set to never pass the test. This test is skipped if either the 16-bit Z-buffer format or the Z-comparison function is not supported by the driver.
AlwaysD24X4S4 Renders triangles of varying colors and depths on top of a 32-bit Z-buffer that uses 24 bits of depth information and 4 bits of stencil information, with the Z-comparison operation set to always pass the test. This test is skipped if either the 24/4/4 Z-buffer format or the Z-comparison function is not supported by the driver.
LessEqualD16_Lockable Renders triangles of varying colors and depths on top of a lockable 16-bit Z-buffer, with the Z-comparison operation set to pass the test only when the new pixel has a Z value that is less than or equal to the value of the current pixel. This test is skipped if either the lockable 16-bit format or the Z-comparison function is not supported by the driver.

Note   The syntax for each test case should assume a format of [CMPOP][FMT], where CMPOP is set to never, less, equal, less than or equal, greater than, not equal, greater than or equal, or always. FMT should be set to D16, D15S1, F24X4S4, D24X8, D24S8, D32, or D16_Lockable.

Remarks

This test library can have one or more optional command-line entries to change the behavior of the test. To specify one or more optional command-line entries to the test library, you must use the –c command-line option. This option forces Tux to pass the specified string into the test library.

See Also

Direct3D Z-Buffering Comparison Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.