1GLMARK2-ES2(1) General Commands Manual GLMARK2-ES2(1)
2
6 glmark2-es2 - OpenGL (ES) 2.0 benchmark suite
7
9 glmark2-es2 [options]
10
12 glmark2-es2 is a benchmark for OpenGL (ES) 2.0. It only uses the subset
13 of the OpenGL 2.0 API that is compatible with OpenGL ES 2.0.
14
16 -b, --benchmark BENCH
17 A benchmark to run: 'scene(:opt1=val1)*' (the option can be used
18 multiple times)
19 -f, --benchmark-file FILE
21 Load benchmarks to run from a file containing a list of bench‐
22 mark descriptions (one per line) (the option can be used multi‐
23 ple times)
24 --validate
26 Run a quick output validation test instead of running the bench‐
27 marks
28 --data-path PATH
30 Path to glmark2 models, shaders and textures
31 --frame-end METHOD
33 How to end a frame [default,none,swap,finish,readpixels]
34 --off-screen
36 Render to an off-screen surface
37 --visual-config
39 The visual configuration to use for the rendering target:
40 ´red=R:green=G:blue=B:alpha=A:buffer=BUF'. The parameters may be
41 defined in any order, and any omitted parameters assume a de‐
42 fault value of '1'
43 --reuse-context
45 Use a single context for all scenes (by default, each scene gets
46 its own context)
47 -s, --size WxH
49 Size of the output window (default: 800x600)
50 --fullscreen
52 Run in fullscreen mode (equivalent to --size -1x-1)
53 -l, --list-scenes
55 Display information about the available scenes and their options
56 --show-all-options
58 Show all scene option values used for benchmarks (only explic‐
59 itly set options are shown by default)
60 --run-forever
62 Run indefinitely, looping from the last benchmark back to the
63 first
64 --annotate
66 Annotate the benchmarks with on-screen information (same as -b
67 :show-fps=true:title=#info#)
68 -d, --debug
70 Display debug messages
71 -h, --help
73 Display help
74
76 glmark2-es2 offers a suite of scenes that can be used to measure many
77 aspects of OpenGL (ES) 2.0 performance. The way in which each scene is
78 rendered is configurable through a set of options. To get the available
79 scenes and their acceptable options you can use the -l, --list-scenes
80 command line option.
81 In glmark2-es2, a benchmark is defined as a scene plus a set of option
83 values. You can specify the list and order of the benchmarks to run by
84 using the -b, --benchmark command line option (possibly multiple
85 times). If no benchmarks are specified, a default set of benchmarks is
86 used. If a benchmark option is not specified it assumes its default
87 value (listed with -l, --list-scenes).
88 As a special case, a benchmark description string is allowed to not
90 contain a scene name (i.e. to start with ':'). In this case, any speci‐
91 fied option values are used as the default values for benchmarks fol‐
92 lowing this description string.
93
96 To run the default benchmarks:
97 glmark2-es2
99 To run a benchmark using scene 'shading' with a 'duration' of '5.0'
101 seconds and
102 'shading' of type 'phong':
103 glmark2-es2 -b shading:duration=5.0:shading=phong
105 To run a series of benchmarks use the -b, --benchmark command line op‐
107 tion multiple times:
108 glmark2-es2 -b shading:duration=5.0 -b build:use-vbo=false -b
110 texture
111 To set default option values for benchmarks:
113 glmark2-es2 -b :duration=2.0 -b shading -b build -b :dura‐
115 tion=5.0 -b texture
116
118 glmark2-es2 was written by Alexandros Frantzis and Jesse Barker based
119 on the original glmark by Ben Smith.
120glmark2-es2 2021.12 December 2021 GLMARK2-ES2(1)