Chart renderer

Overview

The Chart renderer displays scene chart texturing and output density.

Chart renderer modes

Ray Origins mode

If this mode is not available, set the computeRayOriginOutput parameter to true.

Enabling this mode increases the memory footprint of the light transport phase of the precompute. In some cases, you may get an 'out of memory' error, especially when using 32 bit versions.

The Ray Origins rendering mode displays debugging information for the light transport phase of the precompute. When you select this mode, the Ray Origins tab is displayed.

This mode renders the selected system with colour coded pixels to highlight issues with ray origins. Select Show Legend to display the meaning of the colour codes. Pixels in the selected system that have no issues are rendered with a dark random texture. Other systems in the scene are rendered with a greyscale random texture.

When you select Render origin data, additional options become available:

System	Displays currently selected system ID. The slider below selects the system.
Filter on selected system	Renders only the selected system.
Show Targets	Shows only the meshes which contribute to the radiosity computation.
Render undersampled pixels	Renders colour-coded texture overlay on the selected system highlighting pixels with ray origin issues.
Render origin data	Renders colour-coded origin points and/or backface rays.
Render backface rays	Renders yellow lines showing ray segment that caused origins to be rejected.
Render valid origins	Renders points for all valid origins.
Render invalid origins	Renders points for all rejected origins.
Filter on selected pixel	Renders only origin data for a single selected pixel. A pixel is selected by right-clicking the pixel and clicking Select Bucket and Pixel.
Render backfaces	Renders backfaces in orange.
Show legend	Displays an explanation of the colour codes.

Chart Texture mode

This is the default mode. The Chart Texture mode displays the lightmap UVs generated by the precompute. This mode is very useful for debugging mesh projection issues.

Each chart is displayed in a unique colour, with a checkerboard grid displaying output density.

To display a specific chart, right-click on a chart and select Select Chart. All other charts are greyed out:

-- select chart -->

To reset the selection, right click and select Clear Selection.

You can use the Chart Texture mode to examine mesh projection. Right-click and select Toggle show targets while in Chart Texture mode to check how well the charts on the detail mesh have projected onto charts on the target mesh.

The example below shows the Arches asset in Chart Texture mode, viewed in the Filter tab with Show Target Geometry first turned off and then turned on:

Right-click again and select Select chart to check in detail how the detail meshes project onto the target mesh:

Chart and UV Generation

The Chart and UV Generation mode shows in colours the charts Enlighten sees from any mesh loaded into GeoRadiosity. It does not show the same charts that were used during the precompute (use the Chart texture mode for this), but allows you to see how changing the chart identification parameters will affect the charting. The options to control the charting can be located by right-clicking on any geometry in the scene.

When the Chart and UV Generation mode is selected, a separate Chart and UV Generation tab is available with further options.

Geometry UV processing behaviour

Chart detection	Detect input geometry charts using the vertex method.
Chart detection (edge method)	Detect input geometry charts using the edge method.
Pack geometry	Pack input geometries (will also generate lightmap UVs).
Process everything	Process the whole scene.
Clear all results	Clear cached results.
Process only detail meshes	Process only detail meshes (target meshes will be ignored).
Process only LODs	Process only detail meshes of a given LOD (target meshes will be ignored).
Override output pixel size	Enable pixel size override.

Display options

Show aggregate stats	Show aggregate stats for packed geometries.
Override Auto UVs behaviour	Use the specified automatic UV simplification mode specified below.
Override merging parameters	Use the chart merging parameters specified below.
Max plane distance	Max distance between input charts for them to be considered for merging.
Max normal deviations (initial/general)	Max angular (degrees) deviation between input charts for them to be considered candidates for projection plane creation, and max between input charts and projection plane respectively.
Overlap expansion %	Bounding box expansion when detecting which input charts overlap.
Significant area ratio	Ratio of the chart area within which normals point at more than 90 degrees from the chart principal normal to the area of the chart above which the chart is considered curved. Also a ratio of the chart area to the area of the merged group below which the chart is considered insignificant.
Num iterations	Maximum number of algorithm iterations to use to find the best projection plane.
Max fitted	Maximum number of merged groups.

Chart detection controls

Override chart detection	Enable input chart detection options override.
Remove degenerates	Remove degenerate charts.
Link identical vertices	Link together identical charts (determined by the options below).

Identical is defined by unique...

Position	Vertex positions must match for two vertices to be considered identical.
Normals	Vertex normals must match for two vertices to be considered identical.
Chart UVs	Vertex chart UVs must match for two vertices to be considered identical.
Albedo UVs	Vertex albedo UVs must match for two vertices to be considered identical.

Show edge method (parametiser) / Show vertex method (precompute)	Change the charting method to be either the edge or vertex mode.
Show without using / Show including degenerates (default)	Whether to remove topologically degenerate triangles before charting, or leave them in (the default).
Show with / without linking identical vertices	Whether to compare and link together vertices that are 'identical'. The following four comparison flags are only relevant if this option is set to 'Show with linking identical vertices', otherwise these flags are not used.
(Do not) compare positions	Whether to compare vertex positions to establish whether two vertices are identical.
(Do not) compare normals	Whether to compare vertex normals to establish whether two vertices are identical.
(Do not) compare chart UVs	Whether to compare vertex chart UVs to establish whether two vertices are identical.
(Do not) compare albedo UVs	Whether to compare vertex albedo UVs to establish whether two vertices are identical.

For further details of these options, see The lightmap UV pipeline

Enlighten SDK 3.12 Documentation