Baking and reverting¶

Commit the shape you sculpted, roll a surface back to the model you started from, or throw away the sculpting entirely — and know which of the three you can undo.

All three live in the Warp Settings panel, which appears in the sidebar when the Scene tab is in Warp mode. They act on the surface you are editing, not on a single projector.

Know where you stand¶

Above the buttons, one line reports the state of the surface:

Line	Meaning
Unbaked — projector renders the source mesh until you Bake.	No committed warp exists for this surface yet.
Baked. Edit and re-Bake to update the canonical warp.	A committed warp exists. Anything you have sculpted since is not part of it.

There is a second, easier-to-spot signal. The status dot in the top bar turns amber and pulses as soon as you move a point, with the tooltip Warp edits not baked — click Bake Warp to commit. If that dot is amber, you have alignment work that has not been committed.

The three actions¶

Action	What it does	Reversible?
Bake Warp	Commits the surface's current shape as its canonical warp	Yes — bake again to replace it
Revert to Source	Discards the committed warp, so the projector renders the model the surface was built from	No
Reset Warp	Flattens your sculpting, returning every point to its original position	No

Bake Warp¶

Bake Warp takes the shape you can see and writes it down as the canonical warp for that surface.

Finish the alignment pass so the surface sits on the object.
Press Bake Warp. The button reads Baking… while the commit is in flight.
A confirmation appears when it lands, reporting how many points were baked.

Bake at the end of every alignment pass, and always before you hand the show over or walk away from it. Baking again simply replaces the previous bake — there is no penalty for baking often, and no limit on how many times.

Once a surface is baked, the status line switches to Baked and Revert to Source appears beneath the bake button.

Baking does not stop you editing

A bake is a snapshot, not a lock. Move a point after baking and the top-bar dot goes amber again: the committed warp is now behind what you see on screen. Press Bake Warp again to bring them back in line.

If nothing happens

If the commit gets no answer within about eight seconds, Moonshine gives up and warns you rather than leaving the button spinning. Check the connection on the Monitor tab and try again — nothing is lost by pressing Bake Warp a second time.

Revert to Source¶

Revert to Source appears only when a bake exists. It throws that bake away, so the projector goes back to rendering the model the surface was built from — the geometry you imported or the primitive you created, with none of the warp on it. The status line returns to Unbaked and the button disappears until you bake again.

Use it when:

The alignment is far enough off that starting clean beats fixing it.
The physical object or the set has changed and the old correction no longer means anything.
You imported a corrected model and want the surface to follow the file rather than a stale bake.

This is not undoable

Reverting discards the committed warp for that surface. Ctrl+Z will not bring it back. If there is any chance you will want the old alignment, do the revert at a point where you are prepared to redo the pass from scratch.

Revert to Source and Bake Warp are both exclusive operations. They are disabled while another operator holds the warp lock for that surface — see Locks.

Reset Warp¶

Reset Warp returns every point of the surface to its original, unwarped position, discarding the sculpting in your viewport. Moonshine confirms first:

Reset Warp Reset all warp modifications? This cannot be undone.

with Cancel and Reset. Every operator viewing that surface sees it flatten immediately.

Reset also flags the surface as having uncommitted changes — the top-bar dot goes amber. Flattening the surface on screen is not the same as committing the flat shape, so finish the job:

Press Bake Warp to commit the flat surface, or
Press Revert to Source to drop the committed warp as well.

Reset cannot be undone

Unlike a single vertex move, a reset is not on the undo stack. Everything you sculpted on that surface goes at once. If you only want to take back the last few moves, press Ctrl+Z instead — it steps back through your own edits and leaves other operators' work alone.

Resetting from the scene graph

Right-clicking a surface's Warp node in the scene graph — each is labelled with the projector it belongs to — also offers Reset Warp. That route selects the projector and runs immediately, with no confirmation dialog.

Which one do I want?¶

The alignment is right and I want to keep it → Bake Warp.
I want to keep the alignment but the dot is amber → Bake Warp again; you edited after the last bake.
This surface's sculpting is a mess, I want a clean surface to work on → Reset Warp, then sculpt again and bake.
I want this surface back the way it came, bake and all → Revert to Source.
I moved one point too far → Ctrl+Z, not any of the above.