[][src]Function k4a_sys::k4a_transformation_depth_image_to_color_camera

pub unsafe extern "C" fn k4a_transformation_depth_image_to_color_camera(
    transformation_handle: k4a_transformation_t,
    depth_image: k4a_image_t,
    transformed_depth_image: k4a_image_t
) -> k4a_result_t

Transforms the depth map into the geometry of the color camera.

\param transformation_handle Transformation handle.

\param depth_image Handle to input depth image.

\param transformed_depth_image Handle to output transformed depth image.

\remarks This produces a depth image for which each pixel matches the corresponding pixel coordinates of the color camera.

\remarks \p depth_image and \p transformed_depth_image must be of format ::K4A_IMAGE_FORMAT_DEPTH16.

\remarks \p transformed_depth_image must have a width and height matching the width and height of the color camera in the mode specified by the \ref k4a_calibration_t used to create the \p transformation_handle with k4a_transformation_create().

\remarks The contents \p transformed_depth_image will be filled with the depth values derived from \p depth_image in the color camera's coordinate space.

\remarks \p transformed_depth_image should be created by the caller using k4a_image_create() or k4a_image_create_from_buffer().

\returns ::K4A_RESULT_SUCCEEDED if \p transformed_depth_image was successfully written and ::K4A_RESULT_FAILED otherwise.

\relates k4a_transformation_t

\xmlonly k4a.h (include k4a/k4a.h) k4a.lib k4a.dll \endxmlonly