Pugl

Pugl is an API for writing portable and embeddable GUIs. Pugl is not a toolkit or framework, but a minimal portability layer that sets up a drawing context and delivers events.

Compared to other libraries, Pugl is particularly suitable for use in plugins or other loadable modules. There is no implicit context or static data in the library, so it may be statically linked and used multiple times in the same process.

Pugl has a modular design that separates the core library from graphics backends. The core library is graphics agnostic, it implements platform support and depends only on standard system libraries. MacOS, Windows, and X11 are currently supported as platforms.

Graphics backends are separate so that applications only depend on the API that they use. Pugl includes graphics backends for Cairo, OpenGL, and Vulkan. It is also possible to use some other graphics API by implementing a custom backend, or simply accessing the native platform handle for a window.

• Usage
  • Building Against Pugl
• Overview
  • Creating a World
    • Construction
    • Setting Application Data
  • Creating a View
    • Configuring the Frame
    • Embedding
    • Setting an Event Handler
    • Setting View Data
    • Setting a Backend
      • Using Cairo
      • Using OpenGL
      • Using Vulkan
        • Loading Vulkan
        • Linking with Vulkan
        • Creating a Surface
    • Showing the View
  • Handling Events
    • Using the Graphics Context
      • Drawing
      • Cairo Context
      • OpenGL Context
      • Vulkan Context
  • Driving the Event Loop
    • Redrawing
    • Event Dispatching
      • MacOS
      • Windows
      • X11
    • Recursive Event Loops
  • Using Clipboards
    • Drag and Drop
    • Copy and Paste
  • Shutting Down
• Pugl C API
  • Cairo
  • OpenGL
  • Events
  • Status
  • World
  • View
    • Setup
    • Frame
    • Window
    • Graphics
    • Interaction
  • Stub
  • Vulkan