Overlays


The overlay feature allows one or more images to be attached to an image in the Repository. This feature has been designed for visualizing image analysis results such as segmentation results.

When multiple overlays are attached to an image, the z-position of each overlay in the stack is determined by the position of the overlay in the Overlays panel. The first entry in the panel is visually on the bottom of the stack and subsequent entries are positioned higher in the stack. The image that overlays are attached to is positioned visually below all of the overlays.

Attaching Overlays

Overlays are by default positioned at the top left corner of the image they have been attached to, at the base resolution layer. The initial height and width of the overlay will match the overlay's base resolution layer (i.e. pixel scaling of the overlay is not considered). An overlay image can be repositioned using the Transform properties.

Sub-images may complicate overlay positioning for the following reasons: 1) if the image has multiple sub-images, the overlay’s position is determined relative to the first sub-image, at the base resolution layer; and 2) if the overlay contains multiple sub-images, only the first sub-image is viewable.
Attach an overlay using drag and drop
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Upload an image from your computer by dragging a supported image file onto the sidebar

Attach an overlay using the file selection dialog
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Click on the + button at the top of the sidebar to reveal the Add image overlay dialog

  4. Click in the blue box to activate the file selection dialog or simply drag an image into the blue box

  5. Click on the Start upload button

  6. Click on the X button at the top right of the popup dialog or anywhere outside of the dialog box to close it

Deleting Overlays

Overlays can be deleted from the Overlays panel.

To delete an overlay from the Overlays panel
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Identify the overlay entry to be modified

  4. Click on the Delete button

  5. Click on the OK button to confirm

Overlay Properties

If you attempt to modify an item which is governed by a reason for change tracking policy, you will be required to provide a reason for the change.

Overlay Name

The name is a single line text field that supports unicode characters.

To rename an overlay from the Overlays panel
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Identify the overlay entry to be modified

  4. Click on the name of the entry

  5. Provide a name or edit the existing text

  6. Press the Enter key or click away from the textbox to save your changes

Overlay Visibility

Overlays are visible on the image by default once attached.

To change the visibility of individual overlays
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Identify the overlay entry to be modified

  4. Click on the Eye button to toggle visibility

To change the visibility of all overlays
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Click on the Eye button at the top right corner of the Overlays panel to toggle visibility for all overlays

Overlay Transform

By default, overlays are positioned at the origin (top left corner of the image's first sub-image's base resolution layer). If an uploaded overlay is meant to span a different region of interest, an appropriate transform may be defined.

To reposition an overlay
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Click on the Show Transformation button next to an entry name in the panel to open the transform controls

  4. Perform one of the following:

    1. Set the X and Y values to specify the coordinates of the top left corner (with respect to the image) and set the W (width) and H (height) values to specify the extent of the overlay, or
    2. Click on the Scale to Fit button to scale the overlay so that it fits the image width
All values should be provided in pixel coordinates relative to the base resolution level of the image

Transform Limitations

Transform operations may be limited for a given overlay depending on how it was generated.

  • Manually created overlays can be moved and resized
  • Overlays imported from Indica Labs HALO cannot be moved or resized
  • Visiopharm MLD files converted to overlays can be moved, however the point of origin is the default position of the overlay and not the top left corner
    • These overlays can also be resized, but doing so may affect their position
  • Heatmap overlays imported from Visiopharm can be moved and resized.

Overlay Rendering

Overlays have a number of properties that define how they are rendered. These properties are shared for all team members and therefore, changes made by any user will be visible to other users.

To change the opacity of an overlay
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Adjust the opacity slider in the range of [0, 100] for an entry in the Overlays panel

To add pseudocolor to an overlay
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Click on the + Add Pseudocolor button for an entry in the Overlays panel

  4. (Optional) Click on the color block to open the color palette and select a color from the palette

To remove pseudocolor from an overlay
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Click on the x Remove button next to the color block of an entry in the Overlays panel (only available if a pseudocolor has been previously defined)

To change the composite operation for an overlay
  1. If the left sidebar is not displayed, toggle it by clicking on the Menu > button at the bottom left of the Viewer

  2. Hover or click on the Overlays button in the left sidebar

  3. Select a composite mode from the dropdown for an entry in the Overlays panel. See compositing operations for more details. The default composite operation is “Normal”

Compositing Operations

Various compositing techniques are available for rendering overlaid images. These are a number of other modes that may be helpful depending on the types of images and desired effects.

Overlay composition modes
Composite modeDescription
NormalDraw this image on top of existing content.
Source InDraw this image only where it overlaps existing content. Non-overlapping areas are made transparent.
Source OutDraw this image only where it doesn’t overlap existing content.
Source AtopDraw this image only where it overlaps existing content.
Destination OverDraw this image behind existing content.
Destination InDraw existing content only where it overlaps this image. Non-overlapping areas are made transparent.
Destination OutDraw existing content only where it does not overlap this image.
Destination AtopDraw existing content only where it overlaps this image. This image is drawn behind existing content.
LighterAdd color values of this image with the color values of the existing content.
CopyReplace the existing content with this image.
XORThis image and existing content are drawn only where there is no overlap.
MultiplyMultiply the color values of this image with the color values of existing content.
ScreenColor values of this image and the existing content are inverted, multiplied, then inverted again.
OverlayA combination of multiply and screen.
Hard LightLike overlay, but with the top and bottom layers swapped.
Soft LightA softer version of hard light.
DarkenRetain the darkest pixel between this image and the existing content.
Color DodgeDivide the color values of the existing content by the inverted color values of this image.
Color BurnDivide the inverted color values of the existing content by the color values of this image, and then invert the result.
DifferenceSubtract the color values of this image from the color values of the existing content and compute the absolute value.
ExclusionLike difference, but with lower contrast.
HuePreserve the luma and chroma of the existing content while adopting the hue of this image.
SaturationPreserve the luma and hue of the existing content while adopting the chroma of this image.
ColorPreserve the luma of the existing content while adopting the hue and chroma of this image.
LuminosityPreserve the hue and chroma of the existing content while adopting the luma of this image.