Modifying the Direct3D Multi-Texturing Test

The Direct3D Multi-Texturing Test executes the PC99MultiTexturing [Range: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 Multi-Texturing 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

On default execution the test performs all test cases in a single extended test pass. If the test fails, the test logs detailed information about the texture appearance, blending modes, vertex format, and the vertex colors. To run a specific test case, you can pass an identifier to the command line as an argument.

The following text shows a sample error recorded in the error log.

000015 - PC99 Multitexturing                 FAILED!
     Texture Stage States:
     0, D3DTSS_COLOROP,   D3DTOP_SELECTARG1
     0, D3DTSS_COLORARG1, D3DTA_TEXTURE
     0, D3DTSS_COLORARG2, D3DTA_CURRENT
     0, D3DTSS_ALPHAOP,   D3DTOP_SELECTARG1
     0, D3DTSS_ALPHAARG1, D3DTA_TEXTURE
     0, D3DTSS_ALPHAARG2, D3DTA_CURRENT
     1, D3DTSS_COLOROP,   D3DTOP_MODULATE
     1, D3DTSS_COLORARG1, D3DTA_TEXTURE
     1, D3DTSS_COLORARG2, D3DTA_CURRENT
     1, D3DTSS_ALPHAOP,   D3DTOP_SELECTARG2
     1, D3DTSS_ALPHAARG1, D3DTA_TEXTURE
     1, D3DTSS_ALPHAARG2, D3DTA_CURRENT
State info:
# of Textures: 2
# of Texture Coords: 2
Blend Mode: Modulate RGB
Diffuse Colors: gray -> yellow, Alpha 1.000000 Horiz. Gradient
Texture 0 Colors: gray -> yellow, Alpha 1.000000 Vert Gradient
Texture 1 Colors: 8 color stripes w/alpha 1.0, 8 color stripes w/Alpha 0.45

This example shows that test case 15 fails. To run this test case again, you can use the following command line.

PC99MultiTexturing –Range:15

To run a series of test cases, you can use the following command line.

PC99MultiTexturing –Range:1-4,10-15

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 Multi-Texturing Test

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.