# panda3d-complexpbr
complexpbr is an IBL (Image-Based Lighting) rendering module which supports real-time reflections and post-processing effects in Panda3D. complexpbr supports realtime environment reflections for BSDF materials (the industry standard). Your machine must support GLSL version 430 or higher. Sample screenshots and minimum usage examples below.
Featuring support for vertex displacement mapping, SSAO (Screen Space Ambient Occlusion), HSV color correction, Bloom, and Sobel based antialiasing in a screenspace kernel shader, which approximates temporal antialiasing. complexpbr.screenspace_init() automatically enables the AA, SSAO, and HSV color correction. To use the vertex displacement mapping, provide your displacement map as a shader input to your respective model node -- example below in the Usage section.
By default, the environment reflections dynamically track the camera view. You may set a custom position with the 'env_cam_pos' apply_shader() input variable to IE fix the view to a skybox somewhere on the scene graph. This env_cam_pos variable can be updated live afterwards by setting base.env_cam_pos = Vec3(some_pos). The option to disable or re-enable dynamic reflections is available.
The goal of this project is to provide extremely easy to use scene shaders to expose the full functionality of Panda3D rendering, including interoperation with CommonFilters and setting shaders on a per-node basis.
10/30/23 Project Naer ([Project Naer complexpbr](https://github.com/rayanalysis/project-naer-complexpbr))
7/6/23 Lumberyard Bistro ([Amazon Lumberyard Bistro | NVIDIA Developer](https://developer.nvidia.com/orca/amazon-lumberyard-bistro))
6/1/23 Sponza ([Intel GPU Research Samples](https://www.intel.com/content/www/us/en/developer/topic-technology/graphics-research/samples.html))
## Minimal Usage:
```python
from direct.showbase.ShowBase import ShowBase
from panda3d.core import *
import complexpbr
class main(ShowBase):
def __init__(self):
super().__init__()
complexpbr.apply_shader(self.render)
# complexpbr.screenspace_init() # optional, starts the screenspace effects
app = main()
app.run()
```
## Expanded Usage:
```python
from direct.showbase.ShowBase import ShowBase
import complexpbr
class main(ShowBase):
def __init__(self):
super().__init__()
# apply a scene shader with PBR IBL
# node can be base.render or any model node, intensity is the desired AO
# (ambient occlusion reflection) intensity (float, 0.0 to 1.0)
# you may wish to define a specific position in your scene where the
# cube map is rendered from, to IE have multiple skyboxes preloaded
# somewhere on the scene graph and have their reflections map to your
# models -- to achieve this, set env_cam_pos=Vec3(your_pos)
# you may set base.env_cam_pos after this, and it will update in realtime
# env_res is the cube map resolution, can only be set once upon first call
complexpbr.apply_shader(self.render)
# complexpbr.screenspace_init() # optional, starts the screenspace effects
# apply_shader() with optional inputs
# complexpbr.apply_shader(self.render, intensity=0.9, env_cam_pos=None, env_res=256, lut_fill=[1.0,0.0,0.0], custom_dir='shaders/')
# initialize complexpbr's screenspace effects (SSAO, SSR, AA, HSV color correction)
# this replaces CommonFilters functionality
complexpbr.screenspace_init()
# make the cubemap rendering static (performance boost)
complexpbr.set_cubebuff_inactive()
# make the cubemap rendering dynamic (this is the default state)
complexpbr.set_cubebuff_active()
# adjustment factors for the cubemap rendering height (as of version 0.5.5)
base.complexpbr_map_z = 2.1 # manual additive/subtractive factor on the rendering height
# automatically adjust the environment reflections such that they
# update relative to the base.cam position during movement
base.complexpbr_z_tracking = True # defaults to False
# clean up the shader files (not recommended for distributable builds)
# complexpbr.remove_shader_files()
# example of how to apply hardware skinning
fp_character = actor_data.player_character # this is an Actor() model
fp_character.reparent_to(self.render)
fp_character.set_scale(1)
# set hardware skinning for the Actor()
complexpbr.skin(fp_character)
# example of how to use the vertex displacement mapping
wood_sphere_3 = loader.load_model('assets/models/wood_sphere_3.gltf')
wood_sphere_3.reparent_to(base.render)
wood_sphere_3.set_pos(0,0,1)
dis_tex = Texture()
dis_tex.read('assets/textures/WoodFloor057_2K-PNG/WoodFloor057_2K_Displacement.png')
wood_sphere_3.set_shader_input('displacement_map', dis_tex)
wood_sphere_3.set_shader_input('displacement_scale', 0.1)
# example of how to use the shader composition functionality
complexpbr.apply_shader(test_sphere) # example sphere model
# call the append_shader() function, you may modify just 1 or all of the 4 shader files
custom_body_mod = 'float default_noise(vec2 n)\n{\nfloat n2 = fract(sin(dot(n.xy,vec2(11.78,77.443)))*44372.7263);\nreturn n2;\n}'
custom_main_mod = 'o_color += default_noise(vec2(2.3,3.3));'
custom_vert_body_mod = 'float default_noise(vec2 n)\n{\nreturn n[0];\n}'
custom_vert_main_mod = 'float whatever = default_noise(vec2(2.3,3.3));'
complexpbr.append_shader(test_sphere, custom_body_mod, custom_main_mod, custom_vert_body_mod, custom_vert_main_mod)
# example of how to turn on Global Illumination (GI)
self.main_bridge_tunnel.set_shader_input('shadow_boost', 0.3) # increases intrinsic brightness of a tunnel model
# example of how to specify a custom shader directory (you must have created the folder first)
complexpbr.apply_shader(self.render, custom_dir='shaders/')
# example of how to set up bloom -- complexpbr.screenspace_init() must have been called first
screen_quad = base.screen_quad
bloom_intensity = 5.0 # bloom defaults to 0.0 / off
bloom_blur_width = 10
bloom_samples = 6
bloom_threshold = 0.7
screen_quad.set_shader_input("bloom_intensity", bloom_intensity)
screen_quad.set_shader_input("bloom_threshold", bloom_threshold)
screen_quad.set_shader_input("bloom_blur_width", bloom_blur_width)
screen_quad.set_shader_input("bloom_samples", bloom_samples)
# example of how to customize SSR
ssr_intensity = 0.5
ssr_step = 4.0
ssr_fresnel_pow = 3.0
ssr_samples = 128 # ssr_samples defaults to 0 / off
screen_quad.set_shader_input("ssr_intensity", ssr_intensity)
screen_quad.set_shader_input("ssr_step", ssr_step)
screen_quad.set_shader_input("ssr_fresnel_pow", ssr_fresnel_pow)
screen_quad.set_shader_input("ssr_samples", ssr_samples)
# example of how to customize SSAO
ssao_samples = 32 # ssao_samples defaults to 8
screen_quad.set_shader_input("ssao_samples", ssao_samples)
# example of how to HSV adjust the final image
screen_quad.set_shader_input("hsv_g", 1.3) # hsv_g (saturation factor) defaults to 1.0
# example of how to modify the specular contribution
self.render.set_shader_input("specular_factor", 10.0) # the specular_factor defaults to 1.0
# example of how to directly fill your BRDF LUT texture instead of providing one in your game folder
complexpbr.apply_shader(base.render, 1.0, env_res=1024, lut_fill=[1.0,0.0,0.0]) # lut_fill=[red, green, blue]
# if complexpbr.screenspace_init() has not been called, you may use CommonFilters
# scene_filters = CommonFilters(base.win, base.cam)
# scene_filters.set_bloom(size='medium')
# scene_filters.set_exposure_adjust(1.1)
# scene_filters.set_gamma_adjust(1.1)
# scene_filters.set_blur_sharpen(0.9)
```
## Installing with PyPI:
```bash
pip install panda3d-complexpbr
```
## Building:
The module may be built using build.
```bash
python -m build
```
```bash
pip install 'path/to/panda3d-complexpbr.whl'
```
## Relase Notes:
As of version 0.5.2, complexpbr will default to a dummy BRDF LUT which it creates on the fly. complexpbr will remind you that you may create a custom BRDF LUT with the provided 'brdf_lut_calculator.py' script or copy the sample one provided. This feature is automatic, so if you provide the output_brdf_lut.png file in your program directory, it will default to that .png image ignoring the lut_fill input. The sample 'output_brdf_lut.png' and the creation script can be found in the panda3d-complexpbr git repo. For advanced users there is an option to set the LUT image RGB fill values via apply_shader(lut_fill=[r,g,b]) . See Usage section for an example of lut_fill.
As of version 0.5.3, hardware skinning support is provided via complexpbr.skin(your_actor) for models with skeletal animations. See Usage section for an example of hardware skinning.
As of version 0.5.4, panda3d-complexpbr may be considered mature and ready for production use. complexpbr will endeavor to continue supporting CommonFilters, which is still receiving some contemporary updates. complexpbr is still open to pull requests, feature requests, and so forth to continue expanding the filtering capabilities of screenspace_init() within reason.
As of version 0.5.6, dynamic environmental Z-tracking functionality has been expanded, and a function has been added to optionally clean up the created shader files.
As of version 0.5.7, shader composition functionality has been expanded. Using "append_shader()", you may provide custom model-level fragment shader functions and modifications to the main loop.
As of version 0.5.8, an approximation of Global Illumination (GI) is provided via the "shadow_boost" (float) shader input. This feature allows node level objects to partially self-illuminate to remain visible all around even when shadowed. Secondly, you may now specify a custom directory for complexpbr-generated shader files, IE complexpbr.apply_shader(..., custom_dir='shaders/') . Thirdly, a default lighting setup is provided as an option to apply_shader(..., default_lighting=True) . Lastly, the node-level vertex shader is now available for modification using "append_shader()".
## Requirements:
- panda3d
6/1/23 Sponza ([Intel GPU Research Samples](https://www.intel.com/content/www/us/en/developer/topic-technology/graphics-research/samples.html))
Vertex Displacement Mapping:
Raw data
{
"_id": null,
"home_page": null,
"name": "panda3d-complexpbr",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "panda3d, gamedev, pbr, IBL, real-time",
"author": "Logan Bier",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/45/d9/7aef1b18e7e4797721e9fc9b472a1772ce5c799913c9d7c9f08cf68d6cb8/panda3d_complexpbr-0.5.9.tar.gz",
"platform": null,
"description": "# panda3d-complexpbr\ncomplexpbr is an IBL (Image-Based Lighting) rendering module which supports real-time reflections and post-processing effects in Panda3D. complexpbr supports realtime environment reflections for BSDF materials (the industry standard). Your machine must support GLSL version 430 or higher. Sample screenshots and minimum usage examples below.\n\nFeaturing support for vertex displacement mapping, SSAO (Screen Space Ambient Occlusion), HSV color correction, Bloom, and Sobel based antialiasing in a screenspace kernel shader, which approximates temporal antialiasing. complexpbr.screenspace_init() automatically enables the AA, SSAO, and HSV color correction. To use the vertex displacement mapping, provide your displacement map as a shader input to your respective model node -- example below in the Usage section.\n\nBy default, the environment reflections dynamically track the camera view. You may set a custom position with the 'env_cam_pos' apply_shader() input variable to IE fix the view to a skybox somewhere on the scene graph. This env_cam_pos variable can be updated live afterwards by setting base.env_cam_pos = Vec3(some_pos). The option to disable or re-enable dynamic reflections is available. \n\nThe goal of this project is to provide extremely easy to use scene shaders to expose the full functionality of Panda3D rendering, including interoperation with CommonFilters and setting shaders on a per-node basis.\n\n\n \n\n\n10/30/23 Project Naer ([Project Naer complexpbr](https://github.com/rayanalysis/project-naer-complexpbr))\n\n\n\n\n\n7/6/23 Lumberyard Bistro ([Amazon Lumberyard Bistro | NVIDIA Developer](https://developer.nvidia.com/orca/amazon-lumberyard-bistro))\n\n\n\n\n\n\n\n6/1/23 Sponza ([Intel GPU Research Samples](https://www.intel.com/content/www/us/en/developer/topic-technology/graphics-research/samples.html))\n\n\n\n## Minimal Usage:\n```python\nfrom direct.showbase.ShowBase import ShowBase\nfrom panda3d.core import *\nimport complexpbr\n\nclass main(ShowBase):\n def __init__(self):\n super().__init__()\n\n complexpbr.apply_shader(self.render)\n # complexpbr.screenspace_init() # optional, starts the screenspace effects\n \napp = main()\napp.run()\n```\n\n## Expanded Usage:\n```python\nfrom direct.showbase.ShowBase import ShowBase\nimport complexpbr\n\nclass main(ShowBase):\n def __init__(self):\n super().__init__()\n \n # apply a scene shader with PBR IBL\n # node can be base.render or any model node, intensity is the desired AO\n # (ambient occlusion reflection) intensity (float, 0.0 to 1.0)\n # you may wish to define a specific position in your scene where the \n # cube map is rendered from, to IE have multiple skyboxes preloaded\n # somewhere on the scene graph and have their reflections map to your\n # models -- to achieve this, set env_cam_pos=Vec3(your_pos)\n # you may set base.env_cam_pos after this, and it will update in realtime\n # env_res is the cube map resolution, can only be set once upon first call\n \n complexpbr.apply_shader(self.render)\n # complexpbr.screenspace_init() # optional, starts the screenspace effects\n \n # apply_shader() with optional inputs\n # complexpbr.apply_shader(self.render, intensity=0.9, env_cam_pos=None, env_res=256, lut_fill=[1.0,0.0,0.0], custom_dir='shaders/')\n\n # initialize complexpbr's screenspace effects (SSAO, SSR, AA, HSV color correction)\n # this replaces CommonFilters functionality\n complexpbr.screenspace_init()\n \n # make the cubemap rendering static (performance boost)\n complexpbr.set_cubebuff_inactive()\n \n # make the cubemap rendering dynamic (this is the default state)\n complexpbr.set_cubebuff_active()\n \n # adjustment factors for the cubemap rendering height (as of version 0.5.5)\n base.complexpbr_map_z = 2.1 # manual additive/subtractive factor on the rendering height\n # automatically adjust the environment reflections such that they\n # update relative to the base.cam position during movement\n base.complexpbr_z_tracking = True # defaults to False\n \n # clean up the shader files (not recommended for distributable builds)\n # complexpbr.remove_shader_files()\n\n # example of how to apply hardware skinning\n fp_character = actor_data.player_character # this is an Actor() model\n fp_character.reparent_to(self.render)\n fp_character.set_scale(1)\n # set hardware skinning for the Actor()\n complexpbr.skin(fp_character)\n\n # example of how to use the vertex displacement mapping\n wood_sphere_3 = loader.load_model('assets/models/wood_sphere_3.gltf')\n wood_sphere_3.reparent_to(base.render)\n wood_sphere_3.set_pos(0,0,1)\n dis_tex = Texture()\n dis_tex.read('assets/textures/WoodFloor057_2K-PNG/WoodFloor057_2K_Displacement.png')\n wood_sphere_3.set_shader_input('displacement_map', dis_tex)\n wood_sphere_3.set_shader_input('displacement_scale', 0.1)\n \n # example of how to use the shader composition functionality\n complexpbr.apply_shader(test_sphere) # example sphere model\n # call the append_shader() function, you may modify just 1 or all of the 4 shader files\n custom_body_mod = 'float default_noise(vec2 n)\\n{\\nfloat n2 = fract(sin(dot(n.xy,vec2(11.78,77.443)))*44372.7263);\\nreturn n2;\\n}'\n custom_main_mod = 'o_color += default_noise(vec2(2.3,3.3));'\n custom_vert_body_mod = 'float default_noise(vec2 n)\\n{\\nreturn n[0];\\n}'\n custom_vert_main_mod = 'float whatever = default_noise(vec2(2.3,3.3));'\n complexpbr.append_shader(test_sphere, custom_body_mod, custom_main_mod, custom_vert_body_mod, custom_vert_main_mod)\n\n # example of how to turn on Global Illumination (GI)\n self.main_bridge_tunnel.set_shader_input('shadow_boost', 0.3) # increases intrinsic brightness of a tunnel model\n\n # example of how to specify a custom shader directory (you must have created the folder first)\n complexpbr.apply_shader(self.render, custom_dir='shaders/')\n\n # example of how to set up bloom -- complexpbr.screenspace_init() must have been called first\n screen_quad = base.screen_quad\n \n bloom_intensity = 5.0 # bloom defaults to 0.0 / off\n bloom_blur_width = 10\n bloom_samples = 6\n bloom_threshold = 0.7\n\n screen_quad.set_shader_input(\"bloom_intensity\", bloom_intensity)\n screen_quad.set_shader_input(\"bloom_threshold\", bloom_threshold)\n screen_quad.set_shader_input(\"bloom_blur_width\", bloom_blur_width)\n screen_quad.set_shader_input(\"bloom_samples\", bloom_samples)\n \n # example of how to customize SSR\n ssr_intensity = 0.5 \n ssr_step = 4.0\n ssr_fresnel_pow = 3.0\n ssr_samples = 128 # ssr_samples defaults to 0 / off\n \n screen_quad.set_shader_input(\"ssr_intensity\", ssr_intensity)\n screen_quad.set_shader_input(\"ssr_step\", ssr_step)\n screen_quad.set_shader_input(\"ssr_fresnel_pow\", ssr_fresnel_pow)\n screen_quad.set_shader_input(\"ssr_samples\", ssr_samples)\n \n # example of how to customize SSAO\n ssao_samples = 32 # ssao_samples defaults to 8\n \n screen_quad.set_shader_input(\"ssao_samples\", ssao_samples)\n \n # example of how to HSV adjust the final image\n screen_quad.set_shader_input(\"hsv_g\", 1.3) # hsv_g (saturation factor) defaults to 1.0\n \n # example of how to modify the specular contribution\n self.render.set_shader_input(\"specular_factor\", 10.0) # the specular_factor defaults to 1.0\n \n # example of how to directly fill your BRDF LUT texture instead of providing one in your game folder\n complexpbr.apply_shader(base.render, 1.0, env_res=1024, lut_fill=[1.0,0.0,0.0]) # lut_fill=[red, green, blue]\n \n # if complexpbr.screenspace_init() has not been called, you may use CommonFilters\n # scene_filters = CommonFilters(base.win, base.cam)\n # scene_filters.set_bloom(size='medium')\n # scene_filters.set_exposure_adjust(1.1)\n # scene_filters.set_gamma_adjust(1.1)\n # scene_filters.set_blur_sharpen(0.9)\n```\n## Installing with PyPI:\n```bash\npip install panda3d-complexpbr\n```\n\n## Building:\nThe module may be built using build. \n```bash\npython -m build\n```\n```bash\npip install 'path/to/panda3d-complexpbr.whl'\n```\n\n## Relase Notes:\nAs of version 0.5.2, complexpbr will default to a dummy BRDF LUT which it creates on the fly. complexpbr will remind you that you may create a custom BRDF LUT with the provided 'brdf_lut_calculator.py' script or copy the sample one provided. This feature is automatic, so if you provide the output_brdf_lut.png file in your program directory, it will default to that .png image ignoring the lut_fill input. The sample 'output_brdf_lut.png' and the creation script can be found in the panda3d-complexpbr git repo. For advanced users there is an option to set the LUT image RGB fill values via apply_shader(lut_fill=[r,g,b]) . See Usage section for an example of lut_fill.\n\nAs of version 0.5.3, hardware skinning support is provided via complexpbr.skin(your_actor) for models with skeletal animations. See Usage section for an example of hardware skinning.\n\nAs of version 0.5.4, panda3d-complexpbr may be considered mature and ready for production use. complexpbr will endeavor to continue supporting CommonFilters, which is still receiving some contemporary updates. complexpbr is still open to pull requests, feature requests, and so forth to continue expanding the filtering capabilities of screenspace_init() within reason.\n\nAs of version 0.5.6, dynamic environmental Z-tracking functionality has been expanded, and a function has been added to optionally clean up the created shader files.\n\nAs of version 0.5.7, shader composition functionality has been expanded. Using \"append_shader()\", you may provide custom model-level fragment shader functions and modifications to the main loop.\n\nAs of version 0.5.8, an approximation of Global Illumination (GI) is provided via the \"shadow_boost\" (float) shader input. This feature allows node level objects to partially self-illuminate to remain visible all around even when shadowed. Secondly, you may now specify a custom directory for complexpbr-generated shader files, IE complexpbr.apply_shader(..., custom_dir='shaders/') . Thirdly, a default lighting setup is provided as an option to apply_shader(..., default_lighting=True) . Lastly, the node-level vertex shader is now available for modification using \"append_shader()\".\n\n## Requirements:\n\n- panda3d\n\n\n6/1/23 Sponza ([Intel GPU Research Samples](https://www.intel.com/content/www/us/en/developer/topic-technology/graphics-research/samples.html))\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nVertex Displacement Mapping:\n\n\n\n",
"bugtrack_url": null,
"license": "BSD-3-Clause",
"summary": "IBL rendering module supporting real-time reflections and post-processing effects in Panda3D",
"version": "0.5.9",
"project_urls": {
"homepage": "https://github.com/rayanalysis/panda3d-complexpbr"
},
"split_keywords": [
"panda3d",
" gamedev",
" pbr",
" ibl",
" real-time"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "22a1ddfcdadbb7563e7cd5847aaebeed8cea6669bcb0c4325e7e0b7844fe2b3d",
"md5": "4212df50659b3e2d7f401204de5aeb57",
"sha256": "f7b2c249e0b4ee9cb5ad81b4d49179f30089f4a647c7a0d5da7f8d66743fb698"
},
"downloads": -1,
"filename": "panda3d_complexpbr-0.5.9-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4212df50659b3e2d7f401204de5aeb57",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 303811,
"upload_time": "2024-11-11T06:30:37",
"upload_time_iso_8601": "2024-11-11T06:30:37.907060Z",
"url": "https://files.pythonhosted.org/packages/22/a1/ddfcdadbb7563e7cd5847aaebeed8cea6669bcb0c4325e7e0b7844fe2b3d/panda3d_complexpbr-0.5.9-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "45d97aef1b18e7e4797721e9fc9b472a1772ce5c799913c9d7c9f08cf68d6cb8",
"md5": "7be688d6d8d9d1442d681b3518255be8",
"sha256": "57a702e6e80222e46c91d260c2e06827ca87a61a0ba8ff62cf24950872069759"
},
"downloads": -1,
"filename": "panda3d_complexpbr-0.5.9.tar.gz",
"has_sig": false,
"md5_digest": "7be688d6d8d9d1442d681b3518255be8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 308318,
"upload_time": "2024-11-11T06:30:40",
"upload_time_iso_8601": "2024-11-11T06:30:40.195429Z",
"url": "https://files.pythonhosted.org/packages/45/d9/7aef1b18e7e4797721e9fc9b472a1772ce5c799913c9d7c9f08cf68d6cb8/panda3d_complexpbr-0.5.9.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-11 06:30:40",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "rayanalysis",
"github_project": "panda3d-complexpbr",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "panda3d-complexpbr"
}
JSON
