Windows Presentation Foundation (WPF) Verification Suite

Note  This content applies to the Windows Logo Kit (WLK). For the latest information using the new Windows Hardware Certification Kit (HCK), see Windows HCK User's Guide on the Windows Hardware Dev Center.

Type: Automated Test

Overview

The Windows Presentation Foundation verification suite enforces that the display adapter meets the minimum requirements for Windows Presentation Foundation (WPF) content.

Details

1. WpfTest.exe

This executable, written in C#, is the main test driver for the WPF verification suite. Its operation is controlled with an XML script file.

1.1 RefRast verification tests Overview:

The main verification technique for the WpfTest framework is to generate equally sized windows with the same WPF content, one rendering in WPF Hardware accelerated mode and the other using RefRast, the DirectX reference rasterizer. The windows rendered are compared pixel by pixel. The same content is also rendered in transparent windows and verified with the same technique. The XML script contains details of tolerance curves to use, source of content for each test, window size, timeout, and preferred log format for text and screen captures.

This technique is used for 2-D, text, ShaderEffect, and some 3-D verification tests. All source content is either XAML file or text defined in the XML script. This driver has the ability to test any loose xaml, so extending the content here is as simple as adding more XAML files to the kit. Currently the content types supported are: Xaml, ImageBrush, Text, and 3D Content.

Tests:

  1. Windows Presentation Foundation 2D Graphics Render Tests - Basic 32bpp

    Command Line: WpfTest.exe /TestDocument: 2DTests_Basic.xml

    Description: Basic 2D Content in a 32bpp mode.

  2. Windows Presentation Foundation 2D Graphics Render Tests - Basic 16bpp

    Command Line: WpfTest.exe /TestDocument: 2DTests_Basic16.xml /noDisplayModeReset

    Description: Validates rendering of basic 2D Content in a 16bpp mode.

  3. Windows Presentation Foundation 2D Graphics Render Tests - Images

    Command Line: WpfTest.exe /TestDocument: 2DTests_Images.xml

    Description: Image content, defined in an image file.

  4. Windows Presentation Foundation 3D Graphics Render Tests - Basic

    Command Line: WpfTest.exe /TestDocument: 3DTests_Basic.xml

    Description: Basic 3D content, defined in Xaml files.

  5. Windows Presentation Foundation 3D Graphics Render Tests - Material

    Command Line: WpfTest.exe /TestDocument: 3DTests_Material.xml

    Description: Some 3D scenarios, defined in the Xml file. They are different Meshes with different Material/BackMaterials, with different Lights and different Position/LookDirections.

  6. Windows Presentation Foundation 3D Graphics Render Tests - Scenario

    Command Line: WpfTest.exe /TestDocument: 3DTests_Scenario.xml

    Description: Advanced 3D scenarios.

  7. Windows Presentation Foundation 3D Graphics Render Tests - Texturing

    Command Line: WpfTest.exe /TestDocument: 3DTests_Texturing.xml

    Description: ImageBrush and DrawingBrush.

  8. Windows Presentation Foundation Text Render Tests - Basic

    Command Line: WpfTest.exe /TestDocument: TextTests.xml

    Description: Text in various options, such as Background, FontFamily, FontSize, FontStretch, FontStyle, TextTrimming, TextWrap, TextAlignment, FontWeight, Foreground, and LineHeight.

  9. Windows Presentation Foundation Text Render Tests - Glyphs

    Command Line: WpfTest.exe /TestDocument: TextTests_Glyphs.xml

    Description: Glyph scenarios, defined in some XAML files.

  10. Windows Presentation Foundation ShaderEffect tests

    Command Line: WpfTest.exe /TestDocument: ShaderEffectTests.xml

    Description: WPF content with ShaderEffect, a feature using pixel shader.

1.2 AntiAliasing test Overview:

Test asserts that the current card supports 3-D anti-aliasing.

Test renders 3D content, which has a solid color, flat shading on a solid color background. It then captures the screen and counts the number of colors it finds. If there are more than the foreground and background colors (along the edges), the test considers that 3DAA is active. Otherwise, test fails.

Test:

  • 3D Graphics Render Tests - Anti-Aliasing

    Command Line: WpfTest.exe /TestDocument: 3DTests_AntiAliasing.xml

1.3 Tiering test Overview:

Test asserts that the current RenderCapabilities.Tier property is set to 2. This is an LDDM requirement for WPF content.

Test:

  • Windows Presentation Foundation Tiering API Test

    Command Line: WpfTest.exe /TestDocument: APITests_Tiering.xml

    Description: Currently disabled since tier 2 is not currently a requirement for Logo program.

1.4 Animation and scenario tests Overview:

Basic functionality tests that cover multiple monitor and animation scenarios. Each test moves and resizes WPF content around different multiple monitor configuration points, fails if an exception is thrown or passes after a given time.

