[FFmpeg-cvslog] lavc: clarify color_range semantics

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Sun Jan 15 18:16:45 2023 +0100| [26eb3129dffed2fa4922b4336ce689403a65c6ed] | committer: Stefano Sabatini

lavc: clarify color_range semantics

Extend description for decoding and encoding use cases.

Address issue: http://trac.ffmpeg.org/ticket/443

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=26eb3129dffed2fa4922b4336ce689403a65c6ed
---

 libavcodec/avcodec.h | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index 18ca0e2494..1e91b9cb53 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -1016,8 +1016,11 @@ typedef struct AVCodecContext {
 
     /**
      * MPEG vs JPEG YUV range.
-     * - encoding: Set by user
-     * - decoding: Set by libavcodec
+     * - encoding: Set by user to override the default output color range value,
+     *   If not specified, libavcodec sets the color range depending on the
+     *   output format.
+     * - decoding: Set by libavcodec, can be set by the user to propagate the
+     *   color range to components reading from the decoder context.
      */
     enum AVColorRange color_range;