NAME

waffle - 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.

AUTHOR

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

Maintainer

COPYRIGHT

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

http://www.waffle-gl.org

5.: examples

https://gitlab.freedesktop.org/mesa/waffle/tree/master/examples