Docs: Changes to source.android.com

  - 197600621 Devsite localized content from translation request 873033... by Android Partner Docs <noreply@android.com>
  - 197596066 Update Support Library -> AndroidX (Support Library) by Christina Nguyen <cqn@google.com>
  - 197586819 HIDL: clarify documentation about documentation comments by Android Partner Docs <noreply@android.com>
  - 197579595 Devsite localized content from translation request 415584... by Android Partner Docs <noreply@android.com>
  - 197576890 Publish April and May Security/ Pixel bulletins by Danielle Roberts <daroberts@google.com>
  - 197559095 Update camera doc content by Kenneth Lau <kennethlau@google.com>
  - 197559031 Revise content to refer to HIDL interface by Kenneth Lau <kennethlau@google.com>
  - 197558968 Update camera images by Kenneth Lau <kennethlau@google.com>
  - 197492822 Devsite localized content from translation request 3347f0... by Android Partner Docs <noreply@android.com>
  - 197423991 Devsite localized content from translation request 35d612... by Android Partner Docs <noreply@android.com>
  - 197423968 Devsite localized content from translation request 845f73... by Android Partner Docs <noreply@android.com>
  - 197423953 Devsite localized content from translation request 415584... by Android Partner Docs <noreply@android.com>
  - 197423874 Devsite localized content from translation request 0a49fc... by Android Partner Docs <noreply@android.com>
  - 197423857 Devsite localized content from translation request c007e9... by Android Partner Docs <noreply@android.com>
  - 197423850 Devsite localized content from translation request 99ab33... by Android Partner Docs <noreply@android.com>
  - 197198470 Added CVE-2017-0740 to the Acknowledgements page. by Android Partner Docs <noreply@android.com>
  - 197180447 Replace KMSG with ramoops by Clay Murphy <claym@google.com>
  - 197056364 Improve readability of content by Kenneth Lau <kennethlau@google.com>
  - 197029559 Devsite localized content from translation request e1b1c4... by Android Partner Docs <noreply@android.com>
  - 197029538 Devsite localized content from translation request 697929... by Android Partner Docs <noreply@android.com>
  - 196891796 Add Nokia to the bulletin index page by Danielle Roberts <daroberts@google.com>
  - 196847852 Update CTS/CTS-Verifier downloads for CTS-May-2018 Releases by Android Partner Docs <noreply@android.com>
  - 196763369 Fix silly image path error by Clay Murphy <claym@google.com>
  - 196737640 Add blogs list to community page by Danielle Roberts <daroberts@google.com>
  - 196728891 Remove all non-test _freeze.yaml files. These are no long... by Android Partner Docs <noreply@android.com>
  - 196702405 Add initial bootloader docs by Clay Murphy <claym@google.com>
  - 196680338 Devsite localized content from translation request 54cf9d... by Android Partner Docs <noreply@android.com>

PiperOrigin-RevId: 197600621
Change-Id: Ie86e9b753b488ba9af0f78fd6fcc577425ab3b94

1 files changed, 43 insertions, 47 deletions

diff --git a/en/devices/camera/camera3.html b/en/devices/camera/camera3.html
index 7115722e..bb2e6833 100644
--- a/en/devices/camera/camera3.html
+++ b/en/devices/camera/camera3.html
@@ -22,57 +22,18 @@
   -->
 
 
-
 <p>
 Android's camera Hardware Abstraction Layer (HAL) connects the higher level
 camera framework APIs in
