Modifying the Direct3D Multi-Texturing Test

Article
06/30/2006

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.

Share via

Modifying the Direct3D Multi-Texturing Test

Remarks

See Also

Additional resources