Motive API: Function Reference

Main Page → Developer Tools → Motive API → Function Reference

---

Note: For most up-to-date information about functions included in the Motive API, please refer to the NPTrackingTools.h header file.

Functions List

Project Management

TT_Initialize

TT_Shutdown

TT_Update

TT_UpdateSingleFrame

TT_LoadCalibrationW

TT_LoadCalibration

TT_LoadRigidBodiesW

TT_LoadRigidBodies

TT_SaveRigidBodiesW

TT_SaveRigidBodies

TT_AddRigidBodiesW

TT_AddRigidBodies

TT_LoadProfileW

TT_LoadProfile

TT_SaveProfileW

TT_SaveProfile

TT_LoadProjectW

TT_LoadProject

TT_SaveProjectW

TT_SaveProject

TT_LoadCalibrationFromMemory

Data Streaming

TT_StreamNP

TT_StreamTrackd

TT_StreamVRPN

3D Frame Data

TT_FrameMarkerCount

TT_FrameMarkerX

TT_FrameMarkerY

TT_FrameMarkerZ

TT_FrameMarkerLabel

TT_FrameMarkerResidual

TT_FrameTimeStamp

TT_FrameID

TT_FrameCameraCentroid

TT_FlushCameraQueues

Rigid Bodies

TT_IsRigidBodyTracked

TT_RigidBodyLocation

TT_ClearRigidBodyList

TT_RemoveRigidBody

TT_RigidBodyCount

TT_RigidBodyUserData

TT_SetRigidBodyUserData

TT_RigidBodyMeanError

TT_RigidBodyName

TT_RigidBodyNameW

TT_SetRigidBodyEnabled

TT_RigidBodyEnabled

TT_RigidBodyTranslatePivot

TT_RigidBodyResetOrientation

TT_RigidBodyMarkerCount

TT_RigidBodyMarker

TT_RigidBodyUpdateMarker

TT_RigidBodyPointCloudMarker

TT_RigidBodyPlacedMarker

TT_RigidBodyID

TT_CreateRigidBody

TT_RigidBodySettings

TT_SetRigidBodySettings

TT_RigidBodyRefineStart

TT_RigidBodyRefineState

TT_RigidBodyRefineProgress

TT_RigidBodyRefineInitialError

TT_RigidBodyRefineResultError

TT_RigidBodyRefineApplyResult

TT_RigidBodyRefineReset

Camera Group

TT_GetCameraManager

TT_BuildNumber

TT_CameraGroupCount

TT_CreateCameraGroup

TT_RemoveCameraGroup

TT_CamerasGroup

TT_SetGroupShutterDelay

TT_SetCameraGroup

TT_CameraGroupFilterSettings

TT_SetCameraGroupFilterSettings

TT_CameraGroupMarkerSize

TT_SetCameraGroupMarkerSize

TT_SetCameraGroupReconstruction

TT_SetEnabledFilterSwitch

TT_IsFilterSwitchEnabled

Camera

TT_CameraCount

TT_CameraXLocation

TT_CameraYLocation

TT_CameraZLocation

TT_CameraOrientationMatrix

TT_CameraName

TT_CameraMarkerCount

TT_CameraMarker

TT_CameraPixelResolution

TT_CameraMarkerPredistorted

TT_SetCameraSettings

TT_SetCameraFrameRate

TT_CameraFrameRate

TT_CameraVideoType

TT_CameraExposure

TT_CameraThreshold

TT_CameraIntensity

TT_CameraTemperature

TT_CameraRinglightTemperature

TT_CameraGrayscaleDecimation

TT_SetCameraGrayscaleDecimation

TT_SetCameraFilterSwitch

TT_SetCameraAGC

TT_SetCameraAEC

TT_SetCameraHighPower

TT_SetCameraMJPEGHighQuality

TT_CameraImagerGain

TT_CameraImagerGainLevels

TT_SetCameraImagerGain

TT_IsContinuousIRAvailable

TT_ContinuousIR

TT_SetContinuousIR

TT_ClearCameraMask

TT_SetCameraMask

TT_CameraMask

TT_CameraMaskInfo

TT_SetCameraState

TT_CameraState

TT_CameraID

TT_CameraFrameBuffer

TT_CameraFrameBufferSaveAsBMP

TT_CameraBackproject

TT_CameraUndistort2DPoint

TT_CameraDistort2DPoint

TT_CameraRay

TT_CameraModel

TT_CameraPose

TT_GetCamera

Additional

TT_OrientTrackingBar

TT_AttachCameraModule

TT_DetachCameraModule

TT_AttachRigidBodySolutionTest

TT_DetachRigidBodySolutionTest

TT_AttachListener

TT_DetachListener

TT_GetResultString

---

Deprecated Motive API Functions are not listed in this page.

Project Management

---

TT_Initialize

Initializes the API and prepares all connected devices for capturing. Please note that TT_Initialize also loads the default profile from the ProgramData directory: C:\ProgramData\OptiTrack\MotiveProfile.motive. When there is a need to load the profile from a separate directory, use TT_LoadProfile function.

NPRESULT		TT_Initialize();

Description

• This function initializes the API library and prepares all connected devices for capturing.
• When using the API, this function needs to be called at the beginning of a program before using the cameras.
• Returns an NPRESULT value. When the function successfully updates the data, it returns 0 (or NPRESULT_SUCCESS).

Function Input

• None

Function Output

• NPRESULT

C++ Example

// Initializing all connected cameras
TT_Initialize();

↑

TT_Shutdown

Shuts down all of the connected devices.

NPRESULT		TT_Shutdown();

Description

• This function closes down all connected devices and the camera library. To ensure that all devices properly shutdown, call this function before terminating an application.
• When the function successfully closes down the devices, it returns 0 (or NPRESULT_SUCCESS).
• When calling this function, currently configured camera calibration will be saved under the default System Calibration.cal file.

Function Input

• None

Function Output

• NPRESULT

C++ Example

// Close down all of the connected cameras
TT_Shutdown();
return 0;

↑

TT_Update

Processes incoming frame data from the cameras.

NPRESULT		TT_Update();

Description

• This function updates frame information with the most recent data from the cameras and 3D processing engines.
• Another use of this function is to pick up newly connected cameras. Call this function at the beginning of a program in order to make sure that all of the new cameras are properly recognized.
• TT_Update vs. TT_UpdateSingleFrame: In the case when a client application stalls momentarily, the program may get behind on updating the frames. In this situation, the TT_Update() function will disregard accumulated frames and service only the most recent frame data, but this also means that the client application will be missing the previous frames. On the other hand, the TT_UpdateSingleFrame function ensures that always a consecutive frame is updated each time the function is called. In general, a user should always use TT_Update(). Only in the case where a user wants to ensure their client application has access to every frame of tracking data and they are having problems calling TT_Update() in a timely fashion, should they consider using TT_UpdateSingleFrame(). If it is important for your program to obtain and process every single frame, use the TT_UpdateSingleFrame() function for updating the data.
• Returns an NPRESULT integer value, depending on whether the operation was successful or not. Returns NPRESULT_SUCCESS when it successfully updates the frame data.

Function Input

• None

Function Output

• NPRESULT

C++ Example

//== Update to pick up recently-arrived cameras ==/
TT_Update();

//== Frame Processing: Polling the frame data ==//
while( programRunning ){
	if( TT_Update() == NPRESULT_SUCCESS ){
		frameNumber++;
		//== Process Frame Data ==//
	}
}

↑

TT_UpdateSingleFrame

Updates a single frame of camera data.

NPRESULT		TT_UpdateSingleFrame();

Description

• Every time this function is called, it updates frame information with the next frame of camera data.
• Using this function ensures that every frame of data is processed.
• TT_Update() vs. TT_UpdateSingleFrame(): In the case when a client application stalls momentarily, the program may get behind on updating the frames. In this situation, the TT_Update() function will disregard accumulated frames and service only the most recent frame data, but this also means that the client application will be missing the previous frames. On the other hand, the TT_UpdateSingleFrame function ensures that always a consecutive frame is updated each time the function is called. In general, a user should always use TT_Update(). Only in the case where a user wants to ensure their client application has access to every frame of tracking data and they are having problems calling TT_Update() in a timely fashion, should they consider using TT_UpdateSingleFrame(). If it is important for your program to obtain and process every single frame, use the TT_UpdateSingleFrame() function for updating the data.
• Returns an NPRESULT value. When the function successfully updates the data, it returns 0 (or NPRESULT_SUCCESS).

Function Input

• None

Function Output

• NPRESULT

C++ Example

//== Update to pick up recently-arrived cameras ==/
TT_Update();

//== Frame Processing: Polling the frame data ==//
while( programRunning ){
	if( TT_UpdateSingleFrame() == NPRESULT_SUCCESS ){
		frameNumber++;
		//== Process Frame Data ==//
	}
}

↑

TT_LoadCalibration, TT_LoadCalibrationW

Loads a Motive camera calibration file.

NPRESULT		TT_LoadCalibration(const char *filename);

NPRESULT		TT_LoadCalibrationW(const wchar_t *filename);

Description

• These functions load a camera calibration file (CAL).
• Camera calibration files need to be exported from Motive.
• Returns a NPRESULT integer value. If the file was successfully loaded, it returns NPRESULT_SUCCESS.

Function Input

• Filename (const char, const wchar_t)

Function Output

• NPRESULT

C++ Example

const char *calFileName= "project.ttp";
NPRESULT fileload = TT_LoadCalibration(calFileName);

if (fileload == NPRESULT_SUCCESS)
{
	printf("%s successfully loaded.\n", calFileName);
}
else
{
	printf("Error: %s\n", TT_GetResultString(fileload));
}

Continuous Calibration Continuous calibration can be enabled by configuring the cCameraGroupPointCloudSetting settings. If you import an application profile (MOTIVE) with continuous calibration enabled, it will be applied on the Motive API project

↑

TT_LoadRigidBodies, TT_LoadRigidBodiesW

Imports TRA files and loads rigid body assets from it.

NPRESULT		TT_LoadRigidBodies(const char *filename);

NPRESULT		TT_LoadRigidBodiesW(const wchar_t *filename);

Description

• This function imports and loads rigid body assets from a saved TRA file.
• TRA files contain exported rigid body asset definitions from Motive.
• All existing assets in the project will be replaced with the rigid body assets from the TRA file when this function is called. If you want to keep existing assets and only wish to add new rigid bodies, use TT_AddRigidBodies function.
• Returns an NPRESULT integer value. It returns NPRESULT_SUCCESS when the file is successfully loaded.

Function Input

Filename (const char, const wchat_t)

Function Output

NPRESULT

C++ Example

//Loading Rigid Body Assets from a TRA file.
const char *traFile = "rigidbody.tra";
TT_LoadRigidBodies(traFile);

↑

TT_SaveRigidBodies, TT_SaveRigidBodiesW

Saves all of the rigid body asset definitions into a TRA file.

NPRESULT		TT_SaveRigidBodies(const char *filename);

NPRESULT		TT_SaveRigidBodiesW(const wchar_t *filename);

Description

• This function saves all of the rigid body assets from the project into a TRA file.
• Attach *.tra extension at the end of the filename.
• Returns an NPRESULT integer value. It returns 0 or NPRESULT_SUCCESS when successfully saving the file.

Function Input

Filename (const char, const wchar_t)

Function Output

NPRESULT

C++ Example

//== Save Rigid Bodies ==/
TT_SaveRigidBodies("traFileName.tra");

↑

TT_AddRigidBodies, TT_AddRigidBodiesW

Loads a TRA file and adds its rigid body assets onto the project.

NPRESULT		TT_AddRigidBodies(const char *filename);

NPRESULT		TT_AddRigidBodiesW(const wchar_t *filename);

Description

• This function adds rigid body assets from the imported TRA file onto the existing list.
• Adds rigid bodies from imported TRA files onto the asset list of the current project.
• Returns an NPRESULT integer value. If the rigid bodies have been added successfully, it returns 0 or NPRESULT_SUCCESS.

Function Input

Filename (const char, const wchat_t)

Function Output

NPRESULT

C++ Example

/== Adding Rigid Bodies ==/
TT_AddRigidBodies("rigidbody.tra");

↑

TT_LoadProfile, TT_LoadProfileW

Loads a Motive User Profile (.MOTIVE).

NPRESULT		TT_LoadProfile(const char *filename);

NPRESULT		TT_LoadProfileW(const wchar_t *filename);

Description

• Loads the default application profile file (MOTIVE), which is located in the ProgramData directory: C:\ProgramData\OptiTrack\MotiveProfile.motive
• The MOTIVE files store software configurations as well as other software-wide settings.
• Profile files also loads trackable asset definitions. Once the application profile containing trackable assets is imported, there is no need to import TRA and SKL files separately.
• Returns an NPRESULT integer value. If the project file was successfully loaded, it returns 0 (NPRESULT_SUCCESS).

Function Input

Filename (const char, const wchar_t)

Function Output

NPRESULT

C++ Example

//== Loading application profile XML file ==/
const char *filename= "UserProfile.ttp";
NPRESULT profileLoad = TT_LoadProfile(filename);

if (profileLoad == NPRESULT_SUCCESS)
{
	printf("%s successfully loaded.\n", filename);
}
else
{
	printf("Error: %s\n", TT_GetResultString(profileLoad));
}

↑

TT_LoadProject, TT_LoadProjectW

TTP project files are getting deprecated starting from next release of Motive. Export and use Motive profile (*.motive) instead.

Loads a Motive TTP project file.

NPRESULT		TT_LoadProject(const char *filename);

NPRESULT		TT_LoadProjectW(const wchar_t *filename);

Description

• Loads a Motive TTP project file. TTP project file loads and saves both camera calibration and rigid body assets, so when using TTP files, there is no need to import or export CAL or TRA files separately.
• Loading a project file will import all of the required information for tracking. These include camera calibration and rigid body assets that are associated with a Motive project.
• Returns an NPRESULT integer value. If the project file was successfully loaded, it returns 0 (NPRESULT_SUCCESS).

Function Input

Filename (const char, const wchar_t)

Function Output

NPRESULT

C++ Example

//== Loading TTP project file ==/
const char *filename= "project.ttp";
NPRESULT ttpload = TT_LoadProject(filename);

if (ttpload == NPRESULT_SUCCESS)
{
	printf("%s successfully loaded.\n", filename);
}
else
{
	printf("Error: %s\n", TT_GetResultString(ttpload));
}

↑

TT_SaveProfile, TT_SaveProfileW

Saves current application setting into a Profile XML file.

NPRESULT		TT_SaveProfile(const char *filename);

NPRESULT		TT_SaveProfileW(const wchar_t *filename);

Description

• This function saves the current configuration into an application Profile XML file.
• Attach *.xml extension at the end of the filename.
• Returns an NPRESULT integer value. If the profile XML file was saved successfully, it returns 0 (NPRESULT_SUCCESS).

Function Input

Filename (const char, const wchar_t)

Function Output

NPRESULT

C++ Example

//== Saving the TTP project ==/
const char *projectname = "project.ttp";
NPRESULT result = TT_SaveProfile(projectname);

if ( result == NPRESULT_SUCCESS ){
        printf("Profile XML file saved.");
}
else {
        printf("Error: %s", TT_GetResultString(result));
}

↑

TT_SaveProject, TT_SaveProjectW

TT_SaveProject, TT_SaveProjectW functions have been deprecated

What happened to the Project TTP Files? The TTP project file format is deprecated starting from the 2.0 release. Now, recorded Takes will be managed by simply loading the session folders directly onto the new Data Management pane. For exporting and importing the software setting configurations, the Motive profile file format will replace the previous role of the TTP file. In the Motive profile, software configurations such as reconstruction settings, application settings, data streaming settings, and many other settings will be contained. Camera calibration will no longer be saved in TTP files, but they will be saved in the calibration file (CAL) only. TTP files can still be loaded in Motive 2.0. However, we suggest moving away from using TTP files.

TT_LoadCalibrationFromMemory

Loads calibration from memory.

NPRESULT		TT_LoadCalibrationFromMemory(unsigned char* buffer, int bufferSize);

Description

• This function loads camera calibration from memory. In order to do this, the program must have saved calibration memory.
• It assumes the pointer argument (unsigned char*) points to a memory block where calibration data is already stored. The address and size of the calibration buffer must be determined by the developer using the API.

Function Input

• Buffer (unsigned char*)
• Size of the buffer (int)

Function Output

• NPRESULT

C++ Example

// get a pointer to the calibration block in memory
int bufferSize;
 
// get the size of the buffer
NPRESULT result = TT_LoadCalibrationFromMemory(buffer, bufferSize);

↑

Data Streaming

---

TT_StreamNP

Enables/disables the NatNet streaming of the Natrual Point tracking data.

NPRESULT		TT_StreamNP(bool enabled);

Description

• This function enables/disables NaturalPoint data stream.
• This is equivalent to the Broadcase Frame Data in the Data Streaming panel in Motive.
• Returns a NPRESULT integer value. If the operation was successful, it returns 0 (NPRESULT_SUCCESS).

Function Input

• Boolean argument enabled (true) / disabled (false)

Function Output

• NPRESULT

C++ Example

//== Enable NP Streaming ==/
TT_StreamNP(true);

↑

TT_StreamTrackd

Enables/disables streaming frame data into trackd.

NPRESULT		TT_StreamTrackd(bool enabled);

Description

• This function enables/disables streaming data into trackd.
• Returns a NPRESULT integer value. If the operation was successful, it returns 0 (NPRESULT_SUCCESS).

Function Input

• True for enabling and false for disabling (bool)

Function Output

• NPRESULT

C++ Example

//== Enable NP Streaming ==/
TT_StreamTrackd(true);

↑

TT_StreamVRPN

Enables/disables data stream into VRPN.

NPRESULT		TT_StreamVRPN(bool enabled, int port);

Description

• This function enables/disables data streaming into VRPN.
• To stream onto VRPN, the port address must be specified. VRPN server applications run through 3883 port, which is default port for the VRPN streaming.
• Returns an NPRESULT integer value. If streaming was successfully enabled, or disabled, it returns 0 (NPRESULT_SUCCESS).

Function Input

• True for enabling and false for disabling (bool)
• Streaming port address (int)

Function Output

• NPRESULT

C++ Example

//== Enable Streaming into VRPN ==/
TT_StreamVRPN(true);

↑

3D Frame Data

---

TT_FrameMarkerCount

Gets total number of reconstruected markers in a frame.

int		TT_FrameMarkerCount();

Description

• This function returns a total number of reconstructed 3D markers detected in current capture frame.
• Use this function to count a total number of markers, access every markers, and obtain the marker index values.

Function Input

• None

Function Output

• Total number of reconstructed markers in the frame (int)

C++ Example

//Obtaining total marker count
int totalMarker = TT_FrameMarkerCount();
printf("Total number of markers: %d", totalMarker);

for (int i = 0 ; i < totalMarker; i++) {
        //== Use a loop to access every marker in the frame ==//
        printf("Marker %d (X/Y/Z): (%f, %f, %f)\n", i,
		TT_FrameMarkerX(i), TT_FrameMarkerY(i), TT_FrameMarkerZ(i));
}

↑

TT_FrameMarkerX

Returns x-position of a reconstructed marker.

float		TT_FrameMarkerX(int markerIndex);

Description

• This function returns X coordinate of a reconstructed 3D marker in respect to the global coordinate system, in meters.
• It requires a marker index value.

Function Input

• Marker index (int)

Function Output

