Version: 2019.4
Importing UVs from Autodesk® Maya® to Unity
UV overlap

Generating lightmap UVs

You can generate your own lightmap UVs for a Mesh, or Unity can automatically generate them.

Generating your own lightmap UVs

You can author your own lightmap UVs in the content creation software of your choice. You must place lightmap UVs in the second UV channel of your mesh.

A good UV set for lightmaps should adhere to the following rules:

  • It should be within the [0,1] x [0,1] UV space.
  • It should have a wide enough margin between individual charts. For more information, see UV overlap feedback.
  • It should not have any overlapping faces.
  • There should be a low difference between the angles in the UV and the angles in the original geometry.
  • There should be a low difference between the relative scale of triangles in the UV and the relative scale of the triangles in the original geometry), unless you want some areas to have a higher lightmap resolution.

Automatically generating lightmap UVs for a Model

You can tell Unity to automatically generate lightmap UVs for a Model, using the Model Import Settings.

  1. Select the Model in your Project view. Unity opens the Model Import Settings in the Inspector.
  2. In the Model Import Settings, navigate to the Model tab, and then the Geometry section.
  3. Tick the Generate Lightmap UVs checkbox. The Lightmap UVs settings section appears below the Generate Lightmap UVs checkbox.
  4. Optional: Configure the settings in the Lightmap UVs settings section. See Settings for more information.
  5. Click the Apply button. Unity generates lightmap UVs into the Mesh.uv2 channel.

Lightmap UVs settings

These are the settings that appear in the Model tab of the Model Import Settings, when you enable Generate Lightmap UVs.

Property: Function:
Hard Angle The angle between neighboring triangles (in degrees) after which Unity considers it a hard edge and creates a seam. You can set this to a value between 0 and 180. This is set to 88 degrees by default.

If you set this to 180 degrees, Unity considers all edges smooth, which is realistic for organic models. The default value (88 degrees) is realistic for mechanical models.
Pack Margin The margin between neighboring charts (in pixels), assuming the Mesh takes up the entire 1024x1024 lightmap. You can set this to a value between 1 and 64. A larger value increases the margin, but also increases the amount of space the chart needs. This is set to 4 pixels by default.

For more information, see Pack Margin.
Angle Error The maximum possible deviation of UV angles from the angles in the source geometry (as a percentage from 0–100). This is set to 8% by default.

This controls how different the triangles in UV space can be to the triangles in the original geometry. Usually this should be fairly low, to avoid artifacts when applying the lightmap.
Area Error The maximum possible deviation of UV areas from the areas in the source geometry (as a percentage from 0–100). This is set to 15% by default.

This controls how well Unity preserves the relative triangle areas. Increasing the value allows you to create fewer charts. However, increasing the value can change the resolution of the triangles, so make sure the resulting distortion does not deteriorate the lightmap quality.

Pack Margin

To allow filtering, the lightmap contains lighting information in texels near the chart border, so always include some margin between charts to avoid light bleeding when applying the lightmap.

The lightmap resolution defines the texel resolution of your lightmaps. Lightmappers dilate some chart texels in the lightmap to avoid black edges, so the UV charts of your Mesh need to be at least two full texels apart from each other to avoid light bleeding. Use the Pack Margin setting to ensure you have enough margin between the UV charts of your geometry.

In lightmap UV space, the padding between charts need to be at least two full texels in order to avoid UV overlapping and accidental light bleeding. In this image, the black space represents the space between charts.

Angle distortion

The following screenshots demonstrate equal resolution, but with different UVs. The first image has a high Angle Error, and the result contains unintended artifacts. The second image has the default Angle Error (8%). In Meshes with more triangles, angle distortion can significantly distort the shape.

Area distortion

In the image below, two spotlights with the same parameters light the sides of a cylinder. The right-hand side of the cylinder has a higher Area Error value, which distorts the triangles and leads to a lower resolution, creating artifacts in the light.


Progressive Lightmapper added in 2018.1 NewIn20181

Importing UVs from Autodesk® Maya® to Unity
UV overlap