camera_metadata: Raw is not croppable

Update spec doc to clarify that raw stream is not croppable.

Bug: 15168075
Change-Id: I4ffa8e2a06acd17913426ba37744bb9df1bc7330

diff --git a/camera/docs/docs.html b/camera/docs/docs.html
index 167d4e4..6c00bbf 100644 (file)
--- a/camera/docs/docs.html
+++ b/camera/docs/docs.html
@@ -12403,8 +12403,11 @@ maintain the stream's aspect ratio.<wbr/></p>
           </tr>
           <tr class="entry_cont">
             <td class="entry_details" colspan="5">
-              <p>Any additional per-stream cropping must be done to
-maximize the final pixel area of the stream.<wbr/></p>
+              <p>The crop region is applied after the RAW to other color space (e.<wbr/>g.<wbr/> YUV)
+conversion.<wbr/> Since raw streams (e.<wbr/>g.<wbr/> RAW16) don't have the conversion stage,<wbr/>
+it is not croppable.<wbr/> The crop region will be ignored by raw streams.<wbr/></p>
+<p>For non-raw streams,<wbr/> any additional per-stream cropping will
+be done to maximize the final pixel area of the stream.<wbr/></p>
 <p>For example,<wbr/> if the crop region is set to a 4:3 aspect
 ratio,<wbr/> then 4:3 streams should use the exact crop
 region.<wbr/> 16:9 streams should further crop vertically
@@ -13764,8 +13767,11 @@ maintain the stream's aspect ratio.<wbr/></p>
           </tr>
           <tr class="entry_cont">
             <td class="entry_details" colspan="5">
-              <p>Any additional per-stream cropping must be done to
-maximize the final pixel area of the stream.<wbr/></p>
+              <p>The crop region is applied after the RAW to other color space (e.<wbr/>g.<wbr/> YUV)
+conversion.<wbr/> Since raw streams (e.<wbr/>g.<wbr/> RAW16) don't have the conversion stage,<wbr/>
+it is not croppable.<wbr/> The crop region will be ignored by raw streams.<wbr/></p>
+<p>For non-raw streams,<wbr/> any additional per-stream cropping will
+be done to maximize the final pixel area of the stream.<wbr/></p>
 <p>For example,<wbr/> if the crop region is set to a 4:3 aspect
 ratio,<wbr/> then 4:3 streams should use the exact crop
 region.<wbr/> 16:9 streams should further crop vertically

diff --git a/camera/docs/metadata_properties.xml b/camera/docs/metadata_properties.xml
index 4c513ee..12b1dbf 100644 (file)
--- a/camera/docs/metadata_properties.xml
+++ b/camera/docs/metadata_properties.xml
@@ -3172,8 +3172,12 @@ xsi:schemaLocation="http://schemas.android.com/service/camera/metadata/ metadata
           in pixels; (0,0) is top-left corner of
           android.sensor.activeArraySize</units>
           <details>
-            Any additional per-stream cropping must be done to
-            maximize the final pixel area of the stream.
+            The crop region is applied after the RAW to other color space (e.g. YUV)
+            conversion. Since raw streams (e.g. RAW16) don't have the conversion stage,
+            it is not croppable. The crop region will be ignored by raw streams.
+
+            For non-raw streams, any additional per-stream cropping will
+            be done to maximize the final pixel area of the stream.
 
             For example, if the crop region is set to a 4:3 aspect
             ratio, then 4:3 streams should use the exact crop