vlSDK.h

Go to the documentation of this file.

// ========================================================================= //
//                                                                           //
// Filename:  vlSDK.h                                                        //
//                                               +-----+-----+--+--+--+--+   //
// Version:   1.0                                !     !     !  !  !  !  !   //
//                                               !     !     +--+--+--+--+   //
// Author:    Fraunhofer-Institut fuer           !     !     !  !  !  !  !   //
//            Graphische Datenverarbeitung       +-----+-----+--+--+--+--+   //
//            (IGD) Abteilung A4:                !     !     !  !  !  !  !   //
//            Virtuelle und Erweiterte Realitaet !     !     +--+--+--+--+   //
//            Fraunhoferstr. 5                   !     !     !  !  !  !  !   //
//            D-64283 Darmstadt, Germany         +-----+-----+--+--+--+--+   //
//                                               ! FFFFFF hh !     GGGG  !   //
//            Rights: Copyright (c) 2004 by IGD. ! FFFFFF hh !    GGGGGG !   //
//            All rights reserved.               ! FFF    hh h    GG     !   //
//            IGD provides this product          ! FFFFF  hhhhhh  GG  GG !   //
//            without warranty of any kind       ! FFFFF  hhh!hhh GG  GG !   //
//            and shall not be liable for        ! FFF    hh ! hh GGGGGG !   //
//            any damages caused by the use      ! FFF    hh ! hh  GGGG  !   //
//            of this product.                   +-----------+-----------+   //
//                                                                           //
// ========================================================================= //
// -----------------------------------------------------------------------   //
//                                                                           //
// Creation Date :  Tue Jul 21 17:04:00 2015   Martin Buchner                //
//                                                                           //
// ========================================================================= //

#ifndef VL_SDK_H
#define VL_SDK_H

#include "vlSDKDef.h"
#include "vlSDKVersion.h"

struct vlAbstractApplicationWrapper_s;
typedef struct vlAbstractApplicationWrapper_s vlAbstractApplicationWrapper_t;

struct vlImageWrapper_s;
typedef struct vlImageWrapper_s vlImageWrapper_t;

struct vlExtrinsicDataWrapper_s;
typedef struct vlExtrinsicDataWrapper_s vlExtrinsicDataWrapper_t;

struct vlIntrinsicDataWrapper_s;
typedef struct vlIntrinsicDataWrapper_s vlIntrinsicDataWrapper_t;

struct vlWorker_s;
typedef struct vlWorker_s vlWorker_t;

typedef enum
{
    VL_LOG_LOG = 0,
    VL_LOG_FATAL = 1,
    VL_LOG_WARNING = 2,
    VL_LOG_NOTICE = 3,
    VL_LOG_INFO = 4,
    VL_LOG_DEBUG = 5
} vlLogLevel;

typedef enum
{
    VL_RENDER_ROTATION_CCW_0 = 0,
    VL_RENDER_ROTATION_CCW_90 = 2,
    VL_RENDER_ROTATION_CCW_180 = 1,
    VL_RENDER_ROTATION_CCW_270 = 3,
} vlRenderRotation;

typedef enum
{
    VL_IMAGE_FORMAT_UNDEFINED = 0,
    VL_IMAGE_FORMAT_GREY = 1,
    VL_IMAGE_FORMAT_RGB = 2,
    VL_IMAGE_FORMAT_RGBA = 3,
} vlImageFormat;

typedef void (VL_CALLINGCONVENTION *vlCallbackZString)(
    const char data[], void* clientData);

typedef void (VL_CALLINGCONVENTION *vlCallbackJsonString)(
    const char error[], const char data[], void* clientData);

typedef void (VL_CALLINGCONVENTION *vlCallbackJsonAndBinaryString)(
    const char description[], const char data[], unsigned int size,
    void* clientData);

typedef void (VL_CALLINGCONVENTION *vlCallbackImageWrapper)(
    vlImageWrapper_t* image, void* clientData);

typedef void (VL_CALLINGCONVENTION *vlCallbackExtrinsicDataWrapper)(
    vlExtrinsicDataWrapper_t* extrinsicData, void* clientData);

typedef void (VL_CALLINGCONVENTION *vlCallbackIntrinsicDataWrapper)(
    vlIntrinsicDataWrapper_t* intrinsicData, void* clientData);

