Skip to main content

Interface: RotationGizmoSettings

Rotation gizmo behaviour for modular products, configured per scene product in Product Admin → Modular Settings. Values follow the admin enum convention (uppercase). All fields are optional — unset fields fall back to defaults (SNAP mode, 15° step, accent colour, ring shown only while rotating).

Properties

gizmoColor?

optional gizmoColor: string

Gizmo colour override. Falls back to the customer accent colour.


mode?

optional mode: RotationGizmoMode

SNAP — hard steps of snapAngle degrees (default). FREE — no snapping. MAGNETIC — free rotation that momentarily catches at multiples of snapAngle and releases when dragged past the detent. DISABLED — no rotation gizmo at all.


ringAlwaysVisible?

optional ringAlwaysVisible: boolean

When true, the rotation ring is visible whenever the product is selected, not only while dragging the rotation handle.


snapAngle?

optional snapAngle: number

Step in degrees used by SNAP and MAGNETIC modes (e.g. 15, 30, 45).


toolbarRotate?

optional toolbarRotate: ToolbarRotateMode

Toolbar quick-rotate behaviour. LINKED (default) — follows the rotation mode: hidden when rotation is DISABLED, steps by snapAngle for SNAP/MAGNETIC, 45° for FREE. ON — always shown, stepping by toolbarRotateAngle; works even when 3D rotation is DISABLED (toolbar-only rotation). OFF — never shown.


toolbarRotateAngle?

optional toolbarRotateAngle: number

Step in degrees for the toolbar quick-rotate when toolbarRotate is ON.