Merge UV islands (relaxed)
Use this feature to merge UV islands in a relaxed manner, allowing for flexible combination of texture coordinate islands on 3D models to minimize seams and optimize texture packing.
Read time 1 minuteLast updated 21 hours ago
API function: algo.mergeUVIslandsRelaxed This function attempts to reduce the number of UV islands in a model by merging those corresponding to contiguous regions. Conversely to algo.mergeUVIslandsAffine, the set of deformations that can be applied to an island which must be stitched to another one is not limited to linear transformations. Instead, arbitrary local deformations can be applied and each merging operation comes along with a local reparametrization in order to reduce distortions in the resulting merged island.

Example
Here is the example of a 3D model reconstructed by photogrammetry. The initial UV layout (left) is highly fragmented (lot of very small isolated UV islands). The merging drastically reduces the number of islands (right), from 4864 initially to 254.![]() | ![]() |

Parameters
Occurrences
List of occurrences to process.Channel
UV channel to run the island merging on.Target island count
Stopping criterion: the island merging runs until the provided number of islands is reached. If set to0Energy threshold
The maximum unwrapping energy allowed during local reparametrization for a merging to be considered as valid.Force isolated faces
If set totrue
