Class: DragProbeTool

ProbeTool let you get the underlying voxel value by putting a probe in that location. It will give index of the location and value of the voxel. You can use ProbeTool in all perpendicular views (axial, sagittal, coronal). Note: annotation tools in cornerstone3DTools exists in the exact location in the physical 3d space, as a result, by default, all annotations that are drawing in the same frameOfReference will get shared between viewports that are in the same frameOfReference. Probe tool's text box are dynamically generated based on the viewport's underlying Modality. For instance, if the viewport is displaying CT, the text box will shown the statistics in Hounsfield units, and if the viewport is displaying PET, the text box will show the statistics in SUV units.

The resulting annotation's data (statistics) and metadata (the state of the viewport while drawing was happening) will get added to the ToolState manager and can be accessed from the ToolState by calling getAnnotations or similar methods.

To use the ProbeTool, you first need to add it to cornerstoneTools, then create a toolGroup and add the ProbeTool to it. Finally, setToolActive on the toolGroup

cornerstoneTools.addTool(ProbeTool)

const toolGroup = ToolGroupManager.createToolGroup('toolGroupId')

toolGroup.addTool(ProbeTool.toolName)

toolGroup.addViewport('viewportId', 'renderingEngineId')

toolGroup.setToolActive(ProbeTool.toolName, {
  bindings: [
   {
      mouseButton: MouseBindings.Primary, // Left Click
    },
  ],
})

Read more in the Docs section of the website.

Extends

• ProbeTool

Constructors

new DragProbeTool()

new DragProbeTool(toolProps, defaultToolProps): DragProbeTool

Parameters

• toolProps: PublicToolProps = {}

• defaultToolProps: SharedToolProp = ...

Returns

DragProbeTool

Overrides

ProbeTool.constructor

Defined in

tools/src/tools/annotation/DragProbeTool.ts:40

Properties

configuration

configuration: Record<string, any>

Inherited from

ProbeTool.configuration

Defined in

tools/src/tools/base/BaseTool.ts:19

---

editData

editData: object

annotation

annotation: Annotation

newAnnotation?

optional newAnnotation: boolean

viewportIdsToRender

viewportIdsToRender: string[]

Overrides

ProbeTool.editData

Defined in

tools/src/tools/annotation/DragProbeTool.ts:28

---

eventDispatchDetail

eventDispatchDetail: object

renderingEngineId

renderingEngineId: string

viewportId

viewportId: string

Overrides

ProbeTool.eventDispatchDetail

Defined in

tools/src/tools/annotation/DragProbeTool.ts:33

---

isDrawing

isDrawing: boolean

Overrides

ProbeTool.isDrawing

Defined in

tools/src/tools/annotation/DragProbeTool.ts:37

---

isHandleOutsideImage

isHandleOutsideImage: boolean

Overrides

ProbeTool.isHandleOutsideImage

Defined in

tools/src/tools/annotation/DragProbeTool.ts:38

---

isSuvScaled()

isSuvScaled: (viewport, targetId, imageId?) => boolean = AnnotationTool.isSuvScaled

Returns true if the viewport is scaled to SUV units

Parameters

• viewport: StackViewport | VolumeViewport

The viewport

• targetId: string

The annotation targetId

• imageId?: string

The annotation imageId

Returns

boolean

Inherited from

ProbeTool.isSuvScaled

Defined in

tools/src/tools/base/AnnotationTool.ts:401

---

memo

protected memo: Memo

A memo recording the starting state of a tool. This will be updated as changes are made, and reflects the fact that a memo has been created.

Inherited from

ProbeTool.memo

Defined in

tools/src/tools/base/BaseTool.ts:28

---

mode

mode: ToolModes

Tool Mode - Active/Passive/Enabled/Disabled/

Inherited from

ProbeTool.mode

Defined in

tools/src/tools/base/BaseTool.ts:23

---

supportedInteractionTypes

supportedInteractionTypes: InteractionTypes[]

Supported Interaction Types - currently only Mouse

Inherited from

ProbeTool.supportedInteractionTypes

Defined in

tools/src/tools/base/BaseTool.ts:17

---

toolGroupId

toolGroupId: string

ToolGroup ID the tool instance belongs to

Inherited from

ProbeTool.toolGroupId

Defined in

tools/src/tools/base/BaseTool.ts:21

---

defaults

