GLMARK2-ES2-WAYLAND(1)

💖 glmark2-es2-wayland 💖

okay bestie, so this is the manual page for glmark2-es2-wayland, which lives in section 1 of the general commands manual (you know, the "type it in a terminal" section 🫶). It's a whole benchmark suite situation and honestly? she's iconic.

---

✨ NAME ✨

glmark2-es2-wayland — an OpenGL (ES) 2.0 benchmark suite. that's the whole name, that's the whole vibe. 🌸

---

🎀 SYNOPSIS 🎀

glmark2-es2-wayland [options]

literally just the command and whatever options you wanna throw at her. periodt.

---

🦋 DESCRIPTION 🦋

so glmark2-es2-wayland is a benchmark for OpenGL (ES) 2.0. the way she works is she only uses the subset of the OpenGL 2.0 API that's compatible with OpenGL ES 2.0. no cap. that's her whole thing, and she does it flawlessly 💅

---

👑 OPTIONS 👑

here's every single flag, bestie. i'm not skipping a single one, i would never do that to you.

• -b, --benchmark BENCH — the benchmark you wanna run, formatted like 'scene(:opt1=val1)*'. yes you can use this option multiple times. stack 'em up 🧚
• -f, --benchmark-file FILE — load your benchmarks from a file instead, where the file has a list of benchmark descriptions, one per line. also usable multiple times.
• --validate — run a quick output validation test instead of actually running the benchmarks. it's giving "vibe check but for your output" ✨
• --data-path PATH — the path to glmark2's models, shaders and textures. show her where the stuff lives 🍓
• --frame-end METHOD — how to end a frame. options are [default,none,swap,finish,readpixels]
• --swap-mode MODE — how to swap a frame. heads up: all modes are only supported in the DRM flavor, except 'fifo' which is available in all flavors to force vsync. options are [default,immediate,mailbox,fifo]
• --off-screen — render to an off-screen surface. she's mysterious like that 🙈
• --visual-config — 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 can be defined in any order, and any omitted parameters assume a default value of '0' (id, samples), -1 (stencil) or '1' (red, green, blue, alpha, buffer). ⚠️ if 'id' is set to a non-zero value, all other parameters are ignored. like, completely. bye.
• --good-config — require a config that meets all the requested component requirements (peep --visual-config for those)
• --reuse-context — use a single context for all scenes. by default, each scene gets its own context, so this is the "share the aux cord" setting 🎧
• -s, --size WxH — size of the output window. default is 800x600 💖
• --fullscreen — run in fullscreen mode. this is equivalent to --size -1x-1, main character energy fr fr 👑
• --results RESULTS — the types of results to report for each benchmark, as a ':' separated list. options are [fps,cpu,shader]
• --results-file RESULTS-FILE — the file to save the results to. the format is determined by the file extension. options are [csv,xml]
• --winsys-options OPTS — a list of 'opt=value' pairs for window system specific options, separated by ':'
• -l, --list-scenes — display info about the available scenes and their options. this is your bestie when you're lost 🫶
• --show-all-options — show all scene option values used for benchmarks. by default only explicitly set options are shown, so this is the full tea ☕
• --run-forever — run indefinitely, looping from the last benchmark back to the first. she's in it for the long haul 😭
• --annotate — annotate the benchmarks with on-screen information. same as -b :show-fps=true:title=#info#
• -d, --debug — display debug messages. for when you need the receipts 🔍
• --version — display program version
• -h, --help — display help

---

🌈 BENCHMARKS 🌈

so glmark2-es2-wayland offers a whole 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 -l, --list-scenes command line option. go look, she'll tell you everything 💅

in glmark2-es2-wayland, 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 -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 specified option values are used as the default values for benchmarks following this description string. it's giving "set the defaults for everything after me" ✨

---

🎀 EXAMPLES 🎀

to run the default benchmarks:

glmark2-es2-wayland

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

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

to run a series of benchmarks, use the -b, --benchmark command line option multiple times:

glmark2-es2-wayland -b shading:duration=5.0 -b build:use-vbo=false -b texture

to set default option values for benchmarks:

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

---

💜 AUTHOR 💜

glmark2-es2-wayland was written by Alexandros Frantzis and Jesse Barker, based on the original glmark by Ben Smith. legends, all of them. we stan 🫶👑

---

okay that's the whole page bestie, you're officially a glmark2-es2-wayland expert now. go benchmark something and slay 💅✨

and a lil sign-off for the credits at the bottom: this is glmark2-es2-wayland version 2023.01, dated January 2023. that's the era, that's the moment, that's the whole legacy 🌸💖🦋