Skip to main content

Class: ScaleOverlayTool

ScaleOverlayTool

Memberof

Tools

Classdesc

Tool for displaying a scale overlay on the image.

Extends

Constructors

new ScaleOverlayTool()

new ScaleOverlayTool(toolProps, defaultToolProps): ScaleOverlayTool

Parameters

toolProps: PublicToolProps = {}

defaultToolProps: SharedToolProp = ...

Returns

ScaleOverlayTool

Overrides

AnnotationDisplayTool.constructor

Defined in

tools/src/tools/ScaleOverlayTool.ts:44

Properties

_throttledCalculateCachedStats

_throttledCalculateCachedStats: Function

Defined in

tools/src/tools/ScaleOverlayTool.ts:35


configuration

configuration: Record<string, any>

Inherited from

AnnotationDisplayTool.configuration

Defined in

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


editData

editData: object = null

annotation

annotation: ScaleOverlayAnnotation

renderingEngine

renderingEngine: RenderingEngine

viewport

viewport: Viewport

Defined in

tools/src/tools/ScaleOverlayTool.ts:36


isDrawing

isDrawing: boolean

Defined in

tools/src/tools/ScaleOverlayTool.ts:41


isHandleOutsideImage

isHandleOutsideImage: boolean

Defined in

tools/src/tools/ScaleOverlayTool.ts:42


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/ScaleOverlayTool.ts:33

Methods

_getTextLines()

_getTextLines(scaleSize): string[]

Parameters

scaleSize: number

Returns

string[]

Defined in

tools/src/tools/ScaleOverlayTool.ts:382


_init()

_init(): void

Returns

void

Defined in

tools/src/tools/ScaleOverlayTool.ts:56


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


computeCanvasScaleCoordinates()

computeCanvasScaleCoordinates(canvasSize, canvasCoordinates, vscaleBounds, hscaleBounds, location): any

Computes the centered canvas coordinates for scale

Parameters

canvasSize: any

canvasCoordinates: any

vscaleBounds: any

hscaleBounds: any

location: any

Returns

any

scaleCanvasCoordinates

Defined in

tools/src/tools/ScaleOverlayTool.ts:624


computeEndScaleTicks()

computeEndScaleTicks(canvasCoordinates, location): object

calculates scale ticks for ends of the scale

Parameters

canvasCoordinates: any

location: any

Returns

object

leftTick, rightTick

endTick1

endTick1: any[][]

endTick2

endTick2: any[][]

Defined in

tools/src/tools/ScaleOverlayTool.ts:434


computeInnerScaleTicks()

computeInnerScaleTicks(scaleSize, location, annotationUID, leftTick, rightTick): object

Parameters

scaleSize: number

location: string

annotationUID: string

leftTick: Point2[]

rightTick: Point2[]

Returns

object

tickCoordinates

tickCoordinates: any[]

tickIds

tickIds: any[]

tickUIDs

tickUIDs: any[]

Defined in

tools/src/tools/ScaleOverlayTool.ts:481


computeScaleBounds()

computeScaleBounds(canvasSize, horizontalReduction, verticalReduction, location): object

Computes the max bound for scales on the image

Parameters

canvasSize: any

horizontalReduction: any

verticalReduction: any

location: any

Returns

object

height

height: any

width

width: any

Defined in

tools/src/tools/ScaleOverlayTool.ts:658


computeScaleSize()

computeScaleSize(worldWidthViewport, worldHeightViewport, location): any

Parameters

worldWidthViewport: number

worldHeightViewport: number

location: string

Returns

any

currentScaleSize

Defined in

tools/src/tools/ScaleOverlayTool.ts:403


computeWorldScaleCoordinates()

computeWorldScaleCoordinates(scaleSize, location, pointSet): any

Parameters

scaleSize: any

location: any

pointSet: any

Returns

any

Defined in

tools/src/tools/ScaleOverlayTool.ts:554


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/ScaleOverlayTool.ts:159


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/ScaleOverlayTool.ts:155


renderAnnotation()

renderAnnotation(enabledElement, svgDrawingHelper): boolean

Used to draw the scale annotation in each request animation frame.

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/ScaleOverlayTool.ts:175


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