waffle - Man Page

a library for selecting an OpenGL API and window system at runtime

Synopsis

#include <waffle.h>

Link with -lwaffle-1.

Description

Waffle is a cross-platform library that allows one to defer selection of an OpenGL API and of window system until runtime. 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 combinations.

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. A future goal 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.

waffle[4]'s website.

Examples

Your distribution should have installed example source code that demonstrates how to use waffle at /usr/share/doc/waffle-${version}/examples. You can also find examples[5] in Waffle's source repository.

Issues

Please report bugs or and feature requests to https://gitlab.freedesktop.org/mesa/waffle/issues.

See Also

Author

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

Former maintainer

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

Info

07/23/2026 Waffle Manual