OpenLIME

Class: LensDashboardNavigatorRadial

LensDashboardNavigatorRadial

LensDashboardNavigatorRadial class creates a circular lens dashboard with radially arranged controls. Provides:

  • Circular arrangement of controls around the lens
  • Grouped tool positioning
  • Animated visibility transitions
  • Background arc for visual grouping

new LensDashboardNavigatorRadial(viewer [, options])

Creates a new LensDashboardNavigatorRadial instance.

Parameters:
Name Type Argument Description
viewer Viewer

The OpenLIME viewer instance
options Object <optional>

Configuration options

Properties
Name Type Argument Default Description
toolSize number <optional>
 34

Size of tool buttons in pixels
toolPadding number <optional>
 0

Padding between tool buttons
group Array.<number> <optional>
 [-65, 0]

Angle positions for tool groups in degrees
actions Object <optional>

Configuration for toolbar actions

Properties
Name Type Argument Description
camera Object <optional>

Camera control action

Properties
Name Type Description
label string

Action identifier
group number

Group index for positioning
angle number

Angle offset within group
task function

Callback for camera action
light Object <optional>

Light control action (same properties as camera)
annoswitch Object <optional>

Annotation toggle action

Properties
Name Type Description
type string

Action type ('toggle')
toggleClass string

CSS class for toggle element
prev Object <optional>

Previous annotation action (same properties as camera)
down Object <optional>

Download annotation action (same properties as camera)
next Object <optional>

Next annotation action (same properties as camera)
updateCb function <optional>

Callback fired during lens updates
updateEndCb function <optional>

Callback fired when lens movement ends
Source:

Extends

Methods

append(elm)

Adds an HTML element to the dashboard container. The element should use absolute positioning relative to the container. Example:

const button = document.createElement('button');
button.style = 'position: absolute; left: 10px; top: 10px;';
lensDashboard.append(button);
Parameters:
Name Type Description
elm HTMLElement

The HTML element to add
Inherited From:
Overrides:
Source:

getAction(label)

Retrieves an action configuration by its label.

Parameters:
Name Type Description
label string

The action label to find
Source:
Returns:

The action configuration object or null if not found

Type
Object | null

removeMaskFromSvgLayer(svg)

Removes the lens mask from an SVG element. Returns the element to its normal, unmasked rendering.

Parameters:
Name Type Description
svg SVGElement

The SVG element to unmask
Inherited From:
Overrides:
Source:

setActionEnabled(label [, enable])

Enables or disables a specific action button.

Parameters:
Name Type Argument Default Description
label string

The action label to modify
enable boolean <optional>
 true

Whether to enable or disable the action
Source:

setBackgroundRenderingMode(mode)

Sets the rendering mode for the background (area outside the lens). Controls whether content outside the lens is shown or hidden.

Parameters:
Name Type Description
mode RenderingMode

The rendering mode to use
Inherited From:
Overrides:
Source:

setLayerSvgAnnotation(layer)

Associates a LayerSvgAnnotation with the dashboard. This enables proper masking of SVG annotations within the lens area.

Parameters:
Name Type Description
layer LayerSvgAnnotation

The SVG annotation layer to associate
Inherited From:
Overrides:
Source:

setLensRenderingMode(mode)

Sets the rendering mode for the lens area. Controls whether content inside the lens is shown or hidden.

Parameters:
Name Type Description
mode RenderingMode

The rendering mode to use
Inherited From:
Overrides:
Source:

setMaskOnSvgLayer(svg)

Applies the lens mask to an SVG element. Elements with the mask will only be visible within the lens area (or outside, depending on mask configuration).

Parameters:
Name Type Description
svg SVGElement

The SVG element to mask
Inherited From:
Overrides:
Source:

toggle()

Toggles the visibility of the dashboard UI elements. Uses CSS classes to show/hide the interface.

Inherited From:
Overrides:
Source: