README.md

physically-based-panda

A basic GLSL shading framework for the Panda3D game engine, supporting physically-based rendering (PBR). It will perform well even on integrated GPUs, and is easy to integrate into existing projects.

How to Use

Copy and paste the contents of the repository into the folder of the project and import from python. Instructions about creating assets with PBR materials can be found on this wiki page.

To enable, add the following to your code:

#Imports
from panda3d.core import *
from direct.showbase.ShowBase import ShowBase

import pbp
...

class Game(ShowBase):
    def __init__(self):
        ShowBase.__init__(self)
        self.framework = pbp.ShadingFramework(self.render) # Pass the node to apply the shader to. The shader will also be applied to children

...

game = Game()
game.run()

Features

Current:

• PBR shading: lambert for diffuse, GGX distribution, GGX-Schlick geometry, Smith geometry and Schlick fresnel
• Materials and textures using Panda3D Texture and Material objects (albedo, roughness, metallic): the final value used is the material value multiplied by texture value
• Point and directional lights, using Panda3D PointLights
• Shadows: note that when using point lights and shadow mapping together there may be an error thrown every frame — if this happens either avoid using point lights or disable shadows in the shader
• Fog, using Panda3D Fog objects

Planned:

• Spot lights
• Image based lighting (cubemaps)
• AO (maps/SSAO)
• SSR