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

NAME

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

SYNOPSIS

9       glmark2-es2 [options]
10

DESCRIPTION

12       glmark2-es2 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

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       --off-screen
36              Render to an off-screen surface
37
38       --visual-config
39              The visual  configuration  to  use  for  the  rendering  target:
40              ´red=R:green=G:blue=B:alpha=A:buffer=BUF'. The parameters may be
41              defined in any order, and any omitted parameters  assume  a  de‐
42              fault value of '1'
43
44       --reuse-context
45              Use a single context for all scenes (by default, each scene gets
46              its own context)
47
48       -s, --size WxH
49              Size of the output window (default: 800x600)
50
51       --fullscreen
52              Run in fullscreen mode (equivalent to --size -1x-1)
53
54       -l, --list-scenes
55              Display information about the available scenes and their options
56
57       --show-all-options
58              Show all scene option values used for benchmarks  (only  explic‐
59              itly set options are shown by default)
60
61       --run-forever
62              Run  indefinitely,  looping  from the last benchmark back to the
63              first
64
65       --annotate
66              Annotate the benchmarks with on-screen information (same  as  -b
67              :show-fps=true:title=#info#)
68
69       -d, --debug
70              Display debug messages
71
72       -h, --help
73              Display help
74

BENCHMARKS

76       glmark2-es2  offers  a suite of scenes that can be used to measure many
77       aspects of OpenGL (ES) 2.0 performance. The way in which each scene  is
78       rendered is configurable through a set of options. To get the available
79       scenes and their acceptable options you can use the  -l,  --list-scenes
80       command line option.
81
82       In  glmark2-es2, a benchmark is defined as a scene plus a set of option
83       values.  You can specify the list and order of the benchmarks to run by
84       using  the  -b,  --benchmark  command  line  option  (possibly multiple
85       times).  If no benchmarks are specified, a default set of benchmarks is
86       used.  If  a  benchmark  option is not specified it assumes its default
87       value (listed with -l, --list-scenes).
88
89       As a special case, a benchmark description string  is  allowed  to  not
90       contain a scene name (i.e. to start with ':'). In this case, any speci‐
91       fied option values are used as the default values for  benchmarks  fol‐
92       lowing this description string.
93
94

EXAMPLES

96       To run the default benchmarks:
97
98              glmark2-es2
99
100       To  run  a  benchmark  using scene 'shading' with a 'duration' of '5.0'
101       seconds and
102        'shading' of type 'phong':
103
104              glmark2-es2 -b shading:duration=5.0:shading=phong
105
106       To run a series of benchmarks use the -b, --benchmark command line  op‐
107       tion multiple times:
108
109              glmark2-es2  -b  shading:duration=5.0  -b build:use-vbo=false -b
110              texture
111
112       To set default option values for benchmarks:
113
114              glmark2-es2 -b :duration=2.0  -b  shading  -b  build  -b  :dura‐
115              tion=5.0 -b texture
116

AUTHOR

118       glmark2-es2  was  written by Alexandros Frantzis and Jesse Barker based
119       on the original glmark by Ben Smith.
120
121
122
123glmark2-es2 2021.12              December 2021                  GLMARK2-ES2(1)
Impressum