GLMARK2-ES2-DRM(1)

💖 GLMARK2-ES2-DRM 💖

okay bestie, so this is the manual page for glmark2-es2-drm, living in the General Commands Manual section. It's a whole benchmark suite and she's iconic for it. Let's get into it ✨

---

🌸 NAME 🌸

glmark2-es2-drm — OpenGL (ES) 2.0 benchmark suite 🎀

---

🦋 SYNOPSIS 🦋

glmark2-es2-drm [options]

---

✨ DESCRIPTION ✨

So like, glmark2-es2-drm is a benchmark for OpenGL (ES) 2.0. The way that she's built, she only uses the subset of the OpenGL 2.0 API that's compatible with OpenGL ES 2.0 — no cap, that's the whole vibe. 🫶

---

💅 OPTIONS 💅

okay here come the flags, hydrate before reading, there's a lot and they're all important:

• -b, --benchmark BENCH — a benchmark to run, formatted as 'scene(:opt1=val1)*'. You can use this option multiple times 💖
• -f, --benchmark-file FILE — load benchmarks to run from a file that contains a list of benchmark descriptions, one per line. Also usable multiple times 🌸
• --validate — run a quick output validation test instead of running the benchmarks ⭐
• --data-path PATH — the path to glmark2 models, shaders and textures 📁
• --frame-end METHOD — how to end a frame. options: [default,none,swap,finish,readpixels] 🎀
• --swap-mode MODE — how to swap a frame. 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 🙈
• --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). If 'id' is set to a non-zero value, all other parameters are ignored 👀
• --good-config — require a config that meets all the requested component requirements (see --visual-config) 💜
• --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 ':' separated list. options: [fps,cpu,shader] 📊
• --results-file RESULTS-FILE — the file to save the results to, in the format determined by the file extension. options: [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 explicitly 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-es2-drm 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 -l, --list-scenes command line option. 👑

In glmark2-es2-drm, 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. 🦋

---

🌈 EXAMPLES 🌈

To run the default benchmarks:

glmark2-es2-drm

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

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

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

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

To set default option values for benchmarks:

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

---

🫶 AUTHOR 🫶

glmark2-es2-drm was written by Alexandros Frantzis and Jesse Barker, based on the original glmark by Ben Smith. absolute legends, we love them for it 💜

---

and that's the whole page bestie 💖 this is glmark2-es2-drm version 2023.01, dated January 2023 — go forth and benchmark, you've got this, mwah 💅✨🎀