Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
GLMARK2(1)		    General Commands Manual		    GLMARK2(1)

NAME
       glmark2 - OpenGL	(ES) 2.0 benchmark suite

SYNOPSIS
       glmark2 [options]

DESCRIPTION
       glmark2	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.

OPTIONS
       -b, --benchmark BENCH
	      A	benchmark to run: 'scene(:opt1=val1)*' (the option can be used
	      multiple times)

       -f, --benchmark-file FILE
	      Load benchmarks to run from a file containing a list  of	bench-
	      mark  descriptions (one per line)	(the option can	be used	multi-
	      ple times)

       --validate
	      Run a quick output validation test instead of running the	bench-
	      marks

       --data-path PATH
	      Path to glmark2 models, shaders and textures

       --frame-end METHOD
	      How to end a frame [default,none,swap,finish,readpixels]

       --swap-mode MODE
	      How to swap a frame, all modes supported only in the DRM flavor,
	      'fifo' available in all flavors to force vsync  [default,immedi-
	      ate,mailbox,fifo]

       --off-screen
	      Render to	an off-screen surface

       --visual-config
	      The  visual  configuration  to  use  for	the  rendering target:
	      'id=ID:red=R:green=G:blue=B:alpha=A:buffer=BUF:stencil=STEN-
	      CIL:samples=SAMPLES'.  The parameters may	be defined in any  or-
	      der,  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 ig-
	      nored

       --reuse-context
	      Use a single context for all scenes (by default, each scene gets
	      its own context)

       -s, --size WxH
	      Size of the output window	(default: 800x600)

       --fullscreen
	      Run in fullscreen	mode (equivalent to --size -1x-1)

       --results RESULTS
	      The types	of results to report for each benchmark, as a ':' sep-
	      arated list [fps,cpu,shader]

       --results-file RESULTS-FILE
	      The file to save the results to, in the format determined	by the
	      file extension [csv,xml]

       --winsys-options	OPTS
	      A	list of	'opt=value' pairs for window system specific  options,
	      separated	by ':'

       -l, --list-scenes
	      Display information about	the available scenes and their options

       --show-all-options
	      Show  all	 scene option values used for benchmarks (only explic-
	      itly set options are shown by default)

       --run-forever
	      Run indefinitely,	looping	from the last benchmark	 back  to  the
	      first

       --annotate
	      Annotate	the  benchmarks	with on-screen information (same as -b
	      :show-fps=true:title=#info#)

       -d, --debug
	      Display debug messages

       --version
	      Display program version

       -h, --help
	      Display help

BENCHMARKS
       glmark2 offers a	suite of scenes	that can be used to measure  many  as-
       pects  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  -l,	 --list-scenes
       command line option.

       In glmark2, a benchmark is defined as a scene plus a set	of option val-
       ues.   You  can	specify	the list and order of the benchmarks to	run by
       using the  -b,  --benchmark  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 -l, --list-scenes).

       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	speci-
       fied  option  values are	used as	the default values for benchmarks fol-
       lowing this description string.

EXAMPLES
       To run the default benchmarks:

	      glmark2

       To run a	benchmark using	scene 'shading'	with  a	 'duration'  of	 '5.0'
       seconds and
	'shading' of type 'phong':

	      glmark2 -b shading:duration=5.0:shading=phong

       To  run a series	of benchmarks use the -b, --benchmark command line op-
       tion multiple times:

	      glmark2 -b shading:duration=5.0 -b build:use-vbo=false  -b  tex-
	      ture

       To set default option values for	benchmarks:

	      glmark2 -b :duration=2.0 -b shading -b build -b :duration=5.0 -b
	      texture

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

glmark2	2023.01			 January 2023			    GLMARK2(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=glmark2&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help