[FFmpeg-cvslog] avcodec/codec: add doxy to AVCodec.decode()

[James Almer]

ffmpeg | branch: master | James Almer <jamrial at gmail.com> | Fri Mar  5 01:05:05 2021 -0300| [b7e7813e7aaf03b9096d6162499bb6eb1841e0a0] | committer: James Almer

avcodec/codec: add doxy to AVCodec.decode()

Signed-off-by: James Almer <jamrial at gmail.com>

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

 libavcodec/codec.h | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/libavcodec/codec.h b/libavcodec/codec.h
index f96372f77a..0ab618d71c 100644
--- a/libavcodec/codec.h
+++ b/libavcodec/codec.h
@@ -281,6 +281,18 @@ typedef struct AVCodec {
      */
     int (*encode2)(struct AVCodecContext *avctx, struct AVPacket *avpkt,
                    const struct AVFrame *frame, int *got_packet_ptr);
+    /**
+     * Decode picture or subtitle data.
+     *
+     * @param      avctx          codec context
+     * @param      outdata        codec type dependent output struct
+     * @param[out] got_frame_ptr  decoder sets to 0 or 1 to indicate that a
+     *                            non-empty frame or subtitle was returned in
+     *                            outdata.
+     * @param[in]  avpkt          AVPacket containing the data to be decoded
+     * @return amount of bytes read from the packet on success, negative error
+     *         code on failure
+     */
     int (*decode)(struct AVCodecContext *avctx, void *outdata,
                   int *got_frame_ptr, struct AVPacket *avpkt);
     int (*close)(struct AVCodecContext *);