Options

The Source Object, Target Object and Materialized Object. — The Source Object, Target Object and UV Mesh Object.

When the add-on runs and the UV Mesh object is created, it has a Modifier attached to it called Mesh Materializer which controls all settings for how the Source Object is mapped onto the Target Object:

Modifier Settings

Source Object

The object to be copied, deformed and wrapped around the Target Object’s UV Map.

Target Object

The object that the Source Object will wrap around.

Target Object UV Map

The name of the UV Map on the Target Object used to project the Source Object.

Warning

The Target Object’s UV Map needs to have non overlapping faces in order for the Add-on to work otherwise nothing may appear. For mirrored objects, see the Tips and Troubleshooting section for potential workarounds.

Target Object Vertex Group

If specified, the Source Object will only be wrapped to faces with vertices assigned to this Vertex Group. The Vertex Group needs to be added to the Target Object and vertices assigned a weight.

Height

Because a UV Map does not really have height information, this parameter controls the height of the Source Object when it is projected onto the Target Object surface.

Use Face Normals

By default, the Add-On will use the vertex normals of the Target Object to determine how the Source Object is projected. On lower poly meshes, it can sometimes produce more accurate results if the Target Object’s’ Face Normals are used instead.

In the image above, the top left low poly cube does not have enough vertex normal information, so the torus appears stretched. In this case, ticking the Use Face Normals setting will make the torus less distorted, as seen in the top right cube. In higher poly cases like the cubes at the bottom, because there is more vertex information, the Use Face Normals setting matters less, as there is enough Vertex and Face Normals in both cases.

Offset Position

This will move the Source Object along the coordinates of the UV Map:

Offset Angle

This controls the 2D rotation of the Source Object in UV space, therefore rotating it on the surface of the Target Object.

Offset Scale

This controls the size of the Object in UV space. By default, the setting will be at (1,1,1) which corresponds to the UVW coordinates in UV Space, stretching the object across the whole of one UV Map time (from 0 to 1). The W direction influences the height of the Source Object as well.

Preview UVs

It can be difficult to position the Source Object on a complex UV Map. By ticking the Preview UVs checkbox, the add-on changes to a ‘Preview Mode’ which tries to help you by visualizing how the Source Object is projected by showing its position on the Target Object’s UV Map. You can then change the above parameters and the Source Object will also update.

Often this Preview mode may be hidden by the original Target Object, so there are additional parameters below to help you reposition it. These parameters do not affect the final result.

Tip

Because the Height parameter is difficult to translate to UV space, this is not shown in Preview Mode. To reduce the height in preview mode, use the Preview Height parameter.

Preview Position

Move the Preview Mode position in 3D space.

Preview Scale

Scale the Preview Mode up or down.

Preview Height

Change the height of the Source Object in Preview mode. This is separate to the Height parameter shown in the final result.

Preview with Slicing

This stops the Source Object being sliced in Preview Mode, which can be helpful if the Source Object is in between UV islands.