HandleOperator

class Operators.HandleOperator(): Handles are added scene elements that can update the position of your parts through user interaction. Find more information [here](https://docs.techsoft3d.com/communicator/latest/tutorials/additive-manufacturing/handles.html).

Constructors

constructor()

Constructors

HandleOperator.constructor(viewer, view)

Arguments

viewer (WebViewer()) – None
view (View()) – None

Return type

HandleOperator

Methods

addAxisRotationHandle

HandleOperator.addAxisRotationHandle(position, axis, color, positionNormal, groupId)

Arguments

position (Point3()) – center of the handle.
axis (Point3()) – axis to rotate around
color (Color()) – color of the handle geometry
positionNormal (null | Point3()) – optional vector to control the orientation of the handle geometry.
groupId (null | number()) – optional parameter to associate this handle with a group of NodeIds

Adds a handle that rotates around an axis

Return type: Promise <number>

addAxisTranslationHandle

HandleOperator.addAxisTranslationHandle(position, axis, color, positionNormal, groupId)

Arguments

position (Point3()) – center of the handle.
axis (Point3()) – axis to move along
color (Color()) – color of the handle geometry
positionNormal (null | Point3()) – optional vector to control the orientation of the handle geometry.
groupId (null | number()) – optional parameter to associate this handle with a group of NodeIds

Adds a handle that moves along an axis.

Return type: Promise <number>

addHandles

HandleOperator.addHandles(nodeIds, position, groupId)

Arguments

nodeIds ([number]()) – corresponding to the parts that will move with the handles
position (null | Point3()) – world space coordinates the the handle position
groupId (null | number()) – None

Adds all handles into the scene, oriented along the primary axes

Return type: Promise <void>

addMapping

HandleOperator.addMapping(button, modifier)

Arguments

button (Button()) – None
modifier (KeyModifiers()) – None

Adds a button and key modifier mapping for the operator. If no mapping is provided, all combinations are considered valid. All mappings require a mouse button, but a key modifier is optional.

Return type: void

addPlaneTranslationHandle

HandleOperator.addPlaneTranslationHandle(position, normal, faceColor, lineColor, positionNormal, groupId)

Arguments

position (Point3()) – center of the handle.
normal (Point3()) – normal of the plane
faceColor (Color()) – face color of the handle geometry
lineColor (Color()) – outline color of the handle geometry
positionNormal (null | Point3()) – optional vector to control the orientation of the handle geometry.
groupId (null | number()) – optional parameter to associate this handle with a group of NodeIds

Adds a handle that restricts movement to a plane.

Return type: Promise <number>

addTrackedPoint

HandleOperator.addTrackedPoint(point)

Arguments

point (Point3()) – None

Add a point to the tracked points list. When the handle moves, these points will update in world space.

Returns: point index
Return type: number

addViewPlaneTranslationHandle

HandleOperator.addViewPlaneTranslationHandle(position, color, groupId)

Arguments

position (Point3()) – center of the handle
color (Color()) – geometry color
groupId (null | number()) – optional parameter to associate this handle with a group of NodeIds

Adds a handle that restricts movement to the viewplane.

Return type: Promise <number>

clearMapping

HandleOperator.clearMapping()

Clears any button and key modifier mappings for the operator.

Return type: void

clearTrackedPoints

HandleOperator.clearTrackedPoints()

Clear the list of tracked points.

Return type: void

generateGroupId

HandleOperator.generateGroupId()

This will generate a unique id to associate a group of handles with a group of NodeIds.

Return type: number

getNodeIds

HandleOperator.getNodeIds(groupId)

Arguments

groupId (null | number()) – optional parameter that specifies if the NodeIds to retrieve are part of a group.

Gets the NodeIds that the handles in the scene will move.

Return type: [number]

getPosition

HandleOperator.getPosition()

Returns: the current handle position or null if not currently active.
Return type: null | Point3

getTrackedPoints

HandleOperator.getTrackedPoints()

Gets the tracked point list.

Return type: [Point3]

getTranslation

HandleOperator.getTranslation()

Returns: the total translation applied to the handles.
Return type: Point3

isEnabled

HandleOperator.isEnabled()

Returns a boolean value indicating if handles are available to be added to the scene If there is an active explode, active measure, or the model is a 2d drawing. this will be false.

Return type: boolean

removeHandles

HandleOperator.removeHandles()

Removes all handles from the scene.

Return type: Promise <void>

setAxisMeshData

HandleOperator.setAxisMeshData(meshData)

Arguments

meshData (MeshData()) – None

Sets the mesh data for axis handles.

Return type: Promise <void>

setHandleSize

HandleOperator.setHandleSize(size)

Arguments

size (number()) – None

Takes a scale value to change the handle size with 1 representing the default size

Return type: void

setMapping

HandleOperator.setMapping(button, modifier)

Arguments

button (Button()) – None
modifier (KeyModifiers()) – None

Sets the button and key modifier mapping for the operator.

Return type: void

setNodeIds

HandleOperator.setNodeIds(nodeIds, groupId)

Arguments

nodeIds ([number]()) – None
groupId (null | number()) – optional parameter that associates a group of NodeIds with a group of handles.

Sets the NodeIds that any handles in the scene will move.

Return type: void

setPlaneMeshData

HandleOperator.setPlaneMeshData(meshData)

Arguments

meshData (MeshData()) – None

Sets the mesh data for plane handles.

Return type: Promise <void>

setRotateMeshData

HandleOperator.setRotateMeshData(meshData)

Arguments

meshData (MeshData()) – None

Sets the mesh data for rotation handles.

Return type: Promise <void>

setViewPlaneMeshData

HandleOperator.setViewPlaneMeshData(meshData)

Arguments

meshData (MeshData()) – None

Sets the mesh data for view plane handles.

Return type: Promise <void>

showHandles

HandleOperator.showHandles()

Shows any handles that have been added to the scene.

Return type: void

updatePosition

HandleOperator.updatePosition(translation, rotation, finalizePosition, groupId)

Arguments

translation (Point3()) – additional translation
rotation (Matrix()) – additional rotation
finalizePosition (boolean()) – keep translation and rotation. If true, added translation and rotation will not reset the next time the position is updated.
groupId (null | number()) – None

Updates the current handle position.

Return type: Promise <void>