Geometry Effects

Published Updated
A suite of built-in geometry effects that manipulate, deform, align, and constrain the physical vertices of 3D meshes and models in real-time.

Geometry effects alter the actual shape structure, vertices, and mechanical alignments of 3D objects in the scene.

These effects are ideal for deforming models, creating physical snap points, or enforcing rigid rotation constraints on interactive assets.

Snap Chain Effect for Connecting 3D Geometries#

Effect<SnapChainEffect>: Connects scene objects by moving their underlying geometries together. Requires linking connection inputs with outputs.

The Snap Chain effect is designed to align and move the underlying geometries of multiple scene objects together, rather than deforming their individual meshes.

To construct a snap chain, every participating scene object must have the Snap Chain effect applied to it. The system functions by linking the connection input of one snap chain effect with the output of another.

It supports toggling realtime updates via isDynamic, and maps physical anchor points using leftVertexTarget and rightVertexTarget 3D vectors. The boundaries can be restricted to specific spherical coordinate limits using the collapsible Left and Right sections (e.g. useLeftBoundaries, leftBoundaryPhi, leftBoundaryTheta, leftBoundaryWidth, leftBoundaryHeight), while rigid axis constraints are enforced using constrainXRotation, constrainYRotation, and constrainZRotation boolean toggles.

Snap Chain

XR_GEOMETRY.GEO_EFFECT_SNAP_CHAIN
Effect
Effect System ID
GEO_EFFECT_SNAP_CHAIN
Pipeline Type
XR_GEOMETRY
Context Type
XR_UNIT

Snap Chain Properties Details

Property & TypeDisplay NameSystem TypeDefault
isDynamic: boolean
Is Dynamic
BOOL
TOGGLE
true
leftVertexTarget: IVector3
Vertex Target
VECTOR3
VECTOR MULTI INPUT
{x: -1, y: 0, z: 0}
useLeftBoundaries: boolean
Use Left Boundaries
BOOL
TOGGLE
false
leftBoundaryPhi: float
Boundary Center Phi
FLOAT
RANGE SLIDER
0.5
leftBoundaryTheta: float
Boundary Center Theta
FLOAT
RANGE SLIDER
0
leftBoundaryWidth: float
Boundary Width
FLOAT
RANGE SLIDER
0.25
leftBoundaryHeight: float
Boundary Height
FLOAT
RANGE SLIDER
0.25
rightVertexTarget: IVector3
Vertex Target
VECTOR3
VECTOR MULTI INPUT
{x: 1, y: 0, z: 0}
useRightBoundaries: boolean
Use Right Boundaries
BOOL
TOGGLE
false
rightBoundaryPhi: float
Boundary Center Phi
FLOAT
RANGE SLIDER
0
rightBoundaryTheta: float
Boundary Center Theta
FLOAT
RANGE SLIDER
0
rightBoundaryWidth: float
Boundary Width
FLOAT
RANGE SLIDER
0.25
rightBoundaryHeight: float
Boundary Height
FLOAT
RANGE SLIDER
0.25
constrainXRotation: boolean
Constrain X Rotation
BOOL
TOGGLE
false
constrainYRotation: boolean
Constrain Y Rotation
BOOL
TOGGLE
false
constrainZRotation: boolean
Constrain Z Rotation
BOOL
TOGGLE
false