Version: 2017.4
Global Illumination UVs
GI cache

Importing UVs from Maya to Unity

Maya is a 3D computer animation software by Autodesk, with powerful modelling, rendering, simulation, texturing and animation tools for visual effects artists, modellers and animators (see It is often used by Unity developers for advanced graphics work, which is then imported into Unity. It’s important to note that when importing from Maya, your UVs may not look exactly the same, even if you untick the Optimize Realtime UVs checkbox. This section explains why.

Because real-time UVs are repacked by Enlighten, it is very important to understand how UV charts are detected. By default, a chart is defined by a set of connected vertices. However, the DCC or Unity Mesh importer might introduce extra vertices in places where the Mesh has hard edges. These duplicated vertices create extra islands (unconnected groups) in your UVs. However, these cuts normally go unnoticed when you bake the lightmap, because the UVs are used directly and not repacked. The image below shows an example of this.

UVs in Maya
UVs in Maya

A high smoothing angle does not preserve hard cuts in the model, and both the shading and GI look different as a result.

The Mesh Importer settings that relate to this are Normals, Tangents, and Smoothing Angles:

If you set Normals to Calculate, breaks are made wherever the angle between adjacent triangles exceeds the Smoothing Angle value.

To avoid this, you can choose to author and import normals (see documentation on Normal maps to learn more about surface normals). In order to get good results with imported normals, you need to manually make the cuts along hard edges, and pay attention to how the DCC is inserting duplicate vertices. Otherwise, both GI and regular shading may have undesired lighting effects.


When packing with a 40-degree Smoothing Angle, the hard angles in the model are preserved, and extra charts are created:

Asset source: Lee Perry Smith, VizArtOnline
Asset source: Lee Perry Smith, VizArtOnline

If the Smoothing Angle is set to 180 degrees, no cuts are made, and the UVs are the same as they were in Maya. The only difference is the chart packing:

Asset source: Lee Perry Smith, VizArtOnline
Asset source: Lee Perry Smith, VizArtOnline

Optimizing Realtime UVs

The Mesh Renderer contains an option called Optimize Realtime UVs.

Optimize Realtime UVs enables Enlighten’s UV optimization feature. Note that disabling this option does not allow the authored UVs to flow straight to Enlighten; repacking is still applied.

The feature is intended to optimize charting for real-time GI only. It does not affect baked UVs. Its purpose is to simplify the UV unwrap, which reduces the chart count (and thus texel count). This makes lighting more consistent across the model, makes the texel distribution more even, and avoids wasting texels on small details. The time taken to do the precompute phase is proportional to the number of texels you feed in. For example, a detailed tiled floor with separate charts for each tile takes up an unnecessarily high number of texels, but joining them into a single chart results in far fewer texels. This works because the real-time lightmaps only store indirect lighting (meaning there are no sharp direct shadows).

This process cannot alter the number of vertices in the model, so it cannot introduce breaks in the UVs where there already one present. This means the resulting chart layout is the same, but some of the charts might overlap or be merged in areas where it is unlikely to have a negative effect on the indirect lighting.

Use the settings to define when the charts are merged:

  • Max Distance: Charts are simplified if the worldspace distance between the charts is smaller than this value.
  • Max Angle: Charts are merged if the angle between the charts is smaller than this value.

These settings are intended to avoid merging charts when they are far apart or pointing in generally different directions.

Optimizing Realtime UVs: Example

The following example uses the Desert Ruins Asset from the Asset Store:

Asset source: DEXSOFT-Games
Asset source: DEXSOFT-Games

It uses default parameters, and the real-time lightmap resolution is 1 texel per unit. The model is approximately 9 units long. The image below shows the real-time UVs generated for this model using the Auto UV feature:

Note that the the tiles on the floor have been packed to a single chart, with an appropriate resolution for the chosen texel density and instance size:

When packed without the Auto UV feature, the generated UVs look like this:

This generates a large number of small charts, because the charts are split in the authored UVs supplied by the model. Because Auto UVs is not enabled, none of these charts can be merged, and each UV island is awarded a 4x4 pixel block of its own regardless of its size. The image below shows a subsection of the UVs:

The wall sides still get a sensible resolution of 10x4 texels, but the small tiles gets a disproportionate 4x4 texels each. The reason that the minimum chart size is 4x4 is that we want to be able to stitch against the chart on all 4 sides and still get a lighting gradient across the chart.

Further Chart Optimization

There are two additional options for further optimizing the charting the UV layout:

  • Ignore Normals
  • Min Chart Size

Ignore Normals

Tick the Ignore Normals checkbox to keep together any charts that have duplicated vertices due to hard normal breaks. A chart split might occur in Enlighten when the vertex position and the vertex lightmap UVs are the same, but the normals are different. For small details, multiple 4x4 texel charts to represent indirect lighting is too much, and affects precompute and baking performance. In these cases, enable Ignore Normals.


In the following example, Optimize Realtime UVs is disabled, to demonstrate the effect of Ignore Normals in isolation.

Asset source: Lee Perry Smith, VizArtOnline
Asset source: Lee Perry Smith, VizArtOnline

The image on the left shows the result without Ignore Normals enabled. The image on the right shows the result with Ignore Normals enabled.

When Ignore Normals is enabled, the 24x24 Enlighten unwrap is reduced to a 16x16 unwrap for this model.

Min Chart Size

Min Chart Size removes the restriction of having a 4x4 minimum chart size. The stitching does not always work well, but for small details it is usually acceptable.


In this example, Min Chart Size is set to 2 (Minimum).

If you were to apply this Min Chart Size option and Ignore Normals to the model above, the unwrap reduces to 10x10.

Getting chart edges to stitch for realtime GI

The lightmaps that are set to Realtime support chart stitching. Chart stitching ensures that the lighting on adjacent texels in different charts is consistent. This is useful to avoid visible seams along the chart boundaries. In large texel sizes, the lighting on either side of a seam may be quite different. This difference is not automatically smoothed out by filtering, because the texels are not adjacent.

In this example, a seam is visible on the sphere on the right, even when textured, because it has not been stitched:

Stitching is on by default. If you think it is causing some unwanted issues, you can disable it; Apply Lightmap Parameters to the instance in question and untick the Edge Stitching checkbox.

For charts to stitch smoothly, edges must adhere to the following criteria:

  • Preserve UVs must be enabled, so that the charts are not simplified by the Auto UV feature.
  • The charts must be in the same Mesh.
  • The edges must share vertices.
  • The edges must be horizontal or vertical in UV space.
  • The edges must have the same number of texels (this usually follows from the two preceding criteria).

This is how Unity’s built-in sphere, capsule and cylinder are authored. Notice how the charts line up:

  • 2017–07–04 Page published

  • 2017–07–04 Documentation update only, no change to Unity functionality

Global Illumination UVs
GI cache