Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 323f7edd authored by Shuzhen Wang's avatar Shuzhen Wang Committed by Android (Google) Code Review
Browse files

Merge "Camera: document multiResolution raw behavior" into udc-dev

parents a172b0f8 cc914d2e
Loading
Loading
Loading
Loading
+19 −18
Original line number Original line Diff line number Diff line
@@ -9682,24 +9682,25 @@ typedef enum acamera_metadata_enum_acamera_request_available_capabilities {
     * camera's crop region is set to maximum size, the FOV of the physical streams for the
     * camera's crop region is set to maximum size, the FOV of the physical streams for the
     * ultrawide lens will be the same as the logical stream, by making the crop region
     * ultrawide 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>
     * smaller than its active array size to compensate for the smaller focal length.</p>
     * <p>There are two ways for the application to capture RAW images from a logical camera
     * <p>For a logical camera, typically the underlying physical cameras have different RAW
     * with RAW capability:</p>
     * capabilities (such as resolution or CFA pattern). There are two ways for the
     * <ul>
     * application to capture RAW images from the logical camera:</p>
     * <li>Because the underlying physical cameras may have different RAW capabilities (such
     * <ul>
     * as resolution or CFA pattern), to maintain backward compatibility, when a RAW stream
     * <li>If the logical camera has RAW capability, the application can create and use RAW
     * is configured, the camera device makes sure the default active physical camera remains
     * streams in the same way as before. In case a RAW stream is configured, to maintain
     * active and does not switch to other physical cameras. (One exception is that, if the
     * backward compatibility, the camera device makes sure the default active physical
     * logical camera consists of identical image sensors and advertises multiple focalLength
     * camera remains active and does not switch to other physical cameras. (One exception
     * due to different lenses, the camera device may generate RAW images from different
     * is that, if the logical camera consists of identical image sensors and advertises
     * physical cameras based on the focalLength being set by the application.) This
     * multiple focalLength due to different lenses, the camera device may generate RAW
     * backward-compatible approach usually results in loss of optical zoom, to telephoto
     * images from different physical cameras based on the focalLength being set by the
     * lens or to ultrawide lens.</li>
     * application.) This backward-compatible approach usually results in loss of optical
     * <li>Alternatively, to take advantage of the full zoomRatio range of the logical camera,
     * zoom, to telephoto lens or to ultrawide lens.</li>
     * the application should use <a href="https://developer.android.com/reference/android/hardware/camera2/MultiResolutionImageReader.html">MultiResolutionImageReader</a>
     * <li>Alternatively, if supported by the device,
     * to capture RAW images from the currently active physical camera. Because different
     * <a href="https://developer.android.com/reference/android/hardware/camera2/MultiResolutionImageReader.html">MultiResolutionImageReader</a>
     * physical camera may have different RAW characteristics, the application needs to use
     * can be used to capture RAW images from one of the underlying physical cameras (
     * the characteristics and result metadata of the active physical camera for the
     * depending on current zoom level). Because different physical cameras may have
     * relevant RAW metadata.</li>
     * different RAW characteristics, the application needs to use the characteristics
     * and result metadata of the active physical camera for the relevant RAW metadata.</li>
     * </ul>
     * </ul>
     * <p>The capture request and result metadata tags required for backward compatible camera
     * <p>The capture request and result metadata tags required for backward compatible camera
     * functionalities will be solely based on the logical camera capability. On the other
     * functionalities will be solely based on the logical camera capability. On the other