From 8632d7ebda028d8a229c31c2683d6e5e4a2ca0b7 Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Tue, 8 Aug 2023 16:26:39 -0700
Subject: [PATCH 01/22] Camera2Video: Fix MediaRecorder issues.

MediaRecorder recordings were sideways in portrait orientation, and
would not correctly record the HardwarePipeline. The former was due to
the lack of an orientation hint to MediaRecorder and an incorrectly
sized Surface. The latter was due to the presentation time being set,
which is incompatible with MediaRecorder.

Passing the Surface to a temporary MediaRecorder will set its size
correctly, and passing an orientation hint will rotate the output video.
Removing presentation time will ensure that frames' presentation time
in the output video start at zero and increment by 1/FPS seconds for
each frame. onReady would also be signaled at the beginning of recording
for the software path, which has been replaced by onClose.

Change-Id: Ib6d578a408413440c2071245944fc161db783cd3
---
 .../android/camera2/video/EncoderWrapper.kt   | 75 +++++++++++--------
 .../android/camera2/video/HardwarePipeline.kt |  2 -
 .../video/fragments/PreviewFragment.kt        | 14 ++--
 3 files changed, 53 insertions(+), 38 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
index 418beef5..d973d62d 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
@@ -50,8 +50,13 @@ class EncoderWrapper(width: Int,
         val IFRAME_INTERVAL = 1 // sync one frame every second
     }
 
+    private val mWidth = width
+    private val mHeight = height
+    private val mBitRate = bitRate
+    private val mFrameRate = frameRate
+    private val mDynamicRange = dynamicRange
     private val mOrientationHint = orientationHint
-
+    private val mOutputFile = outputFile
     private val mUseMediaRecorder = useMediaRecorder
 
     private val mMimeType = when {
@@ -79,17 +84,48 @@ class EncoderWrapper(width: Int,
     private val mInputSurface: Surface by lazy {
         if (useMediaRecorder) {
             // Get a persistent Surface from MediaCodec, don't forget to release when done
-            MediaCodec.createPersistentInputSurface()
+            val surface = MediaCodec.createPersistentInputSurface()
+
+            // Prepare and release a dummy MediaRecorder with our new surface
+            // Required to allocate an appropriately sized buffer before passing the Surface as the
+            //  output target to the capture session
+            createRecorder(surface).apply {
+                prepare()
+                release()
+            }
+
+            surface
         } else {
             mEncoder!!.createInputSurface()
         }
     }
 
-    private val mMediaRecorder: MediaRecorder? by lazy {
-        if (useMediaRecorder) {
-            MediaRecorder()
-        } else {
-            null
+    private var mMediaRecorder: MediaRecorder? = null
+
+    private fun createRecorder(surface: Surface): MediaRecorder {
+        return MediaRecorder().apply {
+            setAudioSource(MediaRecorder.AudioSource.MIC)
+            setVideoSource(MediaRecorder.VideoSource.SURFACE)
+            setOutputFormat(MediaRecorder.OutputFormat.MPEG_4)
+            setOutputFile(mOutputFile.absolutePath)
+            setVideoEncodingBitRate(mBitRate)
+            if (mFrameRate > 0) setVideoFrameRate(mFrameRate)
+            setVideoSize(mWidth, mHeight)
+
+            val videoEncoder = when {
+                mDynamicRange == DynamicRangeProfiles.STANDARD ->
+                        MediaRecorder.VideoEncoder.H264
+                mDynamicRange < DynamicRangeProfiles.PUBLIC_MAX ->
+                        MediaRecorder.VideoEncoder.HEVC
+                else -> throw IllegalArgumentException("Unknown dynamic range format")
+            }
+
+            setVideoEncoder(videoEncoder)
+            setAudioEncoder(MediaRecorder.AudioEncoder.AAC)
+            setAudioEncodingBitRate(16)
+            setAudioSamplingRate(44100)
+            setInputSurface(surface)
+            setOrientationHint(mOrientationHint)
         }
     }
 
@@ -98,30 +134,7 @@ class EncoderWrapper(width: Int,
      */
     init {
         if (useMediaRecorder) {
-            mMediaRecorder!!.apply {
-                Log.i(TAG, "useMediaRecorder");
-                setAudioSource(MediaRecorder.AudioSource.MIC)
-                setVideoSource(MediaRecorder.VideoSource.SURFACE)
-                setOutputFormat(MediaRecorder.OutputFormat.MPEG_4)
-                setOutputFile(outputFile.absolutePath)
-                setVideoEncodingBitRate(bitRate)
-                if (frameRate > 0) setVideoFrameRate(frameRate)
-                setVideoSize(width, height)
-
-                val videoEncoder = when {
-                    dynamicRange == DynamicRangeProfiles.STANDARD ->
-                            MediaRecorder.VideoEncoder.H264
-                    dynamicRange < DynamicRangeProfiles.PUBLIC_MAX ->
-                            MediaRecorder.VideoEncoder.HEVC
-                    else -> throw IllegalArgumentException("Unknown dynamic range format")
-                }
-
-                setVideoEncoder(videoEncoder)
-                setAudioEncoder(MediaRecorder.AudioEncoder.AAC)
-                setAudioEncodingBitRate(16)
-                setAudioSamplingRate(44100)
-                setInputSurface(mInputSurface)
-            }
+            mMediaRecorder = createRecorder(mInputSurface)
         } else {
             val codecProfile = when {
                 dynamicRange == DynamicRangeProfiles.HLG10 ->
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index 5169630b..d4f24e20 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -948,8 +948,6 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
 
             encoder.frameAvailable()
 
-            EGLExt.eglPresentationTimeANDROID(eglDisplay, eglEncoderSurface,
-                    cameraTexture.getTimestamp())
             EGL14.eglSwapBuffers(eglDisplay, eglEncoderSurface)
         }
 
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index aa7f9dcd..4957db9b 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -287,7 +287,8 @@ class PreviewFragment : Fragment() {
         val previewTargets = pipeline.getPreviewTargets()
 
         // Start a capture session using our open camera and list of Surfaces where frames will go
-        session = createCaptureSession(camera, previewTargets, cameraHandler)
+        session = createCaptureSession(camera, previewTargets, cameraHandler,
+                recordingCompleteOnClose = (pipeline !is SoftwarePipeline))
 
         // Sends the capture request as frequently as possible until the session is torn down or
         //  session.stopRepeating() is called
@@ -323,7 +324,8 @@ class PreviewFragment : Fragment() {
                             val recordTargets = pipeline.getRecordTargets()
 
                             session.close()
-                            session = createCaptureSession(camera, recordTargets, cameraHandler)
+                            session = createCaptureSession(camera, recordTargets, cameraHandler,
+                                    recordingCompleteOnClose = true)
 
                             session.setRepeatingRequest(recordRequest,
                                     object : CameraCaptureSession.CaptureCallback() {
@@ -352,6 +354,7 @@ class PreviewFragment : Fragment() {
                     encoder.waitForFirstFrame()
 
                     session.stopRepeating()
+                    session.close()
 
                     pipeline.clearFrameListener()
                     fragmentBinding.captureButton.setOnTouchListener(null)
@@ -464,7 +467,8 @@ class PreviewFragment : Fragment() {
     private suspend fun createCaptureSession(
             device: CameraDevice,
             targets: List<Surface>,
-            handler: Handler
+            handler: Handler,
+            recordingCompleteOnClose: Boolean
     ): CameraCaptureSession = suspendCoroutine { cont ->
         val stateCallback = object: CameraCaptureSession.StateCallback() {
             override fun onConfigured(session: CameraCaptureSession) = cont.resume(session)
@@ -476,8 +480,8 @@ class PreviewFragment : Fragment() {
             }
 
             /** Called after all captures have completed - shut down the encoder */
-            override fun onReady(session: CameraCaptureSession) {
-                if (!isCurrentlyRecording()) {
+            override fun onClosed(session: CameraCaptureSession) {
+                if (!recordingCompleteOnClose or !isCurrentlyRecording()) {
                     return
                 }
 

From 9f7b654af1c36fe296845000331a1f7cac922bd6 Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Tue, 26 Sep 2023 16:54:53 -0700
Subject: [PATCH 02/22] Add support for color space selection.

On devices that support ColorSpaceProfiles and DynamicRangeProfiles, a new fragment for selecting the color space will appear allowing the user to select P3 for capture.

Change-Id: Ice8e9529fb982585985667299e1c92650ba2e451
---
 Camera2Video/app/build.gradle                 |   8 +-
 Camera2Video/app/src/main/AndroidManifest.xml |   4 +-
 .../video/fragments/ColorSpaceFragment.kt     | 151 ++++++++++++++++++
 .../video/fragments/DynamicRangeFragment.kt   |  29 +++-
 .../video/fragments/EncodeApiFragment.kt      |   2 +-
 .../camera2/video/fragments/FilterFragment.kt |   6 +-
 .../video/fragments/PreviewFragment.kt        |   9 +-
 .../fragments/PreviewStabilizationFragment.kt |   4 +-
 .../video/fragments/RecordModeFragment.kt     |   9 +-
 .../video/fragments/SelectorFragment.kt       |  22 ++-
 .../video/fragments/TransferFragment.kt       |   2 +-
 .../app/src/main/res/navigation/nav_graph.xml |  73 ++++++++-
 12 files changed, 290 insertions(+), 29 deletions(-)
 create mode 100644 Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/ColorSpaceFragment.kt

diff --git a/Camera2Video/app/build.gradle b/Camera2Video/app/build.gradle
index f48b4583..163c662b 100644
--- a/Camera2Video/app/build.gradle
+++ b/Camera2Video/app/build.gradle
@@ -1,5 +1,5 @@
 /*
- * Copyright 2020 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,12 +20,12 @@ apply plugin: 'kotlin-kapt'
 apply plugin: "androidx.navigation.safeargs"
 
 android {
-    compileSdkVersion 33
+    compileSdkVersion 34
     defaultConfig {
         testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
         applicationId "com.android.example.camera2.video"
-        minSdkVersion 23
-        targetSdkVersion 33
+        minSdkVersion 26
+        targetSdkVersion 34
         versionCode 1
         versionName "1.0.0"
     }
diff --git a/Camera2Video/app/src/main/AndroidManifest.xml b/Camera2Video/app/src/main/AndroidManifest.xml
index db50613a..c9e30d9f 100644
--- a/Camera2Video/app/src/main/AndroidManifest.xml
+++ b/Camera2Video/app/src/main/AndroidManifest.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
-  ~ Copyright 2020 The Android Open Source Project
+  ~ Copyright 2023 The Android Open Source Project
   ~
   ~ Licensed under the Apache License, Version 2.0 (the "License");
   ~ you may not use this file except in compliance with the License.
@@ -31,7 +31,7 @@
         android:icon="@drawable/ic_launcher"
         android:exported="false"
         android:debuggable="true"
-        tools:ignore="AllowBackup,GoogleAppIndexingWarning">
+        tools:ignore="AllowBackup,GoogleAppIndexingWarning,HardcodedDebugMode">
 
         <activity
             android:name="com.example.android.camera2.video.CameraActivity"
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/ColorSpaceFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/ColorSpaceFragment.kt
new file mode 100644
index 00000000..9d03fc60
--- /dev/null
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/ColorSpaceFragment.kt
@@ -0,0 +1,151 @@
+/*
+ * Copyright 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera2.video.fragments
+
+import android.annotation.SuppressLint
+import android.content.Context
+import android.graphics.ColorSpace
+import android.graphics.ImageFormat
+import android.hardware.camera2.CameraCharacteristics
+import android.hardware.camera2.CameraManager
+import android.hardware.camera2.CameraMetadata
+import android.hardware.camera2.params.ColorSpaceProfiles
+import android.hardware.camera2.params.DynamicRangeProfiles
+import android.os.Bundle
+import android.util.Size
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import androidx.fragment.app.Fragment
+import androidx.navigation.Navigation
+import androidx.navigation.fragment.navArgs
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import com.example.android.camera.utils.GenericListAdapter
+import com.example.android.camera2.video.R
+
+/**
+ * In this [Fragment] we let users pick a color space profile for the camera.
+ */
+class ColorSpaceFragment : Fragment() {
+
+    private val args: ColorSpaceFragmentArgs by navArgs()
+
+    override fun onCreateView(
+            inflater: LayoutInflater,
+            container: ViewGroup?,
+            savedInstanceState: Bundle?
+    ): View? = RecyclerView(requireContext())
+
+    @SuppressLint("MissingPermission")
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+        view as RecyclerView
+        view.apply {
+            layoutManager = LinearLayoutManager(requireContext())
+
+            val cameraManager =
+                    requireContext().getSystemService(Context.CAMERA_SERVICE) as CameraManager
+
+            val colorSpaceList = enumerateColorSpaces(cameraManager, args.cameraId,
+                    args.dynamicRange)
+
+            val layoutId = android.R.layout.simple_list_item_1
+            adapter = GenericListAdapter(colorSpaceList, itemLayoutId = layoutId) {
+                    view, item, _ ->
+                view.findViewById<TextView>(android.R.id.text1).text = item.name
+                view.setOnClickListener {
+                    navigate(item.value, cameraManager)
+                }
+            }
+        }
+    }
+
+    private fun navigate(colorSpace: ColorSpace.Named, cameraManager: CameraManager) {
+        val navController =
+            Navigation.findNavController(requireActivity(), R.id.fragment_container)
+
+        if (supportsPreviewStabilization(cameraManager)) {
+            navController.navigate(
+                    ColorSpaceFragmentDirections.actionColorSpaceToPreviewStabilization(
+                            args.cameraId, args.width, args.height, args.fps, args.dynamicRange,
+                            colorSpace.ordinal))
+        } else if (args.dynamicRange == DynamicRangeProfiles.STANDARD) {
+            navController.navigate(
+                    ColorSpaceFragmentDirections.actionColorSpaceToEncodeApi(
+                            args.cameraId, args.width, args.height, args.fps, args.dynamicRange,
+                            colorSpace.ordinal, false))
+        }
+    }
+
+    private fun supportsPreviewStabilization(cameraManager: CameraManager) : Boolean {
+        val characteristics = cameraManager.getCameraCharacteristics(args.cameraId)
+        val previewStabilizationModes = characteristics.get(
+            CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES)!!
+        return previewStabilizationModes.contains(
+                CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION)
+    }
+
+    companion object {
+
+        private data class ColorSpaceInfo(
+                val name: String,
+                val value: ColorSpace.Named)
+
+        @SuppressLint("NewApi")
+        private fun colorSpaceString(value: ColorSpace.Named) = when (value) {
+            ColorSpace.Named.ACES -> "ACES"
+            ColorSpace.Named.ACESCG -> "ACESCG"
+            ColorSpace.Named.ADOBE_RGB -> "ADOBE_RGB"
+            ColorSpace.Named.BT2020 -> "BT2020"
+            ColorSpace.Named.BT2020_HLG -> "BT2020_HLG"
+            ColorSpace.Named.BT2020_PQ -> "BT2020_PQ"
+            ColorSpace.Named.BT709 -> "BT709"
+            ColorSpace.Named.CIE_LAB -> "CIE_LAB"
+            ColorSpace.Named.CIE_XYZ -> "CIE_XYZ"
+            ColorSpace.Named.DCI_P3 -> "DCI_P3"
+            ColorSpace.Named.DISPLAY_P3 -> "DISPLAY_P3"
+            ColorSpace.Named.EXTENDED_SRGB -> "EXTENDED_SRGB"
+            ColorSpace.Named.LINEAR_EXTENDED_SRGB -> "LINEAR_EXTENDED_SRGB"
+            ColorSpace.Named.LINEAR_SRGB -> "LINEAR_SRGB"
+            ColorSpace.Named.NTSC_1953 -> "NTSC_1953"
+            ColorSpace.Named.PRO_PHOTO_RGB -> "PRO_PHOTO_RGB"
+            ColorSpace.Named.SMPTE_C -> "SMPTE_C"
+            ColorSpace.Named.SRGB -> "SRGB"
+            else -> "UNKNOWN"
+        }
+
+        @SuppressLint("InlinedApi")
+        private fun enumerateColorSpaces(cameraManager: CameraManager,
+                                         cameraId: String,
+                                         dynamicRange: Long): List<ColorSpaceInfo> {
+            val colorSpaceList: MutableList<ColorSpaceInfo> = mutableListOf()
+
+            val characteristics = cameraManager.getCameraCharacteristics(cameraId)
+            val colorSpaceProfiles = characteristics.get(
+                    CameraCharacteristics.REQUEST_AVAILABLE_COLOR_SPACE_PROFILES)!!
+            colorSpaceProfiles.getSupportedColorSpacesForDynamicRange(ImageFormat.UNKNOWN,
+                    dynamicRange).forEach { colorSpace ->
+                val colorSpaceName = colorSpaceString(colorSpace)
+                colorSpaceList.add(ColorSpaceInfo(colorSpaceName, colorSpace))
+            }
+
+            return colorSpaceList
+        }
+    }
+}
\ No newline at end of file
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/DynamicRangeFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/DynamicRangeFragment.kt
index cb29260d..a4926261 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/DynamicRangeFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/DynamicRangeFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2022 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ import android.content.Context
 import android.hardware.camera2.CameraCharacteristics
 import android.hardware.camera2.CameraManager
 import android.hardware.camera2.CameraMetadata
+import android.hardware.camera2.params.ColorSpaceProfiles
 import android.hardware.camera2.params.DynamicRangeProfiles
 import android.os.Bundle
 import android.util.Size
@@ -76,20 +77,36 @@ class DynamicRangeFragment : Fragment() {
         val navController =
             Navigation.findNavController(requireActivity(), R.id.fragment_container)
 
-        if (supportsPreviewStabilization(cameraManager)) {
+        val characteristics = cameraManager.getCameraCharacteristics(args.cameraId)
+
+        if (supportsColorSpaces(characteristics)) {
             navController.navigate(
-                    DynamicRangeFragmentDirections.actionDynamicRangeToPreviewStabilization(
+                    DynamicRangeFragmentDirections.actionDynamicRangeToColorSpace(
                             args.cameraId, args.width, args.height, args.fps, dynamicRangeProfile))
+        } else if (supportsPreviewStabilization(characteristics)) {
+            navController.navigate(
+                    DynamicRangeFragmentDirections.actionDynamicRangeToPreviewStabilization(
+                            args.cameraId, args.width, args.height, args.fps, dynamicRangeProfile,
+                            ColorSpaceProfiles.UNSPECIFIED))
         } else {
             navController.navigate(
                     DynamicRangeFragmentDirections.actionDynamicRangeToEncodeApi(
                             args.cameraId, args.width, args.height, args.fps, dynamicRangeProfile,
-                            false))
+                            ColorSpaceProfiles.UNSPECIFIED, false))
         }
     }
 
-    private fun supportsPreviewStabilization(cameraManager: CameraManager) : Boolean {
-        val characteristics = cameraManager.getCameraCharacteristics(args.cameraId)
+    private fun supportsColorSpaces(characteristics: CameraCharacteristics): Boolean {
+        if (android.os.Build.VERSION.SDK_INT >=
+                    android.os.Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            val colorSpaceProfiles = characteristics.get(
+                CameraCharacteristics.REQUEST_AVAILABLE_COLOR_SPACE_PROFILES)
+            return colorSpaceProfiles != null
+        }
+        return false
+    }
+
+    private fun supportsPreviewStabilization(characteristics: CameraCharacteristics) : Boolean {
         val previewStabilizationModes = characteristics.get(
             CameraCharacteristics.CONTROL_AVAILABLE_VIDEO_STABILIZATION_MODES)!!
         return previewStabilizationModes.contains(
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
index 20139bab..9571a476 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
@@ -70,7 +70,7 @@ class EncodeApiFragment : Fragment() {
         navController.navigate(
                 EncodeApiFragmentDirections.actionEncodeApiToRecordMode(
                 args.cameraId, args.width, args.height, args.fps,
-                args.dynamicRange, args.previewStabilization, useMediaRecorder))
+                args.dynamicRange, args.colorSpace, args.previewStabilization, useMediaRecorder))
     }
 
     companion object {
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
index 918f183f..0a45f4f3 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2022 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -65,13 +65,13 @@ class FilterFragment : Fragment() {
                         navController.navigate(
                             FilterFragmentDirections.actionFilterToPreview(
                             args.cameraId, args.width, args.height, args.fps,
-                            args.dynamicRange, args.previewStabilization,
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
                             args.useMediaRecorder, item.value, true, 0))
                     } else {
                         navController.navigate(
                             FilterFragmentDirections.actionFilterToTransfer(
                             args.cameraId, args.width, args.height, args.fps,
-                            args.dynamicRange, args.previewStabilization,
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
                             args.useMediaRecorder, item.value))
                     }
                 }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index 4957db9b..4e97380b 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2020 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ import android.content.Context
 import android.content.Intent
 import android.content.pm.ActivityInfo
 import android.graphics.Color
+import android.graphics.ColorSpace
 import android.hardware.camera2.CameraCaptureSession
 import android.hardware.camera2.CameraCharacteristics
 import android.hardware.camera2.CameraDevice
@@ -28,6 +29,7 @@ import android.hardware.camera2.CameraManager
 import android.hardware.camera2.CameraMetadata
 import android.hardware.camera2.CaptureRequest
 import android.hardware.camera2.TotalCaptureResult
+import android.hardware.camera2.params.ColorSpaceProfiles
 import android.hardware.camera2.params.DynamicRangeProfiles
 import android.hardware.camera2.params.OutputConfiguration
 import android.hardware.camera2.params.SessionConfiguration
@@ -452,6 +454,11 @@ class PreviewFragment : Fragment() {
 
             val sessionConfig = SessionConfiguration(SessionConfiguration.SESSION_REGULAR,
                     outputConfigs, HandlerExecutor(handler), stateCallback)
+            if (android.os.Build.VERSION.SDK_INT >=
+                    android.os.Build.VERSION_CODES.UPSIDE_DOWN_CAKE
+                    && args.colorSpace != ColorSpaceProfiles.UNSPECIFIED) {
+                sessionConfig.setColorSpace(ColorSpace.Named.values()[args.colorSpace])
+            }
             device.createCaptureSession(sessionConfig)
             return true
         } else {
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewStabilizationFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewStabilizationFragment.kt
index 9131c7d9..07a07e44 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewStabilizationFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewStabilizationFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2022 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -70,7 +70,7 @@ class PreviewStabilizationFragment : Fragment() {
         navController.navigate(
                 PreviewStabilizationFragmentDirections.actionPreviewStabilizationToEncodeApi(
                 args.cameraId, args.width, args.height, args.fps,
-                args.dynamicRange, stabilizationOn))
+                args.dynamicRange, args.colorSpace, stabilizationOn))
     }
 
     companion object {
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
index ac4e8d62..e5694d03 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2022 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -66,13 +66,14 @@ class RecordModeFragment : Fragment() {
                         navController.navigate(
                             RecordModeFragmentDirections.actionRecordModeToFilter(
                             args.cameraId, args.width, args.height, args.fps,
-                            args.dynamicRange, args.previewStabilization, args.useMediaRecorder))
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
+                            args.useMediaRecorder))
                     } else {
                         navController.navigate(
                             RecordModeFragmentDirections.actionRecordModeToPreview(
                             args.cameraId, args.width, args.height, args.fps,
-                            args.dynamicRange, args.previewStabilization, args.useMediaRecorder,
-                            false, false, 0))
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
+                            args.useMediaRecorder, false, false, 0))
                     }
                 }
             }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/SelectorFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/SelectorFragment.kt
index 7bfa9d31..f4048987 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/SelectorFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/SelectorFragment.kt
@@ -1,5 +1,5 @@
 /*
- * Copyright 2020 The Android Open Source Project
+ * Copyright 2023 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,6 +21,7 @@ import android.content.Context
 import android.hardware.camera2.CameraCharacteristics
 import android.hardware.camera2.CameraManager
 import android.hardware.camera2.CameraMetadata
+import android.hardware.camera2.params.ColorSpaceProfiles
 import android.hardware.camera2.params.DynamicRangeProfiles
 import android.media.MediaRecorder
 import android.os.Bundle
@@ -65,13 +66,14 @@ class SelectorFragment : Fragment() {
                 view.findViewById<TextView>(android.R.id.text1).text = item.name
                 view.setOnClickListener {
                     var dynamicRangeProfiles: DynamicRangeProfiles? = null
+                    var colorSpaceProfiles: ColorSpaceProfiles? = null
                     var supportsPreviewStabilization = false
+                    val characteristics = cameraManager.getCameraCharacteristics(item.cameraId)
 
                     // DynamicRangeProfiles is introduced in android Tiramisu. If the SDK residing on
                     // our device is older, do not call the non-existant paths.
                     if (android.os.Build.VERSION.SDK_INT >=
                             android.os.Build.VERSION_CODES.TIRAMISU) {
-                        val characteristics = cameraManager.getCameraCharacteristics(item.cameraId)
                         val capabilities = characteristics.get(
                                 CameraCharacteristics.REQUEST_AVAILABLE_CAPABILITIES)!!
                         if (capabilities.contains(CameraCharacteristics
@@ -86,6 +88,12 @@ class SelectorFragment : Fragment() {
                                 CameraMetadata.CONTROL_VIDEO_STABILIZATION_MODE_PREVIEW_STABILIZATION)
                     }
 
+                    if (android.os.Build.VERSION.SDK_INT >=
+                                android.os.Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+                        colorSpaceProfiles = characteristics.get(
+                            CameraCharacteristics.REQUEST_AVAILABLE_COLOR_SPACE_PROFILES)
+                    }
+
                     val navController =
                         Navigation.findNavController(requireActivity(), R.id.fragment_container)
 
@@ -95,16 +103,22 @@ class SelectorFragment : Fragment() {
                         navController.navigate(
                             SelectorFragmentDirections.actionSelectorToDynamicRange(
                             item.cameraId, item.size.width, item.size.height, item.fps))
+                    } else if (colorSpaceProfiles != null) {
+                        navController.navigate(
+                            SelectorFragmentDirections.actionSelectorToColorSpace(
+                                item.cameraId, item.size.width, item.size.height, item.fps,
+                                DynamicRangeProfiles.STANDARD))
                     } else if (supportsPreviewStabilization) {
                         navController.navigate(
                             SelectorFragmentDirections.actionSelectorToPreviewStabilization(
                             item.cameraId, item.size.width, item.size.height, item.fps,
-                            DynamicRangeProfiles.STANDARD))
+                            DynamicRangeProfiles.STANDARD, ColorSpaceProfiles.UNSPECIFIED))
                     } else {
                         navController.navigate(
                             SelectorFragmentDirections.actionSelectorToEncodeApi(
                             item.cameraId, item.size.width, item.size.height, item.fps,
-                            DynamicRangeProfiles.STANDARD, /*previewStabilization*/ false))
+                            DynamicRangeProfiles.STANDARD, ColorSpaceProfiles.UNSPECIFIED,
+                            /*previewStabilization*/ false))
                     }
                 }
             }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
index cabf1fb1..440aa8da 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
@@ -62,7 +62,7 @@ class TransferFragment : Fragment() {
                         Navigation.findNavController(requireActivity(), R.id.fragment_container)
                     val direction = TransferFragmentDirections.actionTransferToPreview(
                             args.cameraId, args.width, args.height, args.fps,
-                            args.dynamicRange, args.previewStabilization,
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
                             args.useMediaRecorder, args.filterOn, true, item.id)
                     navController.navigate(direction)
                 }
diff --git a/Camera2Video/app/src/main/res/navigation/nav_graph.xml b/Camera2Video/app/src/main/res/navigation/nav_graph.xml
index 6241541f..d307928b 100644
--- a/Camera2Video/app/src/main/res/navigation/nav_graph.xml
+++ b/Camera2Video/app/src/main/res/navigation/nav_graph.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!--
-  ~ Copyright 2020 The Android Open Source Project
+  ~ Copyright 2023 The Android Open Source Project
   ~
   ~ Licensed under the Apache License, Version 2.0 (the "License");
   ~ you may not use this file except in compliance with the License.
@@ -42,6 +42,10 @@
             android:id="@+id/action_selector_to_dynamic_range"
             app:destination="@id/dynamic_range_fragment" />
 
+        <action
+            android:id="@+id/action_selector_to_color_space"
+            app:destination="@id/color_space_fragment" />
+
         <action
             android:id="@+id/action_selector_to_preview_stabilization"
             app:destination="@id/preview_stabilization_fragment" />
@@ -75,6 +79,11 @@
             android:name="fps"
             app:argType="integer" />
 
+        <action
+            android:id="@+id/action_dynamic_range_to_color_space"
+            app:launchSingleTop="true"
+            app:destination="@id/color_space_fragment" />
+
         <action
             android:id="@+id/action_dynamic_range_to_preview_stabilization"
             app:launchSingleTop="true"
@@ -87,6 +96,44 @@
 
     </fragment>
 
+    <fragment
+        android:id="@+id/color_space_fragment"
+        android:name="com.example.android.camera2.video.fragments.ColorSpaceFragment"
+        android:label="ColorSpace" >
+
+        <argument
+            android:name="camera_id"
+            app:argType="string"
+            app:nullable="false"/>
+
+        <argument
+            android:name="width"
+            app:argType="integer" />
+
+        <argument
+            android:name="height"
+            app:argType="integer" />
+
+        <argument
+            android:name="fps"
+            app:argType="integer" />
+
+        <argument
+            android:name="dynamicRange"
+            app:argType="long" />
+
+        <action
+            android:id="@+id/action_color_space_to_preview_stabilization"
+            app:launchSingleTop="true"
+            app:destination="@id/preview_stabilization_fragment" />
+
+        <action
+            android:id="@+id/action_color_space_to_encode_api"
+            app:launchSingleTop="true"
+            app:destination="@id/encode_api_fragment" />
+
+    </fragment>
+
     <fragment
         android:id="@+id/preview_stabilization_fragment"
         android:name="com.example.android.camera2.video.fragments.PreviewStabilizationFragment"
@@ -113,6 +160,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <action
             android:id="@+id/action_preview_stabilization_to_encode_api"
             app:launchSingleTop="true"
@@ -146,6 +197,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <argument
             android:name="previewStabilization"
             app:argType="boolean" />
@@ -183,6 +238,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <argument
             android:name="previewStabilization"
             app:argType="boolean" />
@@ -229,6 +288,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <argument
             android:name="previewStabilization"
             app:argType="boolean" />
@@ -275,6 +338,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <argument
             android:name="previewStabilization"
             app:argType="boolean" />
@@ -320,6 +387,10 @@
             android:name="dynamicRange"
             app:argType="long" />
 
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
         <argument
             android:name="previewStabilization"
             app:argType="boolean" />

From 1c7df819325faf962d26c334f406bc1a192b22ad Mon Sep 17 00:00:00 2001
From: CharcoalChen <charcoal.chen@gmail.com>
Date: Thu, 5 Oct 2023 17:10:55 +0800
Subject: [PATCH 03/22] [skip ci] Add UI design to show the capture progress
 related info provided by Camera2Extensions API 34

1. Update compileSdk as 34
2. Add UI to show capture progress related info when the following features are supported
   - StillCaptureLatency
   - Still capture processing progress
   - Postview image
   When the capture progress related UI is shown, the mode switch, capture button and strength slide controls will be disabled.
3. Add a slider for adjusting the extension strength when it is supported
   - The slider becomes visibile after retrieving the initial strength value from capture result
4. Add utils project dependence for YuvToRgbConvertor
   - All files under the utils folder are copied from the CameraXVideo project folder
5. Update the android build tools to version 7.4.2
---
 Camera2Extensions/app/build.gradle            |   4 +-
 .../extensions/fragments/CameraFragment.kt    | 535 ++++++++++++++++--
 .../main/res/drawable/ic_progress_info_bg.xml |  13 +
 .../src/main/res/layout/fragment_camera.xml   |  90 +++
 .../app/src/main/res/values/dimens.xml        |   7 +
 .../app/src/main/res/values/strings.xml       |   6 +-
 .../app/src/main/res/values/styles.xml        |   2 +-
 Camera2Extensions/build.gradle                |   6 +-
 .../gradle/wrapper/gradle-wrapper.jar         | Bin 56177 -> 59536 bytes
 .../gradle/wrapper/gradle-wrapper.properties  |   3 +-
 Camera2Extensions/gradlew                     | 282 +++++----
 Camera2Extensions/gradlew.bat                 |  43 +-
 Camera2Extensions/settings.gradle             |   3 +-
 Camera2Extensions/utils/README.md             |   2 +
 Camera2Extensions/utils/build.gradle          |  73 +++
 .../utils/src/main/AndroidManifest.xml        |  17 +
 .../camera/utils/AutoFitSurfaceView.kt        |  79 +++
 .../android/camera/utils/CameraSizes.kt       |  79 +++
 .../example/android/camera/utils/ExifUtils.kt |  73 +++
 .../camera/utils/GenericListAdapter.kt        |  55 ++
 .../camera/utils/OrientationLiveData.kt       |  95 ++++
 .../com/example/android/camera/utils/Yuv.kt   | 191 +++++++
 .../android/camera/utils/YuvToRgbConverter.kt |  99 ++++
 .../src/main/res/drawable/ic_shutter.xml      |  21 +
 .../main/res/drawable/ic_shutter_focused.xml  |  28 +
 .../main/res/drawable/ic_shutter_normal.xml   |  28 +
 .../main/res/drawable/ic_shutter_pressed.xml  |  28 +
 27 files changed, 1681 insertions(+), 181 deletions(-)
 create mode 100644 Camera2Extensions/app/src/main/res/drawable/ic_progress_info_bg.xml
 create mode 100644 Camera2Extensions/utils/README.md
 create mode 100644 Camera2Extensions/utils/build.gradle
 create mode 100644 Camera2Extensions/utils/src/main/AndroidManifest.xml
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/AutoFitSurfaceView.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/CameraSizes.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/ExifUtils.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/GenericListAdapter.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/OrientationLiveData.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/Yuv.kt
 create mode 100644 Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/YuvToRgbConverter.kt
 create mode 100644 Camera2Extensions/utils/src/main/res/drawable/ic_shutter.xml
 create mode 100644 Camera2Extensions/utils/src/main/res/drawable/ic_shutter_focused.xml
 create mode 100644 Camera2Extensions/utils/src/main/res/drawable/ic_shutter_normal.xml
 create mode 100644 Camera2Extensions/utils/src/main/res/drawable/ic_shutter_pressed.xml

diff --git a/Camera2Extensions/app/build.gradle b/Camera2Extensions/app/build.gradle
index 2ecfcfa1..b3b9bc32 100644
--- a/Camera2Extensions/app/build.gradle
+++ b/Camera2Extensions/app/build.gradle
@@ -20,10 +20,10 @@ apply plugin: 'kotlin-kapt'
 apply plugin: "androidx.navigation.safeargs"
 
 android {
-    compileSdkVersion 'android-33'
     defaultConfig {
         testInstrumentationRunner kotlin_version
         applicationId "com.android.example.camera2.extensions"
+        compileSdk 34
         minSdkVersion 31
         targetSdkVersion 33
         versionCode 1
@@ -65,6 +65,7 @@ android {
 dependencies {
     implementation "androidx.activity:activity-ktx:1.2.3"
     implementation "androidx.fragment:fragment-ktx:1.3.5"
+    implementation(project(":utils"))
 
     // Kotlin lang
     implementation 'androidx.core:core-ktx:1.6.0'
@@ -76,6 +77,7 @@ dependencies {
     implementation 'androidx.appcompat:appcompat:1.3.0'
     implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.3.1'
     implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
+    implementation 'com.google.android.material:material:1.6.0'
 
     // Navigation library
     def nav_version = "2.3.5"
diff --git a/Camera2Extensions/app/src/main/java/com/example/android/camera2/extensions/fragments/CameraFragment.kt b/Camera2Extensions/app/src/main/java/com/example/android/camera2/extensions/fragments/CameraFragment.kt
index 1cf82947..07d2ce26 100644
--- a/Camera2Extensions/app/src/main/java/com/example/android/camera2/extensions/fragments/CameraFragment.kt
+++ b/Camera2Extensions/app/src/main/java/com/example/android/camera2/extensions/fragments/CameraFragment.kt
@@ -20,6 +20,7 @@ import android.annotation.SuppressLint
 import android.content.Context
 import android.graphics.*
 import android.hardware.camera2.*
+import android.hardware.camera2.CameraExtensionSession.StillCaptureLatency
 import android.hardware.camera2.params.ExtensionSessionConfiguration
 import android.hardware.camera2.params.MeteringRectangle
 import android.hardware.camera2.params.OutputConfiguration
@@ -33,21 +34,41 @@ import android.widget.Toast
 import androidx.fragment.app.Fragment
 import androidx.lifecycle.lifecycleScope
 import androidx.navigation.fragment.navArgs
+import com.example.android.camera.utils.YuvToRgbConverter
 import com.example.android.camera2.extensions.R
 import com.example.android.camera2.extensions.ZoomUtil
 import com.example.android.camera2.extensions.databinding.FragmentCameraBinding
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.asExecutor
-import kotlinx.coroutines.launch
-import kotlinx.coroutines.suspendCancellableCoroutine
+import com.google.android.material.slider.Slider
 import java.io.File
 import java.io.FileOutputStream
 import java.io.OutputStream
 import java.nio.ByteBuffer
+import java.util.concurrent.Executors
+import java.util.concurrent.ScheduledFuture
+import java.util.concurrent.TimeUnit
 import java.util.stream.Collectors
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException
 import kotlin.math.abs
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.asExecutor
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.suspendCancellableCoroutine
+
+/**
+ * The still capture progress is in DONE state.
+ */
+private const val PROGRESS_STATE_DONE = 0
+/**
+ * The still capture progress is in HOLD_STILL state which should show a message to request the end
+ * users to hold still.
+ */
+private const val PROGRESS_STATE_HOLD_STILL = 1
+/**
+ * The still capture progress is in STILL_PROCESSING state which should show a message to let the
+ * end users know the still image is under processing.
+ */
+private const val PROGRESS_STATE_STILL_PROCESSING = 2
 
 /*
  * This is the main camera fragment where all camera extension logic can be found.
@@ -120,6 +141,107 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
 
   private var zoomRatio: Float = ZoomUtil.minZoom()
 
+  /**
+   * Track the extension strength support for current extension mode.
+   */
+  private var isExtensionStrengthAvailable = false
+
+  /**
+   * Track the extension strength setting.
+   */
+  private var extensionStrength = -1
+  /**
+   * Track the postview support for current extension mode.
+   */
+  private var isPostviewAvailable = false
+  /**
+   * Track the capture process progress support for current extension mode.
+   */
+  private var isCaptureProcessProgressAvailable = false
+  /**
+   * A reference to the image reader to receive the postview when it can be supported for current
+   * extension mode.
+   */
+  private var postviewImageReader: ImageReader? = null
+  /**
+   * A ScheduledFuture for repeatedly updating the capture progress info.
+   */
+  private var progressInfoScheduledFuture: ScheduledFuture<*>? = null
+  /**
+   * Track the process state of current still capture request.
+   */
+  private var progressState = PROGRESS_STATE_DONE
+  /**
+   * Track the still capture latency of current still capture request.
+   */
+  private var stillCaptureLatency: StillCaptureLatency? = null
+  /**
+   *  Track the HOLD_STILL or STILL_PROCESSING start timestamp of current still capture request.
+   */
+  private var progressStartTimestampMs: Long = 0
+  /**
+   * Track the capture processing progress of current still capture request.
+   */
+  private var captureProcessingProgress = -1
+
+  /**
+   * Calculates the remaining duration for the latency of current state.
+   *
+   * The duration is calculated against the start timestamp which was stored when current process
+   * state was begun.
+   */
+  private fun calculateRemainingDurationInMs(): Long {
+    // Only supported when API level is 34 or above
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+      return 0
+    }
+
+    // Only supported when capture latency info is provided
+    if (stillCaptureLatency == null) {
+      return 0
+    }
+
+    val currentTimestampMs = SystemClock.elapsedRealtime()
+    val pastTimeMs = currentTimestampMs - progressStartTimestampMs
+    val remainingTimeMs = if (progressState == PROGRESS_STATE_HOLD_STILL) {
+      stillCaptureLatency!!.captureLatency - pastTimeMs
+    } else {
+      stillCaptureLatency!!.processingLatency - pastTimeMs
+    }
+
+    return if (remainingTimeMs > 0) remainingTimeMs else 0
+  }
+
+  /**
+   * Calculates the process progress for the latency of current state.
+   *
+   * The progress is calculated against the total latency duration of current state.
+   */
+  private fun calculateProgressByRemainingDuration(): Int {
+    // Only supported when API level is 34 or above
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+      return 0
+    }
+
+    // Only supported when capture latency info is provided
+    if (stillCaptureLatency == null) {
+      return 0
+    }
+
+    val currentTimestampMs = SystemClock.elapsedRealtime()
+    val pastTimeMs = currentTimestampMs - progressStartTimestampMs
+    return (if (progressState == PROGRESS_STATE_HOLD_STILL) {
+      pastTimeMs * 100 / stillCaptureLatency!!.captureLatency
+    } else {
+      pastTimeMs * 100 / stillCaptureLatency!!.processingLatency
+    }).toInt()
+  }
+
+  /**
+   * Lens facing of the working camera
+   */
+  private var lensFacing = CameraCharacteristics.LENS_FACING_BACK
+
   /**
    * Gesture detector used for tap to focus
    */
@@ -171,6 +293,14 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         request: CaptureRequest
       ) {
         Log.v(TAG, "onCaptureProcessStarted")
+        // Turns to STILL_PROCESSING stage when the request tag is STILL_CAPTURE_TAG
+        if (request.tag == STILL_CAPTURE_TAG && progressState == PROGRESS_STATE_HOLD_STILL) {
+          progressState = PROGRESS_STATE_STILL_PROCESSING
+          progressStartTimestampMs = SystemClock.elapsedRealtime()
+          requireActivity().runOnUiThread {
+            binding.progressState?.text = getString(R.string.state_still_processing)
+          }
+        }
       }
 
       override fun onCaptureResultAvailable(
@@ -199,6 +329,23 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
 
           queueAutoFocusReset()
         }
+
+        // The initial extension strength value will be provided by the capture results. Checks it
+        // to set and show the slider for end users to adjust their preferred strength setting.
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE &&
+          isExtensionStrengthAvailable && extensionStrength == -1 &&
+          result.keys.contains(CaptureResult.EXTENSION_STRENGTH)
+        ) {
+          result.get(CaptureResult.EXTENSION_STRENGTH)?.let {
+            extensionStrength = it
+            requireActivity().runOnUiThread {
+              binding.strengthSlider?.apply {
+                value = extensionStrength.toFloat()
+                visibility = View.VISIBLE
+              }
+            }
+          }
+        }
       }
 
       override fun onCaptureFailed(
@@ -206,6 +353,7 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         request: CaptureRequest
       ) {
         Log.v(TAG, "onCaptureProcessFailed")
+        hideCaptureProgressUI()
       }
 
       override fun onCaptureSequenceCompleted(
@@ -220,6 +368,45 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         sequenceId: Int
       ) {
         Log.v(TAG, "onCaptureProcessSequenceAborted: $sequenceId")
+        hideCaptureProgressUI()
+      }
+
+      override fun onCaptureProcessProgressed(
+        session: CameraExtensionSession,
+        request: CaptureRequest,
+        progress: Int,
+      ) {
+        // Caches current processing progress and updates the progress info
+        captureProcessingProgress = progress
+        updateProgressInfo()
+      }
+    }
+
+  /**
+   * The slide OnChangeListener implementation for receiving the value change and submitting the
+   * request to change the extension strength setting.
+   */
+  private val sliderOnChangeListener: Slider.OnChangeListener =
+    object : Slider.OnChangeListener {
+      override fun onValueChange(slider: Slider, value: Float, fromUser: Boolean) {
+        if (!fromUser || Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+          return
+        }
+
+        extensionStrength = value.toInt()
+        submitRequest(
+          CameraDevice.TEMPLATE_PREVIEW,
+          previewSurface,
+          true,
+        ) { builder ->
+          builder.apply {
+            set(
+              CaptureRequest.EXTENSION_STRENGTH,
+              extensionStrength
+            )
+            Log.d(TAG, "submit request for extension strength: $extensionStrength")
+          }
+        }
       }
     }
 
@@ -281,10 +468,14 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
 
     extensionCharacteristics = cameraManager.getCameraExtensionCharacteristics(args.cameraId)
     characteristics = cameraManager.getCameraCharacteristics(args.cameraId)
+    lensFacing = characteristics[CameraCharacteristics.LENS_FACING]!!
     supportedExtensions.addAll(extensionCharacteristics.supportedExtensions)
     if (currentExtension == -1) {
       currentExtension = supportedExtensions[0]
       currentExtensionIdx = 0
+      refreshStrengthAndCaptureProgressAvailabilityInfo()
+      binding.strengthSlider?.visibility = View.GONE
+      extensionStrength = -1
       binding.switchButton.text = getExtensionLabel(currentExtension)
     }
 
@@ -293,7 +484,10 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         lifecycleScope.launch(Dispatchers.IO) {
           currentExtensionIdx = (currentExtensionIdx + 1) % supportedExtensions.size
           currentExtension = supportedExtensions[currentExtensionIdx]
+          refreshStrengthAndCaptureProgressAvailabilityInfo()
+          extensionStrength = -1
           requireActivity().runOnUiThread {
+            binding.strengthSlider?.visibility = View.GONE
             binding.switchButton.text = getExtensionLabel(currentExtension)
             restartPreview = true
           }
@@ -319,6 +513,23 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
 
       true
     }
+
+    // Sets strength slider change listener
+    binding.strengthSlider?.addOnChangeListener(sliderOnChangeListener)
+  }
+
+  /**
+   * Refreshes the extension strength and capture progress related availability info.
+   */
+  private fun refreshStrengthAndCaptureProgressAvailabilityInfo() {
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+      isExtensionStrengthAvailable =
+        extensionCharacteristics.getAvailableCaptureRequestKeys(currentExtension)
+          .contains(CaptureRequest.EXTENSION_STRENGTH)
+      isPostviewAvailable = extensionCharacteristics.isPostviewAvailable(currentExtension)
+      isCaptureProcessProgressAvailable =
+        extensionCharacteristics.isCaptureProcessProgressAvailable(currentExtension)
+    }
   }
 
   /**
@@ -435,44 +646,12 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
     if (!binding.texture.isAvailable) {
       return
     }
-    val texture = binding.texture.surfaceTexture
+
     previewSize = pickPreviewResolution(cameraManager, args.cameraId)
-    texture?.setDefaultBufferSize(previewSize.width, previewSize.height)
-    previewSurface = Surface(texture)
-    val yuvColorEncodingSystemSizes = extensionCharacteristics.getExtensionSupportedSizes(
-      currentExtension, ImageFormat.YUV_420_888
-    )
-    val jpegSizes = extensionCharacteristics.getExtensionSupportedSizes(
-      currentExtension, ImageFormat.JPEG
-    )
-    val stillFormat = if (jpegSizes.isEmpty()) ImageFormat.YUV_420_888 else ImageFormat.JPEG
-    val stillCaptureSize = if (jpegSizes.isEmpty()) yuvColorEncodingSystemSizes[0] else jpegSizes[0]
-    stillImageReader = ImageReader.newInstance(
-      stillCaptureSize.width,
-      stillCaptureSize.height, stillFormat, 1
-    )
-    stillImageReader.setOnImageAvailableListener(
-      { reader: ImageReader ->
-        var output: OutputStream
-        try {
-          reader.acquireLatestImage().use { image ->
-            val file = File(
-              requireActivity().getExternalFilesDir(null),
-              if (image.format == ImageFormat.JPEG) "frame.jpg" else "frame.yuv"
-            )
-            output = FileOutputStream(file)
-            output.write(getDataFromImage(image))
-            output.close()
-            Toast.makeText(
-              requireActivity(), "Frame saved at: " + file.path,
-              Toast.LENGTH_SHORT
-            ).show()
-          }
-        } catch (e: Exception) {
-          e.printStackTrace()
-        }
-      }, storeHandler
-    )
+    previewSurface = createPreviewSurface(previewSize)
+    stillImageReader = createStillImageReader()
+    postviewImageReader = createPostviewImageReader()
+
     val outputConfig = ArrayList<OutputConfiguration>()
     outputConfig.add(OutputConfiguration(stillImageReader.surface))
     outputConfig.add(OutputConfiguration(previewSurface))
@@ -482,6 +661,7 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         override fun onClosed(session: CameraExtensionSession) {
           if (restartPreview) {
             stillImageReader.close()
+            postviewImageReader?.close()
             restartPreview = false
             startPreview()
           } else {
@@ -512,6 +692,12 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
         }
       }
     )
+    // Adds postview image reader surface to extension session configuration if it is supported.
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+      postviewImageReader?.let {
+        extensionConfiguration.postviewOutputConfiguration = OutputConfiguration(it.surface)
+      }
+    }
     try {
       cameraDevice.createExtensionSession(extensionConfiguration)
     } catch (e: CameraAccessException) {
@@ -523,18 +709,270 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
     }
   }
 
+  /**
+   * Creates the preview surface
+   */
+  private fun createPreviewSurface(previewSize: Size): Surface {
+    val texture = binding.texture.surfaceTexture
+    texture?.setDefaultBufferSize(previewSize.width, previewSize.height)
+    return Surface(texture)
+  }
+
+  /**
+   * Creates the still image reader and sets up OnImageAvailableListener
+   */
+  private fun createStillImageReader(): ImageReader {
+    val yuvColorEncodingSystemSizes = extensionCharacteristics.getExtensionSupportedSizes(
+      currentExtension, ImageFormat.YUV_420_888
+    )
+    val jpegSizes = extensionCharacteristics.getExtensionSupportedSizes(
+      currentExtension, ImageFormat.JPEG
+    )
+    val stillFormat = if (jpegSizes.isEmpty()) ImageFormat.YUV_420_888 else ImageFormat.JPEG
+    val stillCaptureSize = if (jpegSizes.isEmpty()) yuvColorEncodingSystemSizes[0] else jpegSizes[0]
+    val stillImageReader = ImageReader.newInstance(
+      stillCaptureSize.width,
+      stillCaptureSize.height, stillFormat, 1
+    )
+    stillImageReader.setOnImageAvailableListener(
+      { reader: ImageReader ->
+        var output: OutputStream
+        try {
+          reader.acquireLatestImage().use { image ->
+            hideCaptureProgressUI()
+            val file = File(
+              requireActivity().getExternalFilesDir(null),
+              if (image.format == ImageFormat.JPEG) "frame.jpg" else "frame.yuv"
+            )
+            output = FileOutputStream(file)
+            output.write(getDataFromImage(image))
+            output.close()
+            Toast.makeText(
+              requireActivity(), "Frame saved at: " + file.path,
+              Toast.LENGTH_SHORT
+            ).show()
+          }
+        } catch (e: Exception) {
+          e.printStackTrace()
+        }
+      }, storeHandler
+    )
+    return stillImageReader
+  }
+
+  /**
+   * Creates postview image reader and sets up OnImageAvailableListener if current extension mode
+   * supports postview.
+   */
+  private fun createPostviewImageReader(): ImageReader? {
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE || !isPostviewAvailable) {
+      return null
+    }
+
+    val jpegSupportedSizes = extensionCharacteristics.getPostviewSupportedSizes(
+      currentExtension,
+      Size(
+        stillImageReader.width,
+        stillImageReader.height
+      ),
+      ImageFormat.JPEG
+    )
+    val yuvSupportedSizes = extensionCharacteristics.getPostviewSupportedSizes(
+      currentExtension,
+      Size(
+        stillImageReader.width,
+        stillImageReader.height
+      ),
+      ImageFormat.YUV_420_888
+    )
+    val postviewSize: Size
+    val postviewFormat: Int
+    if (!jpegSupportedSizes.isEmpty()) {
+      postviewSize = jpegSupportedSizes[0]
+      postviewFormat = ImageFormat.JPEG
+    } else {
+      postviewSize = yuvSupportedSizes[0]
+      postviewFormat = ImageFormat.YUV_420_888
+    }
+    val postviewImageReader =
+      ImageReader.newInstance(postviewSize.width, postviewSize.height, postviewFormat, 1)
+    postviewImageReader.setOnImageAvailableListener(
+      { reader: ImageReader ->
+        try {
+          reader.acquireLatestImage().use { image ->
+            drawPostviewImage(image)
+          }
+        } catch (e: Exception) {
+          e.printStackTrace()
+        }
+      }, storeHandler
+    )
+
+    return postviewImageReader
+  }
+
+  /**
+   * Draw postview image to the capture progress UI
+   */
+  private fun drawPostviewImage(image: Image) {
+    createBitmapFromImage(image)?.let { bitmap ->
+      requireActivity().runOnUiThread {
+        binding.progressInfoImage?.apply {
+          // The following settings are for correctly displaying the postview image in portrait
+          // orientation which Camera2Extensions sample app currently supports for.
+          if (lensFacing == CameraCharacteristics.LENS_FACING_BACK) {
+            rotation = 90.0f
+            scaleY = 1.0f
+          } else {
+            rotation = 270.0f
+            scaleY = -1.0f
+          }
+          setImageBitmap(bitmap)
+          visibility = View.VISIBLE
+        }
+      }
+    }
+  }
+
+  private fun createBitmapFromImage(image: Image): Bitmap? {
+    Log.d(TAG, "createBitmapFromImage from image of format ${image.format}")
+    when (image.format) {
+      ImageFormat.JPEG -> {
+        val data = getDataFromImage(image)
+        return BitmapFactory.decodeByteArray(data, 0, data.size, null)
+      }
+
+      ImageFormat.YUV_420_888 -> {
+        val yuvToRgbConverter = YuvToRgbConverter(requireContext())
+        val bitmap = Bitmap.createBitmap(image.width, image.height, Bitmap.Config.ARGB_8888)
+        yuvToRgbConverter.yuvToRgb(image, bitmap)
+        return bitmap
+      }
+    }
+
+    return null
+  }
+
   /**
    * Takes a picture.
    */
   private fun takePicture() {
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+      // Retrieves the still capture latency info
+      cameraExtensionSession.realtimeStillCaptureLatency?.let {
+        stillCaptureLatency = it
+        progressStartTimestampMs = SystemClock.elapsedRealtime()
+      }
+      captureProcessingProgress = -1
+      showCaptureProgressUI()
+    }
     submitRequest(
       CameraDevice.TEMPLATE_STILL_CAPTURE,
-      stillImageReader.surface,
+      if (isPostviewAvailable) {
+        listOf(stillImageReader.surface, postviewImageReader!!.surface)
+      } else {
+        listOf(stillImageReader.surface)
+      },
       false
     ) { request ->
       request.apply {
         set(CaptureRequest.CONTROL_ZOOM_RATIO, zoomRatio)
+        setTag(STILL_CAPTURE_TAG)
+      }
+    }
+  }
+
+  /**
+   * Shows the UI for capture progress info
+   */
+  private fun showCaptureProgressUI() {
+    // Do not show the UI if none of still capture latency, process progress or postview is
+    // supported.
+    if (stillCaptureLatency == null && !isCaptureProcessProgressAvailable && !isPostviewAvailable) {
+      return
+    }
+
+    progressState = PROGRESS_STATE_HOLD_STILL
+    requireActivity().runOnUiThread {
+      enableUiControls(false)
+      binding.progressInfoContainer?.visibility = View.VISIBLE
+      binding.progressState?.text = getString(R.string.state_hold_still)
+      binding.progressIndicator?.isIndeterminate = stillCaptureLatency == null
+    }
+    // Schedules to execute a runnable repeatedly to update the progress info
+    if (stillCaptureLatency != null) {
+      progressInfoScheduledFuture = Executors.newSingleThreadScheduledExecutor()
+        .scheduleAtFixedRate(
+          { updateProgressInfo() }, 0, 100, TimeUnit.MILLISECONDS
+        )
+    }
+  }
+
+  private fun enableUiControls(isEnabled: Boolean) {
+    requireActivity().runOnUiThread {
+      binding.switchButton.isEnabled = isEnabled
+      binding.captureButton.isEnabled = isEnabled
+      binding.strengthSlider?.isEnabled = isEnabled
+    }
+  }
+
+  /**
+   * Updates the capture progress info
+   */
+  private fun updateProgressInfo() {
+    requireActivity().runOnUiThread {
+      binding.progressState?.text = when (progressState) {
+        PROGRESS_STATE_HOLD_STILL -> resources.getString(R.string.state_hold_still)
+        PROGRESS_STATE_STILL_PROCESSING -> resources.getString(R.string.state_still_processing)
+        else -> ""
       }
+
+      binding.progressIndicator?.isIndeterminate = false
+
+      if (progressState == PROGRESS_STATE_STILL_PROCESSING && isCaptureProcessProgressAvailable) {
+        binding.progressIndicator?.progress = captureProcessingProgress
+
+        if (captureProcessingProgress == 100) {
+          hideCaptureProgressUI()
+        }
+      }
+
+      stillCaptureLatency?.let {
+        val remainingDurationMs = calculateRemainingDurationInMs()
+        binding.progressLatencyDuration?.text =
+          resources.getString(R.string.latency_duration, (remainingDurationMs + 500) / 1000)
+        // Updates the progress indicator according to the remaining duration of latency time if
+        // capture process progress is not supported.
+        if (progressState == PROGRESS_STATE_HOLD_STILL || !isCaptureProcessProgressAvailable) {
+          binding.progressIndicator?.progress = calculateProgressByRemainingDuration()
+        }
+        // Automatically turns to still-processing state if capture process progress is not
+        // supported
+        if (remainingDurationMs.toInt() == 0 && progressState == PROGRESS_STATE_HOLD_STILL) {
+          progressState = PROGRESS_STATE_STILL_PROCESSING
+          progressStartTimestampMs = SystemClock.elapsedRealtime()
+          updateProgressInfo()
+        }
+      }
+    }
+  }
+
+  /**
+   * Hides the UI for capture progress info
+   */
+  private fun hideCaptureProgressUI() {
+    progressState = PROGRESS_STATE_DONE
+    requireActivity().runOnUiThread {
+      binding.progressInfoContainer?.apply {
+        visibility = View.GONE
+        binding.progressInfoImage?.visibility = View.GONE
+        binding.progressLatencyDuration?.text = ""
+      }
+      enableUiControls(true)
+    }
+    progressInfoScheduledFuture?.apply {
+      cancel(true)
+      progressInfoScheduledFuture = null
     }
   }
 
