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>

Maintainer

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

Referenced By

waffle_attrib_list(3), waffle_config(3), waffle_context(3), waffle_display(3), waffle_dl(3), waffle_enum(3), waffle_error(3), waffle_feature_test_macros(7), 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_teardown(3), waffle_wayland(3), waffle_window(3), waffle_x11_egl(3), wflinfo(1).

07/20/2024 Waffle Manual