waffle7

Usage

#include <waffle.h>
Link with -lwaffle-1.

Overview

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.

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