glfw 1.5.0

A ctypes-based wrapper for GLFW3.

This module provides Python bindings for GLFW (on GitHub: glfw/glfw). It is a ctypes wrapper which keeps very close to the original GLFW API, except for:

• function names use the pythonic words_with_underscores notation instead of camelCase

• GLFW_ and glfw prefixes have been removed, as their function is replaced by the module namespace

• structs have been replaced with Python sequences

• functions like glfwGetMonitors return a list instead of a pointer and an object count

• Gamma ramps use floats between 0.0 and 1.0 instead of unsigned shorts

• GLFW errors are reported as glfw.GLFWError exceptions if no error callback is set (use glfw.ERROR_REPORTING=False to disable this)

• instead of a sequence for GLFWimage structs, PIL/pillow Image objects can be used

Installation

pyGLFW can be installed using pip:

pip install glfw

To use the module, you also need to install the actual GLFW shared library. Linux and macOS users should compile the library from source (use -DBUILD_SHARED_LIBS=ON) and Windows users can download binaries on the GLFW download site. pyGLFW will search for the library in a list of search paths (including those in LD_LIBRARY_PATH on Linux and DYLD_LIBRARY_PATH on macOS). If you want to use a specific library, you can set the PYGLFW_LIBRARY environment variable to its path.

Example Code

The example from the GLFW documentation ported to pyGLFW:

import glfw

def main():
    # Initialize the library
    if not glfw.init():
        return
    # Create a windowed mode window and its OpenGL context
    window = glfw.create_window(640, 480, "Hello World", None, None)
    if not window:
        glfw.terminate()
        return

    # Make the window's context current
    glfw.make_context_current(window)

    # Loop until the user closes the window
    while not glfw.window_should_close(window):
        # Render here, e.g. using pyOpenGL

        # Swap front and back buffers
        glfw.swap_buffers(window)

        # Poll for and process events
        glfw.poll_events()

    glfw.terminate()

if __name__ == "__main__":
    main()