• X-position of the 3D marker (float)

C++ Example

int totalMarker = TT_FrameMarkerCount();
printf("Total number of markers: %d", totalMarker);

//== Outputting marker positions ==//
for (int i = 0 ; i < totalMarker; i++) {
        //== Use a loop to access every marker in the frame ==//
        printf("Marker %d (X/Y/Z): (%f, %f, %f)", i,
		TT_FrameMarkerX(i), TT_FrameMarkerY(i), TT_FrameMarkerZ(i));
}

↑

TT_FrameMarkerY

Returns y-position of a reconstructed marker.

float		TT_FrameMarkerY(int markerIndex);

Description

• This function returns Y coordinate of a reconstructed 3D marker in respect to the global coordinate system, in meters.
• It requires a marker index value.

Function Input

• Marker index (int)

Function Output

• Y-position of the 3D marker (float)

C++ Example

int totalMarker = TT_FrameMarkerCount();
printf("Total number of markers: %d", totalMarker);

//== Outputting marker positions ==//
for (int i = 0 ; i < totalMarker; i++) {
        //== Use a loop to access every marker in the frame ==//
        printf("Marker %d (X/Y/Z): (%f, %f, %f)", i,
		TT_FrameMarkerX(i), TT_FrameMarkerY(i), TT_FrameMarkerZ(i));
}

↑

TT_FrameMarkerZ

Returns z-position of a reconstructed marker.

float		TT_FrameMarkerZ(int markerIndex);

Description

• This function returns Z coordinate of a reconstructed 3D marker in respect to the global coordinate system, in meters.
• It requires a marker index value.

Function Input

• Marker index (int)

Function Output

• Z-position of the 3D marker (float)

C++ Example

int totalMarker = TT_FrameMarkerCount();
printf("Total number of markers: %d", totalMarker);

//== Outputting marker positions ==//
for (int i = 0 ; i < totalMarker; i++) {
        //== Use a loop to access every marker in the frame ==//
        printf("Marker %d (X/Y/Z): (%f, %f, %f)", i,
		 TT_FrameMarkerX(i), TT_FrameMarkerY(i), TT_FrameMarkerZ(i));
}

↑

TT_FrameMarkerResidual

Returns residual value of a marker.

float		TT_FrameMarkerResidual(int markerIndex);

Description

• This function returns a residual value for a given marker indicated by the marker index.
• Unit of the returned value is in millimeters.
• The marker index value may change between frames, but the unique identifier will always remain the same.

Function Input

• Marker index (int)

Function Output

• Residual value (float)

↑

TT_FrameMarkerLabel

Returns a unique identifier of a marker.

Core::cUID		TT_FrameMarkerLabel(int markerIndex);

Description

• This function returns a unique identifier (cUID) for a given marker.
• Markers have an index from 0 to [totalMarkers -1] for a given frame. In order to access unique identifier of any marker, it's index must be inputted.
• The marker index value may change between frames, but the unique identifier will always remain the same.

Function Input

• Marker index (int)

Function Output

• Marker label (cUID)

C++ Example

int totalMarkers = TT_FrameMarkerCount();
vector<Core::cUID> unique_Marker_ID(totalMarkers);

for (int i = 0; i < totalMarkers; ++i)
{
    unique_Marker_ID[i] = TT_FrameMarkerLabel(int markerIndex); 
}

↑

TT_FrameTimeStamp

Returns a timestamp value for the current frame.

double		TT_FrameTimeStamp();

Description

• This function returns a timestamp value of the current frame.

Function Input

• None

Function Output

• Frame timestamp (double)

C++ Example

int frameNumber = 0;

//== Display Frame number and Time stamp ==//
while( !_kbhit() )
{
	if( !TT_Update() ){
		frameNumber++;	// increment frame number each time a frame is processed.

		printf("Frame #%d: (Timestamp: %f)\n", frameNumber, TT_FrameTimeStamp());
	}
}

↑

TT_FrameID

Returns an ID assigned to the frame. Frame ID is basically the number of frames that a camera has recorded since the first initialization. In Motive, you can view these ID values by enabling more info from the visual aids option under the Camera Preview pane.

int         TT_FrameID();

Description

• This function returns a frame ID value of the current frame.

Function Input

• None

Function Output

• Frame ID (int)

C++ Example

int frameNumber = 0;

//== Display Frame number and ID ==//
while( !_kbhit() )
{
	if( !TT_Update() ){
		frameNumber++;	// increment frame number each time a frame is processed.

		printf("Frame #%d: (ID: %d)\n", frameNumber, TT_FrameID());
	}
}

↑

TT_FrameCameraCentroid

Checks whether a camera is contributing to reconstruction of a 3D marker, and saves corresponding 2D location as detected in the camera's view.

bool		TT_FrameCameraCentroid(int markerIndex, int cameraIndex, float &x, float &y);

Description

• This function evaluates whether the specified camera (cameraIndex) is contributing to point cloud reconstruction of a 3D point (markerIndex).
• It returns true if the camera is contributing to the marker.
• After confirming that the camera contributes to the reconstruction, this function will save the 2D location of the corresponding marker centroid in respect to the camera's view.
• The 2D location is saved in the declared variable.

Function Input

• 3D reconstructed marker index (int)
• Camera index (int)
• Reference variables for saving x and y (floats).

Function Output

• True / False (bool)

C++ Example

//== Getting 2D location of marker centroids from a camera.==//
float x, y;
int targetcam = 1;
int frameMarkercount = TT_FrameMarkerCount();

for (int i = 0; i < frameMarkercount; i++) // For each detected markers
{
	bool result = TT_FrameCameraCentroid(i, targetcam, x, y)

	if (result)
	{
		printf("Marker %d location in camera #%d: %f, %f\n", i, targetcam, x, y);
	}
}

↑

TT_FlushCameraQueues

Flushes out the camera queues.

void		TT_FlushCameraQueues();

Description

• This function flushes camera queues.
• In an event when you are tracking a very high number (hundreds) of markers and the application has accumulated data processing latency, you can call TT_FlushCameraQueues() to refresh the camera queue before calling TT_Update() for processing the frame. After calling this function, avoid calling it again until the TT_Update() function is called and NPRESULT_SUCCESS is returned.

Function Input

• None

Function Output

• Void

C++ Example

//== Flush Camera Queues to remove accumulated latency. ==//
TT_FlushCameraQueues();

//== Update the incoming camera data after. ==//
TT_Update();

↑

Rigid Bodies

---

TT_IsRigidBodyTracked

Checks whether rigid body is tracked or not.

bool		TT_IsRigidBodyTracked(int rbIndex);

Description

• Checks whether the rigid body is being tracked in the current frame.
• Returns true if the rigid body is tracked.

Function Input

• Rigid body index (int)

Function Output

• True / False (bool)

C++ Example

int totalRB = TT_RigidBodyCount();

//== Checking if the rigid body is tracked or not ==//
for(int i = 0; i < totalRB)
{
	If(TT_IsRigidBodyTracked(i))
	{
		// Process Rigid Body
	}
}

↑

TT_RigidBodyLocation

Obtains and saves 3D position, quaternion orientation, and Euler orientation of a rigid body

void		TT_RigidBodyLocation(int rbIndex,
			float *x, float *y, float *z,
			float *qx, float *qy, float *qz, float *qw,
			float *yaw, float *pitch, float *roll);

Description

• This function saves position and orientation of a rigid body. Specifically, position and orientation at the rigid body pivot point is obtained.
• 3D coordinates of the rigid body will be assigned in declared variable addresses (*x, *y, *z).
• Orientation of the rigid body will be saved in two different formats; Euler and quaternion rotations. Yaw, pitch, and roll values for Euler representation will be saved in the declared variable addresses (*yaw, *pitch, *roll), and qx, qy, qz, and qw values for the quaternion rotation will be saved in declared variable addresses (*qx, *qy, *qz, and *qw).

Function Input

• Rigid body index (int)
• Declared variable (float) addresses for:
  • 3D coordinates (x,y,z)
  • Quaternion Rotation (qx, qy, qz, qw)
  • Euler Rotation ( yaw, pitch, roll)

Function Output

• Void

C++ Example

//== Declared variables ==//
float	x, y, z;
float 	qx, qy, qz, qw;
float	yaw, pitch, roll;
int rbcount = TT_RigidBodyCount();

for(int i = 0; i < rbcount; i++)
{
	//== Obtaining/Saving the rigid body position and orientation ==//
	TT_RigidBodyLocation( i, &x, &y, &z, &qx, & qy, &qz, &qw, &yaw, &pitch, &roll );
	
	if( TT_IsRigidBodyTracked( i ) )
	{
		printf( "%s: Pos (%.3f, %.3f, %.3f) Orient (%.1f, %.1f, %.1f)\n", 
					TT_RigidBodyName( i ), x, y, z, yaw, pitch, roll );
	}
}

Euler Angles There are many potential combinations of Euler angles so it is important to understand the order in which rotations are applied, the handedness of the coordinate system, and the axis (positive or negative) that each rotation is applied about. The following conventions are used for representing Euler orientation in Motive: Rotation order: XYZ All coordinates are *right-handed* Pitch is degrees about the X axis Yaw is degrees about the Y axis Roll is degrees about the Z axis Position values are in millimeters

↑

TT_ClearRigidBodyList

Clears and removes all rigid body assets.

void		TT_ClearRigidBodyList();

Description

• This function clears all of existing rigid body assets in the project.

Function Input

• None

Function Output

• Void

C++ Example

//== Clear all rigid bodies ==//
TT_ClearRigidBodyList();

↑

TT_RemoveRigidBody

Removes a rigid body from the project

NPRESULT		TT_RemoveRigidBody(int rbIndex);

Description

• This function removes a single rigid body from a project.
• Returns a NPRESULT integer value. If the operation was successful, it returns 0 (NPRESULT_SUCCESS).

Function Input

• Rigid body index (int)

Function Output

• NPRESULT

C++ Example

//== Removing Rigid Bodies that are not tracked in the scene ==//
int totalRB = TT_RigidBodyCount();

for (int i = 0; i < totalRB; i++)
{
	if(!TT_IsRigidBodyTracked(i))
	{
 		TT_RemoveRigidBody(i);
	}
}

↑

TT_RigidBodyCount

Returns a total number of rigid bodies.

int		TT_RigidBodyCount();

Description

• This function returns a total count of rigid bodies involved in the project.
• This can be used within a loop to set required number iterations and access each of the rigid bodies.

Function Input

• None

Function Output

• Total rigid body count (int)

C++ Example

//== Getting names of all rigid bodies ==//
int totalRB = TT_RigidBodyCount();

for (int i = 0; i < totalRB; i++)
{
	printf("Rigid Body #%d: %s\n", i, TT_RigidBodyName(i));
}

↑

TT_RigidBodyUserData

Returns the User Data ID value of a rigid body.

int		TT_RigidBodyUserData(int rbIndex);

Description

• This function returns the User Data ID number of a rigid body.
• User ID is a user definable ID for the rigid body. When working with capture data in external pipelines, this value can be used to address specific rigid bodies in the scene.

Function Input

• Rigid body index (int)

Function Output

• User Data ID (int)

C++ Example

int totalRB = TT_RigidBodyCount();

//== User Data ID for all rigid bodies ==//
for ( int i = 0 ; i < totalRB; i++ )
{
	printf("%s User Data ID: %d", TT_RigidBodyName(i), TT_RigidBodyUserData(i));
}

↑

TT_SetRigidBodyUserData

Assigns a User Data ID number to a rigid body.

void		TT_SetRigidBodyUserData(int rbIndex, int ID);

Description

• Assigns a User Data ID number to a rigid body.
• The User Data ID numbers can be used to point to particular assets when processing the data in external applications.

Function Input

• Rigid body index (int)
• Desired User Data ID (int)

Function Output

• Void

C++ Example

int totalRB = TT_RigidBodyCount();

//== Assigning incremental User Data ID for rigid bodies. ==//
for( int i = 0; i < totalRB; i++ )
{
	TT_SetRigidBodyUserData(i, i+1);
	printf("Rigid Body: %s, \t User Data ID: %d", TT_RigidBodyName(i), TT_RigidBodyUserData(i)); 
}

↑

TT_RigidBodyName, TT_RigidBodyNameW

Returns the name for the rigid body.

const char* 	 	TT_RigidBodyName(int rbIndex);

const wchar_t*		TT_RigidBodyNameW(int rbIndex);

Description

• These functions are used to obtain name of a rigid body.
• Returns the assigned name of the rigid body.

Function Input

• Rigid body index (int)

Function Output

• Rigid body name (const char*, const w_chart*)

C++ Example

int totalRB = TT_RigidBodyCount();

//== Printing Rigid Body Names ==//
for( int i = 0; i < totalRB; i++ )
{
	printf("Rigid Body: %s, \t User Data ID: %d", TT_RigidBodyName(i), TT_RigidBodyUserData(i)); 
}

↑

TT_SetRigidBodyEnabled

Enables/disables tracking of a rigid body.

void		TT_SetRigidBodyEnabled(int rbIndex, bool enabled);

Description

• This function enables, or disables, tracking of the selected rigid body.
• All rigid bodies are enabled by default. Disabled rigid bodies will not be tracked, and no data will be received from it.

Function Input

• Rigid body index (int)
• Tracking status (bool)

Function Output

• Void

C++ Example

int totalRB = TT_RigidBodyCount();

//== Disabling all rigid bodies ==//
for(int i = 0; i < totalRB; i++)
{
	TT_SetRigidBodyEnabled(i, FALSE);
} 

↑

TT_RigidBodyEnabled

Checks whether a rigid body is enabled.

bool		TT_RigidBodyEnabled(int rbIndex);

Description

• This function checks whether tracking of the rigid body is enabled or not.
• The function returns true is the tracking is enabled.

Function Input

• Rigid body index (int)

Function Output

• True / False (bool)

C++ Example

int totalRB = TT_RigidBodyCount();

for (int i = 0; i < totalRB; i++)
{
	if (TT_RigidBodyEnabled(i))
	{
 		//== Disabling all enabled rigid bodies ==//
		TT_SetRigidBodyEnabled(i, FALSE);
	}
}

↑

TT_RigidBodyTranslatePivot

Translates the pivot point of a rigid body.

NPRESULT		TT_RigidBodyTranslatePivot(int index, float x, float y, float z);

Description

• This function translates a rigid body.
• 3D position of a rigid body will be displaced in x/y/z directions by inputted amount (meters).
• Translation is applied in respect to the local rigid body coordinate axis, not the global axis.
• Returns a NPRESULT integer value. If the operation was successful, it returns 0 (NPRESULT_SUCCESS).

Function Input

• Rigid body index (int)
• Translation along x-axis, in meters. (float)
• Translation along y-axis, in meters. (float)
• Translation along z-axis, in meters. (float)

Function Output

• NPRESULT

C++ Example

int rbIndex = 1;

//== Translating a rigid body 2 cm in positive x-direction ==//
TT_RigidBodyTranslate(rbIndex, 0.02, 0, 0);

↑

TT_RigidBodyResetOrientation

Resets orientation of a rigid body.

bool		TT_RigidBodyResetOrientation(int rbIndex);

Description

• This function resets orientation of the rigid body and re-aligns its orientation axis with the global coordinate system.
• Additional Note: When creating a rigid body, its zero orientation is set by aligning its axis with the global axis at the moment of creation. Calling this function essentially does the same thing on an existing rigid body asset.
• Returns true if the rigid body orientation was reset.

Function Input

• Rigid body index (int)

Function Input

• True / False (bool)

C++ Example

int rbcount = TT_RigidBodyCount();

//== Resetting orientation of each rigid body. ==//
for( int i = 0; i < rbcount i++ )
{
	if(TT_RigidBodyResetOrientation(i))
	{
		printf("Rigid body (%s) orientation reset", TT_RigidBodyName(i));
	}
}

↑

TT_RigidBodyMarkerCount

Gets total number of markers in a rigid body.

int		TT_RigidBodyMarkerCount(int rbIndex);

Description

• This function returns total number of markers involved in a rigid body.

Function Input

• Rigid body index (int)

Function Output

• Total number of marker in the rigid body (int)

C++ Example

int rbcount = TT_RigidBodyCount();

//== Listing out all of the rigid body markers ==// 
for(int i = 0; i < rbcount; i++)
{
	printf("Rigid Body:%s\t Marker Count: %d", TT_RigidBodyName(i), TT_RigidBodyMarkerCount(i));
}

↑

TT_RigidBodyMarker

Saves 3D coordinates of a solved rigid body marker in respect to respective rigid body's local space.

void		TT_RigidBodyMarker(int rbIndex, int markerIndex, float *x, float *y, float *z);

Description

• This function gets 3D position of a solved rigid body marker and saves them in designated addresses. Rigid body marker positions from this function represents solved (or expected) location of the rigid body markers. For actual reconstructed marker positions, use the TT_RigidBodyPointCloudMarker function.
• Note that the 3D coordinates obtained by this function is represented in respect to rigid body's local coordinate axis. For obtaining 3D coordinate in respect to global coordinates, use TT_RigidBodyPointCloudMarker function.

Function Input

• Rigid body index (int)
• Marker index (int)
• Three declared variable addresses for saving x, y, z coordinates of the marker (float)

Function Output

• Void

C++ Example

//== Listing out all of the rigid body markers and its respective position. ==//
int rbcount = TT_RigidBodyCount();

for(int i = 0; i < rbcount; i++)
{
	float	x,y,z;

	for(int j = 0; j < TT_RigidBodyMarkerCount(i); j++)
	{
		printf("Rigid Body:%s\t Marker #%d\n", TT_RigidBodyName(i), j);
		
		//== Marker Locations ==//
		TT_RigidBodyMarker(i, j, &x, &y, &z);
		printf("Local: (%f, %f, %f)\n", x, y, z);
	}
}

↑

TT_RigidBodyUpdateMarker

Changes and updates the rigid body marker positions.

bool     TT_RigidBodyUpdateMarker( int rbIndex, int markerIndex, float *x, float *y, float *z );

Description

• This function is used to change the expected positions of a single rigid body marker.
• Rigid body markers are expected marker positions. Read about marker types in Motive.

Function Input

• Rigid body index (int)
• Marker index (int)
• New x-position of the rigid body marker in respect to the local coordinate system.
• New y-position of the rigid body marker in respect to the local coordinate system.
• New z-position of the rigid body marker in respect to the local coordinate system.

Function Output

• Returns true if marker locations have been successfully updated.

↑

TT_RigidBodyPointCloudMarker

Saves 3D coordinates of a rigid body marker in respect to the global space.

void		TT_RigidBodyPointCloudMarker(int rbIndex, int markerIndex, bool &tracked, float &x, float &y, float &z);

Description

• This function saves 3D coordinates of each rigid body marker in designated addresses.
• 3D coordinates are saved in respect to global coordinate system.

Function Input

• Rigid body index (int)
• Marker index (int)
• Tracked status, True or False (bool)
• Three declared variable addresses for saving x, y, z coordinates of the marker (float).

Function Output

• Void

C++ Example

//== Listing out all of the rigid body markers and its respective position. ==//
int rbcount = TT_RigidBodyCount();

for(int i = 0; i < rbcount; i++)
{
	float	gx, gy, gz;
	bool	tracked;

	for(int j = 0; j < TT_RigidBodyMarkerCount(i); j++)
	{
		printf("Rigid Body:%s\t Marker #%d\n", TT_RigidBodyName(i), j);
		 
		//== Rigid Body Marker Global Coordinates ==//
		TT_RigidBodyPointCloudMarker(i, j, tracked, gx, gy, gz);
		printf("Global: (%f, %f, %f)\n", x, y, z);
	}
}

↑

TT_RigidBodyPlacedMarker

Saves 3D coordinates of a rigid body solved marker positions in respect to the global space. Unlike TT_RigidBodyPointCloudMarker function, it does not report point cloud solved positions, but it reports the expected marker positions in respect to rigid body position and orientation.

void		TT_RigidBodyPlacedMarker(int rbIndex, int markerIndex, bool &tracked, float &x, float &y, float &z);

Description

• This function saves 3D coordinates of each expected rigid body marker positions in designated variable addresses.
• 3D coordinates are saved in respect to global coordinate system.

Function Input

• Rigid body index (int)
• Marker index (int)
• Tracked status, True or False (bool)
• Three declared variable addresses for saving x, y, z coordinates of the marker (float).

Function Output

• Void

C++ Example

//== Listing out all of the rigid body markers and its respective position. ==//
int rbcount = TT_RigidBodyCount();

for(int i = 0; i < rbcount; i++)
{
	float	gx, gy, gz;
	bool	tracked;

	for(int j = 0; j < TT_RigidBodyMarkerCount(i); j++)
	{
		printf("Rigid Body:%s\t Marker #%d\n", TT_RigidBodyName(i), j);
		 
		//== Expected rigid body marker positions. ==//
		TT_RigidBodyPlacedMarker(i, j, tracked, gx, gy, gz);
		printf("Global: (%f, %f, %f)\n", x, y, z);
	}
}

↑

TT_RigidBodyMeanError

Returns a mean error of the rigid body tracking data.

void		TT_RigidBodyMeanError(int rbIndex, int ID);

Description

• Returns a mean error value of the respective rigid body data for the current frame.

Function Input

• Rigid body index (int)

Function Output

• Mean error (meters)

↑

TT_RigidBodyID

This function is used for obtaining unique identifiers for a specific rigid body indicated by the rigid body index number.

Core::cUID		TT_RigidBodyID( int rbIndex );

Function Input

• Rigid body index (int)

Function Output

• Rigid body unique ID (Core::cUID)

↑

TT_CreateRigidBody

Creates a rigid body asset from a set of reconstructed 3D markers.

NPRESULT		TT_CreateRigidBody(const char* name, int userDataID, int markerCount, float *markerList);

Description

• This functions creates a rigid body from the marker list and marker count provided in its argument.
• The marker list is expected to contain a list of marker coordinates in the following order: (x1, y1, z1, x2, y2, z2, …, xN, yN, zN). The x/y/z coordinates must be in respect to the rigid body pivot point, in meters.
• Inputted 3D locations are taken as rigid body marker positions about the rigid body pivot point. If you are using TT_FrameMarkerX/Y/Z functions to obtain the marker coordinates, you will need to subtract the pivot point location from the global marker locations when creating a rigid body. This is shown in the below example. If this is not done, created rigid body will have its pivot point at the global origin.
• Returns an NPRESULT integer value. If the rigid body was successfully created, it returns 0 or NPRESULT_SUCCESS.

Function Input

• Rigid body name (char)
• User Data ID (int)
• Marker Count (int)
• Marker list (float list)

Function Output

• NPRESULT

C++ Example

int markerCount = TT_FrameMarkerCount;
vector<float> markerListRelativeToGlobal;

// add markers to markerListRelativeToGlobal using TT_FrameMarkerX, etc
for (int i = 0; i < markerCount; ++i)
{
    	markerListRelativeToGlobal.push_back(TT_FrameMarkerX(i));
    	markerListRelativeToGlobal.push_back(TT_FrameMarkerY(i));
	markerListRelativeToGlobal.push_back(TT_FrameMarkerZ(i));
}

// then average the locations in x, y and z
float sx = 0, sy = 0, sz = 0;
for (int i = 0; i < markerCount; ++i)
{
    	sx += markerListRelativeToGlobal[3*i];
    	sy += markerListRelativeToGlobal[3*i + 1];
    	sz += markerListRelativeToGlobal[3*i + 2];
}


float ax = sx/markerCount;
float ay = sy/markerCount;
float az = sz/markerCount;


vector<float> pivotPoint = {ax, ay, az};
vector<float> markerListRelativeToPivotPoint;

// subtract the pivot point location from the marker location
for (int i = 0; i < markerCount; ++i)
{
    markerListRelativeToPivotPoint.push_back(markerListRelativeToGlobal[3*i] - ax);
    markerListRelativeToPivotPoint.push_back(markerListRelativeToGlobal[3*i + 1] - ay);
    markerListRelativeToPivotPoint.push_back(markerListRelativeToGlobal[3*i + 2] - az);
}

TT_CreateRigidBody("Rigid Body New", 1, markerCount, markerListRelativeToPivotPoint);

↑

TT_RigidBodySettings

Obtains rigid body settings for a given asset, and saves them in a cRigidBodySettings instance.

NPRESULT		TT_RigidBodySettings(int rbIndex, RigidBodySolver::cRigidBodySettings &settings);

Description

• This function obtains rigid body settings for a given rigid body asset and saves them into a declared cRigidBodySetting instance address.
• Rigid body settings are saved into an instance of the cRigidBodySettings class.
• For detailed information on member function and variables in the cRigidBodySettings class, refer to its declaration in the RigidBodySettings.h header file.
• Returns a NPRESULT integer value.

Function Input

• Rigid body index (int)
• declared instance address (cRigidBodySettings)

Function Output

• NPRESULT

C++ Example

//== Constructor at the Beginning of the program ==//
RigidBodySolver::cRigidBodySettings::cRigidBodySettings()	{};

//== Obtaining Rigid Body Settings ==//
int rbcount = TT_RigidBodyCount();
RigidBodySolver::cRigidBodySettings	settings;

for( int i = 0; i < rbcount; i++ )
{
	TT_RigidBodySettings(i, settings);

	printf("Rigid Body: %s\n", TT_RigidBodyName(i));

	//== Printing Some of the Settings==// 
	printf("MaxMarkerDeflection: %f\n", settings.MaxMarkerDeflection);
	printf("MinimumMarkerCount: %d\n", settings.MinimumMarkerCount);

	if (settings.Unique) 
	{
		printf("Unique: True\n");
	}
}

↑

TT_SetRigidBodySettings

Changes property settings of a rigid body.

NPRESULT		TT_SetRigidBodySettings(int rbIndex, RigidBodySolver::cRigidBodySettings &settings);

Description

