Visimetrica - Quick Start

Media Opening

There are four tabs in Media Explorer panel, which is docked on the left side of the environment by default. Media Explorer
  • Media - Tree view of all media loaded in system.
  • Images - Scroll viewer of image thumbnails
  • Cameras - Scroll viewer of camera thumbnails
  • Videos - Scroll viewer of video file thumbnails
Image Tab

Images can be opened from main toolbar by Open button or directly from Image Tab of Media Explorer using Image Add button. Image Tab toolbar has buttons image adding, removing selected image, saving selected image, up and down arrows to change order of images in scroll viewer and the info button for image resolution, format or metadata info.
Now, notice the two checkboxes on Image Thumbnail, if the first, In Workspace, is checked, image (and all the media in general) persists displayed in Workspace even when it loses its selection. The second check box called In Stack is used for inclusion to stacking computation when multiple images are processed.
You can also see two buttons on thumbnail - Show Filter Rack and Clone Image. Filter Rack is an extendable chain if image processing filters assigned to each image or camera, will be described later. By Clone button click you obtain identical image thumbnail, but you can apply different filters on and compare differences in Workspace. Camera Tab

To add an USB Camera to system open USB Devices dialog by the leftmost button. If some USB cameras are connected to computer, they should appear in Device Combo. If not, plug camera to USB port and click Refresh button. Then select device and resolution. Note, that FPS is just an indicative number, the real actual frame rate appears on camera thumbnail. Now click Connect button and the Camera thumbnail will appear in Camera scroll viewer. The following events should take place as follows: The camera is started to take one frame, whose resolution is displayed on thumb. Then the camera is stopped, but is ready to use. By clicking Camera thumb the first frame is displayed in Workspace, by pressing the Play button on thumb or on Video Control the video stream is started.
When the resolution is changed, it is strongly recommended stop the camera first and then click Connect button again.
To remove USB camera click its thumb to select it, stop it if still running and click Remove Camera button in toolbar.

To add an IP Camera invoke the Connections dialog by Add IP Camera button click. Then you can select some connection saved before or create new by the New button. Click Connect and the camera thumbnail should appear.

Video files: Visimetrica can also be used as the powerfull video player. For example, four simultaneously running MPEG video files in full HD 1080 resolution takes about 4 percent of CPU usage (Xeon 3.4 GHz). Just open video by Open File button or Add Video button and wait a moment before creating preview.

The Workspace and Application Mode

The workspace behaviour is determined by the application mode selected.
Application Mode Switch
  • Zoom/Pan Mode - The whole content of the workspace can be moved by mouse dragging en bloc including horizontal and vertical rulers if displayed, position of each media relative to the coordinates is immutable. The workspace can be also zoomed by the Zoom Slider, mouse wheel or ctrl+drag.
  • Zoom/Move Mode - Media can be moved relative to each other as well as the coordinate system, moreover, the workspace can be zoomed.
  • Selection Mode - Can create rectangle selection in workspace, if the selection is set, the filters effect is only reflected in it .
  • Marker Mode, Line Mode, Angle Mode, Polygon Mode - Modes for Measurement Objects, will be described below.

To display just one media in the workspace click the appropriate media thumbnail but do not check its In Workspace checkbox.
To display multiple media check In Workspace checkboxes of each of them. Then switch to the Zoom/Move Mode and drag each media to desired position.
The workspace layout can be saved as *.vmwsp file.

Snapshot Acquisition

Visimetrica can capture images as well as a series of images at set intervals. This series can be automatically processed to suppress image noise, which mainly CMOS cameras produce, or to select the sharpest parts from each image to achieve the focus stacked image.

If Camera thumbnail (USB or IP) is selected (has red background), the Video Control in workspace may look like this: Video Control
The Snapshot Options, a transparent window can be opened from the Camera thumbnail. Snapshot options
Now about its controls:
  • Frames Left - is set to 1 by default, this number determines the number of images taken from video stream after the Capture Frame button on the Video Control is pressed.
  • Interval - time in milliseconds between snapshots, if not set, each frame is captured.
  • Stop - interrupts the current series.
  • Stack - performs the calculation of the image data of all images according to the selected stacking method. The processing enter only images with In Stack checkbox checked. All images must have the same resolution.
  • If Autostack is checked, the images are processed automatically when the series ends.
  • If Delete source is checked, except for result, all the images are deleted after processing
