documentation
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:
code (integer) as a unique identifier for an issueinfo as an additional message to concrete the issuelevel describing the effect on the systemIn this table you can find the codes, its explanations and how to use them.
| Code (Symbol) | Code (integer) | Info | Description | Level |
|---|---|---|---|---|
| VL_INTERNAL_ERROR | 1 | An internal error occurred during initialization. | Error | |
| VL_WARNING_CALIBRATION_MISSING_FOR_DEVICE | 2 | DeviceName | 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 massively | Warning |
| VL_ERROR_DEVICE_NAME_LOAD_FAILED | 3 | DeviceName | 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 | 4 | There is maybe no camera connected to your system or no Camera/WebCam capabilities are set. | Error | |
| VL_ERROR_NO_CAMERA_ACCESS | 5 | The camera may be removed or used by another application. | Error | |
| VL_WARNING_CALIBRATION_DB_LOAD_FAILED | 10 | CalibrationDB_URI | The calibration DB could not be loaded. | Warning |
| VL_WARNING_CALIBRATION_DB_INVALID | 11 | CalibrationDB_URI | The calibration DB is not valid JSON. | Warning |
| VL_WARNING_CALIBRATION_DB_LOAD_ERROR | 12 | CalibrationDB_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 | 13 | deviceID Overwritten | While loading a calibration data base the following deviceID has been overwritten. | Warning |
| VL_WARNING_CALIBRATION_DEVICE_ID_OVERWRITTEN_BY_ALTERNATIVE_ID | 14 | deviceID 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 | deprecatedParameter - 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_NOT_SET | 106 | Will be issued if no license file or data has been set. | 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 | 108 | Will 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 | 111 | Will 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_WARNING_POSTER_QUALITY_CRITICAL | 351 | PosterQuality | Will be issues if the poster quality is below a critical value. You should replace the poster in the tracker with one of a better quality. | Warning |
| VL_ERROR_GRAPH_SETUP_FAILED_UNKNOWN_ERROR | 400 | The setup of the graph failed with an unknown reason. | Error | |
| VL_ERROR_GRAPH_NODE_NOT_FOUND | 401 | nodeName | Could not find the node with the given name. Info holds the name of the node. | Error |
| VL_ERROR_GRAPH_INVALID_DATA_PATH | 402 | 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_FOUND | 403 | nodeName :: keyName :: awailableKeys | Could 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_FOUND | 404 | nodeName :: keyName :: awailableKeys | Could 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_CYCLES | 405 | There is a cycle in the graph - so no order of execution could be determined. | Error | |
| VL_ERROR_GRAPH_TRACKERS_EMPTY | 406 | There was no tracker defined. | Error | |
| VL_ERROR_GRAPH_DUPLICATE_DEVICE_NAME | 407 | deviceName | The same name has been used for two or more devices. Info contains the name. | Error |
| VL_ERROR_GRAPH_DUPLICATE_TRACKER_NAME | 408 | trackerName | The same name has been used for two or more trackers. Info contains the name. | Error |
| VL_ERROR_DUPLICATE_ANCHOR_NAME | 500 | anchorName | The same name has been used for two or more anchors. Info contains the name. | Error |