Archive/portal64-still-alive
1
0
Fork 0
mirror of https://github.com/mwpenny/portal64-still-alive.git synced 2024-10-19 22:27:36 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity
portal64-still-alive/documentation/levels/level_objects/ambient.md
Matt Penny d99af47d09 Document ambient and point light sources
2024-02-19 20:07:31 -05:00

1.2 KiB
Raw Permalink Blame History

@ambient

A 3D box whose vertex colors allow ambient lighting to be calculated for static geometry.

Name structure

@ambient

Notes

Ambient light sources are not used at runtime. Rather, they are used by the tools/bake_lighting.py Blender script to precompute vertex colors for static geometry. This script must be run manually in Blender prior to exporting a level.

Baked colors are chosen for a given vertex by considering the (up to) two closest ambient light sources. The color contribution of each found source is calculated by interpolating between its vertex colors based on the target's position. Finally, the contributions are blended based on each source's distance from the target. Either smooth or flat shading can be used.

In order for an object to receive baked lighting, it must have a mesh whose material has the custom property bakeType set to lit in Blender. The materials in assets/materials/materials.blend are tagged appropriately.

Instead of using this approach, it is also possible to manually assign vertex colors to static geometry using the Col color attribute layer. Ambient light sources just make it easier to simulate and edit lighting.