Skip to main content

ProbeTool

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.

Hierarchy

Index

Constructors

constructor

  • Parameters

    Returns default

Properties

publicconfiguration

configuration: Record<string, any>

editData

editData: { annotation: any; newAnnotation?: boolean; viewportIdsToRender: string[] }

Type declaration

  • annotation: any
  • optionalnewAnnotation?: boolean
  • viewportIdsToRender: string[]

eventDispatchDetail

eventDispatchDetail: { renderingEngineId: string; viewportId: string }

Type declaration

  • renderingEngineId: string
  • viewportId: string

isDrawing

isDrawing: boolean

isHandleOutsideImage

isHandleOutsideImage: boolean

publicmode

mode: ToolModes

Tool Mode - Active/Passive/Enabled/Disabled/

mouseDragCallback

mouseDragCallback: any

publicsupportedInteractionTypes

supportedInteractionTypes: Mouse[]

Supported Interaction Types - currently only Mouse

publictoolGroupId

toolGroupId: string

ToolGroup ID the tool instance belongs to

touchDragCallback

touchDragCallback: any

statictoolName

toolName: string = 'Probe'

Methods

_activateModify

  • _activateModify(element: any): void
  • Parameters

    • element: any

    Returns void

_calculateCachedStats

  • _calculateCachedStats(annotation: any, renderingEngine: any, enabledElement: any): any
  • Parameters

    • annotation: any
    • renderingEngine: any
    • enabledElement: any

    Returns any

_deactivateModify

  • _deactivateModify(element: any): void
  • Parameters

    • element: any

    Returns void

_getTextLines

  • _getTextLines(data: any, targetId: any): any[]
  • Parameters

    • data: any
    • targetId: any

    Returns any[]

_getValueForModality

  • _getValueForModality(value: any, imageVolume: any, modality: any): {}
  • Parameters

    • value: any
    • imageVolume: any
    • modality: any

    Returns {}

    _mouseDragCallback

    • _mouseDragCallback(evt: any): void
    • Parameters

      • evt: any

      Returns void

    _mouseUpCallback

    • _mouseUpCallback(evt: MouseUpEventType | MouseClickEventType): void
    • Parameters

      • evt: MouseUpEventType | MouseClickEventType

      Returns void

    addNewAnnotation

    • addNewAnnotation(evt: MouseDownActivateEventType): 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: MouseDownActivateEventType

        EventTypes.NormalizedMouseEventType

      Returns ProbeAnnotation

      The annotation object.

    publicapplyActiveStrategy

    • applyActiveStrategy(enabledElement: IEnabledElement, operationData: unknown): any
    • It applies the active strategy to the enabled element.


      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.

    cancel

    • cancel(element: HTMLDivElement): any
    • Parameters

      • element: HTMLDivElement

      Returns any

    filterInteractableAnnotationsForElement

    • @virtual

      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

    getHandleNearImagePoint

    • getHandleNearImagePoint(element: HTMLDivElement, annotation: ProbeAnnotation, canvasCoords: Point2, proximity: number): 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.

    publicgetLinkedTextBoxStyle

    • getLinkedTextBoxStyle(specifications: StyleSpecifier, annotation?: Annotation): Record<string, unknown>
    • It returns the style for the text box


      Parameters

      • specifications: StyleSpecifier
      • optionalannotation: Annotation

        The annotation for the tool that is currently active.

      Returns Record<string, unknown>

      An object of the style settings for the text box.

    publicgetStyle

    • getStyle(property: string, specifications: StyleSpecifier, annotation?: 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
      • optionalannotation: Annotation

        The annotation for the tool that is currently active.

      Returns unknown

      The value of the property.

    publicgetToolName

    • getToolName(): string
    • Returns the name of the tool


      Returns string

      The name of the tool.

    handleSelectedCallback

    • handleSelectedCallback(evt: MouseDownEventType, annotation: ProbeAnnotation, handle: ToolHandle, interactionType?: string): void
    • handleSelectedCallback Custom callback for when a handle is selected.


      Parameters

      • evt: MouseDownEventType
      • annotation: ProbeAnnotation
      • handle: ToolHandle
      • interactionType: string = 'mouse'

      Returns void

    isPointNearTool

    • isPointNearTool(): boolean
    • Returns true if the provided canvas coordinate tool is near the annotation


      Returns boolean

      boolean if the point is near.

    publicmouseMoveCallback

    • mouseMoveCallback(evt: MouseMoveEventType, filteredAnnotations?: Annotations): boolean
    • @virtual

      Event handler for Cornerstone MOUSE_MOVE event.


      Parameters

      • evt: MouseMoveEventType

        The normalized mouse event

      • optionalfilteredAnnotations: Annotations

        The annotations to check for hover interactions

      Returns boolean

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

    publiconImageSpacingCalibrated

    • onImageSpacingCalibrated(evt: ImageSpacingCalibratedEvent): 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

    renderAnnotation

    • 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

    publicsetActiveStrategy

    • setActiveStrategy(strategyName: string): 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

    publicsetConfiguration

    • setConfiguration(newConfiguration: Record<string, any>): void
    • merges the new configuration with the tool configuration


      Parameters

      • newConfiguration: Record<string, any>

      Returns void

    toolSelectedCallback

    • toolSelectedCallback(): void
    • Custom callback for when an annotation is selected


      Returns void