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.