Merge "Camera: Clarify multi-camera RAW and FOV behaviors" into qt-dev

This commit is contained in:
TreeHugger Robot
2019-04-17 23:23:29 +00:00
committed by Android (Google) Code Review

View File

@@ -906,6 +906,24 @@ public abstract class CameraMetadata<TKey> {
* <li>{@link CameraCharacteristics#LENS_POSE_REFERENCE android.lens.poseReference}</li>
* <li>{@link CameraCharacteristics#LENS_DISTORTION android.lens.distortion}</li>
* </ul>
* <p>The field of view of all non-RAW physical streams must be the same or as close as
* possible to that of non-RAW logical streams. If the requested FOV is outside of the
* range supported by the physical camera, the physical stream for that physical camera
* will use either the maximum or minimum scaler crop region, depending on which one is
* closer to the requested FOV. For example, for a logical camera with wide-tele lens
* configuration where the wide lens is the default, if the logical camera's crop region
* is set to maximum, the physical stream for the tele lens will be configured to its
* maximum crop region. On the other hand, if the logical camera has a normal-wide lens
* configuration where the normal lens is the default, when the logical camera's crop
* region is set to maximum, the FOV of the logical streams will be that of the normal
* lens. The FOV of the physical streams for the wide lens will be the same as the
* logical stream, by making the crop region smaller than its active array size to
* compensate for the smaller focal length.</p>
* <p>Even if the underlying physical cameras have different RAW characteristics (such as
* size or CFA pattern), a logical camera can still advertise RAW capability. In this
* case, when the application configures a RAW stream, the camera device will make sure
* the active physical camera will remain active to ensure consistent RAW output
* behavior, and not switch to other physical cameras.</p>
* <p>To maintain backward compatibility, the capture request and result metadata tags
* required for basic camera functionalities will be solely based on the
* logical camera capabiltity. Other request and result metadata tags, on the other