Merge "camera: Update logical multi-camera requirement"

[android-x86/system-media.git] / camera / docs / metadata_definitions.xml

diff --git a/camera/docs/metadata_definitions.xml b/camera/docs/metadata_definitions.xml
index dec8acb..1130411 100644 (file)
--- a/camera/docs/metadata_definitions.xml
+++ b/camera/docs/metadata_definitions.xml
@@ -5122,6 +5122,8 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata
                   - android.lens.poseTranslation
                   - android.lens.intrinsicCalibration
                   - android.lens.radialDistortion
+              * The SENSOR_INFO_TIMESTAMP_SOURCE of the logical device and physical devices must be
+                the same.
               * The logical camera device must be LIMITED or higher device.
 
               Both the logical camera device and its underlying physical devices support the
@@ -5129,13 +5131,16 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata
 
               Additionally, for each guaranteed stream combination, the logical camera supports:
 
-              * Replacing one logical {@link android.graphics.ImageFormat#YUV_420_888|AIMAGE_FORMAT_YUV_420_888 YUV_420_888}
+              * For each guaranteed stream combination, the logical camera supports replacing one
+                logical {@link android.graphics.ImageFormat#YUV_420_888|AIMAGE_FORMAT_YUV_420_888 YUV_420_888}
                 or raw stream with two physical streams of the same size and format, each from a
                 separate physical camera, given that the size and format are supported by both
                 physical cameras.
-              * Adding two raw streams, each from one physical camera, if the logical camera doesn't
-                advertise RAW capability, but the underlying physical cameras do. This is usually
-                the case when the physical cameras have different sensor sizes.
+              * If the logical camera doesn't advertise RAW capability, but the underlying physical
+                cameras do, the logical camera will support guaranteed stream combinations for RAW
+                capability, except that the RAW streams will be physical streams, each from a separate
+                physical camera. This is usually the case when the physical cameras have different
+                sensor sizes.
 
               Using physical streams in place of a logical stream of the same size and format will
               not slow down the frame rate of the capture, as long as the minimum frame duration