Merge commit '0957b274e312e985d69cb490bee2a7ff820acaa6'
[ffmpeg.git] / libavcodec / avcodec.h
index 463fc04a6e3870d2b9a131634020d80b0f88ba97..d52f24506076eeb5c91fc3ed62ec5bc9a678beb5 100644 (file)
@@ -2930,6 +2930,21 @@ typedef struct AVCodecContext {
      */
     uint64_t vbv_delay;
 
+    /**
+     * Encoding only. Allow encoders to output packets that do not contain any
+     * encoded data, only side data.
+     *
+     * Some encoders need to output such packets, e.g. to update some stream
+     * parameters at the end of encoding.
+     *
+     * All callers are strongly recommended to set this option to 1 and update
+     * their code to deal with such packets, since this behaviour may become
+     * always enabled in the future (then this option will be deprecated and
+     * later removed). To avoid ABI issues when this happens, the callers should
+     * use AVOptions to set this field.
+     */
+    int side_data_only_packets;
+
     /**
      * Timebase in which pkt_dts/pts and AVPacket.dts/pts are.
      * Code outside libavcodec should access this field using: