Skip to content

Native

Info

This tutorial explains the usage of the VIRNECT Track native C++ sample application for Windows or Linux platforms.

  1. Download or build the application using our Sample Project
  2. Train or download Sample Targets to track

  3. Open a Command Line Interface and start Track-Native.exe with the following arguments:

    Argument Description
    licenseKey Your Track license key
    targetDataPath Folder containing the target files (If map recording is enabled, it used for saving map target data)
    targetNames List of Target names without the .track extension. Multiple Targets can be separated with # (If map recording is enabled, image target should be set)
    imageSource Set to camera or fileSequence
    cameraID or fileSequencePath USB camera ID as an integer (starting with 0) or path to a folder containing a consecutive image sequence
    cameraCalibrationPath Path to camera calibration JSON file representing the intrinsic camera parameters of the used USB camera
    fps Frames per second. A value of 30 or 60 is recommended
    mapRecording Optional parameter for recording map target
    maptargetName Optional parameter for the name of recorded MAP target only if mapRecording mode

Command line example is like below.

./TRACK-Native 0000-0000-0000-0000 ../targets TRACK_IMAGE_000#TRACK_QR_Code_000 camera 0 ../calibration.json 60 

./TRACK-Native 0000-0000-0000-0000 ../targets TRACK_IMAGE_000 fileSequence ../imgSequence ../calibration.json 60 mapRecording TRACK_MAP_000
  1. Face your Targets to track them: