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

am: 56afee3c1f

Change-Id: I07f2205daf1d751e08a67381048a93ccbd3af86d
This commit is contained in:
Eino-Ville Talvala
2017-10-02 21:47:36 +00:00
committed by android-build-merger

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;