Assesses a system's ability to run D3D based applications such as games.
For examples of how to use this command, see Examples.
Syntax
winsat d3d <parameters>
Parameters
Parameter | Description |
---|---|
-objs |
The primitives used in the assessment are spheres. The parameter
specifies the theta and phi quantization. Increasing this number
causes more shader processing to occur. |
-sradius |
Specifies the radius of the spheres. A smaller radius will
reduce the number of pixels drawn for that sphere while keeping the
overhead of that sphere constant. |
-totalobj |
Total number of spheres in the scene. A large number of objects,
combined with a small object size, results is an assessment that is
batch limited. |
-texw |
Width and height of the textures created by the assessment as a
power of 2. |
-totaltex |
The total number of textures that WinSAT will create. If the
number of textures is less than the total number of objects that
require a texture, then WinSAT will re-use the textures in the
scene. If there are more textures that are required in the scene
then WinSAT will iterate over the list using as many as is needed
for this frame. This means that all textures will be used
eventually. |
-texpobj |
This is the number of textures each sphere requires to
render. |
-batchcnt |
Having large batches reduces driver time and tends to make the
application fill rate limited. Conversely, having many small
batches causes more driver overhead. |
-time |
Number of seconds to run the assessment. |
-out |
Specifies a path to a file to save the results along with the
arguments to WinSAT. |
-width |
Width and Height of the window the app is running in. On XP,
this is the screen resolution, on Vista it will be similar, but
will not run in exclusive mode. |
-vs <profile> |
Forces the use of a particular vertex shader profile. The assessment is not guaranteed to run correctly when forced into using a particular shader model. |
-ps <profile> |
Forces the user of a particular pixel shader profile. The assessment is not guaranteed to run correctly when forced to use a particular shader model. |
-fps <n> |
In full screen mode, limits the refresh rate (frames per second) to the nearest rate supported by the card. |
-rendertotex <n> |
Render to texture float <n>. Simulate multiple-stage off-screen texture rendering. WinSAT will cycle through the specified number of rendertargets. |
-rtdelta <n> |
When rendering with render targets, the delta defines how far back in the render target circular buffer the assessment will go to set a previous render target as a texture. The default is 1. |
-fullscreen |
Specifies that the D3D device should be created in full screen mode. |
-noalpha |
Turns off back buffer alpha blending. |
-NoDisp |
Sets the window to "not visible" so that the assessment draws to an off-screen surface. |
-texshader |
Use the texture shader that samples up to 16 textures and adds them together instead of the default simple shader. |
-alushader |
Use the alu shader that loads up to two textures and computes an intensive lighting formula instead of the default simple shader. |
-fixedseed |
Seeds rand with a fixed number in order to run the exact same assessment multiple times. |
-nozwarming |
Disables the z-buffer warming used to make the results consistent for non-alpha assessments. |
-ref |
Forces software rasterization of the assessment. This option can decrease the speed of the assessment. |
-noetw |
Disables ETW tracing. Use this option if you intend to do your own ETW logging and do not want the log stopped when the assessment runs. |
-noclear |
Disables the call to clear in the OnFrameRender function. |
-v |
Send verbose output to STDOUT, including status and progress information. Any errors will also be written to the command window. |
-xml <file name> |
Save the output of the assessment as the specified XML file. If the specified file exists, it will be overwritten. |
-idiskinfo |
Save information about physical volumes and logical disks as part of the <SystemConfig> section in the XML output. |
-iguid |
Create a globally unique identifier (GUID) in the XML output file. |
-note "note text" |
Add the note text to the <note> section in the XML output file. |
-icn |
Include the local computer name in the XML output file. |
-eef |
Enumerate extra system information in the XML output file. |
Examples
- The following example assesses performance with 20 total
spheres and 10 rendered textures using the alu shader, without back
buffer alpha blending and in full screen mode, for 10 seconds,
sending verbose output to stdout.
winsat d3d -totalobj 20 -objs C(20) -totaltex 10 -texpobj C(1) -alushader -noalpha -fullscreen -v -time 10
Remarks
- Membership in the local Administrators group, or equivalent, is
the minimum required to use winsat. The command must be
executed from an elevated command prompt window.
- To open an elevated command prompt window, click Start,
click Accessories, right-click Command Prompt, and
click Run as administrator.