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.