Filtering

Controls how the texture or material will be filtered. This setting can impact how the texture looks when repeated multiple times. With high scaling values using a different filtering than the default may produce better looking result. Current settings available:

• Bilinear | HQ (default): Advanced bilinear filtering that tries to improve the quality of the texture when the tiling values are high.
• Bilinear | Sharp: Simple bilinear filtering that smooths the texture slightly but try to preserve details.
• Nearest: No filtering, useful if the Bilinear filtering gives a blurry result and breaks fine details. Can introduce aliasing in the texture.

UV wrap

Control how the texture repeats within the projection. Possible values are:

• None: the texture doesn't repeat. Anything outside the texture is black/transparent.
• Repeat horizontally: the texture only repeats horizontally.
• Repeat vertically: the texture only repeats vertically.
• Repeat (default): the texture repeats on both axes.

Shape crop

Define if the projected texture should be visible outside of the projection area. Possible values are:

• Project cropped to shape: the projection is confined within the projection area.
• Projection extends outside shape (default): the projection continues beyond the projection area.

Projection depth

Control how far the projection goes along its Z axis. This setting helps reaching the mesh surface when the grid point or the projection plane is too far away.

The green arrows indicate the direction and distance of the projection for each points of the grid.

Depth culling

Fade the projection based on the distance. One parameter is available:

• Hardness: control how hard or soft the fading transition is.

Show/Hide manipulator

If enabled, the manipulator is visible and controllable in the viewport to edit the projection transformation or the grid points. If disabled, both the manipulator and the grid are hidden.

Manipulator settings

This menu contains three settings:

• Manipulator size: control how big the manipulator is in the viewport.
• Grid steps: define the size of the step when translating with a constraint.
• Angle steps: define the angle of the step when rotating with a constraint.

Warp edition menu

This menu contains five actions:

• Transform warp: edit the warp transformation. Allow to manipulate the global grid position, rotation and scale.
• Edit vertices: edit the warp grid points individually (or in group).
• Split warp crosswise: start the split warp tool to insert a new grid division both horizontally and vertically.
• Split warp horizontally: start the split warp tool to insert a new grid division horizontally.
• Split warp vertically: start the split warp tool to insert a new grid division vertically.

Warp projection settings

This menu regroups settings that affect only the current warp projection:

• Row and columns: specify the number of divisions that the warp grid has. This setting can only be edited if no points of the grid have been modified.
• Handle size: define the size of the grid points in Edit vertices mode.
• Grid color: define the color of the warp grid lines.

Automatic tangents

If enabled, align the tangents of a point automatically toward its neighbors points when moved.

Translation manipulator

Allow to move the projection or the grid points along the main axes (X, Y, Z).

Rotation manipulator

Allow to rotate the projection or the grid points in the along the main axes (X, Y, Z).

Scale manipulator

Allow to scale the projection in the scene along the main axes (X, Y, Z).

Surface manipulator

Allow to move the projection or the grid points by snapping them on the 3D model surface.

Manipulator space

Define in which space the transformations are performed. Possible values:

• Local space: axes are aligned with the current transformation.
• World space: axes are aligned with scene.

Mirror on X

Flip the transformation on the X axis.

Mirror on Y

Flip the transformation on the Y axis.

Mirror on Z

Flip the transformation on the Z axis.

Reset transformation

This menu contains three actions:

• Restore the global transformation: reset the position, rotation and scale of the projection back to the initial values. This action doesn't affect the grid points themselves.
• Reset all vertices: reset all the position and tangents of the grid points of the warp grid.
• Reset selected vertices: reset the position and tangents of only the selected points of the warp grid.

Translation

Mouse click

With the Translation manipulator, clicking on the axes move the projection:

• One axis: only move in one direction the projection.
• Two axes: move the projection on the plans aligned with the axes.
• Three axes: move the projection in the space of the camera (plan facing it).

Translation constrained

SHIFT+Mouse click

With the Translation manipulator, move the projection along the selected axes but only at specific intervals (stepping). The size of the interval is defined via the manipulator settings.

Rotation

Mouse click

With the Rotation manipulator, clicking on one axes rotate the projection. Click in-between the axes allow to rotate all the axes at the same time.

Rotation constrained

SHIFT+Mouse click

With the Rotation manipulator, clicking on one axis to rotate the projection will only happen at specific intervals. The step is defined by an angle via the manipulator settings.

Scale

Mouse click

With the Scale manipulator, clicking on one axis handle resize the projection along the given axis.

Scale constrained

SHIFT+Mouse click

With the Scale manipulator, clicking on one axis handle while maintaining the shortcut will resize the projection in steps. The step size is the same as for the Translation manipulator.

Surface

Mouse click

With the Surface manipulator, clicking and dragging it over the 3D model will snap it on the surface.

• A single click on a point will select it.
• Clicking away from a point or the manipulator will deselect points.
• Clicking on points while pressing SHIFT allow to select multiple points.
• Clicking on a point while pressing CTRL allow to deselect only this point and not the other.

• Clicking and dragging allow to do a rectangular selection. Any points within the rectangle will be selected when the mouse is released.
• Clicking and dragging while pressing SHIFT allow to add more points to the current selection.
• Clicking and dragging while pressing CTRL allow to remove points from the current selection.

• Use the Translation manipulator to move a point.
• Use the Surface manipulator to move on point on the 3D model surface.

• Click and drag a point to quickly move it without having to select it first.
• Clicking and dragging a point will move it like the Surface manipulator.
• Clicking and dragging a point while pressing CTRL will move it like the Translation manipulator (in camera space on three axes).

• To modify the tangents of a point (displayed in red), simply select the given point then use the Rotation or Scale manipulator.

• Divide the grid by rows and columns from the Warp settings menu. (This is only possible if no points have been moved)
• Subdivide the grid by using one of the three split tools.
• Any of the split tools can be cancelled by pressing Escape.