Pivot API

component · /pivot

ModelPivotGroup

interface ModelPivotGroupProps {
  pivot?: Vec3
  position?: Vec3
  rotation?: Vec3 // degrees
  scale?: Vec3
  children?: ReactNode
  contentRef?: Ref<THREE.Group>
  name?: string
}

PivotHelper

A development helper that follows the pivot root. It renders axes, a center sphere, and a ring without participating in raycasts or bounds.

Utilities

setViewerPivot(config, point, options)

Returns a new viewer configuration. With preserveVisualPosition, compensates current and sequence model positions.

compensateModelPositionForPivot(...)

Low-level transform math used by setViewerPivot.

getObjectLocalBounds(root, relativeTo)

Calculates renderable bounds expressed in a selected object's local coordinate space.

worldPointToModelLocal(worldPoint, modelContentRoot)

Converts a raycast world point to the imported model's original local coordinates.