Skip to main content
Version: 2026.06-beta

Annotate

Annotations are primarily used for marking and noting objects in images. For image analysis and calculations, it is recommended to use ROIs and labels instead, as annotations may overlap and cause confusion.

tip

Press F5 to open the Annotation Properties.

Draw an annotation

To activate annotation drawing, simply follow these steps:

  1. In the drawing tool, select Annotate menu icon and choose the correct annotation type and drawing mode. When drawing is activated, the mouse pointer changes from to .

    Click Annotate and annotation type to activate annotation drawing.
    Click Annotate and annotation type to activate annotation drawing.
  2. Now, left click to start drawing and use the mouse to draw the annotation.

  3. Depending on the drawing mode, double-click, let go or press the R key to complete the annotation. When the annotation has been drawn, the Edit Text dialog will appear, as seen below, where it is possible to add any comment necessary.

  4. Click OK to complete the annotation.

Change current active annotation

The current active annotation is the annotation highlighted in the scrollable list of the expanded drawing tool. This annotation can be changed in the drawing tool by:

  1. Hover over annotation in the Drawing Tool to expand the Annotation overlay type.
  2. Hover over the list and use the middle mouse button to scroll the list.
  3. Select the desired annotation from the list, and start drawing the annotation.

Delete an annotation

To delete a single annotation, the annotation drawing tool must be activated first:

  1. Click Annotate menu icon in the Drawing Tool as shown below to activate annotation drawing. The mouse pointer changes from to indicating that annotation drawing is activated.

From here, it is possible to delete an annotation in two different ways. Either select the Delete option menu icon, after which clicking on an annotation will delete it, or

  1. Hold the mouse over the annotation, so that the annotation is highlighted as yellow.
  2. While the annotation is highlighted, press the Delete key to delete the annotation.
    Hover over the annotation to highlight it and press the Delete-key to delete it (Breast cancer tissue, HER2).
    Hover over the annotation to highlight it and press the Delete-key to delete it (Breast cancer tissue, HER2).
tip

While highlighting an annotation, the overlay info box appears displaying information about the highlighted annotation.

Delete all annotations

To delete all annotations, the annotation drawing tool must be activated first:

  1. Click Annotate in the Drawing Tool as shown below to activate annotation drawing. The mouse pointer changes from to indicating that annotation drawing is activated.
  2. Hold the Shift-key and press the Delete-key to delete all annotations. Notice that the mouse pointer changes back to .
tip

It is not necessary to highlight an annotation to delete all annotations.

Measure with an Annotation

The Measure provides tools for easy, interactive geometric measurements of length along lines and curves, area, angles and circumference in the image. The user can define up to 255 different measure tools with individual names and colors. When hovering over an annotation, relevant measurements such as length, area, angles and circumference will appear.

tip

It is possible to permanently show the information of the active overlay such as shape, length, area, circumference, and comments by ticking the options in the Properties, Measures, and Comment tabs under View in Overlay Properties.

If unchecked, the information will automatically show by hovering on a specific overlay. (default: inactive for all overlays).

Length

Measures the Length along a straight or curved line between two points. While drawing the lenght displayed will be the lenght from the starting point to the mouse position.

Example of measurement with curved and straight lines
Example of measurement with curved and straight lines

Angle

Measures the angle between two straight lines. Using the freehand drawing tool (poly line) , click to start the first line, then click again to add a bend. Double-click to finish the annotation.

note

Holding down the mouse button prevents the freehand tool from creating straight lines, which makes angle measurement impossible.

Example of measurement with distance and angle (Muscle fibers)
Example of measurement with distance and angle (Muscle fibers)

Area

Measures the area inside a shape. In the Draw section under Overlay Properties, a variety of predefined shapes is available, such as circles and squares, as well as an option to freehand a polygon.

Example of measurement with area (Glomeruli)
Example of measurement with area (Glomeruli)

Circumference

The Circumference measurement represents the total length around the boundary of a Annotation.

Example of measurement with circumference (Lung Cancer, TME)
Example of measurement with circumference (Lung Cancer, TME)

Configuration properties

In the Configuration page, configurations are handled. The existing configurations are listed to the right, and the currently active is shown in the Active field. If the current configuration is not saved a '*' is shown after the name of the configuration in the title bar. A measure configuration holds all of the information which is specified in the measure dialog.

  • load Load the configuration that is selected in the list. The current configuration is lost if it has not been saved.
  • save Save the current configuration under the name that is selected in the list.
  • save-as Save the current configuration under a new name. A dialog where the new configuration name can be specified is launched.
  • delete Delete the configuration that is selected in the list. When a configuration is deleted from within Visiopharm, the configuration files are backed up in Windows Recycle Bin. The files are placed in the root of Recycle Bin. To restore the files, sort Recycle Bin by original location, select all files from a configuration folder, and click "Restore the selected items" to restore.
  • edit configuration Add information about the current configuration.