1GLMARK2(1)                  General Commands Manual                 GLMARK2(1)
2
3
4

NAME

6       glmark2 - OpenGL (ES) 2.0 benchmark suite
7

SYNOPSIS

9       glmark2 [options]
10

DESCRIPTION

12       glmark2  is a benchmark for OpenGL (ES) 2.0. It only uses the subset of
13       the OpenGL 2.0 API that is compatible with OpenGL ES 2.0.
14

OPTIONS

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       --data-path PATH
30              Path to glmark2 models, shaders and textures
31
32       --frame-end METHOD
33              How to end a frame [default,none,swap,finish,readpixels]
34
35       --swap-mode MODE
36              How to swap a frame, all modes supported only in the DRM flavor,
37              'fifo'  available in all flavors to force vsync [default,immedi‐
38              ate,mailbox,fifo]
39
40       --off-screen
41              Render to an off-screen surface
42
43       --visual-config
44              The visual  configuration  to  use  for  the  rendering  target:
45              ´id=ID:red=R:green=G:blue=B:alpha=A:buffer=BUF:stencil=STEN‐
46              CIL:samples=SAMPLES'.  The parameters may be defined in any  or‐
47              der,  and  any  omitted parameters assume a default value of '0'
48              (id, stencil, samples) or '1' (red, green, blue, alpha, buffer).
49              If 'id' is set to a non-zero value, all other parameters are ig‐
50              nored
51
52       --reuse-context
53              Use a single context for all scenes (by default, each scene gets
54              its own context)
55
56       -s, --size WxH
57              Size of the output window (default: 800x600)
58
59       --fullscreen
60              Run in fullscreen mode (equivalent to --size -1x-1)
61
62       --results RESULTS
63              The types of results to report for each benchmark, as a ':' sep‐
64              arated list [fps,cpu,shader]
65
66       --results-file RESULTS-FILE
67              The file to save the results to, in the format determined by the
68              file extension [csv,xml]
69
70       --winsys-options OPTS
71              A  list of 'opt=value' pairs for window system specific options,
72              separated by ':'
73
74       -l, --list-scenes
75              Display information about the available scenes and their options
76
77       --show-all-options
78              Show all scene option values used for benchmarks  (only  explic‐
79              itly set options are shown by default)
80
81       --run-forever
82              Run  indefinitely,  looping  from the last benchmark back to the
83              first
84
85       --annotate
86              Annotate the benchmarks with on-screen information (same  as  -b
87              :show-fps=true:title=#info#)
88
89       -d, --debug
90              Display debug messages
91
92       --version
93              Display program version
94
95       -h, --help
96              Display help
97

BENCHMARKS

99       glmark2  offers  a suite of scenes that can be used to measure many as‐
100       pects of OpenGL (ES) 2.0 performance. The way in which  each  scene  is
101       rendered is configurable through a set of options. To get the available
102       scenes and their acceptable options you can use the  -l,  --list-scenes
103       command line option.
104
105       In glmark2, a benchmark is defined as a scene plus a set of option val‐
106       ues.  You can specify the list and order of the benchmarks  to  run  by
107       using  the  -b,  --benchmark  command  line  option  (possibly multiple
108       times).  If no benchmarks are specified, a default set of benchmarks is
109       used.  If  a  benchmark  option is not specified it assumes its default
110       value (listed with -l, --list-scenes).
111
112       As a special case, a benchmark description string  is  allowed  to  not
113       contain a scene name (i.e. to start with ':'). In this case, any speci‐
114       fied option values are used as the default values for  benchmarks  fol‐
115       lowing this description string.
116
117

EXAMPLES

119       To run the default benchmarks:
120
121              glmark2
122
123       To  run  a  benchmark  using scene 'shading' with a 'duration' of '5.0'
124       seconds and
125        'shading' of type 'phong':
126
127              glmark2 -b shading:duration=5.0:shading=phong
128
129       To run a series of benchmarks use the -b, --benchmark command line  op‐
130       tion multiple times:
131
132              glmark2  -b  shading:duration=5.0 -b build:use-vbo=false -b tex‐
133              ture
134
135       To set default option values for benchmarks:
136
137              glmark2 -b :duration=2.0 -b shading -b build -b :duration=5.0 -b
138              texture
139

AUTHOR

141       glmark2  was  written  by Alexandros Frantzis and Jesse Barker based on
142       the original glmark by Ben Smith.
143
144
145
146glmark2 2023.01                  January 2023                       GLMARK2(1)