Mesh Warp Tools

What is Mesh Warp?

Mesh warp is a grid of control points laid over your artwork. Drag any point and the artwork in that area follows smoothly. This is exactly Photoshop's Edit → Transform → Warp tool.

Use it when 4 corners aren't enough — cups, hats, bulged labels, anything with a complex curve.

Recommended quick workflow

1. Click Mesh in the toolbar
2. Click ✨ Auto Mesh — drops a grid that hugs your product silhouette
3. Click ⇋ Sym: L↔R — turn on horizontal symmetry so both sides mirror
4. Click 🧲 Magnet — drag any part of the mesh to sculpt smoothly
5. Click ✨ Smooth to clean up any kinks
6. Click 💾 Save Position so the mesh persists for this product

Grid density — how many control points?

Use the Grid dropdown to pick how many control points the mesh has.

Changing density mid-edit re-interpolates your existing mesh shape, so you don't lose work when you bump it up.

✨ Auto Mesh — detect the product shape

Click ✨ Auto Mesh and the system:

1. Reads your product photo
2. Finds the product's silhouette (alpha channel for transparent PNGs, or background-difference for JPGs)
3. Detects the body centre (so handles on a cup don't throw it off)
4. Drops a mesh inside the visible product body, row-by-row

If detection fails (e.g. product blends into the background), a sensible default grid gets placed centred in the canvas. Auto Mesh always gives you a starting point.

Moving the whole mesh

Four ways to translate the entire grid without warping:

• Centre move handle — the coloured dot with a ✛ icon at the centre of the mesh. Drag it to move everything.
• ↔ Move button — click to enter "move only" mode. Any drag inside the mesh moves the whole grid. Click again to exit.
• Shift + drag anywhere — temporary move mode. Hold Shift while dragging anywhere inside the mesh.
• Arrow keys — nudge 1px (or 10px with Shift).

Resizing — enlarge / shrink without distortion

Three ways to scale the mesh uniformly (artwork stays proportional):

• Blue Resize − / + buttons in the mesh toolbar. Each click scales ±10%.
• Keyboard: [ to shrink, ] to enlarge (outside Mask mode).
• Drag a corner handle of the dashed bounding box. Locks aspect ratio by default. Hold Shift to scale freely (distortion allowed).

⇋ Symmetry — mirror edits automatically

Click the ⇋ Sym button to cycle through three modes:

• Off — normal independent dragging.
• L↔R — horizontal mirror. Drag the left side of the mesh; the right side mirrors automatically. Perfect for cups, bottles, anything left-right symmetric.
• T↕B — vertical mirror. Top mirrors to bottom. Useful for plates and labels.

✨ Smooth — iron out kinks

Each click runs a Laplacian smoothing pass:

• Every interior mesh point gets replaced with a weighted average of its 4 neighbours (60% original, 40% neighbour-average)
• Outer edge points stay put — artwork stays inside the same outer bounds
• Respects active symmetry mode

Click Smooth once for gentle cleanup, several times for strong smoothing. Great after manual dragging or Magnet work.

🧲 Magnet — sculpt the mesh like clay (Liquify)

The fastest way to create a smooth curve in the mesh:

1. Click 🧲 Magnet (turns purple when active)
2. A Range slider appears — controls the brush radius
3. Hover the canvas — a purple dashed circle shows the magnet's pull area
4. Click and drag anywhere on the mesh. Points within the circle follow the cursor with a smooth gaussian falloff; points outside are untouched.

One stroke = a clean curve. No need to align individual points manually. Works beautifully with symmetry on.

🌀 Curve slider — generate a curve instantly

Drag the Curve slider in the mesh toolbar to bend the entire mesh into a smooth arc in one motion:

• Negative values — arc up (frown shape)
• Zero — no bend (original mesh)
• Positive values — arc down (smile shape)
• H / V toggle — switch between horizontal bend (rows curve) and vertical bend (columns curve)
• × button — reset to the original mesh shape

The curve always stays inside the original bounding box — the mesh CANNOT grow past the product. Drag the slider freely and the mesh re-shapes without stretching past the edges.

Combine with Magnet for finishing touches: curve slider for the big shape, Magnet for the fine detail.

Undo / Redo

Cmd+Z undoes the last mesh operation (up to 30 steps back).

Cmd+Shift+Z redoes.

Works for single-point drags, magnet strokes, curve slider changes, scale ops, and smoothing passes.

Mesh is preserved when you switch modes

Sculpting a mesh then clicking Flat or Mask doesn't wipe your work — the mesh is stashed and restored when you return to Mesh mode.

Only Reset All or Reset Position explicitly clears the mesh.