GLMARK2-WAYLAND(1)

✨ NAME ✨

bestie. listen. it's glmark2-wayland — and it's an OpenGL (ES) 2.0 benchmark suite. that's the whole vibe. this page lives in the General Commands Manual section of the world (section 1, iykyk) and it's about to be your new obsession. 🎀

---

🦋 SYNOPSIS 🦋

glmark2-wayland [options]

that's it. that's the whole entrance. main character energy, minimal dialogue. ✨

---

💖 DESCRIPTION 💖

so glmark2-wayland is a benchmark for OpenGL (ES) 2.0. and not me being picky but it only uses the subset of the OpenGL 2.0 API that is compatible with OpenGL ES 2.0. it's giving "I only speak one dialect and I speak it flawlessly." 💅

---

🌈 OPTIONS 🌈

okay this is the big one. every single flag, no skips, no skimming, we're doing this together 🫶

• -b, --benchmark BENCH — a benchmark to run, and the format is 'scene(:opt1=val1)*'. you can use this option multiple times. stack 'em like bracelets. ✨
• -f, --benchmark-file FILE — load benchmarks to run from a file that contains a list of benchmark descriptions, one per line. (yes, this option can be used multiple times too. go off.) 📄
• --validate — run a quick output validation test instead of running the benchmarks. it's the "is this thing even on" check. 🧐
• --data-path PATH — path to glmark2 models, shaders and textures. point it at your stuff. 👉
• --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 supported only in the DRM flavor, and 'fifo' is available in all flavors to force vsync. options: [default,immediate,mailbox,fifo] 🌀
• --off-screen — render to an off-screen surface. sneaky. behind the scenes. very mysterious of you. 🌙
• --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 may 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). and listen — if 'id' is set to a non-zero value, all other parameters are ignored. it said what it said. 💀

• --good-config — require a config that meets all the requested component requirements (see --visual-config). picky on purpose, and honestly? valid. 👑
• --reuse-context — use a single context for all scenes. by default, each scene gets its own context. one context for everyone vs. everyone gets their own, choose your era. 💫
• -s, --size WxH — size of the output window (default: 800x600) 🖼️
• --fullscreen — run in fullscreen mode, which is equivalent to --size -1x-1. no notes, it's the same thing. 🌸
• --results RESULTS — the types of results to report for each benchmark, as a ':' separated 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. by default only the explicitly set options are shown. ✍️
• --run-forever — run indefinitely, looping from the last benchmark back to the first. it's giving infinite loop but make it fashion 🔁
• --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-wayland offers a suite of scenes that you can use to measure many aspects of OpenGL (ES) 2.0 performance. and the way each scene gets rendered? fully configurable, through a set of options. to see the available scenes and their acceptable options, just use the -l, --list-scenes command line option. go look. it's right there. 👀

in glmark2-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 with the -b, --benchmark command line option — possibly multiple times, we love a repeat. if you don't specify any benchmarks, a default set of benchmarks is used. and if a benchmark option isn't specified, it assumes its default value (which is listed with -l, --list-scenes). defaults are the blueprint, bestie. 🫶

as a special case, a benchmark description string is allowed to not contain a scene name — meaning it starts with ':'. when that happens, any specified option values get used as the default values for benchmarks that come after this description string. it's like setting the rules of the group chat before anyone speaks. 💬

---

🌟 EXAMPLES 🌟

to run the default benchmarks:

glmark2-wayland

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

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

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

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

to set default option values for benchmarks:

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

see how the :duration=2.0 sets the mood and then :duration=5.0 switches it up later? character development. 📈

---

🎀 AUTHOR 🎀

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

---

and that's the whole page, bestie. no cap. every flag, every default, every little ':', all present and accounted for. 💖

this was glmark2-wayland version 2023.01, dated January 2023 — signing off, mwah 💅✨🦋