diff --git a/camera/ndk/include/camera/NdkCameraMetadataTags.h b/camera/ndk/include/camera/NdkCameraMetadataTags.h index 6fefa4114a..3ac3ded451 100644 --- a/camera/ndk/include/camera/NdkCameraMetadataTags.h +++ b/camera/ndk/include/camera/NdkCameraMetadataTags.h @@ -2509,6 +2509,11 @@ typedef enum acamera_metadata_tag { *

p' = Rp

*

where p is in the device sensor coordinate system, and * p' is in the camera-oriented coordinate system.

+ *

If ACAMERA_LENS_POSE_REFERENCE is UNDEFINED, the quaternion rotation cannot + * be accurately represented by the camera device, and will be represented by + * default values matching its default facing.

+ * + * @see ACAMERA_LENS_POSE_REFERENCE */ ACAMERA_LENS_POSE_ROTATION = // float[4] ACAMERA_LENS_START + 6, @@ -2549,6 +2554,8 @@ typedef enum acamera_metadata_tag { *

When ACAMERA_LENS_POSE_REFERENCE is GYROSCOPE, then this position is relative to * the center of the primary gyroscope on the device. The axis definitions are the same as * with PRIMARY_CAMERA.

+ *

When ACAMERA_LENS_POSE_REFERENCE is UNDEFINED, this position cannot be accurately + * represented by the camera device, and will be represented as (0, 0, 0).

* * @see ACAMERA_LENS_DISTORTION * @see ACAMERA_LENS_INTRINSIC_CALIBRATION @@ -2691,8 +2698,10 @@ typedef enum acamera_metadata_tag { ACAMERA_LENS_RADIAL_DISTORTION = // Deprecated! DO NOT USE ACAMERA_LENS_START + 11, /** - *

The origin for ACAMERA_LENS_POSE_TRANSLATION.

+ *

The origin for ACAMERA_LENS_POSE_TRANSLATION, and the accuracy of + * ACAMERA_LENS_POSE_TRANSLATION and ACAMERA_LENS_POSE_ROTATION.

* + * @see ACAMERA_LENS_POSE_ROTATION * @see ACAMERA_LENS_POSE_TRANSLATION * *

Type: byte (acamera_metadata_enum_android_lens_pose_reference_t)

@@ -7539,6 +7548,19 @@ typedef enum acamera_metadata_enum_acamera_lens_pose_reference { */ ACAMERA_LENS_POSE_REFERENCE_GYROSCOPE = 1, + /** + *

The camera device cannot represent the values of ACAMERA_LENS_POSE_TRANSLATION + * and ACAMERA_LENS_POSE_ROTATION accurately enough. One such example is a camera device + * on the cover of a foldable phone: in order to measure the pose translation and rotation, + * some kind of hinge position sensor would be needed.

+ *

The value of ACAMERA_LENS_POSE_TRANSLATION must be all zeros, and + * ACAMERA_LENS_POSE_ROTATION must be values matching its default facing.

+ * + * @see ACAMERA_LENS_POSE_ROTATION + * @see ACAMERA_LENS_POSE_TRANSLATION + */ + ACAMERA_LENS_POSE_REFERENCE_UNDEFINED = 2, + } acamera_metadata_enum_android_lens_pose_reference_t;