quick start

Get up and running with Sprite Warp in minutes!

Installation

1

Import the package

Import the Sprite Warp package into your Unity project.

2

Ready to use

The tool is ready to use — no additional setup required.

Simple Mode

1

Add Component

• Select a GameObject in the Hierarchy

• Add the SpritePerspective component via the Add Component button

2

Adjust Perspective

• The component automatically enters Simple Mode

• In the Scene view, you'll see four yellow handles at the sprite corners

• Drag any handle to adjust the perspective with the View Tool (Hand icon)

3

Fine-Tune (Optional)

• Hold [Shift] while dragging to maintain equal edge lengths

• [Control + Click] to select multiple corner handles

• [Control + Double Click] to deselect all corners

• Enable "Use Subdivided Mesh" for consistent corner behavior

• Adjust "Grid Subdivisions" for more control points

4

Bake

• Click "Bake Perspective to Sprite" in the Inspector

• Choose a save location for the new sprite

• The warped sprite replaces the original

• Adjust "Bake Texture Multiplier" to control .png size.

Advanced Mode

1

Switch to Advanced Mode

• Set Mode to "Advanced" in the Inspector

• The component automatically enters the Layout sub-mode

2

Create Planes

• Adjust plane corners by dragging handles in the Scene view

• Click "Create Plane" to add a new perspective plane

3

Switch to Warp Mode

• After your planes are defined, set Sub-Mode to "Warp"

• Adjust corner handles to warp the sprite

4

Bake

• Same as Simple Mode — click "Bake Perspective to Sprite" when done.

Common Workflows

Simple Perspective Warp

1

Add component → Drag corners → Bake

Advanced Multi-Plane Warp

1

Add component → Advanced Mode

2

Create planes covering different sprite regions

3

Switch to Warp mode for warping

4

Bake

Inspecting the new .png

• After creating a new .png texture, inspect its file properties to compare the new file size to the original file size.

• If the newly created .png is smaller than before, you've lost fidelity and can re-assign your original sprite and do the warp again, but increase your Bake Texture Multiplier before re-baking. I save a snapshot when you click bake, and you can restore a previous warp so you don't have to do this process again by going to Tools > Sprite Warp > Editor Window. Watch a how to vid here

• It is not possible to guess with any accuracy the .png file size that will be created, so it is expected to bake a few times to get the desired file size.

Keyboard Shortcuts

• [Shift + Drag]: Equal distance constraint

• [Ctrl + Click]: Multi-select handles

• [Ctrl + Double-Click]: Clear selection

• [Ctrl + Drag]: Prevents dragging

Next Steps

• See how it works for a lower level explanation of the different systems working together to make this happen

• See settings reference for complete settings reference