Interface IScaleGizmo
_rootMesh: Mesh;
additionalTransformNode?: TransformNode;
anchorPoint: GizmoAnchorPoint;
attachedMesh: Nullable<AbstractMesh>;
attachedNode: Nullable<Node>;
coloredMaterial: StandardMaterial;
coordinatesMode: GizmoCoordinatesMode;
customRotationQuaternion: Nullable<Quaternion>;
disableMaterial: StandardMaterial;
gizmoLayer: UtilityLayerRenderer;
hoverMaterial: StandardMaterial;
incrementalSnap: boolean;
isDragging: boolean;
isHovered: boolean;
onDragEndObservable: Observable<DragStartEndEvent>;
onDragObservable: Observable<DragEvent>;
onDragStartObservable: Observable<DragStartEndEvent>;
scaleRatio: number;
sensitivity: number;
snapDistance: number;
uniformScaleGizmo: IAxisScaleGizmo;
updateGizmoPositionToMatchAttachedMesh: boolean;
updateGizmoRotationToMatchAttachedMesh: boolean;
updateScale: boolean;
xGizmo: IAxisScaleGizmo;
yGizmo: IAxisScaleGizmo;
zGizmo: IAxisScaleGizmo;
addToAxisCache(mesh: Mesh, cache: GizmoAxisCache): void;
dispose(): void;
releaseDrag(): void;
setCustomMesh(mesh: Mesh): void;
}
Hierarchy (View Summary)
- IGizmo
- IScaleGizmo
Implemented by
Index
Properties
Methods
Properties
_
The root mesh of the gizmo
Optionaladditional
Additional transform applied to the gizmo. It's useful when the gizmo is attached to a bone: if the bone is part of a skeleton attached to a mesh, you should define the mesh as additionalTransformNode if you want the gizmo to be displayed at the bone's correct location. Otherwise, as the gizmo is relative to the skeleton root, the mesh transformation will not be taken into account.
anchor
Defines where the gizmo will be positioned if updateGizmoPositionToMatchAttachedMesh is enabled.
(Default: GizmoAnchorPoint.Origin)
attached
Mesh that the gizmo will be attached to. (eg. on a drag gizmo the mesh that will be dragged)
- When set, interactions will be enabled
attached
Node that the gizmo will be attached to. (eg. on a drag gizmo the mesh, bone or NodeTransform that will be dragged)
- When set, interactions will be enabled
colored
Default material used to render when gizmo is not disabled or hovered
coordinates
Set the coordinate mode to use. By default it's local.
custom
Orientation that the gizmo will be displayed with. When set null, default value will be used (Quaternion(0, 0, 0, 1))
disable
Material used to render when gizmo is disabled. typically grey.
gizmo
The utility layer the gizmo will be added to
hover
Material used to render when gizmo is hovered with mouse
incremental
Incremental snap scaling. When true, with a snapDistance of 0.1, scaling will be 1.1,1.2,1.3 instead of, when false: 1.1,1.21,1.33,...
Readonlyis
True when the mouse pointer is dragging a gizmo mesh
Readonlyis
True when the mouse pointer is hovered a gizmo mesh
on
Fires an event when any of it's sub gizmos are released from dragging
on
Fires an event when any of it's sub gizmos are being dragged
on
Fires an event when any of it's sub gizmos are dragged
scale
Ratio for the scale of the gizmo
sensitivity
Sensitivity factor for dragging
snap
Drag distance in babylon units that the gizmo will snap to when dragged
uniform
Internal gizmo used to scale all axis equally
update
If set the gizmo's position will be updated to match the attached mesh each frame (Default: true)
update
If set the gizmo's rotation will be updated to match the attached mesh each frame (Default: true)
update
When set, the gizmo will always appear the same size no matter where the camera is (default: true)
x
Internal gizmo used for interactions on the x axis
y
Internal gizmo used for interactions on the y axis
z
Internal gizmo used for interactions on the z axis
Methods
add
-
Builds Gizmo Axis Cache to enable features such as hover state preservation and graying out other axis during manipulation
Parameters
- mesh: Mesh
Axis gizmo mesh
- cache: GizmoAxisCache
Gizmo axis definition used for reactive gizmo UI
Returns void
- mesh: Mesh
dispose
-
Releases all held resources
Returns void
release
-
Force release the drag action by code
Returns void
set
-
Disposes and replaces the current meshes in the gizmo with the specified mesh
Parameters
- mesh: Mesh
The mesh to replace the default mesh of the gizmo
Returns void
- mesh: Mesh
Interface for scale gizmo