static defaults: object

Has the defaults associated with the base tool.

configuration

configuration: object

configuration.activeStrategy

activeStrategy: any = undefined

configuration.defaultStrategy

defaultStrategy: any = undefined

configuration.strategies

strategies: object = {}

configuration.strategyOptions

strategyOptions: object = {}

Inherited from

ProbeTool.defaults

Defined in

tools/src/tools/base/BaseTool.ts:33

---

probeDefaults

static probeDefaults: object

configuration

configuration: object

configuration.getTextLines()

getTextLines: (data, targetId) => string[] = defaultGetTextLines

Parameters

• data: any

• targetId: any

Returns

string[]

configuration.preventHandleOutsideImage

preventHandleOutsideImage: boolean = false

configuration.shadow

shadow: boolean = true

supportedInteractionTypes

supportedInteractionTypes: string[]

Inherited from

ProbeTool.probeDefaults

Defined in

tools/src/tools/annotation/ProbeTool.ts:110

---

toolName

static toolName: any

Overrides

ProbeTool.toolName

Defined in

tools/src/tools/annotation/DragProbeTool.ts:26

Accessors

toolName

get toolName(): string

Newer method for getting the tool name as a property

Returns

string

Inherited from

ProbeTool.toolName

Defined in

tools/src/tools/base/BaseTool.ts:82

Methods

_activateModify()

_activateModify(element): void

Parameters

• element: any

Returns

void

Inherited from

ProbeTool._activateModify

Defined in

tools/src/tools/annotation/ProbeTool.ts:401

---

_calculateCachedStats()

_calculateCachedStats(annotation, renderingEngine, enabledElement, changeType): any

Parameters

• annotation: any

• renderingEngine: any

• enabledElement: any

• changeType: ChangeTypes = ChangeTypes.StatsUpdated

Returns

any

Inherited from

ProbeTool._calculateCachedStats

Defined in

tools/src/tools/annotation/ProbeTool.ts:580

---

_deactivateModify()

_deactivateModify(element): void

Parameters

• element: any

Returns

void

Inherited from

ProbeTool._deactivateModify

Defined in

tools/src/tools/annotation/ProbeTool.ts:413

---

_dragCallback()

_dragCallback(evt): void

Parameters

• evt: any

Returns

void

Inherited from

ProbeTool._dragCallback

Defined in

tools/src/tools/annotation/ProbeTool.ts:360

---

_endCallback()

_endCallback(evt): void

Parameters

• evt: InteractionEventType

Returns

void

Inherited from

ProbeTool._endCallback

Defined in

tools/src/tools/annotation/ProbeTool.ts:322

---

addNewAnnotation()

addNewAnnotation(evt): ProbeAnnotation

Based on the current position of the mouse and the current imageId to create a Probe Annotation and stores it in the annotationManager

Parameters

• evt: InteractionEventType

EventTypes.NormalizedMouseEventType

Returns

ProbeAnnotation

The annotation object.

Inherited from

ProbeTool.addNewAnnotation

Defined in

tools/src/tools/annotation/ProbeTool.ts:197

---

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

ProbeTool.applyActiveStrategy

Defined in

tools/src/tools/base/BaseTool.ts:102

---

applyActiveStrategyCallback()

applyActiveStrategyCallback(enabledElement, operationData, callbackType, ...extraArgs): 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

• ...extraArgs: any[]

Returns

any

The result of the strategy.

Inherited from

ProbeTool.applyActiveStrategyCallback

Defined in

tools/src/tools/base/BaseTool.ts:126

---

cancel()

cancel(element): string

cancel Used to cancel the ongoing tool drawing and manipulation

Parameters

• element: HTMLDivElement

Returns

string

Inherited from

ProbeTool.cancel

Defined in

tools/src/tools/annotation/ProbeTool.ts:377

---

createAnnotation()

protected createAnnotation(evt): Annotation

Creates an annotation containing the basic data set.

Parameters

• evt: InteractionEventType

Returns

Annotation

Inherited from

ProbeTool.createAnnotation

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:134

---

createMemo()

protected createMemo(element, annotation, options?): void

Creates a memo on the given annotation.

Parameters

• element: any

• annotation: any

• options?: any

Returns

void

Inherited from

ProbeTool.createMemo

Defined in

tools/src/tools/base/AnnotationTool.ts:635

---

