Sample GUI client (VIT Recognition System)

Owned by Inna Kabanova (Unlicensed)
Last updated: Dec 23, 2016
4 min read

Current release version of VitML.Recognition.Client: 2.2.2

As a part of VitML.Recognition.Client distribution, we provide a sample GUI application which demonstrates the operation of VIT Recognition System API. It allows to send images to VIT Recognition Server and receive the license plate recognition results + additional meta data.

Within the delivered package, the sample application is located in VitML.Recognition.Client.TestClient folder.

Name of the executable: VitML.Recognition.Client.TestClient.exe.


GUI sections:

  1. VIT Recognition Server connection settings.
  2. Recognition settings which specify how your image should be processed.
  3. Recognition request data you specify to receive as part of recognition result.
  4. Recognition response data (image processing result).
  5. Recognition history: list of sent requests and the corresponding results (new requests on the top).
  6. Images section (the latest sent and received images).

Usage steps:

Step 1. Specify the connection settings


  • Host — IP address of the machine where your VIT Recognition System is functioning (127.0.0.1 by default).
  • Port — service port of your VIT Recognition System (5432 by default).
  • Database — name of the database on VIT Recognition System's side, which stores the images you send, as well as the corresponding license plate recognition results. 
  • User — database user's name.
  • Password — password to access the database.

Step 2. Specify the recognition settings

  • Recognition requests source ID — your identifier (as VIT Recognition System's client, i.e. the source of recognition requests); the client is responsible for uniqueness of this ID. 
  • Recognition requests source name — your name (as VIT Recognition System's client).
  • License plate star max count — maximum number of unrecognized symbols on the license plate image, when the result is still considered valid and is sent to the client.

Unrecognized symbols are substituted with the asterisk symbol ( * ) in recognition result string, hence the option's name. 

  • License plate validity min — minimum value of license plate recognition validity (preciseness), when the result is still considered valid and is sent to the client.

For each recognition result, validity is determined by the recognition engine by its own criteria.

Step 3. Load the image to analyze



Step 4. Change sizes of recognition zone and plate image


  • Edit plate size — allows to visually specify license plate sizes which will be taken into account while processing your image:

    1. Maximum size of license plate's image. If the license plate image's size exceeds this value, the system will ignore this license plate.

    2. Minimum size of license plate's image. If the license plate image's size is less than this value, the system will ignore this license plate. 

  • Edit zone — allows to specify a so-called "recognition zone", a zone in the image where the license plate detection will be done. The rest of the image (which is not included into the recognition zone) is ignored by the recognition engine. By default, if recognition zone is not specified, license plates are searched on the whole frame. 

Step 5. Select the license plate templates

Step 5. Clarify your recognition request

Activate the check boxes in accordance to which images you want to receive with your recognition result.


Step 6. (finally) Send your recognition request


Step 7. View the result from your VIT Recognition System