multidot

Description

Add multiple small ROIs which are either circular or painted. Painted modes can be created and edited with a circular brush or a flood fill.

Most subsequent operations will only be performed on the union of all regions of interest. Also outputs an RGB image annotated with the ROIs on the 'ann' RGB input, or the input image converted to RGB if that input is not connected.

This can also "capture" ROIs from the incoming image, so that they can be edited. This copies the ROIs from the image into the node, and suppresses the image's original ROIs.

In addition to this, the "convert circles" button will convert all circular ROIs in the node into painted ROIs.

Quick guide:

To add and edit circular ROIs:

  • select "Circles" on the left-hand side
  • set the dot size to the desired radius
  • shift-click to add and select a new ROI
  • click to select an existing ROI (or deselect)
  • drag to move the centre of the circle
  • edit parameters like dot size, name, colour, etc. to change the current ROI or next created ROI

To add and edit painted ROIs:

  • select "Painted" on the left-hand side
  • set the dot size to the desired radius
  • set add/create mode to Brush
  • shift-click to add and select a new painted ROI
  • click inside an ROI to select it
  • ctrl-click to add a circle to a selected painted ROI
  • alt-click to "unpaint" a circle from a selected painted ROI

To add and edit filled ROIs:

  • select "Painted" on the left-hand side
  • set add/create mode to Fill
  • set tolerance to a low number (e.g. 0.1)
  • shift-click to add and select a new filled ROI
  • possibly undo (ctrl-Z) to remove the last fill, then change the tolerance!
  • click inside an ROI to select it
  • ctrl-click to add more flood fill to a selected ROI
    • set add/create mode to "Brush" to paint circular brushstrokes on a ROI
  • alt-click to "unpaint" a circle from a selected ROI

General controls:

  • Circles or Painted selects the type of new ROIs
  • click inside an ROI (or very near a circle) to show and edit its properties
  • Dot size is the size of the circle used for both creating circle ROIs and for circular painting in Painted mode.
  • Scale is the font size for all annotations created by this node
  • Thickness is the border size for (currently) all circles only
  • Colour is the colour of the current ROI's annotation
  • Recolour all will select random colours for all ROIs
  • Name is the name of the current ROI
  • Background is whether a background rectangle is used to make the name clearer for all ROIs
  • Capture captures the ROIs from the incoming image, and suppresses the image's original ROIs
  • Convert circles will convert all circular ROIs in the node into painted ROIs.
  • tolerance is the colour difference between the current pixel and surrounding pixels required to stop flood filling. PICK CAREFULLY - it may need to be very small.
  • add/create mode is whether we are new ROIs are created with a circular brush or flood fill in Painted mode

Circle mode:

  • shift-click to add a new ROI
  • drag to move centre of circle

Painted mode:

  • shift-click to add a new painted ROI. Will use a circle if "Paint Mode" is circle, or a flood fill with the given tolerance if the mode is "Fill".
  • ctrl-click to add a circle or flood fill to a selected painted ROI, provided we are in the same mode as the selected ROI. Circle or fill depends on Paint Mode.
  • alt-click to "unpaint" a circle from a selected painted ROI

(Internal: Note that this type doesn't inherit from XFormROI.)

Connections

Inputs

Index Name Type Desc
0 input img (none)

Outputs

Index Name Type Desc
0 img img image with ROIs