doneEditMemo()

doneEditMemo(): void

This clears and edit memo storage to allow for further history functions to be called. Calls the complete function if present, and pushes the memo to the history memo stack.

This should be called when a tool has finished making a change which should be separated from future/other changes in terms of the history. Usually that means on endCallback (mouse up), but some tools also make changes on the initial creation of an object or have alternate flows and the doneEditMemo has to be called on mouse down or other initiation events to ensure that new changes are correctly recorded.

If the tool has no end callback, then the doneEditMemo is called from the pre mouse down callback. See ZoomTool for an example of this usage.

Returns

void

Inherited from

ProbeTool.doneEditMemo

Defined in

tools/src/tools/base/BaseTool.ts:305

---

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

Annotations

The filtered annotations

Inherited from

ProbeTool.filterInteractableAnnotationsForElement

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:63

---

getAnnotationStyle()

protected getAnnotationStyle(context): AnnotationStyle

Get the style that will be applied to all annotations such as length, cobb angle, arrow annotate, etc. when rendered on a canvas or svg layer

Parameters

• context

• context.annotation: Annotation

• context.styleSpecifier: StyleSpecifier

Returns

AnnotationStyle

Inherited from

ProbeTool.getAnnotationStyle

Defined in

tools/src/tools/base/AnnotationTool.ts:407

---

getHandleNearImagePoint()

getHandleNearImagePoint(element, annotation, canvasCoords, proximity): ToolHandle

It checks if the mouse click is near ProveTool, it overwrites the baseAnnotationTool getHandleNearImagePoint method.

Parameters

• element: HTMLDivElement

The element that the tool is attached to.

• annotation: ProbeAnnotation

The annotation object associated with the annotation

• canvasCoords: Point2

The coordinates of the mouse click on canvas

• proximity: number

The distance from the mouse cursor to the point that is considered "near".

Returns

ToolHandle

The handle that is closest to the cursor, or null if the cursor is not near any of the handles.

Inherited from

ProbeTool.getHandleNearImagePoint

Defined in

tools/src/tools/annotation/ProbeTool.ts:271

---

getLinkedTextBoxStyle()

getLinkedTextBoxStyle(specifications, annotation?): Record<string, unknown>

It returns the style for the text box

Parameters

• specifications: StyleSpecifier

• annotation?: Annotation

The annotation for the tool that is currently active.

Returns

Record<string, unknown>

An object of the style settings for the text box.

Inherited from

ProbeTool.getLinkedTextBoxStyle

Defined in

tools/src/tools/base/AnnotationTool.ts:340

---

getReferencedImageId()

protected getReferencedImageId(viewport, worldPos, viewPlaneNormal, viewUp?): string

Parameters

• viewport: Viewport

• worldPos: Point3

• viewPlaneNormal: Point3

• viewUp?: Point3

Returns

string

Inherited from

ProbeTool.getReferencedImageId

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:184

---

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

ProbeTool.getStyle

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:221

---

getTargetId()

