WGF11 Rasterizer
This automated test verifies various aspects of the D3D primitive rasterizer and rasterizer state as implemented by hardware.
This topic applies to the following test jobs:
WGF11 Rasterizer
WGF11 Rasterizer (WoW64)
Test details
Specifications |
|
Platforms |
|
Supported Releases |
|
Expected run time (in minutes) | 2 |
Category | Compatibility |
Timeout (in minutes) | 120 |
Requires reboot | false |
Requires special configuration | false |
Type | automatic |
Additional documentation
Tests in this feature area might have additional documentation, including prerequisites, setup, and troubleshooting information, that can be found in the following topic(s):
Running the test
Before you run the test, complete the test setup as described in the test requirements: Graphic Adapter or Chipset Testing Prerequisites.
Troubleshooting
For generic troubleshooting of HLK test failures, see Troubleshooting Windows HLK Test Failures.
For troubleshooting information, see Troubleshooting Device.Graphics Testing.
All test cases return PASS or FAIL. Review the test results in the log file for specific details about failures. The test might return SKIP if it is run with a feature level that doesn't support the feature being tested. The test might return BLOCKED if there is an uncaught exception (framework catches it at the end and logs it).
More information
For D3D10 and above, this test verifies the following:
Primitive culling, fill mode, and winding order based on the rasterizer state.
Interpolation modes in the pixel shader
Constant mode is simple, because there is no change from the values sent from the vertex shader.
Because it is not tightly spec'd, linear modes are verified by ensuring that adjacent pixels are not equal and follow the gradient of an edge.
Sample frequency pixel shader invocation (D3D10.1 and above).
For D3D11, this test verifies pull model attribute evaluation.
The following intrinsic functions will be introduced into D3D11 (HLSL 5.0) for the feature of pull-model attribute evaluation:
EvaluateAttributeSnapped( attrib numeric value, int2 pixeloffset )
EvaluateAttributeAtSample( attrib numeric value, uint sampleindex )
EvaluateAttributeAtCentroid( attrib numeric value )
For each intrinsic function, a set of pixel shaders will be generated, targeting the cases on different combinations of the parameter values of the intrinsic function and the declared interpolation modes of the input attributes.
The following are test factors for all three intrinsics:
Input attributes passed from the Vertex shader.
Note
Only float type attribute can be interpolated; int/uint type will always be constant interpolation mode
float4 texCoord : TEXCOORD
float4 color : COLOR
float clipDis : SV_ClipDistance
Declarations of interpolation modes.
Note
Nointerpolation mode is not allowed by the HLSL compiler when the corresponding attribute is evaluated with pull-model in the shader.
linear
linear noPerspective
linear centroid
linear sample
linear noPerspective centroid
linear noPerspective sample
Primitives to draw:
When the interpolation mode is linear, a triangle C1-C2-C3 as follows will be drawn. This covers one whole pixel and two half pixels. The coordinates of the vertices in projection space are as the following:
<need image here
C1: (-1, 1, 0), C2(-1, -1, 0), C3(1, 1, 0).
Right triangle within a square, with vertices C1, C2, and C3; C1 forms the 90-degree angle and is at the upper-left corner of the square
When the interpolation mode is noperspective, a triangle A-B-C with the following vertex coordinates in the projection space will be drawn:
A:(-1, 1, 1);
B:(-1, -1, 0);
C:(1, 1, 1)
The screen space triangle should cover the same pixels and pixel areas as triangle C1-C2-C3 shown above.
Render target
Format: All formats supporting render target.
Sample count: 1, 2, ... the maximum supported sample count.
Different values of pixeloffset for EvaluateAttributeSnapped( )
Ideally, all possible 256 offset positions. If the test runs too long, this group of test cases will be reduced to 4 corner positions, 8 border positions, 4 positions from 4x4 grid, 4 positions from 8x8 grid, and 4 positions from 16x16 grid.
Different values of sampleindex for EvaluateAttributeAtSample( )
All sample indices supported by the render target
The verification method begins when the pixel shader writes the interpolated attribute value to the render target. The render target data is then mapped and read out. In cases of multisampled render targets, multisample resolve is required before mapping. The result data will be compared with pre-calculated interpolated data or data got from direct accessing the attribute.
When interpolation mode is linear noperspective:
Calculate and store the interpolated (and extrapolated for uncovered area of p2 and p3) values for 256 offset positions of each pixels of p1, p2, p3.
For EvaluateAttributeSnapped :
Pixel p1 should have "pulled " attribute value in between of the expected values for left and right (as well as upper and lower) neighboring offsets of the "pulled" offset.
Pixels p2 and p3:
In single-sampled cases, they should not be rendered.
In multi-sampled cases, they should have "pulled" attribute value in between of the expected values for left and right (as well as upper and lower) neighboring offsets of the "pulled" offset.
For EvaluateAttributeAtSample with SampleFinder, find the position of the sample index on the sample coordinate system with range [-8, 7]. Use this position to do the verification the same way as in EvaluateAttributeSnapped above.
For EvaluateAttributeAtCentroid, draw triangle C1-C2-C3 with SV_COVERAGE to find out the first covered sample, which is the centroid position defined by the Shader Model 5.0. Use the sample index for centoid to do the verification the same way as in EvaluateAttributeAtSample above.
When interpolation mode is linear:
Calculate and store the interpolated (and extrapolated for uncovered area of p2 and p3) values for 256 offset positions of each pixels, using perspective correct interpolation. Interpolate the attribute values that have been divided by the respective depth value, then divide the interpolated attribute value by the interpolated reciprocal of the depth.
For EvaluateAttributeSnapped(), use the same verification as 2.a.
For EvaluateAttributeAtCentroid(), use the same verification as 2.c.
For EvaluateAttributeAtSample(), use the same verification as 2.b.
Use PSInvocation to verify the number of PS invocations for all test cases.
If any attribute has sample interpolation mode or SV_SAMPLEINDEX is declared, and the sample count is larger than 1, PSInvocation should be 3*(sample count).
When the sample count is 1, PSInvocation should be 1.
Command syntax
Command option | Description |
---|---|
Wgf11rasterizer |
Runs the test jobs. Without any options, the test enumerates devices. |
-FeatureLevel:XX.X |
Sets the feauture level, where XX.X is the Feature Level the test will run at: 10.0, 10.1, or 11.0. |
Note
For command line help for this test binary, type /?.
File list
File | Location |
---|---|
Configdisplay.exe |
<[testbinroot]>\nttest\windowstest\tools\ |
D3d11_1sdklayers.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3d11ref.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3d11sdklayers.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
D3dcompiler_test.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support |
D3dx10_test.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
d3dx11_test.dll |
<[testbinroot]>\nttest\windowstest\graphics\d3d\support\ |
TDRWatch.exe |
<[testbinroot]>\nttest\windowstest\graphics\ |
Wgf11rasterizer.exe |
<[testbinroot]>\nttest\windowstest\graphics\d3d\conf |
Parameters
Parameter name | Parameter description |
---|---|
MODIFIEDCMDLINE | Additional command line arguments for test executable |
LLU_NetAccessOnly | LLU Name of net user |
ConfigDisplayCommandLine | Custom Command Line for ConfigDisplay. Default: logo |
TDRArgs | /get or /set |