Modifying the Direct3D Fogging Test

  • Article

The Direct3D Fogging Test executes the D3DC_Fog [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 Fogging 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>
Limit the variations of the DrawPrimitive application programming interface (API) that are used to render shapes. 
-API:<dptype>

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

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

  • dpvb: DrawPrimitive
  • dipvb: DrawIndexedPrimitive
  • dp: DrawPrimitiveUP
  • dip: DrawIndexedPrimitiveUP
  • dps: DrawPrimitive with multistream shader
  • dips: DrawIndexedPrimitive with multistream shader

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 Fogging Test.

Test case Description
Vertex Renders triangles using simple vertex-based fogging of varying colors, if the driver exposes the D3DPRASTERCAPS_FOGVERTEX caps bit.
TableLinear Renders triangles using depth-based per pixel fogging with a linear fog falloff table, if supported by the driver.
TableExp Renders triangles using depth-based per pixel fogging with an exponential fog falloff table, if supported by the driver.
TableExp2 Renders triangles using depth-based per pixel fogging with a squared exponential fog falloff table, if supported by the driver.
WLinear Renders triangles using range-based per pixel fogging with a linear fog falloff table, if supported by the driver.
WExp Renders triangles using range-based per pixel fogging with an exponential fog falloff table, if supported by the driver.
WExp2 Renders triangles using range-based per pixel fogging with a squared exponential fog falloff table, if supported by the driver.
TextureVertex Runs the Vertex test case and adds a texture to the rendered triangles.
TextureTableLinear Runs the TableLinear test case and adds a texture to the rendered triangles.
TextureTableExp Runs the TableExp test case and adds a texture to the rendered triangles.
TextureTableExp2 Runs the TableExp2 test case and adds a texture to the rendered triangles.
TextureWLinear Runs the WLinear test case and adds a texture to the rendered triangles.
TextureWExp Runs the WExp test case and adds a texture to the rendered triangles.
TextureWExp2 Runs the WExp2 case and adds a texture to the rendered triangles.

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 Fogging Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.