This tutorial describes how to use GeoRadiosity to preview and debug specific aspects of a scene.

Preparation

First, load and set up your scene in GeoRadiosity. If you do not have a scene of your own, load the example Arches scene (Arches.scene).

Load and precompute

1. Load the scene

- If you wish to debug mesh projection issues, select the Load Mesh Projection Data option.
- If you wish to preview clustering, select the Load Clustering Data option.

2. Click the Precompute tab and then Full Precompute. Even if you have already precomputed in your engine, you may need to do a precompute again in GeoRadiosity to generate GeoRadiosity-specific data.

Set up lighting

The default lighting configuration consists of one directional light. Click the Lighting tab to set up and save your own lighting configuration.

Set up camera

Click the Rendering tab and set your camera properties.

Preview radiosity

On the Rendering tab, select the Scene renderer. Then click the Demo tab and use the Radiosity Wipe slider to show the scene split with radiosity on one side and without radiosity on the other.
On the Lighting tab, use the Radiosity Scale slider to increase and decrease the radiosity in the scene.
On the Radiosity tab, change various radiosity options.

Preview and debug mesh projection issues

On loading the scene, select the Load Mesh Projection Data option.
Use the Filter tab option Toggle Target Geometry to show only meshes that are included in the radiosity computation. This switch can be used while any other render mode/visualisation service is active.
On the Rendering tab, select the Projection Issues visualisation service.
Also on the Rendering tab, select the Chart renderer to preview how detail charts project onto their targets.

Preview light probes / dynamic object lighting

On the Filter tab, select Draw Dynamic Objects.
On the Rendering tab, select the ProbeSets visualisation service.

Preview clustering

On the Rendering tab, select the Cluster renderer. This renderer shows clusters with / without the input lighting.
On the Rendering tab, select the Duster Points visualisation service. Then click the Duster Points tab to change the duster display mode.

Debug performance issues

Click the Performance tab and select Enable real time performance graph to display runtime statistics.
Click the Perf Stats tab to change the way the performance statistics are displayed.
On the Rendering tab, select the Chart renderer to preview charting. Too many small charts will impact performance.
On the Rendering tab, select the Geometry > Systems renderer mode. Very large systems will impact performance.
Click the System Dependencies. Too many dependencies will impact performance. Ensure that only the required dependencies exist.

Preview systems

On the Rendering tab, select the Geometry > Systems renderer mode to view the systems in the level. Very large systems will impact performance.
Click the System Dependencies tab. Choose Calculated and click Load calculated deps to see the dependencies used by the precompute.
On the Rendering tab, select the Occlusion visualisation service. This filters systems based on occlusion from the viewpoint.
On the Filter tab, use the System slider to filter systems based on index.

Debug albedo issues

On the Rendering tab, select the Geometry > Albedo renderer mode.
Select the Texture Albedo Renderer visualisation service.
Select the Duster Points visualisation service. Then click the Duster Points tab and select Duster Albedo to display duster points with per duster albedo colour.
On the Radiosity tab, switch the Radiosity Albedo Type between cluster albedo and texture albedo.

Preview light animations

Click the Lighting to set up a light configuration. This represents the first frame of your light animation.
Then enable the Light Animator visualisation service, and click the Light Animator tab.