Tests:

  1. Windows Presentation Foundation Animation Scenario Test

    Command Line: WpfTest.exe /TestDocument: 2dAnimationScenario.xml

    Description: Tests animation scenarios.

  2. Windows Presentation Foundation MultiMon Test - Horizontal

    Command Line: WpfTest.exe /TestDocument: MultiMonHorOrientationNormal.xml

    Description: Two monitors, monitor 1 and monitor 2, are arranged on the left and right, respectively. Both monitors are in 32bpp mode.

  3. Windows Presentation Foundation MultiMon Test - Horizontal HW Fallback

    Command Line: WpfTest.exe /TestDocument: MultiMonHorOrientationNormalHWFallback.xml

    Description: Two monitors, monitor 1 and monitor 2, are arranged on the left and right, respectively. Monitor 1 is in 32bpp mode and monitor 2 is in 16bpp mode.

  4. Windows Presentation Foundation MultiMon Test - Horizontal Reverse

    Command Line: WpfTest.exe /TestDocument: MultiMonHorOrientationReversed.xml

    Description: Two monitors, monitor 1 and monitor 2, are arranged on the right and left, respectively. Both monitors are in 32bpp mode.

  5. Windows Presentation Foundation MultiMon Test - Vertical

    Command Line: WpfTest.exe /TestDocument: MultiMonVertOrientationNormal.xml

    Description: Two monitors, monitor 1 and monitor 2, are stacked on the top and bottom, respectively. Both monitors are in 32bpp mode.

  6. Windows Presentation Foundation MultiMon Test - Vertical HW Fallback

    Command Line: WpfTest.exe /TestDocument: MultiMonVertOrientationReversedHWFallback.xml

    Description: Two monitors, monitor 1 and monitor 2, are stacked on the top and bottom, respectively, monitor 1 is in 32bpp mode and monitor 2 is in 16bpp mode.

  7. Windows Presentation Foundation MultiMon Test - Vertical Reverse

    Command Line: WpfTest.exe /TestDocument: MultiMonVertOrientationReversed.xml

    Description: Two monitors, monitor 1 and monitor 2, are stacked on the bottom and top, respectively. Both monitors and both display in 32bpp mode.

2. Stability ("Crash") Tests Overview:

All stability tests are made to run within the DirectX Crash harness together with other DirectX applications in the kit. The spirit of these tests is to be stand-alone applications that produce reproducible content in a random fashion to stress the system - they will be monitored for crashes as part of the stability effort.

These are all built from a common core and have the following common parameters and behavior. Each iteration loads certain content, moves and resizes the window, and changes window background.

/seed=< int > - random number seed to reproduce a sequence of events

/refresh=< int - milliseconds > - time between content refresh

/hardware - create a hardware only render target when set

/serialize - save each iteration as a stand-alone XAML file

/verify - after rendering the random content in hardware, test renders using the reference rasterizer and uses visual verification to validate. This can make the test longer and more cumbersome and should not be used under stress - it's rather meant to be an additional use for this framework.

/forceSave - saves a .png output file of the rendered content for each iteration

Tests:

  1. Windows Presentation Foundation D3D Stress

    Command Line: Crash3DTest.exe /hardware /refresh=2000

    Description: Test creates random 3-D content. The camera is set so that the content is very likely to be in view most of the time. Different numbers of lights, meshes, materials, Effects and some other variations are set in a random fashion.

  2. Windows Presentation Foundation Drawing Stress

    Command Line: CrashDrawingTest.exe /hardware /refresh=1500

    Description: Test creates random 2-D content by generating randomized path segments, with different widths and pens and fills. Since path is the lowest level rendering primitive in WPF, this should be a defining sample of any 2-D content. The path is set to fit into the visible window area.

  3. Windows Presentation Foundation Win32 Host Stress

    Command Line: CrashHostTest.exe /hardware /refresh=2000

    Description: Test creates a randomly sized Win32 button hosted within a WPF application.

  4. Windows Presentation Foundation Video Stress

    Command Line: Test scans the working directory for .WMV files, randomly chooses one from them, and creates a scene with the video in either 2-D or 3-D.

    Description: CrashVideoTest.exe /hardware /refresh=15000

  5. Windows Presentation Foundation Xaml Stress

    Command Line: CrashXamlTest.exe /hardware /refresh=4000

    Description: Test randomly grabs a Xaml file from working directory and creates a scene from the Xaml file.

Requirements

Software Requirements

The test tool runs on the following Windows operating systems:

  • Windows 7

  • Windows Vista

  • Windows Server 2003

  • Windows XP

  • Software components included with the device that is being tested

  • Microsoft .NET Framework 3.5 Service Pack 1 installed

Hardware Requirements

The test tool requires the following hardware:

  • Device to be tested

  • Computer that meets the minimum software requirements

  • Windows keyboard

  • Two-button pointing device

  • Color display monitor capable of at least 1024 by 768 resolution, 32-bits per pixel, 60 Hz

  • Hard drive with a minimum of 20 GB available on partition C:

Processor

The test tool runs on the following processor architectures:

  • x86

  • x64

 

 

Build date: 9/14/2012

Community Additions

ADD
Show: