documentation

vlSDK.h
Go to the documentation of this file.
1 // Copyright (c) Visometry GmbH.
2 
17 #ifndef VL_SDK_H
18 #define VL_SDK_H
19 
20 #include "vlSDKDef.h"
21 #include "vlSDKVersion.h"
22 
23 struct vlImageWrapper_s;
30 typedef struct vlImageWrapper_s vlImageWrapper_t;
31 
32 struct vlExtrinsicDataWrapper_s;
39 typedef struct vlExtrinsicDataWrapper_s vlExtrinsicDataWrapper_t;
40 
41 struct vlSimilarityTransformWrapper_s;
48 typedef struct vlSimilarityTransformWrapper_s vlSimilarityTransformWrapper_t;
49 
50 struct vlIntrinsicDataWrapper_s;
57 typedef struct vlIntrinsicDataWrapper_s vlIntrinsicDataWrapper_t;
58 
59 struct vlCalibratedImageWrapper_s;
68 typedef struct vlCalibratedImageWrapper_s vlCalibratedImageWrapper_t;
69 
70 struct vlWorker_s;
77 typedef struct vlWorker_s vlWorker_t;
78 
82 typedef enum
83 {
91  VL_LOG_DEBUG = 3
93 
97 typedef enum
98 {
99  VL_RENDER_ROTATION_CCW_0 = 0,
100  VL_RENDER_ROTATION_CCW_90 = 2,
101  VL_RENDER_ROTATION_CCW_180 = 1,
102  VL_RENDER_ROTATION_CCW_270 = 3,
104 
108 typedef enum
109 {
120 } vlImageFormat;
121 
125 typedef enum
126 {
132 
141 typedef void (VL_CALLINGCONVENTION *vlCallbackZString)(
142  const char data[], void* clientData);
143 
160 typedef void (VL_CALLINGCONVENTION *vlCallbackJsonString)(
161  const char error[], const char data[], void* clientData);
162 
185 typedef void (VL_CALLINGCONVENTION *vlCallbackJsonAndBinaryString)(
186  const char error[],
187  const char result[],
188  const char data[],
189  unsigned int size,
190  void* clientData);
191 
203 typedef void (VL_CALLINGCONVENTION *vlCallbackImageWrapper)(
204  vlImageWrapper_t* image, void* clientData);
205 
218 typedef void (VL_CALLINGCONVENTION *vlCallbackExtrinsicDataWrapper)(
219  vlExtrinsicDataWrapper_t* extrinsicData, void* clientData);
220 
233 typedef void (VL_CALLINGCONVENTION *vlCallbackSimilarityTransformWrapper)(
234  vlSimilarityTransformWrapper_t* similarityTransform, void* clientData);
235 
248 typedef void (VL_CALLINGCONVENTION *vlCallbackIntrinsicDataWrapper)(
249  vlIntrinsicDataWrapper_t* intrinsicData, void* clientData);
250 
263 typedef void(VL_CALLINGCONVENTION* vlCallbackCalibratedImageWrapper)(
264  vlCalibratedImageWrapper_t* calibratedImage,
265  void* clientData);
266 
267 #ifdef __cplusplus
268 extern "C"
269 {
270 #endif // __cplusplus
282  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionMajor();
283 
288  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionMinor();
289 
294  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionRevision();
303  VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionPostfix(
304  char postfix[], unsigned int maxSize);
313  VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionString(
314  char version[], unsigned int maxSize);
315 
324  VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionHashString(
325  char version[], unsigned int maxSize);
326 
335  VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionTimestampString(
336  char versionTimeStamp[], unsigned int maxSize);
337 
351  VL_SDK_API bool VL_CALLINGCONVENTION vlGetHostId(
352  char hostIdBuffer[], unsigned int maxSize);
353 
367  VL_SDK_API bool VL_CALLINGCONVENTION vlGetBundleId(
368  char bundleIdBuffer[], unsigned int maxSize);
369 
380  VL_SDK_API bool VL_CALLINGCONVENTION vlAddLogListener(
381  vlCallbackZString fn, void* clientData);
382 
391  VL_SDK_API bool VL_CALLINGCONVENTION vlRemoveLogListener(
392  vlCallbackZString fn, void* clientData);
393 
400  VL_SDK_API bool VL_CALLINGCONVENTION vlClearLogListeners();
401 
417  VL_SDK_API void VL_CALLINGCONVENTION vlEnableLogBuffer();
418 
432  VL_SDK_API void VL_CALLINGCONVENTION vlDisableLogBuffer();
433 
445  VL_SDK_API void VL_CALLINGCONVENTION vlSetLogBufferSize(
446  unsigned int maxEntries);
447 
463  VL_SDK_API bool VL_CALLINGCONVENTION vlFlushLogBuffer();
464 
471  VL_SDK_API int VL_CALLINGCONVENTION vlGetLogLevel();
472 
486  VL_SDK_API bool VL_CALLINGCONVENTION vlSetLogLevel(int level);
487 
496  VL_SDK_API bool VL_CALLINGCONVENTION vlLog(
497  const char message[], int level);
498 
515  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION vlNew_ImageWrapper(vlImageFormat imageFormat);
516 
525  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
527 
537  VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ImageWrapper(
538  vlImageWrapper_t* imageWrapper);
539 
548  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetFormat(
549  vlImageWrapper_t* imageWrapper);
550 
558  VL_SDK_API unsigned int VL_CALLINGCONVENTION
560  vlImageWrapper_t* imageWrapper);
561 
569  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetWidth(
570  vlImageWrapper_t* imageWrapper);
571 
579  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetHeight(
580  vlImageWrapper_t* imageWrapper);
581 
582 
598  VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyToBuffer(
599  vlImageWrapper_t* imageWrapper,
600  unsigned char buffer[], unsigned int bufferSize);
601 
619  VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBuffer(
620  vlImageWrapper_t* imageWrapper, const unsigned char buffer[],
621  unsigned int width, unsigned int height);
622 
639  VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBufferWithFormat(
640  vlImageWrapper_t* imageWrapper, const unsigned char buffer[],
641  unsigned int width, unsigned int height,vlImageFormat imageFormat);
642 
661  VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION vlNew_ExtrinsicDataWrapper();
662 
671  VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION
673 
683  VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ExtrinsicDataWrapper(
684  vlExtrinsicDataWrapper_t* extrinsicDataWrapper);
685 
695  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetValid(
696  vlExtrinsicDataWrapper_t* extrinsicDataWrapper);
697 
707  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetValid(
708  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, bool value);
709 
732  VL_SDK_API bool VL_CALLINGCONVENTION
734  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float matrix[],
735  unsigned int matrixElementCount);
736 
753  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetT(
754  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float t[],
755  unsigned int elementCount);
756 
773  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetT(
774  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float t[],
775  unsigned int elementCount);
776 
793  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetR(
794  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float q[],
795  unsigned int elementCount);
796 
813  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetR(
814  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float q[],
815  unsigned int elementCount);
816 
833  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetCamPosWorld(
834  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float t[],
835  unsigned int elementCount);
836 
853  VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetCamPosWorld(
854  vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float t[],
855  unsigned int elementCount);
856 
875 
884  VL_SDK_API vlSimilarityTransformWrapper_t* VL_CALLINGCONVENTION
886 
896  VL_SDK_API void VL_CALLINGCONVENTION vlDelete_SimilarityTransformWrapper(
897  vlSimilarityTransformWrapper_t* similarityTransformWrapper);
898 
908  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetValid(
909  vlSimilarityTransformWrapper_t* similarityTransformWrapper);
910 
920  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetValid(
921  vlSimilarityTransformWrapper_t* similarityTransformWrapper, bool value);
922 
937  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetT(
938  vlSimilarityTransformWrapper_t* similarityTransformWrapper, float t[],
939  unsigned int elementCount);
940 
955  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetT(
956  vlSimilarityTransformWrapper_t* similarityTransformWrapper, const float t[],
957  unsigned int elementCount);
958 
973  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetR(
974  vlSimilarityTransformWrapper_t* similarityTransformWrapper, float q[],
975  unsigned int elementCount);
976 
991  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetR(
992  vlSimilarityTransformWrapper_t* similarityTransformWrapper, const float q[],
993  unsigned int elementCount);
994 
1006  VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetS(
1007  vlSimilarityTransformWrapper_t* similarityTransformWrapper, float s);
1008 
1019  VL_SDK_API float VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetS(
1020  vlSimilarityTransformWrapper_t* similarityTransformWrapper);
1021 
1040  VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION vlNew_IntrinsicDataWrapper();
1041 
1050  VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION
1052 
1062  VL_SDK_API void VL_CALLINGCONVENTION vlDelete_IntrinsicDataWrapper(
1063  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1064 
1072  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetWidth(
1073  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1074 
1084  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetWidth(
1085  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, unsigned int value);
1086 
1094  VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetHeight(
1095  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1096 
1106  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetHeight(
1107  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, unsigned int value);
1119  VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFxNorm(
1120  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1121 
1132  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFxNorm(
1133  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
1134 
1146  VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFyNorm(
1147  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1148 
1159  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFyNorm(
1160  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
1171  VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetSkewNorm(
1172  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1173 
1183  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetSkewNorm(
1184  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
1185 
1196  VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCxNorm(
1197  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1198 
1209  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCxNorm(
1210  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
1221  VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCyNorm(
1222  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1223 
1234  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCyNorm(
1235  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
1236 
1247  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCalibrated(
1248  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1249 
1259  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCalibrated(
1260  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, bool value);
1261 
1272  VL_SDK_API double VL_CALLINGCONVENTION
1274  vlIntrinsicDataWrapper_t* intrinsicDataWrapper);
1275 
1287  VL_SDK_API bool VL_CALLINGCONVENTION
1289  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double k[],
1290  unsigned int elementCount);
1291 
1293  VL_SDK_API bool VL_CALLINGCONVENTION
1295  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double k[],
1296  unsigned int elementCount);
1297 
1309  VL_SDK_API bool VL_CALLINGCONVENTION
1311  vlIntrinsicDataWrapper_t* intrinsicDataWrapper, const double k[],
1312  unsigned int elementCount);
1313 
1315  VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetRadialDistortion(
1316  vlIntrinsicDataWrapper_t* intrinsicDataWrapper,
1317  const double k[],
1318  unsigned int elementCount);
1319 
1358  VL_SDK_API bool VL_CALLINGCONVENTION
1360  vlIntrinsicDataWrapper_t* intrinsicDataWrapper,
1361  float nearFact, float farFact, unsigned int screenWidth,
1362  unsigned int screenHeight, unsigned int renderRotation,
1363  unsigned int mode, float matrix[], unsigned int matrixElementCount);
1364 
1382  VL_SDK_API vlCalibratedImageWrapper_t* VL_CALLINGCONVENTION vlNew_CalibratedImageWrapper();
1383 
1392  VL_SDK_API vlCalibratedImageWrapper_t* VL_CALLINGCONVENTION
1394 
1404  VL_SDK_API void VL_CALLINGCONVENTION
1406 
1413  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
1415 
1423  VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION
1425  vlCalibratedImageWrapper_t* calibratedImageWrapper);
1426 
1434  VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION
1436  vlCalibratedImageWrapper_t* calibratedImageWrapper);
1437 
1455  VL_SDK_API vlWorker_t* VL_CALLINGCONVENTION vlNew_Worker();
1456 
1472  VL_SDK_API vlWorker_t* VL_CALLINGCONVENTION vlNew_SyncWorker();
1473 
1480  VL_SDK_API void VL_CALLINGCONVENTION vlDelete_Worker(vlWorker_t* worker);
1481 
1489  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Start(vlWorker_t* worker);
1490 
1498  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Stop(vlWorker_t* worker);
1499 
1512  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RunOnceSync(
1513  vlWorker_t* worker);
1514 
1536  VL_SDK_API bool VL_CALLINGCONVENTION
1537  vlWorker_AddCameraCalibrationDB(vlWorker_t* worker, const char uri[]);
1538 
1558  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ResetCameraCalibrationDB(vlWorker_t* worker);
1559 
1576  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonCommandSync(
1577  vlWorker_t* worker, const char jsonString[],
1578  vlCallbackJsonString callback, void* clientData);
1579 
1601  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonAndBinaryCommandSync(
1602  vlWorker_t* worker,
1603  const char jsonString[],
1604  const char data[],
1605  unsigned int size,
1607  void* clientData);
1608 
1650  VL_SDK_API char* VL_CALLINGCONVENTION vlWorker_GetDeviceInfo(vlWorker_t* worker);
1651 
1665  VL_SDK_API bool VL_CALLINGCONVENTION
1666  vlWorker_SetLicenseFilePath(vlWorker_t* worker, const char licenseFilePath[]);
1667 
1683  VL_SDK_API bool VL_CALLINGCONVENTION
1684  vlWorker_SetLicenseFileData(vlWorker_t* worker, const char licenseFileData[]);
1685 
1697  VL_SDK_API char* VL_CALLINGCONVENTION vlWorker_GetLicenseInformation(
1698  vlWorker_t* worker);
1699 
1709  VL_SDK_API bool VL_CALLINGCONVENTION
1710  vlWorker_LoadPlugin(vlWorker_t* worker, const char pluginName[]);
1711 
1728  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION vlWorker_GetImageSync(
1729  vlWorker_t* worker);
1730 
1748  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
1750  vlWorker_t* worker, const char* image_name);
1751 
1752 
1770  VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
1771  vlWorker_GetNodeImageSync(vlWorker_t* worker, const char node[], const char key[]);
1772 
1788  VL_SDK_API bool VL_CALLINGCONVENTION
1789  vlWorker_SetNodeImageSync(vlWorker_t* worker, vlImageWrapper_t* image, const char node[], const char key[]);
1790 
1808  VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION
1810  vlWorker_t* worker,
1811  const char node[],
1812  const char key[]);
1813 
1829  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeExtrinsicDataSync(
1830  vlWorker_t* worker,
1831  vlExtrinsicDataWrapper_t* extrinsicData,
1832  const char node[],
1833  const char key[]);
1834 
1852  VL_SDK_API vlSimilarityTransformWrapper_t* VL_CALLINGCONVENTION
1854  vlWorker_t* worker,
1855  const char node[],
1856  const char key[]);
1857 
1873  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeSimilarityTransformSync(
1874  vlWorker_t* worker,
1875  vlSimilarityTransformWrapper_t* similarityTransform,
1876  const char node[],
1877  const char key[]);
1878 
1896  VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION
1898  vlWorker_t* worker,
1899  const char node[],
1900  const char key[]);
1901 
1917  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeIntrinsicDataSync(
1918  vlWorker_t* worker,
1919  vlIntrinsicDataWrapper_t* intrinsicData,
1920  const char node[],
1921  const char key[]);
1922 
1930  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_IsRunning(
1931  vlWorker_t* worker);
1932 
1954  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonCommand(
1955  vlWorker_t* worker, const char jsonString[],
1956  vlCallbackJsonString callback, void* clientData);
1957 
1983  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonAndBinaryCommand(
1984  vlWorker_t* worker, const char jsonString[], const char data[],
1985  unsigned int size, vlCallbackJsonAndBinaryString callback,
1986  void* clientData);
1987 
1999  VL_SDK_API void VL_CALLINGCONVENTION vlReleaseBinaryBuffer(const char data[]);
2000 
2012  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessCallbacks(
2013  vlWorker_t* worker);
2014 
2027  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddImageListener(
2028  vlWorker_t* worker, vlCallbackImageWrapper listener, void* clientData);
2029 
2040  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveImageListener(
2041  vlWorker_t* worker, vlCallbackImageWrapper listener, void* clientData);
2042 
2055  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddDebugImageListener(
2056  vlWorker_t* worker,
2057  vlCallbackImageWrapper listener,
2058  void* clientData);
2059 
2070  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveDebugImageListener(
2071  vlWorker_t* worker,
2072  vlCallbackImageWrapper listener,
2073  void* clientData);
2074 
2087  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddExtrinsicDataListener(
2088  vlWorker_t* worker, vlCallbackExtrinsicDataWrapper listener,
2089  void* clientData);
2090 
2101  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveExtrinsicDataListener(
2102  vlWorker_t* worker, vlCallbackExtrinsicDataWrapper listener,
2103  void* clientData);
2104 
2117  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddIntrinsicDataListener(
2118  vlWorker_t* worker, vlCallbackIntrinsicDataWrapper listener,
2119  void* clientData);
2120 
2131  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveIntrinsicDataListener(
2132  vlWorker_t* worker, vlCallbackIntrinsicDataWrapper listener,
2133  void* clientData);
2134 
2149  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddCalibratedImageListener(
2150  vlWorker_t* worker,
2152  void* clientData,
2153  vlImageFormat format);
2154 
2167  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveCalibratedImageListener(
2168  vlWorker_t* worker,
2170  void* clientData,
2171  vlImageFormat format);
2172 
2185  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddTrackingStateListener(
2186  vlWorker_t* worker, vlCallbackZString listener, void* clientData);
2187 
2198  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveTrackingStateListener(
2199  vlWorker_t* worker, vlCallbackZString listener, void* clientData);
2200 
2213  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddPerformanceInfoListener(
2214  vlWorker_t* worker, vlCallbackZString listener, void* clientData);
2215 
2226  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemovePerformanceInfoListener(
2227  vlWorker_t* worker, vlCallbackZString listener, void* clientData);
2228 
2243  VL_SDK_API bool VL_CALLINGCONVENTION
2245  vlWorker_t* worker,
2246  const char anchorName[],
2248  void* clientData);
2249 
2263  VL_SDK_API bool VL_CALLINGCONVENTION
2265  vlWorker_t* worker,
2266  const char anchorName[],
2268  void* clientData);
2269 
2282  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddWorldFromCameraTransformListener(
2283  vlWorker_t* worker,
2285  void* clientData);
2286 
2297  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveWorldFromCameraTransformListener(
2298  vlWorker_t* worker,
2300  void* clientData);
2301 
2318  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddNodeDataImageListener(
2319  vlWorker_t* worker, const char node[], const char key[],
2320  vlCallbackImageWrapper listener, void* clientData);
2321 
2337  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveNodeDataImageListener(
2338  vlWorker_t* worker, const char node[], const char key[],
2339  vlCallbackImageWrapper listener, void* clientData);
2340 
2357  VL_SDK_API bool VL_CALLINGCONVENTION
2358  vlWorker_AddNodeDataExtrinsicDataListener(
2359  vlWorker_t* worker, const char node[], const char key[],
2360  vlCallbackExtrinsicDataWrapper listener, void* clientData);
2361 
2377  VL_SDK_API bool VL_CALLINGCONVENTION
2378  vlWorker_RemoveNodeDataExtrinsicDataListener(
2379  vlWorker_t* worker, const char node[], const char key[],
2380  vlCallbackExtrinsicDataWrapper listener, void* clientData);
2381 
2398  VL_SDK_API bool VL_CALLINGCONVENTION
2399  vlWorker_AddNodeDataSimilarityTransformListener(
2400  vlWorker_t* worker, const char node[], const char key[],
2401  vlCallbackSimilarityTransformWrapper listener, void* clientData);
2402 
2418  VL_SDK_API bool VL_CALLINGCONVENTION
2419  vlWorker_RemoveNodeDataSimilarityTransformListener(
2420  vlWorker_t* worker, const char node[], const char key[],
2421  vlCallbackSimilarityTransformWrapper listener, void* clientData);
2422 
2439  VL_SDK_API bool VL_CALLINGCONVENTION
2440  vlWorker_AddNodeDataIntrinsicDataListener(
2441  vlWorker_t* worker, const char node[], const char key[],
2442  vlCallbackIntrinsicDataWrapper listener, void* clientData);
2443 
2459  VL_SDK_API bool VL_CALLINGCONVENTION
2460  vlWorker_RemoveNodeDataIntrinsicDataListener(
2461  vlWorker_t* worker, const char node[], const char key[],
2462  vlCallbackIntrinsicDataWrapper listener, void* clientData);
2463 
2481  VL_SDK_API bool VL_CALLINGCONVENTION
2482  vlWorker_AddNodeTrackingStateListener(vlWorker_t* worker,
2483  const char node[], vlCallbackZString listener, void* clientData);
2484 
2500  VL_SDK_API char* VL_CALLINGCONVENTION
2501  vlWorker_GetNodeTrackingStateJsonSync(vlWorker_t* worker, const char node[]);
2502 
2517  VL_SDK_API bool VL_CALLINGCONVENTION
2518  vlWorker_RemoveNodeTrackingStateListener(vlWorker_t* worker,
2519  const char node[], vlCallbackZString listener, void* clientData);
2520 
2528  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ClearListeners(
2529  vlWorker_t* worker);
2530 
2542  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PollEvents(
2543  vlWorker_t* worker);
2544 
2561  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_WaitEvents(
2562  vlWorker_t* worker, unsigned int timeout);
2563 
2568  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Lock(vlWorker_t* worker);
2569 
2574  VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Unlock(vlWorker_t* worker);
2575 
2603  VL_SDK_API char* VL_CALLINGCONVENTION vlSDKUtil_get(
2604  const char *uri, unsigned long *size, const char *options=0);
2605 
2624  VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_set(
2625  const char* uri, const void* data, unsigned long size,
2626  const char* options=0);
2627 
2641  VL_SDK_API bool VL_CALLINGCONVENTION
2642  vlSDKUtil_registerScheme(const char* name, const char* uri);
2643 
2658  VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_getTempFilename(
2659  const char* prefName, char *newName, unsigned int maxSize);
2660 
2675  VL_SDK_API char* VL_CALLINGCONVENTION
2676  vlSDKUtil_getCameraPositionsFromGeometry(const char* geometryJson, unsigned long* size);
2677 
2692  VL_SDK_API char* VL_CALLINGCONVENTION vlSDKUtil_getCameraPositionsFromWorkspaceDefinition(
2693  const char* workspaceJson,
2694  unsigned long* size);
2695 
2711  VL_SDK_API char* VL_CALLINGCONVENTION
2713  const char* workspaceJson,
2714  unsigned long* size);
2715 
2730  VL_SDK_API char* VL_CALLINGCONVENTION
2732  const char* workspaceJson,
2733  unsigned long* size);
2734 
2742  VL_SDK_API double VL_CALLINGCONVENTION
2744  vlImageWrapper_t* imageWrapper);
2745 
2752  VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_systemHasExternalSLAM();
2753 
2769  VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_retrievePhysicalPath(
2770  const char uri[],
2771  char physicalPath[],
2772  unsigned int maxSize);
2773 
2783  VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_getModelHash(
2784  const char modelURI[],
2785  char modelHash[],
2786  unsigned int maxSize);
2787 
2799  VL_SDK_API const char* VL_CALLINGCONVENTION
2800  vlSDKUtil_loadModel(const char* uri, const char** json, unsigned long* size);
2801 
2802 #ifdef __cplusplus
2803 }
2804 #endif // __cplusplus
2805 
2808 #endif // VL_SDK_H
VL_SDK_API char *VL_CALLINGCONVENTION vlSDKUtil_getCameraPositionsFromGeometry(const char *geometryJson, unsigned long *size)
Transforms a workspace geometry into a list of points.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_retrievePhysicalPath(const char uri[], char physicalPath[], unsigned int maxSize)
Resolves the given URI.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_set(const char *uri, const void *data, unsigned long size, const char *options=0)
Posts or writes data to given URI.
VL_SDK_API char *VL_CALLINGCONVENTION vlSDKUtil_getCameraTransformsFromWorkspaceDefinition(const char *workspaceJson, unsigned long *size)
Transforms a workspace definition into a list of poses.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_getTempFilename(const char *prefName, char *newName, unsigned int maxSize)
Generate a temporary file URI.
VL_SDK_API const char *VL_CALLINGCONVENTION vlSDKUtil_loadModel(const char *uri, const char **json, unsigned long *size)
Loads the model for the given uri and returns it in a serialized form.
VL_SDK_API char *VL_CALLINGCONVENTION vlSDKUtil_getCameraPositionsFromWorkspaceDefinition(const char *workspaceJson, unsigned long *size)
Transforms a workspace definition into a list of points.
VL_SDK_API double VL_CALLINGCONVENTION vlSDKUtil_getPosterQuality(vlImageWrapper_t *imageWrapper)
Estimates the quality of a given image as a PosterTracker reference.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_systemHasExternalSLAM()
Returns wether or not the system supports external SLAM (ARKit, ARCore, HoloLens).
VL_SDK_API char *VL_CALLINGCONVENTION vlSDKUtil_get(const char *uri, unsigned long *size, const char *options=0)
Retrieves a file and its data from a given URI.
VL_SDK_API char *VL_CALLINGCONVENTION vlSDKUtil_getOriginTransformFromSimpleWorkspaceDefinition(const char *workspaceJson, unsigned long *size)
Computes the origin transform of a given simple workspace definition.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_getModelHash(const char modelURI[], char modelHash[], unsigned int maxSize)
Creates the model hash of the given model into a buffer.
VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_registerScheme(const char *name, const char *uri)
Creates an internal file scheme relative to the given uri.
struct vlImageWrapper_s vlImageWrapper_t
Type which represents an ImageWrapper.
Definition: vlSDK.h:30
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetRadialDistortion(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double k[], unsigned int elementCount)
void(VL_CALLINGCONVENTION * vlCallbackJsonString)(const char error[], const char data[], void *clientData)
A pointer to a callback function which receives two zero terminated string which contain JSON data.
Definition: vlSDK.h:160
void(VL_CALLINGCONVENTION * vlCallbackImageWrapper)(vlImageWrapper_t *image, void *clientData)
A pointer to a callback function which receives a pointer to an ImageWrapper object as parameter.
Definition: vlSDK.h:203
struct vlSimilarityTransformWrapper_s vlSimilarityTransformWrapper_t
Type which represents a SimilarityTransformWrapper.
Definition: vlSDK.h:48
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetRadialDistortion(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, const double k[], unsigned int elementCount)
void(VL_CALLINGCONVENTION * vlCallbackSimilarityTransformWrapper)(vlSimilarityTransformWrapper_t *similarityTransform, void *clientData)
A pointer to a callback function which receives a pointer to an SimilarityTransformWrapper object as ...
Definition: vlSDK.h:233
void(VL_CALLINGCONVENTION * vlCallbackJsonAndBinaryString)(const char error[], const char result[], const char data[], unsigned int size, void *clientData)
A pointer to a callback function which receives a zero terminated result string (usually in JSON),...
Definition: vlSDK.h:185
void(VL_CALLINGCONVENTION * vlCallbackIntrinsicDataWrapper)(vlIntrinsicDataWrapper_t *intrinsicData, void *clientData)
A pointer to a callback function which receives a pointer to an IntrinsicDataWrapper object as parame...
Definition: vlSDK.h:248
struct vlIntrinsicDataWrapper_s vlIntrinsicDataWrapper_t
Type which represents an IntrinsicDataWrapper.
Definition: vlSDK.h:57
struct vlWorker_s vlWorker_t
Type which represents a Worker.
Definition: vlSDK.h:77
struct vlExtrinsicDataWrapper_s vlExtrinsicDataWrapper_t
Type which represents an ExtrinsicDataWrapper.
Definition: vlSDK.h:39
void(VL_CALLINGCONVENTION * vlCallbackZString)(const char data[], void *clientData)
A pointer to a callback function which receives a zero terminated string as parameter.
Definition: vlSDK.h:141
struct vlCalibratedImageWrapper_s vlCalibratedImageWrapper_t
Type which represents a CalibratedImageWrapper.
Definition: vlSDK.h:68
void(VL_CALLINGCONVENTION * vlCallbackExtrinsicDataWrapper)(vlExtrinsicDataWrapper_t *extrinsicData, void *clientData)
A pointer to a callback function which receives a pointer to an ExtrinsicDataWrapper object as parame...
Definition: vlSDK.h:218
vlFittingMode
Definition: vlSDK.h:126
void(VL_CALLINGCONVENTION * vlCallbackCalibratedImageWrapper)(vlCalibratedImageWrapper_t *calibratedImage, void *clientData)
A pointer to a callback function which receives a pointer to a CalibratedImageWrapper object as param...
Definition: vlSDK.h:263
vlLogLevel
Definition: vlSDK.h:83
vlRenderRotation
Definition: vlSDK.h:98
vlImageFormat
Definition: vlSDK.h:109
@ VL_FITTING_MODE_COVER
Definition: vlSDK.h:128
@ VL_FITTING_MODE_CONTAIN
Definition: vlSDK.h:130
@ VL_LOG_MUTE
Definition: vlSDK.h:85
@ VL_LOG_DEBUG
Definition: vlSDK.h:91
@ VL_LOG_WARNING
Definition: vlSDK.h:89
@ VL_LOG_ERROR
Definition: vlSDK.h:87
@ VL_IMAGE_FORMAT_RGBA
Definition: vlSDK.h:117
@ VL_IMAGE_FORMAT_UNDEFINED
Definition: vlSDK.h:111
@ VL_IMAGE_FORMAT_GREY
Definition: vlSDK.h:113
@ VL_IMAGE_FORMAT_RGB
Definition: vlSDK.h:115
@ VL_IMAGE_FORMAT_DEPTH
Definition: vlSDK.h:119
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlCalibratedImageWrapper_GetImage(vlCalibratedImageWrapper_t *calibratedImageeWrapper)
Returns a pointer to the ImageWrapper object of the calibrated image.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_CalibratedImageWrapper(vlCalibratedImageWrapper_t *calibratedImageWrapper)
Deletes an CalibratedImageWrapper object.
VL_SDK_API vlCalibratedImageWrapper_t *VL_CALLINGCONVENTION vlCalibratedImageWrapper_Clone(vlCalibratedImageWrapper_t *calibratedImageWrapper)
Creates a copy of the CalibratedImageWrapper object and returns a pointer to it.
VL_SDK_API vlExtrinsicDataWrapper_t *VL_CALLINGCONVENTION vlCalibratedImageWrapper_GetImageFromDeviceTransform(vlCalibratedImageWrapper_t *calibratedImageWrapper)
Returns a pointer to the ExtrinsicDataWrapper object of the extrinsic from the device to the image co...
VL_SDK_API vlIntrinsicDataWrapper_t *VL_CALLINGCONVENTION vlCalibratedImageWrapper_GetIntrinsicData(vlCalibratedImageWrapper_t *calibratedImageWrapper)
Returns a pointer to the IntriniscDataWrapper object of the intrinsic of the image.
VL_SDK_API vlCalibratedImageWrapper_t *VL_CALLINGCONVENTION vlNew_CalibratedImageWrapper()
Creates a new CalibratedImageWrapper object and returns a pointer to it.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetModelViewMatrix(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, float matrix[], unsigned int matrixElementCount)
Returns the current camera pose as model-view matrix.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetValid(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, bool value)
Sets the valid flag of the given ExtrinsicData.
VL_SDK_API vlExtrinsicDataWrapper_t *VL_CALLINGCONVENTION vlNew_ExtrinsicDataWrapper()
Creates a new ExtrinsicDataWrapper object and returns a pointer to it.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetR(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, float q[], unsigned int elementCount)
Returns the rotation from the world coordinate system to the camera coordinate system.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetCamPosWorld(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, float t[], unsigned int elementCount)
Returns the position of the camera in world coordinates.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetT(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, float t[], unsigned int elementCount)
Returns the translation from the world coordinate system to the camera coordinate system.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetValid(vlExtrinsicDataWrapper_t *extrinsicDataWrapper)
Returns whether the current tracking pose is valid (the tracking was successful).
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetR(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, const float q[], unsigned int elementCount)
Sets the rotation from the world coordinate system to the camera coordinate system.
VL_SDK_API vlExtrinsicDataWrapper_t *VL_CALLINGCONVENTION vlExtrinsicDataWrapper_Clone(vlExtrinsicDataWrapper_t *extrinsicDataWrapper)
Creates a copy of the ExtrinsicDataWrapper object and returns a pointer to it.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ExtrinsicDataWrapper(vlExtrinsicDataWrapper_t *extrinsicDataWrapper)
Deletes an ExtrinsicDataWrapper object.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetCamPosWorld(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, const float t[], unsigned int elementCount)
Sets the position of the camera in world coordinates.
VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetT(vlExtrinsicDataWrapper_t *extrinsicDataWrapper, const float t[], unsigned int elementCount)
Sets the translation from the world coordinate system to the camera coordinate system.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionHashString(char version[], unsigned int maxSize)
Copies the version hash of the VisionLib plugin into a buffer.
VL_SDK_API int VL_CALLINGCONVENTION vlGetLogLevel()
Gets the current log level.
VL_SDK_API bool VL_CALLINGCONVENTION vlSetLogLevel(int level)
Sets the log level.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetBundleId(char bundleIdBuffer[], unsigned int maxSize)
Copies the bundle ID of the current application into the provided buffer as zero terminated string.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionMinor()
Returns the minor version number of the VisionLib plugin.
VL_SDK_API bool VL_CALLINGCONVENTION vlFlushLogBuffer()
Notifies registered log listeners of all buffered log messages.
VL_SDK_API bool VL_CALLINGCONVENTION vlAddLogListener(vlCallbackZString fn, void *clientData)
Registers a log listener.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionTimestampString(char versionTimeStamp[], unsigned int maxSize)
Copies the version timestamp of the VisionLib plugin into a buffer.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionString(char version[], unsigned int maxSize)
Copies the version string of the VisionLib plugin into a buffer.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionRevision()
Returns the revision version number of the VisionLib plugin.
VL_SDK_API bool VL_CALLINGCONVENTION vlRemoveLogListener(vlCallbackZString fn, void *clientData)
Unregisters a log listener.
VL_SDK_API bool VL_CALLINGCONVENTION vlClearLogListeners()
Removes all log listeners.
VL_SDK_API void VL_CALLINGCONVENTION vlDisableLogBuffer()
Disables log buffering.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetHostId(char hostIdBuffer[], unsigned int maxSize)
Copies the host ID of the current application into the provided buffer as zero terminated string.
VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionPostfix(char postfix[], unsigned int maxSize)
Copies the version postfix of the VisionLib plugin into a buffer.
VL_SDK_API void VL_CALLINGCONVENTION vlSetLogBufferSize(unsigned int maxEntries)
Sets the maximum number of log messages in the log buffer.
VL_SDK_API void VL_CALLINGCONVENTION vlEnableLogBuffer()
Enables log buffering.
VL_SDK_API bool VL_CALLINGCONVENTION vlLog(const char message[], int level)
Logs the given message as VisionLib log.
VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBufferWithFormat(vlImageWrapper_t *imageWrapper, const unsigned char buffer[], unsigned int width, unsigned int height, vlImageFormat imageFormat)
Copies the given an formated buffer into the VisionLib image.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetBytesPerPixel(vlImageWrapper_t *imageWrapper)
Returns the number of bytes per pixel.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetHeight(vlImageWrapper_t *imageWrapper)
Returns the height of the image.
VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyToBuffer(vlImageWrapper_t *imageWrapper, unsigned char buffer[], unsigned int bufferSize)
Copies the VisionLib image into the given buffer.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetFormat(vlImageWrapper_t *imageWrapper)
Returns the internal type of the image.
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlNew_ImageWrapper(vlImageFormat imageFormat)
Creates a new Image object and returns a pointer to it.
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlImageWrapper_Clone(vlImageWrapper_t *imageWrapper)
Creates a copy of the image and returns a pointer to it.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetWidth(vlImageWrapper_t *imageWrapper)
Returns the width of the image.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ImageWrapper(vlImageWrapper_t *imageWrapper)
Deletes an ImageWrapper object.
VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBuffer(vlImageWrapper_t *imageWrapper, const unsigned char buffer[], unsigned int width, unsigned int height)
Copies the given buffer into the VisionLib image.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetProjectionMatrix(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, float nearFact, float farFact, unsigned int screenWidth, unsigned int screenHeight, unsigned int renderRotation, unsigned int mode, float matrix[], unsigned int matrixElementCount)
Computed the projection matrix from the intrinsic camera parameters.
VL_SDK_API vlIntrinsicDataWrapper_t *VL_CALLINGCONVENTION vlIntrinsicDataWrapper_Clone(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Creates a copy of the IntrinsicDataWrapper object and returns a pointer to it.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_IntrinsicDataWrapper(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Deletes an IntrinsicDataWrapper object.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFxNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double value)
Sets the normalized focal length in x direction of the given IntrinsicDataWrapper object to the given...
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetWidth(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the width of the intrinsic camera calibration.
VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetHeight(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the height of the intrinsic camera calibration.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCalibrated(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns whether the intrinsic parameters are valid.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetWidth(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, unsigned int value)
Sets width of the given IntrinsicDataWrapper object to the given value.
VL_SDK_API vlIntrinsicDataWrapper_t *VL_CALLINGCONVENTION vlNew_IntrinsicDataWrapper()
Creates a new IntrinsicDataWrapper object and returns a pointer to it.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCyNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double value)
Sets the normalized y-component of the principal point of the given IntrinsicDataWrapper object to th...
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCxNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double value)
Sets the normalized x-component of the principal point of the given IntrinsicDataWrapper object to th...
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFyNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double value)
Sets the normalized focal length in y direction of the given IntrinsicDataWrapper object to the given...
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetHeight(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, unsigned int value)
Sets height of the given IntrinsicDataWrapper object to the given value.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFyNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the normalized focal length of the intrinsic camera calibration in y direction.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCyNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the normalized y-component of the principal point.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetDistortionParameters(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, const double k[], unsigned int elementCount)
Sets the radial and tangential distortion parameters.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetSkewNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double value)
Sets the normalized skew of the given IntrinsicDataWrapper object to the given value.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCxNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the normalized x-component of the principal point.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetSkewNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the normalized skew of the intrinsic camera calibration.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetDistortionParameters(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, double k[], unsigned int elementCount)
Retrieves the radial and tangential distortion parameters.
VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCalibrated(vlIntrinsicDataWrapper_t *intrinsicDataWrapper, bool value)
Sets the calibrated flag of the given IntrinsicDataWrapper object to the given value.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFxNorm(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the normalized focal length of the intrinsic camera calibration in x direction.
VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCalibrationError(vlIntrinsicDataWrapper_t *intrinsicDataWrapper)
Returns the calibration error.
VL_SDK_API float VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetS(vlSimilarityTransformWrapper_t *similarityTransformWrapper)
Returns the scale factor of the given SimilarityTransform.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetS(vlSimilarityTransformWrapper_t *similarityTransformWrapper, float s)
Sets the scale factor of the given SimilarityTransform.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetValid(vlSimilarityTransformWrapper_t *similarityTransformWrapper)
Returns whether the contained transform is valid (the tracking was successful).
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetValid(vlSimilarityTransformWrapper_t *similarityTransformWrapper, bool value)
Sets the valid flag of the given SimilarityTransform.
VL_SDK_API vlSimilarityTransformWrapper_t *VL_CALLINGCONVENTION vlNew_SimilarityTransformWrapper()
Creates a new SimilarityTransformWrapper object and returns a pointer to it.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetR(vlSimilarityTransformWrapper_t *similarityTransformWrapper, float q[], unsigned int elementCount)
Returns the rotation of the contained transform.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetR(vlSimilarityTransformWrapper_t *similarityTransformWrapper, const float q[], unsigned int elementCount)
Sets the rotation of the contained transform.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_GetT(vlSimilarityTransformWrapper_t *similarityTransformWrapper, float t[], unsigned int elementCount)
Returns the translational part of the contained transform.
VL_SDK_API bool VL_CALLINGCONVENTION vlSimilarityTransformWrapper_SetT(vlSimilarityTransformWrapper_t *similarityTransformWrapper, const float t[], unsigned int elementCount)
Sets the translational part of the contained transform.
VL_SDK_API vlSimilarityTransformWrapper_t *VL_CALLINGCONVENTION vlSimilarityTransformWrapper_Clone(vlSimilarityTransformWrapper_t *similarityTransformWrapper)
Creates a copy of the SimilarityTransformWrapper object and returns a pointer to it.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_SimilarityTransformWrapper(vlSimilarityTransformWrapper_t *similarityTransformWrapper)
Deletes a SimilarityTransformWrapper object.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ClearListeners(vlWorker_t *worker)
Removes all listeners.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddDebugImageListener(vlWorker_t *worker, vlCallbackImageWrapper listener, void *clientData)
Register a listener for debug image events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RunOnceSync(vlWorker_t *worker)
Processes the enqueued commands and the tracking once.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddTrackingStateListener(vlWorker_t *worker, vlCallbackZString listener, void *clientData)
Registers a listener for tracking state events.
VL_SDK_API vlWorker_t *VL_CALLINGCONVENTION vlNew_Worker()
Creates a Worker object.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddIntrinsicDataListener(vlWorker_t *worker, vlCallbackIntrinsicDataWrapper listener, void *clientData)
Registers a listener for IntrinsicData events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddPerformanceInfoListener(vlWorker_t *worker, vlCallbackZString listener, void *clientData)
Registers a listener for performance information events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddCameraCalibrationDB(vlWorker_t *worker, const char uri[])
Adds a given URI pointing to a camera calibration database JSON file to the VisionLib.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddWorldFromAnchorTransformListener(vlWorker_t *worker, const char anchorName[], vlCallbackSimilarityTransformWrapper listener, void *clientData)
Register a listener for world from anchor transform events (SimilarityTransform events) produced by a...
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlWorker_GetImageByNameSync(vlWorker_t *worker, const char *image_name)
Returns a pointer to the camera image with the given name.
VL_SDK_API vlExtrinsicDataWrapper_t *VL_CALLINGCONVENTION vlWorker_GetNodeExtrinsicDataSync(vlWorker_t *worker, const char node[], const char key[])
Returns a pointer to extrinsicdata with the given name from a given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Lock(vlWorker_t *worker)
For testing purposed. Don't use!
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveImageListener(vlWorker_t *worker, vlCallbackImageWrapper listener, void *clientData)
Unregisters a listener from image events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveExtrinsicDataListener(vlWorker_t *worker, vlCallbackExtrinsicDataWrapper listener, void *clientData)
Unregisters a listener from ExtrinsicData events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveIntrinsicDataListener(vlWorker_t *worker, vlCallbackIntrinsicDataWrapper listener, void *clientData)
Unregisters a listener from IntrinsicData events.
VL_SDK_API vlSimilarityTransformWrapper_t *VL_CALLINGCONVENTION vlWorker_GetNodeSimilarityTransformSync(vlWorker_t *worker, const char node[], const char key[])
Returns a pointer to the SimilarityTransform with the given name from a given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_WaitEvents(vlWorker_t *worker, unsigned int timeout)
Waits for enqueued events and calls the registered listeners.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveTrackingStateListener(vlWorker_t *worker, vlCallbackZString listener, void *clientData)
Unregisters a listener from tracking state events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveWorldFromAnchorTransformListener(vlWorker_t *worker, const char anchorName[], vlCallbackSimilarityTransformWrapper listener, void *clientData)
Unregister a listener from world from anchor transform events (SimilarityTransform events) produced b...
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeSimilarityTransformSync(vlWorker_t *worker, vlSimilarityTransformWrapper_t *similarityTransform, const char node[], const char key[])
Sets the given SimilarityTransform in the given input of the given node.
VL_SDK_API char *VL_CALLINGCONVENTION vlWorker_GetLicenseInformation(vlWorker_t *worker)
Retrieves actual license information as a JSON encoded string.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveWorldFromCameraTransformListener(vlWorker_t *worker, vlCallbackExtrinsicDataWrapper listener, void *clientData)
Unregisters a listener from world from camera transform events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddImageListener(vlWorker_t *worker, vlCallbackImageWrapper listener, void *clientData)
Registers a listener for image events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PollEvents(vlWorker_t *worker)
Calls the registered listeners for the enqueued events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveDebugImageListener(vlWorker_t *worker, vlCallbackImageWrapper listener, void *clientData)
Unregisters a listener from debug image events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetLicenseFileData(vlWorker_t *worker, const char licenseFileData[])
Allows to inject the license data from memory.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeIntrinsicDataSync(vlWorker_t *worker, vlIntrinsicDataWrapper_t *intrinsicData, const char node[], const char key[])
Sets the given IntrinsicData in the given input of the given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonAndBinaryCommandSync(vlWorker_t *worker, const char jsonString[], const char data[], unsigned int size, vlCallbackJsonAndBinaryString callback, void *clientData)
Processes the passed json command along with binary data for the visionLib.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddCalibratedImageListener(vlWorker_t *worker, vlCallbackCalibratedImageWrapper listener, void *clientData, vlImageFormat format)
Registers a listener for CalibratedImage events.
VL_SDK_API void VL_CALLINGCONVENTION vlReleaseBinaryBuffer(const char data[])
Helper function for releasing a binary memory block.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessCallbacks(vlWorker_t *worker)
Executes all enqueued callbacks.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddWorldFromCameraTransformListener(vlWorker_t *worker, vlCallbackExtrinsicDataWrapper listener, void *clientData)
Registers a listener for world from camera transform events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonAndBinaryCommand(vlWorker_t *worker, const char jsonString[], const char data[], unsigned int size, vlCallbackJsonAndBinaryString callback, void *clientData)
Enqueues a json command along with binary data for the visionLib.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Stop(vlWorker_t *worker)
Stops the tracking thread.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeImageSync(vlWorker_t *worker, vlImageWrapper_t *image, const char node[], const char key[])
Sets the given image in the given input of the given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonCommand(vlWorker_t *worker, const char jsonString[], vlCallbackJsonString callback, void *clientData)
Enqueues a command for the tracking thread as zero terminated JSON string.
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlWorker_GetImageSync(vlWorker_t *worker)
Returns a pointer to the camera image.
VL_SDK_API void VL_CALLINGCONVENTION vlDelete_Worker(vlWorker_t *worker)
Deletes a Worker object.
VL_SDK_API vlImageWrapper_t *VL_CALLINGCONVENTION vlWorker_GetNodeImageSync(vlWorker_t *worker, const char node[], const char key[])
Returns a pointer to the image with the given name from a given node.
VL_SDK_API vlWorker_t *VL_CALLINGCONVENTION vlNew_SyncWorker()
Creates a synchronous Worker object.
VL_SDK_API vlIntrinsicDataWrapper_t *VL_CALLINGCONVENTION vlWorker_GetNodeIntrinsicDataSync(vlWorker_t *worker, const char node[], const char key[])
Returns a pointer to IntrinsicData with the given name from a given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveCalibratedImageListener(vlWorker_t *worker, vlCallbackCalibratedImageWrapper listener, void *clientData, vlImageFormat format)
Unregisters a listener from CalibratedImage events.
VL_SDK_API char *VL_CALLINGCONVENTION vlWorker_GetDeviceInfo(vlWorker_t *worker)
Returns a JSON string with information about the current device.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddExtrinsicDataListener(vlWorker_t *worker, vlCallbackExtrinsicDataWrapper listener, void *clientData)
Registers a listener for ExtrinsicData events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetLicenseFilePath(vlWorker_t *worker, const char licenseFilePath[])
Sets the path of the license file.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonCommandSync(vlWorker_t *worker, const char jsonString[], vlCallbackJsonString callback, void *clientData)
Processes the passed command.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeExtrinsicDataSync(vlWorker_t *worker, vlExtrinsicDataWrapper_t *extrinsicData, const char node[], const char key[])
Sets the given extrinsicData in the given input of the given node.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemovePerformanceInfoListener(vlWorker_t *worker, vlCallbackZString listener, void *clientData)
Unregisters a listener from performance info events.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Start(vlWorker_t *worker)
Starts the tracking thread.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_LoadPlugin(vlWorker_t *worker, const char pluginName[])
Loads the plugin with the given name.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ResetCameraCalibrationDB(vlWorker_t *worker)
Removes all references to all manually set calibration data bases.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_IsRunning(vlWorker_t *worker)
Returns whether the thread is currently running or not.
VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Unlock(vlWorker_t *worker)
For testing purposed. Don't use!
This file contains defines with the VisionLib version.