Window: region selection

_images/window_region_selection_main.svg

Extra functionality not shown in diagram above

  1. All of these objects must be selectable and must show appropriate highlighting as feedback for selection: vertices, edges, shapes.
  2. To pick the object being selected, prioritize vertices, then edges, then shapes.
  3. Scroll zoom is important to be able to select the right object. Maybe also add keybinds for “-” and “=”/”+” for zooming. It will also be very important when analyzing videos that contain multiple independent experiments (which will then be masked off).
  4. To remove a vertex or a shape, click on it, then either press the <DEL> key, or use the “remove” button below. (You don’t need to implement edge removal.)
  5. Clicking on an edge and dragging it moves the two vertices adjacent to that edge.

Workflows involving this window

Foreground detection workflow

In the foreground separation procedure, the user is asked to mark the foreground in the video (or rather, confirm that the foreground was correctly autodetected). Here’s how that happens:

The region selection window appears.

The user is presented with an OK-dialog box explaining what the user has to do and why.

In this mode, the region selection window must have an extra prominent green button called “Done!” or “Apply!”. When it is pressed, a dialog “Are all the foreground regions correctly marked now?” appears with choices “Yes”, “No”, “Explain again” (latter shows the initial OK-dialog box).

Analysis workflow

Report methods can receive regions as parameters (along with e.g. text/strings and numbers).

Example: how long the critter spends in one corner of the box

  1. In report window, user selects “add new report”, then picks the preset report “how long the critter spends in a region”.
  2. The report takes, as a parameter, the region of interest. This is shown as a text box with a ”...” button next to it. Clicking the button brings the user to the region selection window.
  3. The user selects the corner_of_interest region from the region list.
  4. The user clicks the green “Apply!” button.
  5. The region selection window closes and brings the user back to the report parameters window.