Add 10 and 12b ranges to aom_color_range_t comment
Add note about undefined behavior in aom_codec_encode() description.
Bug: b/229104835
Change-Id: I63c5a6f263aa0c6f5c23ebf55e40aacf199d2afc
diff --git a/aom/aom_encoder.h b/aom/aom_encoder.h
index b4f2a7e..09617c0 100644
--- a/aom/aom_encoder.h
+++ b/aom/aom_encoder.h
@@ -1021,6 +1021,8 @@
*
* \param[in] ctx Pointer to this instance's context
* \param[in] img Image data to encode, NULL to flush.
+ * Encoding sample values outside the range
+ * [0..(1<<img->bit_depth)-1] is undefined behavior.
* \param[in] pts Presentation time stamp, in timebase units. If img
* is NULL, pts is ignored.
* \param[in] duration Duration to show frame, in timebase units. If img
diff --git a/aom/aom_image.h b/aom/aom_image.h
index 154563e1..d5f0c08 100644
--- a/aom/aom_image.h
+++ b/aom/aom_image.h
@@ -129,8 +129,12 @@
/*!\brief List of supported color range */
typedef enum aom_color_range {
- AOM_CR_STUDIO_RANGE = 0, /**< Y [16..235], UV [16..240] */
- AOM_CR_FULL_RANGE = 1 /**< YUV/RGB [0..255] */
+ AOM_CR_STUDIO_RANGE = 0, /**<- Y [16..235], UV [16..240] (bit depth 8) */
+ /**<- Y [64..940], UV [64..960] (bit depth 10) */
+ /**<- Y [256..3760], UV [256..3840] (bit depth 12) */
+ AOM_CR_FULL_RANGE = 1 /**<- YUV/RGB [0..255] (bit depth 8) */
+ /**<- YUV/RGB [0..1023] (bit depth 10) */
+ /**<- YUV/RGB [0..4095] (bit depth 12) */
} aom_color_range_t; /**< alias for enum aom_color_range */
/*!\brief List of chroma sample positions */
