documentation

VLAbstractApplicationWrapper Class Reference

The VLAbstractApplicationWrapper is a wrapper for the AbstractApplication. The AbstractApplication represents the tracking context. More...

Inherits IDisposable.

Public Member Functions

 VLAbstractApplicationWrapper ()
 Constructor of VLAbstractApplicationWrapper. More...
 
IntPtr GetHandle ()
 Returns the handle to the native object. More...
 
void Dispose ()
 Explicitly releases references to unmanaged resources. More...
 
bool FoundBlockedFeatures ()
 Returns whether any features are used, which are not licensed. More...
 
bool GetHostID (out string hostID)
 Returns the host ID of the current machine as string. More...
 
bool SetLicenseFilePath (string path)
 Sets the path of the license file in the system. More...
 
bool SetLicenseFileData (string data)
 Allows to inject the license data from memory More...
 
bool GetTrackerType (out string trackerType)
 Returns the type of the loaded tracking pipeline. More...
 
bool LoadProjectData (string filename)
 Loads the specified tracking configuration XML file. More...
 
bool LoadProjectDataFromString (string str, string fakeFilename)
 Loads the given string as tracking configuration. More...
 
bool RegisterThread ()
 Registers the current thread for the AbstractApplication. More...
 
VLDeviceInfo GetDeviceInfo ()
 Retrieves the device info object from the AbstractApplication. More...
 
bool AddCameraCalibrationDB (string uri)
 Adds a custom camera calibration database file. More...
 

Detailed Description

The VLAbstractApplicationWrapper is a wrapper for the AbstractApplication. The AbstractApplication represents the tracking context.

Constructor & Destructor Documentation

◆ VLAbstractApplicationWrapper()

VLAbstractApplicationWrapper.VLAbstractApplicationWrapper ( )
inline

Member Function Documentation

◆ AddCameraCalibrationDB()

bool VLAbstractApplicationWrapper.AddCameraCalibrationDB ( string  uri)
inline

Adds a custom camera calibration database file.

The calibration database must be added before loading a tracking configuration.

Returns
true, if the camera calibration database URI was added successfully; false otherwise. false will also be returned, if the URI was added already.
Parameters
uriURI to the camera calibration database file

◆ Dispose()

void VLAbstractApplicationWrapper.Dispose ( )
inline

Explicitly releases references to unmanaged resources.

Call Dispose when you are finished using the VLAbstractApplicationWrapper. The Dispose method leaves the VLAbstractApplicationWrapper in an unusable state. After calling Dispose, you must release all references to the VLAbstractApplicationWrapper so the garbage collector can reclaim the memory that the VLAbstractApplicationWrapper was occupying.

◆ FoundBlockedFeatures()

bool VLAbstractApplicationWrapper.FoundBlockedFeatures ( )
inline

Returns whether any features are used, which are not licensed.

The 'blocked features' status will be re-evaluated from time to time.

Returns
true, if unlicensed features are used; false otherwise.

◆ GetDeviceInfo()

VLDeviceInfo VLAbstractApplicationWrapper.GetDeviceInfo ( )
inline

Retrieves the device info object from the AbstractApplication.

Returns
VLDeviceInfo, if the device info was acquired successfully; null otherwise.

◆ GetHandle()

IntPtr VLAbstractApplicationWrapper.GetHandle ( )
inline

Returns the handle to the native object.

Returns
Handle to native object.

◆ GetHostID()

bool VLAbstractApplicationWrapper.GetHostID ( out string  hostID)
inline

Returns the host ID of the current machine as string.

The host ID is necessary for generating a license file.

Returns
true, if host ID was gotten; false otherwise.
Parameters
hostIDOutput host ID string.

◆ GetTrackerType()

bool VLAbstractApplicationWrapper.GetTrackerType ( out string  trackerType)
inline

Returns the type of the loaded tracking pipeline.

This only works for tracking configurations loaded from a vl-file or vl-string.

Returns
true, if tracker type was retrieved successful false otherwise.
Parameters
trackerTypeOutput host ID string.

◆ LoadProjectData()

bool VLAbstractApplicationWrapper.LoadProjectData ( string  filename)
inline

Loads the specified tracking configuration XML file.

Returns
true, if the tracking configuration was loaded successfully; false otherwise.
Parameters
filenameFilename of the tracking configuration
string trackingFile = Path.Combine(Application.streamingAssetsPath, "tracking.vl");
aap.LoadProjectData(trackingFile);

◆ LoadProjectDataFromString()

bool VLAbstractApplicationWrapper.LoadProjectDataFromString ( string  str,
string  fakeFilename 
)
inline

Loads the given string as tracking configuration.

Returns
true, if the tracking configuration was loaded successfully; false otherwise.
Parameters
strString with the tracking configuration
fakeFilenameFilename which will be used to determine the type of the tracking configuration (vl / PM) and for resolving relative file paths and the type of the tracking configuration.

◆ RegisterThread()

bool VLAbstractApplicationWrapper.RegisterThread ( )
inline

Registers the current thread for the AbstractApplication.

Returns
true, if the thread was registered correctly; false otherwise.

◆ SetLicenseFileData()

bool VLAbstractApplicationWrapper.SetLicenseFileData ( string  data)
inline

Allows to inject the license data from memory

Returns
true, if the given license data is valid; false otherwise.
Parameters
dataString with the license data.

◆ SetLicenseFilePath()

bool VLAbstractApplicationWrapper.SetLicenseFilePath ( string  path)
inline

Sets the path of the license file in the system.

Calling of this function is mandatory for starting the tracking configuration.

Returns
true, if a valid license file could be found; false otherwise.
Parameters
pathThe absolute location of the file.