[Professional Version Only]

Repaint

The Repaint tool allows you to load an old mesh and texture map into UVLayout where you can then modify the UVs (e.g. repack, optimize, modify seams) and then repaint the old map according to the new UVs. To use, the modified mesh with new UVs should be loaded into the 3D window.

Mesh 

Select the file (OBJ or UVL) with the original UVs.

Map 

Select the original texture map file.

Max U 

When using the #### naming convention for tiled maps (see below) this number specifies the maximum U index (also known as udim). Many people use "10". If left at "0", then the maximum is automatically determined from the UVs in the original mesh.

Snap Shells To Pixels 

Tick this if you want to move the current shells so they're locked to the pixel locations; this is needed for lossless copying of shells that have been translated or rotated by 90 degree steps only. You should save your mesh out after running the repaint, because the UVs will have been modified slightly if you have ticked this option.

Trace After Repaint 

The newly repainted texture map is mapped onto the loaded mesh, just as if you'd used the Display Trace tool.

Renormalize 

If the map being repainted is a texture space normal map, tick this and the normals will be adjusted for shells that have been rotated. The nV option selects nVIDIA style normal maps, and use ATI for maps with an inverted G channel. Its safe to leave Renormalize on for standard color maps because UVLayout will only adjust the color values if it detects that a normal map is being processed.

Edge Bleed 

After repainting, shell boundaries are bled out the set number of pixels. This helps make the UV seams less visible when the repainted map is used as a texture.

Repaint Map 

Set the output resolution, then click this to create the repainted map.

Currently the Repaint tool only works for single tiles; that is, all UVs in the original and current mesh have to be contained within the 0 to 1 UV space.

Repainting Multiple Maps

If your mesh has multiple texture maps, such as color, specular and normal, then you can get UVLayout to process them in one go. Instead of selecting a texture map in the Map selector, you can load a CSV extension text file that has the names of the maps, one per line. For example ...

 fish-color.tif
 fish-spec.tif
 fish-norm.tif

By default UVLayout will create new files for each of the repainted maps with "-repaint" added to the original filename. If you would like a different output name, or to overwrite the original file, add that to the CSV file with a comma between the original and the new names ...

 fish-color.tif,new-color.tif    <- different output name
 fish-spec.tif,fish-spec.tif     <- overwrite original
 fish-norm.tif                   <- keep default output name

If these multiple maps are different resolutions, and you want the repainted maps to keep the same resolutions, then change the output resolution field to the equals character (i.e. =). You can also enter in a resolution multiplier (e.g. *2) or divider (e.g. /4), and then the resolutions of the output maps are adjusted accordingly.

Repainting Multiple Tiles

If your original UVs are spread across multiple UV tiles, with corresponding maps, then you can also repaint these to the new UVs. Instead of selecting one of the texture map tiles in Map, you need to copy and rename any one of the map files so that the U and V indexes or tile number is replaced with the following special tags:

 #,##,###,####  <-  tile number
 U,UU,UUU,UUUU  <-  tile U index
 V,VV,VVV,VVVV  <-  tile V index

For example, if you're using a U/V convention and you maps are named like this ...

 fish-color-00,00.exr
 fish-color-01,00.exr
 fish-color-01,01.exr

... then you should copy one of those files and rename it like this ...

 fish-color-UU,VV.exr

... then that file is selected for the Map value. UVLayout will then replace the UU and VV tags with their actual values when trying to find the texture map files for polygons in those tiles.

If you're using tile sequence numbering ...

 fish-color-1001.exr
 fish-color-1002.exr
 fish-color-1012.exr

... then you should copy one of those files and rename it like this ...

 fish-color-####.exr

... and selected that file for the Map value. UVLayout will then replace the #### with the tile number. By default, UVLayout will examine the UVs in the original mesh to determine the maximum U index, but many people use "10". If that's you too, make sure you change the Max U value to "10" before repainting.