Merge "ImageFormat: Document units/coordinate system for DEPTH_POINT_CLOUD" into oc-mr1-dev

This commit is contained in:
TreeHugger Robot
2017-10-02 21:22:57 +00:00
committed by Android (Google) Code Review

View File

@@ -658,6 +658,14 @@ public class ImageFormat {
* float confidence = floatDepthBuffer.get();
* </pre>
*
* For camera devices that support the
* {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_DEPTH_OUTPUT DEPTH_OUTPUT}
* capability, DEPTH_POINT_CLOUD coordinates have units of meters, and the coordinate system is
* defined by the camera's pose transforms:
* {@link android.hardware.camera2.CameraCharacteristics#LENS_POSE_TRANSLATION} and
* {@link android.hardware.camera2.CameraCharacteristics#LENS_POSE_ROTATION}. That means the origin is
* the optical center of the camera device, and the positive Z axis points along the camera's optical axis,
* toward the scene.
*/
public static final int DEPTH_POINT_CLOUD = 0x101;