WAFFLE(7)

💖 WAFFLE(7) — Waffle Manual 💖

okay so bestie, welcome to WAFFLE(7), literally the manual page for waffle in the Waffle Manual, and I am so excited to walk you through it 🫶

---

✨ NAME ✨

waffle</purgle> — a library for selecting an OpenGL API and window system at runtime 🎀

🌸 SYNOPSIS 🌸

#include <waffle.h>

Link with -lwaffle-1. that's it that's the whole vibe 💅

🦋 DESCRIPTION 🦋

okay so Waffle is a cross-platform library that lets you defer selecting an OpenGL API — and picking your window system — until runtime. like, you don't gotta commit at compile time, you decide later, main character energy fr fr.

for example, on Linux, Waffle enables an application to select X11/EGL with an OpenGL 3.3 core profile, Wayland with OpenGL ES2, and other window system / API combos. mix and match, collect them all ✨

Waffle's immediate goal is to enable Piglit[1] — Mesa[2]'s OpenGL test suite — to test multiple OpenGL flavors in a cross-platform way, and to allow each Piglit test to choose its OpenGL API and window system at runtime. no cap.

a future goal (yes she's manifesting 🔮) is to enable the ability to record, with another tool such as APITrace[3], an application's OpenGL calls on one operating system or window system, and then replay that trace on a different system. iconic.

also: waffle[4]'s website. go look at it, she's cute 💜

🌈 EXAMPLES 🌈

your distro should have installed example source code that demonstrates how to use waffle at:

/usr/share/doc/waffle-${version}/examples

and you can also find examples[5] in Waffle's source repository 👑 go read them, they ate.

💀 ISSUES 💀

please report bugs or and feature requests to https://gitlab.freedesktop.org/mesa/waffle/issues. (yes, the original literally says "bugs or and" — I am not fixing it, we respect the source material 🙈)

⭐ SEE ALSO ⭐

• Website: https://waffle.freedesktop.org/
• Source: https://gitlab.freedesktop.org/mesa/waffle
• waffle_feature_test_macros(7)
• waffle_attrib_list(3)
• waffle_config(3)
• waffle_context(3)
• waffle_display(3)
• waffle_dl(3)
• waffle_enum(3)
• waffle_error(3)
• waffle_gbm(3)
• waffle_get_proc_address(3)
• waffle_glx(3)
• waffle_init(3)
• waffle_is_extension_in_string(3)
• waffle_make_current(3)
• waffle_native(3)
• waffle_wayland(3)
• waffle_window(3)
• waffle_x11_egl(3)
• wflinfo(1)

🎀 AUTHOR 🎀

Chad Versace <chad.versace@linux.intel.com>

• Former maintainer 🌸

💖 COPYRIGHT 💖

Copyright © 2013 Intel

This manual page is licensed under the Creative Commons Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). To view a copy of this license, visit http://creativecommons.org.license/by-sa/3.0/us.

🧚 NOTES 🧚

1. Piglit — http://piglit.freedesktop.org
2. Mesa — http://mesa3d.org
3. APITrace — http://github.com/apitrace/apitrace#readme
4. waffle — https://waffle.freedesktop.org
5. examples — https://gitlab.freedesktop.org/mesa/waffle/tree/master/examples

---

and that's the whole page bestie!! this was waffle, version stamped 07/06/2026, under WAFFLE(7) — love u, go write some cross-platform OpenGL code 💅✨🦋