Skip to main content
2025 Python Packaging Survey is now live!  Take the survey now

Light volume calculation and rendering with OpenGL

Project description

This package provides the module lightvolume, which offers a CFFI binding to trylock/visibility. This, in turn, is a C++ implementation of the visibility algorithm documented in detail (with awesome interactive demos) on the Red Blob Games website.

API

First, import lightvolume:

import lightvolume

Then, we can create a number of shadow-casting bodies:

objects = [
    lightvolume.rect(0, 0, 500, 500),  # outer bounds - this is needed
    lightvolume.rect(20, 30, 10, 20),
    lightvolume.rect(290, 300, 100, 300),
]

Finally, we can render the lit area cast by a light in this scene (an OpenGL context must already have been created and appropriate GL state set):

light = 90, 200
lightvolume.draw_light(light, objects)

This module is intended to be used with appropriate shaders to provide attenuation, surface interactions such as bump mapping, and so on.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page