Skip to main content

Class: SegmentationIntersectionTool

Abstract class for tools which create and display annotations on the cornerstone3D canvas. In addition, it provides a base class for segmentation tools that require drawing an annotation before running the segmentation strategy for instance threshold segmentation based on an area and a threshold. Annotation tools make use of drawing utilities to draw SVG elements on the viewport.

To create a new annotation tool, derive from this class and implement the abstract methods.

Extends

Constructors

new SegmentationIntersectionTool()

new SegmentationIntersectionTool(toolProps, defaultToolProps): SegmentationIntersectionTool

Parameters

toolProps: PublicToolProps = {}

defaultToolProps: SharedToolProp = ...

Returns

SegmentationIntersectionTool

Overrides

AnnotationDisplayTool.constructor

Defined in

tools/src/tools/SegmentationIntersectionTool.ts:27

Properties

configuration

configuration: Record<string, any>

Inherited from

AnnotationDisplayTool.configuration

Defined in

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


mode

mode: ToolModes

Tool Mode - Active/Passive/Enabled/Disabled/

Inherited from

AnnotationDisplayTool.mode

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

static toolName: any

Overrides

AnnotationDisplayTool.toolName

Defined in

tools/src/tools/SegmentationIntersectionTool.ts:25

Methods

_init()

_init(): void

Initialize the annotation data and calculates surface intersections

Returns

void

Defined in

tools/src/tools/SegmentationIntersectionTool.ts:42


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


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

AnnotationDisplayTool.filterInteractableAnnotationsForElement

Defined in

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


getReferencedImageId()

protected getReferencedImageId(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()

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

AnnotationDisplayTool.getTargetId

Defined in

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


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

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


onCameraModified()

onCameraModified(evt): void

Parameters

evt: CameraModifiedEvent

Returns

void

Defined in

tools/src/tools/SegmentationIntersectionTool.ts:91


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


onSetToolEnabled()

onSetToolEnabled(): void

Returns

void

Defined in

tools/src/tools/SegmentationIntersectionTool.ts:87


renderAnnotation()

renderAnnotation(enabledElement, svgDrawingHelper): boolean

Renders the surface intersections

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/SegmentationIntersectionTool.ts:101


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