[FFmpeg-cvslog] lavc: Mark fields that require av_opt_ptr()

[Michael Niedermayer]

ffmpeg | branch: master | Michael Niedermayer <michaelni at gmx.at> | Mon Dec  5 13:23:17 2011 +0100| [51177b1fe93297d2dbb87802ef9bc18afc72fc21] | committer: Michael Niedermayer

lavc: Mark fields that require av_opt_ptr()

Signed-off-by: Michael Niedermayer <michaelni at gmx.at>

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

 libavcodec/avcodec.h |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/libavcodec/avcodec.h b/libavcodec/avcodec.h
index 132863b..e937c94 100644
--- a/libavcodec/avcodec.h
+++ b/libavcodec/avcodec.h
@@ -1256,6 +1256,8 @@ typedef struct AVFrame {
 
     /**
      * frame timestamp estimated using various heuristics, in stream time base
+     * Code outside libavcodec should access this field using:
+     *  av_opt_ptr(avcodec_get_frame_class(), frame, "best_effort_timestamp");
      * - encoding: unused
      * - decoding: set by libavcodec, read by user.
      */
@@ -1263,6 +1265,8 @@ typedef struct AVFrame {
 
     /**
      * reordered pos from the last AVPacket that has been input into the decoder
+     * Code outside libavcodec should access this field using:
+     *  av_opt_ptr(avcodec_get_frame_class(), frame, "pkt_pos");
      * - encoding: unused
      * - decoding: Read by user.
      */
@@ -1270,6 +1274,8 @@ typedef struct AVFrame {
 
     /**
      * reordered sample aspect ratio for the video frame, 0/1 if unknown\unspecified
+     * Code outside libavcodec should access this field using:
+     *  av_opt_ptr(avcodec_get_frame_class(), frame, "sample_aspect_ratio");
      * - encoding: unused
      * - decoding: Read by user.
      */
@@ -1277,6 +1283,8 @@ typedef struct AVFrame {
 
     /**
      * width and height of the video frame
+     * Code outside libavcodec should access this field using:
+     *  av_opt_ptr(avcodec_get_frame_class(), frame, "width");
      * - encoding: unused
      * - decoding: Read by user.
      */
@@ -1286,6 +1294,8 @@ typedef struct AVFrame {
      * format of the frame, -1 if unknown or unset
      * It should be cast to the corresponding enum (enum PixelFormat
      * for video, enum AVSampleFormat for audio)
+     * Code outside libavcodec should access this field using:
+     *  av_opt_ptr(avcodec_get_frame_class(), frame, "format");
      * - encoding: unused
      * - decoding: Read by user.
      */