Skip to main content

View Image Style And Overlays

The View menu controls how Vidsy.ai displays images, videos, camera feeds, and analysis indicators.

Two sections are especially important during review and annotation:

  • Image style: changes the layout of image and video tiles in the active panel
  • Overlays: shows or hides analysis indicators such as ROI boxes, keypoints, and meshes

These controls do not change the model itself. They change how existing media, detections, and annotations are displayed while you work.

Image style​

View / Image style controls the shape and size of image and video tiles in the panel that currently has focus.

Use it when you want to:

  • make thumbnails larger or smaller
  • switch between square, 4:3, and 16:9 tiles
  • use portrait or landscape layout
  • decide how media is fitted inside each tile
  • make a list easier to scan, annotate, or compare

The section is disabled until a panel is active. Click inside an image list, search result list, camera list, or another media panel first, then change the settings.

Aspect ratio​

Aspect ratio controls the tile shape:

  • 16/9: wide tile
  • 4/3: fullscreen-style tile
  • Square: equal width and height

This changes the display area used for each item. It does not crop or rewrite the original file.

Direction​

Direction switches the selected aspect ratio between landscape and portrait.

For example, a 16:9 tile can be shown as a wide landscape tile or as a tall portrait tile. Square tiles are visually unchanged by direction.

Image fit​

Image fit controls how the image or video fills its tile:

  • Cover: fills the tile and may crop edges
  • Contain: keeps the full image visible and may leave empty space
  • Fill: stretches the media to the tile shape

Use Contain when you need to see the full frame. Use Cover when you want dense browsing and can accept edge cropping.

Size​

Size controls the tile size in pixels. The slider can make tiles small for browsing many items or large for precise inspection.

The selected size is combined with the aspect ratio and direction. A square tile uses the size as both width and height. A 16:9 or 4:3 tile uses the size as the main dimension and calculates the other side from the selected ratio.

Where image style applies​

Image style is stored per panel and mode. This means the image list, search results, camera list, and other media views can keep different layouts.

For example, you can keep small square thumbnails in an index view and larger wide video tiles in a search or recordings view.

The settings are saved in the user configuration, so they remain available after restarting the app.

Overlays​

View / Overlays controls which analysis indicators are drawn over images, videos, recordings, and live camera feeds.

The available overlay toggles are:

  • ROI Box
  • Keypoints
  • Mesh

These toggles control visibility only. They do not create, delete, or retrain detections.

ROI Box​

ROI Box shows bounding boxes for observations that have box data.

ROI boxes are used to mark the region of interest for a detected object or condition. In pipe workflows, this can be a connection, defect, material feature, or another model-specific category.

ROI boxes can appear on:

  • image search results
  • video search results
  • recording playback
  • live camera feeds

If a model category has ROI display disabled in the model configuration, boxes for that category are filtered out of overlay rendering.

Keypoints​

Keypoints shows landmark points for observations that have keypoint data.

Keypoints are useful when the model needs more structure than a single box can provide, such as fitting position, shape, angle, alignment, or deformation.

Keypoints depend on the active model configuration. If the model does not use keypoints, the toggle has no visible effect for that data.

Mesh​

Mesh draws configured paths or triangle groups from keypoints.

Meshes are defined in the model's keypoint configuration. A mesh can connect keypoints as a path or as groups of triangles. The mesh overlay is only visible when:

  • keypoints exist for the observation
  • the model has one or more mesh definitions
  • the Mesh overlay is enabled

Meshes are commonly used to make keypoint structure readable at a glance. They also make graph-based formatting easier to understand during analysis.

Overlay styling​

Some analysis graphs can change overlay styling while analysis runs.

Graph formatting can target:

  • box
  • keypoints
  • mesh

Formatting can set:

  • color
  • fill
  • border width
  • state presets such as normal, warning, or alert

This is used for visual feedback. For example, a graph can turn a mesh and its keypoints red when a measured angle is outside the allowed range, then return them to normal when the condition is no longer active.

If no graph formatting applies, overlays use the default display style.

Labels inside ROI boxes​

ROI boxes can also show labels inside the box.

This is available from camera and recording menus, and in recording controls when ROI boxes are visible. You can choose:

  • whether labels are shown
  • label position inside the box
  • whether to show category label
  • whether to show score
  • whether to show value

Label settings are saved in the user configuration. They are useful when you want the video or camera feed itself to carry enough context for review without opening a separate details view.

Editing ROI boxes and keypoints​

In image result views, the action bar includes edit toggles for ROI boxes and keypoints.

When ROI editing is enabled:

  • ROI boxes become interactive
  • the active box can be moved
  • resize handles are shown for the active box
  • dragging updates the annotation

When keypoint editing is enabled:

  • keypoints become draggable
  • moving points updates the keypoint annotation
  • mesh rendering follows the updated points when mesh is visible

Editing controls are enabled only when the active model supports the relevant annotation type.

Image and video information overlays​

Image and video result tiles also have information overlays that are separate from ROI overlays.

From a result item's context menu, you can choose:

  • Show all info on images
  • Info shown / URI
  • Info shown / Index details
  • Info shown / Value

When enabled, Vidsy.ai shows a dark information label over the tile. The same fields are also used by the hover tooltip.

This setting is session-only. It helps when browsing many results and you want index, category, value, or URI details visible without hovering over every tile.

Adding and removing annotations from a result​

The context menu on an image or video result can also expose annotation actions, depending on the active model:

  • add, delete, or reset an ROI box
  • add, delete, or reset keypoints
  • start learning from selected ROI or keypoint annotations
  • complete missing ROI or keypoint annotations from selected items

These actions are different from the View / Overlays toggles. The overlay toggles decide what is visible. The context-menu actions change annotation data.

Recorded video behavior​

During recorded playback, overlays are time-aware.

Vidsy.ai loads boxes, keypoints, meshes, and formatting records for the file, then draws the items that apply at the current playback time. When the video is paused or seeked, overlays update to match the current frame.

For bundles with multiple files, overlays follow the recording file being displayed.

Live camera behavior​

During live camera analysis, overlays update as detections and observation frames arrive.

The live overlay data source listens for:

  • new or changed boxes
  • new or changed keypoints
  • observations leaving view
  • formatting records from analysis graphs

This lets camera feeds show current detections, changing keypoint positions, and graph-driven styling while the engine runs.

Practical workflow​

A typical review workflow is:

  1. Open the relevant mode from View / Modes.
  2. Click the image list, search results, recording view, or camera panel you want to adjust.
  3. Use View / Image style to choose a tile size and fit that suits the work.
  4. Enable View / Overlays / ROI Box when you need object locations.
  5. Enable Keypoints and Mesh when reviewing model structure, alignment, or measurements.
  6. Use ROI labels or image info overlays when you need more context directly on the media.
  7. Use result context menus and edit toggles when you need to change annotation data.