protected getTargetId(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

ProbeTool.getTargetId

Defined in

tools/src/tools/base/BaseTool.ts:238

---

getTargetImageData()

protected getTargetImageData(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

ProbeTool.getTargetImageData

Defined in

tools/src/tools/base/BaseTool.ts:181

---

getToolName()

getToolName(): string

Returns the name of the tool

Returns

string

The name of the tool.

Inherited from

ProbeTool.getToolName

Defined in

tools/src/tools/base/BaseTool.ts:90

---

handleSelectedCallback()

handleSelectedCallback(evt, annotation): void

handleSelectedCallback Custom callback for when a handle is selected.

Parameters

• evt: InteractionEventType

The normalized mouse event

• annotation: ProbeAnnotation

The annotation selected.

Returns

void

Inherited from

ProbeTool.handleSelectedCallback

Defined in

tools/src/tools/annotation/ProbeTool.ts:292

---

isPointNearTool()

isPointNearTool(): boolean

Returns true if the provided canvas coordinate tool is near the annotation

Returns

boolean

boolean if the point is near.

Inherited from

ProbeTool.isPointNearTool

Defined in

tools/src/tools/annotation/ProbeTool.ts:131

---

mouseMoveCallback()

mouseMoveCallback(evt, filteredAnnotations?): boolean

Event handler for Cornerstone MOUSE_MOVE event.

Parameters

• evt: MouseMoveEventType

The normalized mouse event

• filteredAnnotations?: Annotations

The annotations to check for hover interactions

Returns

boolean

True if the annotation needs to be re-drawn by the annotationRenderingEngine.

Inherited from

ProbeTool.mouseMoveCallback

Defined in

tools/src/tools/base/AnnotationTool.ts:209

---

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

ProbeTool.onImageSpacingCalibrated

Defined in

tools/src/tools/base/AnnotationDisplayTool.ts:88

---

postMouseDownCallback()

postMouseDownCallback(evt): ProbeAnnotation

Parameters

• evt: InteractionEventType

Returns

ProbeAnnotation

Defined in

tools/src/tools/annotation/DragProbeTool.ts:54

---

postTouchStartCallback()

postTouchStartCallback(evt): ProbeAnnotation

Parameters

• evt: InteractionEventType

Returns

ProbeAnnotation

Defined in

tools/src/tools/annotation/DragProbeTool.ts:114

---

redo()

redo(): void

Redo an action (undo the undo)

Returns

void

Inherited from

ProbeTool.redo

Defined in

tools/src/tools/base/BaseTool.ts:261

---

renderAnnotation()

renderAnnotation(enabledElement, svgDrawingHelper): boolean

it is used to draw the probe annotation in each request animation frame. It calculates the updated cached statistics if data is invalidated and cache it.

Parameters

• enabledElement: IEnabledElement

The Cornerstone's enabledElement.

• svgDrawingHelper: SVGDrawingHelper

The svgDrawingHelper providing the context for drawing.

Returns

boolean

Overrides

ProbeTool.renderAnnotation

Defined in

tools/src/tools/annotation/DragProbeTool.ts:120

---

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

ProbeTool.setActiveStrategy

Defined in

tools/src/tools/base/BaseTool.ts:167

---

setConfiguration()

setConfiguration(newConfiguration): void

merges the new configuration with the tool configuration

Parameters

• newConfiguration: Record<string, any>

Returns

void

Inherited from

ProbeTool.setConfiguration

Defined in

tools/src/tools/base/BaseTool.ts:153

---

toolSelectedCallback()

toolSelectedCallback(): void

Custom callback for when an annotation is selected

Returns

void

Inherited from

ProbeTool.toolSelectedCallback

Defined in

tools/src/tools/annotation/ProbeTool.ts:135

---

undo()

undo(): void

Undoes an action

Returns

void

Inherited from

ProbeTool.undo

Defined in

tools/src/tools/base/BaseTool.ts:251

---

createAndAddAnnotation()

static createAndAddAnnotation(viewport, ...annotationBaseData): void

Creates and adds an annotation of the given type, firing the annotation modified event on the new annotation. This implicitly uses the static class when you call it on the correct base class. For example, you can call the KeyImageTool.createAnnotation method on KeyImageTool.toolName by calling KeyImageTool.createAndAddAnnotation

Parameters

• viewport: any

• ...annotationBaseData: any[]

Returns

void

Inherited from

ProbeTool.createAndAddAnnotation

Defined in

tools/src/tools/base/AnnotationTool.ts:109

---

createAnnotation()

static createAnnotation(...annotationBaseData): Annotation

Creates a base annotation object, adding in any annotation base data provided

Parameters

• ...annotationBaseData: any[]

Returns

Annotation

Inherited from

ProbeTool.createAnnotation

Defined in

tools/src/tools/base/AnnotationTool.ts:57

---

createAnnotationForViewport()

static createAnnotationForViewport(viewport, ...annotationBaseData): Annotation

Creates a new annotation for the given viewport. This just adds the viewport reference data to the metadata, and otherwise returns the static class createAnnotation data.

Parameters

• viewport: any

• ...annotationBaseData: any[]

Returns

Annotation

Inherited from

ProbeTool.createAnnotationForViewport

Defined in

tools/src/tools/base/AnnotationTool.ts:94

---

createAnnotationMemo()

static createAnnotationMemo(element, annotation, options?): object

Creates an annotation memo storing the current data state on the given annotation object. This will store/recover handles data, text box and contour data, and if the options are set for deletion, will apply that correctly.

Parameters

• element: any

that the annotation is shown on.

• annotation: Annotation

to store a memo for the current state.

• options?

whether the annotation is being created (newAnnotation) or is in the process of being deleted (deleting)

• Note the naming on deleting is to indicate the deletion is in progress, as the createAnnotationMemo needs to be called BEFORE the annotation is actually deleted.
• deleting with a value of false is the same as newAnnotation=true, as it is simply the opposite direction. Use undefined for both newAnnotation and deleting for non-create/delete operations.

• options.deleting?: boolean

• options.newAnnotation?: boolean

Returns

object

Memo containing the annotation data.

restoreMemo()

restoreMemo: () => void

Returns

void

Inherited from

ProbeTool.createAnnotationMemo

Defined in

tools/src/tools/base/AnnotationTool.ts:544

---

createAnnotationState()

protected static createAnnotationState(annotation, deleting?): object

Creates an annotation state copy to allow storing the current state of an annotation. This class has knowledge about the contour and spline implementations in order to copy the contour object efficiently, and to allow copying the spline object (which has member variables etc).

Parameters

• annotation: Annotation

the annotation to create a clone of

• deleting?: boolean

a flag to indicate that this object is about to be deleted (deleting true), or was just created (deleting false), or neither (deleting undefined).

Returns

object

state information for the given annotation.

annotationUID

annotationUID: string

data

data: object

Index Signature

[key: string]: unknown

data.cachedStats?

optional cachedStats: Record<string, unknown>

Cached Annotation statistics which is specific to the tool

data.handles?

optional handles: object

Annotation handles that are grabbable for manipulation

Index Signature

[key: string]: unknown

data.handles.activeHandleIndex?

optional activeHandleIndex: number

index of the active handle being manipulated

data.handles.points?

optional points: Point3[]

world location of the handles in the space

data.handles.textBox?

optional textBox: object

annotation text box information

data.handles.textBox.hasMoved?

optional hasMoved: boolean

whether the text box has moved

data.handles.textBox.worldBoundingBox?

optional worldBoundingBox: object

text box bounding box information

data.handles.textBox.worldBoundingBox.bottomLeft

bottomLeft: Point3

Bottom left location of the text box in the world space

data.handles.textBox.worldBoundingBox.bottomRight

bottomRight: Point3

Bottom right location of the text box in the world space

data.handles.textBox.worldBoundingBox.topLeft

topLeft: Point3

Top left location of the text box in the world space

data.handles.textBox.worldBoundingBox.topRight

topRight: Point3

Top right location of the text box in the world space

data.handles.textBox.worldPosition?

optional worldPosition: Point3

the world location of the text box

deleting

deleting: boolean

Inherited from

ProbeTool.createAnnotationState

Defined in

tools/src/tools/base/AnnotationTool.ts:491

---

createZoomPanMemo()

static createZoomPanMemo(viewport): object

Creates a zoom/pan memo that remembers the original zoom/pan position for the given viewport.

Parameters

• viewport: any

Returns

object

restoreMemo()

restoreMemo: () => void

Returns

void

Inherited from

ProbeTool.createZoomPanMemo

Defined in

tools/src/tools/base/BaseTool.ts:269

---

hydrate()

static hydrate(viewportId, points, options?): ProbeAnnotation

Parameters

• viewportId: string

• points: Point3[]

• options?

• options.annotationUID?: string

Returns

ProbeAnnotation

Inherited from

ProbeTool.hydrate

Defined in

tools/src/tools/annotation/ProbeTool.ts:137

---

isSuvScaled()

static isSuvScaled(viewport, targetId, imageId?): boolean

Returns true if the viewport is scaled to SUV units

Parameters

• viewport: StackViewport | VolumeViewport

The viewport

• targetId: string

The annotation targetId

• imageId?: string

The annotation imageId

Returns

boolean

Inherited from

ProbeTool.isSuvScaled

Defined in

tools/src/tools/base/AnnotationTool.ts:386

---

mergeDefaultProps()

static mergeDefaultProps(defaultProps, additionalProps?): any

Does a deep merge of property options. Allows extending the default values for a child class.

Parameters

• defaultProps = {}

this is a base set of defaults to merge into

• additionalProps?: any

the additional properties to merge into the default props

Returns

any

defaultProps if additional props not defined, or a merge into a new object containing additionalProps adding onto and overriding defaultProps.

Inherited from

ProbeTool.mergeDefaultProps

Defined in

tools/src/tools/base/BaseTool.ts:72