Azure Kinect Sensor SDK
refs/heads/master
Documentation for https://github.com/Microsoft/AzureKinectSensorSDK


related 
Transform a 2D pixel coordinate with an associated depth value of the source camera into a 2D pixel coordinate of the target camera.
calibration  Location to read the camera calibration obtained by k4a_device_get_calibration(). 
source_point2d  The 2D pixel in source_camera coordinates. 
source_depth_mm  The depth of source_point2d in millimeters. One way to derive the depth value in the color camera geometry is to use the function k4a_transformation_depth_image_to_color_camera(). 
source_camera  The current camera. 
target_camera  The target camera. 
target_point2d  The 2D pixel in target_camera coordinates. 
valid  The output parameter returns a value of 1 if the source_point2d is a valid coordinate in the target_camera coordinate system, and will return 0 if the coordinate is not valid in the calibration model. 
target_point2d
was successfully written. K4A_RESULT_FAILED if calibration
contained invalid transformation parameters. If the function returns K4A_RESULT_SUCCEEDED, but valid
is 0, the transformation was computed, but the results in target_point2d
are outside of the range of valid calibration and should be ignored.source_point2d
and then using k4a_calibration_3d_to_2d() to map the 3D point into the coordinate system of the target_camera
.source_camera
and target_camera
are identical, the function immediately sets target_point2d
to source_point2d
and returns without computing any transformations.source_point2d
does not map to a valid 2D coordinate in the target_camera
coordinate system, valid
is set to 0. If it is valid, valid
will be set to 1. The user should not use the value of target_point2d
if valid
was set to 0.