Snap for 11273583 from e20e5f920a4a745710dde2ee82f011c2036cf954 to mainline-cellbroadcast-release
Change-Id: If7d39a10b037c9bce30c232a1119ad9d281a1f10
diff --git a/camera/docs/docs.html b/camera/docs/docs.html
index ca2c4a2..1883aa2 100644
--- a/camera/docs/docs.html
+++ b/camera/docs/docs.html
@@ -3030,7 +3030,7 @@
<p>To start a CaptureSession with a target FPS range different from the
capture request template's default value,<wbr/> the application
is strongly recommended to call
-<a href="https://developer.android.com/reference/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
+<a href="https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
with the target fps range before creating the capture session.<wbr/> The aeTargetFpsRange is
typically a session parameter.<wbr/> Specifying it at session creation time helps avoid
session reconfiguration delays in cases like 60fps or high speed recording.<wbr/></p>
@@ -4790,7 +4790,7 @@
OFF if the recording output is not stabilized,<wbr/> or if there are no output
Surface types that can be stabilized.<wbr/></p>
<p>The application is strongly recommended to call
-<a href="https://developer.android.com/reference/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
+<a href="https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
with the desired video stabilization mode before creating the capture session.<wbr/>
Video stabilization mode is a session parameter on many devices.<wbr/> Specifying
it at session creation time helps avoid reconfiguration delay caused by difference
@@ -8312,7 +8312,7 @@
<p>To start a CaptureSession with a target FPS range different from the
capture request template's default value,<wbr/> the application
is strongly recommended to call
-<a href="https://developer.android.com/reference/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
+<a href="https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
with the target fps range before creating the capture session.<wbr/> The aeTargetFpsRange is
typically a session parameter.<wbr/> Specifying it at session creation time helps avoid
session reconfiguration delays in cases like 60fps or high speed recording.<wbr/></p>
@@ -11115,7 +11115,7 @@
OFF if the recording output is not stabilized,<wbr/> or if there are no output
Surface types that can be stabilized.<wbr/></p>
<p>The application is strongly recommended to call
-<a href="https://developer.android.com/reference/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
+<a href="https://developer.android.com/reference/android/hardware/camera2/params/SessionConfiguration.html#setSessionParameters">SessionConfiguration#setSessionParameters</a>
with the desired video stabilization mode before creating the capture session.<wbr/>
Video stabilization mode is a session parameter on many devices.<wbr/> Specifying
it at session creation time helps avoid reconfiguration delay caused by difference
@@ -20263,8 +20263,7 @@
<ul>
<li>Profile <a href="https://developer.android.com/reference/android/hardware/camera2/params/DynamicRangeProfiles.html#HLG10">DynamicRangeProfiles#HLG10</a></li>
<li>All mandatory stream combinations for this specific capability as per
- documentation
- <a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#10-bit-output-additional-guaranteed-configurations">CameraDevice#10-bit-output-additional-guaranteed-configurations</a></li>
+ <a href="https://developer.android.com/reference/android/hardware/camera2/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/<wbr/>or 10-bit dynamic range profiles within the same capture request,<wbr/>
then those constraints must be listed in
@@ -20302,8 +20301,8 @@
</ul>
<p><a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#SCALER_AVAILABLE_STREAM_USE_CASES">Camera<wbr/>Characteristics#SCALER_<wbr/>AVAILABLE_<wbr/>STREAM_<wbr/>USE_<wbr/>CASES</a>
lists all of the supported stream use cases.<wbr/></p>
-<p>Refer to
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#stream-use-case-capability-additional-guaranteed-configurations">CameraDevice#stream-use-case-capability-additional-guaranteed-configurations</a>
+<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,<wbr/> which can also be
queried via <a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">MandatoryStreamCombination</a>.<wbr/></p></span>
</li>
@@ -23761,7 +23760,7 @@
stream configurations are the same as for applications targeting SDK version older than
31.<wbr/></p>
<p>Refer to <a href="#static_android.request.availableCapabilities">android.<wbr/>request.<wbr/>available<wbr/>Capabilities</a> and
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">CameraDevice#legacy-level-guaranteed-configurations</a>
+<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.<wbr/></p>
<p>*1: For JPEG format,<wbr/> the sizes may be restricted by below conditions:</p>
<ul>
@@ -24199,7 +24198,7 @@
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#INFO_SUPPORTED_HARDWARE_LEVEL">Camera<wbr/>Characteristics#INFO_<wbr/>SUPPORTED_<wbr/>HARDWARE_<wbr/>LEVEL</a>
and <a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#REQUEST_AVAILABLE_CAPABILITIES">Camera<wbr/>Characteristics#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES</a>.<wbr/>
This is an app-readable conversion of the mandatory stream combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">tables</a>.<wbr/></p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">tables</a>.<wbr/></p>
</td>
<td class="entry_units">
@@ -24224,7 +24223,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">guideline</a> based on specific device level and capabilities.<wbr/>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">guideline</a>.<wbr/>
+based on specific device level and capabilities.<wbr/>
Clients can use the array as a quick reference to find an appropriate camera stream
combination.<wbr/>
As per documentation,<wbr/> the stream combinations with given PREVIEW,<wbr/> RECORD and
@@ -24279,7 +24279,7 @@
<td class="entry_description">
<p>An array of mandatory concurrent stream combinations.<wbr/>
This is an app-readable conversion of the concurrent mandatory stream combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#concurrent-stream-guaranteed-configurations">tables</a>.<wbr/></p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#concurrent-stream-guaranteed-configurations">tables</a>.<wbr/></p>
</td>
<td class="entry_units">
@@ -24304,7 +24304,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#concurrent-stream-guaranteed-configurations">guideline</a> 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
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraManager.html#getConcurrentCameraIds">CameraManager#getConcurrentCameraIds</a>.<wbr/>
Clients can use the array as a quick reference to find an appropriate camera stream
combination.<wbr/>
@@ -24603,7 +24604,7 @@
<p>If a camera device supports multi-resolution output streams for a particular format,<wbr/> for
each of its mandatory stream combinations,<wbr/> the camera device will support using a
MultiResolutionImageReader for the MAXIMUM stream of supported formats.<wbr/> Refer to
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs">CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs</a>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs">the table</a>
for additional details.<wbr/></p>
<p>To use multi-resolution input streams,<wbr/> the supported formats can be queried by <a href="https://developer.android.com/reference/android/hardware/camera2/params/MultiResolutionStreamConfigurationMap.html#getInputFormats">MultiResolutionStreamConfigurationMap#getInputFormats</a>.<wbr/>
A reprocessable CameraCaptureSession can then be created using an <a href="https://developer.android.com/reference/android/hardware/camera2/params/InputConfiguration.html">InputConfiguration</a> constructed with
@@ -24612,7 +24613,7 @@
{@code YUV} output,<wbr/> or multi-resolution {@code PRIVATE} input and multi-resolution
{@code PRIVATE} output,<wbr/> {@code JPEG} and {@code YUV} are guaranteed to be supported
multi-resolution output stream formats.<wbr/> Refer to
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs">CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs</a>}
+<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.<wbr/></p>
</td>
</tr>
@@ -25005,7 +25006,7 @@
<a href="https://developer.android.com/reference/android/hardware/camera2/CaptureRequest.html">CaptureRequest</a> has <a href="#controls_android.sensor.pixelMode">android.<wbr/>sensor.<wbr/>pixel<wbr/>Mode</a> set
to <a href="https://developer.android.com/reference/android/hardware/camera2/CameraMetadata.html#SENSOR_PIXEL_MODE_MAXIMUM_RESOLUTION">Camera<wbr/>Metadata#SENSOR_<wbr/>PIXEL_<wbr/>MODE_<wbr/>MAXIMUM_<wbr/>RESOLUTION</a>.<wbr/>
This is an app-readable conversion of the maximum resolution mandatory stream combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#additional-guaranteed-combinations-for-ultra-high-resolution-sensors">tables</a>.<wbr/></p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors">tables</a>.<wbr/></p>
</td>
<td class="entry_units">
@@ -25030,7 +25031,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#additional-guaranteed-combinations-for-ultra-high-resolution-sensors">guideline</a> 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
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraMetadata.html#REQUEST_AVAILABLE_CAPABILITIES_ULTRA_HIGH_RESOLUTION_SENSOR">Camera<wbr/>Metadata#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES_<wbr/>ULTRA_<wbr/>HIGH_<wbr/>RESOLUTION_<wbr/>SENSOR</a>
capability.<wbr/>
Clients can use the array as a quick reference to find an appropriate camera stream
@@ -25082,7 +25084,7 @@
10-bit output capability
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT">Camera<wbr/>Characteristics#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES_<wbr/>DYNAMIC_<wbr/>RANGE_<wbr/>TEN_<wbr/>BIT</a>
This is an app-readable conversion of the 10 bit output mandatory stream combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#10-bit-output-additional-guaranteed-configurations">tables</a>.<wbr/></p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations">tables</a>.<wbr/></p>
</td>
<td class="entry_units">
@@ -25107,7 +25109,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#10-bit-output-additional-guaranteed-configurations">guideline</a> 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
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#REQUEST_AVAILABLE_CAPABILITIES_DYNAMIC_RANGE_TEN_BIT">Camera<wbr/>Characteristics#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES_<wbr/>DYNAMIC_<wbr/>RANGE_<wbr/>TEN_<wbr/>BIT</a>
capability.<wbr/>
Clients can use the array as a quick reference to find an appropriate camera stream
@@ -25159,7 +25162,7 @@
{@code PREVIEW_<wbr/>STABILIZATION} in <a href="#static_android.control.availableVideoStabilizationModes">android.<wbr/>control.<wbr/>available<wbr/>Video<wbr/>Stabilization<wbr/>Modes</a>.<wbr/>
This is an app-readable conversion of the preview stabilization mandatory stream
combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#preview-stabilization-guaranteed-stream-configurations">tables</a>.<wbr/></p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#preview-stabilization-guaranteed-stream-configurations">tables</a>.<wbr/></p>
</td>
<td class="entry_units">
@@ -25184,7 +25187,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#preview-stabilization-guaranteed-stream-configurations">guideline</a> for each device which supports {@code PREVIEW_<wbr/>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_<wbr/>STABILIZATION}
Clients can use the array as a quick reference to find an appropriate camera stream
combination.<wbr/>
The mandatory stream combination array will be {@code null} in case the device does not
@@ -25478,8 +25482,8 @@
<p>The guaranteed stream combinations related to stream use case for a camera device with
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE">Camera<wbr/>Characteristics#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES_<wbr/>STREAM_<wbr/>USE_<wbr/>CASE</a>
capability is documented in the camera device
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#stream-use-case-capability-additional-guaranteed-configurations">guideline</a>.<wbr/> The application is strongly recommended to use one of the guaranteed stream
-combinations.<wbr/>
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations">guideline</a>.<wbr/>
+The application is strongly recommended to use one of the guaranteed stream combinations.<wbr/>
If the application creates a session with a stream combination not in the guaranteed
list,<wbr/> or with mixed DEFAULT and non-DEFAULT use cases within the same session,<wbr/>
the camera device may ignore some stream use cases due to hardware constraints
@@ -25530,7 +25534,8 @@
<td class="entry_description">
<p>An array of mandatory stream combinations with stream use cases.<wbr/>
This is an app-readable conversion of the mandatory stream combination
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#stream-use-case-capability-additional-guaranteed-configurations">tables</a> with each stream's use case being set.<wbr/></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.<wbr/></p>
</td>
<td class="entry_units">
@@ -25555,7 +25560,8 @@
<p>The array of
<a href="https://developer.android.com/reference/android/hardware/camera2/params/MandatoryStreamCombination.html">combinations</a> is
generated according to the documented
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#stream-use-case-capability-additional-guaranteed-configurations">guideline</a> 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
<a href="https://developer.android.com/reference/android/hardware/camera2/CameraCharacteristics.html#REQUEST_AVAILABLE_CAPABILITIES_STREAM_USE_CASE">Camera<wbr/>Characteristics#REQUEST_<wbr/>AVAILABLE_<wbr/>CAPABILITIES_<wbr/>STREAM_<wbr/>USE_<wbr/>CASE</a>
capability.<wbr/>
The mandatory stream combination array will be {@code null} in case the device doesn't
@@ -35416,9 +35422,9 @@
<span class="entry_type_enum_name">LIMITED (v3.2)</span>
<span class="entry_type_enum_notes"><p>This camera device does not have enough capabilities to qualify as a <code>FULL</code> device or
better.<wbr/></p>
-<p>Only the stream configurations listed in the <code>LEGACY</code> and <code>LIMITED</code> tables in the
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#limited-level-additional-guaranteed-configurations">CameraDevice#limited-level-additional-guaranteed-configurations</a>
-documentation are guaranteed to be supported.<wbr/></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.<wbr/></p>
<p>All <code>LIMITED</code> devices support the <code>BACKWARDS_<wbr/>COMPATIBLE</code> capability,<wbr/> indicating basic
support for color image capture.<wbr/> The only exception is that the device may
alternatively support only the <code>DEPTH_<wbr/>OUTPUT</code> capability,<wbr/> if it can only output depth
@@ -35436,9 +35442,9 @@
<li>
<span class="entry_type_enum_name">FULL (v3.2)</span>
<span class="entry_type_enum_notes"><p>This camera device is capable of supporting advanced imaging applications.<wbr/></p>
-<p>The stream configurations listed in the <code>FULL</code>,<wbr/> <code>LEGACY</code> and <code>LIMITED</code> tables in the
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#full-level-additional-guaranteed-configurations">CameraDevice#full-level-additional-guaranteed-configurations</a>
-documentation are guaranteed to be supported.<wbr/></p>
+<p>The stream configurations listed in the <code>FULL</code>,<wbr/> <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.<wbr/></p>
<p>A <code>FULL</code> device will support below capabilities:</p>
<ul>
<li><code>BURST_<wbr/>CAPTURE</code> capability (<a href="#static_android.request.availableCapabilities">android.<wbr/>request.<wbr/>available<wbr/>Capabilities</a> contains
@@ -35458,9 +35464,9 @@
<li>
<span class="entry_type_enum_name">LEGACY (v3.2)</span>
<span class="entry_type_enum_notes"><p>This camera device is running in backward compatibility mode.<wbr/></p>
-<p>Only the stream configurations listed in the <code>LEGACY</code> table in the
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">CameraDevice#legacy-level-guaranteed-configurations</a>
-documentation are supported.<wbr/></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.<wbr/></p>
<p>A <code>LEGACY</code> device does not support per-frame control,<wbr/> manual sensor control,<wbr/> manual
post-processing,<wbr/> arbitrary cropping regions,<wbr/> and has relaxed performance constraints.<wbr/>
No additional capabilities beyond <code>BACKWARD_<wbr/>COMPATIBLE</code> will ever be listed by a
@@ -35478,9 +35484,9 @@
<span class="entry_type_enum_notes"><p>This camera device is capable of YUV reprocessing and RAW data capture,<wbr/> in addition to
FULL-level capabilities.<wbr/></p>
<p>The stream configurations listed in the <code>LEVEL_<wbr/>3</code>,<wbr/> <code>RAW</code>,<wbr/> <code>FULL</code>,<wbr/> <code>LEGACY</code> and
-<code>LIMITED</code> tables in the
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#level-3-additional-guaranteed-configurations">CameraDevice#level-3-additional-guaranteed-configurations</a>
-documentation are guaranteed to be supported.<wbr/></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.<wbr/></p>
<p>The following additional capabilities are guaranteed to be supported:</p>
<ul>
<li><code>YUV_<wbr/>REPROCESSING</code> capability (<a href="#static_android.request.availableCapabilities">android.<wbr/>request.<wbr/>available<wbr/>Capabilities</a> contains
@@ -38549,7 +38555,8 @@
<td class="entry_description">
<p>Whether this camera device can support identical set of stream combinations
involving HEIC image format,<wbr/> compared to the
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">table of combinations</a> involving JPEG image format required for the device's hardware
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">table of combinations</a>
+involving JPEG image format required for the device's hardware
level and capabilities.<wbr/></p>
</td>
@@ -38581,7 +38588,8 @@
HEIC streams at the same time is not supported.<wbr/></p>
<p>If a camera device supports HEIC format (ISO/<wbr/>IEC 23008-12),<wbr/> not only does it
support the existing mandatory stream
-<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice.html#legacy-level-guaranteed-configurations">combinations</a> required for the device's hardware level and capabilities,<wbr/> it also
+<a href="https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations">combinations</a>
+required for the device's hardware level and capabilities,<wbr/> it also
supports swapping each JPEG stream with HEIC stream in all guaranteed combinations.<wbr/></p>
<p>For every HEIC stream configured by the application,<wbr/> the camera framework sets up 2
internal streams with camera HAL:</p>
diff --git a/camera/docs/metadata_definitions.xml b/camera/docs/metadata_definitions.xml
index 533c1d2..6f89498 100644
--- a/camera/docs/metadata_definitions.xml
+++ b/camera/docs/metadata_definitions.xml
@@ -837,7 +837,7 @@
To start a CaptureSession with a target FPS range different from the
capture request template's default value, the application
is strongly recommended to call
- {@link SessionConfiguration#setSessionParameters|ACameraDevice_createCaptureSessionWithSessionParameters}
+ {@link android.hardware.camera2.params.SessionConfiguration#setSessionParameters|ACameraDevice_createCaptureSessionWithSessionParameters}
with the target fps range before creating the capture session. The aeTargetFpsRange is
typically a session parameter. Specifying it at session creation time helps avoid
session reconfiguration delays in cases like 60fps or high speed recording.
@@ -2113,7 +2113,7 @@
Surface types that can be stabilized.
The application is strongly recommended to call
- {@link SessionConfiguration#setSessionParameters|ACameraDevice_createCaptureSessionWithSessionParameters}
+ {@link android.hardware.camera2.params.SessionConfiguration#setSessionParameters|ACameraDevice_createCaptureSessionWithSessionParameters}
with the desired video stabilization mode before creating the capture session.
Video stabilization mode is a session parameter on many devices. Specifying
it at session creation time helps avoid reconfiguration delay caused by difference
@@ -6593,8 +6593,7 @@
* Profile {@link android.hardware.camera2.params.DynamicRangeProfiles#HLG10}
* All mandatory stream combinations for this specific capability as per
- documentation
- {@link android.hardware.camera2.CameraDevice#10-bit-output-additional-guaranteed-configurations}
+ [documentation](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations)
* 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
@@ -6632,8 +6631,8 @@
{@link android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES}
lists all of the supported stream use cases.
- Refer to
- {@link android.hardware.camera2.CameraDevice#stream-use-case-capability-additional-guaranteed-configurations}
+ Refer to the
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations)
for the mandatory stream combinations involving stream use cases, which can also be
queried via {@link android.hardware.camera2.params.MandatoryStreamCombination}.
</notes>
@@ -8133,7 +8132,7 @@
31.
Refer to android.request.availableCapabilities and
- {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations}
+ [the table](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations)
for additional mandatory stream configurations on a per-capability basis.
*1: For JPEG format, the sizes may be restricted by below conditions:
@@ -8446,15 +8445,14 @@
{@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}.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations).
</description>
<details>
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.
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations).
+ 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
@@ -8481,15 +8479,14 @@
<description>
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}.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#concurrent-stream-guaranteed-configurations).
</description>
<details>
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
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#concurrent-stream-guaranteed-configurations)
+ 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.
@@ -8749,7 +8746,7 @@
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}
+ [the table](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs)
for additional details.
To use multi-resolution input streams, the supported formats can be queried by {@link
@@ -8763,7 +8760,7 @@
{@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}}
+ [the table](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-additional-guaranteed-combinations-with-multiresolutionoutputs)
for details about the additional mandatory stream combinations in this case.
</details>
<hal_details>
@@ -8902,15 +8899,14 @@
{@link android.hardware.camera2.CaptureRequest} has 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}.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors).
</description>
<details>
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
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#additional-guaranteed-combinations-for-ultra-high-resolution-sensors)
+ 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
@@ -8935,15 +8931,14 @@
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}.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations).
</description>
<details>
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
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#10-bit-output-additional-guaranteed-configurations)
+ 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
@@ -8968,15 +8963,14 @@
{@code PREVIEW_STABILIZATION} in 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}.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#preview-stabilization-guaranteed-stream-configurations).
</description>
<details>
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}
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#preview-stabilization-guaranteed-stream-configurations)
+ 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
@@ -9208,9 +9202,8 @@
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.
+ [guideline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations).
+ 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
@@ -9234,15 +9227,15 @@
<description>
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.
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations)
+ with each stream's use case being set.
</description>
<details>
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
+ [guildeline](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#stream-use-case-capability-additional-guaranteed-configurations)
+ 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
@@ -12461,9 +12454,9 @@
This camera device does not have enough capabilities to qualify as a `FULL` device or
better.
- Only the stream configurations listed in the `LEGACY` and `LIMITED` tables in the
- {@link android.hardware.camera2.CameraDevice#limited-level-additional-guaranteed-configurations|ACameraDevice_createCaptureSession}
- documentation are guaranteed to be supported.
+ Only the stream configurations listed in the `LEGACY` and `LIMITED`
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#limited-level-additional-guaranteed-configurations)
+ in the documentation are guaranteed to be supported.
All `LIMITED` devices support the `BACKWARDS_COMPATIBLE` capability, indicating basic
support for color image capture. The only exception is that the device may
@@ -12488,9 +12481,9 @@
<notes>
This camera device is capable of supporting advanced imaging applications.
- The stream configurations listed in the `FULL`, `LEGACY` and `LIMITED` tables in the
- {@link android.hardware.camera2.CameraDevice#full-level-additional-guaranteed-configurations|ACameraDevice_createCaptureSession}
- documentation are guaranteed to be supported.
+ The stream configurations listed in the `FULL`, `LEGACY` and `LIMITED`
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#full-level-additional-guaranteed-configurations)
+ in the documentation are guaranteed to be supported.
A `FULL` device will support below capabilities:
@@ -12514,9 +12507,9 @@
<notes>
This camera device is running in backward compatibility mode.
- Only the stream configurations listed in the `LEGACY` table in the
- {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations|ACameraDevice_createCaptureSession}
- documentation are supported.
+ Only the stream configurations listed in the `LEGACY`
+ [table](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations)
+ in the documentation are supported.
A `LEGACY` device does not support per-frame control, manual sensor control, manual
post-processing, arbitrary cropping regions, and has relaxed performance constraints.
@@ -12541,9 +12534,9 @@
FULL-level capabilities.
The stream configurations listed in the `LEVEL_3`, `RAW`, `FULL`, `LEGACY` and
- `LIMITED` tables in the
- {@link android.hardware.camera2.CameraDevice#level-3-additional-guaranteed-configurations|ACameraDevice_createCaptureSession}
- documentation are guaranteed to be supported.
+ `LIMITED`
+ [tables](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#level-3-additional-guaranteed-configurations)
+ in the documentation are guaranteed to be supported.
The following additional capabilities are guaranteed to be supported:
@@ -13650,8 +13643,8 @@
</enum>
<description>Whether this camera device can support identical set of stream combinations
involving HEIC image format, compared to the
- {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations
- table of combinations} involving JPEG image format required for the device's hardware
+ [table of combinations](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations)
+ involving JPEG image format required for the device's hardware
level and capabilities.
</description>
<details>
@@ -13662,8 +13655,8 @@
If a camera device supports HEIC format (ISO/IEC 23008-12), not only does it
support the existing mandatory stream
- {@link android.hardware.camera2.CameraDevice#legacy-level-guaranteed-configurations
- combinations} required for the device's hardware level and capabilities, it also
+ [combinations](https://developer.android.com/reference/android/hardware/camera2/CameraDevice#legacy-level-guaranteed-configurations)
+ required for the device's hardware level and capabilities, it also
supports swapping each JPEG stream with HEIC stream in all guaranteed combinations.
For every HEIC stream configured by the application, the camera framework sets up 2