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

NAME

6       glmark2-wayland - OpenGL (ES) 2.0 benchmark suite
7

SYNOPSIS

9       glmark2-wayland [options]
10

DESCRIPTION

12       glmark2-wayland  is  a  benchmark for OpenGL (ES) 2.0. It only uses the
13       subset of 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-wayland  offers  a  suite of scenes that can be used to measure
100       many aspects of OpenGL (ES) 2.0 performance.  The  way  in  which  each
101       scene  is rendered is configurable through a set of options. To get the
102       available scenes and their acceptable  options  you  can  use  the  -l,
103       --list-scenes command line option.
104
105       In glmark2-wayland, a benchmark is defined as a scene plus a set of op‐
106       tion values.  You can specify the list and order of the  benchmarks  to
107       run by 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-wayland
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-wayland -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-wayland  -b  shading:duration=5.0 -b build:use-vbo=false
133              -b texture
134
135       To set default option values for benchmarks:
136
137              glmark2-wayland -b :duration=2.0 -b shading -b build  -b  :dura‐
138              tion=5.0 -b texture
139

AUTHOR

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