skia2/tools/skpbench
Ben Wagner ae4bb98f13 Reland "Remove use of legacy display globals."
This is a reland of c1916c34fe

As it turns out, benches are not always given a canvas.

Original change's description:
> Remove use of legacy display globals.
>
> In the ongoing effort to remove the display globals from Skia, allow
> their use only if SK_LEGACY_SURFACE_PROPS is defined. Do not define this
> in a normal Skia build and remove all use from Skia code.
>
> Change-Id: I9ff550f5db246b9024aac687a1bc01321f1be4c8
> Reviewed-on: https://skia-review.googlesource.com/c/skia/+/319343
> Reviewed-by: Herb Derby <herb@google.com>
> Commit-Queue: Ben Wagner <bungeman@google.com>

Change-Id: I61a2ac058fafc99653e3304876cf4b97350dac8b
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/322490
Reviewed-by: Ben Wagner <bungeman@google.com>
Reviewed-by: Herb Derby <herb@google.com>
Commit-Queue: Ben Wagner <bungeman@google.com>
2020-10-05 19:13:58 +00:00
..
__init__.py skpbench 2016-09-19 11:03:58 -07:00
_adb_path.py Assert there are some sources when running skpbench 2019-09-11 20:20:33 +00:00
_adb.py skpbench: invoke 'adb wait-for-device' lazily 2019-07-29 16:49:59 +00:00
_benchresult.py skpbench: add "resultsfile" option 2016-11-10 16:08:12 +00:00
_hardware_android.py skpbench: Add support for Pixel 2 2018-04-30 15:29:13 +00:00
_hardware_nexus_6p.py [skpbench] experiment with not disabling services 2018-03-01 19:28:44 +00:00
_hardware_pixel2.py skpbench: Add support for Pixel 2 2018-04-30 15:29:13 +00:00
_hardware_pixel_c.py [skpbench] Use android's perf settings for Pixel C 2018-03-19 14:22:55 +00:00
_hardware_pixel.py skpbench: Add support for Pixel 2 2018-04-30 15:29:13 +00:00
_hardware.py skpbench: support pixel phone 2017-10-20 17:52:36 +00:00
_os_path.py Add "AllPathsVolatile" skpbench bots 2020-09-24 19:50:34 +00:00
README.md Add a basic readme to help the uninitiated build and run skpbench 2020-06-11 13:27:03 +00:00
sheet.py skpbench: add utility to format results for Skia Perf 2016-11-10 20:00:56 +00:00
skiaperf.py find min and max, separared by comma. not minmax. 2019-11-06 16:35:23 +00:00
skpbench.cpp Reland "Remove use of legacy display globals." 2020-10-05 19:13:58 +00:00
skpbench.py add pixel xl to skpbench 2020-10-05 18:34:18 +00:00

skpbench

skpbench is a benchmarking tool for replaying skp or mksp files on android devices. it achieves a lower variance in framerate by controlling the clock speed and stopping all other processes that could cause interference.

Build

skpbench consists of the skpbench binary which must be built for the phone you intend to run on, and skpbench.py which runs on the machine the phone is connected to via ADB and is the entry point.

The to build skia for android are at https://skia.org/user/build#android and reproduced here.

Download the Android NDK

cipd auth-login
python2 infra/bots/assets/android_ndk_linux/download.py  -t /tmp/ndk

After this is set up once, build skpbench for your target cpu (assumed to be arm64 here for a Pixel 3)

bin/gn gen out/arm64 --args='ndk="/tmp/ndk" target_cpu="arm64" is_debug=false'
ninja -C out/arm64 skpbench

Benchmark an SKP on a connected device.

First, copy the built skpbench binary and an example skp file to the device.

adb push out/arm64/skpbench /data/local/tmp
adb push /home/nifong/Downloads/foo.skp /data/local/tmp/skps/

Run skpbench.py (in my case on a Pixel 3)

python tools/skpbench/skpbench.py \
  --adb \
  --force \
  --config gles \
  /data/local/tmp/skpbench \
  /data/local/tmp/skps/foo.skp

--adb specifies that it should use adb to the only connected device and run skpbench there. --force is necessary because we don't yet have a configuration to monitor vitals on the Pixel 3. --config gles specifies Open GL ES is the backend GPU config to use.

Additional documentation of arguments is printed by python tools/skpbench/skpbench.py --help

Output appears in the following format

   accum    median       max       min   stddev  samples  sample_ms  clock  metric  config    bench
  0.1834    0.1832    0.1897    0.1707    1.59%      101         50  cpu    ms      gles      foo.skp

accum is the time taken to draw all frames, divided by the number of frames. metric specifies that the unit is ms (milliseconds per frame)

Production

skpbench is run as a tryjob from gerrit, where it uploads the results to perf.skia.org. TODO(nifong, csmartdalton): elaborate on this section.