1GLMARK2(1) General Commands Manual GLMARK2(1)
2
3
4
6 glmark2-drm - OpenGL (ES) 2.0 benchmark suite
7
9 glmark2-drm [options]
10
12 glmark2-drm 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
20 -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
25 --validate
26 Run a quick output validation test instead of running the bench‐
27 marks
28
29 --frame-end METHOD
30 How to end a frame [default,none,swap,finish,readpixels]
31
32 --off-screen
33 Render to an off-screen surface
34
35 --visual-config
36 The visual configuration to use for the rendering target:
37 ´red=R:green=G:blue=B:alpha=A:buffer=BUF'. The parameters may be
38 defined in any order, and any omitted parameters assume a
39 default value of '1'
40
41 --reuse-context
42 Use a single context for all scenes (by default, each scene gets
43 its own context)
44
45 -s, --size WxH
46 Size of the output window (default: 800x600)
47
48 --fullscreen
49 Run in fullscreen mode (equivalent to --size -1x-1)
50
51 -l, --list-scenes
52 Display information about the available scenes and their options
53
54 --show-all-options
55 Show all scene option values used for benchmarks (only explic‐
56 itly set options are shown by default)
57
58 --run-forever
59 Run indefinitely, looping from the last benchmark back to the
60 first
61
62 --annotate
63 Annotate the benchmarks with on-screen information (same as -b
64 :show-fps=true:title=#info#)
65
66 -d, --debug
67 Display debug messages
68
69 -h, --help
70 Display help
71
73 glmark2-drm offers a suite of scenes that can be used to measure many
74 aspects of OpenGL (ES) 2.0 performance. The way in which each scene is
75 rendered is configurable through a set of options. To get the available
76 scenes and their acceptable options you can use the -l, --list-scenes
77 command line option.
78
79 In glmark2-drm, a benchmark is defined as a scene plus a set of option
80 values. You can specify the list and order of the benchmarks to run by
81 using the -b, --benchmark command line option (possibly multiple
82 times). If no benchmarks are specified, a default set of benchmarks is
83 used. If a benchmark option is not specified it assumes its default
84 value (listed with -l, --list-scenes).
85
86 As a special case, a benchmark description string is allowed to not
87 contain a scene name (i.e. to start with ':'). In this case, any speci‐
88 fied option values are used as the default values for benchmarks fol‐
89 lowing this description string.
90
91
93 To run the default benchmarks:
94
95 glmark2-drm
96
97 To run a benchmark using scene 'shading' with a 'duration' of '5.0'
98 seconds and
99 'shading' of type 'phong':
100
101 glmark2-drm -b shading:duration=5.0:shading=phong
102
103 To run a series of benchmarks use the -b, --benchmark command line
104 option multiple times:
105
106 glmark2-drm -b shading:duration=5.0 -b build:use-vbo=false -b
107 texture
108
109 To set default option values for benchmarks:
110
111 glmark2-drm -b :duration=2.0 -b shading -b build -b :dura‐
112 tion=5.0 -b texture
113
115 glmark2-drm was written by Alexandros Frantzis and Jesse Barker based
116 on the original glmark by Ben Smith.
117
118
119
120glmark2-drm 2017.07 July 2017 GLMARK2(1)