README
1glmark2 is an OpenGL 2.0 and ES 2.0 benchmark.
2
3glmark2 is developed by Alexandros Frantzis and Jesse Barker based on the
4original glmark benchmark by Ben Smith.
5
6It is licensed under the GPLv3 (see COPYING).
7
8To build glmark2 you need:
9
10 * meson (>= 0.47) or python3 (if you are using WAF for building)
11 * libpng 1.6
12 * Window system development files for the flavors you want to build
13 (e.g, X11, Wayland, drm)
14 * libGL (for desktop GL)
15 * libEGL and libGLESv2 (for GLESv2)
16
17Read the INSTALL file for building/installation instructions,
18
19Read the INSTALL.android file for instructions for Android.
20
README.android
1Command-line arguments
2======================
3
4The Android version of glmark2 can accept command-line arguments from either
5an extra intent key or a file. If arguments are specified in an intent key, the
6file is disregarded.
7
8Arguments from an extra intent key
9----------------------------------
10
11The 'args' extra intent key is used to specify arguments. For example:
12
13am start -a android.intent.action.MAIN \
14 -n org.linaro.glmark2/org.linaro.glmark2.Glmark2Activity \
15 -e args '-b :duration=2 -b texture -f /path/file --debug'
16
17Arguments from a file
18---------------------
19
20If the 'args' intent key is not defined, the contents of the file
21'/data/glmark2/args' (if present) are used as command line arguments. The
22arguments can be placed in either a single or multiple lines. For example:
23
24-b :duration -b texture
25-f /path/file
26--debug
27
28Android limitations and peculiarities
29=====================================
30
31The Android version of glmark2 doesn't accept all of the command-line arguments
32that the X11 version accepts. In particular, the Android version currently
33ignores the following:
34
35--validate
36--frame-end
37--off-screen
38--reuse-context
39--fullscreen
40-l,--list-scenes
41
42The default visual config used on Android is:
43
44'red=5:green=6:blue=5:alpha=0:depth=16:buffer=1'
45
46Of course, you can change it using the '--visual-config' option.
47
48The Android system is free to resize the application at will, so although the
49'-s,--size' option is initially taken into account, it usually doesn't have any
50lasting effect.
51