Möbius Warp
Apply spherical warp transformations — twist, swirl, and perspective adjustments — directly on the 360° viewer
Last updated: 2026-07-15
Möbius Warp
What Is Möbius Warp?
Möbius Warp applies spherical warp transformations directly on the 360° viewer, letting you twist, swirl, and adjust perspective in equirectangular space. It lives in the transforms section of the viewer toolbar, alongside Depinch and Offset.
The warp operates on the current view state — yaw, pitch, roll, and zoom — and composites them into a single transform. Spherical tunnel guides rendered in the viewer help orient the warp in 3D space so you can see the effect before applying.
Controls
All parameters are adjusted via sliders in the MobiusWarpControls panel, which opens when you activate the tool from the viewer toolbar:
| Control | Description |
|---|---|
| Yaw | Horizontal rotation around the vertical axis |
| Pitch | Vertical tilt up or down |
| Zoom | Field-of-view scaling (identity: 1.0) |
| Roll | Rotation around the view axis (identity: 0) |
| Twist | Spherical swirl distortion (identity: 0) |
| Twist Curve | Falloff curve for the twist effect — controls how the distortion ramps across the sphere |
Apply Gate
The Apply button is disabled when all values are at identity — zoom is 1, roll is 0, and twist is 0. This isIdentity gate prevents submitting a no-op transform.
Stale-Guard
An abort controller guards the apply path. If you adjust sliders rapidly or reactivate the tool while a previous apply is still in flight, the stale request is cancelled. Only the most recent apply completes.
Usage
- Open the viewer toolbar and select Möbius Warp from the transforms section
- Adjust yaw, pitch, zoom, roll, twist, and twist curve using the sliders
- Use the spherical tunnel guides to preview the warp in 3D space
- Click Apply — enabled only when the transform is non-identity
- The result is inserted as a new render node in the derivation graph
Tips
- Start with small twist values (0.1–0.3) — the effect compounds quickly
- Zoom + twist together produces dramatic swirl effects
- The warp is non-destructive — your source node is preserved in the graph
- Combine with Depinch and Offset for full spatial control
- A depth channel on the source is warped onto the new node with the image; if depth cannot follow, regenerate rather than trusting a stale map
See also: Channels | Modules & Compatibility | Viewer Tools