125 lines
3.2 KiB
Markdown
125 lines
3.2 KiB
Markdown
# 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](https://github.com/glmark2/glmark2). 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](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](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
|
|
```
|