ExternalBenchmarks.md

Using External Benchmarks with ANGLE

This document contains instructions on how to run external benchmarks on ANGLE as the GLES renderer. There is a section for each benchmark with subsections for each platform. The general theme is to make the benchmark application pick ANGLE's libGLESv2.so and libEGL.so files instead of the system ones.

On Linux, this is generally achieved with setting LD_LIBRARY_PATH. On Windows, ANGLE dlls may need to be copied to the benchmark's executable directory.

glmark2

This benchmark can be found on github. It's written against GLES 2.0 and supports Linux and Android. It performs tens of tests and reports the framerate for each test.

glmark2 on Linux

To build glmark2 on Linux:

$ git clone https://github.com/glmark2/glmark2.git
$ cd glmark2
$ ./waf configure --with-flavors=x11-glesv2 --data-path=$PWD/data/
$ ./waf

To run glmark2 using the native implementation of GLES:

$ cd build/src
$ ./glmark2-es2

To run glmark2 using ANGLE, we need to first create a few links in the build directory of ANGLE:

$ cd /path/to/angle/out/release
$ ln -s libEGL.so libEGL.so.1
$ ln -s libGLESv2.so libGLESv2.so.2

Back in glmark2, we need to make sure these shared objects are picked up:

$ cd /path/to/glmark2/build/src
$ LD_LIBRARY_PATH=/path/to/angle/out/release/ ldd ./glmark2-es2

With ldd, you can verify that libEGL.so.1 and libGLESv2.so.2 are correctly picked up from ANGLE's build directory.

To run glmark2 on the default back-end of ANGLE:

$ LD_LIBRARY_PATH=/path/to/angle/out/release/ ./glmark2-es2

To run glmark2 on a specific back-end of ANGLE:

$ ANGLE_DEFAULT_PLATFORM=vulkan LD_LIBRARY_PATH=/path/to/angle/out/release/ ./glmark2-es2

glmark2 on Linux for Android

Prerequisites

Below steps are set up to use version 26.0.1 of build-tools, which can be downloaded here:

https://dl.google.com/android/repository/build-tools_r26.0.1-linux.zip

Tested with r19 of NDK, which can be downloaded here:

https://dl.google.com/android/repository/android-ndk-r19-linux-x86_64.zip

Tested with OpenJDK 8:

sudo apt-get install openjdk-8-jdk

Note: This is built from a branch that has fixes for Android. It only supports 32-bit ARM (armeabi-v7a). Supporting other ABIs requires more work, possibly including a move to cmake instead of ndk-build.

Setup

export ANDROID_SDK=<path_to_Android_SDK>
export ANDROID_NDK=<path_to_Android_NDK>
export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64

Build

git clone https://github.com/cnorthrop/glmark2.git
cd glmark2/android
git checkout android_fixes
./build.sh

Install

adb install --abi armeabi-v7a glmark2.apk

Run

To select ANGLE as the driver on Android (requires Android Q):

adb shell settings put global angle_gl_driver_selection_pkgs org.linaro.glmark2
adb shell settings put global angle_gl_driver_selection_values angle

To switch back to native GLES driver:

adb shell settings delete global angle_gl_driver_selection_values
adb shell settings delete global angle_gl_driver_selection_pkgs