This is the documentation for Enlighten.

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