.TH GLMARK2 "1" "January 2023" "glmark2 2023.01"
.SH NAME
glmark2 \- OpenGL (ES) 2.0 benchmark suite
.SH SYNOPSIS
.B glmark2 [options]
.SH DESCRIPTION
\fBglmark2\fP is a benchmark for OpenGL (ES) 2.0. It only uses the subset of
the OpenGL 2.0 API that is compatible with OpenGL ES 2.0.
.SH OPTIONS
.TP
\fB\-b\fR, \fB\-\-benchmark\fR BENCH
A benchmark to run: 'scene(:opt1=val1)*'
(the option can be used multiple times)
.TP
\fB\-f\fR, \fB\-\-benchmark-file\fR FILE
Load benchmarks to run from a file containing a
list of benchmark descriptions (one per line)
(the option can be used multiple times)
.TP
\fB\-\-validate\fR
Run a quick output validation test instead of
running the benchmarks
.TP
\fB\-\-data-path\fR PATH
Path to glmark2 models, shaders and textures
.TP
\fB\-\-frame-end\fR METHOD
How to end a frame [default,none,swap,finish,readpixels]
.TP
\fB\-\-swap-mode\fR MODE
How to swap a frame, all modes supported only in the DRM flavor, 'fifo'
available in all flavors to force vsync [default,immediate,mailbox,fifo]
.TP
\fB\-\-off-screen\fR
Render to an off-screen surface
.TP
\fB--visual-config\fR
The visual configuration to use for the rendering target:
\'id=ID:red=R:green=G:blue=B:alpha=A:buffer=BUF:stencil=STENCIL:samples=SAMPLES'.
The parameters may be defined in any order, and any omitted parameters assume a
default value of '0' (id, stencil, samples) or '1' (red, green, blue, alpha, buffer).
If 'id' is set to a non-zero value, all other parameters are ignored
.TP
\fB\-\-reuse\-context\fR
Use a single context for all scenes
(by default, each scene gets its own context)
.TP
\fB\-s\fR, \fB\-\-size\fR WxH
Size of the output window (default: 800x600)
.TP
\fB\-\-fullscreen\fR
Run in fullscreen mode (equivalent to --size -1x-1)
.TP
\fB\-\-results\fR RESULTS
The types of results to report for each benchmark, as a ':' separated list [fps,cpu,shader]
.TP
\fB\-\-results-file\fR RESULTS-FILE
The file to save the results to, in the format determined by the file extension [csv,xml]
.TP
\fB\-\-winsys-options\fR OPTS
A list of 'opt=value' pairs for window system specific options, separated by ':'
.TP
\fB\-l\fR, \fB\-\-list\-scenes\fR
Display information about the available scenes
and their options
.TP
\fB\-\-show-all-options\fR
Show all scene option values used for benchmarks
(only explicitly set options are shown by default)
.TP
\fB\-\-run-forever\fR
Run indefinitely, looping from the last benchmark
back to the first
.TP
\fB\-\-annotate\fR
Annotate the benchmarks with on-screen information
(same as -b :show-fps=true:title=#info#)
.TP
\fB\-d\fR, \fB\-\-debug\fR
Display debug messages
.TP
\fB\-\-version\fR
Display program version
.TP
\fB\-h\fR, \fB\-\-help\fR
Display help
.SH BENCHMARKS
glmark2 offers a suite of scenes that can be used to measure many aspects
of OpenGL (ES) 2.0 performance. The way in which each scene is rendered is
configurable through a set of options. To get the available scenes and their
acceptable options you can use the \fB\-l\fR, \fB\-\-list\-scenes\fR command
line option.

In glmark2, a benchmark is defined as a scene plus a set of option values.
You can specify the list and order of the benchmarks to run by using the
\fB\-b\fR, \fB\-\-benchmark\fR command line option (possibly multiple times).
If no benchmarks are specified, a default set of benchmarks is used. If a
benchmark option is not specified it assumes its default value (listed with
\fB\-l\fR, \fB\-\-list\-scenes\fR).

As a special case, a benchmark description string is allowed to not contain a
scene name (i.e. to start with ':'). In this case, any specified option values
are used as the default values for benchmarks following this description
string.

.SH EXAMPLES
To run the default benchmarks:
.PP
.RS
\fBglmark2\fR
.RE
.PP
To run a benchmark using scene 'shading' with a 'duration' of '5.0' seconds and
 'shading' of type 'phong':
.PP
.RS
\fBglmark2 -b shading:duration=5.0:shading=phong\fR
.RE
.PP
To run a series of benchmarks use the \fB\-b\fR, \fB\-\-benchmark\fR command
line option multiple times:
.PP
.RS
\fBglmark2 -b shading:duration=5.0 -b build:use-vbo=false -b texture\fR
.RE
.PP
To set default option values for benchmarks:
.PP
.RS
\fBglmark2 -b :duration=2.0 -b shading -b build -b :duration=5.0 -b texture\fR
.RE
.PP

.SH AUTHOR
glmark2 was written by Alexandros Frantzis and Jesse Barker based on the original
glmark by Ben Smith.