Mesh texturing

APIs for texturing of 3D meshes. More...

Functions
Tango3DR_Status	Tango3DR_getTexturedMesh (const Tango3DR_TexturingContext context, Tango3DR_Mesh *tango_mesh_out)
Tango3DR_TexturingContext	Tango3DR_TexturingContext_create (const Tango3DR_Config texture_config, const Tango3DR_Mesh *tango_mesh)
Tango3DR_Status	Tango3DR_TexturingContext_destroy (Tango3DR_TexturingContext context)
Tango3DR_Status	Tango3DR_TexturingContext_setColorCalibration (const Tango3DR_TexturingContext context, const Tango3DR_CameraCalibration *calibration)
Tango3DR_Status	Tango3DR_updateTexture (Tango3DR_TexturingContext context, const Tango3DR_ImageBuffer *image, const Tango3DR_Pose *image_pose)
Tango3DR_Status	Tango3DR_updateTextureGl (Tango3DR_TexturingContext context, const int texture_target, const int image_texture_id, const Tango3DR_Pose *image_pose)

---

Detailed Description

APIs for texturing of 3D meshes.

---

Function Documentation

Tango3DR_Status Tango3DR_getTexturedMesh	(	const Tango3DR_TexturingContext	context,
		Tango3DR_Mesh *	tango_mesh_out
	)

Extracts the textured mesh from the texturing context.

Parameters:

context	Handle to the texturing context.
mesh	On successful return, a freshly allocated Tango3DR_Mesh containing the mesh for the grid cell. After use, free this by calling Tango3DR_Mesh_destroy().

Returns:

TANGO_3DR_SUCCESS on success, TANGO_3DR_INVALID if the parameters are not valid

Tango3DR_TexturingContext Tango3DR_TexturingContext_create	(	const Tango3DR_Config	texture_config,
		const Tango3DR_Mesh *	tango_mesh
	)

Create a new Tango 3D texturing context and return a handle to it.

Parameters:

context_config	The context will be started with the setting specified by this config handle. If NULL is passed here, then the context will be started in the default configuration.
tango_mesh	mesh that will be textured.

Returns:

A handle to the Tango texturing context.

Tango3DR_Status Tango3DR_TexturingContext_destroy

(

Tango3DR_TexturingContext

context

)

Destroy a previously created texturing context.

Parameters:

context

Handle to a previously created context.

Returns:

TANGO_3DR_SUCCESS on successfully destroying the context. Returns TANGO_3DR_INVALID if context is NULL.

Tango3DR_Status Tango3DR_TexturingContext_setColorCalibration	(	const Tango3DR_TexturingContext	context,
		const Tango3DR_CameraCalibration *	calibration
	)

Sets the color camera intrinsic calibration that a texturing context uses. It is required to call this function once before calling Tango3DR_updateTexture and .

Parameters:

context	Handle to a texturing context.
calibration	The calibration parameters of the color camera.

Returns:

TANGO_3DR_SUCCESS on success, if the parameters are not valid.

Tango3DR_Status Tango3DR_updateTexture	(	Tango3DR_TexturingContext	context,
		const Tango3DR_ImageBuffer *	image,
		const Tango3DR_Pose *	image_pose
	)

Updates the texturing context using an image with a corresponding pose. Must be called from the same thread where the context was created and destroyed.

Parameters:

context	Handle to the texturing context.
image	Image used for texturing. Ideally, the image should be in TANGO_3DR_HAL_PIXEL_FORMAT_YCrCb_420_SP. Other formats (RGB_888/RGBA_8888) will be converted automatically.
image_pose	Pose corresponding to the image.

Returns:

TANGO_3DR_SUCCESS on success and TANGO_3DR_INVALID if the parameters are not valid.

Tango3DR_Status Tango3DR_updateTextureGl	(	Tango3DR_TexturingContext	context,
		const int	texture_target,
		const int	image_texture_id,
		const Tango3DR_Pose *	image_pose
	)

Updates the texturing context using an image with a corresponding pose. Must be called from the same thread where the context was created and destroyed.

Additionally, a valid GL context supporting at least Desktop OpengGL 2.1 or OpenGL ES 2 must be current on the calling thread.

Parameters:

context	Handle to the texturing context.
texture_target	Must be GL_TEXTURE_2D on Linux or Android, or GL_TEXTURE_EXTERNAL_OES on Android.
image_texture_id	OpenGL ID of the current camera image texture.
image_pose	Pose corresponding to the image.

Returns:

TANGO_3DR_SUCCESS on success and TANGO_3DR_INVALID if the parameters are not valid.