#ifdef __cplusplus
extern "C"
{
#endif // __cplusplus

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionMajor();

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionMinor();

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlGetVersionRevision();
    VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionString(
        char version[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionHashString(
        char version[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION vlGetVersionTimestampString(
        char versionTimeStamp[], unsigned int maxSize);
    
    VL_SDK_API bool VL_CALLINGCONVENTION vlGetHostId(
        char hostIdBuffer[], unsigned int maxSize);
    
    VL_SDK_API bool VL_CALLINGCONVENTION vlGetBundleId(
        char bundleIdBuffer[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION vlAddLogListener(
        vlCallbackZString fn, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlRemoveLogListener(
        vlCallbackZString fn, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlClearLogListeners();

    VL_SDK_API void VL_CALLINGCONVENTION vlEnableLogBuffer();

    VL_SDK_API void VL_CALLINGCONVENTION vlDisableLogBuffer();

    VL_SDK_API void VL_CALLINGCONVENTION vlSetLogBufferSize(
        unsigned int maxEntries);

    VL_SDK_API bool VL_CALLINGCONVENTION vlFlushLogBuffer();

    VL_SDK_API int VL_CALLINGCONVENTION vlGetLogLevel();

    VL_SDK_API bool VL_CALLINGCONVENTION vlSetLogLevel(int level);

    VL_SDK_API bool VL_CALLINGCONVENTION vlLog(
        const char message[], int level);

    VL_SDK_API vlAbstractApplicationWrapper_t* VL_CALLINGCONVENTION
        vlNew_AbstractApplicationWrapper();

    VL_SDK_API void VL_CALLINGCONVENTION vlDelete_AbstractApplicationWrapper(
        vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_FoundBlockedFeatures(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_ActivateFoundBlockedFeatures(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_GetHostID(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            char hostID[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_GetBundleID(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            char bundleID[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_SetLicenseFilePath(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char *licenseFilePath);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_SetLicenseFileData(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char *licenseFileData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_GetLicenseInformation(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            char licenseInfo[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_AutoLoadPlugins(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char pluginPath[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_GetTrackerType(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            char trackerType[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_ClearProject(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_LoadProjectData(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char filename[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_LoadProjectDataFromString(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char str[], const char fakeFilename[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_RegisterThread(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_GetDeviceInfo(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            char buffer[], unsigned int maxSize);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_AddCameraCalibrationDB(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper,
            const char uri[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlAbstractApplicationWrapper_ResetCameraCalibrationDB(
            vlAbstractApplicationWrapper_t* abstractApplicationWrapper);

    VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION vlNew_ImageWrapper(vlImageFormat imageFormat);

    VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
        vlImageWrapper_Clone(vlImageWrapper_t* imageWrapper);

    VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ImageWrapper(
        vlImageWrapper_t* imageWrapper);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetFormat(
        vlImageWrapper_t* imageWrapper);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION
        vlImageWrapper_GetBytesPerPixel(
            vlImageWrapper_t* imageWrapper);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetWidth(
        vlImageWrapper_t* imageWrapper);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlImageWrapper_GetHeight(
        vlImageWrapper_t* imageWrapper);


    VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyToBuffer(
        vlImageWrapper_t* imageWrapper,
        unsigned char buffer[], unsigned int bufferSize);

    VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBuffer(
        vlImageWrapper_t* imageWrapper, const unsigned char buffer[],
        unsigned int width, unsigned int height);

    VL_SDK_API bool VL_CALLINGCONVENTION vlImageWrapper_CopyFromBufferWithFormat(
        vlImageWrapper_t* imageWrapper, const unsigned char buffer[],
        unsigned int width, unsigned int height,vlImageFormat imageFormat);
    
    VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION vlNew_ExtrinsicDataWrapper();

    VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION
        vlExtrinsicDataWrapper_Clone(vlExtrinsicDataWrapper_t* extrinsicDataWrapper);

    VL_SDK_API void VL_CALLINGCONVENTION vlDelete_ExtrinsicDataWrapper(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetValid(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetValid(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, bool value);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlExtrinsicDataWrapper_GetModelViewMatrix(
            vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float matrix[],
            unsigned int matrixElementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetT(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float t[],
        unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetT(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float t[],
        unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetR(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float q[],
        unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetR(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float q[],
        unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_GetCamPosWorld(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, float t[],
        unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION vlExtrinsicDataWrapper_SetCamPosWorld(
        vlExtrinsicDataWrapper_t* extrinsicDataWrapper, const float t[],
        unsigned int elementCount);

    VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION vlNew_IntrinsicDataWrapper();

    VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION
        vlIntrinsicDataWrapper_Clone(vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API void VL_CALLINGCONVENTION vlDelete_IntrinsicDataWrapper(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetWidth(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetWidth(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, unsigned int value);

    VL_SDK_API unsigned int VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetHeight(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetHeight(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, unsigned int value);
    VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFxNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFxNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);

    VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetFyNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetFyNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
    VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetSkewNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetSkewNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);

    VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCxNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCxNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);
    VL_SDK_API double VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCyNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCyNorm(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double value);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_GetCalibrated(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION vlIntrinsicDataWrapper_SetCalibrated(
        vlIntrinsicDataWrapper_t* intrinsicDataWrapper, bool value);

    VL_SDK_API double VL_CALLINGCONVENTION
        vlIntrinsicDataWrapper_GetCalibrationError(
            vlIntrinsicDataWrapper_t* intrinsicDataWrapper);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlIntrinsicDataWrapper_GetRadialDistortion(
            vlIntrinsicDataWrapper_t* intrinsicDataWrapper, double k[],
            unsigned int elementCount);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlIntrinsicDataWrapper_SetRadialDistortion(
            vlIntrinsicDataWrapper_t* intrinsicDataWrapper, const double k[],
            unsigned int elementCount);

    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);

    VL_SDK_API vlWorker_t* VL_CALLINGCONVENTION vlNew_Worker(
        vlAbstractApplicationWrapper_t* aap);

    VL_SDK_API vlWorker_t* VL_CALLINGCONVENTION vlNew_SyncWorker(
        vlAbstractApplicationWrapper_t* aap);

    VL_SDK_API void VL_CALLINGCONVENTION vlDelete_Worker(vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Start(vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Stop(vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RunOnceSync(
        vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonCommandSync(
        vlWorker_t* worker, const char jsonString[],
        vlCallbackJsonString callback, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessJsonAndBinaryCommandSync(
        vlWorker_t* worker,
        const char jsonString[],
        const char data[],
        unsigned int size,
        vlCallbackJsonAndBinaryString callback,
        void* clientData);

    VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION vlWorker_GetImageSync(
        vlWorker_t* worker);

    VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
        vlWorker_GetImageByNameSync(
            vlWorker_t* worker, const char* image_name);

    
    VL_SDK_API vlImageWrapper_t* VL_CALLINGCONVENTION
    vlWorker_GetNodeImageSync(vlWorker_t* worker, const char node[], const char key[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
    vlWorker_SetNodeImageSync(vlWorker_t* worker, vlImageWrapper_t* image, const char node[], const char key[]);
    
    VL_SDK_API vlExtrinsicDataWrapper_t* VL_CALLINGCONVENTION
        vlWorker_GetNodeExtrinsicDataSync(
        vlWorker_t* worker,
        const char node[],
        const char key[]);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeExtrinsicDataSync(
        vlWorker_t* worker,
        vlExtrinsicDataWrapper_t* extrinsicData,
        const char node[],
        const char key[]);

    VL_SDK_API vlIntrinsicDataWrapper_t* VL_CALLINGCONVENTION
        vlWorker_GetNodeIntrinsicDataSync(
        vlWorker_t* worker,
        const char node[],
        const char key[]);
        
    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_SetNodeIntrinsicDataSync(
        vlWorker_t* worker,
        vlIntrinsicDataWrapper_t* intrinsicData,
        const char node[],
        const char key[]);
    
    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_IsRunning(
        vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonCommand(
        vlWorker_t* worker, const char jsonString[],
        vlCallbackJsonString callback, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PushJsonAndBinaryCommand(
        vlWorker_t* worker, const char jsonString[], const char data[],
        unsigned int size, vlCallbackJsonAndBinaryString callback,
        void* clientData);

    VL_SDK_API void VL_CALLINGCONVENTION vlReleaseBinaryBuffer(const char data[]);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ProcessCallbacks(
        vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddImageListener(
        vlWorker_t* worker, vlCallbackImageWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveImageListener(
        vlWorker_t* worker, vlCallbackImageWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddDebugImageListener(
        vlWorker_t* worker,
        vlCallbackImageWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveDebugImageListener(
        vlWorker_t* worker,
        vlCallbackImageWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddExtrinsicDataListener(
        vlWorker_t* worker, vlCallbackExtrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveExtrinsicDataListener(
        vlWorker_t* worker, vlCallbackExtrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddIntrinsicDataListener(
        vlWorker_t* worker, vlCallbackIntrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveIntrinsicDataListener(
        vlWorker_t* worker, vlCallbackIntrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddTrackingStateListener(
        vlWorker_t* worker, vlCallbackZString listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveTrackingStateListener(
        vlWorker_t* worker, vlCallbackZString listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddPerformanceInfoListener(
        vlWorker_t* worker, vlCallbackZString listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemovePerformanceInfoListener(
        vlWorker_t* worker, vlCallbackZString listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION 
        vlWorker_AddAnchorToWorldTransformListener(
        vlWorker_t* worker,
        const char anchorName[],
        vlCallbackExtrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION 
        vlWorker_RemoveAnchorToWorldTransformListener(
        vlWorker_t* worker,
        const char anchorName[],
        vlCallbackExtrinsicDataWrapper listener,
        void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_AddNodeDataImageListener(
        vlWorker_t* worker, const char node[], const char key[],
        vlCallbackImageWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_RemoveNodeDataImageListener(
        vlWorker_t* worker, const char node[], const char key[],
        vlCallbackImageWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_AddNodeDataExtrinsicDataListener(
            vlWorker_t* worker, const char node[], const char key[],
            vlCallbackExtrinsicDataWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_RemoveNodeDataExtrinsicDataListener(
            vlWorker_t* worker, const char node[], const char key[],
            vlCallbackExtrinsicDataWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_AddNodeDataIntrinsicDataListener(
            vlWorker_t* worker, const char node[], const char key[],
            vlCallbackIntrinsicDataWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_RemoveNodeDataIntrinsicDataListener(
            vlWorker_t* worker, const char node[], const char key[],
            vlCallbackIntrinsicDataWrapper listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_AddNodeTrackingStateListener(vlWorker_t* worker,
            const char node[], vlCallbackZString listener, void* clientData);

    VL_SDK_API char* VL_CALLINGCONVENTION
        vlWorker_GetNodeTrackingStateJsonSync(vlWorker_t* worker, const char node[]);

    VL_SDK_API bool VL_CALLINGCONVENTION
        vlWorker_RemoveNodeTrackingStateListener(vlWorker_t* worker,
            const char node[], vlCallbackZString listener, void* clientData);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_ClearListeners(
        vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_PollEvents(
        vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_WaitEvents(
        vlWorker_t* worker, unsigned int timeout);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Lock(vlWorker_t* worker);

    VL_SDK_API bool VL_CALLINGCONVENTION vlWorker_Unlock(vlWorker_t* worker);

     VL_SDK_API char* VL_CALLINGCONVENTION vlSDKUtil_get(
        const char *uri, unsigned long *size, const char *options=0);

     VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_set(
        const char* uri, const void* data, unsigned long size,
        const char* options=0);

     VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_getTempFilename(
        const char* prefName, char *newName, unsigned int maxSize);

     VL_SDK_API char* VL_CALLINGCONVENTION
     //VL_SDK_API float* VL_CALLINGCONVENTION
         vlSDKUtil_getCameraPositionsFromGeometry(
             const char* geometryJson, unsigned long* size);

     VL_SDK_API char* VL_CALLINGCONVENTION
         // VL_SDK_API float* VL_CALLINGCONVENTION
         vlSDKUtil_getCameraTransformsFromWorkspaceDefinition(
             const char* workspaceJson,
             unsigned long* size);

     VL_SDK_API double VL_CALLINGCONVENTION
         vlSDKUtil_getPosterQuality(
        vlImageWrapper_t* imageWrapper);

     VL_SDK_API bool VL_CALLINGCONVENTION vlSDKUtil_retrievePhysicalPath(
         const char uri[],
         char physicalPath[],
         unsigned int maxSize);

#ifdef __cplusplus
}
#endif // __cplusplus

#endif // VL_SDK_H