Dataset processing

APIs for miscellaneous post-processing of Tango datasets. More...

Typedefs
typedef void(*	Tango3DR_ProgressCallback )(int progress, void *callback_param)
	A callback function for dataset processing to report progress.
Functions
Tango3DR_Status	Tango3DR_AreaDescription_createFromDataset (const char *dataset_path, const char *loop_closure_database_path, Tango3DR_AreaDescription *area_description, Tango3DR_ProgressCallback progress_callback, void *callback_param)
Tango3DR_Status	Tango3DR_extractRawDataFromDataset (const char *dataset_path, const char *output_path, Tango3DR_ProgressCallback progress_callback, void *callback_param)
Tango3DR_Status	Tango3DR_textureMeshFromDataset (const Tango3DR_Config texture_config, const char *dataset_path, const Tango3DR_Trajectory trajectory, const Tango3DR_Mesh *tango_mesh_in, Tango3DR_Mesh *tango_mesh_out, Tango3DR_ProgressCallback progress_callback, void *callback_param)
Tango3DR_Status	Tango3DR_updateFromTrajectoryAndDataset (const Tango3DR_ReconstructionContext context, const char *dataset_path, const Tango3DR_Trajectory trajectory, Tango3DR_ProgressCallback progress_callback, void *callback_param)

---

Detailed Description

APIs for miscellaneous post-processing of Tango datasets.

---

Typedef Documentation

typedef void(* Tango3DR_ProgressCallback)(int progress, void *callback_param)

A callback function for dataset processing to report progress.

Definition at line 1614 of file tango_3d_reconstruction_api.h.

---

Function Documentation

Tango3DR_Status Tango3DR_AreaDescription_createFromDataset	(	const char *	dataset_path,
		const char *	loop_closure_database_path,
		Tango3DR_AreaDescription *	area_description,
		Tango3DR_ProgressCallback	progress_callback,
		void *	callback_param
	)

Create an AreaDescription from a given dataset recording. A new AreaDescription will be allocated. To free it up, call Tango3DR_AreaDescription_destroy.

Parameters:

dataset_path	path to a Tango dataset.
loop_closure_database_path	path to a a loop closure database, available for download from the Tango developers website.
area_description	pointer to an area description to be allocated by this function.
progress_callback	Called periodically while creating the trajectory. Optional, can be NULL.
callback_param	Value passed as callback_param to the callback. Optional, can be NULL.

Returns:

TANGO_3DR_SUCCESS on success, TANGO_3DR_INVALID if the parameters are not valid, and TANGO_3DR_ERROR if some other error occurred.

Tango3DR_Status Tango3DR_extractRawDataFromDataset	(	const char *	dataset_path,
		const char *	output_path,
		Tango3DR_ProgressCallback	progress_callback,
		void *	callback_param
	)

Extract the raw sensor data (images, point clouds, IMU) from a Tango dataset and saves it in human-readable form. Running this function might take some time.

Parameters:

dataset_path	Path to a dataset.
output_path	Path to the output folder.
progress_callback	Called periodically while exporting the dataset. Optional, can be set to NULL.
callback_param	Value passed as callback_param to the callback.

Tango3DR_Status Tango3DR_textureMeshFromDataset	(	const Tango3DR_Config	texture_config,
		const char *	dataset_path,
		const Tango3DR_Trajectory	trajectory,
		const Tango3DR_Mesh *	tango_mesh_in,
		Tango3DR_Mesh *	tango_mesh_out,
		Tango3DR_ProgressCallback	progress_callback,
		void *	callback_param
	)

Extract a mesh with textures given a trajectory and dataset.

Parameters:

texture_config	Configuration for texturing. If NULL is passed here, texturing will be done with the default configuration.
dataset_path	Path to a dataset file.
trajectory	Handle to a trajectory representing the path a Tango device traveled over time.
tango_mesh_in	Mesh to texture. Commonly previously extracted from Tango3DR_extractFullMesh().
tango_mesh_out	On successful return, a freshly allocated Tango3DR_Mesh containing the mesh with texture processing. After use, free this by calling Tango3DR_Mesh_destroy().
progress_callback	Called periodically while texturing the mesh. Optional.
callback_param	Value passed as callback_param to the callback.

Returns:

TANGO_3DR_SUCCESS on success, TANGO_3DR_INVALID if the parameters are not valid, and TANGO_3DR_ERROR if some other error occurred.

Tango3DR_Status Tango3DR_updateFromTrajectoryAndDataset	(	const Tango3DR_ReconstructionContext	context,
		const char *	dataset_path,
		const Tango3DR_Trajectory	trajectory,
		Tango3DR_ProgressCallback	progress_callback,
		void *	callback_param
	)

Update the voxels given a trajectory and dataset.

Parameters:

context	Handle to a previously created context.
dataset_path	Path to a dataset file.
trajectory	Handle to a trajectory representing the path a Tango device traveled over time.
progress_callback	Called periodically while creating the trajectory. Optional.
callback_param	Value passed as callback_param to the callback.

Returns:

TANGO_3DR_SUCCESS on success, TANGO_3DR_INVALID if the parameters are not valid, and TANGO_3DR_ERROR if some other error occurred.