English Română

Welcome! This user manual will guide you through using and configuring the Metrici QR Code Recognition application. This software automatically recognizes QR codes from video streams and can send this information to servers for further processing, such as access control, inventory tracking, or document processing.

Table of Contents

Important! This documentation is currently in beta and is a work in progress. Content may change as features are finalized.

1. Overview

The Metrici QR Code Recognizer system is designed to:

Tip: This application requires a valid software license (HASP key) to operate. Without a valid license, the application will run in demo mode with limited functionality on a limited period of time.

2. Main Window

The main window is divided into several sections:

QR Code application main window
Fig. QR Code Recognizer Main Window

2.1 Video Display Area

The left side of the window displays:

Each video display shows:

2.2 QR Code Information Panel

The right side displays:

2.3 Control Buttons

3. Getting Started

3.1 Initial Setup

  1. Connect your camera - Ensure your IP camera is connected to the network and functioning
  2. Launch the application - Set it in Foregreound with watchdog to iniate settings
  3. Open settings - Click the Settings button
  4. Configure video source - Go to the "Input Stream" section and select your camera type
  5. IP Address: Enter the camera's IP address or hostname (without http://)
  6. Port: Enter the HTTP port (default HTTP is usually 80)-other protocols have different ports
  7. Write username and password for the camera
  8. Limit FPS: Set to 0 for unlimited, or specify a maximum frame rate
  9. Save settings - Click Save to apply your configuration
  10. Test the connection - The video feed should appear in the main window

3.2 First Time Configuration

For optimal performance, follow these steps:

  1. Adjust the Detection Window to cover only the area where QR codes will appear
  2. Set the QR Recognition Engine Working Mode based on your needs
  3. Configure Reporting URLs if you want to send code data to a server
  4. Set up Barrier Control if you need automatic gate opening based on QR codes

4. Video Sources

The application supports many types of video sources. You need to configure both the Input Stream (main camera) and optionally a Companion Stream (secondary camera).

4.1 Input Stream Configuration

Stream Type

Select the type of video stream from your camera. If you don't have a specific supported brand, just choose Generic. The application supports:

TypeDescription
HTTP ACTi MJPEGACTi cameras using MJPEG over HTTP
RTSP ACTi H264ACTi cameras using H264 over RTSP
HTTP Android MJPEGAndroid-based cameras
HTTP Arecont MJPEGArecont Vision cameras
HTTP Axis MJPEGAxis cameras using MJPEG
RTSP Axis MJPEGAxis cameras using RTSP with MJPEG
RTSP Axis H264Axis cameras using RTSP with H264
RTSP Bosch MJPEGBosch cameras using MJPEG
RTSP Bosch H264Bosch cameras using H264
HTTP Dahua MJPEGDahua cameras using MJPEG
HTTP Diviotec MJPEGDiviotec cameras
RTSP Diviotec H264Diviotec cameras using H264
HTTP Generic MJPEGGeneric MJPEG cameras
RTSP Generic MJPEGGeneric RTSP MJPEG streams
RTSP Generic H264Generic RTSP H264 streams
HTTP Hikvision MJPEGHikvision cameras using MJPEG
RTSP Hikvision H264Hikvision cameras using H264
HTTP Mobotix MJPEGMobotix cameras using MJPEG
HTTP Mobotix MxPEGMobotix cameras using their MxPEG format
RTSP Mobotix H264Mobotix cameras using H264
RTSP Mobotix MOVE H264Mobotix MOVE cameras
HTTP Novus MJPEGNovus cameras
RTSP Novus H264Novus cameras using H264
RTSP Pelco MJPEGPelco cameras
ROSEEEK RAWROSEek camera raw stream
HTTP Samsung MJPEGSamsung cameras
RTSP Samsung H264Samsung cameras using H264
HTTP Sony MJPEGSony cameras
RTSP Sony H264Sony cameras using H264
RTSP Uniview H264Uniview cameras
HTTP Vivotek MJPEGVivotek cameras
HTTP VLC MJPEGVLC media server streams

Stream Address

Enter the network address of your camera. This could be:

TCP Port

The network port number your camera uses. Common defaults:

Username and Password

If your camera requires authentication, enter the credentials here. Leave blank if your camera is open access.

FPS Limit

Limits the number of frames processed per second. Lower values reduce CPU usage but may miss fast-moving QR codes. Recommended values:

Important: The FPS limit is a maximum value. The actual frame rate depends on your camera capabilities and network bandwidth. If you limit fps in the application and the camera sends more toward the engine, this will drop frames beyond its limit.

4.2 Companion Stream

The companion stream provides a second video camera view. This is useful when:

Configuration options are identical to the Input Stream.

5. Detection Window

The detection window defines the specific area within the video frame where the application will look for QR codes. This optimization :

5.1 Detection Window Active

Enable or disable the detection window. When disabled, the entire video frame is scanned for QR codes.

5.2 Window Position and Size

SettingDescription
Origin X (origx)Horizontal starting position of the detection window (left edge)
Origin Y (origy)Vertical starting position of the detection window (top edge)
Resolution X (resx)Width of the detection window in pixels
Resolution Y (resy)Height of the detection window in pixels
Setup Tip: Or just drag the corners of the polygon on the live video when you enable the detection window. When setting up the detection window, position it to cover where QR codes will appear (e.g., on conveyor belts, at entry points, on documents). The window should be large enough to capture codes but not so large that it includes empty areas.

5.3 Items Direction

Set the direction of item movement (0-360 degrees). This is used for: