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

Commit 0558b513 authored by TreeHugger Robot's avatar TreeHugger Robot Committed by Android (Google) Code Review
Browse files

Merge "Camera: Update streamConfigurationMap doc for JPEG sizes" into tm-dev

parents 19885f1c e07c69bf

core/java/android/hardware/camera2/CameraCharacteristics.java

+53 −22
Original line number Diff line number Diff line
@@ -2356,10 +2356,11 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <p>A subset of the available request keys that can be overridden for

     * physical devices backing a logical multi-camera.</p>

     * <p>This is a subset of android.request.availableRequestKeys which contains a list

     * of keys that can be overridden using {@link CaptureRequest.Builder#setPhysicalCameraKey }.

     * of keys that can be overridden using

     * {@link android.hardware.camera2.CaptureRequest.Builder#setPhysicalCameraKey }.

     * The respective value of such request key can be obtained by calling

     * {@link CaptureRequest.Builder#getPhysicalCameraKey }. Capture requests that contain

     * individual physical device requests must be built via

     * {@link android.hardware.camera2.CaptureRequest.Builder#getPhysicalCameraKey }.

     * Capture requests that contain individual physical device requests must be built via

     * {@link android.hardware.camera2.CameraDevice#createCaptureRequest(int, Set)}.</p>

     * <p><b>Optional</b> - The value for this key may be {@code null} on some devices.</p>

     * <p><b>Limited capability</b> -
@@ -2759,7 +2760,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * </table>

     * <p>For applications targeting SDK version 31 or newer, if the mobile device declares to be

     * media performance class 12 or higher by setting

     * {@link android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * {@link android.os.Build.VERSION#MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * the primary camera devices (first rear/front camera in the camera ID list) will not

     * support JPEG sizes smaller than 1080p. If the application configures a JPEG stream

     * smaller than 1080p, the camera device will round up the JPEG image size to at least
@@ -2833,7 +2834,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * </table>

     * <p>For applications targeting SDK version 31 or newer, if the mobile device doesn't declare

     * to be media performance class 12 or better by setting

     * {@link android.os.Build.VERSION_CODES.MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * {@link android.os.Build.VERSION#MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * or if the camera device isn't a primary rear/front camera, the minimum required output

     * stream configurations are the same as for applications targeting SDK version older than

     * 31.</p>
@@ -2958,9 +2959,27 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * can provide.</p>

     * <p>Please reference the documentation for the image data destination to

     * check if it limits the maximum size for image data.</p>

     * <p>The following table describes the minimum required output stream

     * configurations based on the hardware level

     * ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}):</p>

     * <p>For applications targeting SDK version older than 31, the following table

     * describes the minimum required output stream configurations based on the

     * hardware level ({@link CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL android.info.supportedHardwareLevel}):

     * Format                                             | Size                                         | Hardware Level | Notes

     * :-------------------------------------------------:|:--------------------------------------------:|:--------------:|:--------------:

     * {@link android.graphics.ImageFormat#JPEG }          | {@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize} (*1)     | Any            |

     * {@link android.graphics.ImageFormat#JPEG }          | 1920x1080 (1080p)                            | Any            | if 1080p &lt;= activeArraySize

     * {@link android.graphics.ImageFormat#JPEG }          | 1280x720 (720p)                               | Any            | if 720p &lt;= activeArraySize

     * {@link android.graphics.ImageFormat#JPEG }          | 640x480 (480p)                               | Any            | if 480p &lt;= activeArraySize

     * {@link android.graphics.ImageFormat#JPEG }          | 320x240 (240p)                               | Any            | if 240p &lt;= activeArraySize

     * {@link android.graphics.ImageFormat#YUV_420_888 }   | all output sizes available for JPEG          | FULL           |

     * {@link android.graphics.ImageFormat#YUV_420_888 }   | all output sizes available for JPEG, up to the maximum video size | LIMITED        |

     * {@link android.graphics.ImageFormat#PRIVATE }       | same as YUV_420_888                          | Any            |</p>

     * <p>For applications targeting SDK version 31 or newer, if the mobile device declares to be

     * media performance class 12 or higher by setting

     * {@link android.os.Build.VERSION#MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * the primary camera devices (first rear/front camera in the camera ID list) will not

     * support JPEG sizes smaller than 1080p. If the application configures a JPEG stream

     * smaller than 1080p, the camera device will round up the JPEG image size to at least

     * 1080p. The requirements for IMPLEMENTATION_DEFINED and YUV_420_888 stay the same.

     * This new minimum required output stream configurations are illustrated by the table below:</p>

     * <table>

     * <thead>

     * <tr>
@@ -2984,32 +3003,38 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <td align="center">if 1080p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#JPEG }</td>

     * <td align="center">1280x720 (720p)</td>

     * <td align="center">Any</td>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">{@link CameraCharacteristics#SENSOR_INFO_ACTIVE_ARRAY_SIZE android.sensor.info.activeArraySize}</td>

     * <td align="center">FULL</td>

     * <td align="center"></td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">1920x1080 (1080p)</td>

     * <td align="center">FULL</td>

     * <td align="center">if 1080p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">1280x720 (720)</td>

     * <td align="center">FULL</td>

     * <td align="center">if 720p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#JPEG }</td>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">640x480 (480p)</td>

     * <td align="center">Any</td>

     * <td align="center">FULL</td>

     * <td align="center">if 480p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#JPEG }</td>

     * <td align="center">320x240 (240p)</td>

     * <td align="center">Any</td>

     * <td align="center">if 240p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">all output sizes available for JPEG</td>

     * <td align="center">320x240 (240p)</td>

     * <td align="center">FULL</td>

     * <td align="center"></td>

     * <td align="center">if 240p &lt;= activeArraySize</td>

     * </tr>

     * <tr>

     * <td align="center">{@link android.graphics.ImageFormat#YUV_420_888 }</td>

     * <td align="center">all output sizes available for JPEG, up to the maximum video size</td>

     * <td align="center">all output sizes available for FULL hardware level, up to the maximum video size</td>

     * <td align="center">LIMITED</td>

     * <td align="center"></td>

     * </tr>
@@ -3021,6 +3046,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * </tr>

     * </tbody>

     * </table>

     * <p>For applications targeting SDK version 31 or newer, if the mobile device doesn't declare

     * to be media performance class 12 or better by setting

     * {@link android.os.Build.VERSION#MEDIA_PERFORMANCE_CLASS } to be 31 or larger,

     * or if the camera device isn't a primary rear/front camera, the minimum required output

     * stream configurations are the same as for applications targeting SDK version older than

     * 31.</p>

     * <p>Refer to {@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} and {@link android.hardware.camera2.CameraDevice#createCaptureSession } for additional mandatory

     * stream configurations on a per-capability basis.</p>

     * <p>*1: For JPEG format, the sizes may be restricted by below conditions:</p>