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       --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  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, a benchmark is defined as a scene plus a set of option val‐
80       ues.  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

EXAMPLES

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

AUTHOR

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