Class: ReferenceCursors
ReferenceCursors is a tool that will show your cursors position in all other elements in the toolGroup if they have a matching FrameOfReference relative to its position in world space. Also when positionSync is enabled, it will try to sync viewports so that the cursor can be displayed in the correct position in all viewports.
Configuration:
- positionSync: boolean, if true, it will try to sync viewports so that the cursor can be displayed in the correct position in all viewports.
- disableCursor: boolean, if true, it will hide the cursor in all viewports. You need to disable and reactivate the tool for this to apply.
- displayThreshold: number, if the distance of the cursor in a viewport is bigger than this threshold the cursor will not be displayed.
Only uses Active and Disabled state
Extends
Constructors
new ReferenceCursors()
new ReferenceCursors(
toolProps,defaultToolProps):ReferenceCursors
Parameters
• toolProps: PublicToolProps = {}
• defaultToolProps: SharedToolProp = ...
Returns
Overrides
AnnotationDisplayTool.constructor
Defined in
tools/src/tools/ReferenceCursors.ts:58
Properties
_currentCanvasPosition
_currentCanvasPosition:
Point2=null
Defined in
tools/src/tools/ReferenceCursors.ts:54
_currentCursorWorldPosition
_currentCursorWorldPosition:
Point3=null
Defined in
tools/src/tools/ReferenceCursors.ts:53
_disableCursorEnabled
_disableCursorEnabled:
boolean=false
Defined in
tools/src/tools/ReferenceCursors.ts:56
_elementWithCursor
_elementWithCursor:
HTMLDivElement=null
Defined in
tools/src/tools/ReferenceCursors.ts:52
configuration
configuration:
Record<string,any>
Inherited from
AnnotationDisplayTool.configuration
Defined in
tools/src/tools/base/BaseTool.ts:17
isDrawing
isDrawing:
boolean=false
Defined in
tools/src/tools/ReferenceCursors.ts:50
isHandleOutsideImage
isHandleOutsideImage:
boolean=false
Defined in
tools/src/tools/ReferenceCursors.ts:51
mode
mode:
ToolModes
Tool Mode - Active/Passive/Enabled/Disabled/
Inherited from
Defined in
tools/src/tools/base/BaseTool.ts:21
supportedInteractionTypes
supportedInteractionTypes:
InteractionTypes[]
Supported Interaction Types - currently only Mouse
Inherited from
AnnotationDisplayTool.supportedInteractionTypes
Defined in
tools/src/tools/base/BaseTool.ts:15
toolGroupId
toolGroupId:
string
ToolGroup ID the tool instance belongs to
Inherited from
AnnotationDisplayTool.toolGroupId
Defined in
tools/src/tools/base/BaseTool.ts:19
toolName
statictoolName:any
Overrides
AnnotationDisplayTool.toolName
Defined in
tools/src/tools/ReferenceCursors.ts:49
Methods
applyActiveStrategy()
applyActiveStrategy(
enabledElement,operationData):any
Applies the active strategy function to the enabled element with the specified operation data.
Parameters
• enabledElement: IEnabledElement
The element that is being operated on.
• operationData: unknown
The data that needs to be passed to the strategy.
Returns
any
The result of the strategy.
Inherited from
AnnotationDisplayTool.applyActiveStrategy
Defined in
tools/src/tools/base/BaseTool.ts:62
applyActiveStrategyCallback()
applyActiveStrategyCallback(
enabledElement,operationData,callbackType):any
Applies the active strategy, with a given event type being applied. The event type function is found by indexing it on the active strategy function.
Parameters
• enabledElement: IEnabledElement
The element that is being operated on.
• operationData: unknown
The data that needs to be passed to the strategy.
• callbackType: string
the type of the callback
Returns
any
The result of the strategy.
Inherited from
AnnotationDisplayTool.applyActiveStrategyCallback
Defined in
tools/src/tools/base/BaseTool.ts:86
createInitialAnnotation()
createInitialAnnotation(
worldPos,element):void
Parameters
• worldPos: Point3
• element: HTMLDivElement
Returns
void
Defined in
tools/src/tools/ReferenceCursors.ts:139
filterInteractableAnnotationsForElement()
filterInteractableAnnotationsForElement(
element,annotations):Annotations
Given the element and annotations which is an array of annotation, it filters the annotations array to only include the annotation based on the viewportType. If the viewport is StackViewport, it filters based on the current imageId of the viewport, if the viewport is volumeViewport, it only returns those that are within the same slice as the current rendered slice in the volume viewport. imageId as the enabledElement.
Parameters
• element: HTMLDivElement
The HTML element
• annotations: Annotations
The annotations to filter (array of annotation)
Returns
The filtered annotations
Overrides
AnnotationDisplayTool.filterInteractableAnnotationsForElement
Defined in
tools/src/tools/ReferenceCursors.ts:295
getActiveAnnotation()
getActiveAnnotation(
element):Annotation
Parameters
• element: HTMLDivElement
Returns
Defined in
tools/src/tools/ReferenceCursors.ts:215
getReferencedImageId()
protectedgetReferencedImageId(viewport,worldPos,viewPlaneNormal,viewUp?):string
Parameters
• viewport: Viewport
• worldPos: Point3
• viewPlaneNormal: Point3
• viewUp?: Point3
Returns
string
Inherited from
AnnotationDisplayTool.getReferencedImageId
Defined in
tools/src/tools/base/AnnotationDisplayTool.ts:126
getStyle()
getStyle(
property,specifications,annotation?):unknown
It takes the property (color, lineDash, etc.) and based on the state of the annotation (selected, highlighted etc.) it returns the appropriate value based on the central toolStyle settings for each level of specification.
Parameters
• property: string
The name of the style property to get.
• specifications: StyleSpecifier
• annotation?: Annotation
The annotation for the tool that is currently active.
Returns
unknown
The value of the property.
Inherited from
AnnotationDisplayTool.getStyle
Defined in
tools/src/tools/base/AnnotationDisplayTool.ts:163
getTargetId()
protectedgetTargetId(viewport):string
Get the target Id for the viewport which will be used to store the cached statistics scoped to that target in the annotations. For StackViewport, targetId is the viewportId, but for the volume viewport, the targetId will be grabbed from the volumeId if particularly specified in the tool configuration, or if not, the first actorUID in the viewport.
Parameters
• viewport: Viewport
viewport to get the targetId for
Returns
string
targetId
Inherited from
AnnotationDisplayTool.getTargetId
Defined in
tools/src/tools/base/BaseTool.ts:197
getTargetImageData()
protectedgetTargetImageData(targetId):IImageData|CPUIImageData
Get the image that is displayed for the targetId in the cachedStats which can be
imageId:<imageId>volumeId:<volumeId>videoId:<basePathForVideo>/frames/<frameSpecifier>
Parameters
• targetId: string
annotation targetId stored in the cached stats
Returns
IImageData | CPUIImageData
The image data for the target.
Inherited from
AnnotationDisplayTool.getTargetImageData
Defined in
tools/src/tools/base/BaseTool.ts:140
getToolName()
getToolName():
string
Returns the name of the tool
Returns
string
The name of the tool.
Inherited from
AnnotationDisplayTool.getToolName
Defined in
tools/src/tools/base/BaseTool.ts:50
mouseMoveCallback()
mouseMoveCallback(
evt):boolean
Overwritten mouseMoveCallback since we want to keep track of the current mouse position and redraw on mouseMove Event handler for Cornerstone MOUSE_MOVE event.
Parameters
• evt: InteractionEventType
The normalized mouse event
Returns
boolean
True if the annotation needs to be re-drawn by the annotationRenderingEngine.
Defined in
tools/src/tools/ReferenceCursors.ts:84
onCameraModified()
onCameraModified(
evt):void
Parameters
• evt: CameraModifiedEvent
Returns
void
Defined in
tools/src/tools/ReferenceCursors.ts:254
onImageSpacingCalibrated()
onImageSpacingCalibrated(
evt):void
On Image Calibration, take all the annotation from the AnnotationState manager, and invalidate them to force them to be re-rendered and their stats to be recalculated. Then use the old and new imageData (non-calibrated and calibrated) to calculate the new position for the annotations in the space of the new imageData.
Parameters
• evt: ImageSpacingCalibratedEvent
The calibration event
Returns
void
Inherited from
AnnotationDisplayTool.onImageSpacingCalibrated
Defined in
tools/src/tools/base/AnnotationDisplayTool.ts:83
onSetToolActive()
onSetToolActive():
void
Returns
void
Defined in
tools/src/tools/ReferenceCursors.ts:102
onSetToolDisabled()
onSetToolDisabled():
void
Returns
void
Defined in
tools/src/tools/ReferenceCursors.ts:121
renderAnnotation()
renderAnnotation(
enabledElement,svgDrawingHelper):boolean
Draws the cursor representation on the enabledElement Checks if a stack change has happened and updates annotation in that case
Parameters
• enabledElement: IEnabledElement
The Cornerstone's enabledElement.
• svgDrawingHelper: SVGDrawingHelper
The svgDrawingHelper providing the context for drawing.
Returns
boolean
Overrides
AnnotationDisplayTool.renderAnnotation
Defined in
tools/src/tools/ReferenceCursors.ts:330
setActiveStrategy()
setActiveStrategy(
strategyName):void
Sets the active strategy for a tool. Strategies are multiple implementations of tool behavior that can be switched by tool configuration.
Parameters
• strategyName: string
name of the strategy to be set as active
Returns
void
Inherited from
AnnotationDisplayTool.setActiveStrategy
Defined in
tools/src/tools/base/BaseTool.ts:126
setConfiguration()
setConfiguration(
newConfiguration):void
merges the new configuration with the tool configuration
Parameters
• newConfiguration: Record<string, any>
Returns
void
Inherited from
AnnotationDisplayTool.setConfiguration
Defined in
tools/src/tools/base/BaseTool.ts:112
updateAnnotationPosition()
updateAnnotationPosition(
element,annotation):void
updates the position of the annotation to match the currently set world position
Parameters
• element: HTMLDivElement
• annotation: Annotation
Returns
void
Defined in
tools/src/tools/ReferenceCursors.ts:227
updateViewportImage()
updateViewportImage(
viewport):void
Parameters
• viewport: StackViewport | VolumeViewport
Returns
void