documentation

Initialization Issues

Starting the VisionLib SDK with a configuration file can arise some issues. You might react accordingly to that by notifying the user of your app.

Generally the feedback is passed at the time the tracking pipeline has/or not been initialized. In depth two json strings are passed inside the SDK, which are reflected by vlTrackingIssues Objects in Unity and the Objective-C SDK.

Usually you can find some fixed errorCode which you should rely on. A warning in this context means, that the tracking configuration will run, but restricted in terms of quality or reliability. It is your turn to decide what to do now. YOU SHOULD TAKE THE WARNINGS SERIOUSLY

If an error is passed, that tracking pipe should be stopped (done automatically on Unity), it will not run at all. This can happen if some blocking event occurred during initialization.

An issue usually consists out of:

  • an code (integer) as a unique identifier for an issue
  • an info as an additional message to concrete the issue
  • and a level describing the effect on the system
    • 0 = Notification
    • 1 = Warning
    • 2 = Error
    • 3 = Deprecation Warning

In this table you can find the codes, its explanations and how to use them.

Code (Symbol)Code (integer)InfoDescriptionLevel
VL_WARNING_CALIBRATION_MISSING_FOR_DEVICE 2DeviceName No calibration available for device. The device ID is passed in the info field. Please be aware that some standard calibration might be used which will can harm the tracking quality massivelyWarning
VL_ERROR_DEVICE_NAME_LOAD_FAILED 3DeviceName No information of the device name passed in the configuration could be loaded. The info string holds the device name requested.Error
VL_ERROR_NO_CAMERA_CONNECTED 4There is maybe no camera connected to your system or no Camera/WebCam capabilities are set. Error
VL_ERROR_NO_CAMERA_ACCESS 5The camera may be removed or used by another application. Error
VL_WARNING_CALIBRATION_DB_LOAD_FAILED 10CalibrationDB_URI The calibration DB could not be loaded.Warning
VL_WARNING_CALIBRATION_DB_INVALID 11CalibrationDB_URI The calibration DB is not valid JSON.Warning
VL_WARNING_CALIBRATION_DB_LOAD_ERROR 12CalibrationDB_URI While loading a calibration data base an internal error occurred reading the database. Please review the error log of the VisionLib for more information!Warning
VL_WARNING_CALIBRATION_DEVICE_ID_OVERWRITTEN_ON_LOAD 13deviceID Overwritten While loading a calibration data base the following deviceID has been overwritten.Warning
VL_WARNING_CALIBRATION_DEVICE_ID_OVERWRITTEN_BY_ALTERNATIVE_ID14deviceID Overwritten-*deviceID Source* While loading a calibration data base the following deviceID has been overwritten due to a defined alternative deviceID in 'Source'.Warning
VL_DEPRECATION_WARNING 20*parameter[optional-newparameter]* We have encountered an about to deprecate parameter which should be replaced by an other or at least reviewed.Deprecation Warning
VL_WARNING_PERMISSION_NOT_SET 97*PermissionName* An optional permission is not set. The program might not run as expected.Warning
VL_ERROR_FILE_READING_FAILED 98*TrackingConfigFileURI* The file specified could not be acquired or loaded.Error
VL_ERROR_FILE_INVALID 99*TrackingConfigFileURI* No valid tracking configuration. The file can not be handled or has the wrong format.Error
VL_ERROR_FILE_FORMAT_NOT_ALLOWED 100*TrackingConfigFileExtension* You have passed a file different to the ones allowed or it is not valid (only .json and .vl files allowed). So no valid configuration could be loaded.Error
VL_ERROR_LICENSE_INVALID 101*LicenseFileURI* Will be issued if the license is not a valid file.Error
VL_ERROR_LICENSE_EXPIRED 102*ExpirationDate* Will be issued when the license has been expired. In this case a black image will be shown with the watermark instead of the camera image. The extrinsic data cannot be acquired.Error
VL_ERROR_LICENSE_EXCEEDS_RUNS 103*NumberOfRunsSinceDeployment* Will be issued when you have started the license more than 5 times without re-deploying. In this case a black image will be shown with the watermark instead of the camera image. The extrinsic data cannot be acquired.Error
VL_WARNING_LICENSE_MODEL_BOUND_FEATURE_INVALD 104*ModelHashFeature* Will be issued when no valid license for a model bound feature could be found. This will not load this model and will result in undefined tracking behaviour. You should contact your license provider for updating the model hash provided in the info string.Warning
VL_ERROR_LICENSE_INVALID_HOST_ID 105*HostID* Will be issued if the license is not registered for this id. If you have licensed a commercial or poc license you might send us this id for updating your license file.Error
VL_ERROR_LICENSE_INVALID_PLATFORM 107*CurrentPlatform* The given license is not valid for running for the current platform (e.g. on HoloLens). Error
VL_WARNING_LICENSE_USING_UNREGISTERED_MODELS 108Will be issued when the loaded model has NOT been registered in the license. Warning
VL_ERROR_LICENSE_FILE_NOT_FOUND 109*LicenseFileURI* Will be issued if the specified license file has not been found at the specified location. Error
VL_ERROR_LICENSE_INVALID_PROGRAM_VERSION 110*LastAllowedProgramVersion Will be issues if the license is encountering a program version incompatibility (e.g. Lifetime License bound to a certain version). Error
VL_ERROR_LICENSE_INVALID_SEAT 111Will be issues if the license is encountering a required SEAT license but is not authorized (e.g PoC licenses are bound to Seats). Error
VL_ERROR_LICENSE_INVALID_FEATURE 112*featureBundleName* Will be issued if a certain feature of the VisionLib is not available due to license restrictions. Error
VL_WARNING_LICENSE_EXPIRING_SOON 113*daysLicenseIsValid* Will be issued if the license is only valid for less then a week. Warning
VL_ERROR_LICENSE_INVALID_BUNDLE_ID 114*bundleName* Will be issues if the license is not registered for this bundle id. Warning
VL_ERROR_LICENSE_EXCEEDED_ALLOWED_NUMBER_OF_ANCHORS 115*numberOfAllowedAnchors* Will be issued if the number of allowed tracking anchors is exceeded.Error
VL_ERROR_MODEL_LOAD_FAILED 300*FileURI* The model name passed could not be loaded. Info holds the filename uri requested.Error
VL_ERROR_MODEL_DECODE_FAILED 301*FileURI* The model downloaded by the specified fileURI could not be decoded.Error
VL_ERROR_POSTER_LOAD_FAILED 350*FileURI* The poster image name passed could not be loaded. Info holds the filename uri requested.Error
VL_ERROR_GRAPH_SETUP_FAILED_UNKNOWN_ERROR400The setup of the graph failed with an unknown reason. Error
VL_ERROR_GRAPH_NODE_NOT_FOUND401*nodeName*Could not find the node with the given name. Info holds the name of the node.Error
VL_ERROR_GRAPH_INVALID_DATA_PATH402*dataPath*The data path doesn't comply with the expected pattern nodeName.dataName. Info holds the data path that was invalid.Error
VL_ERROR_GRAPH_INPUT_NOT_FOUND403*nodeName* :: keyName :: awailableKeysCould not find an input of a node. Info contains: The nodename :: The Key that has not been found :: The keys that are defined on that node. Error
VL_ERROR_GRAPH_OUTPUT_NOT_FOUND404*nodeName* :: keyName :: awailableKeysCould not find an output of a node. Info contains: The nodename :: The Key that has not been found :: The keys that are defined on that node. Error
VL_ERROR_GRAPH_HAS_CYCLES405There is a cycle in the graph - so no order of execution could be determined. Error
VL_ERROR_GRAPH_TRACKERS_EMPTY406There was no tracker defined. Error
VL_ERROR_GRAPH_DUPLICATE_DEVICE_NAME407*deviceName*The same name has been used for two or more devices. Info contains the name.Error
VL_ERROR_GRAPH_DUPLICATE_TRACKER_NAME408*trackerName*The same name has been used for two or more trackers. Info contains the name.Error
VL_ERROR_DUPLICATE_ANCHOR_NAME500*anchorName*The same name has been used for two or more anchors. Info contains the name.Error