• This function assigns a set of rigid body settings to a rigid body asset.
• An instance of cRigidBodySettings will be attached to the provided rigid body.
• Returns a NPRESULT integer value. If the marker was successfully created, it returns 0 (NPRESULT_SUCCESS).

Function Input

• Rigid body index (int)

Function Output

• NPRESULT

C++ Example

//== Constructor at the Beginning of the program ==//
int rbcount = TT_RigidBodyCount();
RigidBodySolver::cRigidBodySettings::cRigidBodySettings()	{};

RigidBodySolver::cRigidBodySettings	settings;

for(int i = 0; i < rbcount; i++)
{

	//== Obtaining configured settings for each rigid body ==//
	TT_RigidBodySettings(i, settings);

	if(settings.Unique){
		printf("Rigid Body #%d is already set to Unique", i);
	}
	else
	{
 		//== Setting/assigning all rigid bodies to Unique ==//
		settings.Unique = TRUE;
 		TT_SetRigidBodySettings(i,settings);

		printf("Rigid Body #%d has been set to Unique", i);
}

↑

TT_RigidBodyRefineStart

Initiates the rigid body refinement process. Input the number of samples and the ID of the rigid body you wish to refine. After starting the process, TT_RigidBodyRefineSample bust be called on everyframe in order to collect samples.

bool     TT_RigidBodyRefineStart( Core::cUID rigidBodyID, int sampleCount );

Description

• This function is used to start rigid body refinement.

Function Input

• Target rigid body ID
• Sample count (int)

Function Output

• Returns true if the refinement process has successfully initiated.

↑

TT_RigidBodyRefineSample

This function collects samples for rigid body refinement started by calling the TT_RigidBodyRefineStart function. Call this function for every frame; within the update loop. You can check the progress of calibration by calling the TT_RigidBodyRefineProgress function.

bool     TT_RigidBodyRefineSample();

Description

• This function collects sample rigid body tracking data for refining the definition of corresponding rigid body.

Function Input

• None. Samples frames for the initialized refine process.

Function Output

• Returns true if the refinement process has successfully collected a sample. This function does not collect samples if rigid body is not tracked on the frame.

↑

TT_RigidBodyRefineState

This function inquiries the state of the refinement process. It returns TT_RigidBodyRefineStates enum as a result.

TT_RIgidBodyRefineStates     TT_RigidBodyRefineState();

Description

• This function queries the state of the rigid body refinement process. It returns an enum value for indicating whether the proess is intialized, sampling, solving, complete, or uninitialized.

<source> enum TT_RigidBodyRefineStates {

   TT_RigidBodyRefine_Initialized = 0,
   TT_RigidBodyRefine_Sampling,
   TT_RigidBodyRefine_Solving,
   TT_RigidBodyRefine_Complete,
   TT_RigidBodyRefine_Uninitialized

};

</source>

Function Input

• None. Checks the state on the ongoing refinement process.

Function Output

• Returns TT_RigidBodyRefineStates enum value.

↑

TT_RigidBodyRefineProgress

This function inquiries the progress of the refinement sampling process.

float     TT_RigidBodyRefintProgress();

Description

• When the refinement process is under the sampling state, calling this function returns the sampling progress. It will return a percentage value representing the sampling progress in respect to the total number of samples given in the TT_RigidBodyRefineStart parameter.

Function Input

• None. Checks the progress on the ongoing refinement process.

Function Output

• Returns percentage completness of the sampling process (float).

↑

TT_RigidBodyRefineInitialError / TT_RigidBodyRefineResultError

These two functions returns error values of the rigid body definition before and after the refinement.

float     TT_RigidBodyRefineInitialError();
float     TT_RigidBodyRefineResultError();

Description

• Once the refinement process has reached complete stage, these two functions can be called to compare the error values from corresponding rigid body defintion before and after the refinement.

Function Input

• None.

Function Output

• Average error value of the target rigid body defintion prior (TT_RigidBodyRefineInitialError) and after (TT_RigidBodyRefineResultError) the refinement.

↑

TT_RigidBodyRefineApplyResult

This function applies the refined result to the corresponding rigid body definition.

bool     TT_RigidBodyRefineApplyResult();

Description

• This function applies the refined rigid body definition. After comparing the error values before and after the refinement using TT_RigidBodyRefineInitialError and TT_RigidBodyRefineResultError functions, use this function to apply if the results are satisfying.

Function Input

• None.

Function Output

• Returns true if the refined results have been successfully applied.

↑

TT_RigidBodyRefineReset

This function discards the final refinement result and resets the refinement process.

bool     TT_RigidBodyRefineReset();

Description

• If the final refinement result from the TT_RigidBodyRefineResultError call is not satisfying, you can call this function to discard the result and start over from the sampling process again.

Function Input

• None.

Function Output

• Returns true if the refined results have been successfully resetted.

↑

Camera Group

TT_GetCameraManager

Returns pointer to the CameraManager instance.

CameraLibrary::CameraManager*		TT_GetCameraManager();

Description

• This function returns a pointer to the CameraManager instance from the Camera SDK.
• Camera SDK must be installed to use this function.
• The version number of Motive and the Camera SDK must match.
• Corresponding headers and libraries must be included in the program.

Function Input

• None

Function Output

• Pointer to the CameraManager instance (CameraLibrary::CameraManager*)

C++ Example

CameraLibrary::CameraManager *cman = TT_GetCameraManager();
// cman is declared as a pointer to a camera manager used in conjuction with the Camera SDK

↑

TT_BuildNumber

Returns Motive build number.

int		TT_BuildNumber();

Description

• This function returns corresponding Motive build number.

Function Input

• None

Function Output

• Build number (int)

C++ Example

//== Printing Motive Build Number ==//
printf("Motive Build: %d\n", TT_BuildNumber());

↑

TT_CameraGroupCount

Returns camera group count.

int		TT_CameraGroupCount();

Description

• This function returns total count of camera groups that are involved in the project.

Function Input

• None

Function Output

• Camera group count (int)

C++ Example

int groupcount = TT_CameraGroupCount();

//== Processing Camera Groups ==//
for(int i = 0; i < groupcount; i++)
{
	//== Process each camera group ==//
}

↑

TT_CreateCameraGroup

Creates a new camera group.

bool		TT_CreateCameraGroup();

Description

• This function adds an additional camera group (empty) to a project.
• Note: Creating an additional camera group is unnecessary for most applications. Most common case is to group cameras to set them as a reference group for recording grayscale videos.

Function Input

• None

Function Output

• True/False (bool)

C++ Example

//== Creating a new camera group ==//
TT_CreateCameraGroup();