Taper Warp Tool: Tapered Tumbler Compensation

Lightburn's Taper Warp tool compensates for the design distortion that happens when you wrap a flat design around a tapered tumbler (Yeti, Stanley Quencher, RTIC, Hydro Flask). It pre-warps the source artwork in software so the engraved result reads as visually rectangular on the finished tumbler. This replaces the manual pre-distortion math previous versions of Lightburn required.

Where to find it

Menu path: Laser Tools → Taper Warp.

Select the artwork you want to compensate first, then open the tool. The tool operates on the current selection.

The four input parameters (verbatim Lightburn field names)

Field	What it asks for	How to measure / set
Object Top	Dropdown: Top, Left, or Right. Tells Lightburn which edge of your artwork corresponds to the WIDER end of the physical tumbler.	For a logo standing upright on a top-wider tumbler with the design oriented vertically in Lightburn, choose Top. For sideways-laid designs, pick the matching edge.
Top Diameter	Diameter at the wider end of the physical tumbler.	Caliper the actual tumbler at its widest point on the engrave area. Don't trust advertised dimensions, production runs vary.
Length	Total length of the engrave area along the tumbler's axis.	Caliper or ruler the height of the area you'll be engraving (top of design to bottom of design on the tumbler surface).
Bottom Diameter	Diameter at the narrower end.	Caliper at the narrower end of the engrave area. Don't measure the foot if the foot is below the engrave zone, measure where the design will actually start/end.

Important: Taper Warp operates in millimeters per LightBurn's docs. If your project is set to inches, convert your caliper readings to mm before entering. (1 inch = 25.4 mm.)

Workflow

1. Set up the rotary normally first. Tools → Rotary Setup. Configure as Roller or Chuck appropriately. Enter the AVERAGE diameter ((D_top + D_bottom) / 2) for the rotary's "object diameter" field. Test 360° rotation.
2. Place your design in the workspace at the size it should appear on the finished tumbler. Don't pre-distort; design as if the surface is flat.
3. Select the artwork to be warped (typically: select all, or just the elements that need compensation).
4. Open Laser Tools → Taper Warp.
5. Set the four parameters per the table above.
6. Preview in the workspace. The artwork visibly warps to a trapezoid shape, narrower at the end you marked Object Top (the wider physical end), wider at the opposite end. That's correct: this pre-distortion will "untwist" as the design wraps the taper during engraving.
7. Click OK to apply, or Cancel to discard.
8. Engrave normally. The warped artwork wraps cleanly on the tumbler.

Critical: Taper Warp permanently modifies the artwork

Limitations (from LightBurn's documentation)

• Operates in millimeters only. Convert if your project is inches.
• Does NOT account for laser focal length or laser-to-object distance. Focus management is still your job, see Focal Range section in the tapered tumbler module.
• Accuracy is only as good as your measurements. Caliper carefully. Even 1mm of measurement error compounds across a tall design.
• Engrave surface still needs to be parallel to the laser bed. Taper Warp solves the design-distortion problem in software; the physics of laser-on-tilted-surface still applies. You still need a tilt rotary, OR shimming, OR a thin-band engrave to keep the surface flat under the laser.
• Best for moderate tapers. Heavy tapers (Stanley Quencher) test the limits, combining Taper Warp with mechanical shimming usually beats either approach alone for the most-distorted tumblers.

When to use Taper Warp vs alternatives

Approach	Best for
Tilt-capable rotary alone (no Taper Warp)	Short designs that occupy < ~50% of the tumbler height. The tilt presents a flat band to the laser; no software compensation needed for that band.
Taper Warp alone	Full-height wrap designs on a standard (non-tilt) rotary, where the surface still ends up reasonably parallel because the taper is mild.
Taper Warp + tilt-capable rotary	Premium results on heavy tapers (Stanley Quencher). Taper Warp solves the wrap-distortion in software; the tilt keeps the surface flat under the laser. Two complementary fixes.
Taper Warp + shimming (no tilt rotary)	Same combination but with a wedge under the narrow end instead of a tilt mechanism. Works fine; just less convenient batch-to-batch.
Manual pre-distortion in Illustrator/Inkscape	Legacy / fallback only. Use if you're on a pre-1.5.01 LightBurn install, OR if Taper Warp's parameters don't fit an unusual geometry. Otherwise Taper Warp is faster and more accurate.

Common mistakes

• Object Top set to the wrong edge. Result: design warps in reverse (wider end gets shrunk instead of widened). Symptom: engraved result is MORE distorted than uncompensated. Fix: undo, change Object Top dropdown, re-apply.
• Diameter measured at the wrong height. The Top Diameter must be at the engrave-area top, not the absolute top of the tumbler (which may flare out at the rim). Same for bottom, measure where your design will start/end, not the tumbler's foot.
• Length over-measured. Including non-engrave area in Length skews the warp. Length = how tall is the design ON the tumbler.
• Re-applying Taper Warp on already-warped artwork. Doubles the warp; engraved result is wildly distorted. If you apply by mistake, Undo immediately; if past Undo, reload the saved flat backup.
• Forgetting to save a backup before applying. Taper Warp is permanent on the artwork. No backup = no easy way to recover the original layout for re-editing.
• Trusting Taper Warp to handle focal range. The tool warps geometry only. If the engrave surface drifts out of focus mid-job (because the tumbler's tilt brings the surface above or below the focal plane), Taper Warp won't save you. See Focal Range guidance in the tapered tumbler module.

Verify on a sample blank: every time

Even with Taper Warp dialed correctly, run a verification piece before committing to a customer's tumbler:

1. Add a small reference shape to your design, a perfect 30×30mm square, or a 10×10mm grid pattern. Place it on the same layer as your real artwork.
2. Apply Taper Warp to the WHOLE selection (real artwork + reference shape).
3. Engrave on a sacrificial blank.
4. Measure the engraved square / grid. If it's still trapezoidal, your top/bottom diameter measurements are off, re-caliper.
5. Once the reference engraves square, you've validated the Taper Warp settings for that tumbler model. Save the project as a template.

Related tools

• Warp Selection and Deform Selection (Tools menu), different tools for free-form geometric warping (drag handles to bend artwork). Useful for non-tumbler distortion needs but NOT a replacement for Taper Warp on tapered drinkware.
• Cylinder Correction: for true-cylinder rotary work on certain controllers. Not applicable to tapers.
• Rotary Setup (Tools → Rotary Setup), required upstream of Taper Warp. The rotary needs to be calibrated correctly for the warped output to engrave correctly.

What to read next

• Tapered Tumblers (Advanced) in the CO2 tab, the production workflow that puts Taper Warp in context with rotary tilt, shimming, focal range, and settings.
• Straight-Wall Tumblers & Bottles in the CO2 tab, the easier sibling workflow (no Taper Warp needed because there's no taper).
• Material Library Files (.clb) in this section, once you've validated Taper Warp settings for a tumbler model, save the per-model settings to your Library so you don't re-test the same model again.

Sources

• LightBurn Documentation, Taper Warp reference
• LightBurn Documentation, Full Wrap Tumblers guide
• LightBurn 1.4.00 release notes, Warp / Deform tools introduction

Verified against LightBurn 2.x official documentation (Laser Tools → Taper Warp). Taper Warp first shipped in LightBurn 1.5.01; the broader Warp / Deform Selection family was introduced in 1.4.00.