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

Commit 0138393a authored by Android Build Coastguard Worker's avatar Android Build Coastguard Worker
Browse files

Snap for 11201039 from 1b7e9c03 to 24Q1-release 

Change-Id: I376b2fb4cc8bd1f3bec83e24f2130b05ba3ae1ed
parents 5b1f674a 1b7e9c03

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

+24 −17
Original line number Diff line number Diff line
@@ -3317,7 +3317,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * 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#legacy-level-guaranteed-configurations }

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">the table</a>

     * 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>

     * <ul>
@@ -3436,11 +3436,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * {@link android.hardware.camera2.CameraCharacteristics#INFO_SUPPORTED_HARDWARE_LEVEL }

     * and {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES }.

     * This is an app-readable conversion of the mandatory stream combination

     * {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations tables}.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">tables</a>.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations guideline} based on specific device level and capabilities.

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">guideline</a>.

     * based on specific device level and capabilities.

     * Clients can use the array as a quick reference to find an appropriate camera stream

     * combination.

     * As per documentation, the stream combinations with given PREVIEW, RECORD and
@@ -3469,11 +3470,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    /**

     * <p>An array of mandatory concurrent stream combinations.

     * This is an app-readable conversion of the concurrent mandatory stream combination

     * {@link android.hardware.camera2.CameraDevice#concurrent-stream-guaranteed-configurations tables}.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#concurrent-stream-guaranteed-configurations">tables</a>.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#concurrent-stream-guaranteed-configurations guideline} for each device which has its Id present in the set returned by

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#concurrent-stream-guaranteed-configurations">guideline</a>

     * for each device which has its Id present in the set returned by

     * {@link android.hardware.camera2.CameraManager#getConcurrentCameraIds }.

     * Clients can use the array as a quick reference to find an appropriate camera stream

     * combination.
@@ -3578,7 +3580,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <p>If a camera device supports multi-resolution output streams for a particular format, for

     * each of its mandatory stream combinations, the camera device will support using a

     * MultiResolutionImageReader for the MAXIMUM stream of supported formats. Refer to

     * {@link android.hardware.camera2.CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs }

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs">the table</a>

     * for additional details.</p>

     * <p>To use multi-resolution input streams, the supported formats can be queried by {@link android.hardware.camera2.params.MultiResolutionStreamConfigurationMap#getInputFormats }.

     * A reprocessable CameraCaptureSession can then be created using an {@link android.hardware.camera2.params.InputConfiguration InputConfiguration} constructed with
@@ -3587,7 +3589,7 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * {@code YUV} output, or multi-resolution {@code PRIVATE} input and multi-resolution

     * {@code PRIVATE} output, {@code JPEG} and {@code YUV} are guaranteed to be supported

     * multi-resolution output stream formats. Refer to

     * {@link android.hardware.camera2.CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs }}

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs">the table</a>

     * for details about the additional mandatory stream combinations in this case.</p>

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

     */
@@ -3700,11 +3702,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * {@link android.hardware.camera2.CaptureRequest } has {@link CaptureRequest#SENSOR_PIXEL_MODE android.sensor.pixelMode} set

     * to {@link android.hardware.camera2.CameraMetadata#SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION }.

     * This is an app-readable conversion of the maximum resolution mandatory stream combination

     * {@link android.hardware.camera2.CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors tables}.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors">tables</a>.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors guideline} for each device which has the

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors">guideline</a>

     * for each device which has the

     * {@link android.hardware.camera2.CameraMetadata#REQUEST_AVAILABLE_CAPABILITIES_ULTRA_HIGH_RESOLUTION_SENSOR }

     * capability.

     * Clients can use the array as a quick reference to find an appropriate camera stream
@@ -3727,11 +3730,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * 10-bit output capability

     * {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT }

     * This is an app-readable conversion of the 10 bit output mandatory stream combination

     * {@link android.hardware.camera2.CameraDevice#10-bit-output-additional-guaranteed-configurations tables}.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations">tables</a>.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#10-bit-output-additional-guaranteed-configurations guideline} for each device which has the

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations">guideline</a>

     * for each device which has the

     * {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT }

     * capability.

     * Clients can use the array as a quick reference to find an appropriate camera stream
@@ -3752,11 +3756,12 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * {@code PREVIEW_STABILIZATION} in {@link CameraCharacteristics#CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES android.control.availableVideoStabilizationModes}.

     * This is an app-readable conversion of the preview stabilization mandatory stream

     * combination

     * {@link android.hardware.camera2.CameraDevice#preview-stabilization-guaranteed-stream-configurations tables}.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#preview-stabilization-guaranteed-stream-configurations">tables</a>.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#preview-stabilization-guaranteed-stream-configurations guideline} for each device which supports {@code PREVIEW_STABILIZATION}

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#preview-stabilization-guaranteed-stream-configurations">guideline</a>

     * for each device which supports {@code PREVIEW_STABILIZATION}

     * Clients can use the array as a quick reference to find an appropriate camera stream

     * combination.

     * The mandatory stream combination array will be {@code null} in case the device does not
@@ -3829,8 +3834,8 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
     * <p>The guaranteed stream combinations related to stream use case for a camera device with

     * {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE }

     * capability is documented in the camera device

     * {@link android.hardware.camera2.CameraDevice#stream-use-case-capability-additional-guaranteed-configurations guideline}. The application is strongly recommended to use one of the guaranteed stream

     * combinations.

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations">guideline</a>.

     * The application is strongly recommended to use one of the guaranteed stream combinations.

     * If the application creates a session with a stream combination not in the guaranteed

     * list, or with mixed DEFAULT and non-DEFAULT use cases within the same session,

     * the camera device may ignore some stream use cases due to hardware constraints
@@ -3866,11 +3871,13 @@ public final class CameraCharacteristics extends CameraMetadata<CameraCharacteri 
    /**

     * <p>An array of mandatory stream combinations with stream use cases.

     * This is an app-readable conversion of the mandatory stream combination

     * {@link android.hardware.camera2.CameraDevice#stream-use-case-capability-additional-guaranteed-configurations tables} with each stream's use case being set.</p>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations">tables</a>

     * with each stream's use case being set.</p>

     * <p>The array of

     * {@link android.hardware.camera2.params.MandatoryStreamCombination combinations} is

     * generated according to the documented

     * {@link android.hardware.camera2.CameraDevice#stream-use-case-capability-additional-guaranteed-configurations guideline} for a camera device with

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations">guildeline</a>

     * for a camera device with

     * {@link android.hardware.camera2.CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE }

     * capability.

     * The mandatory stream combination array will be {@code null} in case the device doesn't

core/java/android/hardware/camera2/CameraMetadata.java

+15 −16
Original line number Diff line number Diff line
@@ -1216,8 +1216,7 @@ public abstract class CameraMetadata<TKey> { 
     * <ul>

     * <li>Profile {@link android.hardware.camera2.params.DynamicRangeProfiles#HLG10 }</li>

     * <li>All mandatory stream combinations for this specific capability as per

     *   documentation

     *   {@link android.hardware.camera2.CameraDevice#10-bit-output-additional-guaranteed-configurations }</li>

     *   <a href="CameraDevice#10-bit-output-additional-guaranteed-configurations">documentation</a></li>

     * <li>In case the device is not able to capture some combination of supported

     *   standard 8-bit and/or 10-bit dynamic range profiles within the same capture request,

     *   then those constraints must be listed in
@@ -1256,8 +1255,8 @@ public abstract class CameraMetadata<TKey> { 
     * </ul>

     * <p>{@link android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES }

     * lists all of the supported stream use cases.</p>

     * <p>Refer to

     * {@link android.hardware.camera2.CameraDevice#stream-use-case-capability-additional-guaranteed-configurations }

     * <p>Refer to the

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations">guideline</a>

     * for the mandatory stream combinations involving stream use cases, which can also be

     * queried via {@link android.hardware.camera2.params.MandatoryStreamCombination }.</p>

     * @see CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES
@@ -1756,9 +1755,9 @@ public abstract class CameraMetadata<TKey> { 
    /**

     * <p>This camera device does not have enough capabilities to qualify as a <code>FULL</code> device or

     * better.</p>

     * <p>Only the stream configurations listed in the <code>LEGACY</code> and <code>LIMITED</code> tables in the

     * {@link android.hardware.camera2.CameraDevice#limited-level-additional-guaranteed-configurations }

     * documentation are guaranteed to be supported.</p>

     * <p>Only the stream configurations listed in the <code>LEGACY</code> and <code>LIMITED</code>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#limited-level-additional-guaranteed-configurations">tables</a>

     * in the documentation are guaranteed to be supported.</p>

     * <p>All <code>LIMITED</code> devices support the <code>BACKWARDS_COMPATIBLE</code> capability, indicating basic

     * support for color image capture. The only exception is that the device may

     * alternatively support only the <code>DEPTH_OUTPUT</code> capability, if it can only output depth
@@ -1784,9 +1783,9 @@ public abstract class CameraMetadata<TKey> { 


    /**

     * <p>This camera device is capable of supporting advanced imaging applications.</p>

     * <p>The stream configurations listed in the <code>FULL</code>, <code>LEGACY</code> and <code>LIMITED</code> tables in the

     * {@link android.hardware.camera2.CameraDevice#full-level-additional-guaranteed-configurations }

     * documentation are guaranteed to be supported.</p>

     * <p>The stream configurations listed in the <code>FULL</code>, <code>LEGACY</code> and <code>LIMITED</code>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#full-level-additional-guaranteed-configurations">tables</a>

     * in the documentation are guaranteed to be supported.</p>

     * <p>A <code>FULL</code> device will support below capabilities:</p>

     * <ul>

     * <li><code>BURST_CAPTURE</code> capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains
@@ -1814,9 +1813,9 @@ public abstract class CameraMetadata<TKey> { 


    /**

     * <p>This camera device is running in backward compatibility mode.</p>

     * <p>Only the stream configurations listed in the <code>LEGACY</code> table in the

     * {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations }

     * documentation are supported.</p>

     * <p>Only the stream configurations listed in the <code>LEGACY</code>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">table</a>

     * in the documentation are supported.</p>

     * <p>A <code>LEGACY</code> device does not support per-frame control, manual sensor control, manual

     * post-processing, arbitrary cropping regions, and has relaxed performance constraints.

     * No additional capabilities beyond <code>BACKWARD_COMPATIBLE</code> will ever be listed by a
@@ -1839,9 +1838,9 @@ public abstract class CameraMetadata<TKey> { 
     * <p>This camera device is capable of YUV reprocessing and RAW data capture, in addition to

     * FULL-level capabilities.</p>

     * <p>The stream configurations listed in the <code>LEVEL_3</code>, <code>RAW</code>, <code>FULL</code>, <code>LEGACY</code> and

     * <code>LIMITED</code> tables in the

     * {@link android.hardware.camera2.CameraDevice#level-3-additional-guaranteed-configurations }

     * documentation are guaranteed to be supported.</p>

     * <code>LIMITED</code>

     * <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#level-3-additional-guaranteed-configurations">tables</a>

     * in the documentation are guaranteed to be supported.</p>

     * <p>The following additional capabilities are guaranteed to be supported:</p>

     * <ul>

     * <li><code>YUV_REPROCESSING</code> capability ({@link CameraCharacteristics#REQUEST_AVAILABLE_CAPABILITIES android.request.availableCapabilities} contains

core/java/android/hardware/display/DisplayManager.java

+1 −2
Original line number Diff line number Diff line
@@ -403,14 +403,13 @@ public final class DisplayManager { 


    /**

     * Virtual display flag: Indicates that the display should support system decorations. Virtual

     * displays without this flag shouldn't show home, IME or any other system decorations.

     * displays without this flag shouldn't show home, navigation bar or wallpaper.

     * <p>This flag doesn't work without {@link #VIRTUAL_DISPLAY_FLAG_TRUSTED}</p>

     *

     * @see #createVirtualDisplay

     * @see #VIRTUAL_DISPLAY_FLAG_TRUSTED

     * @hide

     */

    // TODO (b/114338689): Remove the flag and use IWindowManager#setShouldShowSystemDecors

    @TestApi

    public static final int VIRTUAL_DISPLAY_FLAG_SHOULD_SHOW_SYSTEM_DECORATIONS = 1 << 9;

core/java/android/hardware/display/VirtualDisplayConfig.java

+2 −1
Original line number Diff line number Diff line
@@ -447,7 +447,8 @@ public final class VirtualDisplayConfig implements Parcelable { 
         * Sets whether this display supports showing home activities and wallpaper.

         *

         * <p>If set to {@code true}, then the home activity relevant to this display will be

         * automatically launched upon the display creation.</p>

         * automatically launched upon the display creation. If unset or set to {@code false}, the

         * display will not host any activities upon creation.</p>

         *

         * <p>Note: setting to {@code true} requires the display to be trusted. If the display is

         * not trusted, this property is ignored.</p>

core/java/android/view/Display.java

+2 −3
Original line number Diff line number Diff line
@@ -276,15 +276,14 @@ public final class Display { 
    /**

     * Display flag: Indicates that the display should show system decorations.

     * <p>

     * This flag identifies secondary displays that should show system decorations, such as status

     * bar, navigation bar, home activity or IME.

     * This flag identifies secondary displays that should show system decorations, such as

     * navigation bar, home activity or wallpaper.

     * </p>

     * <p>Note that this flag doesn't work without {@link #FLAG_TRUSTED}</p>

     *

     * @see #getFlags()

     * @hide

     */

    // TODO (b/114338689): Remove the flag and use IWindowManager#setShouldShowSystemDecors

    public static final int FLAG_SHOULD_SHOW_SYSTEM_DECORATIONS = 1 << 6;



    /**