1GLMARK2(1)                  General Commands Manual                 GLMARK2(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       --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

BENCHMARKS

73       glmark2-wayland  offers  a  suite of scenes that can be used to measure
74       many aspects of OpenGL (ES) 2.0 performance.  The  way  in  which  each
75       scene  is rendered is configurable through a set of options. To get the
76       available scenes and their acceptable  options  you  can  use  the  -l,
77       --list-scenes command line option.
78
79       In  glmark2-wayland,  a  benchmark  is defined as a scene plus a set of
80       option values.  You can specify the list and order of the benchmarks to
81       run by 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

EXAMPLES

93       To run the default benchmarks:
94
95              glmark2-wayland
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-wayland -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-wayland  -b  shading:duration=5.0 -b build:use-vbo=false
107              -b texture
108
109       To set default option values for benchmarks:
110
111              glmark2-wayland -b :duration=2.0 -b shading -b build  -b  :dura‐
112              tion=5.0 -b texture
113

AUTHOR

115       glmark2-wayland  was  written  by  Alexandros Frantzis and Jesse Barker
116       based on the original glmark by Ben Smith.
117
118
119
120glmark2-wayland 2017.07            July 2017                        GLMARK2(1)