Stacking Methods:
  • MED - Median, for image noise suppressing.
  • AVG - The average value of the corresponding pixels
  • WAVG - Weighted average, selects the sharpest parts in each image to compound an image in deep focus.

Except for camera streams the snapshot can be also taken from video file streams, but in this case the image series are not supported yet.

Video Recording

Press Recording options button on Camera Thumbnail and show recording options window.This window always displays the data of currently focused camera. Recording options

Select the directory for recorded file and specify its name. The extension is set to *.avi by default. Then select video codec and frame rate in FPS textbox, you can derive its value from average FPS, if this value is higher, you will get a time-lapse video. The video quality depends on kbps value, its value is good to try experimentally. If you want to capture a time-lapse video, specify the interval in milliseconds between frames. Now press the red recording button and the camera enters recording mode, controls are protected and Video Control looks to be paused, although the camera is running. Then press the Play button and start recording. It can be paused and started again. By the Stop button the recording is ended and the file is closed and loaded to the Video tab.

Filter Rack

If the media is of camera or image type, the filter rack button appears on the thumbnail. The Filter Rack is a powerfull tool providing image/video processing for each media separately. It contains a set of filters, which can be chained and their order changed by arrows. Filter Rack A detailed description of each filter will be added over time, now you can experiment with them. You can adjust or filter colors in RGB or HSL space, binarize image by various types of thresholding algorithms and then count objects in binarized image by Blob Counter, track motion in the monitored area and write to chart its intensity by Motion Detector etc. Setting both individual filters and their entire chain can be saved as *.ftr file.



  • View Video Control - shows/hides the video transport bar, which can be found near bottom of the Workspace in fixed position. This control is variable depending on type of focused media.
  • View Axes - shows/hides the coordinate axes. Their color and transparency can be set in Settings
  • View Grid - shows/hides the grid above workspace. Its color and transparency can be set in Settings. Axes and grid are shown only when some media is loaded in the Workspace
  • View Cursor Coordinate - shows/hides the cross displaying current position of cursor.
  • View Axis Cursor - shows/hides an extension of the cursor coordinate toward the axes.
  • View Magnifying Glass - shows/hides the round magnifier on the top of all controls including axes, grid and measurement objects. Its radius and magnification can be set in Settings.
  • View Histogram - shows/hides the transparent window with histogram of focused media. Note, that when applied on video stream it takes some CPU time.
  • View Settings - shows/hides the settings window
    • Controls - the opacity of transparent controls and the visibility of toolbars even when the fullscreen mode is switched.
    • Axes - the color and opacity of coordinate axes
    • Grid - the color and opacity of grid

Settings with Grid Color Picker Magnifying Glass

Measurement Objects - The Overlay

At present, Visimetrica contains only the basic set of Measurement Object which will be extended in future. All these objects are displayed on the top of the Workspace, are bound to the coordinates and are zoomable and draggable together or relative to media. Their name, color, transparency and coordinates can be set in Measurement Objects Datagrid on the app bottom when selected there. Selected objects can be also deleted there.
  • Markers - switch to Marker mode on Application mode toolbar and double click anywhere in Workspace with some media loaded. Then draggable marker should appear.
  • Markers
  • Lines - switch to Line mode and double click in Workspace, then move your mouse and double click again.
  • Angles - switch to Angle mode and double click in Workspace, then move your mouse and double click again. The 30-degree angle should appear, can be moved by dragging its end points.
  • Polygons - switch to Polygon mode, start by double click, add points by single clicks and double click to finalize polygon. Points to finalized polygons can be added by click, removing is not impemented yet.
Various Measurement Objects on the top of running video


The default measurement units in workspace are pixels. Do not be surprised if you see a fraction of the pixels in the measurement because the imaging engine works with a dpi resolution and pixels are interpolated. To change measurement units and ratio open some media for calibration, for example point a camera at a ruler or use an image containing some known distance. Then invoke the Calibration dialog, and switch application to Line mode. At first, enter a name for new calibration to combobox. Now doubleclick on media to the start point and drag the line to the end point. You will see the pixel distance in Source textbox. The line is solid when horizontal or vertical, otherwise dotted. Finish the line by doubleclick, fill Destination distance, select units and click Apply/Save. The environment will switch to new resolution and your calibration will be saved.
When this dialog box is open again, the calibration returns back to pixels.