-<a href="http://developer.android.com/reference/android/hardware/Camera.html">android.hardware.Camera</a>
-to your underlying camera driver and hardware. Android 5.0 introduced a new,
-underlying implementation of the camera stack. If you have previously developed
-a camera HAL module and driver for older versions of Android, be aware of
-significant changes in the camera pipeline.</p>
-
-<p class="note"><strong>Note:</strong> The new camera HAL is in active
-development and can change at any time. This document describes the high-level
-design of the camera subsystem; for details, see
-<a href="/devices/camera/versioning.html">Camera Version Support</a>.</p>
-
-<h2 id="overview">Camera HAL1 overview</h2>
-
-<p>Version 1 of the camera subsystem was designed as a black box with high-level
-controls and the following three operating modes:</p>
-
-<ul>
-<li>Preview</li>
-<li>Video Record</li>
-<li>Still Capture</li>
-</ul>
-
-<p>Each mode has slightly different and overlapping capabilities. This made it
-hard to implement new types of features, such as burst mode, since it would fall
-between two of these modes.</p>
-
-<img src="images/camera_block.png" alt="Camera block diagram" id="figure1" />
-<p class="img-caption"><strong>Figure 1.</strong> Camera components</p>
-
-<p>Android 7.0 continues to support camera HAL1 as many devices still rely on
-it. In addition, the Android camera service supports implementing both HALs (1
-and 3), which is useful when you want to support a less-capable front-facing
-camera with camera HAL1 and a more advanced back-facing camera with camera
-HAL3.</p>
-
-<p class="note"><strong>Note:</strong> Camera HAL2 is not supported as it was a
-temporary step on the way to camera HAL3.</p>
-
-<p>There is a single camera HAL <em>module</em> (with its own
-<a href="/devices/camera/versioning.html#module_version">version
-number</a>), which lists multiple independent camera devices that each have
-their own version number. Camera module 2 or newer is required to support
-devices 2 or newer, and such camera modules can have a mix of camera device
-versions (this is what we mean when we say Android supports implementing both
-HALs).</p>
+<a href="https://developer.android.com/reference/android/hardware/camera2/package-summary">android.hardware.camera2</a>
+to your underlying camera driver and hardware. Android 8.0 introduced
+<a href="/devices/architecture/treble">Treble</a>, switching the CameraHal API
+to a stable interface defined by the HAL Interface Description Language (HIDL).
+If you have previously developed a camera
+HAL module and driver for older versions of Android, be aware of significant
+changes in the camera pipeline.</p>
 
-<h2 id="v3-enhance">Camera HAL3 enhancements</h2>
+<h2 id="v3-enhance">Camera HAL3 features</h2>
 
 <p>The aim of the Android Camera API redesign is to substantially increase the
 ability of applications to control the camera subsystem on Android devices while
@@ -125,5 +86,40 @@ have priority over repeating requests.</p>
 <img src="images/camera_simple_model.png" alt="Camera data model" id="figure2" />
 <p class="img-caption"><strong>Figure 2.</strong> Camera core operation model</p>
 
+<h2 id="overview">Camera HAL1 overview</h2>
+
+<aside class="note"><strong>Note:</strong> Camera HAL1 has been deprecated. New
+devices should use Camera HAL3.</aside>
+
+<p>Version 1 of the camera subsystem was designed as a black box with high-level
+controls and the following three operating modes:</p>
+
+<ul>
+<li>Preview</li>
+<li>Video Record</li>
+<li>Still Capture</li>
+</ul>
+
+<p>Each mode has slightly different and overlapping capabilities. This made it
+hard to implement new features such as burst mode, which falls between two of
+the operating modes.</p>
+
+<img src="images/camera_block.png" alt="Camera block diagram" id="figure1" />
+<p class="img-caption"><strong>Figure 1.</strong> Camera components</p>
+
+<p>Android 7.0 continues to support camera HAL1 as many devices still rely on
+it. In addition, the Android camera service supports implementing both HALs (1
+and 3), which is useful when you want to support a less-capable front-facing
+camera with camera HAL1 and a more advanced back-facing camera with camera
+HAL3.</p>
+
+<p>There is a single camera HAL <em>module</em> (with its own
+<a href="/devices/camera/versioning.html#module_version">version
+number</a>), which lists multiple independent camera devices that each have
+their own version number. Camera module 2 or newer is required to support
+devices 2 or newer, and such camera modules can have a mix of camera device
+versions (this is what we mean when we say Android supports implementing both
+HALs).</p>
+
   </body>
 </html>