@@ -543,10 +981,20 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
     target: Surface,
     isRepeating: Boolean,
     block: (captureRequest: CaptureRequest.Builder) -> CaptureRequest.Builder) {
+    return submitRequest(templateType, listOf(target), isRepeating, block)
+  }
+
+  private fun submitRequest(
+    templateType: Int,
+    targets: List<Surface>,
+    isRepeating: Boolean,
+    block: (captureRequest: CaptureRequest.Builder) -> CaptureRequest.Builder) {
     try {
       val captureBuilder = cameraDevice.createCaptureRequest(templateType)
         .apply {
-          addTarget(target)
+          targets.forEach {
+            addTarget(it)
+          }
           if (tag != null) {
             setTag(tag)
           }
@@ -760,6 +1208,7 @@ class CameraFragment : Fragment(), TextureView.SurfaceTextureListener {
 
   companion object {
     private val TAG = CameraFragment::class.java.simpleName
+    private const val STILL_CAPTURE_TAG = "still_capture_tag"
     private const val AUTO_FOCUS_TAG = "auto_focus_tag"
     private const val AUTO_FOCUS_TIMEOUT_MILLIS = 5_000L
     private const val METERING_RECTANGLE_SIZE = 0.15f
diff --git a/Camera2Extensions/app/src/main/res/drawable/ic_progress_info_bg.xml b/Camera2Extensions/app/src/main/res/drawable/ic_progress_info_bg.xml
new file mode 100644
index 00000000..35296f0a
--- /dev/null
+++ b/Camera2Extensions/app/src/main/res/drawable/ic_progress_info_bg.xml
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="utf-8"?>
+<ripple xmlns:android="http://schemas.android.com/apk/res/android">
+  <item>
+    <shape android:shape="rectangle">
+      <corners
+          android:bottomLeftRadius="8dp"
+          android:bottomRightRadius="8dp"
+          android:topLeftRadius="8dp"
+          android:topRightRadius="8dp"/>
+      <solid android:color="#AAFFFFFF"/>
+    </shape>
+  </item>
+</ripple>
\ No newline at end of file
diff --git a/Camera2Extensions/app/src/main/res/layout/fragment_camera.xml b/Camera2Extensions/app/src/main/res/layout/fragment_camera.xml
index be69f276..a958ffbd 100644
--- a/Camera2Extensions/app/src/main/res/layout/fragment_camera.xml
+++ b/Camera2Extensions/app/src/main/res/layout/fragment_camera.xml
@@ -38,6 +38,25 @@
         android:contentDescription="@string/switch_content"
         android:padding="@dimen/button_padding" />
 
+    <com.google.android.material.slider.Slider
+        android:id="@+id/strength_slider"
+        style="@style/Theme.AppCompat"
+        android:layout_width="match_parent"
+        android:layout_height="wrap_content"
+        android:layout_marginLeft="25dp"
+        android:layout_marginTop="25dp"
+        android:contentDescription="@string/slider_content"
+        android:rotation="270"
+        android:stepSize="1"
+        android:transformPivotX="10dp"
+        android:transformPivotY="10dp"
+        android:valueFrom="0"
+        android:valueTo="100"
+        android:visibility="gone"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/capture_button"/>
+
     <ImageButton
         android:id="@+id/capture_button"
         android:layout_width="@dimen/image_button_width"
@@ -50,4 +69,75 @@
         app:layout_constraintBottom_toBottomOf="parent"
         android:contentDescription="@string/capture" />
 
+    <LinearLayout
+        android:id="@+id/progress_info_container"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:layout_gravity="bottom"
+        android:layout_marginBottom="@dimen/progress_info_margin"
+        android:orientation="vertical"
+        android:visibility="gone"
+        app:layout_constraintLeft_toLeftOf="parent"
+        app:layout_constraintRight_toRightOf="parent"
+        app:layout_constraintBottom_toTopOf="@id/capture_button"
+        >
+        <ImageView
+            android:id="@+id/progress_info_image"
+            android:layout_width="@dimen/postview_image_width"
+            android:layout_height="@dimen/postview_image_height"
+            android:layout_marginBottom="@dimen/progress_info_margin"
+            android:layout_marginTop="@dimen/progress_info_margin"
+            android:layout_gravity="center"
+            android:background="@drawable/ic_progress_info_bg"
+            android:paddingLeft="@dimen/progress_info_padding"
+            android:paddingRight="@dimen/progress_info_padding"
+            android:paddingTop="@dimen/progress_info_padding"
+            android:paddingBottom="@dimen/progress_info_padding"
+            android:scaleType="fitCenter"
+            android:visibility="gone"/>
+        <LinearLayout
+            android:id="@+id/progress_info"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:layout_gravity="bottom"
+            android:orientation="vertical"
+            android:background="@drawable/ic_progress_info_bg">
+            <TextView
+                android:id="@+id/progress_state"
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:textColor="@android:color/black"
+                android:gravity="center"
+                android:paddingLeft="@dimen/progress_info_padding"
+                android:paddingRight="@dimen/progress_info_padding"
+                android:paddingTop="@dimen/progress_info_padding"
+                android:textSize="@dimen/text_size_progress_state"/>
+            <FrameLayout
+                android:layout_width="wrap_content"
+                android:layout_height="wrap_content"
+                android:layout_gravity="center">
+                <com.google.android.material.progressindicator.CircularProgressIndicator
+                    android:id="@+id/progress_indicator"
+                    android:layout_width="wrap_content"
+                    android:layout_height="wrap_content"
+                    android:layout_gravity="center"
+                    android:paddingLeft="@dimen/circle_indicator_padding"
+                    android:paddingRight="@dimen/circle_indicator_padding"
+                    android:paddingTop="@dimen/circle_indicator_padding"
+                    android:paddingBottom="@dimen/circle_indicator_padding"
+                    android:scaleX="1.8"
+                    android:scaleY="1.8"
+                    app:indicatorColor="@android:color/holo_orange_dark"/>
+                <TextView
+                    android:id="@+id/progress_latency_duration"
+                    android:layout_width="match_parent"
+                    android:layout_height="match_parent"
+                    android:layout_gravity="center"
+                    android:textColor="@android:color/holo_orange_dark"
+                    android:gravity="center"
+                    android:textSize="@dimen/text_size_latency_duration"/>
+            </FrameLayout>
+        </LinearLayout>
+    </LinearLayout>
+
 </androidx.constraintlayout.widget.ConstraintLayout>
\ No newline at end of file
diff --git a/Camera2Extensions/app/src/main/res/values/dimens.xml b/Camera2Extensions/app/src/main/res/values/dimens.xml
index 3d9c73da..ebf4236b 100644
--- a/Camera2Extensions/app/src/main/res/values/dimens.xml
+++ b/Camera2Extensions/app/src/main/res/values/dimens.xml
@@ -17,7 +17,14 @@
 
 <resources>
   <dimen name="button_padding">20dp</dimen>
+  <dimen name="circle_indicator_padding">24dp</dimen>
   <dimen name="image_button_width">96dp</dimen>
   <dimen name="image_button_height">96dp</dimen>
   <dimen name="image_button_bottom_margin">96dp</dimen>
+  <dimen name="postview_image_height">90dp</dimen>
+  <dimen name="postview_image_width">120dp</dimen>
+  <dimen name="progress_info_padding">8dp</dimen>
+  <dimen name="progress_info_margin">24dp</dimen>
+  <dimen name="text_size_progress_state">32sp</dimen>
+  <dimen name="text_size_latency_duration">24sp</dimen>
 </resources>
\ No newline at end of file
diff --git a/Camera2Extensions/app/src/main/res/values/strings.xml b/Camera2Extensions/app/src/main/res/values/strings.xml
index d3024d93..32a88a69 100644
--- a/Camera2Extensions/app/src/main/res/values/strings.xml
+++ b/Camera2Extensions/app/src/main/res/values/strings.xml
@@ -18,6 +18,10 @@
 <resources>
     <string name="app_name">Camera2Extensions</string>
     <string name="capture">Capture</string>
-    <string name="switch_content">Switch extension</string>
+    <string name="latency_duration">%ds</string>
     <string name="permission_required">Camera permission required!</string>
+    <string name="slider_content">Extension strength slider</string>>
+    <string name="state_hold_still">Hold Still...</string>
+    <string name="state_still_processing">Processing...</string>
+    <string name="switch_content">Switch extension</string>
 </resources>
diff --git a/Camera2Extensions/app/src/main/res/values/styles.xml b/Camera2Extensions/app/src/main/res/values/styles.xml
index cf7cd7e0..7b222f57 100644
--- a/Camera2Extensions/app/src/main/res/values/styles.xml
+++ b/Camera2Extensions/app/src/main/res/values/styles.xml
@@ -17,7 +17,7 @@
 
 <resources>
     <!-- Base application theme. -->
-    <style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
+    <style name="AppTheme" parent="Theme.Material3.Light.NoActionBar">
         <item name="android:immersive">true</item>
         <item name="android:windowFullscreen">true</item>
         <item name="android:windowTranslucentStatus">true</item>
diff --git a/Camera2Extensions/build.gradle b/Camera2Extensions/build.gradle
index c44494e2..1c5a117f 100644
--- a/Camera2Extensions/build.gradle
+++ b/Camera2Extensions/build.gradle
@@ -18,7 +18,7 @@
 
 buildscript {
     // Top-level variables used for versioning
-    ext.kotlin_version = '1.5.10'
+    ext.kotlin_version = '1.6.21'
     ext.java_version = JavaVersion.VERSION_1_8
 
     repositories {
@@ -26,10 +26,10 @@ buildscript {
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:4.2.2'
+        classpath 'com.android.tools.build:gradle:7.4.2'
         //noinspection DifferentKotlinGradleVersion
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
-        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:2.3.5"
+        classpath 'androidx.navigation:navigation-safe-args-gradle-plugin:2.4.1'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files
diff --git a/Camera2Extensions/gradle/wrapper/gradle-wrapper.jar b/Camera2Extensions/gradle/wrapper/gradle-wrapper.jar
index 94336fcae912db8a11d55634156fa011f4686124..7454180f2ae8848c63b8b4dea2cb829da983f2fa 100644
GIT binary patch
delta 51385
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%0A}15$O#mvChbGF@eh4Ar%3syAIE
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
X00Rm%3j7*w*}<eig9!8dufP5uya;()

delta 48177
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

diff --git a/Camera2Extensions/gradle/wrapper/gradle-wrapper.properties b/Camera2Extensions/gradle/wrapper/gradle-wrapper.properties
index c46f3740..8049c684 100644
--- a/Camera2Extensions/gradle/wrapper/gradle-wrapper.properties
+++ b/Camera2Extensions/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,5 @@
-#Tue Jun 09 15:16:01 EDT 2020
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip
diff --git a/Camera2Extensions/gradlew b/Camera2Extensions/gradlew
index cccdd3d5..1b6c7873 100755
--- a/Camera2Extensions/gradlew
+++ b/Camera2Extensions/gradlew
@@ -1,78 +1,129 @@
-#!/usr/bin/env sh
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
 
 ##############################################################################
-##
-##  Gradle start up script for UN*X
-##
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
 ##############################################################################
 
 # Attempt to set APP_HOME
+
 # Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
 done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
+
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
 
 APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
+APP_BASE_NAME=${0##*/}
 
 # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS=""
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
 
 # Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
+MAX_FD=maximum
 
 warn () {
     echo "$*"
-}
+} >&2
 
 die () {
     echo
     echo "$*"
     echo
     exit 1
-}
+} >&2
 
 # OS specific support (must be 'true' or 'false').
 cygwin=false
 msys=false
 darwin=false
 nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
 esac
 
 CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
 
+
 # Determine the Java command to use to start the JVM.
 if [ -n "$JAVA_HOME" ] ; then
     if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
         # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
+        JAVACMD=$JAVA_HOME/jre/sh/java
     else
-        JAVACMD="$JAVA_HOME/bin/java"
+        JAVACMD=$JAVA_HOME/bin/java
     fi
     if [ ! -x "$JAVACMD" ] ; then
         die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
@@ -81,7 +132,7 @@ Please set the JAVA_HOME variable in your environment to match the
 location of your Java installation."
     fi
 else
-    JAVACMD="java"
+    JAVACMD=java
     which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
 
 Please set the JAVA_HOME variable in your environment to match the
@@ -89,84 +140,95 @@ location of your Java installation."
 fi
 
 # Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
 fi
 
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
 
-# For Cygwin, switch paths to Windows format before running java
-if $cygwin ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
     # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
         fi
-        i=$((i+1))
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
     done
-    case $i in
-        (0) set -- ;;
-        (1) set -- "$args0" ;;
-        (2) set -- "$args0" "$args1" ;;
-        (3) set -- "$args0" "$args1" "$args2" ;;
-        (4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        (5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        (6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        (7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        (8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        (9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
-    esac
 fi
 
-# Escape application args
-save () {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=$(save "$@")
-
-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
-
-# by default we should be in the correct project dir, but when run from Finder on Mac, the cwd is wrong
-if [ "$(uname)" = "Darwin" ] && [ "$HOME" = "$PWD" ]; then
-  cd "$(dirname "$0")"
-fi
+# Collect all arguments for the java command;
+#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+#     shell script including quotes and variable substitutions, so put them in
+#     double quotes to make sure that they get re-expanded; and
+#   * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
 
 exec "$JAVACMD" "$@"
diff --git a/Camera2Extensions/gradlew.bat b/Camera2Extensions/gradlew.bat
index e95643d6..ac1b06f9 100644
--- a/Camera2Extensions/gradlew.bat
+++ b/Camera2Extensions/gradlew.bat
@@ -1,3 +1,19 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
 @if "%DEBUG%" == "" @echo off
 @rem ##########################################################################
 @rem
@@ -13,15 +29,18 @@ if "%DIRNAME%" == "" set DIRNAME=.
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
 @rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-set DEFAULT_JVM_OPTS=
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
 
 @rem Find java.exe
 if defined JAVA_HOME goto findJavaFromJavaHome
 
 set JAVA_EXE=java.exe
 %JAVA_EXE% -version >NUL 2>&1
-if "%ERRORLEVEL%" == "0" goto init
+if "%ERRORLEVEL%" == "0" goto execute
 
 echo.
 echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
@@ -35,7 +54,7 @@ goto fail
 set JAVA_HOME=%JAVA_HOME:"=%
 set JAVA_EXE=%JAVA_HOME%/bin/java.exe
 
-if exist "%JAVA_EXE%" goto init
+if exist "%JAVA_EXE%" goto execute
 
 echo.
 echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
@@ -45,28 +64,14 @@ echo location of your Java installation.
 
 goto fail
 
-:init
-@rem Get command-line arguments, handling Windows variants
-
-if not "%OS%" == "Windows_NT" goto win9xME_args
-
-:win9xME_args
-@rem Slurp the command line arguments.
-set CMD_LINE_ARGS=
-set _SKIP=2
-
-:win9xME_args_slurp
-if "x%~1" == "x" goto execute
-
-set CMD_LINE_ARGS=%*
-
 :execute
 @rem Setup the command line
 
 set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
 
+
 @rem Execute Gradle
-"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %CMD_LINE_ARGS%
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
 
 :end
 @rem End local scope for the variables with windows NT shell
diff --git a/Camera2Extensions/settings.gradle b/Camera2Extensions/settings.gradle
index 41716e95..78e895a8 100644
--- a/Camera2Extensions/settings.gradle
+++ b/Camera2Extensions/settings.gradle
@@ -14,4 +14,5 @@
  * limitations under the License.
  */
 
-include 'app'
+include ':app'
+include ':utils'
diff --git a/Camera2Extensions/utils/README.md b/Camera2Extensions/utils/README.md
new file mode 100644
index 00000000..7a10722f
--- /dev/null
+++ b/Camera2Extensions/utils/README.md
@@ -0,0 +1,2 @@
+Do not modify code under this folder outside of `CameraUtils`, it is copied
+automatically by `.github/scripts/copy_utils.sh`.
\ No newline at end of file
diff --git a/Camera2Extensions/utils/build.gradle b/Camera2Extensions/utils/build.gradle
new file mode 100644
index 00000000..c5d4a883
--- /dev/null
+++ b/Camera2Extensions/utils/build.gradle
@@ -0,0 +1,73 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+
+android {
+    compileSdkVersion 29
+
+    defaultConfig {
+        minSdkVersion 21
+        targetSdkVersion 29
+
+        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+        consumerProguardFiles 'consumer-rules.pro'
+    }
+
+    compileOptions {
+        sourceCompatibility rootProject.ext.java_version
+        targetCompatibility rootProject.ext.java_version
+    }
+
+    kotlinOptions {
+        jvmTarget = "$rootProject.ext.java_version"
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+        }
+    }
+}
+
+dependencies {
+
+    // Kotlin lang
+    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
+    implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.4'
+
+    // App compat and UI things
+    implementation 'androidx.appcompat:appcompat:1.1.0'
+    implementation 'androidx.recyclerview:recyclerview:1.1.0'
+
+    // EXIF Interface
+    implementation 'androidx.exifinterface:exifinterface:1.2.0'
+
+    // Unit testing
+    testImplementation 'androidx.test.ext:junit:1.1.1'
+    testImplementation 'androidx.test:rules:1.2.0'
+    testImplementation 'androidx.test:runner:1.2.0'
+    testImplementation 'androidx.test.espresso:espresso-core:3.2.0'
+    testImplementation 'org.robolectric:robolectric:4.3.1'
+
+    // Instrumented testing
+    androidTestImplementation 'androidx.test.ext:junit:1.1.1'
+    androidTestImplementation 'androidx.test:rules:1.2.0'
+    androidTestImplementation 'androidx.test:runner:1.2.0'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.2.0'
+}
diff --git a/Camera2Extensions/utils/src/main/AndroidManifest.xml b/Camera2Extensions/utils/src/main/AndroidManifest.xml
new file mode 100644
index 00000000..2e13c37a
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/AndroidManifest.xml
@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  ~ Copyright 2020 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<manifest package="com.example.android.camera.utils" />
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/AutoFitSurfaceView.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/AutoFitSurfaceView.kt
new file mode 100644
index 00000000..3d900d19
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/AutoFitSurfaceView.kt
@@ -0,0 +1,79 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.content.Context
+import android.util.AttributeSet
+import android.util.Log
+import android.view.SurfaceView
+import kotlin.math.roundToInt
+
+/**
+ * A [SurfaceView] that can be adjusted to a specified aspect ratio and
+ * performs center-crop transformation of input frames.
+ */
+class AutoFitSurfaceView @JvmOverloads constructor(
+        context: Context,
+        attrs: AttributeSet? = null,
+        defStyle: Int = 0
+) : SurfaceView(context, attrs, defStyle) {
+
+    private var aspectRatio = 0f
+
+    /**
+     * Sets the aspect ratio for this view. The size of the view will be
+     * measured based on the ratio calculated from the parameters.
+     *
+     * @param width  Camera resolution horizontal size
+     * @param height Camera resolution vertical size
+     */
+    fun setAspectRatio(width: Int, height: Int) {
+        require(width > 0 && height > 0) { "Size cannot be negative" }
+        aspectRatio = width.toFloat() / height.toFloat()
+        holder.setFixedSize(width, height)
+        requestLayout()
+    }
+
+    override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
+        super.onMeasure(widthMeasureSpec, heightMeasureSpec)
+        val width = MeasureSpec.getSize(widthMeasureSpec)
+        val height = MeasureSpec.getSize(heightMeasureSpec)
+        if (aspectRatio == 0f) {
+            setMeasuredDimension(width, height)
+        } else {
+
+            // Performs center-crop transformation of the camera frames
+            val newWidth: Int
+            val newHeight: Int
+            val actualRatio = if (width > height) aspectRatio else 1f / aspectRatio
+            if (width < height * actualRatio) {
+                newHeight = height
+                newWidth = (height * actualRatio).roundToInt()
+            } else {
+                newWidth = width
+                newHeight = (width / actualRatio).roundToInt()
+            }
+
+            Log.d(TAG, "Measured dimensions set: $newWidth x $newHeight")
+            setMeasuredDimension(newWidth, newHeight)
+        }
+    }
+
+    companion object {
+        private val TAG = AutoFitSurfaceView::class.java.simpleName
+    }
+}
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/CameraSizes.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/CameraSizes.kt
new file mode 100644
index 00000000..6db01d31
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/CameraSizes.kt
@@ -0,0 +1,79 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.graphics.Point
+import android.hardware.camera2.CameraCharacteristics
+import android.hardware.camera2.params.StreamConfigurationMap
+import android.util.Size
+import android.view.Display
+import kotlin.math.max
+import kotlin.math.min
+
+/** Helper class used to pre-compute shortest and longest sides of a [Size] */
+class SmartSize(width: Int, height: Int) {
+    var size = Size(width, height)
+    var long = max(size.width, size.height)
+    var short = min(size.width, size.height)
+    override fun toString() = "SmartSize(${long}x${short})"
+}
+
+/** Standard High Definition size for pictures and video */
+val SIZE_1080P: SmartSize = SmartSize(1920, 1080)
+
+/** Returns a [SmartSize] object for the given [Display] */
+fun getDisplaySmartSize(display: Display): SmartSize {
+    val outPoint = Point()
+    display.getRealSize(outPoint)
+    return SmartSize(outPoint.x, outPoint.y)
+}
+
+/**
+ * Returns the largest available PREVIEW size. For more information, see:
+ * https://d.android.com/reference/android/hardware/camera2/CameraDevice and
+ * https://developer.android.com/reference/android/hardware/camera2/params/StreamConfigurationMap
+ */
+fun <T>getPreviewOutputSize(
+        display: Display,
+        characteristics: CameraCharacteristics,
+        targetClass: Class<T>,
+        format: Int? = null
+): Size {
+
+    // Find which is smaller: screen or 1080p
+    val screenSize = getDisplaySmartSize(display)
+    val hdScreen = screenSize.long >= SIZE_1080P.long || screenSize.short >= SIZE_1080P.short
+    val maxSize = if (hdScreen) SIZE_1080P else screenSize
+
+    // If image format is provided, use it to determine supported sizes; else use target class
+    val config = characteristics.get(
+            CameraCharacteristics.SCALER_STREAM_CONFIGURATION_MAP)!!
+    if (format == null)
+        assert(StreamConfigurationMap.isOutputSupportedFor(targetClass))
+    else
+        assert(config.isOutputSupportedFor(format))
+    val allSizes = if (format == null)
+        config.getOutputSizes(targetClass) else config.getOutputSizes(format)
+
+    // Get available sizes and sort them by area from largest to smallest
+    val validSizes = allSizes
+            .sortedWith(compareBy { it.height * it.width })
+            .map { SmartSize(it.width, it.height) }.reversed()
+
+    // Then, get the largest output size that is smaller or equal than our max size
+    return validSizes.first { it.long <= maxSize.long && it.short <= maxSize.short }.size
+}
\ No newline at end of file
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/ExifUtils.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/ExifUtils.kt
new file mode 100644
index 00000000..561c14b3
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/ExifUtils.kt
@@ -0,0 +1,73 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.graphics.Bitmap
+import android.graphics.Matrix
+import android.util.Log
+import androidx.exifinterface.media.ExifInterface
+
+private const val TAG: String = "ExifUtils"
+
+/** Transforms rotation and mirroring information into one of the [ExifInterface] constants */
+fun computeExifOrientation(rotationDegrees: Int, mirrored: Boolean) = when {
+    rotationDegrees == 0 && !mirrored -> ExifInterface.ORIENTATION_NORMAL
+    rotationDegrees == 0 && mirrored -> ExifInterface.ORIENTATION_FLIP_HORIZONTAL
+    rotationDegrees == 180 && !mirrored -> ExifInterface.ORIENTATION_ROTATE_180
+    rotationDegrees == 180 && mirrored -> ExifInterface.ORIENTATION_FLIP_VERTICAL
+    rotationDegrees == 270 && mirrored -> ExifInterface.ORIENTATION_TRANSVERSE
+    rotationDegrees == 90 && !mirrored -> ExifInterface.ORIENTATION_ROTATE_90
+    rotationDegrees == 90 && mirrored -> ExifInterface.ORIENTATION_TRANSPOSE
+    rotationDegrees == 270 && mirrored -> ExifInterface.ORIENTATION_ROTATE_270
+    rotationDegrees == 270 && !mirrored -> ExifInterface.ORIENTATION_TRANSVERSE
+    else -> ExifInterface.ORIENTATION_UNDEFINED
+}
+
+/**
+ * Helper function used to convert an EXIF orientation enum into a transformation matrix
+ * that can be applied to a bitmap.
+ *
+ * @return matrix - Transformation required to properly display [Bitmap]
+ */
+fun decodeExifOrientation(exifOrientation: Int): Matrix {
+    val matrix = Matrix()
+
+    // Apply transformation corresponding to declared EXIF orientation
+    when (exifOrientation) {
+        ExifInterface.ORIENTATION_NORMAL -> Unit
+        ExifInterface.ORIENTATION_UNDEFINED -> Unit
+        ExifInterface.ORIENTATION_ROTATE_90 -> matrix.postRotate(90F)
+        ExifInterface.ORIENTATION_ROTATE_180 -> matrix.postRotate(180F)
+        ExifInterface.ORIENTATION_ROTATE_270 -> matrix.postRotate(270F)
+        ExifInterface.ORIENTATION_FLIP_HORIZONTAL -> matrix.postScale(-1F, 1F)
+        ExifInterface.ORIENTATION_FLIP_VERTICAL -> matrix.postScale(1F, -1F)
+        ExifInterface.ORIENTATION_TRANSPOSE -> {
+            matrix.postScale(-1F, 1F)
+            matrix.postRotate(270F)
+        }
+        ExifInterface.ORIENTATION_TRANSVERSE -> {
+            matrix.postScale(-1F, 1F)
+            matrix.postRotate(90F)
+        }
+
+        // Error out if the EXIF orientation is invalid
+        else -> Log.e(TAG, "Invalid orientation: $exifOrientation")
+    }
+
+    // Return the resulting matrix
+    return matrix
+}
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/GenericListAdapter.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/GenericListAdapter.kt
new file mode 100644
index 00000000..a55af278
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/GenericListAdapter.kt
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import androidx.recyclerview.widget.RecyclerView
+
+/** Type helper used for the callback triggered once our view has been bound */
+typealias BindCallback<T> = (view: View, data: T, position: Int) -> Unit
+
+/** List adapter for generic types, intended used for small-medium lists of data */
+class GenericListAdapter<T>(
+        private val dataset: List<T>,
+        private val itemLayoutId: Int? = null,
+        private val itemViewFactory: (() -> View)? = null,
+        private val onBind: BindCallback<T>
+) : RecyclerView.Adapter<GenericListAdapter.GenericListViewHolder>() {
+
+    class GenericListViewHolder(val view: View) : RecyclerView.ViewHolder(view)
+
+    override fun onCreateViewHolder(parent: ViewGroup, viewType: Int) = GenericListViewHolder(when {
+        itemViewFactory != null -> itemViewFactory.invoke()
+        itemLayoutId != null -> {
+            LayoutInflater.from(parent.context)
+                    .inflate(itemLayoutId, parent, false)
+        }
+        else -> {
+            throw IllegalStateException(
+                    "Either the layout ID or the view factory need to be non-null")
+        }
+    })
+
+    override fun onBindViewHolder(holder: GenericListViewHolder, position: Int) {
+        if (position < 0 || position > dataset.size) return
+        onBind(holder.view, dataset[position], position)
+    }
+
+    override fun getItemCount() = dataset.size
+}
\ No newline at end of file
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/OrientationLiveData.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/OrientationLiveData.kt
new file mode 100644
index 00000000..f9d9a470
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/OrientationLiveData.kt
@@ -0,0 +1,95 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.content.Context
+import android.hardware.camera2.CameraCharacteristics
+import android.view.OrientationEventListener
+import android.view.Surface
+import androidx.lifecycle.LiveData
+
+
+/**
+ * Calculates closest 90-degree orientation to compensate for the device
+ * rotation relative to sensor orientation, i.e., allows user to see camera
+ * frames with the expected orientation.
+ */
+class OrientationLiveData(
+        context: Context,
+        characteristics: CameraCharacteristics
+): LiveData<Int>() {
+
+    private val listener = object : OrientationEventListener(context.applicationContext) {
+        override fun onOrientationChanged(orientation: Int) {
+            val rotation = when {
+                orientation <= 45 -> Surface.ROTATION_0
+                orientation <= 135 -> Surface.ROTATION_90
+                orientation <= 225 -> Surface.ROTATION_180
+                orientation <= 315 -> Surface.ROTATION_270
+                else -> Surface.ROTATION_0
+            }
+            val relative = computeRelativeRotation(characteristics, rotation)
+            if (relative != value) postValue(relative)
+        }
+    }
+
+    override fun onActive() {
+        super.onActive()
+        listener.enable()
+    }
+
+    override fun onInactive() {
+        super.onInactive()
+        listener.disable()
+    }
+
+    companion object {
+
+        /**
+         * Computes rotation required to transform from the camera sensor orientation to the
+         * device's current orientation in degrees.
+         *
+         * @param characteristics the [CameraCharacteristics] to query for the sensor orientation.
+         * @param surfaceRotation the current device orientation as a Surface constant
+         * @return the relative rotation from the camera sensor to the current device orientation.
+         */
+        @JvmStatic
+        private fun computeRelativeRotation(
+                characteristics: CameraCharacteristics,
+                surfaceRotation: Int
+        ): Int {
+            val sensorOrientationDegrees =
+                    characteristics.get(CameraCharacteristics.SENSOR_ORIENTATION)!!
+
+            val deviceOrientationDegrees = when (surfaceRotation) {
+                Surface.ROTATION_0 -> 0
+                Surface.ROTATION_90 -> 90
+                Surface.ROTATION_180 -> 180
+                Surface.ROTATION_270 -> 270
+                else -> 0
+            }
+
+            // Reverse device orientation for front-facing cameras
+            val sign = if (characteristics.get(CameraCharacteristics.LENS_FACING) ==
+                    CameraCharacteristics.LENS_FACING_FRONT) 1 else -1
+
+            // Calculate desired JPEG orientation relative to camera orientation to make
+            // the image upright relative to the device orientation
+            return (sensorOrientationDegrees - (deviceOrientationDegrees * sign) + 360) % 360
+        }
+    }
+}
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/Yuv.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/Yuv.kt
new file mode 100644
index 00000000..c476ad0e
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/Yuv.kt
@@ -0,0 +1,191 @@
+package com.example.android.camera.utils
+
+import android.graphics.ImageFormat
+import android.media.Image
+import androidx.annotation.IntDef
+import java.nio.ByteBuffer
+
+/*
+This file is converted from part of https://github.com/gordinmitya/yuv2buf.
+Follow the link to find demo app, performance benchmarks and unit tests.
+
+Intro to YUV image formats:
+YUV_420_888 - is a generic format that can be represented as I420, YV12, NV21, and NV12.
+420 means that for each 4 luminosity pixels we have 2 chroma pixels: U and V.
+
+* I420 format represents an image as Y plane followed by U then followed by V plane
+    without chroma channels interleaving.
+    For example:
+    Y Y Y Y
+    Y Y Y Y
+    U U V V
+
+* NV21 format represents an image as Y plane followed by V and U interleaved. First V then U.
+    For example:
+    Y Y Y Y
+    Y Y Y Y
+    V U V U
+
+* YV12 and NV12 are the same as previous formats but with swapped order of V and U. (U then V)
+
+Visualization of these 4 formats:
+https://user-images.githubusercontent.com/9286092/89119601-4f6f8100-d4b8-11ea-9a51-2765f7e513c2.jpg
+
+It's guaranteed that image.getPlanes() always returns planes in order Y U V for YUV_420_888.
+https://developer.android.com/reference/android/graphics/ImageFormat#YUV_420_888
+
+Because I420 and NV21 are more widely supported (RenderScript, OpenCV, MNN)
+the conversion is done into these formats.
+
+More about each format: https://www.fourcc.org/yuv.php
+*/
+
+@kotlin.annotation.Retention(AnnotationRetention.SOURCE)
+@IntDef(ImageFormat.NV21, ImageFormat.YUV_420_888)
+annotation class YuvType
+
+class YuvByteBuffer(image: Image, dstBuffer: ByteBuffer? = null) {
+    @YuvType
+    val type: Int
+    val buffer: ByteBuffer
+
+    init {
+        val wrappedImage = ImageWrapper(image)
+
+        type = if (wrappedImage.u.pixelStride == 1) {
+            ImageFormat.YUV_420_888
+        } else {
+            ImageFormat.NV21
+        }
+        val size = image.width * image.height * 3 / 2
+        buffer = if (
+            dstBuffer == null || dstBuffer.capacity() < size ||
+            dstBuffer.isReadOnly || !dstBuffer.isDirect
+        ) {
+            ByteBuffer.allocateDirect(size) }
+        else {
+            dstBuffer
+        }
+        buffer.rewind()
+
+        removePadding(wrappedImage)
+    }
+
+    // Input buffers are always direct as described in
+    // https://developer.android.com/reference/android/media/Image.Plane#getBuffer()
+    private fun removePadding(image: ImageWrapper) {
+        val sizeLuma = image.y.width * image.y.height
+        val sizeChroma = image.u.width * image.u.height
+        if (image.y.rowStride > image.y.width) {
+            removePaddingCompact(image.y, buffer, 0)
+        } else {
+            buffer.position(0)
+            buffer.put(image.y.buffer)
+        }
+        if (type == ImageFormat.YUV_420_888) {
+            if (image.u.rowStride > image.u.width) {
+                removePaddingCompact(image.u, buffer, sizeLuma)
+                removePaddingCompact(image.v, buffer, sizeLuma + sizeChroma)
+            } else {
+                buffer.position(sizeLuma)
+                buffer.put(image.u.buffer)
+                buffer.position(sizeLuma + sizeChroma)
+                buffer.put(image.v.buffer)
+            }
+        } else {
+            if (image.u.rowStride > image.u.width * 2) {
+                removePaddingNotCompact(image, buffer, sizeLuma)
+            } else {
+                buffer.position(sizeLuma)
+                var uv = image.v.buffer
+                val properUVSize = image.v.height * image.v.rowStride - 1
+                if (uv.capacity() > properUVSize) {
+                    uv = clipBuffer(image.v.buffer, 0, properUVSize)
+                }
+                buffer.put(uv)
+                val lastOne = image.u.buffer[image.u.buffer.capacity() - 1]
+                buffer.put(buffer.capacity() - 1, lastOne)
+            }
+        }
+        buffer.rewind()
+    }
+
+    private fun removePaddingCompact(
+        plane: PlaneWrapper,
+        dst: ByteBuffer,
+        offset: Int
+    ) {
+        require(plane.pixelStride == 1) {
+            "use removePaddingCompact with pixelStride == 1"
+        }
+
+        val src = plane.buffer
+        val rowStride = plane.rowStride
+        var row: ByteBuffer
+        dst.position(offset)
+        for (i in 0 until plane.height) {
+            row = clipBuffer(src, i * rowStride, plane.width)
+            dst.put(row)
+        }
+    }
+
+    private fun removePaddingNotCompact(
+        image: ImageWrapper,
+        dst: ByteBuffer,
+        offset: Int
+    ) {
+        require(image.u.pixelStride == 2) {
+            "use removePaddingNotCompact pixelStride == 2"
+        }
+        val width = image.u.width
+        val height = image.u.height
+        val rowStride = image.u.rowStride
+        var row: ByteBuffer
+        dst.position(offset)
+        for (i in 0 until height - 1) {
+            row = clipBuffer(image.v.buffer, i * rowStride, width * 2)
+            dst.put(row)
+        }
+        row = clipBuffer(image.u.buffer, (height - 1) * rowStride - 1, width * 2)
+        dst.put(row)
+    }
+
+    private fun clipBuffer(buffer: ByteBuffer, start: Int, size: Int): ByteBuffer {
+        val duplicate = buffer.duplicate()
+        duplicate.position(start)
+        duplicate.limit(start + size)
+        return duplicate.slice()
+    }
+
+    private class ImageWrapper(image:Image) {
+        val width= image.width
+        val height = image.height
+        val y = PlaneWrapper(width, height, image.planes[0])
+        val u = PlaneWrapper(width / 2, height / 2, image.planes[1])
+        val v = PlaneWrapper(width / 2, height / 2, image.planes[2])
+
+        // Check this is a supported image format
+        // https://developer.android.com/reference/android/graphics/ImageFormat#YUV_420_888
+        init {
+            require(y.pixelStride == 1) {
+                "Pixel stride for Y plane must be 1 but got ${y.pixelStride} instead."
+            }
+            require(u.pixelStride == v.pixelStride && u.rowStride == v.rowStride) {
+                "U and V planes must have the same pixel and row strides " +
+                "but got pixel=${u.pixelStride} row=${u.rowStride} for U " +
+                "and pixel=${v.pixelStride} and row=${v.rowStride} for V"
+            }
+            require(u.pixelStride == 1 || u.pixelStride == 2) {
+                "Supported" + " pixel strides for U and V planes are 1 and 2"
+            }
+        }
+    }
+
+    private class PlaneWrapper(width: Int, height: Int, plane: Image.Plane) {
+        val width = width
+        val height = height
+        val buffer: ByteBuffer = plane.buffer
+        val rowStride = plane.rowStride
+        val pixelStride = plane.pixelStride
+    }
+}
\ No newline at end of file
diff --git a/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/YuvToRgbConverter.kt b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/YuvToRgbConverter.kt
new file mode 100644
index 00000000..8dcd5596
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/java/com/example/android/camera/utils/YuvToRgbConverter.kt
@@ -0,0 +1,99 @@
+/*
+ * Copyright 2020 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera.utils
+
+import android.content.Context
+import android.graphics.Bitmap
+import android.graphics.ImageFormat
+import android.media.Image
+import android.renderscript.Allocation
+import android.renderscript.Element
+import android.renderscript.RenderScript
+import android.renderscript.ScriptIntrinsicYuvToRGB
+import android.renderscript.Type
+import java.nio.ByteBuffer
+
+/**
+ * Helper class used to convert a [Image] object from
+ * [ImageFormat.YUV_420_888] format to an RGB [Bitmap] object, it has equivalent
+ * functionality to https://github
+ * .com/androidx/androidx/blob/androidx-main/camera/camera-core/src/main/java/androidx/camera/core/ImageYuvToRgbConverter.java
+ *
+ * NOTE: This has been tested in a limited number of devices and is not
+ * considered production-ready code. It was created for illustration purposes,
+ * since this is not an efficient camera pipeline due to the multiple copies
+ * required to convert each frame. For example, this
+ * implementation
+ * (https://stackoverflow.com/questions/52726002/camera2-captured-picture-conversion-from-yuv-420-888-to-nv21/52740776#52740776)
+ * might have better performance.
+ */
+class YuvToRgbConverter(context: Context) {
+    private val rs = RenderScript.create(context)
+    private val scriptYuvToRgb =
+        ScriptIntrinsicYuvToRGB.create(rs, Element.U8_4(rs))
+
+    // Do not add getters/setters functions to these private variables
+    // because yuvToRgb() assume they won't be modified elsewhere
+    private var yuvBits: ByteBuffer? = null
+    private var bytes: ByteArray = ByteArray(0)
+    private var inputAllocation: Allocation? = null
+    private var outputAllocation: Allocation? = null
+
+    @Synchronized
+    fun yuvToRgb(image: Image, output: Bitmap) {
+        val yuvBuffer = YuvByteBuffer(image, yuvBits)
+        yuvBits = yuvBuffer.buffer
+
+        if (needCreateAllocations(image, yuvBuffer)) {
+            val yuvType = Type.Builder(rs, Element.U8(rs))
+                .setX(image.width)
+                .setY(image.height)
+                .setYuvFormat(yuvBuffer.type)
+            inputAllocation = Allocation.createTyped(
+                rs,
+                yuvType.create(),
+                Allocation.USAGE_SCRIPT
+            )
+            bytes = ByteArray(yuvBuffer.buffer.capacity())
+            val rgbaType = Type.Builder(rs, Element.RGBA_8888(rs))
+                .setX(image.width)
+                .setY(image.height)
+            outputAllocation = Allocation.createTyped(
+                rs,
+                rgbaType.create(),
+                Allocation.USAGE_SCRIPT
+            )
+        }
+
+        yuvBuffer.buffer.get(bytes)
+        inputAllocation!!.copyFrom(bytes)
+
+        // Convert NV21 or YUV_420_888 format to RGB
+        inputAllocation!!.copyFrom(bytes)
+        scriptYuvToRgb.setInput(inputAllocation)
+        scriptYuvToRgb.forEach(outputAllocation)
+        outputAllocation!!.copyTo(output)
+    }
+
+    private fun needCreateAllocations(image: Image, yuvBuffer: YuvByteBuffer): Boolean {
+        return (inputAllocation == null ||               // the very 1st call
+            inputAllocation!!.type.x != image.width ||   // image size changed
+            inputAllocation!!.type.y != image.height ||
+            inputAllocation!!.type.yuv != yuvBuffer.type || // image format changed
+            bytes.size == yuvBuffer.buffer.capacity())
+    }
+}
diff --git a/Camera2Extensions/utils/src/main/res/drawable/ic_shutter.xml b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter.xml
new file mode 100644
index 00000000..9bb91ab8
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2020 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+    <item android:state_pressed="true" android:drawable="@drawable/ic_shutter_pressed" />
+    <item android:state_focused="true" android:drawable="@drawable/ic_shutter_focused" />
+    <item android:drawable="@drawable/ic_shutter_normal" />
+</selector>
\ No newline at end of file
diff --git a/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_focused.xml b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_focused.xml
new file mode 100644
index 00000000..9bf521da
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_focused.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2020 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="74"
+    android:viewportHeight="74">
+    <path android:fillColor="#FFFFFF" android:fillType="evenOdd"
+        android:pathData="M73.1,37C73.1,17.0637 56.9373,0.9 37,0.9C17.0627,0.9 0.9,17.0637 0.9,37C0.9,56.9373 17.0627,73.1 37,73.1C56.9373,73.1 73.1,56.9373 73.1,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+    <path android:fillColor="#58A0C4" android:fillType="evenOdd"
+        android:pathData="M67.4,37C67.4,53.7895 53.7895,67.4 37,67.4C20.2105,67.4 6.6,53.7895 6.6,37C6.6,20.2105 20.2105,6.6 37,6.6C53.7895,6.6 67.4,20.2105 67.4,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+</vector>
diff --git a/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_normal.xml b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_normal.xml
new file mode 100644
index 00000000..cb50026e
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_normal.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2020 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="74"
+    android:viewportHeight="74">
+    <path android:fillColor="#FFFFFF" android:fillType="evenOdd"
+        android:pathData="M73.1,37C73.1,17.0637 56.9373,0.9 37,0.9C17.0627,0.9 0.9,17.0637 0.9,37C0.9,56.9373 17.0627,73.1 37,73.1C56.9373,73.1 73.1,56.9373 73.1,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+    <path android:fillColor="#CFD7DB" android:fillType="evenOdd"
+        android:pathData="M67.4,37C67.4,53.7895 53.7895,67.4 37,67.4C20.2105,67.4 6.6,53.7895 6.6,37C6.6,20.2105 20.2105,6.6 37,6.6C53.7895,6.6 67.4,20.2105 67.4,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+</vector>
diff --git a/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_pressed.xml b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_pressed.xml
new file mode 100644
index 00000000..9bf521da
--- /dev/null
+++ b/Camera2Extensions/utils/src/main/res/drawable/ic_shutter_pressed.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+  ~ Copyright 2020 The Android Open Source Project
+  ~
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
+  ~
+  ~     https://www.apache.org/licenses/LICENSE-2.0
+  ~
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
+  -->
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+    android:width="24dp"
+    android:height="24dp"
+    android:viewportWidth="74"
+    android:viewportHeight="74">
+    <path android:fillColor="#FFFFFF" android:fillType="evenOdd"
+        android:pathData="M73.1,37C73.1,17.0637 56.9373,0.9 37,0.9C17.0627,0.9 0.9,17.0637 0.9,37C0.9,56.9373 17.0627,73.1 37,73.1C56.9373,73.1 73.1,56.9373 73.1,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+    <path android:fillColor="#58A0C4" android:fillType="evenOdd"
+        android:pathData="M67.4,37C67.4,53.7895 53.7895,67.4 37,67.4C20.2105,67.4 6.6,53.7895 6.6,37C6.6,20.2105 20.2105,6.6 37,6.6C53.7895,6.6 67.4,20.2105 67.4,37"
+        android:strokeColor="#00000000" android:strokeWidth="1"/>
+</vector>

From 0db56e025115445b1484f0f7c07d0bac2f1efece Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Tue, 24 Oct 2023 17:23:25 -0700
Subject: [PATCH 04/22] Fix crash on Samsung phones when compiling the HDR
 fragment shaders

Not all phones compile these the same way, and some are more strict
about the #extension macro than others.

Bug: 307621381
Test: Tested HDR capture with MediaCodec / MediaRecorder.
Change-Id: I0dfaaa5cbb2e5e4a37bb5aa17ed9c91287d8140d
---
 .../android/camera2/video/HardwarePipeline.kt        | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index d4f24e20..c3b7dc29 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -170,7 +170,7 @@ void main() {
 
 /** Passthrough fragment shader, simply copies from the source texture */
 private val PASSTHROUGH_FSHADER = """
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 varying vec2 vTextureCoord;
 uniform samplerExternalOES sTexture;
@@ -180,7 +180,7 @@ void main() {
 """
 
 private val PASSTHROUGH_HDR_FSHADER = """#version 300 es
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 in vec2 vTextureCoord;
 uniform samplerExternalOES sTexture;
@@ -192,7 +192,7 @@ void main() {
 
 private val YUV_TO_RGB_PASSTHROUGH_HDR_FSHADER = """#version 300 es
 #extension GL_EXT_YUV_target : require
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 uniform __samplerExternal2DY2YEXT sTexture;
 in vec2 vTextureCoord;
@@ -208,7 +208,7 @@ void main() {
 
 private val YUV_TO_RGB_PORTRAIT_HDR_FSHADER = """#version 300 es
 #extension GL_EXT_YUV_target : require
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 uniform __samplerExternal2DY2YEXT sTexture;
 in vec2 vTextureCoord;
@@ -260,7 +260,7 @@ void main() {
 """
 
 private val HLG_TO_LINEAR_HDR_FSHADER = """#version 300 es
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 uniform samplerExternalOES sTexture;
 in vec2 vTextureCoord;
@@ -278,7 +278,7 @@ void main() {
 """
 
 private val HLG_TO_PQ_HDR_FSHADER = """#version 300 es
-#extension GL_OES_EGL_image_external : require
+#extension GL_OES_EGL_image_external_essl3 : require
 precision mediump float;
 uniform samplerExternalOES sTexture;
 in vec2 vTextureCoord;

From 1ccae7d062e5eed19ec6514d528fe9a0ec631eba Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Tue, 24 Oct 2023 18:26:42 -0700
Subject: [PATCH 05/22] Remove essl3 suffix from SDR shader

This was added by accident.

Bug: b/307621381
Test: Tested both HDR and SDR paths.
Change-Id: Idaf6b0eabae6024d71e7b3d668e2a00bb83469ae
---
 .../java/com/example/android/camera2/video/HardwarePipeline.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index c3b7dc29..5d523930 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -170,7 +170,7 @@ void main() {
 
 /** Passthrough fragment shader, simply copies from the source texture */
 private val PASSTHROUGH_FSHADER = """
-#extension GL_OES_EGL_image_external_essl3 : require
+#extension GL_OES_EGL_image_external : require
 precision mediump float;
 varying vec2 vTextureCoord;
 uniform samplerExternalOES sTexture;

From 270fd2b1cde8b9c5d4e65df3e301299c17674b96 Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Wed, 25 Oct 2023 11:39:28 -0700
Subject: [PATCH 06/22] Camera2Video: Fix stability issues due to race
 conditions

The app is not waiting for rendering / encoding operations to complete
before the preview fragment ends. This leads to exceptions in render /
encode, and an app crash.

Bug: 307767427
Test: Ran Camera2Video down various paths, observed no crashes.
Change-Id: I1896fa7753ddf8c1e9022fffb1719fdd8ed7ee43
---
 .../android/camera2/video/HardwarePipeline.kt | 47 +++++++++++++++----
 .../video/fragments/PreviewFragment.kt        |  6 ++-
 2 files changed, 42 insertions(+), 11 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index 5d523930..86f1dd3f 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -388,6 +388,7 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
     override fun destroyWindowSurface() {
         renderHandler.sendMessage(renderHandler.obtainMessage(
                 RenderHandler.MSG_DESTROY_WINDOW_SURFACE))
+        renderHandler.waitDestroyWindowSurface()
     }
 
     override fun setPreviewSize(previewSize: Size) {
@@ -415,11 +416,13 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
     override fun clearFrameListener() {
         renderHandler.sendMessage(renderHandler.obtainMessage(
                 RenderHandler.MSG_CLEAR_FRAME_LISTENER))
+        renderHandler.waitClearFrameListener()
     }
 
     override fun cleanup() {
         renderHandler.sendMessage(renderHandler.obtainMessage(
                 RenderHandler.MSG_CLEANUP))
+        renderHandler.waitCleanup()
     }
 
     private class ShaderProgram(id: Int,
@@ -513,9 +516,9 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         private var eglDisplay = EGL14.EGL_NO_DISPLAY
         private var eglContext = EGL14.EGL_NO_CONTEXT
         private var eglConfig: EGLConfig? = null
-        private var eglRenderSurface: EGLSurface? = null
-        private var eglEncoderSurface: EGLSurface? = null
-        private var eglWindowSurface: EGLSurface? = null
+        private var eglRenderSurface: EGLSurface = EGL14.EGL_NO_SURFACE
+        private var eglEncoderSurface: EGLSurface = EGL14.EGL_NO_SURFACE
+        private var eglWindowSurface: EGLSurface = EGL14.EGL_NO_SURFACE
         private var vertexShader = 0
         private var cameraToRenderFragmentShader = 0
         private var renderToPreviewFragmentShader = 0
@@ -526,6 +529,9 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         private var renderToEncodeShaderProgram: ShaderProgram? = null
 
         private val cvResourcesCreated = ConditionVariable(false)
+        private val cvDestroyWindowSurface = ConditionVariable(false)
+        private val cvClearFrameListener = ConditionVariable(false)
+        private val cvCleanup = ConditionVariable(false)
 
         public fun startRecording() {
             currentlyRecording = true
@@ -865,7 +871,12 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
 
         private fun destroyWindowSurface() {
             EGL14.eglDestroySurface(eglDisplay, eglWindowSurface)
-            eglWindowSurface = null
+            eglWindowSurface = EGL14.EGL_NO_SURFACE
+            cvDestroyWindowSurface.open()
+        }
+
+        public fun waitDestroyWindowSurface() {
+            cvDestroyWindowSurface.block()
         }
 
         private fun copyTexture(texId: Int, texture: SurfaceTexture, viewportRect: Rect,
@@ -964,36 +975,54 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
 
         private fun clearFrameListener() {
             cameraTexture.setOnFrameAvailableListener(null)
+            cvClearFrameListener.open()
+        }
+
+        public fun waitClearFrameListener() {
+            cvClearFrameListener.block()
         }
 
         private fun cleanup() {
             EGL14.eglDestroySurface(eglDisplay, eglEncoderSurface)
-            eglEncoderSurface = null
+            eglEncoderSurface = EGL14.EGL_NO_SURFACE
             EGL14.eglDestroySurface(eglDisplay, eglRenderSurface)
-            eglRenderSurface = null
+            eglRenderSurface = EGL14.EGL_NO_SURFACE
 
             cameraTexture.release()
 
             EGL14.eglDestroyContext(eglDisplay, eglContext)
+
+            eglDisplay = EGL14.EGL_NO_DISPLAY
+            eglContext = EGL14.EGL_NO_CONTEXT
+
+            cvCleanup.open()
+        }
+
+        public fun waitCleanup() {
+            cvCleanup.block()
         }
 
         @Suppress("UNUSED_PARAMETER")
         private fun onFrameAvailableImpl(surfaceTexture: SurfaceTexture) {
+            if (eglContext == EGL14.EGL_NO_CONTEXT) {
+                return
+            }
+
             /** The camera API does not update the tex image. Do so here. */
             cameraTexture.updateTexImage()
 
             /** Copy from the camera texture to the render texture */
-            if (eglRenderSurface != null) {
+            if (eglRenderSurface != EGL14.EGL_NO_SURFACE) {
                 copyCameraToRender()
             }
 
             /** Copy from the render texture to the TextureView */
-            if (eglWindowSurface != null) {
+            if (eglWindowSurface != EGL14.EGL_NO_SURFACE) {
                 copyRenderToPreview()
             }
 
             /** Copy to the encoder surface if we're currently recording. */
-            if (eglEncoderSurface != null && currentlyRecording) {
+            if (eglEncoderSurface != EGL14.EGL_NO_SURFACE && currentlyRecording) {
                 copyRenderToEncode()
             }
         }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index 4e97380b..de63697b 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -376,11 +376,11 @@ class PreviewFragment : Fragment() {
 
                     delay(CameraActivity.ANIMATION_SLOW_MILLIS)
 
+                    pipeline.cleanup()
+
                     Log.d(TAG, "Recording stopped. Output file: $outputFile")
                     encoder.shutdown()
 
-                    pipeline.cleanup()
-
                     // Broadcasts the media file to the rest of the system
                     MediaScannerConnection.scanFile(
                             requireView().context, arrayOf(outputFile.absolutePath), null, null)
@@ -512,6 +512,8 @@ class PreviewFragment : Fragment() {
 
     override fun onDestroy() {
         super.onDestroy()
+        pipeline.clearFrameListener()
+        pipeline.cleanup()
         cameraThread.quitSafely()
         encoderSurface.release()
     }

From 12a5686914596002412b5c44262950aa15b3ddeb Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Sun, 29 Oct 2023 23:30:26 -0700
Subject: [PATCH 07/22] [HDR Video] Change the UX when recording a video

1. Remove the overlay flash animation
2. Add a timer for recording
3. Change the recording button color to RED when recording starts and to GRAY when recording stops
4. Check the recorded file existing before playback

Bug: b/308369542
Test: Run on Samsung s23 Ultra and Pixel 8
Change-Id: I5613fd4c4d983eb88a35127bdd3b5ff7eba173d8
---
 .../video/fragments/PreviewFragment.kt        | 89 +++++++++----------
 .../src/main/res/layout/fragment_preview.xml  |  9 ++
 .../app/src/main/res/values/strings.xml       |  1 +
 .../main/res/drawable/ic_shutter_focused.xml  |  6 +-
 .../main/res/drawable/ic_shutter_pressed.xml  |  6 +-
 5 files changed, 59 insertions(+), 52 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index de63697b..57d1f92c 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -20,29 +20,24 @@ import android.annotation.SuppressLint
 import android.content.Context
 import android.content.Intent
 import android.content.pm.ActivityInfo
-import android.graphics.Color
 import android.graphics.ColorSpace
 import android.hardware.camera2.CameraCaptureSession
 import android.hardware.camera2.CameraCharacteristics
 import android.hardware.camera2.CameraDevice
 import android.hardware.camera2.CameraManager
-import android.hardware.camera2.CameraMetadata
 import android.hardware.camera2.CaptureRequest
 import android.hardware.camera2.TotalCaptureResult
 import android.hardware.camera2.params.ColorSpaceProfiles
 import android.hardware.camera2.params.DynamicRangeProfiles
 import android.hardware.camera2.params.OutputConfiguration
 import android.hardware.camera2.params.SessionConfiguration
-import android.media.MediaCodec
-import android.media.MediaCodecInfo
-import android.media.MediaFormat
 import android.media.MediaScannerConnection
 import android.os.Bundle
 import android.os.ConditionVariable
 import android.os.Handler
 import android.os.HandlerThread
+import android.os.Looper
 import android.util.Log
-import android.util.Range
 import android.view.LayoutInflater
 import android.view.MotionEvent
 import android.view.Surface
@@ -50,18 +45,18 @@ import android.view.SurfaceHolder
 import android.view.View
 import android.view.ViewGroup
 import android.webkit.MimeTypeMap
+import android.widget.Toast
+import androidx.core.content.ContextCompat
 import androidx.core.content.FileProvider
-import androidx.core.graphics.drawable.toDrawable
 import androidx.fragment.app.Fragment
-import androidx.lifecycle.Observer
 import androidx.lifecycle.lifecycleScope
 import androidx.navigation.NavController
 import androidx.navigation.Navigation
 import androidx.navigation.fragment.navArgs
-import com.example.android.camera.utils.OrientationLiveData
 import com.example.android.camera.utils.getPreviewOutputSize
 import com.example.android.camera2.video.BuildConfig
 import com.example.android.camera2.video.CameraActivity
+import com.example.android.camera2.video.EncoderWrapper
 import com.example.android.camera2.video.R
 import com.example.android.camera2.video.databinding.FragmentPreviewBinding
 import kotlinx.coroutines.Dispatchers
@@ -72,16 +67,12 @@ import java.io.File
 import java.text.SimpleDateFormat
 import java.util.Date
 import java.util.Locale
-import kotlin.RuntimeException
+import java.util.concurrent.Executor
+import java.util.concurrent.RejectedExecutionException
 import kotlin.coroutines.resume
 import kotlin.coroutines.resumeWithException
 import kotlin.coroutines.suspendCoroutine
 
-import com.example.android.camera2.video.EncoderWrapper
-
-import java.util.concurrent.Executor
-import java.util.concurrent.RejectedExecutionException
-
 class PreviewFragment : Fragment() {
 
     private class HandlerExecutor(handler: Handler) : Executor {
@@ -147,26 +138,6 @@ class PreviewFragment : Fragment() {
     /** [Handler] corresponding to [cameraThread] */
     private val cameraHandler = Handler(cameraThread.looper)
 
-    /** Performs recording animation of flashing screen */
-    private val animationTask: Runnable by lazy {
-        Runnable {
-            // Flash white animation
-            fragmentBinding.overlay.foreground = Color.argb(150, 255, 255, 255).toDrawable()
-            // Wait for ANIMATION_FAST_MILLIS
-            fragmentBinding.overlay.postDelayed({
-                if (isCurrentlyRecording()) {
-                    // Remove white flash animation
-                    fragmentBinding.overlay.foreground = null
-                    // Restart animation recursively
-                    if (isCurrentlyRecording()) {
-                        fragmentBinding.overlay.postDelayed(animationTask,
-                                CameraActivity.ANIMATION_FAST_MILLIS)
-                    }
-                }
-            }, CameraActivity.ANIMATION_FAST_MILLIS)
-        }
-    }
-
     /** Captures frames from a [CameraDevice] for our video recording */
     private lateinit var session: CameraCaptureSession
 
@@ -344,8 +315,16 @@ class PreviewFragment : Fragment() {
                         recordingStartMillis = System.currentTimeMillis()
                         Log.d(TAG, "Recording started")
 
-                        // Starts recording animation
-                        fragmentBinding.overlay.post(animationTask)
+                        // Set color to RED and show timer when recording begins
+                        fragmentBinding.captureButton.post {
+                            fragmentBinding.captureButton.background =
+                                    context?.let {
+                                        ContextCompat.getDrawable(it,
+                                                R.drawable.ic_shutter_pressed)
+                                    }
+                            fragmentBinding.captureTimer?.visibility = View.VISIBLE
+                            fragmentBinding.captureTimer?.start()
+                        }
                     }
                 }
 
@@ -361,6 +340,17 @@ class PreviewFragment : Fragment() {
                     pipeline.clearFrameListener()
                     fragmentBinding.captureButton.setOnTouchListener(null)
 
+                    // Set color to GRAY and hide timer when recording stops
+                    fragmentBinding.captureButton.post {
+                        fragmentBinding.captureButton.background =
+                                context?.let {
+                                    ContextCompat.getDrawable(it,
+                                            R.drawable.ic_shutter_normal)
+                                }
+                        fragmentBinding.captureTimer?.visibility = View.GONE
+                        fragmentBinding.captureTimer?.stop()
+                    }
+
                     /* Wait until the session signals onReady */
                     cvRecordingComplete.block()
 
@@ -386,15 +376,22 @@ class PreviewFragment : Fragment() {
                             requireView().context, arrayOf(outputFile.absolutePath), null, null)
 
                     // Launch external activity via intent to play video recorded using our provider
-                    startActivity(Intent().apply {
-                        action = Intent.ACTION_VIEW
-                        type = MimeTypeMap.getSingleton()
-                                .getMimeTypeFromExtension(outputFile.extension)
-                        val authority = "${BuildConfig.APPLICATION_ID}.provider"
-                        data = FileProvider.getUriForFile(view.context, authority, outputFile)
-                        flags = Intent.FLAG_GRANT_READ_URI_PERMISSION or
-                                Intent.FLAG_ACTIVITY_CLEAR_TOP
-                    })
+                    if (outputFile.exists()) {
+                        startActivity(Intent().apply {
+                            action = Intent.ACTION_VIEW
+                            type = MimeTypeMap.getSingleton()
+                                    .getMimeTypeFromExtension(outputFile.extension)
+                            val authority = "${BuildConfig.APPLICATION_ID}.provider"
+                            data = FileProvider.getUriForFile(view.context, authority, outputFile)
+                            flags = Intent.FLAG_GRANT_READ_URI_PERMISSION or
+                                    Intent.FLAG_ACTIVITY_CLEAR_TOP
+                        })
+                    } else {
+                        Handler(Looper.getMainLooper()).post {
+                            Toast.makeText(activity, R.string.error_file_not_found,
+                                    Toast.LENGTH_LONG).show()
+                        }
+                    }
 
                     navController.popBackStack()
                 }
diff --git a/Camera2Video/app/src/main/res/layout/fragment_preview.xml b/Camera2Video/app/src/main/res/layout/fragment_preview.xml
index a3adc3e8..be24397f 100644
--- a/Camera2Video/app/src/main/res/layout/fragment_preview.xml
+++ b/Camera2Video/app/src/main/res/layout/fragment_preview.xml
@@ -34,9 +34,18 @@
         android:id="@+id/capture_button"
         android:layout_width="96dp"
         android:layout_height="96dp"
+        android:layout_marginBottom="96dp"
         android:layout_gravity="bottom|center"
         android:scaleType="fitCenter"
         android:background="@drawable/ic_shutter"
         android:contentDescription="@string/capture" />
 
+    <Chronometer
+        android:id="@+id/capture_timer"
+        android:layout_width="96dp"
+        android:layout_height="96dp"
+        android:layout_gravity="bottom|right"
+        android:textColor="@android:color/holo_red_light"
+        android:scaleType="fitCenter"
+        android:visibility="gone"/>
 </FrameLayout>
\ No newline at end of file
diff --git a/Camera2Video/app/src/main/res/values/strings.xml b/Camera2Video/app/src/main/res/values/strings.xml
index 472805d3..c00c7bae 100644
--- a/Camera2Video/app/src/main/res/values/strings.xml
+++ b/Camera2Video/app/src/main/res/values/strings.xml
@@ -16,4 +16,5 @@
 <resources>
     <string name="app_name">Camera2Video</string>
     <string name="capture">Capture</string>
+    <string name="error_file_not_found">Recorded file not found</string>
 </resources>
diff --git a/Camera2Video/utils/src/main/res/drawable/ic_shutter_focused.xml b/Camera2Video/utils/src/main/res/drawable/ic_shutter_focused.xml
index 9bf521da..d92ffdfa 100644
--- a/Camera2Video/utils/src/main/res/drawable/ic_shutter_focused.xml
+++ b/Camera2Video/utils/src/main/res/drawable/ic_shutter_focused.xml
@@ -21,8 +21,8 @@
     android:viewportHeight="74">
     <path android:fillColor="#FFFFFF" android:fillType="evenOdd"
         android:pathData="M73.1,37C73.1,17.0637 56.9373,0.9 37,0.9C17.0627,0.9 0.9,17.0637 0.9,37C0.9,56.9373 17.0627,73.1 37,73.1C56.9373,73.1 73.1,56.9373 73.1,37"
-        android:strokeColor="#00000000" android:strokeWidth="1"/>
-    <path android:fillColor="#58A0C4" android:fillType="evenOdd"
+        android:strokeColor="#ffff4444" android:strokeWidth="1"/>
+    <path android:fillColor="#ffff4444" android:fillType="evenOdd"
         android:pathData="M67.4,37C67.4,53.7895 53.7895,67.4 37,67.4C20.2105,67.4 6.6,53.7895 6.6,37C6.6,20.2105 20.2105,6.6 37,6.6C53.7895,6.6 67.4,20.2105 67.4,37"
-        android:strokeColor="#00000000" android:strokeWidth="1"/>
+        android:strokeColor="#ffff4444" android:strokeWidth="1"/>
 </vector>
diff --git a/Camera2Video/utils/src/main/res/drawable/ic_shutter_pressed.xml b/Camera2Video/utils/src/main/res/drawable/ic_shutter_pressed.xml
index 9bf521da..d92ffdfa 100644
--- a/Camera2Video/utils/src/main/res/drawable/ic_shutter_pressed.xml
+++ b/Camera2Video/utils/src/main/res/drawable/ic_shutter_pressed.xml
@@ -21,8 +21,8 @@
     android:viewportHeight="74">
     <path android:fillColor="#FFFFFF" android:fillType="evenOdd"
         android:pathData="M73.1,37C73.1,17.0637 56.9373,0.9 37,0.9C17.0627,0.9 0.9,17.0637 0.9,37C0.9,56.9373 17.0627,73.1 37,73.1C56.9373,73.1 73.1,56.9373 73.1,37"
-        android:strokeColor="#00000000" android:strokeWidth="1"/>
-    <path android:fillColor="#58A0C4" android:fillType="evenOdd"
+        android:strokeColor="#ffff4444" android:strokeWidth="1"/>
+    <path android:fillColor="#ffff4444" android:fillType="evenOdd"
         android:pathData="M67.4,37C67.4,53.7895 53.7895,67.4 37,67.4C20.2105,67.4 6.6,53.7895 6.6,37C6.6,20.2105 20.2105,6.6 37,6.6C53.7895,6.6 67.4,20.2105 67.4,37"
-        android:strokeColor="#00000000" android:strokeWidth="1"/>
+        android:strokeColor="#ffff4444" android:strokeWidth="1"/>
 </vector>

From f5852bea8886385b9a2607037f53e330a536d7d7 Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Sun, 29 Oct 2023 21:46:15 -0700
Subject: [PATCH 08/22] [HDR Video] Fix the crash when MediaRecorder.stop is
 called immediately after start.

Bug: b/308345292
Test: Run on Samsung s23 Ultra and Pixel 8
Change-Id: I62595aaff1934061449d4ceff314c2c933b00c00
---
 .../android/camera2/video/EncoderWrapper.kt   | 17 ++++++-
 .../video/fragments/PreviewFragment.kt        | 46 +++++++++++--------
 .../app/src/main/res/values/strings.xml       |  1 +
 3 files changed, 43 insertions(+), 21 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
index d973d62d..3cc760ef 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
@@ -209,11 +209,23 @@ class EncoderWrapper(width: Int,
      * <p>
      * Does not return until the encoder thread has stopped.
      */
-    public fun shutdown() {
+    public fun shutdown(): Boolean {
         if (VERBOSE) Log.d(TAG, "releasing encoder objects")
 
         if (mUseMediaRecorder) {
-            mMediaRecorder!!.stop()
+            try {
+                mMediaRecorder!!.stop()
+            } catch (e: RuntimeException) {
+                // https://developer.android.com/reference/android/media/MediaRecorder.html#stop()
+                // RuntimeException will be thrown if no valid audio/video data has been received
+                // when stop() is called, it usually happens when stop() is called immediately after
+                // start(). In this case the output file is not properly constructed ans should be
+                // deleted.
+                Log.d(TAG, "RuntimeException: stop() is called immediately after start()");
+                //noinspection ResultOfMethodCallIgnored
+                mOutputFile.delete()
+                return false
+            }
         } else {
             val handler = mEncoderThread!!.getHandler()
             handler.sendMessage(handler.obtainMessage(EncoderThread.EncoderHandler.MSG_SHUTDOWN))
@@ -226,6 +238,7 @@ class EncoderWrapper(width: Int,
             mEncoder!!.stop()
             mEncoder!!.release()
         }
+        return true
     }
 
     /**
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index 57d1f92c..c73d2d4b 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -369,30 +369,38 @@ class PreviewFragment : Fragment() {
                     pipeline.cleanup()
 
                     Log.d(TAG, "Recording stopped. Output file: $outputFile")
-                    encoder.shutdown()
-
-                    // Broadcasts the media file to the rest of the system
-                    MediaScannerConnection.scanFile(
-                            requireView().context, arrayOf(outputFile.absolutePath), null, null)
-
-                    // Launch external activity via intent to play video recorded using our provider
-                    if (outputFile.exists()) {
-                        startActivity(Intent().apply {
-                            action = Intent.ACTION_VIEW
-                            type = MimeTypeMap.getSingleton()
-                                    .getMimeTypeFromExtension(outputFile.extension)
-                            val authority = "${BuildConfig.APPLICATION_ID}.provider"
-                            data = FileProvider.getUriForFile(view.context, authority, outputFile)
-                            flags = Intent.FLAG_GRANT_READ_URI_PERMISSION or
-                                    Intent.FLAG_ACTIVITY_CLEAR_TOP
-                        })
+
+                    if (encoder.shutdown()) {
+                        // Broadcasts the media file to the rest of the system
+                        MediaScannerConnection.scanFile(
+                                requireView().context, arrayOf(outputFile.absolutePath), null, null)
+
+                        if (outputFile.exists()) {
+                            // Launch external activity via intent to play video recorded using our provider
+                            startActivity(Intent().apply {
+                                action = Intent.ACTION_VIEW
+                                type = MimeTypeMap.getSingleton()
+                                        .getMimeTypeFromExtension(outputFile.extension)
+                                val authority = "${BuildConfig.APPLICATION_ID}.provider"
+                                data = FileProvider.getUriForFile(view.context, authority, outputFile)
+                                flags = Intent.FLAG_GRANT_READ_URI_PERMISSION or
+                                        Intent.FLAG_ACTIVITY_CLEAR_TOP
+                            })
+                        } else {
+                            // TODO: 
+                            //  1. Move the callback to ACTION_DOWN, activating it on the second press
+                            //  2. Add an animation to the button before the user can press it again
+                            Handler(Looper.getMainLooper()).post {
+                                Toast.makeText(activity, R.string.error_file_not_found,
+                                        Toast.LENGTH_LONG).show()
+                            }
+                        }
                     } else {
                         Handler(Looper.getMainLooper()).post {
-                            Toast.makeText(activity, R.string.error_file_not_found,
+                            Toast.makeText(activity, R.string.recorder_shutdown_error,
                                     Toast.LENGTH_LONG).show()
                         }
                     }
-
                     navController.popBackStack()
                 }
             }
diff --git a/Camera2Video/app/src/main/res/values/strings.xml b/Camera2Video/app/src/main/res/values/strings.xml
index c00c7bae..0496f05c 100644
--- a/Camera2Video/app/src/main/res/values/strings.xml
+++ b/Camera2Video/app/src/main/res/values/strings.xml
@@ -17,4 +17,5 @@
     <string name="app_name">Camera2Video</string>
     <string name="capture">Capture</string>
     <string name="error_file_not_found">Recorded file not found</string>
+    <string name="recorder_shutdown_error">Recording stops too fast, please press longer</string>
 </resources>

From 3739577a475e86ea113fea8384b5f3822db75336 Mon Sep 17 00:00:00 2001
From: Austin Borger <borgera@google.com>
Date: Tue, 24 Oct 2023 18:22:47 -0700
Subject: [PATCH 09/22] Add fragment to select video codec

Change-Id: Ida18d3f63042e762b9f8ace3e40d57a23ca17735
---
 .../android/camera2/video/EncoderWrapper.kt   |  60 ++++----
 .../video/fragments/EncodeApiFragment.kt      |   2 +-
 .../camera2/video/fragments/FilterFragment.kt |   4 +-
 .../video/fragments/PreviewFragment.kt        |   3 +-
 .../video/fragments/RecordModeFragment.kt     |   4 +-
 .../video/fragments/TransferFragment.kt       |   2 +-
 .../video/fragments/VideoCodecFragment.kt     | 132 ++++++++++++++++++
 .../app/src/main/res/navigation/nav_graph.xml |  63 ++++++++-
 8 files changed, 238 insertions(+), 32 deletions(-)
 create mode 100644 Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/VideoCodecFragment.kt

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
index 3cc760ef..d979eeb2 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/EncoderWrapper.kt
@@ -28,6 +28,8 @@ import android.os.Message
 import android.util.Log
 import android.view.Surface
 
+import com.example.android.camera2.video.fragments.VideoCodecFragment
+
 import java.io.File
 import java.io.IOException
 import java.lang.ref.WeakReference
@@ -43,7 +45,8 @@ class EncoderWrapper(width: Int,
                      dynamicRange: Long,
                      orientationHint: Int,
                      outputFile: File,
-                     useMediaRecorder: Boolean) {
+                     useMediaRecorder: Boolean,
+                     videoCodec: Int) {
     companion object {
         val TAG = "EncoderWrapper"
         val VERBOSE = false
@@ -58,12 +61,9 @@ class EncoderWrapper(width: Int,
     private val mOrientationHint = orientationHint
     private val mOutputFile = outputFile
     private val mUseMediaRecorder = useMediaRecorder
+    private val mVideoCodec = videoCodec
 
-    private val mMimeType = when {
-        dynamicRange == DynamicRangeProfiles.STANDARD -> MediaFormat.MIMETYPE_VIDEO_AVC
-        dynamicRange < DynamicRangeProfiles.PUBLIC_MAX -> MediaFormat.MIMETYPE_VIDEO_HEVC
-        else -> throw IllegalArgumentException("Unknown dynamic range format")
-    }
+    private val mMimeType = VideoCodecFragment.idToType(mVideoCodec)
 
     private val mEncoderThread: EncoderThread? by lazy {
         if (useMediaRecorder) {
@@ -112,12 +112,14 @@ class EncoderWrapper(width: Int,
             if (mFrameRate > 0) setVideoFrameRate(mFrameRate)
             setVideoSize(mWidth, mHeight)
 
-            val videoEncoder = when {
-                mDynamicRange == DynamicRangeProfiles.STANDARD ->
+            val videoEncoder = when (mVideoCodec) {
+                VideoCodecFragment.VIDEO_CODEC_ID_H264 ->
                         MediaRecorder.VideoEncoder.H264
-                mDynamicRange < DynamicRangeProfiles.PUBLIC_MAX ->
+                VideoCodecFragment.VIDEO_CODEC_ID_HEVC ->
                         MediaRecorder.VideoEncoder.HEVC
-                else -> throw IllegalArgumentException("Unknown dynamic range format")
+                VideoCodecFragment.VIDEO_CODEC_ID_AV1 ->
+                        MediaRecorder.VideoEncoder.AV1
+                else -> throw IllegalArgumentException("Unknown video codec id")
             }
 
             setVideoEncoder(videoEncoder)
@@ -136,13 +138,25 @@ class EncoderWrapper(width: Int,
         if (useMediaRecorder) {
             mMediaRecorder = createRecorder(mInputSurface)
         } else {
-            val codecProfile = when {
-                dynamicRange == DynamicRangeProfiles.HLG10 ->
-                        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10
-                dynamicRange == DynamicRangeProfiles.HDR10 ->
-                        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10
-                dynamicRange == DynamicRangeProfiles.HDR10_PLUS ->
-                        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10Plus
+            val codecProfile = when (mVideoCodec) {
+                VideoCodecFragment.VIDEO_CODEC_ID_HEVC -> when {
+                    dynamicRange == DynamicRangeProfiles.HLG10 ->
+                            MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10
+                    dynamicRange == DynamicRangeProfiles.HDR10 ->
+                            MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10
+                    dynamicRange == DynamicRangeProfiles.HDR10_PLUS ->
+                            MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10Plus
+                    else -> -1
+                }
+                VideoCodecFragment.VIDEO_CODEC_ID_AV1 -> when {
+                    dynamicRange == DynamicRangeProfiles.HLG10 ->
+                            MediaCodecInfo.CodecProfileLevel.AV1ProfileMain10
+                    dynamicRange == DynamicRangeProfiles.HDR10 ->
+                            MediaCodecInfo.CodecProfileLevel.AV1ProfileMain10HDR10
+                    dynamicRange == DynamicRangeProfiles.HDR10_PLUS ->
+                            MediaCodecInfo.CodecProfileLevel.AV1ProfileMain10HDR10Plus
+                    else -> -1
+                }
                 else -> -1
             }
 
@@ -160,7 +174,7 @@ class EncoderWrapper(width: Int,
                 format.setInteger(MediaFormat.KEY_PROFILE, codecProfile)
                 format.setInteger(MediaFormat.KEY_COLOR_STANDARD, MediaFormat.COLOR_STANDARD_BT2020)
                 format.setInteger(MediaFormat.KEY_COLOR_RANGE, MediaFormat.COLOR_RANGE_FULL)
-                format.setInteger(MediaFormat.KEY_COLOR_TRANSFER, getTransferFunction(codecProfile))
+                format.setInteger(MediaFormat.KEY_COLOR_TRANSFER, getTransferFunction())
                 format.setFeatureEnabled(MediaCodecInfo.CodecCapabilities.FEATURE_HdrEditing, true)
             }
 
@@ -172,12 +186,10 @@ class EncoderWrapper(width: Int,
         }
     }
 
-    private fun getTransferFunction(codecProfile: Int) = when (codecProfile) {
-        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10 -> MediaFormat.COLOR_TRANSFER_HLG
-        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10 ->
-                MediaFormat.COLOR_TRANSFER_ST2084
-        MediaCodecInfo.CodecProfileLevel.HEVCProfileMain10HDR10Plus ->
-                MediaFormat.COLOR_TRANSFER_ST2084
+    private fun getTransferFunction() = when (mDynamicRange) {
+        DynamicRangeProfiles.HLG10 -> MediaFormat.COLOR_TRANSFER_HLG
+        DynamicRangeProfiles.HDR10 -> MediaFormat.COLOR_TRANSFER_ST2084
+        DynamicRangeProfiles.HDR10_PLUS -> MediaFormat.COLOR_TRANSFER_ST2084
         else -> MediaFormat.COLOR_TRANSFER_SDR_VIDEO
     }
 
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
index 9571a476..cd8c4146 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
@@ -68,7 +68,7 @@ class EncodeApiFragment : Fragment() {
                 Navigation.findNavController(requireActivity(), R.id.fragment_container)
 
         navController.navigate(
-                EncodeApiFragmentDirections.actionEncodeApiToRecordMode(
+                EncodeApiFragmentDirections.actionEncodeApiToVideoCodec(
                 args.cameraId, args.width, args.height, args.fps,
                 args.dynamicRange, args.colorSpace, args.previewStabilization, useMediaRecorder))
     }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
index 0a45f4f3..542895d3 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/FilterFragment.kt
@@ -66,13 +66,13 @@ class FilterFragment : Fragment() {
                             FilterFragmentDirections.actionFilterToPreview(
                             args.cameraId, args.width, args.height, args.fps,
                             args.dynamicRange, args.colorSpace, args.previewStabilization,
-                            args.useMediaRecorder, item.value, true, 0))
+                            args.useMediaRecorder, args.videoCodec, item.value, true, 0))
                     } else {
                         navController.navigate(
                             FilterFragmentDirections.actionFilterToTransfer(
                             args.cameraId, args.width, args.height, args.fps,
                             args.dynamicRange, args.colorSpace, args.previewStabilization,
-                            args.useMediaRecorder, item.value))
+                            args.useMediaRecorder, args.videoCodec, item.value))
                     }
                 }
             }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index c73d2d4b..a475377d 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -241,7 +241,8 @@ class PreviewFragment : Fragment() {
         }
 
         return EncoderWrapper(width, height, RECORDER_VIDEO_BITRATE, args.fps,
-                args.dynamicRange, orientationHint, outputFile, args.useMediaRecorder)
+                args.dynamicRange, orientationHint, outputFile, args.useMediaRecorder,
+                args.videoCodec)
     }
 
     /**
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
index e5694d03..9baf79f0 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/RecordModeFragment.kt
@@ -67,13 +67,13 @@ class RecordModeFragment : Fragment() {
                             RecordModeFragmentDirections.actionRecordModeToFilter(
                             args.cameraId, args.width, args.height, args.fps,
                             args.dynamicRange, args.colorSpace, args.previewStabilization,
-                            args.useMediaRecorder))
+                            args.useMediaRecorder, args.videoCodec))
                     } else {
                         navController.navigate(
                             RecordModeFragmentDirections.actionRecordModeToPreview(
                             args.cameraId, args.width, args.height, args.fps,
                             args.dynamicRange, args.colorSpace, args.previewStabilization,
-                            args.useMediaRecorder, false, false, 0))
+                            args.useMediaRecorder, args.videoCodec, false, false, 0))
                     }
                 }
             }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
index 440aa8da..56c34e40 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
@@ -63,7 +63,7 @@ class TransferFragment : Fragment() {
                     val direction = TransferFragmentDirections.actionTransferToPreview(
                             args.cameraId, args.width, args.height, args.fps,
                             args.dynamicRange, args.colorSpace, args.previewStabilization,
-                            args.useMediaRecorder, args.filterOn, true, item.id)
+                            args.useMediaRecorder, args.videoCodec, args.filterOn, true, item.id)
                     navController.navigate(direction)
                 }
             }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/VideoCodecFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/VideoCodecFragment.kt
new file mode 100644
index 00000000..936c350a
--- /dev/null
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/VideoCodecFragment.kt
@@ -0,0 +1,132 @@
+/*
+ * Copyright 2023 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.example.android.camera2.video.fragments
+
+import android.annotation.SuppressLint
+import android.hardware.camera2.params.DynamicRangeProfiles
+import android.media.MediaCodecList
+import android.media.MediaFormat
+import android.os.Bundle
+import android.util.Size
+import android.view.LayoutInflater
+import android.view.View
+import android.view.ViewGroup
+import android.widget.TextView
+import androidx.fragment.app.Fragment
+import androidx.navigation.Navigation
+import androidx.navigation.fragment.navArgs
+import androidx.recyclerview.widget.LinearLayoutManager
+import androidx.recyclerview.widget.RecyclerView
+import com.example.android.camera.utils.GenericListAdapter
+import com.example.android.camera2.video.R
+
+/**
+ * In this [Fragment] we let users pick a video codec to use for the encoded video.
+ */
+class VideoCodecFragment : Fragment() {
+
+    private val args: VideoCodecFragmentArgs by navArgs()
+
+    override fun onCreateView(
+            inflater: LayoutInflater,
+            container: ViewGroup?,
+            savedInstanceState: Bundle?
+    ): View? = RecyclerView(requireContext())
+
+    @SuppressLint("MissingPermission")
+    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
+        super.onViewCreated(view, savedInstanceState)
+        view as RecyclerView
+        view.apply {
+            layoutManager = LinearLayoutManager(requireContext())
+            val videoCodecList = enumerateVideoCodecs(args.dynamicRange)
+
+            val layoutId = android.R.layout.simple_list_item_1
+            adapter = GenericListAdapter(videoCodecList, itemLayoutId = layoutId) { view, item, _ ->
+                view.findViewById<TextView>(android.R.id.text1).text = item.name
+                view.setOnClickListener {
+                    val navController =
+                        Navigation.findNavController(requireActivity(), R.id.fragment_container)
+                    val direction = VideoCodecFragmentDirections.actionVideoCodecToRecordMode(
+                            args.cameraId, args.width, args.height, args.fps,
+                            args.dynamicRange, args.colorSpace, args.previewStabilization,
+                            args.useMediaRecorder, item.id)
+                    navController.navigate(direction)
+                }
+            }
+        }
+    }
+
+    companion object {
+
+        private data class VideoCodecInfo(
+                val name: String,
+                val id: Int)
+
+        public const val VIDEO_CODEC_ID_HEVC: Int = 0
+        public const val VIDEO_CODEC_ID_H264: Int = 1
+        public const val VIDEO_CODEC_ID_AV1: Int = 2
+
+        public fun idToStr(videoCodecId: Int): String = when (videoCodecId) {
+            VIDEO_CODEC_ID_HEVC -> "HEVC"
+            VIDEO_CODEC_ID_H264 -> "H264"
+            VIDEO_CODEC_ID_AV1 -> "AV1"
+            else -> throw RuntimeException("Unexpected video codec id " + videoCodecId)
+        }
+
+        public fun idToType(videoCodecId: Int): String = when (videoCodecId) {
+            VIDEO_CODEC_ID_H264 -> MediaFormat.MIMETYPE_VIDEO_AVC
+            VIDEO_CODEC_ID_HEVC -> MediaFormat.MIMETYPE_VIDEO_HEVC
+            VIDEO_CODEC_ID_AV1 -> MediaFormat.MIMETYPE_VIDEO_AV1
+            else -> throw RuntimeException("Unexpected video codec id " + videoCodecId)
+        }
+
+        /** Lists all video-capable cameras and supported resolution and FPS combinations */
+        @SuppressLint("InlinedApi")
+        private fun enumerateVideoCodecs(dynamicRange: Long): List<VideoCodecInfo> {
+            val videoCodecIdList = when {
+                dynamicRange == DynamicRangeProfiles.STANDARD -> listOf(VIDEO_CODEC_ID_H264)
+                dynamicRange < DynamicRangeProfiles.PUBLIC_MAX ->
+                        listOf(VIDEO_CODEC_ID_HEVC, VIDEO_CODEC_ID_AV1)
+                else -> throw RuntimeException("Unrecognized dynamic range $dynamicRange")
+            }
+
+            val supportedVideoCodecIdSet = mutableSetOf<Int>()
+            val mediaCodecList = MediaCodecList(MediaCodecList.REGULAR_CODECS)
+            for (codecInfo in mediaCodecList.getCodecInfos()) {
+                if (!codecInfo.isEncoder()) {
+                    continue
+                }
+
+                val types = codecInfo.getSupportedTypes()
+                for (type in types) {
+                    for (videoCodecId in videoCodecIdList) {
+                        if (type.equals(idToType(videoCodecId), ignoreCase = true)) {
+                            supportedVideoCodecIdSet.add(videoCodecId)
+                        }
+                    }
+                }
+            }
+
+            val videoCodecList: MutableList<VideoCodecInfo> = mutableListOf()
+            for (id in supportedVideoCodecIdSet) {
+                videoCodecList.add(VideoCodecInfo(idToStr(id), id))
+            }
+            return videoCodecList
+        }
+    }
+}
diff --git a/Camera2Video/app/src/main/res/navigation/nav_graph.xml b/Camera2Video/app/src/main/res/navigation/nav_graph.xml
index d307928b..17099bbf 100644
--- a/Camera2Video/app/src/main/res/navigation/nav_graph.xml
+++ b/Camera2Video/app/src/main/res/navigation/nav_graph.xml
@@ -206,7 +206,52 @@
             app:argType="boolean" />
 
         <action
-            android:id="@+id/action_encode_api_to_record_mode"
+            android:id="@+id/action_encode_api_to_video_codec"
+            app:launchSingleTop="true"
+            app:destination="@id/video_codec_fragment" />
+
+    </fragment>
+
+    <fragment
+        android:id="@+id/video_codec_fragment"
+        android:name="com.example.android.camera2.video.fragments.VideoCodecFragment"
+        android:label="Video Codec" >
+
+        <argument
+            android:name="camera_id"
+            app:argType="string"
+            app:nullable="false"/>
+
+        <argument
+            android:name="width"
+            app:argType="integer" />
+
+        <argument
+            android:name="height"
+            app:argType="integer" />
+
+        <argument
+            android:name="fps"
+            app:argType="integer" />
+
+        <argument
+            android:name="dynamicRange"
+            app:argType="long" />
+
+        <argument
+            android:name="colorSpace"
+            app:argType="integer" />
+
+        <argument
+            android:name="previewStabilization"
+            app:argType="boolean" />
+
+        <argument
+            android:name="useMediaRecorder"
+            app:argType="boolean" />
+
+        <action
+            android:id="@+id/action_video_codec_to_record_mode"
             app:launchSingleTop="true"
             app:destination="@id/record_mode_fragment" />
 
@@ -250,6 +295,10 @@
             android:name="useMediaRecorder"
             app:argType="boolean" />
 
+        <argument
+            android:name="videoCodec"
+            app:argType="integer" />
+
         <action
             android:id="@+id/action_record_mode_to_preview"
             app:launchSingleTop="true"
@@ -300,6 +349,10 @@
             android:name="useMediaRecorder"
             app:argType="boolean" />
 
+        <argument
+            android:name="videoCodec"
+            app:argType="integer" />
+
         <action
             android:id="@+id/action_filter_to_preview"
             app:launchSingleTop="true"
@@ -350,6 +403,10 @@
             android:name="useMediaRecorder"
             app:argType="boolean" />
 
+        <argument
+            android:name="videoCodec"
+            app:argType="integer" />
+
         <argument
             android:name="filterOn"
             app:argType="boolean" />
@@ -399,6 +456,10 @@
             android:name="useMediaRecorder"
             app:argType="boolean" />
 
+        <argument
+            android:name="videoCodec"
+            app:argType="integer" />
+
         <argument
             android:name="filterOn"
             app:argType="boolean" />

From 83dad63cd9c3910b054588c24edaaf124cec6502 Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Thu, 26 Oct 2023 17:48:11 -0700
Subject: [PATCH 10/22] [HDR Video] Add HLG extension support

1. Add HLG extension support for Android 14 or above
2. Merge https://devrel-review.git.corp.google.com/c/samples/android/camera/+/214130 for HLG extension workaround

Bug: b/308198138
Test: Run Camera2Video on Pixel 8 (Android 14) and Samsung s23 Ultra (Android 13)
Change-Id: I9c3d1a3f7a62e52e627d3076e4cd9497ef736478
---
 Camera2Video/app/build.gradle                 |   3 +
 .../android/camera2/video/HardwarePipeline.kt | 378 +++++++++++++-----
 .../video/fragments/TransferFragment.kt       |  12 +
 Camera2Video/build.gradle                     |   2 +-
 4 files changed, 284 insertions(+), 111 deletions(-)

diff --git a/Camera2Video/app/build.gradle b/Camera2Video/app/build.gradle
index 163c662b..b16183d7 100644
--- a/Camera2Video/app/build.gradle
+++ b/Camera2Video/app/build.gradle
@@ -77,6 +77,9 @@ dependencies {
     implementation 'androidx.lifecycle:lifecycle-runtime-ktx:2.2.0'
     implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
 
+    // EGL compat
+    implementation 'androidx.graphics:graphics-core:1.0.0-alpha05'
+
     // Navigation library
     def nav_version = "2.2.2"
     implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index 86f1dd3f..cfb72c51 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -16,43 +16,31 @@
 
 package com.example.android.camera2.video.fragments
 
-import android.annotation.SuppressLint
-import android.content.Context
-import android.content.Intent
-import android.content.pm.ActivityInfo
-import android.graphics.Color
-import android.graphics.ColorSpace
-import android.graphics.ImageFormat
 import android.graphics.Rect
 import android.graphics.SurfaceTexture
+import android.hardware.DataSpace
 import android.hardware.camera2.CameraCaptureSession
 import android.hardware.camera2.CameraCharacteristics
 import android.hardware.camera2.CameraDevice
-import android.hardware.camera2.CameraManager
 import android.hardware.camera2.CaptureRequest
 import android.hardware.camera2.params.DynamicRangeProfiles
-import android.hardware.camera2.params.OutputConfiguration
 import android.hardware.HardwareBuffer
-import android.media.Image
-import android.media.ImageReader
-import android.media.ImageWriter
-import android.media.MediaCodec
-import android.media.MediaCodecInfo
-import android.media.MediaFormat
-import android.media.MediaScannerConnection
+import android.hardware.SyncFence
 import android.opengl.EGL14
-import android.opengl.EGL14.EGL_CONTEXT_CLIENT_VERSION
-import android.opengl.EGL14.EGL_OPENGL_ES2_BIT
+import android.opengl.EGL14.EGL_NO_DISPLAY
+import android.opengl.EGL14.EGL_NO_SURFACE
 import android.opengl.EGL15
 import android.opengl.EGLConfig
-import android.opengl.EGLContext
-import android.opengl.EGLDisplay
 import android.opengl.EGLExt
-import android.opengl.EGLImage
 import android.opengl.EGLSurface
 import android.opengl.GLES11Ext
+import android.opengl.GLES20.GL_COLOR_ATTACHMENT0
+import android.opengl.GLES20.GL_FRAMEBUFFER
+import android.opengl.GLES20.GL_TEXTURE_2D
+import android.opengl.GLES20.glFinish
+import android.opengl.GLES20.glFlush
 import android.opengl.GLES30
-import android.os.Bundle
+import android.os.Build
 import android.os.ConditionVariable
 import android.os.Handler
 import android.os.HandlerThread
@@ -61,42 +49,16 @@ import android.os.Message
 import android.util.Log
 import android.util.Range
 import android.util.Size
-import android.view.LayoutInflater
-import android.view.MotionEvent
 import android.view.Surface
-import android.view.SurfaceHolder
-import android.view.TextureView
-import android.view.View
-import android.view.ViewGroup
-import android.webkit.MimeTypeMap
-import androidx.core.content.FileProvider
-import androidx.core.graphics.drawable.toDrawable
-import androidx.fragment.app.Fragment
-import androidx.lifecycle.Observer
-import androidx.lifecycle.lifecycleScope
-import androidx.navigation.NavController
-import androidx.navigation.Navigation
-import androidx.navigation.fragment.navArgs
-import com.example.android.camera.utils.getPreviewOutputSize
+import android.view.SurfaceControl
+import androidx.annotation.RequiresApi
+import androidx.opengl.EGLExt.Companion.eglCreateSyncKHR
+import androidx.opengl.EGLImageKHR
 import com.example.android.camera.utils.AutoFitSurfaceView
-import com.example.android.camera2.video.BuildConfig
-import com.example.android.camera2.video.CameraActivity
-import com.example.android.camera2.video.R
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.delay
-import kotlinx.coroutines.launch
-import kotlinx.coroutines.suspendCancellableCoroutine
-import java.io.File
 import java.nio.ByteBuffer
 import java.nio.ByteOrder
 import java.nio.IntBuffer
-import java.text.SimpleDateFormat
-import java.util.Date
-import java.util.Locale
 import kotlin.RuntimeException
-import kotlin.coroutines.resume
-import kotlin.coroutines.resumeWithException
-import kotlin.coroutines.suspendCoroutine
 
 import com.example.android.camera2.video.EncoderWrapper
 
@@ -348,6 +310,7 @@ private val FULLSCREEN_QUAD = floatArrayOf(
 private val EGL_GL_COLORSPACE_KHR               = 0x309D
 private val EGL_GL_COLORSPACE_BT2020_LINEAR_EXT = 0x333F
 private val EGL_GL_COLORSPACE_BT2020_PQ_EXT     = 0x3340
+private val EGL_GL_COLORSPACE_BT2020_HLG_EXT     = 0x3540
 private val EGL_SMPTE2086_DISPLAY_PRIMARY_RX_EXT       = 0x3341
 private val EGL_SMPTE2086_DISPLAY_PRIMARY_RY_EXT       = 0x3342
 private val EGL_SMPTE2086_DISPLAY_PRIMARY_GX_EXT       = 0x3343
@@ -370,7 +333,7 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
     }
 
     private val renderHandler = RenderHandler(renderThread.getLooper(),
-            width, height, fps, filterOn, transfer, dynamicRange, characteristics, encoder)
+            width, height, fps, filterOn, transfer, dynamicRange, characteristics, encoder, viewFinder)
 
     override fun createRecordRequest(session: CameraCaptureSession,
             previewStabilization: Boolean) : CaptureRequest {
@@ -459,7 +422,8 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
 
     private class RenderHandler(looper: Looper, width: Int, height: Int, fps: Int,
             filterOn: Boolean, transfer: Int, dynamicRange: Long,
-            characteristics: CameraCharacteristics, encoder: EncoderWrapper): Handler(looper),
+            characteristics: CameraCharacteristics, encoder: EncoderWrapper,
+            viewFinder: AutoFitSurfaceView): Handler(looper),
             SurfaceTexture.OnFrameAvailableListener {
         companion object {
             val MSG_CREATE_RESOURCES = 0
@@ -476,8 +440,8 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         private val filterOn = filterOn
         private val transfer = transfer
         private val dynamicRange = dynamicRange
-        private val characteristics = characteristics
         private val encoder = encoder
+        private val viewFinder = viewFinder
 
         private var previewSize = Size(0, 0)
 
@@ -490,8 +454,6 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         /** The above SurfaceTexture cast as a Surface */
         private lateinit var cameraSurface: Surface
 
-        private lateinit var cameraImage: EGLImage
-
         /** OpenGL texture that will combine the camera output with rendering */
         private var renderTexId: Int = 0
 
@@ -501,6 +463,13 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         /** The above SurfaceTexture cast as a Surface */
         private lateinit var renderSurface: Surface
 
+        /** Stuff needed for displaying HLG via SurfaceControl */
+        private var contentSurfaceControl: SurfaceControl? = null
+        private var windowTexId: Int = 0
+        private var windowFboId: Int = 0
+
+        private var supportsNativeFences = false
+
         /** Storage space for setting the texMatrix uniform */
         private val texMatrix = FloatArray(16)
 
@@ -516,9 +485,9 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         private var eglDisplay = EGL14.EGL_NO_DISPLAY
         private var eglContext = EGL14.EGL_NO_CONTEXT
         private var eglConfig: EGLConfig? = null
-        private var eglRenderSurface: EGLSurface = EGL14.EGL_NO_SURFACE
-        private var eglEncoderSurface: EGLSurface = EGL14.EGL_NO_SURFACE
-        private var eglWindowSurface: EGLSurface = EGL14.EGL_NO_SURFACE
+        private var eglRenderSurface: EGLSurface? = EGL_NO_SURFACE
+        private var eglEncoderSurface: EGLSurface? = EGL_NO_SURFACE
+        private var eglWindowSurface: EGLSurface? = EGL_NO_SURFACE
         private var vertexShader = 0
         private var cameraToRenderFragmentShader = 0
         private var renderToPreviewFragmentShader = 0
@@ -594,6 +563,8 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                     requiredExtensionsList.add("EGL_EXT_gl_colorspace_bt2020_pq")
                 } else if (transfer == TransferFragment.LINEAR_ID) {
                     requiredExtensionsList.add("EGL_EXT_gl_colorspace_bt2020_linear")
+                } else if (transfer == TransferFragment.HLG_ID) {
+                    requiredExtensionsList.add("EGL_EXT_gl_colorspace_bt2020_hlg")
                 }
 
                 val eglExtensions = EGL14.eglQueryString(eglDisplay, EGL14.EGL_EXTENSIONS)
@@ -606,6 +577,11 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                         throw RuntimeException("EGL extension not supported: " + requiredExtension)
                     }
                 }
+
+                // More devices can be supported if the eglCreateSyncKHR is used instead of
+                // EGL15.eglCreateSync
+                supportsNativeFences = eglVersion >= 15
+                        && eglExtensions.contains("EGL_ANDROID_native_fence_sync")
             }
 
             Log.i(TAG, "isHDR: " + isHDR())
@@ -684,56 +660,101 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                         EGL_GL_COLORSPACE_KHR, EGL_GL_COLORSPACE_BT2020_LINEAR_EXT,
                         EGL14.EGL_NONE
                     )
+                    // We configure HLG below
+                    TransferFragment.HLG_ID -> intArrayOf(
+                            EGL_GL_COLORSPACE_KHR, EGL_GL_COLORSPACE_BT2020_HLG_EXT,
+                            EGL14.EGL_NONE
+                    )
+                    TransferFragment.HLG_WORKAROUND_ID -> intArrayOf(EGL14.EGL_NONE)
                     else -> throw RuntimeException("Unexpected transfer " + transfer)
                 }
             }
 
-            eglWindowSurface = EGL14.eglCreateWindowSurface(eglDisplay, eglConfig, surface,
-                    windowSurfaceAttribs, 0)
-            if (eglWindowSurface == EGL14.EGL_NO_SURFACE) {
-                throw RuntimeException("Failed to create EGL texture view surface")
+            if (!isHDR() or (transfer != TransferFragment.HLG_WORKAROUND_ID)) {
+                eglWindowSurface = EGL14.eglCreateWindowSurface(
+                    eglDisplay, eglConfig, surface,
+                    windowSurfaceAttribs, 0
+                )
+                if (eglWindowSurface == EGL_NO_SURFACE) {
+                    throw RuntimeException("Failed to create EGL texture view surface")
+                }
             }
 
-            if (isHDR() and (transfer == TransferFragment.PQ_ID)) {
-                val SMPTE2086_MULTIPLIER = 50000
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
-                        EGL_SMPTE2086_MAX_LUMINANCE_EXT, 10000 * SMPTE2086_MULTIPLIER)
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
-                        EGL_SMPTE2086_MIN_LUMINANCE_EXT, 0)
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+            if (eglWindowSurface != EGL_NO_SURFACE) {
+                if (isHDR() and (transfer == TransferFragment.PQ_ID)) {
+                    val SMPTE2086_MULTIPLIER = 50000
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
+                        EGL_SMPTE2086_MAX_LUMINANCE_EXT, 10000 * SMPTE2086_MULTIPLIER
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
+                        EGL_SMPTE2086_MIN_LUMINANCE_EXT, 0
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_RX_EXT,
-                        (0.708f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.708f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_RY_EXT,
-                        (0.292f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.292f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_GX_EXT,
-                        (0.170f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.170f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_GY_EXT,
-                        (0.797f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.797f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_BX_EXT,
-                        (0.131f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.131f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_DISPLAY_PRIMARY_BY_EXT,
-                        (0.046f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.046f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_WHITE_POINT_X_EXT,
-                        (0.3127f * SMPTE2086_MULTIPLIER).toInt())
-                EGL14.eglSurfaceAttrib(eglDisplay, eglWindowSurface,
+                        (0.3127f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                    EGL14.eglSurfaceAttrib(
+                        eglDisplay, eglWindowSurface,
                         EGL_SMPTE2086_WHITE_POINT_Y_EXT,
-                        (0.3290f * SMPTE2086_MULTIPLIER).toInt())
+                        (0.3290f * SMPTE2086_MULTIPLIER).toInt()
+                    )
+                }
             }
 
-            EGL14.eglMakeCurrent(eglDisplay, eglWindowSurface, eglWindowSurface, eglContext)
-
             cameraTexId = createTexture()
             cameraTexture = SurfaceTexture(cameraTexId)
             cameraTexture.setOnFrameAvailableListener(this)
             cameraTexture.setDefaultBufferSize(width, height)
             cameraSurface = Surface(cameraTexture)
 
+
+            if (isHDR() and (transfer == TransferFragment.HLG_WORKAROUND_ID)) {
+                // Communicating HLG content may not be supported on EGLSurface in API 33, as there
+                // is no EGL extension for communicating the surface color space. Instead, create
+                // a child SurfaceControl whose parent is the viewFinder's SurfaceView and push
+                // buffers directly to the SurfaceControl.
+                contentSurfaceControl = SurfaceControl.Builder()
+                    .setName("HardwarePipeline")
+                    .setParent(viewFinder.surfaceControl)
+                    .setHidden(false)
+                    .build()
+                windowTexId = createTexId()
+                windowFboId = createFboId()
+            }
+
             renderTexId = createTexture()
             renderTexture = SurfaceTexture(renderTexId)
             renderTexture.setDefaultBufferSize(width, height)
@@ -742,7 +763,7 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             var renderSurfaceAttribs = intArrayOf(EGL14.EGL_NONE)
             eglRenderSurface = EGL14.eglCreateWindowSurface(eglDisplay, eglConfig, renderSurface,
                     renderSurfaceAttribs, 0)
-            if (eglRenderSurface == EGL14.EGL_NO_SURFACE) {
+            if (eglRenderSurface == EGL_NO_SURFACE) {
                 throw RuntimeException("Failed to create EGL render surface")
             }
 
@@ -773,6 +794,9 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                             HLG_TO_PQ_HDR_FSHADER)
                     TransferFragment.LINEAR_ID -> createShader(GLES30.GL_FRAGMENT_SHADER,
                             HLG_TO_LINEAR_HDR_FSHADER)
+                    TransferFragment.HLG_ID,
+                    TransferFragment.HLG_WORKAROUND_ID -> createShader(GLES30.GL_FRAGMENT_SHADER,
+                            PASSTHROUGH_HDR_FSHADER)
                     else -> throw RuntimeException("Unexpected transfer " + transfer)
                 }
 
@@ -847,6 +871,30 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             return shader
         }
 
+        private fun createTexId(): Int {
+            val buffer = IntBuffer.allocate(1)
+            GLES30.glGenTextures(1, buffer)
+            return buffer.get(0)
+        }
+
+        private fun destroyTexId(id: Int) {
+            val buffer = IntBuffer.allocate(1)
+            buffer.put(0, id)
+            GLES30.glDeleteTextures(1, buffer)
+        }
+
+        private fun createFboId(): Int {
+            val buffer = IntBuffer.allocate(1)
+            GLES30.glGenFramebuffers(1, buffer)
+            return buffer.get(0)
+        }
+
+        private fun destroyFboId(id: Int) {
+            val buffer = IntBuffer.allocate(1)
+            buffer.put(0, id)
+            GLES30.glDeleteFramebuffers(1, buffer)
+        }
+
         /** Create an OpenGL texture */
         private fun createTexture(): Int {
             /* Check that EGL has been initialized. */
@@ -854,9 +902,7 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                 throw IllegalStateException("EGL not initialized before call to createTexture()");
             }
 
-            val buffer = IntBuffer.allocate(1)
-            GLES30.glGenTextures(1, buffer)
-            val texId = buffer.get(0)
+            val texId = createTexId()
             GLES30.glBindTexture(GLES11Ext.GL_TEXTURE_EXTERNAL_OES, texId)
             GLES30.glTexParameteri(GLES11Ext.GL_TEXTURE_EXTERNAL_OES, GLES30.GL_TEXTURE_MIN_FILTER,
                     GLES30.GL_LINEAR)
@@ -870,7 +916,9 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         }
 
         private fun destroyWindowSurface() {
-            EGL14.eglDestroySurface(eglDisplay, eglWindowSurface)
+            if (eglWindowSurface != EGL_NO_SURFACE && eglDisplay != EGL_NO_DISPLAY) {
+                EGL14.eglDestroySurface(eglDisplay, eglWindowSurface)
+            }
             eglWindowSurface = EGL14.EGL_NO_SURFACE
             cvDestroyWindowSurface.open()
         }
@@ -880,7 +928,7 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
         }
 
         private fun copyTexture(texId: Int, texture: SurfaceTexture, viewportRect: Rect,
-                shaderProgram: ShaderProgram) {
+                shaderProgram: ShaderProgram, outputIsFramebuffer: Boolean) {
             GLES30.glClearColor(0.0f, 0.0f, 0.0f, 1.0f)
             checkGlError("glClearColor")
             GLES30.glClear(GLES30.GL_COLOR_BUFFER_BIT)
@@ -893,6 +941,17 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             checkGlError("glBindTexture")
 
             texture.getTransformMatrix(texMatrix)
+
+            // HardwareBuffer coordinates are flipped relative to what GLES expects
+            if (outputIsFramebuffer) {
+                val flipMatrix = floatArrayOf(
+                    1f, 0f, 0f, 0f,
+                    0f, -1f, 0f, 0f,
+                    0f, 0f, 1f, 0f,
+                    0f, 1f, 0f, 1f
+                )
+                android.opengl.Matrix.multiplyMM(texMatrix, 0, flipMatrix, 0, texMatrix.clone(), 0)
+            }
             shaderProgram.setTexMatrix(texMatrix)
 
             shaderProgram.setVertexAttribArray(FULLSCREEN_QUAD)
@@ -908,14 +967,50 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             EGL14.eglMakeCurrent(eglDisplay, eglRenderSurface, eglRenderSurface, eglContext)
 
             copyTexture(cameraTexId, cameraTexture, Rect(0, 0, width, height),
-                cameraToRenderShaderProgram!!)
+                cameraToRenderShaderProgram!!, false)
 
             EGL14.eglSwapBuffers(eglDisplay, eglRenderSurface)
             renderTexture.updateTexImage()
         }
 
         private fun copyRenderToPreview() {
-            EGL14.eglMakeCurrent(eglDisplay, eglWindowSurface, eglRenderSurface, eglContext)
+
+            var hardwareBuffer: HardwareBuffer? = null
+            var eglImage: EGLImageKHR? = null
+            if (transfer == TransferFragment.HLG_WORKAROUND_ID) {
+                EGL14.eglMakeCurrent(eglDisplay, EGL_NO_SURFACE, EGL_NO_SURFACE, eglContext)
+
+                // TODO: use GLFrameBufferRenderer to optimize the performance
+                // Note that pooling and reusing HardwareBuffers will have significantly better
+                // memory utilization so the HardwareBuffers do not have to be allocated every frame
+                hardwareBuffer = HardwareBuffer.create(
+                        previewSize.width, previewSize.height,
+                        HardwareBuffer.RGBA_1010102, 1,
+                        HardwareBuffer.USAGE_GPU_SAMPLED_IMAGE
+                                or HardwareBuffer.USAGE_GPU_COLOR_OUTPUT
+                                or HardwareBuffer.USAGE_COMPOSER_OVERLAY)
+
+                // If we're sending output buffers to a SurfaceControl we cannot render to an
+                // EGLSurface. We need to render to a HardwareBuffer instead by importing the
+                // HardwareBuffer into EGL, associating it with a texture, and framebuffer, and
+                // drawing directly into the HardwareBuffer.
+                eglImage = androidx.opengl.EGLExt.eglCreateImageFromHardwareBuffer(
+                    eglDisplay, hardwareBuffer)
+                checkGlError("eglCreateImageFromHardwareBuffer")
+
+                GLES30.glBindTexture(GL_TEXTURE_2D, windowTexId)
+                checkGlError("glBindTexture")
+                androidx.opengl.EGLExt.glEGLImageTargetTexture2DOES(GL_TEXTURE_2D, eglImage!!)
+                checkGlError("glEGLImageTargetTexture2DOES")
+
+                GLES30.glBindFramebuffer(GL_FRAMEBUFFER, windowFboId);
+                checkGlError("glBindFramebuffer")
+                GLES30.glFramebufferTexture2D(
+                    GL_FRAMEBUFFER, GL_COLOR_ATTACHMENT0, GL_TEXTURE_2D, windowTexId, 0);
+                checkGlError("glFramebufferTexture2D")
+            } else {
+                EGL14.eglMakeCurrent(eglDisplay, eglWindowSurface, eglRenderSurface, eglContext)
+            }
 
             val cameraAspectRatio = width.toFloat() / height.toFloat()
             val previewAspectRatio = previewSize.width.toFloat() / previewSize.height.toFloat()
@@ -925,8 +1020,8 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             var viewportY = 0
 
             /** The camera display is not the same size as the video. Letterbox the preview so that
-                we can see exactly how the video will turn out. */
-            if (previewAspectRatio > cameraAspectRatio) {
+             * we can see exactly how the video will turn out. */
+            if (previewAspectRatio < cameraAspectRatio) {
                 /** Avoid vertical stretching */
                 viewportHeight = ((viewportHeight.toFloat() / previewAspectRatio) * cameraAspectRatio).toInt()
                 viewportY = (previewSize.height - viewportHeight) / 2
@@ -936,10 +1031,47 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
                 viewportX = (previewSize.width - viewportWidth) / 2
             }
 
-            copyTexture(renderTexId, renderTexture, Rect(viewportX, viewportY, viewportWidth,
-                    viewportHeight), renderToPreviewShaderProgram!!)
+            copyTexture(renderTexId, renderTexture,
+                        Rect(viewportX, viewportY, viewportWidth, viewportHeight),
+                        renderToPreviewShaderProgram!!, hardwareBuffer != null)
+
+            if (hardwareBuffer != null) {
+                if (contentSurfaceControl == null) {
+                    throw RuntimeException("Forgot to set up SurfaceControl for HLG preview!")
+                }
+
+                // When rendering to HLG, send each camera frame to the display and communicate the
+                // HLG colorspace here.
+                if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
+                    val fence = createSyncFence()
+                    if (fence == null) {
+                        glFinish()
+                        checkGlError("glFinish")
+                    }
+                    SurfaceControl.Transaction()
+                            .setBuffer(
+                                    contentSurfaceControl!!,
+                                    hardwareBuffer,
+                                    fence)
+                            .setDataSpace(
+                                    contentSurfaceControl!!,
+                                    DataSpace.pack(
+                                        DataSpace.STANDARD_BT2020,
+                                        DataSpace.TRANSFER_HLG,
+                                        DataSpace.RANGE_FULL
+                                    ))
+                            .apply()
+                    hardwareBuffer.close()
+                }
+            } else {
+                EGL14.eglSwapBuffers(eglDisplay, eglWindowSurface)
+            }
+
+            if (eglImage != null) {
+                GLES30.glBindFramebuffer(GL_FRAMEBUFFER, 0);
+                androidx.opengl.EGLExt.eglDestroyImageKHR(eglDisplay, eglImage)
+            }
 
-            EGL14.eglSwapBuffers(eglDisplay, eglWindowSurface)
         }
 
         private fun copyRenderToEncode() {
@@ -955,18 +1087,37 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             }
 
             copyTexture(renderTexId, renderTexture, Rect(0, 0, viewportWidth, viewportHeight),
-                    renderToEncodeShaderProgram!!)
+                    renderToEncodeShaderProgram!!, false)
 
             encoder.frameAvailable()
 
             EGL14.eglSwapBuffers(eglDisplay, eglEncoderSurface)
         }
 
+        @RequiresApi(Build.VERSION_CODES.TIRAMISU)
+        private fun createSyncFence() : SyncFence? {
+            if (!supportsNativeFences) {
+                return null
+            }
+
+            val eglSync = EGL15.eglCreateSync(
+                    eglDisplay, androidx.opengl.EGLExt.EGL_SYNC_NATIVE_FENCE_ANDROID,
+                    longArrayOf(EGL14.EGL_NONE.toLong()), 0)
+            checkGlError("eglCreateSync")
+            glFlush()
+            checkGlError("glFlush")
+            return eglSync?.let {
+                val fence = EGLExt.eglDupNativeFenceFDANDROID(eglDisplay, it)
+                checkGlError("eglDupNativeFenceFDANDROID")
+                fence
+            }
+        }
+
         private fun actionDown(encoderSurface: Surface) {
             val surfaceAttribs = intArrayOf(EGL14.EGL_NONE)
             eglEncoderSurface = EGL14.eglCreateWindowSurface(eglDisplay, eglConfig,
                     encoderSurface, surfaceAttribs, 0)
-            if (eglEncoderSurface == EGL14.EGL_NO_SURFACE) {
+            if (eglEncoderSurface == EGL_NO_SURFACE) {
                 val error = EGL14.eglGetError()
                 throw RuntimeException("Failed to create EGL encoder surface"
                         + ": eglGetError = 0x" + Integer.toHexString(error))
@@ -984,12 +1135,20 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
 
         private fun cleanup() {
             EGL14.eglDestroySurface(eglDisplay, eglEncoderSurface)
-            eglEncoderSurface = EGL14.EGL_NO_SURFACE
+            eglEncoderSurface = EGL_NO_SURFACE
             EGL14.eglDestroySurface(eglDisplay, eglRenderSurface)
-            eglRenderSurface = EGL14.EGL_NO_SURFACE
+            eglRenderSurface = EGL_NO_SURFACE
 
             cameraTexture.release()
 
+            if (windowTexId > 0) {
+                destroyTexId(windowTexId)
+            }
+
+            if (windowFboId > 0) {
+                destroyFboId(windowFboId)
+            }
+
             EGL14.eglDestroyContext(eglDisplay, eglContext)
 
             eglDisplay = EGL14.EGL_NO_DISPLAY
@@ -1012,17 +1171,15 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             cameraTexture.updateTexImage()
 
             /** Copy from the camera texture to the render texture */
-            if (eglRenderSurface != EGL14.EGL_NO_SURFACE) {
+            if (eglRenderSurface != EGL_NO_SURFACE) {
                 copyCameraToRender()
             }
 
             /** Copy from the render texture to the TextureView */
-            if (eglWindowSurface != EGL14.EGL_NO_SURFACE) {
-                copyRenderToPreview()
-            }
+            copyRenderToPreview()
 
             /** Copy to the encoder surface if we're currently recording. */
-            if (eglEncoderSurface != EGL14.EGL_NO_SURFACE && currentlyRecording) {
+            if (eglEncoderSurface != EGL_NO_SURFACE && currentlyRecording) {
                 copyRenderToEncode()
             }
         }
@@ -1069,4 +1226,5 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             }
         }
     }
+
 }
diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
index 56c34e40..7dc4950a 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/TransferFragment.kt
@@ -17,6 +17,7 @@
 package com.example.android.camera2.video.fragments
 
 import android.annotation.SuppressLint
+import android.os.Build
 import android.os.Bundle
 import android.util.Size
 import android.view.LayoutInflater
@@ -78,12 +79,18 @@ class TransferFragment : Fragment() {
 
         public val PQ_STR = "PQ"
         public val LINEAR_STR = "LINEAR"
+        public val HLG_STR = "HLG (Android 14 or above)"
+        public val HLG_WORKAROUND_STR = "HLG (Android 13)"
         public val PQ_ID: Int = 0
         public val LINEAR_ID: Int = 1
+        public val HLG_ID: Int = 2
+        public val HLG_WORKAROUND_ID: Int = 3
 
         public fun idToStr(transferId: Int): String = when (transferId) {
             PQ_ID -> PQ_STR
             LINEAR_ID -> LINEAR_STR
+            HLG_ID -> HLG_STR
+            HLG_WORKAROUND_ID -> HLG_WORKAROUND_STR
             else -> throw RuntimeException("Unexpected transferId " + transferId)
         }
 
@@ -93,6 +100,11 @@ class TransferFragment : Fragment() {
             val transferCharacteristics: MutableList<TransferInfo> = mutableListOf()
             transferCharacteristics.add(TransferInfo(PQ_STR, PQ_ID))
             transferCharacteristics.add(TransferInfo(LINEAR_STR, LINEAR_ID))
+            if (Build.VERSION.SDK_INT > Build.VERSION_CODES.TIRAMISU) {
+                transferCharacteristics.add(TransferInfo(HLG_STR, HLG_ID))
+            } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.TIRAMISU) {
+                transferCharacteristics.add(TransferInfo(HLG_WORKAROUND_STR, HLG_WORKAROUND_ID))
+            }
             return transferCharacteristics
         }
     }
diff --git a/Camera2Video/build.gradle b/Camera2Video/build.gradle
index 9727d4d8..1843a459 100644
--- a/Camera2Video/build.gradle
+++ b/Camera2Video/build.gradle
@@ -18,7 +18,7 @@
 
 buildscript {
     // Top-level variables used for versioning
-    ext.kotlin_version = '1.5.31'
+    ext.kotlin_version = '1.8.0'
     ext.java_version = JavaVersion.VERSION_1_8
 
     repositories {

From c396e86b1296d59376ff1290309f175ba10ba643 Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Fri, 27 Oct 2023 12:21:23 -0700
Subject: [PATCH 11/22] [HDR Video] Turn off transfer function experiment for
 testing

Bug: 307767427
Test: Ran Camera2Video on Pixel 8
Change-Id: Ia70879b6dd23cfb82cb93b679ee186d2c7186943
---
 .../android/camera2/video/HardwarePipeline.kt     | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
index cfb72c51..1571ae54 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/HardwarePipeline.kt
@@ -681,6 +681,21 @@ class HardwarePipeline(width: Int, height: Int, fps: Int, filterOn: Boolean, tra
             }
 
             if (eglWindowSurface != EGL_NO_SURFACE) {
+                /**
+                 * This is only experimental for the transfer function. It is intended to be
+                 * supplied alongside CTA 861.3 metadata
+                 * https://registry.khronos.org/EGL/extensions/EXT/EGL_EXT_surface_CTA861_3_metadata.txt.
+                 * which describes the max and average luminance of the content).
+                 *
+                 * The display will use these parameters to map the source content colors to a
+                 * colors that fill the display's capabilities.
+                 *
+                 * Without providing these parameters, the display will assume "reasonable defaults",
+                 * which may not be accurate for the source content. This would most likely result
+                 * in inaccurate colors, although the exact effect is device-dependent.
+                 *
+                 * The parameters needs to be tuned.
+                 * */
                 if (isHDR() and (transfer == TransferFragment.PQ_ID)) {
                     val SMPTE2086_MULTIPLIER = 50000
                     EGL14.eglSurfaceAttrib(

From f346b02b21721525826299cfee7606cf8848d2b7 Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Tue, 7 Nov 2023 17:34:51 -0800
Subject: [PATCH 12/22] [HDR Video] Fix the crash after video recording

It's not 100% reproducible.

Bug: b/309701359
Test: Run on Pixel 8 Pro
Change-Id: I7a968102bfad38bf0e2a8a60781818e6f6b0059d
---
 .../android/camera2/video/fragments/PreviewFragment.kt        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
index a475377d..333fb525 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/PreviewFragment.kt
@@ -402,7 +402,9 @@ class PreviewFragment : Fragment() {
                                     Toast.LENGTH_LONG).show()
                         }
                     }
-                    navController.popBackStack()
+                    Handler(Looper.getMainLooper()).post {
+                        navController.popBackStack()
+                    }
                 }
             }
 

From 7b0a87897c75329135c1ed5d205b6d0fbf9d0500 Mon Sep 17 00:00:00 2001
From: Kailiang Chen <kailianc@google.com>
Date: Mon, 27 Nov 2023 17:33:20 -0800
Subject: [PATCH 13/22] [Camera2Video] Add note that MediaRecorder is not
 supporting HDR Video capture

Bug: b/308178715
Test: test on real devices
Change-Id: Ide226dd460ff05737f21850260ffc315cfdd423d
---
 .../android/camera2/video/fragments/EncodeApiFragment.kt  | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
index cd8c4146..c4022776 100644
--- a/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
+++ b/Camera2Video/app/src/main/java/com/example/android/camera2/video/fragments/EncodeApiFragment.kt
@@ -52,7 +52,7 @@ class EncodeApiFragment : Fragment() {
         view as RecyclerView
         view.apply {
             layoutManager = LinearLayoutManager(requireContext())
-            val modeList = enumerateModes()
+            val modeList = enumerateModes(args.dynamicRange)
             val layoutId = android.R.layout.simple_list_item_1
             adapter = GenericListAdapter(modeList, itemLayoutId = layoutId) { view, item, _ ->
                 view.findViewById<TextView>(android.R.id.text1).text = item.name
@@ -79,11 +79,13 @@ class EncodeApiFragment : Fragment() {
                 val value: Boolean)
 
         @SuppressLint("InlinedApi")
-        private fun enumerateModes(): List<ApiInfo> {
+        private fun enumerateModes(dynamicRange: Long): List<ApiInfo> {
             val modeList: MutableList<ApiInfo> = mutableListOf()
 
             modeList.add(ApiInfo("MediaCodec", false))
-            modeList.add(ApiInfo("MediaRecorder", true))
+            if (dynamicRange == DynamicRangeProfiles.STANDARD) {
+                modeList.add(ApiInfo("MediaRecorder", true))
+            }
 
             return modeList
         }

From 4428a9fb3335d04424d8e7c9b83f07149ab36017 Mon Sep 17 00:00:00 2001
From: Tiger Meng <tigerm@google.com>
Date: Mon, 15 Jan 2024 07:54:52 +0800
Subject: [PATCH 14/22] upgrade dependency version of CameraXExtension

for One UI 6.0
---
 CameraXExtensions/app/build.gradle | 4 ++--
 CameraXExtensions/build.gradle     | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CameraXExtensions/app/build.gradle b/CameraXExtensions/app/build.gradle
index bd651a4e..1a07b333 100644
--- a/CameraXExtensions/app/build.gradle
+++ b/CameraXExtensions/app/build.gradle
@@ -27,7 +27,7 @@ kapt {
 
 android {
     namespace 'com.example.android.cameraxextensions'
-    compileSdk 33
+    compileSdk 34
 
     defaultConfig {
         applicationId "com.example.android.cameraxextensions"
@@ -44,7 +44,7 @@ android {
     }
 
     composeOptions {
-        kotlinCompilerExtensionVersion = "1.3.2"
+        kotlinCompilerExtensionVersion = "1.5.8"
     }
 
     buildTypes {
diff --git a/CameraXExtensions/build.gradle b/CameraXExtensions/build.gradle
index 0dcda53a..8b68c98f 100644
--- a/CameraXExtensions/build.gradle
+++ b/CameraXExtensions/build.gradle
@@ -17,10 +17,10 @@
 // Top-level build file where you can add configuration options common to all sub-projects/modules.
 buildscript {
     // Top-level variables used for versioning
-    ext.kotlin_version = '1.7.20'
+    ext.kotlin_version = '1.9.22'
     ext.java_version = JavaVersion.VERSION_11
 
-    ext.camerax_version = '1.2.0-beta02'
+    ext.camerax_version = '1.4.0-alpha03'
     ext.coroutines_version = '1.6.0'
     ext.lifecycle_version = '2.5.1'
     ext.camerax = '1.2.0-alpha04'

From 602a586dd355e4517329e29d53e9c0531631b094 Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Fri, 29 Sep 2023 14:23:24 -0400
Subject: [PATCH 15/22] Update dependency versions and gradle version

- update all dep versions to latest
- update gradle to 8.11
- update corutines and kotlin versions to latest
---
 CameraXExtensions/app/build.gradle            | 34 +++++++++----------
 CameraXExtensions/build.gradle                |  3 +-
 CameraXExtensions/gradle.properties           |  4 ++-
 .../gradle/wrapper/gradle-wrapper.properties  |  2 +-
 4 files changed, 22 insertions(+), 21 deletions(-)

diff --git a/CameraXExtensions/app/build.gradle b/CameraXExtensions/app/build.gradle
index 1a07b333..f2c2d6f0 100644
--- a/CameraXExtensions/app/build.gradle
+++ b/CameraXExtensions/app/build.gradle
@@ -32,7 +32,7 @@ android {
     defaultConfig {
         applicationId "com.example.android.cameraxextensions"
         minSdk 24
-        targetSdk 33
+        targetSdk 34
         versionCode 1
         versionName "1.0.0"
 
@@ -67,7 +67,7 @@ android {
 
 dependencies {
     // Kotlin lang
-    implementation 'androidx.core:core-ktx:1.9.0'
+    implementation 'androidx.core:core-ktx:1.12.0'
 
     // CameraX
     implementation "androidx.camera:camera-core:$camerax_version"
@@ -88,25 +88,25 @@ dependencies {
     implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:$lifecycle_version"
 
     // Image loading
-    implementation "io.coil-kt:coil:2.1.0"
+    implementation "io.coil-kt:coil:2.4.0"
 
     // Compose
-    implementation 'androidx.compose.material:material:1.2.1'
-    implementation 'androidx.compose.ui:ui:1.2.1'
-    implementation 'androidx.compose.ui:ui-tooling-preview:1.2.1'
-    debugImplementation 'androidx.compose.ui:ui-tooling:1.2.1'
-    implementation 'androidx.activity:activity-compose:1.6.0'
-    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.5.1'
-
-    implementation 'androidx.activity:activity-ktx:1.6.0'
-    implementation 'androidx.appcompat:appcompat:1.5.1'
-    implementation 'com.google.android.material:material:1.6.1'
+    implementation 'androidx.compose.material:material:1.5.1'
+    implementation 'androidx.compose.ui:ui:1.5.1'
+    implementation 'androidx.compose.ui:ui-tooling-preview:1.5.1'
+    debugImplementation 'androidx.compose.ui:ui-tooling:1.5.1'
+    implementation 'androidx.activity:activity-compose:1.7.2'
+    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.6.2'
+
+    implementation 'androidx.activity:activity-ktx:1.7.2'
+    implementation 'androidx.appcompat:appcompat:1.6.1'
+    implementation 'com.google.android.material:material:1.9.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
-    implementation "androidx.recyclerview:recyclerview:1.2.1"
+    implementation "androidx.recyclerview:recyclerview:1.3.1"
 
 
     // Test
     testImplementation 'junit:junit:4.13.2'
-    androidTestImplementation 'androidx.test.ext:junit:1.1.3'
-    androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
-}
\ No newline at end of file
+    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
+    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
+}
diff --git a/CameraXExtensions/build.gradle b/CameraXExtensions/build.gradle
index 8b68c98f..fdea8ce2 100644
--- a/CameraXExtensions/build.gradle
+++ b/CameraXExtensions/build.gradle
@@ -23,14 +23,13 @@ buildscript {
     ext.camerax_version = '1.4.0-alpha03'
     ext.coroutines_version = '1.6.0'
     ext.lifecycle_version = '2.5.1'
-    ext.camerax = '1.2.0-alpha04'
 
     repositories {
         google()
         mavenCentral()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:7.3.0'
+        classpath 'com.android.tools.build:gradle:8.1.1'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
 
         // NOTE: Do not place your application dependencies here; they belong
diff --git a/CameraXExtensions/gradle.properties b/CameraXExtensions/gradle.properties
index fc8b66af..fad33040 100644
--- a/CameraXExtensions/gradle.properties
+++ b/CameraXExtensions/gradle.properties
@@ -36,4 +36,6 @@ kotlin.code.style=official
 # Enables namespacing of each library's R class so that its R class includes only the
 # resources declared in the library itself and none from the library's dependencies,
 # thereby reducing the size of the R class for that library
-android.nonTransitiveRClass=true
\ No newline at end of file
+android.nonTransitiveRClass=true
+android.defaults.buildfeatures.buildconfig=true
+android.nonFinalResIds=false
\ No newline at end of file
diff --git a/CameraXExtensions/gradle/wrapper/gradle-wrapper.properties b/CameraXExtensions/gradle/wrapper/gradle-wrapper.properties
index f357f21f..3d714831 100644
--- a/CameraXExtensions/gradle/wrapper/gradle-wrapper.properties
+++ b/CameraXExtensions/gradle/wrapper/gradle-wrapper.properties
@@ -16,7 +16,7 @@
 
 #Wed Aug 03 16:12:29 EDT 2022
 distributionBase=GRADLE_USER_HOME
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-rc-2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
 distributionPath=wrapper/dists
 zipStorePath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME

From 0b6ce4be0395108b35efae2660cb42095b151c71 Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Sat, 18 May 2024 19:04:16 -0400
Subject: [PATCH 16/22] Update lib versions

- update versions to latest

Test: n/a
---
 CameraXExtensions/app/build.gradle | 26 ++++++++++++++------------
 CameraXExtensions/build.gradle     |  6 +++---
 2 files changed, 17 insertions(+), 15 deletions(-)

diff --git a/CameraXExtensions/app/build.gradle b/CameraXExtensions/app/build.gradle
index f2c2d6f0..23f27ee4 100644
--- a/CameraXExtensions/app/build.gradle
+++ b/CameraXExtensions/app/build.gradle
@@ -67,7 +67,7 @@ android {
 
 dependencies {
     // Kotlin lang
-    implementation 'androidx.core:core-ktx:1.12.0'
+    implementation 'androidx.core:core-ktx:1.13.1'
 
     // CameraX
     implementation "androidx.camera:camera-core:$camerax_version"
@@ -90,20 +90,22 @@ dependencies {
     // Image loading
     implementation "io.coil-kt:coil:2.4.0"
 
+    // Material Components
+    implementation 'com.google.android.material:material:1.12.0'
+
     // Compose
-    implementation 'androidx.compose.material:material:1.5.1'
-    implementation 'androidx.compose.ui:ui:1.5.1'
-    implementation 'androidx.compose.ui:ui-tooling-preview:1.5.1'
-    debugImplementation 'androidx.compose.ui:ui-tooling:1.5.1'
-    implementation 'androidx.activity:activity-compose:1.7.2'
-    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.6.2'
-
-    implementation 'androidx.activity:activity-ktx:1.7.2'
+    implementation 'androidx.compose.material:material:1.6.7'
+    implementation 'androidx.compose.ui:ui:1.6.7'
+    implementation 'androidx.compose.ui:ui-tooling-preview:1.6.7'
+    debugImplementation 'androidx.compose.ui:ui-tooling:1.6.7'
+    implementation 'androidx.activity:activity-compose:1.9.0'
+    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.0'
+
+    implementation 'androidx.activity:activity-ktx:1.9.0'
     implementation 'androidx.appcompat:appcompat:1.6.1'
-    implementation 'com.google.android.material:material:1.9.0'
+    implementation 'com.google.android.material:material:1.12.0'
     implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
-    implementation "androidx.recyclerview:recyclerview:1.3.1"
-
+    implementation "androidx.recyclerview:recyclerview:1.3.2"
 
     // Test
     testImplementation 'junit:junit:4.13.2'
diff --git a/CameraXExtensions/build.gradle b/CameraXExtensions/build.gradle
index fdea8ce2..b32135f3 100644
--- a/CameraXExtensions/build.gradle
+++ b/CameraXExtensions/build.gradle
@@ -20,9 +20,9 @@ buildscript {
     ext.kotlin_version = '1.9.22'
     ext.java_version = JavaVersion.VERSION_11
 
-    ext.camerax_version = '1.4.0-alpha03'
-    ext.coroutines_version = '1.6.0'
-    ext.lifecycle_version = '2.5.1'
+    ext.camerax_version = '1.4.0-beta01'
+    ext.coroutines_version = '1.8.1'
+    ext.lifecycle_version = '2.8.0'
 
     repositories {
         google()

From 2e47ccb4f6ce051c2a31c56af49207bad34fb787 Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Sat, 18 May 2024 19:05:44 -0400
Subject: [PATCH 17/22] Add UI for Progress Indicator and Postview

- UI to show the processing progress indicator
- this will animate the progress on each progress update
- UI to show the postview

Test: manually tested using S24
---
 .../ui/CameraExtensionsScreen.kt              | 44 +++++++++++++++++++
 .../app/src/main/res/layout/activity_main.xml | 26 +++++++++++
 2 files changed, 70 insertions(+)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
index 40fd2f78..13c5deb4 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
@@ -18,8 +18,10 @@ package com.example.android.cameraxextensions.ui
 
 import android.animation.Animator
 import android.animation.AnimatorListenerAdapter
+import android.animation.ObjectAnimator
 import android.annotation.SuppressLint
 import android.content.Context
+import android.graphics.Bitmap
 import android.net.Uri
 import android.util.TypedValue
 import android.view.GestureDetector.SimpleOnGestureListener
@@ -46,9 +48,11 @@ import com.example.android.cameraxextensions.model.CameraUiAction
 import com.example.android.cameraxextensions.viewstate.CameraPreviewScreenViewState
 import com.example.android.cameraxextensions.viewstate.CaptureScreenViewState
 import com.example.android.cameraxextensions.viewstate.PostCaptureScreenViewState
+import com.google.android.material.progressindicator.CircularProgressIndicator
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.MutableSharedFlow
 import kotlinx.coroutines.launch
+import kotlin.math.max
 
 /**
  * Displays the camera preview and captured photo.
@@ -63,6 +67,7 @@ class CameraExtensionsScreen(private val root: View) {
         private const val SPRING_STIFFNESS_ALPHA_OUT = 100f
         private const val SPRING_STIFFNESS = 800f
         private const val SPRING_DAMPING_RATIO = 0.35f
+        private const val MAX_PROGRESS_ANIM_DURATION_MS = 3000
     }
 
     private val context: Context = root.context
@@ -79,6 +84,9 @@ class CameraExtensionsScreen(private val root: View) {
     private val permissionsRationale: TextView = root.findViewById(R.id.permissionsRationale)
     private val permissionsRequestButton: TextView =
         root.findViewById(R.id.permissionsRequestButton)
+    private val photoPostview: ImageView = root.findViewById(R.id.photoPostview)
+    private val processProgressIndicator: CircularProgressIndicator =
+        root.findViewById(R.id.processProgressIndicator)
 
     val previewView: PreviewView = root.findViewById(R.id.previewView)
 
@@ -216,6 +224,30 @@ class CameraExtensionsScreen(private val root: View) {
         }
     }
 
+    private fun showPostview(bitmap: Bitmap) {
+        if (photoPostview.isVisible) return
+        photoPostview.isVisible = true
+        photoPostview.load(bitmap)
+    }
+
+    private fun hidePostview() {
+        photoPostview.isVisible = false
+    }
+
+    private fun showProcessProgressIndicator(progress: Int) {
+        processProgressIndicator.isVisible = true
+        ObjectAnimator.ofInt(processProgressIndicator, "progress", progress).apply {
+            val currentProgress = processProgressIndicator.progress
+            val progressStep = max(0, progress - currentProgress)
+            duration = (progressStep / 100f * MAX_PROGRESS_ANIM_DURATION_MS).toLong()
+            start()
+        }
+    }
+
+    private fun hideProcessProgressIndicator() {
+        processProgressIndicator.isVisible = false
+    }
+
     private fun showPhoto(uri: Uri?) {
         if (uri == null) return
         photoPreview.isVisible = true
@@ -237,6 +269,18 @@ class CameraExtensionsScreen(private val root: View) {
 
         extensionSelector.isVisible = state.extensionsSelectorViewState.isVisible
         extensionsAdapter.submitList(state.extensionsSelectorViewState.extensions)
+
+        if (state.postviewViewState.isVisible) {
+            showPostview(state.postviewViewState.bitmap!!)
+        } else {
+            hidePostview()
+        }
+
+        if (state.processProgressViewState.isVisible) {
+            showProcessProgressIndicator(state.processProgressViewState.progress)
+        } else {
+            hideProcessProgressIndicator()
+        }
     }
 
     private fun onItemClick(view: View) {
diff --git a/CameraXExtensions/app/src/main/res/layout/activity_main.xml b/CameraXExtensions/app/src/main/res/layout/activity_main.xml
index 617f1443..9d574a29 100644
--- a/CameraXExtensions/app/src/main/res/layout/activity_main.xml
+++ b/CameraXExtensions/app/src/main/res/layout/activity_main.xml
@@ -73,6 +73,17 @@
         app:srcCompat="@drawable/ic_flip_camera_android"
         app:tint="@color/button" />
 
+    <androidx.appcompat.widget.AppCompatImageView
+        android:id="@+id/photoPostview"
+        android:layout_width="0dp"
+        android:layout_height="0dp"
+        android:visibility="gone"
+        android:scaleType="centerCrop"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
     <androidx.appcompat.widget.AppCompatImageView
         android:id="@+id/photoPreview"
         android:layout_width="0dp"
@@ -97,6 +108,21 @@
         app:srcCompat="@drawable/ic_close"
         app:tint="@color/button" />
 
+    <com.google.android.material.progressindicator.CircularProgressIndicator
+        android:id="@+id/processProgressIndicator"
+        android:layout_width="80dp"
+        android:layout_height="80dp"
+        android:visibility="gone"
+        app:indicatorSize="80dp"
+        app:indicatorColor="#FFBE0B"
+        app:trackColor="#272727"
+        app:trackThickness="4dp"
+        app:trackCornerRadius="2dp"
+        app:layout_constraintBottom_toBottomOf="parent"
+        app:layout_constraintEnd_toEndOf="parent"
+        app:layout_constraintStart_toStartOf="parent"
+        app:layout_constraintTop_toTopOf="parent" />
+
     <androidx.appcompat.widget.LinearLayoutCompat
         android:id="@+id/permissionsRationaleContainer"
         android:layout_width="0dp"

From 5ab09ac6a5a3f73bada370c0effd453cd19195bc Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Sat, 18 May 2024 19:07:46 -0400
Subject: [PATCH 18/22] Wire functionality to show Postview and Processing
 Progress Indicator

- if the device supports process indicator then show process indicator
- if the device supports postview then show the postview

Test: manually tested using S24
---
 .../android/cameraxextensions/MainActivity.kt | 29 +++++++++++++--
 .../cameraxextensions/model/CameraUiState.kt  | 11 ++++++
 .../viewmodel/CameraExtensionsViewModel.kt    | 37 ++++++++++++++++++-
 .../viewstate/CameraPreviewScreenViewState.kt | 28 +++++++++++++-
 4 files changed, 98 insertions(+), 7 deletions(-)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
index 45394592..c1741111 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
@@ -24,7 +24,11 @@ import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
 import androidx.camera.extensions.ExtensionMode
 import androidx.core.app.ActivityCompat
-import androidx.lifecycle.*
+import androidx.lifecycle.Lifecycle
+import androidx.lifecycle.LifecycleOwner
+import androidx.lifecycle.ViewModelProvider
+import androidx.lifecycle.lifecycleScope
+import androidx.lifecycle.repeatOnLifecycle
 import com.example.android.cameraxextensions.adapter.CameraExtensionItem
 import com.example.android.cameraxextensions.model.CameraState
 import com.example.android.cameraxextensions.model.CameraUiAction
@@ -203,9 +207,10 @@ class MainActivity : AppCompatActivity() {
                                     } else {
                                         PostCaptureScreenViewState.PostCaptureScreenHiddenViewState
                                     }
-                                }
-                                .updateCameraScreen {
+                                }.updateCameraScreen {
                                     it.hideCameraControls()
+                                        .hideProcessProgressViewState()
+                                        .hidePostview()
                                 }
                         )
                     }
@@ -220,6 +225,24 @@ class MainActivity : AppCompatActivity() {
                                     it.showCameraControls()
                                         .enableCameraShutter(true)
                                         .enableSwitchLens(true)
+                                        .hideProcessProgressViewState()
+                                        .hidePostview()
+                                }
+                        )
+                    }
+                    is CaptureState.CapturePostview -> {
+                        captureScreenViewState.emit(
+                            captureScreenViewState.value
+                                .updateCameraScreen {
+                                    it.showPostview(state.bitmap)
+                                }
+                        )
+                    }
+                    is CaptureState.CaptureProcessProgress -> {
+                        captureScreenViewState.emit(
+                            captureScreenViewState.value
+                                .updateCameraScreen {
+                                    it.showProcessProgressViewState(state.progress)
                                 }
                         )
                     }
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
index e07fb2b4..94988278 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
@@ -16,6 +16,7 @@
 
 package com.example.android.cameraxextensions.model
 
+import android.graphics.Bitmap
 import androidx.camera.core.CameraSelector.LENS_FACING_BACK
 import androidx.camera.core.CameraSelector.LensFacing
 import androidx.camera.core.ImageCapture
@@ -74,6 +75,16 @@ sealed class CaptureState {
      */
     object CaptureStarted : CaptureState()
 
+    /**
+     * Capture postview is ready
+     */
+    data class CapturePostview(val bitmap: Bitmap): CaptureState()
+
+    /**
+     * Capture process progress updated with the [progress] value
+     */
+    data class CaptureProcessProgress(val progress: Int): CaptureState()
+
     /**
      * Capture completed successfully.
      */
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
index c53aa38f..8ebcbb0d 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
@@ -17,13 +17,13 @@
 package com.example.android.cameraxextensions.viewmodel
 
 import android.app.Application
+import android.graphics.Bitmap
 import androidx.camera.core.*
 import androidx.camera.core.CameraSelector.LensFacing
 import androidx.camera.extensions.ExtensionMode
 import androidx.camera.extensions.ExtensionsManager
 import androidx.camera.lifecycle.ProcessCameraProvider
 import androidx.camera.view.PreviewView
-import androidx.compose.ui.layout.ScaleFactor
 import androidx.core.net.toUri
 import androidx.lifecycle.LifecycleOwner
 import androidx.lifecycle.ViewModel
@@ -58,7 +58,7 @@ class CameraExtensionsViewModel(
 
     private var camera: Camera? = null
 
-    private val imageCapture = ImageCapture.Builder()
+    private var imageCapture = ImageCapture.Builder()
         .setTargetAspectRatio(AspectRatio.RATIO_16_9)
         .build()
 
@@ -142,6 +142,19 @@ class CameraExtensionsViewModel(
                 currentCameraUiState.extensionMode
             )
         }
+
+        cameraProvider.unbindAll()
+        camera = cameraProvider.bindToLifecycle(lifecycleOwner, cameraSelector)
+
+        camera?.cameraInfo?.let {
+            val isPostviewSupported =
+                ImageCapture.getImageCaptureCapabilities(it).isPostviewSupported
+            imageCapture = ImageCapture.Builder()
+                .setTargetAspectRatio(AspectRatio.RATIO_16_9)
+                .setPostviewEnabled(isPostviewSupported)
+                .build()
+        }
+
         val useCaseGroup = UseCaseGroup.Builder()
             .setViewPort(previewView.viewPort!!)
             .addUseCase(imageCapture)
@@ -223,6 +236,14 @@ class CameraExtensionsViewModel(
                 .setMetadata(metadata)
                 .build()
 
+        camera?.cameraInfo?.let {
+            if (ImageCapture.getImageCaptureCapabilities(it).isCaptureProcessProgressSupported) {
+                viewModelScope.launch {
+                    _captureUiState.emit(CaptureState.CaptureProcessProgress(0))
+                }
+            }
+        }
+
         imageCapture.takePicture(
             outputFileOptions,
             Dispatchers.Default.asExecutor(),
@@ -242,6 +263,18 @@ class CameraExtensionsViewModel(
                         _captureUiState.emit(CaptureState.CaptureFailed(exception))
                     }
                 }
+
+                override fun onCaptureProcessProgressed(progress: Int) {
+                    viewModelScope.launch {
+                        _captureUiState.emit(CaptureState.CaptureProcessProgress(progress))
+                    }
+                }
+
+                override fun onPostviewBitmapAvailable(bitmap: Bitmap) {
+                    viewModelScope.launch {
+                        _captureUiState.emit(CaptureState.CapturePostview(bitmap))
+                    }
+                }
             })
     }
 
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewstate/CameraPreviewScreenViewState.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewstate/CameraPreviewScreenViewState.kt
index 0badce1f..13aecb06 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewstate/CameraPreviewScreenViewState.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewstate/CameraPreviewScreenViewState.kt
@@ -16,6 +16,7 @@
 
 package com.example.android.cameraxextensions.viewstate
 
+import android.graphics.Bitmap
 import com.example.android.cameraxextensions.adapter.CameraExtensionItem
 
 /**
@@ -25,7 +26,9 @@ import com.example.android.cameraxextensions.adapter.CameraExtensionItem
 data class CameraPreviewScreenViewState(
     val shutterButtonViewState: ShutterButtonViewState = ShutterButtonViewState(),
     val switchLensButtonViewState: SwitchLensButtonViewState = SwitchLensButtonViewState(),
-    val extensionsSelectorViewState: CameraExtensionSelectorViewState = CameraExtensionSelectorViewState()
+    val extensionsSelectorViewState: CameraExtensionSelectorViewState = CameraExtensionSelectorViewState(),
+    val processProgressViewState: ProcessProgressIndicatorViewState = ProcessProgressIndicatorViewState(),
+    val postviewViewState: PostviewViewState = PostviewViewState()
 ) {
     fun hideCameraControls(): CameraPreviewScreenViewState =
         copy(
@@ -49,6 +52,17 @@ data class CameraPreviewScreenViewState(
 
     fun setAvailableExtensions(extensions: List<CameraExtensionItem>): CameraPreviewScreenViewState =
         copy(extensionsSelectorViewState = extensionsSelectorViewState.copy(extensions = extensions))
+
+    fun showPostview(bitmap: Bitmap): CameraPreviewScreenViewState =
+        copy(postviewViewState = PostviewViewState(isVisible = true, bitmap = bitmap))
+
+    fun hidePostview(): CameraPreviewScreenViewState = copy(postviewViewState = PostviewViewState())
+
+    fun showProcessProgressViewState(progress: Int): CameraPreviewScreenViewState =
+        copy(processProgressViewState = ProcessProgressIndicatorViewState(isVisible = true, progress = progress))
+
+    fun hideProcessProgressViewState(): CameraPreviewScreenViewState =
+        copy(processProgressViewState = ProcessProgressIndicatorViewState())
 }
 
 data class CameraExtensionSelectorViewState(
@@ -64,4 +78,14 @@ data class ShutterButtonViewState(
 data class SwitchLensButtonViewState(
     val isVisible: Boolean = false,
     val isEnabled: Boolean = false
-)
\ No newline at end of file
+)
+
+data class ProcessProgressIndicatorViewState(
+    val isVisible: Boolean = false,
+    val progress: Int = 0
+)
+
+data class PostviewViewState(
+    val isVisible: Boolean = false,
+    val bitmap: Bitmap? = null
+)

From e97a8dda7e51a827e67507758cbba73087a2922d Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Thu, 23 May 2024 14:23:47 -0400
Subject: [PATCH 19/22] Improve UI and UX flow when using postview and proccess
 progress

- add a hold still text
- add a background for the progress and hold still text
- make sure the spinner animates to 100 before switching out postview for final capture

Test: manual testing on pixel 8
---
 .../android/cameraxextensions/MainActivity.kt | 54 +++++++++++++------
 .../cameraxextensions/model/CameraUiAction.kt |  9 ++--
 .../ui/CameraExtensionsScreen.kt              | 14 ++++-
 .../viewmodel/CameraExtensionsViewModel.kt    | 10 +++-
 .../app/src/main/res/layout/activity_main.xml | 43 +++++++++++----
 .../app/src/main/res/values/strings.xml       |  2 +
 6 files changed, 97 insertions(+), 35 deletions(-)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
index c1741111..30c82cb2 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
@@ -18,6 +18,7 @@ package com.example.android.cameraxextensions
 
 import android.Manifest
 import android.content.pm.PackageManager
+import android.net.Uri
 import android.os.Bundle
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.result.contract.ActivityResultContracts
@@ -80,6 +81,29 @@ class MainActivity : AppCompatActivity() {
     // monitors changes in camera permission state
     private lateinit var permissionState: MutableStateFlow<PermissionState>
 
+    private var captureUri: Uri? = null
+    private var progressComplete: Boolean = false
+
+    private suspend fun showCapture() {
+        if (captureUri == null || !progressComplete) return
+
+        cameraExtensionsViewModel.stopPreview()
+        captureScreenViewState.emit(
+            captureScreenViewState.value
+                .updatePostCaptureScreen {
+                    captureUri?.let {
+                        PostCaptureScreenViewState.PostCaptureScreenVisibleViewState(it)
+                    } ?: PostCaptureScreenViewState.PostCaptureScreenHiddenViewState
+                }.updateCameraScreen {
+                    it.hideCameraControls()
+                        .hideProcessProgressViewState()
+                        .hidePostview()
+                }
+        )
+        captureUri = null
+        progressComplete = false
+    }
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
 
@@ -149,6 +173,10 @@ class MainActivity : AppCompatActivity() {
                     CameraUiAction.RequestPermissionClick -> {
                         requestPermissionsLauncher.launch(Manifest.permission.CAMERA)
                     }
+                    CameraUiAction.ProcessProgressComplete -> {
+                        progressComplete = true
+                        showCapture()
+                    }
                     is CameraUiAction.Focus -> {
                         cameraExtensionsViewModel.focus(action.meteringPoint)
                     }
@@ -195,24 +223,16 @@ class MainActivity : AppCompatActivity() {
                         )
                     }
                     is CaptureState.CaptureFinished -> {
-                        cameraExtensionsViewModel.stopPreview()
-                        captureScreenViewState.emit(
-                            captureScreenViewState.value
-                                .updatePostCaptureScreen {
-                                    val uri = state.outputResults.savedUri
-                                    if (uri != null) {
-                                        PostCaptureScreenViewState.PostCaptureScreenVisibleViewState(
-                                            uri
-                                        )
-                                    } else {
-                                        PostCaptureScreenViewState.PostCaptureScreenHiddenViewState
+                        captureUri = state.outputResults.savedUri
+                        if (!progressComplete) {
+                            captureScreenViewState.emit(
+                                captureScreenViewState.value
+                                    .updateCameraScreen {
+                                        it.showProcessProgressViewState(100)
                                     }
-                                }.updateCameraScreen {
-                                    it.hideCameraControls()
-                                        .hideProcessProgressViewState()
-                                        .hidePostview()
-                                }
-                        )
+                            )
+                        }
+                        showCapture()
                     }
                     is CaptureState.CaptureFailed -> {
                         cameraExtensionsScreen.showCaptureError("Couldn't take photo")
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiAction.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiAction.kt
index 5ba45715..13c9dfb1 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiAction.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiAction.kt
@@ -23,10 +23,11 @@ import androidx.camera.extensions.ExtensionMode
  * User initiated actions related to camera operations.
  */
 sealed class CameraUiAction {
-    object RequestPermissionClick : CameraUiAction()
-    object SwitchCameraClick : CameraUiAction()
-    object ShutterButtonClick : CameraUiAction()
-    object ClosePhotoPreviewClick : CameraUiAction()
+    data object RequestPermissionClick : CameraUiAction()
+    data object SwitchCameraClick : CameraUiAction()
+    data object ShutterButtonClick : CameraUiAction()
+    data object ClosePhotoPreviewClick : CameraUiAction()
+    data object ProcessProgressComplete : CameraUiAction()
     data class SelectCameraExtension(@ExtensionMode.Mode val extension: Int) : CameraUiAction()
     data class Focus(val meteringPoint: MeteringPoint) : CameraUiAction()
     data class Scale(val scaleFactor: Float) : CameraUiAction()
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
index 13c5deb4..ed7e8431 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
@@ -32,6 +32,7 @@ import android.widget.ImageView
 import android.widget.TextView
 import android.widget.Toast
 import androidx.camera.view.PreviewView
+import androidx.core.animation.doOnEnd
 import androidx.core.view.GestureDetectorCompat
 import androidx.core.view.isVisible
 import androidx.dynamicanimation.animation.DynamicAnimation
@@ -85,6 +86,8 @@ class CameraExtensionsScreen(private val root: View) {
     private val permissionsRequestButton: TextView =
         root.findViewById(R.id.permissionsRequestButton)
     private val photoPostview: ImageView = root.findViewById(R.id.photoPostview)
+    private val processProgressContainer: View =
+        root.findViewById(R.id.processProgressContainer)
     private val processProgressIndicator: CircularProgressIndicator =
         root.findViewById(R.id.processProgressIndicator)
 
@@ -235,17 +238,24 @@ class CameraExtensionsScreen(private val root: View) {
     }
 
     private fun showProcessProgressIndicator(progress: Int) {
-        processProgressIndicator.isVisible = true
+        processProgressContainer.isVisible = true
         ObjectAnimator.ofInt(processProgressIndicator, "progress", progress).apply {
             val currentProgress = processProgressIndicator.progress
             val progressStep = max(0, progress - currentProgress)
             duration = (progressStep / 100f * MAX_PROGRESS_ANIM_DURATION_MS).toLong()
+            doOnEnd {
+                if (animatedValue == 100) {
+                    root.findViewTreeLifecycleOwner()?.lifecycleScope?.launch {
+                        _action.emit(CameraUiAction.ProcessProgressComplete)
+                    }
+                }
+            }
             start()
         }
     }
 
     private fun hideProcessProgressIndicator() {
-        processProgressIndicator.isVisible = false
+        processProgressContainer.isVisible = false
     }
 
     private fun showPhoto(uri: Uri?) {
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
index 8ebcbb0d..5d738a25 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
@@ -18,8 +18,16 @@ package com.example.android.cameraxextensions.viewmodel
 
 import android.app.Application
 import android.graphics.Bitmap
-import androidx.camera.core.*
+import androidx.camera.core.AspectRatio
+import androidx.camera.core.Camera
+import androidx.camera.core.CameraSelector
 import androidx.camera.core.CameraSelector.LensFacing
+import androidx.camera.core.FocusMeteringAction
+import androidx.camera.core.ImageCapture
+import androidx.camera.core.ImageCaptureException
+import androidx.camera.core.MeteringPoint
+import androidx.camera.core.Preview
+import androidx.camera.core.UseCaseGroup
 import androidx.camera.extensions.ExtensionMode
 import androidx.camera.extensions.ExtensionsManager
 import androidx.camera.lifecycle.ProcessCameraProvider
diff --git a/CameraXExtensions/app/src/main/res/layout/activity_main.xml b/CameraXExtensions/app/src/main/res/layout/activity_main.xml
index 9d574a29..d1c82264 100644
--- a/CameraXExtensions/app/src/main/res/layout/activity_main.xml
+++ b/CameraXExtensions/app/src/main/res/layout/activity_main.xml
@@ -108,20 +108,41 @@
         app:srcCompat="@drawable/ic_close"
         app:tint="@color/button" />
 
-    <com.google.android.material.progressindicator.CircularProgressIndicator
-        android:id="@+id/processProgressIndicator"
-        android:layout_width="80dp"
-        android:layout_height="80dp"
-        android:visibility="gone"
-        app:indicatorSize="80dp"
-        app:indicatorColor="#FFBE0B"
-        app:trackColor="#272727"
-        app:trackThickness="4dp"
-        app:trackCornerRadius="2dp"
+    <LinearLayout
+        android:id="@+id/processProgressContainer"
+        android:layout_width="wrap_content"
+        android:layout_height="wrap_content"
+        android:orientation="vertical"
+        android:background="@drawable/selector_background"
+        android:gravity="center"
+        android:visibility="visible"
+        android:paddingHorizontal="84dp"
+        android:paddingVertical="16dp"
         app:layout_constraintBottom_toBottomOf="parent"
         app:layout_constraintEnd_toEndOf="parent"
         app:layout_constraintStart_toStartOf="parent"
-        app:layout_constraintTop_toTopOf="parent" />
+        app:layout_constraintTop_toTopOf="parent" >
+
+        <androidx.appcompat.widget.AppCompatTextView
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:textStyle="bold"
+            android:textColor="#FFBE0B"
+            android:textSize="16sp"
+            android:text="@string/hold_still"
+            android:layout_marginBottom="8dp"
+            />
+
+        <com.google.android.material.progressindicator.CircularProgressIndicator
+            android:id="@+id/processProgressIndicator"
+            android:layout_width="64dp"
+            android:layout_height="64dp"
+            app:indicatorSize="64dp"
+            app:indicatorColor="#FFBE0B"
+            app:trackColor="#272727"
+            app:trackThickness="6dp"
+            app:trackCornerRadius="3dp" />
+    </LinearLayout>
 
     <androidx.appcompat.widget.LinearLayoutCompat
         android:id="@+id/permissionsRationaleContainer"
diff --git a/CameraXExtensions/app/src/main/res/values/strings.xml b/CameraXExtensions/app/src/main/res/values/strings.xml
index 4f145381..04476385 100644
--- a/CameraXExtensions/app/src/main/res/values/strings.xml
+++ b/CameraXExtensions/app/src/main/res/values/strings.xml
@@ -27,4 +27,6 @@
     <string name="camera_permissions_request_with_rationale">You can\'t use camera extensions unless CameraX Extensions has access to your camera.</string>
     <string name="camera_permissions_request">Allow CameraX Extensions access to your camera to try camera extensions.</string>
     <string name="camera_permissions_action">Turn On</string>
+
+    <string name="hold_still">Hold Still</string>
 </resources>
\ No newline at end of file

From e37680f88cfc5bab89d31a0ba5de83adcf846dab Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Thu, 23 May 2024 18:37:03 -0400
Subject: [PATCH 20/22] Improve visual transition when going from postview to
 final capture

- show the postview
- show the final capture on top
---
 .../example/android/cameraxextensions/MainActivity.kt  |  5 ++++-
 .../cameraxextensions/ui/CameraExtensionsScreen.kt     | 10 ++++++++--
 2 files changed, 12 insertions(+), 3 deletions(-)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
index 30c82cb2..7a449222 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
@@ -20,6 +20,7 @@ import android.Manifest
 import android.content.pm.PackageManager
 import android.net.Uri
 import android.os.Bundle
+import android.util.Log
 import androidx.activity.OnBackPressedCallback
 import androidx.activity.result.contract.ActivityResultContracts
 import androidx.appcompat.app.AppCompatActivity
@@ -97,7 +98,6 @@ class MainActivity : AppCompatActivity() {
                 }.updateCameraScreen {
                     it.hideCameraControls()
                         .hideProcessProgressViewState()
-                        .hidePostview()
                 }
         )
         captureUri = null
@@ -201,6 +201,7 @@ class MainActivity : AppCompatActivity() {
                                 .updateCameraScreen {
                                     it.enableCameraShutter(true)
                                         .enableSwitchLens(true)
+                                        .hidePostview()
                                 }
                         )
                     }
@@ -302,6 +303,7 @@ class MainActivity : AppCompatActivity() {
                                     }
                                     .updateCameraScreen {
                                         it.showCameraControls()
+                                            .hidePostview()
                                             .enableCameraShutter(false)
                                             .enableSwitchLens(false)
                                     }
@@ -342,6 +344,7 @@ class MainActivity : AppCompatActivity() {
             captureScreenViewState.value
                 .updateCameraScreen { state ->
                     state.showCameraControls()
+                    state.hidePostview()
                 }
                 .updatePostCaptureScreen {
                     PostCaptureScreenViewState.PostCaptureScreenHiddenViewState
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
index ed7e8431..1f375af9 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
@@ -230,7 +230,10 @@ class CameraExtensionsScreen(private val root: View) {
     private fun showPostview(bitmap: Bitmap) {
         if (photoPostview.isVisible) return
         photoPostview.isVisible = true
-        photoPostview.load(bitmap)
+        photoPostview.load(bitmap) {
+            crossfade(true)
+            crossfade(200)
+        }
     }
 
     private fun hidePostview() {
@@ -261,7 +264,10 @@ class CameraExtensionsScreen(private val root: View) {
     private fun showPhoto(uri: Uri?) {
         if (uri == null) return
         photoPreview.isVisible = true
-        photoPreview.load(uri)
+        photoPreview.load(uri) {
+            crossfade(true)
+            crossfade(200)
+        }
         closePhotoPreview.isVisible = true
     }
 

From 7bb54ef4132d53dc59199d29cd1fa87432fc9428 Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Fri, 24 May 2024 15:59:31 -0400
Subject: [PATCH 21/22] Reset the progress indicator to 0

- reset the progress indicator to 0 before it gets displayed again
---
 .../android/cameraxextensions/ui/CameraExtensionsScreen.kt       | 1 +
 1 file changed, 1 insertion(+)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
index 1f375af9..e0fffd33 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
@@ -259,6 +259,7 @@ class CameraExtensionsScreen(private val root: View) {
 
     private fun hideProcessProgressIndicator() {
         processProgressContainer.isVisible = false
+        processProgressIndicator.progress = 0
     }
 
     private fun showPhoto(uri: Uri?) {

From c37d4a8dd1d2f603b7415caf076622ca8184402c Mon Sep 17 00:00:00 2001
From: Jag Saund <jagsaund@google.com>
Date: Fri, 24 May 2024 16:53:27 -0400
Subject: [PATCH 22/22] Fix issue where processing indicator shows when not
 supported

- if the device does not support processing indicator then the indicator still appears
- this fixes the issue
---
 .../android/cameraxextensions/MainActivity.kt       | 11 ++++-------
 .../cameraxextensions/model/CameraUiState.kt        |  5 ++++-
 .../cameraxextensions/ui/CameraExtensionsScreen.kt  |  2 ++
 .../viewmodel/CameraExtensionsViewModel.kt          | 13 ++++++++++++-
 4 files changed, 22 insertions(+), 9 deletions(-)

diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
index 7a449222..ec3522e7 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/MainActivity.kt
@@ -206,6 +206,8 @@ class MainActivity : AppCompatActivity() {
                         )
                     }
                     CaptureState.CaptureReady -> {
+                        captureUri = null
+                        progressComplete = false
                         captureScreenViewState.emit(
                             captureScreenViewState.value
                                 .updateCameraScreen {
@@ -225,13 +227,8 @@ class MainActivity : AppCompatActivity() {
                     }
                     is CaptureState.CaptureFinished -> {
                         captureUri = state.outputResults.savedUri
-                        if (!progressComplete) {
-                            captureScreenViewState.emit(
-                                captureScreenViewState.value
-                                    .updateCameraScreen {
-                                        it.showProcessProgressViewState(100)
-                                    }
-                            )
+                        if (!state.isProcessProgressSupported) {
+                            progressComplete = true
                         }
                         showCapture()
                     }
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
index 94988278..e86e09ce 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/model/CameraUiState.kt
@@ -88,7 +88,10 @@ sealed class CaptureState {
     /**
      * Capture completed successfully.
      */
-    data class CaptureFinished(val outputResults: ImageCapture.OutputFileResults) : CaptureState()
+    data class CaptureFinished(
+        val outputResults: ImageCapture.OutputFileResults,
+        val isProcessProgressSupported: Boolean
+    ) : CaptureState()
 
     /**
      * Capture failed with an error.
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
index e0fffd33..0befc776 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/ui/CameraExtensionsScreen.kt
@@ -242,6 +242,8 @@ class CameraExtensionsScreen(private val root: View) {
 
     private fun showProcessProgressIndicator(progress: Int) {
         processProgressContainer.isVisible = true
+        if (progress == processProgressIndicator.progress) return
+
         ObjectAnimator.ofInt(processProgressIndicator, "progress", progress).apply {
             val currentProgress = processProgressIndicator.progress
             val progressStep = max(0, progress - currentProgress)
diff --git a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
index 5d738a25..12623ae9 100644
--- a/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
+++ b/CameraXExtensions/app/src/main/java/com/example/android/cameraxextensions/viewmodel/CameraExtensionsViewModel.kt
@@ -261,8 +261,19 @@ class CameraExtensionsViewModel(
                         application,
                         outputFileResults.savedUri ?: photoFile.toUri()
                     )
+                    val isProcessProgressSupported = camera?.cameraInfo?.let {
+                        ImageCapture.getImageCaptureCapabilities(it).isCaptureProcessProgressSupported
+                    } ?: false
                     viewModelScope.launch {
-                        _captureUiState.emit(CaptureState.CaptureFinished(outputFileResults))
+                        if (isProcessProgressSupported) {
+                            _captureUiState.emit(CaptureState.CaptureProcessProgress(100))
+                        }
+                        _captureUiState.emit(
+                            CaptureState.CaptureFinished(
+                                outputFileResults,
+                                isProcessProgressSupported
+                            )
+                        )
                     }
                 }