Share via


Background Animation (Compact 2013)

3/26/2014

This test suite measures the frame-rate that is achieved while having an animation running behind static or moving UI.

Performance logs can be found at: \\release\XRBackgroundAnimationPerfResults.xml

Test Prerequisites

Your device must meet the following requirements before you run this test.

The following prerequisites must be met to run this test.

The XAML for Windows Embedded Performance Test suite can be run on any connected device. Some of the tests may run out of memory on devices with less than 256 MB of memory.

The following table shows the software requirements for the Windows Embedded Compact-based device that will be running the performance test suite. In addition, the run-time image for the devices must include support for XAML for Windows Embedded (SYSGEN_XAML_RUNTIME) and CEPerf (IMGCEPERF).

Requirement

Description

Tux.exe

Tux test harness, required for executing the test.

Kato.dll

Kato logging engine, required for logging test data

Subtests

The table below lists the subtests included in this test.

SubTest ID

Description

3024324

A static button panel sitting over a hypnotic wave-like animation

3024326

A button panel sliding over the animation from 2

3024340

A virtual keyboard panel sliding over the animation from 2proc_name

Setting Up the Test

For each of the tests it is recommended that you first clear the log file (unless you wish to aggregate the results of a number of tests into a single log file). Enter the following at the command line in order to clear the log file:

log 0x0

y

log -flush

Running the Test

s tux -o -d \release\XRPerfBackgroundAnimationTests.dll -c data=\release\xamlruntime\test\perf\BackgroundAnimation\BackgroundAnimation.TestSuite.xml;seconds=<seconds>;<UseBaml> -x <test#>

Argument

Description

Seconds

How many seconds to run the test. 30 is typically a good value.

UseBAML

If this is included, the test will run using a binary form of XAML which loads faster.

Test#

Which of the tests to run. Here are the recommended tests:

(2) A static button panel sitting over a hypnotic wave-like animation

(4) A button panel sliding over the animation from 2

(6) A virtual keyboard panel sliding over the animation from 2proc_name

Verifying the Test

This test reports a Pass or Fail result.

The Background Animation test logs can be found in the CTK log directory:

  • XRBackgroundAnimationPerfResults.xml

The following values are common performance measurements:

  • Average Frame Rate Change Average - frame per second during Animation in frames per second (fps)
  • Load Image from Resource Average - average time for loading images from dll resource in microseconds
  • Create Host From Xaml Average - average time for loading and parsing xaml and generating the visual element tree in microseconds
  • Paint Element Tree Average - average time for rendering the visual element tree in microseconds
  • First Paint - time from process launch to the end of the first rendering of the visual element tree in microseconds

Troubleshooting the Test

Known issues: Tests with large resources may fail cause lower-end devices to run out of memory, failing the test.

If running from cmd:

Re-run the test from command line with the following parameter at the end: -f Logfile.txt. The log file, which can be found the release directory after the test executes will have more detailed information on the failure.

If running from a test framework:

Open the test framework’s log file for a more detailed information on the failure.

See Also

Other Resources

Shell Tests