FFmpeg  4.2.2
avcodec.h
Go to the documentation of this file.
1 /*
2  * copyright (c) 2001 Fabrice Bellard
3  *
4  * This file is part of FFmpeg.
5  *
6  * FFmpeg is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or (at your option) any later version.
10  *
11  * FFmpeg is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with FFmpeg; if not, write to the Free Software
18  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
19  */
20 
21 #ifndef AVCODEC_AVCODEC_H
22 #define AVCODEC_AVCODEC_H
23 
24 /**
25  * @file
26  * @ingroup libavc
27  * Libavcodec external API header
28  */
29 
30 #include <errno.h>
31 #include "libavutil/samplefmt.h"
32 #include "libavutil/attributes.h"
33 #include "libavutil/avutil.h"
34 #include "libavutil/buffer.h"
35 #include "libavutil/cpu.h"
37 #include "libavutil/dict.h"
38 #include "libavutil/frame.h"
39 #include "libavutil/hwcontext.h"
40 #include "libavutil/log.h"
41 #include "libavutil/pixfmt.h"
42 #include "libavutil/rational.h"
43 
44 #include "version.h"
45 
46 /**
47  * @defgroup libavc libavcodec
48  * Encoding/Decoding Library
49  *
50  * @{
51  *
52  * @defgroup lavc_decoding Decoding
53  * @{
54  * @}
55  *
56  * @defgroup lavc_encoding Encoding
57  * @{
58  * @}
59  *
60  * @defgroup lavc_codec Codecs
61  * @{
62  * @defgroup lavc_codec_native Native Codecs
63  * @{
64  * @}
65  * @defgroup lavc_codec_wrappers External library wrappers
66  * @{
67  * @}
68  * @defgroup lavc_codec_hwaccel Hardware Accelerators bridge
69  * @{
70  * @}
71  * @}
72  * @defgroup lavc_internal Internal
73  * @{
74  * @}
75  * @}
76  */
77 
78 /**
79  * @ingroup libavc
80  * @defgroup lavc_encdec send/receive encoding and decoding API overview
81  * @{
82  *
83  * The avcodec_send_packet()/avcodec_receive_frame()/avcodec_send_frame()/
84  * avcodec_receive_packet() functions provide an encode/decode API, which
85  * decouples input and output.
86  *
87  * The API is very similar for encoding/decoding and audio/video, and works as
88  * follows:
89  * - Set up and open the AVCodecContext as usual.
90  * - Send valid input:
91  * - For decoding, call avcodec_send_packet() to give the decoder raw
92  * compressed data in an AVPacket.
93  * - For encoding, call avcodec_send_frame() to give the encoder an AVFrame
94  * containing uncompressed audio or video.
95  * In both cases, it is recommended that AVPackets and AVFrames are
96  * refcounted, or libavcodec might have to copy the input data. (libavformat
97  * always returns refcounted AVPackets, and av_frame_get_buffer() allocates
98  * refcounted AVFrames.)
99  * - Receive output in a loop. Periodically call one of the avcodec_receive_*()
100  * functions and process their output:
101  * - For decoding, call avcodec_receive_frame(). On success, it will return
102  * an AVFrame containing uncompressed audio or video data.
103  * - For encoding, call avcodec_receive_packet(). On success, it will return
104  * an AVPacket with a compressed frame.
105  * Repeat this call until it returns AVERROR(EAGAIN) or an error. The
106  * AVERROR(EAGAIN) return value means that new input data is required to
107  * return new output. In this case, continue with sending input. For each
108  * input frame/packet, the codec will typically return 1 output frame/packet,
109  * but it can also be 0 or more than 1.
110  *
111  * At the beginning of decoding or encoding, the codec might accept multiple
112  * input frames/packets without returning a frame, until its internal buffers
113  * are filled. This situation is handled transparently if you follow the steps
114  * outlined above.
115  *
116  * In theory, sending input can result in EAGAIN - this should happen only if
117  * not all output was received. You can use this to structure alternative decode
118  * or encode loops other than the one suggested above. For example, you could
119  * try sending new input on each iteration, and try to receive output if that
120  * returns EAGAIN.
121  *
122  * End of stream situations. These require "flushing" (aka draining) the codec,
123  * as the codec might buffer multiple frames or packets internally for
124  * performance or out of necessity (consider B-frames).
125  * This is handled as follows:
126  * - Instead of valid input, send NULL to the avcodec_send_packet() (decoding)
127  * or avcodec_send_frame() (encoding) functions. This will enter draining
128  * mode.
129  * - Call avcodec_receive_frame() (decoding) or avcodec_receive_packet()
130  * (encoding) in a loop until AVERROR_EOF is returned. The functions will
131  * not return AVERROR(EAGAIN), unless you forgot to enter draining mode.
132  * - Before decoding can be resumed again, the codec has to be reset with
133  * avcodec_flush_buffers().
134  *
135  * Using the API as outlined above is highly recommended. But it is also
136  * possible to call functions outside of this rigid schema. For example, you can
137  * call avcodec_send_packet() repeatedly without calling
138  * avcodec_receive_frame(). In this case, avcodec_send_packet() will succeed
139  * until the codec's internal buffer has been filled up (which is typically of
140  * size 1 per output frame, after initial input), and then reject input with
141  * AVERROR(EAGAIN). Once it starts rejecting input, you have no choice but to
142  * read at least some output.
143  *
144  * Not all codecs will follow a rigid and predictable dataflow; the only
145  * guarantee is that an AVERROR(EAGAIN) return value on a send/receive call on
146  * one end implies that a receive/send call on the other end will succeed, or
147  * at least will not fail with AVERROR(EAGAIN). In general, no codec will
148  * permit unlimited buffering of input or output.
149  *
150  * This API replaces the following legacy functions:
151  * - avcodec_decode_video2() and avcodec_decode_audio4():
152  * Use avcodec_send_packet() to feed input to the decoder, then use
153  * avcodec_receive_frame() to receive decoded frames after each packet.
154  * Unlike with the old video decoding API, multiple frames might result from
155  * a packet. For audio, splitting the input packet into frames by partially
156  * decoding packets becomes transparent to the API user. You never need to
157  * feed an AVPacket to the API twice (unless it is rejected with AVERROR(EAGAIN) - then
158  * no data was read from the packet).
159  * Additionally, sending a flush/draining packet is required only once.
160  * - avcodec_encode_video2()/avcodec_encode_audio2():
161  * Use avcodec_send_frame() to feed input to the encoder, then use
162  * avcodec_receive_packet() to receive encoded packets.
163  * Providing user-allocated buffers for avcodec_receive_packet() is not
164  * possible.
165  * - The new API does not handle subtitles yet.
166  *
167  * Mixing new and old function calls on the same AVCodecContext is not allowed,
168  * and will result in undefined behavior.
169  *
170  * Some codecs might require using the new API; using the old API will return
171  * an error when calling it. All codecs support the new API.
172  *
173  * A codec is not allowed to return AVERROR(EAGAIN) for both sending and receiving. This
174  * would be an invalid state, which could put the codec user into an endless
175  * loop. The API has no concept of time either: it cannot happen that trying to
176  * do avcodec_send_packet() results in AVERROR(EAGAIN), but a repeated call 1 second
177  * later accepts the packet (with no other receive/flush API calls involved).
178  * The API is a strict state machine, and the passage of time is not supposed
179  * to influence it. Some timing-dependent behavior might still be deemed
180  * acceptable in certain cases. But it must never result in both send/receive
181  * returning EAGAIN at the same time at any point. It must also absolutely be
182  * avoided that the current state is "unstable" and can "flip-flop" between
183  * the send/receive APIs allowing progress. For example, it's not allowed that
184  * the codec randomly decides that it actually wants to consume a packet now
185  * instead of returning a frame, after it just returned AVERROR(EAGAIN) on an
186  * avcodec_send_packet() call.
187  * @}
188  */
189 
190 /**
191  * @defgroup lavc_core Core functions/structures.
192  * @ingroup libavc
193  *
194  * Basic definitions, functions for querying libavcodec capabilities,
195  * allocating core structures, etc.
196  * @{
197  */
198 
199 
200 /**
201  * Identify the syntax and semantics of the bitstream.
202  * The principle is roughly:
203  * Two decoders with the same ID can decode the same streams.
204  * Two encoders with the same ID can encode compatible streams.
205  * There may be slight deviations from the principle due to implementation
206  * details.
207  *
208  * If you add a codec ID to this list, add it so that
209  * 1. no value of an existing codec ID changes (that would break ABI),
210  * 2. it is as close as possible to similar codecs
211  *
212  * After adding new codec IDs, do not forget to add an entry to the codec
213  * descriptor list and bump libavcodec minor version.
214  */
215 enum AVCodecID {
217 
218  /* video codecs */
220  AV_CODEC_ID_MPEG2VIDEO, ///< preferred ID for MPEG-1/2 video decoding
355 #define AV_CODEC_ID_IFF_BYTERUN1 AV_CODEC_ID_IFF_ILBM
393 #define AV_CODEC_ID_H265 AV_CODEC_ID_HEVC
414 
461 
462  /* various PCM "codecs" */
463  AV_CODEC_ID_FIRST_AUDIO = 0x10000, ///< A dummy id pointing at the start of audio codecs
495 
501 
502  /* various ADPCM codecs */
534 
546 
547  /* AMR */
550 
551  /* RealAudio codecs*/
554 
555  /* various DPCM codecs */
560 
563 
564  /* audio codecs */
565  AV_CODEC_ID_MP2 = 0x15000,
566  AV_CODEC_ID_MP3, ///< preferred ID for decoding MPEG audio layer 1, 2 or 3
583  AV_CODEC_ID_GSM, ///< as in Berlin toast format
595  AV_CODEC_ID_GSM_MS, /* as found in WAV */
633 
656 
657  /* subtitle codecs */
658  AV_CODEC_ID_FIRST_SUBTITLE = 0x17000, ///< A dummy ID pointing at the start of subtitle codecs.
661  AV_CODEC_ID_TEXT, ///< raw UTF-8 text
668 
686 
687  /* other specific kind of codecs (generally used for attachments) */
688  AV_CODEC_ID_FIRST_UNKNOWN = 0x18000, ///< A dummy ID pointing at the start of various fake codecs.
689  AV_CODEC_ID_TTF = 0x18000,
690 
691  AV_CODEC_ID_SCTE_35, ///< Contain timestamp estimated through PCR of program stream.
700 
701 
702  AV_CODEC_ID_PROBE = 0x19000, ///< codec_id is not known (like AV_CODEC_ID_NONE) but lavf should attempt to identify it
703 
704  AV_CODEC_ID_MPEG2TS = 0x20000, /**< _FAKE_ codec to indicate a raw MPEG-2 TS
705  * stream (only used by libavformat) */
706  AV_CODEC_ID_MPEG4SYSTEMS = 0x20001, /**< _FAKE_ codec to indicate a MPEG-4 Systems
707  * stream (only used by libavformat) */
708  AV_CODEC_ID_FFMETADATA = 0x21000, ///< Dummy codec for streams containing only metadata information.
709  AV_CODEC_ID_WRAPPED_AVFRAME = 0x21001, ///< Passthrough codec, AVFrames wrapped in AVPacket
710 };
711 
712 /**
713  * This struct describes the properties of a single codec described by an
714  * AVCodecID.
715  * @see avcodec_descriptor_get()
716  */
717 typedef struct AVCodecDescriptor {
718  enum AVCodecID id;
720  /**
721  * Name of the codec described by this descriptor. It is non-empty and
722  * unique for each codec descriptor. It should contain alphanumeric
723  * characters and '_' only.
724  */
725  const char *name;
726  /**
727  * A more descriptive name for this codec. May be NULL.
728  */
729  const char *long_name;
730  /**
731  * Codec properties, a combination of AV_CODEC_PROP_* flags.
732  */
733  int props;
734  /**
735  * MIME type(s) associated with the codec.
736  * May be NULL; if not, a NULL-terminated array of MIME types.
737  * The first item is always non-NULL and is the preferred MIME type.
738  */
739  const char *const *mime_types;
740  /**
741  * If non-NULL, an array of profiles recognized for this codec.
742  * Terminated with FF_PROFILE_UNKNOWN.
743  */
744  const struct AVProfile *profiles;
746 
747 /**
748  * Codec uses only intra compression.
749  * Video and audio codecs only.
750  */
751 #define AV_CODEC_PROP_INTRA_ONLY (1 << 0)
752 /**
753  * Codec supports lossy compression. Audio and video codecs only.
754  * @note a codec may support both lossy and lossless
755  * compression modes
756  */
757 #define AV_CODEC_PROP_LOSSY (1 << 1)
758 /**
759  * Codec supports lossless compression. Audio and video codecs only.
760  */
761 #define AV_CODEC_PROP_LOSSLESS (1 << 2)
762 /**
763  * Codec supports frame reordering. That is, the coded order (the order in which
764  * the encoded packets are output by the encoders / stored / input to the
765  * decoders) may be different from the presentation order of the corresponding
766  * frames.
767  *
768  * For codecs that do not have this property set, PTS and DTS should always be
769  * equal.
770  */
771 #define AV_CODEC_PROP_REORDER (1 << 3)
772 /**
773  * Subtitle codec is bitmap based
774  * Decoded AVSubtitle data can be read from the AVSubtitleRect->pict field.
775  */
776 #define AV_CODEC_PROP_BITMAP_SUB (1 << 16)
777 /**
778  * Subtitle codec is text based.
779  * Decoded AVSubtitle data can be read from the AVSubtitleRect->ass field.
780  */
781 #define AV_CODEC_PROP_TEXT_SUB (1 << 17)
782 
783 /**
784  * @ingroup lavc_decoding
785  * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
786  * This is mainly needed because some optimized bitstream readers read
787  * 32 or 64 bit at once and could read over the end.<br>
788  * Note: If the first 23 bits of the additional bytes are not 0, then damaged
789  * MPEG bitstreams could cause overread and segfault.
790  */
791 #define AV_INPUT_BUFFER_PADDING_SIZE 64
792 
793 /**
794  * @ingroup lavc_encoding
795  * minimum encoding buffer size
796  * Used to avoid some checks during header writing.
797  */
798 #define AV_INPUT_BUFFER_MIN_SIZE 16384
799 
800 /**
801  * @ingroup lavc_decoding
802  */
804  /* We leave some space between them for extensions (drop some
805  * keyframes for intra-only or drop just some bidir frames). */
806  AVDISCARD_NONE =-16, ///< discard nothing
807  AVDISCARD_DEFAULT = 0, ///< discard useless packets like 0 size packets in avi
808  AVDISCARD_NONREF = 8, ///< discard all non reference
809  AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames
810  AVDISCARD_NONINTRA= 24, ///< discard all non intra frames
811  AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes
812  AVDISCARD_ALL = 48, ///< discard all
813 };
814 
825  AV_AUDIO_SERVICE_TYPE_NB , ///< Not part of ABI
826 };
827 
828 /**
829  * @ingroup lavc_encoding
830  */
831 typedef struct RcOverride{
834  int qscale; // If this is 0 then quality_factor will be used instead.
836 } RcOverride;
837 
838 /* encoding support
839  These flags can be passed in AVCodecContext.flags before initialization.
840  Note: Not everything is supported yet.
841 */
842 
843 /**
844  * Allow decoders to produce frames with data planes that are not aligned
845  * to CPU requirements (e.g. due to cropping).
846  */
847 #define AV_CODEC_FLAG_UNALIGNED (1 << 0)
848 /**
849  * Use fixed qscale.
850  */
851 #define AV_CODEC_FLAG_QSCALE (1 << 1)
852 /**
853  * 4 MV per MB allowed / advanced prediction for H.263.
854  */
855 #define AV_CODEC_FLAG_4MV (1 << 2)
856 /**
857  * Output even those frames that might be corrupted.
858  */
859 #define AV_CODEC_FLAG_OUTPUT_CORRUPT (1 << 3)
860 /**
861  * Use qpel MC.
862  */
863 #define AV_CODEC_FLAG_QPEL (1 << 4)
864 /**
865  * Don't output frames whose parameters differ from first
866  * decoded frame in stream.
867  */
868 #define AV_CODEC_FLAG_DROPCHANGED (1 << 5)
869 /**
870  * Use internal 2pass ratecontrol in first pass mode.
871  */
872 #define AV_CODEC_FLAG_PASS1 (1 << 9)
873 /**
874  * Use internal 2pass ratecontrol in second pass mode.
875  */
876 #define AV_CODEC_FLAG_PASS2 (1 << 10)
877 /**
878  * loop filter.
879  */
880 #define AV_CODEC_FLAG_LOOP_FILTER (1 << 11)
881 /**
882  * Only decode/encode grayscale.
883  */
884 #define AV_CODEC_FLAG_GRAY (1 << 13)
885 /**
886  * error[?] variables will be set during encoding.
887  */
888 #define AV_CODEC_FLAG_PSNR (1 << 15)
889 /**
890  * Input bitstream might be truncated at a random location
891  * instead of only at frame boundaries.
892  */
893 #define AV_CODEC_FLAG_TRUNCATED (1 << 16)
894 /**
895  * Use interlaced DCT.
896  */
897 #define AV_CODEC_FLAG_INTERLACED_DCT (1 << 18)
898 /**
899  * Force low delay.
900  */
901 #define AV_CODEC_FLAG_LOW_DELAY (1 << 19)
902 /**
903  * Place global headers in extradata instead of every keyframe.
904  */
905 #define AV_CODEC_FLAG_GLOBAL_HEADER (1 << 22)
906 /**
907  * Use only bitexact stuff (except (I)DCT).
908  */
909 #define AV_CODEC_FLAG_BITEXACT (1 << 23)
910 /* Fx : Flag for H.263+ extra options */
911 /**
912  * H.263 advanced intra coding / MPEG-4 AC prediction
913  */
914 #define AV_CODEC_FLAG_AC_PRED (1 << 24)
915 /**
916  * interlaced motion estimation
917  */
918 #define AV_CODEC_FLAG_INTERLACED_ME (1 << 29)
919 #define AV_CODEC_FLAG_CLOSED_GOP (1U << 31)
920 
921 /**
922  * Allow non spec compliant speedup tricks.
923  */
924 #define AV_CODEC_FLAG2_FAST (1 << 0)
925 /**
926  * Skip bitstream encoding.
927  */
928 #define AV_CODEC_FLAG2_NO_OUTPUT (1 << 2)
929 /**
930  * Place global headers at every keyframe instead of in extradata.
931  */
932 #define AV_CODEC_FLAG2_LOCAL_HEADER (1 << 3)
933 
934 /**
935  * timecode is in drop frame format. DEPRECATED!!!!
936  */
937 #define AV_CODEC_FLAG2_DROP_FRAME_TIMECODE (1 << 13)
938 
939 /**
940  * Input bitstream might be truncated at a packet boundaries
941  * instead of only at frame boundaries.
942  */
943 #define AV_CODEC_FLAG2_CHUNKS (1 << 15)
944 /**
945  * Discard cropping information from SPS.
946  */
947 #define AV_CODEC_FLAG2_IGNORE_CROP (1 << 16)
948 
949 /**
950  * Show all frames before the first keyframe
951  */
952 #define AV_CODEC_FLAG2_SHOW_ALL (1 << 22)
953 /**
954  * Export motion vectors through frame side data
955  */
956 #define AV_CODEC_FLAG2_EXPORT_MVS (1 << 28)
957 /**
958  * Do not skip samples and export skip information as frame side data
959  */
960 #define AV_CODEC_FLAG2_SKIP_MANUAL (1 << 29)
961 /**
962  * Do not reset ASS ReadOrder field on flush (subtitles decoding)
963  */
964 #define AV_CODEC_FLAG2_RO_FLUSH_NOOP (1 << 30)
965 
966 /* Unsupported options :
967  * Syntax Arithmetic coding (SAC)
968  * Reference Picture Selection
969  * Independent Segment Decoding */
970 /* /Fx */
971 /* codec capabilities */
972 
973 /**
974  * Decoder can use draw_horiz_band callback.
975  */
976 #define AV_CODEC_CAP_DRAW_HORIZ_BAND (1 << 0)
977 /**
978  * Codec uses get_buffer() for allocating buffers and supports custom allocators.
979  * If not set, it might not use get_buffer() at all or use operations that
980  * assume the buffer was allocated by avcodec_default_get_buffer.
981  */
982 #define AV_CODEC_CAP_DR1 (1 << 1)
983 #define AV_CODEC_CAP_TRUNCATED (1 << 3)
984 /**
985  * Encoder or decoder requires flushing with NULL input at the end in order to
986  * give the complete and correct output.
987  *
988  * NOTE: If this flag is not set, the codec is guaranteed to never be fed with
989  * with NULL data. The user can still send NULL data to the public encode
990  * or decode function, but libavcodec will not pass it along to the codec
991  * unless this flag is set.
992  *
993  * Decoders:
994  * The decoder has a non-zero delay and needs to be fed with avpkt->data=NULL,
995  * avpkt->size=0 at the end to get the delayed data until the decoder no longer
996  * returns frames.
997  *
998  * Encoders:
999  * The encoder needs to be fed with NULL data at the end of encoding until the
1000  * encoder no longer returns data.
1001  *
1002  * NOTE: For encoders implementing the AVCodec.encode2() function, setting this
1003  * flag also means that the encoder must set the pts and duration for
1004  * each output packet. If this flag is not set, the pts and duration will
1005  * be determined by libavcodec from the input frame.
1006  */
1007 #define AV_CODEC_CAP_DELAY (1 << 5)
1008 /**
1009  * Codec can be fed a final frame with a smaller size.
1010  * This can be used to prevent truncation of the last audio samples.
1011  */
1012 #define AV_CODEC_CAP_SMALL_LAST_FRAME (1 << 6)
1013 
1014 /**
1015  * Codec can output multiple frames per AVPacket
1016  * Normally demuxers return one frame at a time, demuxers which do not do
1017  * are connected to a parser to split what they return into proper frames.
1018  * This flag is reserved to the very rare category of codecs which have a
1019  * bitstream that cannot be split into frames without timeconsuming
1020  * operations like full decoding. Demuxers carrying such bitstreams thus
1021  * may return multiple frames in a packet. This has many disadvantages like
1022  * prohibiting stream copy in many cases thus it should only be considered
1023  * as a last resort.
1024  */
1025 #define AV_CODEC_CAP_SUBFRAMES (1 << 8)
1026 /**
1027  * Codec is experimental and is thus avoided in favor of non experimental
1028  * encoders
1029  */
1030 #define AV_CODEC_CAP_EXPERIMENTAL (1 << 9)
1031 /**
1032  * Codec should fill in channel configuration and samplerate instead of container
1033  */
1034 #define AV_CODEC_CAP_CHANNEL_CONF (1 << 10)
1035 /**
1036  * Codec supports frame-level multithreading.
1037  */
1038 #define AV_CODEC_CAP_FRAME_THREADS (1 << 12)
1039 /**
1040  * Codec supports slice-based (or partition-based) multithreading.
1041  */
1042 #define AV_CODEC_CAP_SLICE_THREADS (1 << 13)
1043 /**
1044  * Codec supports changed parameters at any point.
1045  */
1046 #define AV_CODEC_CAP_PARAM_CHANGE (1 << 14)
1047 /**
1048  * Codec supports avctx->thread_count == 0 (auto).
1049  */
1050 #define AV_CODEC_CAP_AUTO_THREADS (1 << 15)
1051 /**
1052  * Audio encoder supports receiving a different number of samples in each call.
1053  */
1054 #define AV_CODEC_CAP_VARIABLE_FRAME_SIZE (1 << 16)
1055 /**
1056  * Decoder is not a preferred choice for probing.
1057  * This indicates that the decoder is not a good choice for probing.
1058  * It could for example be an expensive to spin up hardware decoder,
1059  * or it could simply not provide a lot of useful information about
1060  * the stream.
1061  * A decoder marked with this flag should only be used as last resort
1062  * choice for probing.
1063  */
1064 #define AV_CODEC_CAP_AVOID_PROBING (1 << 17)
1065 /**
1066  * Codec is intra only.
1067  */
1068 #define AV_CODEC_CAP_INTRA_ONLY 0x40000000
1069 /**
1070  * Codec is lossless.
1071  */
1072 #define AV_CODEC_CAP_LOSSLESS 0x80000000
1073 
1074 /**
1075  * Codec is backed by a hardware implementation. Typically used to
1076  * identify a non-hwaccel hardware decoder. For information about hwaccels, use
1077  * avcodec_get_hw_config() instead.
1078  */
1079 #define AV_CODEC_CAP_HARDWARE (1 << 18)
1080 
1081 /**
1082  * Codec is potentially backed by a hardware implementation, but not
1083  * necessarily. This is used instead of AV_CODEC_CAP_HARDWARE, if the
1084  * implementation provides some sort of internal fallback.
1085  */
1086 #define AV_CODEC_CAP_HYBRID (1 << 19)
1087 
1088 /**
1089  * This codec takes the reordered_opaque field from input AVFrames
1090  * and returns it in the corresponding field in AVCodecContext after
1091  * encoding.
1092  */
1093 #define AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE (1 << 20)
1094 
1095 /**
1096  * Pan Scan area.
1097  * This specifies the area which should be displayed.
1098  * Note there may be multiple such areas for one frame.
1099  */
1100 typedef struct AVPanScan {
1101  /**
1102  * id
1103  * - encoding: Set by user.
1104  * - decoding: Set by libavcodec.
1105  */
1106  int id;
1107 
1108  /**
1109  * width and height in 1/16 pel
1110  * - encoding: Set by user.
1111  * - decoding: Set by libavcodec.
1112  */
1113  int width;
1114  int height;
1115 
1116  /**
1117  * position of the top left corner in 1/16 pel for up to 3 fields/frames
1118  * - encoding: Set by user.
1119  * - decoding: Set by libavcodec.
1120  */
1121  int16_t position[3][2];
1122 } AVPanScan;
1123 
1124 /**
1125  * This structure describes the bitrate properties of an encoded bitstream. It
1126  * roughly corresponds to a subset the VBV parameters for MPEG-2 or HRD
1127  * parameters for H.264/HEVC.
1128  */
1129 typedef struct AVCPBProperties {
1130  /**
1131  * Maximum bitrate of the stream, in bits per second.
1132  * Zero if unknown or unspecified.
1133  */
1134 #if FF_API_UNSANITIZED_BITRATES
1136 #else
1137  int64_t max_bitrate;
1138 #endif
1139  /**
1140  * Minimum bitrate of the stream, in bits per second.
1141  * Zero if unknown or unspecified.
1142  */
1143 #if FF_API_UNSANITIZED_BITRATES
1145 #else
1146  int64_t min_bitrate;
1147 #endif
1148  /**
1149  * Average bitrate of the stream, in bits per second.
1150  * Zero if unknown or unspecified.
1151  */
1152 #if FF_API_UNSANITIZED_BITRATES
1154 #else
1155  int64_t avg_bitrate;
1156 #endif
1157 
1158  /**
1159  * The size of the buffer to which the ratecontrol is applied, in bits.
1160  * Zero if unknown or unspecified.
1161  */
1163 
1164  /**
1165  * The delay between the time the packet this structure is associated with
1166  * is received and the time when it should be decoded, in periods of a 27MHz
1167  * clock.
1168  *
1169  * UINT64_MAX when unknown or unspecified.
1170  */
1171  uint64_t vbv_delay;
1172 } AVCPBProperties;
1173 
1174 /**
1175  * The decoder will keep a reference to the frame and may reuse it later.
1176  */
1177 #define AV_GET_BUFFER_FLAG_REF (1 << 0)
1178 
1179 /**
1180  * @defgroup lavc_packet AVPacket
1181  *
1182  * Types and functions for working with AVPacket.
1183  * @{
1184  */
1186  /**
1187  * An AV_PKT_DATA_PALETTE side data packet contains exactly AVPALETTE_SIZE
1188  * bytes worth of palette. This side data signals that a new palette is
1189  * present.
1190  */
1192 
1193  /**
1194  * The AV_PKT_DATA_NEW_EXTRADATA is used to notify the codec or the format
1195  * that the extradata buffer was changed and the receiving side should
1196  * act upon it appropriately. The new extradata is embedded in the side
1197  * data buffer and should be immediately used for processing the current
1198  * frame or packet.
1199  */
1201 
1202  /**
1203  * An AV_PKT_DATA_PARAM_CHANGE side data packet is laid out as follows:
1204  * @code
1205  * u32le param_flags
1206  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT)
1207  * s32le channel_count
1208  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT)
1209  * u64le channel_layout
1210  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE)
1211  * s32le sample_rate
1212  * if (param_flags & AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS)
1213  * s32le width
1214  * s32le height
1215  * @endcode
1216  */
1218 
1219  /**
1220  * An AV_PKT_DATA_H263_MB_INFO side data packet contains a number of
1221  * structures with info about macroblocks relevant to splitting the
1222  * packet into smaller packets on macroblock edges (e.g. as for RFC 2190).
1223  * That is, it does not necessarily contain info about all macroblocks,
1224  * as long as the distance between macroblocks in the info is smaller
1225  * than the target payload size.
1226  * Each MB info structure is 12 bytes, and is laid out as follows:
1227  * @code
1228  * u32le bit offset from the start of the packet
1229  * u8 current quantizer at the start of the macroblock
1230  * u8 GOB number
1231  * u16le macroblock address within the GOB
1232  * u8 horizontal MV predictor
1233  * u8 vertical MV predictor
1234  * u8 horizontal MV predictor for block number 3
1235  * u8 vertical MV predictor for block number 3
1236  * @endcode
1237  */
1239 
1240  /**
1241  * This side data should be associated with an audio stream and contains
1242  * ReplayGain information in form of the AVReplayGain struct.
1243  */
1245 
1246  /**
1247  * This side data contains a 3x3 transformation matrix describing an affine
1248  * transformation that needs to be applied to the decoded video frames for
1249  * correct presentation.
1250  *
1251  * See libavutil/display.h for a detailed description of the data.
1252  */
1254 
1255  /**
1256  * This side data should be associated with a video stream and contains
1257  * Stereoscopic 3D information in form of the AVStereo3D struct.
1258  */
1260 
1261  /**
1262  * This side data should be associated with an audio stream and corresponds
1263  * to enum AVAudioServiceType.
1264  */
1266 
1267  /**
1268  * This side data contains quality related information from the encoder.
1269  * @code
1270  * u32le quality factor of the compressed frame. Allowed range is between 1 (good) and FF_LAMBDA_MAX (bad).
1271  * u8 picture type
1272  * u8 error count
1273  * u16 reserved
1274  * u64le[error count] sum of squared differences between encoder in and output
1275  * @endcode
1276  */
1278 
1279  /**
1280  * This side data contains an integer value representing the stream index
1281  * of a "fallback" track. A fallback track indicates an alternate
1282  * track to use when the current track can not be decoded for some reason.
1283  * e.g. no decoder available for codec.
1284  */
1286 
1287  /**
1288  * This side data corresponds to the AVCPBProperties struct.
1289  */
1291 
1292  /**
1293  * Recommmends skipping the specified number of samples
1294  * @code
1295  * u32le number of samples to skip from start of this packet
1296  * u32le number of samples to skip from end of this packet
1297  * u8 reason for start skip
1298  * u8 reason for end skip (0=padding silence, 1=convergence)
1299  * @endcode
1300  */
1302 
1303  /**
1304  * An AV_PKT_DATA_JP_DUALMONO side data packet indicates that
1305  * the packet may contain "dual mono" audio specific to Japanese DTV
1306  * and if it is true, recommends only the selected channel to be used.
1307  * @code
1308  * u8 selected channels (0=mail/left, 1=sub/right, 2=both)
1309  * @endcode
1310  */
1312 
1313  /**
1314  * A list of zero terminated key/value strings. There is no end marker for
1315  * the list, so it is required to rely on the side data size to stop.
1316  */
1318 
1319  /**
1320  * Subtitle event position
1321  * @code
1322  * u32le x1
1323  * u32le y1
1324  * u32le x2
1325  * u32le y2
1326  * @endcode
1327  */
1329 
1330  /**
1331  * Data found in BlockAdditional element of matroska container. There is
1332  * no end marker for the data, so it is required to rely on the side data
1333  * size to recognize the end. 8 byte id (as found in BlockAddId) followed
1334  * by data.
1335  */
1337 
1338  /**
1339  * The optional first identifier line of a WebVTT cue.
1340  */
1342 
1343  /**
1344  * The optional settings (rendering instructions) that immediately
1345  * follow the timestamp specifier of a WebVTT cue.
1346  */
1348 
1349  /**
1350  * A list of zero terminated key/value strings. There is no end marker for
1351  * the list, so it is required to rely on the side data size to stop. This
1352  * side data includes updated metadata which appeared in the stream.
1353  */
1355 
1356  /**
1357  * MPEGTS stream ID as uint8_t, this is required to pass the stream ID
1358  * information from the demuxer to the corresponding muxer.
1359  */
1361 
1362  /**
1363  * Mastering display metadata (based on SMPTE-2086:2014). This metadata
1364  * should be associated with a video stream and contains data in the form
1365  * of the AVMasteringDisplayMetadata struct.
1366  */
1368 
1369  /**
1370  * This side data should be associated with a video stream and corresponds
1371  * to the AVSphericalMapping structure.
1372  */
1374 
1375  /**
1376  * Content light level (based on CTA-861.3). This metadata should be
1377  * associated with a video stream and contains data in the form of the
1378  * AVContentLightMetadata struct.
1379  */
1381 
1382  /**
1383  * ATSC A53 Part 4 Closed Captions. This metadata should be associated with
1384  * a video stream. A53 CC bitstream is stored as uint8_t in AVPacketSideData.data.
1385  * The number of bytes of CC data is AVPacketSideData.size.
1386  */
1388 
1389  /**
1390  * This side data is encryption initialization data.
1391  * The format is not part of ABI, use av_encryption_init_info_* methods to
1392  * access.
1393  */
1395 
1396  /**
1397  * This side data contains encryption info for how to decrypt the packet.
1398  * The format is not part of ABI, use av_encryption_info_* methods to access.
1399  */
1401 
1402  /**
1403  * Active Format Description data consisting of a single byte as specified
1404  * in ETSI TS 101 154 using AVActiveFormatDescription enum.
1405  */
1407 
1408  /**
1409  * The number of side data types.
1410  * This is not part of the public API/ABI in the sense that it may
1411  * change when new side data types are added.
1412  * This must stay the last enum value.
1413  * If its value becomes huge, some code using it
1414  * needs to be updated as it assumes it to be smaller than other limits.
1415  */
1417 };
1418 
1419 #define AV_PKT_DATA_QUALITY_FACTOR AV_PKT_DATA_QUALITY_STATS //DEPRECATED
1420 
1421 typedef struct AVPacketSideData {
1422  uint8_t *data;
1423  int size;
1426 
1427 /**
1428  * This structure stores compressed data. It is typically exported by demuxers
1429  * and then passed as input to decoders, or received as output from encoders and
1430  * then passed to muxers.
1431  *
1432  * For video, it should typically contain one compressed frame. For audio it may
1433  * contain several compressed frames. Encoders are allowed to output empty
1434  * packets, with no compressed data, containing only side data
1435  * (e.g. to update some stream parameters at the end of encoding).
1436  *
1437  * AVPacket is one of the few structs in FFmpeg, whose size is a part of public
1438  * ABI. Thus it may be allocated on stack and no new fields can be added to it
1439  * without libavcodec and libavformat major bump.
1440  *
1441  * The semantics of data ownership depends on the buf field.
1442  * If it is set, the packet data is dynamically allocated and is
1443  * valid indefinitely until a call to av_packet_unref() reduces the
1444  * reference count to 0.
1445  *
1446  * If the buf field is not set av_packet_ref() would make a copy instead
1447  * of increasing the reference count.
1448  *
1449  * The side data is always allocated with av_malloc(), copied by
1450  * av_packet_ref() and freed by av_packet_unref().
1451  *
1452  * @see av_packet_ref
1453  * @see av_packet_unref
1454  */
1455 typedef struct AVPacket {
1456  /**
1457  * A reference to the reference-counted buffer where the packet data is
1458  * stored.
1459  * May be NULL, then the packet data is not reference-counted.
1460  */
1462  /**
1463  * Presentation timestamp in AVStream->time_base units; the time at which
1464  * the decompressed packet will be presented to the user.
1465  * Can be AV_NOPTS_VALUE if it is not stored in the file.
1466  * pts MUST be larger or equal to dts as presentation cannot happen before
1467  * decompression, unless one wants to view hex dumps. Some formats misuse
1468  * the terms dts and pts/cts to mean something different. Such timestamps
1469  * must be converted to true pts/dts before they are stored in AVPacket.
1470  */
1471  int64_t pts;
1472  /**
1473  * Decompression timestamp in AVStream->time_base units; the time at which
1474  * the packet is decompressed.
1475  * Can be AV_NOPTS_VALUE if it is not stored in the file.
1476  */
1477  int64_t dts;
1478  uint8_t *data;
1479  int size;
1481  /**
1482  * A combination of AV_PKT_FLAG values
1483  */
1484  int flags;
1485  /**
1486  * Additional packet data that can be provided by the container.
1487  * Packet can contain several types of side information.
1488  */
1491 
1492  /**
1493  * Duration of this packet in AVStream->time_base units, 0 if unknown.
1494  * Equals next_pts - this_pts in presentation order.
1495  */
1496  int64_t duration;
1497 
1498  int64_t pos; ///< byte position in stream, -1 if unknown
1499 
1500 #if FF_API_CONVERGENCE_DURATION
1501  /**
1502  * @deprecated Same as the duration field, but as int64_t. This was required
1503  * for Matroska subtitles, whose duration values could overflow when the
1504  * duration field was still an int.
1505  */
1508 #endif
1510 } AVPacket;
1511 #define AV_PKT_FLAG_KEY 0x0001 ///< The packet contains a keyframe
1512 #define AV_PKT_FLAG_CORRUPT 0x0002 ///< The packet content is corrupted
1513 /**
1514  * Flag is used to discard packets which are required to maintain valid
1515  * decoder state but are not required for output and should be dropped
1516  * after decoding.
1517  **/
1518 #define AV_PKT_FLAG_DISCARD 0x0004
1519 /**
1520  * The packet comes from a trusted source.
1521  *
1522  * Otherwise-unsafe constructs such as arbitrary pointers to data
1523  * outside the packet may be followed.
1524  */
1525 #define AV_PKT_FLAG_TRUSTED 0x0008
1526 /**
1527  * Flag is used to indicate packets that contain frames that can
1528  * be discarded by the decoder. I.e. Non-reference frames.
1529  */
1530 #define AV_PKT_FLAG_DISPOSABLE 0x0010
1531 
1532 
1538 };
1539 /**
1540  * @}
1541  */
1542 
1543 struct AVCodecInternal;
1544 
1548  AV_FIELD_TT, //< Top coded_first, top displayed first
1549  AV_FIELD_BB, //< Bottom coded first, bottom displayed first
1550  AV_FIELD_TB, //< Top coded first, bottom displayed first
1551  AV_FIELD_BT, //< Bottom coded first, top displayed first
1552 };
1553 
1554 /**
1555  * main external API structure.
1556  * New fields can be added to the end with minor version bumps.
1557  * Removal, reordering and changes to existing fields require a major
1558  * version bump.
1559  * You can use AVOptions (av_opt* / av_set/get*()) to access these fields from user
1560  * applications.
1561  * The name string for AVOptions options matches the associated command line
1562  * parameter name and can be found in libavcodec/options_table.h
1563  * The AVOption/command line parameter names differ in some cases from the C
1564  * structure field names for historic reasons or brevity.
1565  * sizeof(AVCodecContext) must not be used outside libav*.
1566  */
1567 typedef struct AVCodecContext {
1568  /**
1569  * information on struct for av_log
1570  * - set by avcodec_alloc_context3
1571  */
1574 
1575  enum AVMediaType codec_type; /* see AVMEDIA_TYPE_xxx */
1576  const struct AVCodec *codec;
1577  enum AVCodecID codec_id; /* see AV_CODEC_ID_xxx */
1578 
1579  /**
1580  * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
1581  * This is used to work around some encoder bugs.
1582  * A demuxer should set this to what is stored in the field used to identify the codec.
1583  * If there are multiple such fields in a container then the demuxer should choose the one
1584  * which maximizes the information about the used codec.
1585  * If the codec tag field in a container is larger than 32 bits then the demuxer should
1586  * remap the longer ID to 32 bits with a table or other structure. Alternatively a new
1587  * extra_codec_tag + size could be added but for this a clear advantage must be demonstrated
1588  * first.
1589  * - encoding: Set by user, if not then the default based on codec_id will be used.
1590  * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
1591  */
1592  unsigned int codec_tag;
1593 
1594  void *priv_data;
1595 
1596  /**
1597  * Private context used for internal data.
1598  *
1599  * Unlike priv_data, this is not codec-specific. It is used in general
1600  * libavcodec functions.
1601  */
1602  struct AVCodecInternal *internal;
1603 
1604  /**
1605  * Private data of the user, can be used to carry app specific stuff.
1606  * - encoding: Set by user.
1607  * - decoding: Set by user.
1608  */
1609  void *opaque;
1610 
1611  /**
1612  * the average bitrate
1613  * - encoding: Set by user; unused for constant quantizer encoding.
1614  * - decoding: Set by user, may be overwritten by libavcodec
1615  * if this info is available in the stream
1616  */
1617  int64_t bit_rate;
1618 
1619  /**
1620  * number of bits the bitstream is allowed to diverge from the reference.
1621  * the reference can be CBR (for CBR pass1) or VBR (for pass2)
1622  * - encoding: Set by user; unused for constant quantizer encoding.
1623  * - decoding: unused
1624  */
1626 
1627  /**
1628  * Global quality for codecs which cannot change it per frame.
1629  * This should be proportional to MPEG-1/2/4 qscale.
1630  * - encoding: Set by user.
1631  * - decoding: unused
1632  */
1634 
1635  /**
1636  * - encoding: Set by user.
1637  * - decoding: unused
1638  */
1640 #define FF_COMPRESSION_DEFAULT -1
1641 
1642  /**
1643  * AV_CODEC_FLAG_*.
1644  * - encoding: Set by user.
1645  * - decoding: Set by user.
1646  */
1647  int flags;
1648 
1649  /**
1650  * AV_CODEC_FLAG2_*
1651  * - encoding: Set by user.
1652  * - decoding: Set by user.
1653  */
1654  int flags2;
1655 
1656  /**
1657  * some codecs need / can use extradata like Huffman tables.
1658  * MJPEG: Huffman tables
1659  * rv10: additional flags
1660  * MPEG-4: global headers (they can be in the bitstream or here)
1661  * The allocated memory should be AV_INPUT_BUFFER_PADDING_SIZE bytes larger
1662  * than extradata_size to avoid problems if it is read with the bitstream reader.
1663  * The bytewise contents of extradata must not depend on the architecture or CPU endianness.
1664  * Must be allocated with the av_malloc() family of functions.
1665  * - encoding: Set/allocated/freed by libavcodec.
1666  * - decoding: Set/allocated/freed by user.
1667  */
1668  uint8_t *extradata;
1670 
1671  /**
1672  * This is the fundamental unit of time (in seconds) in terms
1673  * of which frame timestamps are represented. For fixed-fps content,
1674  * timebase should be 1/framerate and timestamp increments should be
1675  * identically 1.
1676  * This often, but not always is the inverse of the frame rate or field rate
1677  * for video. 1/time_base is not the average frame rate if the frame rate is not
1678  * constant.
1679  *
1680  * Like containers, elementary streams also can store timestamps, 1/time_base
1681  * is the unit in which these timestamps are specified.
1682  * As example of such codec time base see ISO/IEC 14496-2:2001(E)
1683  * vop_time_increment_resolution and fixed_vop_rate
1684  * (fixed_vop_rate == 0 implies that it is different from the framerate)
1685  *
1686  * - encoding: MUST be set by user.
1687  * - decoding: the use of this field for decoding is deprecated.
1688  * Use framerate instead.
1689  */
1691 
1692  /**
1693  * For some codecs, the time base is closer to the field rate than the frame rate.
1694  * Most notably, H.264 and MPEG-2 specify time_base as half of frame duration
1695  * if no telecine is used ...
1696  *
1697  * Set to time_base ticks per frame. Default 1, e.g., H.264/MPEG-2 set it to 2.
1698  */
1700 
1701  /**
1702  * Codec delay.
1703  *
1704  * Encoding: Number of frames delay there will be from the encoder input to
1705  * the decoder output. (we assume the decoder matches the spec)
1706  * Decoding: Number of frames delay in addition to what a standard decoder
1707  * as specified in the spec would produce.
1708  *
1709  * Video:
1710  * Number of frames the decoded output will be delayed relative to the
1711  * encoded input.
1712  *
1713  * Audio:
1714  * For encoding, this field is unused (see initial_padding).
1715  *
1716  * For decoding, this is the number of samples the decoder needs to
1717  * output before the decoder's output is valid. When seeking, you should
1718  * start decoding this many samples prior to your desired seek point.
1719  *
1720  * - encoding: Set by libavcodec.
1721  * - decoding: Set by libavcodec.
1722  */
1723  int delay;
1724 
1725 
1726  /* video only */
1727  /**
1728  * picture width / height.
1729  *
1730  * @note Those fields may not match the values of the last
1731  * AVFrame output by avcodec_decode_video2 due frame
1732  * reordering.
1733  *
1734  * - encoding: MUST be set by user.
1735  * - decoding: May be set by the user before opening the decoder if known e.g.
1736  * from the container. Some decoders will require the dimensions
1737  * to be set by the caller. During decoding, the decoder may
1738  * overwrite those values as required while parsing the data.
1739  */
1741 
1742  /**
1743  * Bitstream width / height, may be different from width/height e.g. when
1744  * the decoded frame is cropped before being output or lowres is enabled.
1745  *
1746  * @note Those field may not match the value of the last
1747  * AVFrame output by avcodec_receive_frame() due frame
1748  * reordering.
1749  *
1750  * - encoding: unused
1751  * - decoding: May be set by the user before opening the decoder if known
1752  * e.g. from the container. During decoding, the decoder may
1753  * overwrite those values as required while parsing the data.
1754  */
1756 
1757  /**
1758  * the number of pictures in a group of pictures, or 0 for intra_only
1759  * - encoding: Set by user.
1760  * - decoding: unused
1761  */
1763 
1764  /**
1765  * Pixel format, see AV_PIX_FMT_xxx.
1766  * May be set by the demuxer if known from headers.
1767  * May be overridden by the decoder if it knows better.
1768  *
1769  * @note This field may not match the value of the last
1770  * AVFrame output by avcodec_receive_frame() due frame
1771  * reordering.
1772  *
1773  * - encoding: Set by user.
1774  * - decoding: Set by user if known, overridden by libavcodec while
1775  * parsing the data.
1776  */
1778 
1779  /**
1780  * If non NULL, 'draw_horiz_band' is called by the libavcodec
1781  * decoder to draw a horizontal band. It improves cache usage. Not
1782  * all codecs can do that. You must check the codec capabilities
1783  * beforehand.
1784  * When multithreading is used, it may be called from multiple threads
1785  * at the same time; threads might draw different parts of the same AVFrame,
1786  * or multiple AVFrames, and there is no guarantee that slices will be drawn
1787  * in order.
1788  * The function is also used by hardware acceleration APIs.
1789  * It is called at least once during frame decoding to pass
1790  * the data needed for hardware render.
1791  * In that mode instead of pixel data, AVFrame points to
1792  * a structure specific to the acceleration API. The application
1793  * reads the structure and can change some fields to indicate progress
1794  * or mark state.
1795  * - encoding: unused
1796  * - decoding: Set by user.
1797  * @param height the height of the slice
1798  * @param y the y position of the slice
1799  * @param type 1->top field, 2->bottom field, 3->frame
1800  * @param offset offset into the AVFrame.data from which the slice should be read
1801  */
1802  void (*draw_horiz_band)(struct AVCodecContext *s,
1803  const AVFrame *src, int offset[AV_NUM_DATA_POINTERS],
1804  int y, int type, int height);
1805 
1806  /**
1807  * callback to negotiate the pixelFormat
1808  * @param fmt is the list of formats which are supported by the codec,
1809  * it is terminated by -1 as 0 is a valid format, the formats are ordered by quality.
1810  * The first is always the native one.
1811  * @note The callback may be called again immediately if initialization for
1812  * the selected (hardware-accelerated) pixel format failed.
1813  * @warning Behavior is undefined if the callback returns a value not
1814  * in the fmt list of formats.
1815  * @return the chosen format
1816  * - encoding: unused
1817  * - decoding: Set by user, if not set the native format will be chosen.
1818  */
1819  enum AVPixelFormat (*get_format)(struct AVCodecContext *s, const enum AVPixelFormat * fmt);
1820 
1821  /**
1822  * maximum number of B-frames between non-B-frames
1823  * Note: The output will be delayed by max_b_frames+1 relative to the input.
1824  * - encoding: Set by user.
1825  * - decoding: unused
1826  */
1828 
1829  /**
1830  * qscale factor between IP and B-frames
1831  * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
1832  * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
1833  * - encoding: Set by user.
1834  * - decoding: unused
1835  */
1837 
1838 #if FF_API_PRIVATE_OPT
1839  /** @deprecated use encoder private options instead */
1842 #endif
1843 
1844  /**
1845  * qscale offset between IP and B-frames
1846  * - encoding: Set by user.
1847  * - decoding: unused
1848  */
1850 
1851  /**
1852  * Size of the frame reordering buffer in the decoder.
1853  * For MPEG-2 it is 1 IPB or 0 low delay IP.
1854  * - encoding: Set by libavcodec.
1855  * - decoding: Set by libavcodec.
1856  */
1858 
1859 #if FF_API_PRIVATE_OPT
1860  /** @deprecated use encoder private options instead */
1863 #endif
1864 
1865  /**
1866  * qscale factor between P- and I-frames
1867  * If > 0 then the last P-frame quantizer will be used (q = lastp_q * factor + offset).
1868  * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
1869  * - encoding: Set by user.
1870  * - decoding: unused
1871  */
1873 
1874  /**
1875  * qscale offset between P and I-frames
1876  * - encoding: Set by user.
1877  * - decoding: unused
1878  */
1880 
1881  /**
1882  * luminance masking (0-> disabled)
1883  * - encoding: Set by user.
1884  * - decoding: unused
1885  */
1887 
1888  /**
1889  * temporary complexity masking (0-> disabled)
1890  * - encoding: Set by user.
1891  * - decoding: unused
1892  */
1894 
1895  /**
1896  * spatial complexity masking (0-> disabled)
1897  * - encoding: Set by user.
1898  * - decoding: unused
1899  */
1901 
1902  /**
1903  * p block masking (0-> disabled)
1904  * - encoding: Set by user.
1905  * - decoding: unused
1906  */
1907  float p_masking;
1908 
1909  /**
1910  * darkness masking (0-> disabled)
1911  * - encoding: Set by user.
1912  * - decoding: unused
1913  */
1915 
1916  /**
1917  * slice count
1918  * - encoding: Set by libavcodec.
1919  * - decoding: Set by user (or 0).
1920  */
1922 
1923 #if FF_API_PRIVATE_OPT
1924  /** @deprecated use encoder private options instead */
1927 #define FF_PRED_LEFT 0
1928 #define FF_PRED_PLANE 1
1929 #define FF_PRED_MEDIAN 2
1930 #endif
1931 
1932  /**
1933  * slice offsets in the frame in bytes
1934  * - encoding: Set/allocated by libavcodec.
1935  * - decoding: Set/allocated by user (or NULL).
1936  */
1938 
1939  /**
1940  * sample aspect ratio (0 if unknown)
1941  * That is the width of a pixel divided by the height of the pixel.
1942  * Numerator and denominator must be relatively prime and smaller than 256 for some video standards.
1943  * - encoding: Set by user.
1944  * - decoding: Set by libavcodec.
1945  */
1947 
1948  /**
1949  * motion estimation comparison function
1950  * - encoding: Set by user.
1951  * - decoding: unused
1952  */
1953  int me_cmp;
1954  /**
1955  * subpixel motion estimation comparison function
1956  * - encoding: Set by user.
1957  * - decoding: unused
1958  */
1960  /**
1961  * macroblock comparison function (not supported yet)
1962  * - encoding: Set by user.
1963  * - decoding: unused
1964  */
1965  int mb_cmp;
1966  /**
1967  * interlaced DCT comparison function
1968  * - encoding: Set by user.
1969  * - decoding: unused
1970  */
1972 #define FF_CMP_SAD 0
1973 #define FF_CMP_SSE 1
1974 #define FF_CMP_SATD 2
1975 #define FF_CMP_DCT 3
1976 #define FF_CMP_PSNR 4
1977 #define FF_CMP_BIT 5
1978 #define FF_CMP_RD 6
1979 #define FF_CMP_ZERO 7
1980 #define FF_CMP_VSAD 8
1981 #define FF_CMP_VSSE 9
1982 #define FF_CMP_NSSE 10
1983 #define FF_CMP_W53 11
1984 #define FF_CMP_W97 12
1985 #define FF_CMP_DCTMAX 13
1986 #define FF_CMP_DCT264 14
1987 #define FF_CMP_MEDIAN_SAD 15
1988 #define FF_CMP_CHROMA 256
1989 
1990  /**
1991  * ME diamond size & shape
1992  * - encoding: Set by user.
1993  * - decoding: unused
1994  */
1996 
1997  /**
1998  * amount of previous MV predictors (2a+1 x 2a+1 square)
1999  * - encoding: Set by user.
2000  * - decoding: unused
2001  */
2003 
2004 #if FF_API_PRIVATE_OPT
2005  /** @deprecated use encoder private options instead */
2007  int pre_me;
2008 #endif
2009 
2010  /**
2011  * motion estimation prepass comparison function
2012  * - encoding: Set by user.
2013  * - decoding: unused
2014  */
2016 
2017  /**
2018  * ME prepass diamond size & shape
2019  * - encoding: Set by user.
2020  * - decoding: unused
2021  */
2023 
2024  /**
2025  * subpel ME quality
2026  * - encoding: Set by user.
2027  * - decoding: unused
2028  */
2030 
2031  /**
2032  * maximum motion estimation search range in subpel units
2033  * If 0 then no limit.
2034  *
2035  * - encoding: Set by user.
2036  * - decoding: unused
2037  */
2039 
2040  /**
2041  * slice flags
2042  * - encoding: unused
2043  * - decoding: Set by user.
2044  */
2046 #define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
2047 #define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG-2 field pics)
2048 #define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
2049 
2050  /**
2051  * macroblock decision mode
2052  * - encoding: Set by user.
2053  * - decoding: unused
2054  */
2056 #define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
2057 #define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
2058 #define FF_MB_DECISION_RD 2 ///< rate distortion
2059 
2060  /**
2061  * custom intra quantization matrix
2062  * Must be allocated with the av_malloc() family of functions, and will be freed in
2063  * avcodec_free_context().
2064  * - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
2065  * - decoding: Set/allocated/freed by libavcodec.
2066  */
2067  uint16_t *intra_matrix;
2068 
2069  /**
2070  * custom inter quantization matrix
2071  * Must be allocated with the av_malloc() family of functions, and will be freed in
2072  * avcodec_free_context().
2073  * - encoding: Set/allocated by user, freed by libavcodec. Can be NULL.
2074  * - decoding: Set/allocated/freed by libavcodec.
2075  */
2076  uint16_t *inter_matrix;
2077 
2078 #if FF_API_PRIVATE_OPT
2079  /** @deprecated use encoder private options instead */
2082 
2083  /** @deprecated use encoder private options instead */
2086 #endif
2087 
2088  /**
2089  * precision of the intra DC coefficient - 8
2090  * - encoding: Set by user.
2091  * - decoding: Set by libavcodec
2092  */
2094 
2095  /**
2096  * Number of macroblock rows at the top which are skipped.
2097  * - encoding: unused
2098  * - decoding: Set by user.
2099  */
2101 
2102  /**
2103  * Number of macroblock rows at the bottom which are skipped.
2104  * - encoding: unused
2105  * - decoding: Set by user.
2106  */
2108 
2109  /**
2110  * minimum MB Lagrange multiplier
2111  * - encoding: Set by user.
2112  * - decoding: unused
2113  */
2114  int mb_lmin;
2115 
2116  /**
2117  * maximum MB Lagrange multiplier
2118  * - encoding: Set by user.
2119  * - decoding: unused
2120  */
2121  int mb_lmax;
2122 
2123 #if FF_API_PRIVATE_OPT
2124  /**
2125  * @deprecated use encoder private options instead
2126  */
2129 #endif
2130 
2131  /**
2132  * - encoding: Set by user.
2133  * - decoding: unused
2134  */
2136 
2137 #if FF_API_PRIVATE_OPT
2138  /** @deprecated use encoder private options instead */
2141 #endif
2142 
2143  /**
2144  * minimum GOP size
2145  * - encoding: Set by user.
2146  * - decoding: unused
2147  */
2149 
2150  /**
2151  * number of reference frames
2152  * - encoding: Set by user.
2153  * - decoding: Set by lavc.
2154  */
2155  int refs;
2156 
2157 #if FF_API_PRIVATE_OPT
2158  /** @deprecated use encoder private options instead */
2161 #endif
2162 
2163  /**
2164  * Note: Value depends upon the compare function used for fullpel ME.
2165  * - encoding: Set by user.
2166  * - decoding: unused
2167  */
2169 
2170 #if FF_API_PRIVATE_OPT
2171  /** @deprecated use encoder private options instead */
2174 #endif
2175 
2176  /**
2177  * Chromaticity coordinates of the source primaries.
2178  * - encoding: Set by user
2179  * - decoding: Set by libavcodec
2180  */
2182 
2183  /**
2184  * Color Transfer Characteristic.
2185  * - encoding: Set by user
2186  * - decoding: Set by libavcodec
2187  */
2189 
2190  /**
2191  * YUV colorspace type.
2192  * - encoding: Set by user
2193  * - decoding: Set by libavcodec
2194  */
2196 
2197  /**
2198  * MPEG vs JPEG YUV range.
2199  * - encoding: Set by user
2200  * - decoding: Set by libavcodec
2201  */
2203 
2204  /**
2205  * This defines the location of chroma samples.
2206  * - encoding: Set by user
2207  * - decoding: Set by libavcodec
2208  */
2210 
2211  /**
2212  * Number of slices.
2213  * Indicates number of picture subdivisions. Used for parallelized
2214  * decoding.
2215  * - encoding: Set by user
2216  * - decoding: unused
2217  */
2218  int slices;
2219 
2220  /** Field order
2221  * - encoding: set by libavcodec
2222  * - decoding: Set by user.
2223  */
2225 
2226  /* audio only */
2227  int sample_rate; ///< samples per second
2228  int channels; ///< number of audio channels
2229 
2230  /**
2231  * audio sample format
2232  * - encoding: Set by user.
2233  * - decoding: Set by libavcodec.
2234  */
2235  enum AVSampleFormat sample_fmt; ///< sample format
2236 
2237  /* The following data should not be initialized. */
2238  /**
2239  * Number of samples per channel in an audio frame.
2240  *
2241  * - encoding: set by libavcodec in avcodec_open2(). Each submitted frame
2242  * except the last must contain exactly frame_size samples per channel.
2243  * May be 0 when the codec has AV_CODEC_CAP_VARIABLE_FRAME_SIZE set, then the
2244  * frame size is not restricted.
2245  * - decoding: may be set by some decoders to indicate constant frame size
2246  */
2248 
2249  /**
2250  * Frame counter, set by libavcodec.
2251  *
2252  * - decoding: total number of frames returned from the decoder so far.
2253  * - encoding: total number of frames passed to the encoder so far.
2254  *
2255  * @note the counter is not incremented if encoding/decoding resulted in
2256  * an error.
2257  */
2259 
2260  /**
2261  * number of bytes per packet if constant and known or 0
2262  * Used by some WAV based audio codecs.
2263  */
2265 
2266  /**
2267  * Audio cutoff bandwidth (0 means "automatic")
2268  * - encoding: Set by user.
2269  * - decoding: unused
2270  */
2271  int cutoff;
2272 
2273  /**
2274  * Audio channel layout.
2275  * - encoding: set by user.
2276  * - decoding: set by user, may be overwritten by libavcodec.
2277  */
2278  uint64_t channel_layout;
2279 
2280  /**
2281  * Request decoder to use this channel layout if it can (0 for default)
2282  * - encoding: unused
2283  * - decoding: Set by user.
2284  */
2286 
2287  /**
2288  * Type of service that the audio stream conveys.
2289  * - encoding: Set by user.
2290  * - decoding: Set by libavcodec.
2291  */
2293 
2294  /**
2295  * desired sample format
2296  * - encoding: Not used.
2297  * - decoding: Set by user.
2298  * Decoder will decode to this format if it can.
2299  */
2301 
2302  /**
2303  * This callback is called at the beginning of each frame to get data
2304  * buffer(s) for it. There may be one contiguous buffer for all the data or
2305  * there may be a buffer per each data plane or anything in between. What
2306  * this means is, you may set however many entries in buf[] you feel necessary.
2307  * Each buffer must be reference-counted using the AVBuffer API (see description
2308  * of buf[] below).
2309  *
2310  * The following fields will be set in the frame before this callback is
2311  * called:
2312  * - format
2313  * - width, height (video only)
2314  * - sample_rate, channel_layout, nb_samples (audio only)
2315  * Their values may differ from the corresponding values in
2316  * AVCodecContext. This callback must use the frame values, not the codec
2317  * context values, to calculate the required buffer size.
2318  *
2319  * This callback must fill the following fields in the frame:
2320  * - data[]
2321  * - linesize[]
2322  * - extended_data:
2323  * * if the data is planar audio with more than 8 channels, then this
2324  * callback must allocate and fill extended_data to contain all pointers
2325  * to all data planes. data[] must hold as many pointers as it can.
2326  * extended_data must be allocated with av_malloc() and will be freed in
2327  * av_frame_unref().
2328  * * otherwise extended_data must point to data
2329  * - buf[] must contain one or more pointers to AVBufferRef structures. Each of
2330  * the frame's data and extended_data pointers must be contained in these. That
2331  * is, one AVBufferRef for each allocated chunk of memory, not necessarily one
2332  * AVBufferRef per data[] entry. See: av_buffer_create(), av_buffer_alloc(),
2333  * and av_buffer_ref().
2334  * - extended_buf and nb_extended_buf must be allocated with av_malloc() by
2335  * this callback and filled with the extra buffers if there are more
2336  * buffers than buf[] can hold. extended_buf will be freed in
2337  * av_frame_unref().
2338  *
2339  * If AV_CODEC_CAP_DR1 is not set then get_buffer2() must call
2340  * avcodec_default_get_buffer2() instead of providing buffers allocated by
2341  * some other means.
2342  *
2343  * Each data plane must be aligned to the maximum required by the target
2344  * CPU.
2345  *
2346  * @see avcodec_default_get_buffer2()
2347  *
2348  * Video:
2349  *
2350  * If AV_GET_BUFFER_FLAG_REF is set in flags then the frame may be reused
2351  * (read and/or written to if it is writable) later by libavcodec.
2352  *
2353  * avcodec_align_dimensions2() should be used to find the required width and
2354  * height, as they normally need to be rounded up to the next multiple of 16.
2355  *
2356  * Some decoders do not support linesizes changing between frames.
2357  *
2358  * If frame multithreading is used and thread_safe_callbacks is set,
2359  * this callback may be called from a different thread, but not from more
2360  * than one at once. Does not need to be reentrant.
2361  *
2362  * @see avcodec_align_dimensions2()
2363  *
2364  * Audio:
2365  *
2366  * Decoders request a buffer of a particular size by setting
2367  * AVFrame.nb_samples prior to calling get_buffer2(). The decoder may,
2368  * however, utilize only part of the buffer by setting AVFrame.nb_samples
2369  * to a smaller value in the output frame.
2370  *
2371  * As a convenience, av_samples_get_buffer_size() and
2372  * av_samples_fill_arrays() in libavutil may be used by custom get_buffer2()
2373  * functions to find the required data size and to fill data pointers and
2374  * linesize. In AVFrame.linesize, only linesize[0] may be set for audio
2375  * since all planes must be the same size.
2376  *
2377  * @see av_samples_get_buffer_size(), av_samples_fill_arrays()
2378  *
2379  * - encoding: unused
2380  * - decoding: Set by libavcodec, user can override.
2381  */
2382  int (*get_buffer2)(struct AVCodecContext *s, AVFrame *frame, int flags);
2383 
2384  /**
2385  * If non-zero, the decoded audio and video frames returned from
2386  * avcodec_decode_video2() and avcodec_decode_audio4() are reference-counted
2387  * and are valid indefinitely. The caller must free them with
2388  * av_frame_unref() when they are not needed anymore.
2389  * Otherwise, the decoded frames must not be freed by the caller and are
2390  * only valid until the next decode call.
2391  *
2392  * This is always automatically enabled if avcodec_receive_frame() is used.
2393  *
2394  * - encoding: unused
2395  * - decoding: set by the caller before avcodec_open2().
2396  */
2399 
2400  /* - encoding parameters */
2401  float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
2402  float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
2403 
2404  /**
2405  * minimum quantizer
2406  * - encoding: Set by user.
2407  * - decoding: unused
2408  */
2409  int qmin;
2410 
2411  /**
2412  * maximum quantizer
2413  * - encoding: Set by user.
2414  * - decoding: unused
2415  */
2416  int qmax;
2417 
2418  /**
2419  * maximum quantizer difference between frames
2420  * - encoding: Set by user.
2421  * - decoding: unused
2422  */
2424 
2425  /**
2426  * decoder bitstream buffer size
2427  * - encoding: Set by user.
2428  * - decoding: unused
2429  */
2431 
2432  /**
2433  * ratecontrol override, see RcOverride
2434  * - encoding: Allocated/set/freed by user.
2435  * - decoding: unused
2436  */
2439 
2440  /**
2441  * maximum bitrate
2442  * - encoding: Set by user.
2443  * - decoding: Set by user, may be overwritten by libavcodec.
2444  */
2445  int64_t rc_max_rate;
2446 
2447  /**
2448  * minimum bitrate
2449  * - encoding: Set by user.
2450  * - decoding: unused
2451  */
2452  int64_t rc_min_rate;
2453 
2454  /**
2455  * Ratecontrol attempt to use, at maximum, <value> of what can be used without an underflow.
2456  * - encoding: Set by user.
2457  * - decoding: unused.
2458  */
2460 
2461  /**
2462  * Ratecontrol attempt to use, at least, <value> times the amount needed to prevent a vbv overflow.
2463  * - encoding: Set by user.
2464  * - decoding: unused.
2465  */
2467 
2468  /**
2469  * Number of bits which should be loaded into the rc buffer before decoding starts.
2470  * - encoding: Set by user.
2471  * - decoding: unused
2472  */
2474 
2475 #if FF_API_CODER_TYPE
2476 #define FF_CODER_TYPE_VLC 0
2477 #define FF_CODER_TYPE_AC 1
2478 #define FF_CODER_TYPE_RAW 2
2479 #define FF_CODER_TYPE_RLE 3
2480  /**
2481  * @deprecated use encoder private options instead
2482  */
2485 #endif /* FF_API_CODER_TYPE */
2486 
2487 #if FF_API_PRIVATE_OPT
2488  /** @deprecated use encoder private options instead */
2491 #endif
2492 
2493 #if FF_API_PRIVATE_OPT
2494  /** @deprecated use encoder private options instead */
2497 
2498  /** @deprecated use encoder private options instead */
2501 
2502  /** @deprecated use encoder private options instead */
2505 
2506  /** @deprecated use encoder private options instead */
2509 #endif /* FF_API_PRIVATE_OPT */
2510 
2511  /**
2512  * trellis RD quantization
2513  * - encoding: Set by user.
2514  * - decoding: unused
2515  */
2516  int trellis;
2517 
2518 #if FF_API_PRIVATE_OPT
2519  /** @deprecated use encoder private options instead */
2522 
2523  /** @deprecated use encoder private options instead */
2526 
2527  /** @deprecated use encoder private options instead */
2530 #endif
2531 
2532 #if FF_API_RTP_CALLBACK
2533  /**
2534  * @deprecated unused
2535  */
2536  /* The RTP callback: This function is called */
2537  /* every time the encoder has a packet to send. */
2538  /* It depends on the encoder if the data starts */
2539  /* with a Start Code (it should). H.263 does. */
2540  /* mb_nb contains the number of macroblocks */
2541  /* encoded in the RTP payload. */
2543  void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
2544 #endif
2545 
2546 #if FF_API_PRIVATE_OPT
2547  /** @deprecated use encoder private options instead */
2549  int rtp_payload_size; /* The size of the RTP payload: the coder will */
2550  /* do its best to deliver a chunk with size */
2551  /* below rtp_payload_size, the chunk will start */
2552  /* with a start code on some codecs like H.263. */
2553  /* This doesn't take account of any particular */
2554  /* headers inside the transmitted RTP payload. */
2555 #endif
2556 
2557 #if FF_API_STAT_BITS
2558  /* statistics, used for 2-pass encoding */
2560  int mv_bits;
2568  int i_count;
2570  int p_count;
2575 
2576  /** @deprecated this field is unused */
2579 #endif
2580 
2581  /**
2582  * pass1 encoding statistics output buffer
2583  * - encoding: Set by libavcodec.
2584  * - decoding: unused
2585  */
2586  char *stats_out;
2587 
2588  /**
2589  * pass2 encoding statistics input buffer
2590  * Concatenated stuff from stats_out of pass1 should be placed here.
2591  * - encoding: Allocated/set/freed by user.
2592  * - decoding: unused
2593  */
2594  char *stats_in;
2595 
2596  /**
2597  * Work around bugs in encoders which sometimes cannot be detected automatically.
2598  * - encoding: Set by user
2599  * - decoding: Set by user
2600  */
2602 #define FF_BUG_AUTODETECT 1 ///< autodetection
2603 #define FF_BUG_XVID_ILACE 4
2604 #define FF_BUG_UMP4 8
2605 #define FF_BUG_NO_PADDING 16
2606 #define FF_BUG_AMV 32
2607 #define FF_BUG_QPEL_CHROMA 64
2608 #define FF_BUG_STD_QPEL 128
2609 #define FF_BUG_QPEL_CHROMA2 256
2610 #define FF_BUG_DIRECT_BLOCKSIZE 512
2611 #define FF_BUG_EDGE 1024
2612 #define FF_BUG_HPEL_CHROMA 2048
2613 #define FF_BUG_DC_CLIP 4096
2614 #define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft's broken decoders.
2615 #define FF_BUG_TRUNCATED 16384
2616 #define FF_BUG_IEDGE 32768
2617 
2618  /**
2619  * strictly follow the standard (MPEG-4, ...).
2620  * - encoding: Set by user.
2621  * - decoding: Set by user.
2622  * Setting this to STRICT or higher means the encoder and decoder will
2623  * generally do stupid things, whereas setting it to unofficial or lower
2624  * will mean the encoder might produce output that is not supported by all
2625  * spec-compliant decoders. Decoders don't differentiate between normal,
2626  * unofficial and experimental (that is, they always try to decode things
2627  * when they can) unless they are explicitly asked to behave stupidly
2628  * (=strictly conform to the specs)
2629  */
2631 #define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to an older more strict version of the spec or reference software.
2632 #define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences.
2633 #define FF_COMPLIANCE_NORMAL 0
2634 #define FF_COMPLIANCE_UNOFFICIAL -1 ///< Allow unofficial extensions
2635 #define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.
2636 
2637  /**
2638  * error concealment flags
2639  * - encoding: unused
2640  * - decoding: Set by user.
2641  */
2643 #define FF_EC_GUESS_MVS 1
2644 #define FF_EC_DEBLOCK 2
2645 #define FF_EC_FAVOR_INTER 256
2646 
2647  /**
2648  * debug
2649  * - encoding: Set by user.
2650  * - decoding: Set by user.
2651  */
2652  int debug;
2653 #define FF_DEBUG_PICT_INFO 1
2654 #define FF_DEBUG_RC 2
2655 #define FF_DEBUG_BITSTREAM 4
2656 #define FF_DEBUG_MB_TYPE 8
2657 #define FF_DEBUG_QP 16
2658 #if FF_API_DEBUG_MV
2659 /**
2660  * @deprecated this option does nothing
2661  */
2662 #define FF_DEBUG_MV 32
2663 #endif
2664 #define FF_DEBUG_DCT_COEFF 0x00000040
2665 #define FF_DEBUG_SKIP 0x00000080
2666 #define FF_DEBUG_STARTCODE 0x00000100
2667 #define FF_DEBUG_ER 0x00000400
2668 #define FF_DEBUG_MMCO 0x00000800
2669 #define FF_DEBUG_BUGS 0x00001000
2670 #if FF_API_DEBUG_MV
2671 #define FF_DEBUG_VIS_QP 0x00002000
2672 #define FF_DEBUG_VIS_MB_TYPE 0x00004000
2673 #endif
2674 #define FF_DEBUG_BUFFERS 0x00008000
2675 #define FF_DEBUG_THREADS 0x00010000
2676 #define FF_DEBUG_GREEN_MD 0x00800000
2677 #define FF_DEBUG_NOMC 0x01000000
2678 
2679 #if FF_API_DEBUG_MV
2680  /**
2681  * debug
2682  * - encoding: Set by user.
2683  * - decoding: Set by user.
2684  */
2685  int debug_mv;
2686 #define FF_DEBUG_VIS_MV_P_FOR 0x00000001 // visualize forward predicted MVs of P-frames
2687 #define FF_DEBUG_VIS_MV_B_FOR 0x00000002 // visualize forward predicted MVs of B-frames
2688 #define FF_DEBUG_VIS_MV_B_BACK 0x00000004 // visualize backward predicted MVs of B-frames
2689 #endif
2690 
2691  /**
2692  * Error recognition; may misdetect some more or less valid parts as errors.
2693  * - encoding: unused
2694  * - decoding: Set by user.
2695  */
2697 
2698 /**
2699  * Verify checksums embedded in the bitstream (could be of either encoded or
2700  * decoded data, depending on the codec) and print an error message on mismatch.
2701  * If AV_EF_EXPLODE is also set, a mismatching checksum will result in the
2702  * decoder returning an error.
2703  */
2704 #define AV_EF_CRCCHECK (1<<0)
2705 #define AV_EF_BITSTREAM (1<<1) ///< detect bitstream specification deviations
2706 #define AV_EF_BUFFER (1<<2) ///< detect improper bitstream length
2707 #define AV_EF_EXPLODE (1<<3) ///< abort decoding on minor error detection
2708 
2709 #define AV_EF_IGNORE_ERR (1<<15) ///< ignore errors and continue
2710 #define AV_EF_CAREFUL (1<<16) ///< consider things that violate the spec, are fast to calculate and have not been seen in the wild as errors
2711 #define AV_EF_COMPLIANT (1<<17) ///< consider all spec non compliances as errors
2712 #define AV_EF_AGGRESSIVE (1<<18) ///< consider things that a sane encoder should not do as an error
2713 
2714 
2715  /**
2716  * opaque 64-bit number (generally a PTS) that will be reordered and
2717  * output in AVFrame.reordered_opaque
2718  * - encoding: Set by libavcodec to the reordered_opaque of the input
2719  * frame corresponding to the last returned packet. Only
2720  * supported by encoders with the
2721  * AV_CODEC_CAP_ENCODER_REORDERED_OPAQUE capability.
2722  * - decoding: Set by user.
2723  */
2725 
2726  /**
2727  * Hardware accelerator in use
2728  * - encoding: unused.
2729  * - decoding: Set by libavcodec
2730  */
2731  const struct AVHWAccel *hwaccel;
2732 
2733  /**
2734  * Hardware accelerator context.
2735  * For some hardware accelerators, a global context needs to be
2736  * provided by the user. In that case, this holds display-dependent
2737  * data FFmpeg cannot instantiate itself. Please refer to the
2738  * FFmpeg HW accelerator documentation to know how to fill this
2739  * is. e.g. for VA API, this is a struct vaapi_context.
2740  * - encoding: unused
2741  * - decoding: Set by user
2742  */
2744 
2745  /**
2746  * error
2747  * - encoding: Set by libavcodec if flags & AV_CODEC_FLAG_PSNR.
2748  * - decoding: unused
2749  */
2751 
2752  /**
2753  * DCT algorithm, see FF_DCT_* below
2754  * - encoding: Set by user.
2755  * - decoding: unused
2756  */
2758 #define FF_DCT_AUTO 0
2759 #define FF_DCT_FASTINT 1
2760 #define FF_DCT_INT 2
2761 #define FF_DCT_MMX 3
2762 #define FF_DCT_ALTIVEC 5
2763 #define FF_DCT_FAAN 6
2764 
2765  /**
2766  * IDCT algorithm, see FF_IDCT_* below.
2767  * - encoding: Set by user.
2768  * - decoding: Set by user.
2769  */
2771 #define FF_IDCT_AUTO 0
2772 #define FF_IDCT_INT 1
2773 #define FF_IDCT_SIMPLE 2
2774 #define FF_IDCT_SIMPLEMMX 3
2775 #define FF_IDCT_ARM 7
2776 #define FF_IDCT_ALTIVEC 8
2777 #define FF_IDCT_SIMPLEARM 10
2778 #define FF_IDCT_XVID 14
2779 #define FF_IDCT_SIMPLEARMV5TE 16
2780 #define FF_IDCT_SIMPLEARMV6 17
2781 #define FF_IDCT_FAAN 20
2782 #define FF_IDCT_SIMPLENEON 22
2783 #define FF_IDCT_NONE 24 /* Used by XvMC to extract IDCT coefficients with FF_IDCT_PERM_NONE */
2784 #define FF_IDCT_SIMPLEAUTO 128
2785 
2786  /**
2787  * bits per sample/pixel from the demuxer (needed for huffyuv).
2788  * - encoding: Set by libavcodec.
2789  * - decoding: Set by user.
2790  */
2792 
2793  /**
2794  * Bits per sample/pixel of internal libavcodec pixel/sample format.
2795  * - encoding: set by user.
2796  * - decoding: set by libavcodec.
2797  */
2799 
2800 #if FF_API_LOWRES
2801  /**
2802  * low resolution decoding, 1-> 1/2 size, 2->1/4 size
2803  * - encoding: unused
2804  * - decoding: Set by user.
2805  */
2806  int lowres;
2807 #endif
2808 
2809 #if FF_API_CODED_FRAME
2810  /**
2811  * the picture in the bitstream
2812  * - encoding: Set by libavcodec.
2813  * - decoding: unused
2814  *
2815  * @deprecated use the quality factor packet side data instead
2816  */
2818 #endif
2819 
2820  /**
2821  * thread count
2822  * is used to decide how many independent tasks should be passed to execute()
2823  * - encoding: Set by user.
2824  * - decoding: Set by user.
2825  */
2827 
2828  /**
2829  * Which multithreading methods to use.
2830  * Use of FF_THREAD_FRAME will increase decoding delay by one frame per thread,
2831  * so clients which cannot provide future frames should not use it.
2832  *
2833  * - encoding: Set by user, otherwise the default is used.
2834  * - decoding: Set by user, otherwise the default is used.
2835  */
2837 #define FF_THREAD_FRAME 1 ///< Decode more than one frame at once
2838 #define FF_THREAD_SLICE 2 ///< Decode more than one part of a single frame at once
2839 
2840  /**
2841  * Which multithreading methods are in use by the codec.
2842  * - encoding: Set by libavcodec.
2843  * - decoding: Set by libavcodec.
2844  */
2846 
2847  /**
2848  * Set by the client if its custom get_buffer() callback can be called
2849  * synchronously from another thread, which allows faster multithreaded decoding.
2850  * draw_horiz_band() will be called from other threads regardless of this setting.
2851  * Ignored if the default get_buffer() is used.
2852  * - encoding: Set by user.
2853  * - decoding: Set by user.
2854  */
2856 
2857  /**
2858  * The codec may call this to execute several independent things.
2859  * It will return only after finishing all tasks.
2860  * The user may replace this with some multithreaded implementation,
2861  * the default implementation will execute the parts serially.
2862  * @param count the number of things to execute
2863  * - encoding: Set by libavcodec, user can override.
2864  * - decoding: Set by libavcodec, user can override.
2865  */
2866  int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size);
2867 
2868  /**
2869  * The codec may call this to execute several independent things.
2870  * It will return only after finishing all tasks.
2871  * The user may replace this with some multithreaded implementation,
2872  * the default implementation will execute the parts serially.
2873  * Also see avcodec_thread_init and e.g. the --enable-pthread configure option.
2874  * @param c context passed also to func
2875  * @param count the number of things to execute
2876  * @param arg2 argument passed unchanged to func
2877  * @param ret return values of executed functions, must have space for "count" values. May be NULL.
2878  * @param func function that will be called count times, with jobnr from 0 to count-1.
2879  * threadnr will be in the range 0 to c->thread_count-1 < MAX_THREADS and so that no
2880  * two instances of func executing at the same time will have the same threadnr.
2881  * @return always 0 currently, but code should handle a future improvement where when any call to func
2882  * returns < 0 no further calls to func may be done and < 0 is returned.
2883  * - encoding: Set by libavcodec, user can override.
2884  * - decoding: Set by libavcodec, user can override.
2885  */
2886  int (*execute2)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count);
2887 
2888  /**
2889  * noise vs. sse weight for the nsse comparison function
2890  * - encoding: Set by user.
2891  * - decoding: unused
2892  */
2894 
2895  /**
2896  * profile
2897  * - encoding: Set by user.
2898  * - decoding: Set by libavcodec.
2899  */
2900  int profile;
2901 #define FF_PROFILE_UNKNOWN -99
2902 #define FF_PROFILE_RESERVED -100
2903 
2904 #define FF_PROFILE_AAC_MAIN 0
2905 #define FF_PROFILE_AAC_LOW 1
2906 #define FF_PROFILE_AAC_SSR 2
2907 #define FF_PROFILE_AAC_LTP 3
2908 #define FF_PROFILE_AAC_HE 4
2909 #define FF_PROFILE_AAC_HE_V2 28
2910 #define FF_PROFILE_AAC_LD 22
2911 #define FF_PROFILE_AAC_ELD 38
2912 #define FF_PROFILE_MPEG2_AAC_LOW 128
2913 #define FF_PROFILE_MPEG2_AAC_HE 131
2914 
2915 #define FF_PROFILE_DNXHD 0
2916 #define FF_PROFILE_DNXHR_LB 1
2917 #define FF_PROFILE_DNXHR_SQ 2
2918 #define FF_PROFILE_DNXHR_HQ 3
2919 #define FF_PROFILE_DNXHR_HQX 4
2920 #define FF_PROFILE_DNXHR_444 5
2921 
2922 #define FF_PROFILE_DTS 20
2923 #define FF_PROFILE_DTS_ES 30
2924 #define FF_PROFILE_DTS_96_24 40
2925 #define FF_PROFILE_DTS_HD_HRA 50
2926 #define FF_PROFILE_DTS_HD_MA 60
2927 #define FF_PROFILE_DTS_EXPRESS 70
2928 
2929 #define FF_PROFILE_MPEG2_422 0
2930 #define FF_PROFILE_MPEG2_HIGH 1
2931 #define FF_PROFILE_MPEG2_SS 2
2932 #define FF_PROFILE_MPEG2_SNR_SCALABLE 3
2933 #define FF_PROFILE_MPEG2_MAIN 4
2934 #define FF_PROFILE_MPEG2_SIMPLE 5
2935 
2936 #define FF_PROFILE_H264_CONSTRAINED (1<<9) // 8+1; constraint_set1_flag
2937 #define FF_PROFILE_H264_INTRA (1<<11) // 8+3; constraint_set3_flag
2938 
2939 #define FF_PROFILE_H264_BASELINE 66
2940 #define FF_PROFILE_H264_CONSTRAINED_BASELINE (66|FF_PROFILE_H264_CONSTRAINED)
2941 #define FF_PROFILE_H264_MAIN 77
2942 #define FF_PROFILE_H264_EXTENDED 88
2943 #define FF_PROFILE_H264_HIGH 100
2944 #define FF_PROFILE_H264_HIGH_10 110
2945 #define FF_PROFILE_H264_HIGH_10_INTRA (110|FF_PROFILE_H264_INTRA)
2946 #define FF_PROFILE_H264_MULTIVIEW_HIGH 118
2947 #define FF_PROFILE_H264_HIGH_422 122
2948 #define FF_PROFILE_H264_HIGH_422_INTRA (122|FF_PROFILE_H264_INTRA)
2949 #define FF_PROFILE_H264_STEREO_HIGH 128
2950 #define FF_PROFILE_H264_HIGH_444 144
2951 #define FF_PROFILE_H264_HIGH_444_PREDICTIVE 244
2952 #define FF_PROFILE_H264_HIGH_444_INTRA (244|FF_PROFILE_H264_INTRA)
2953 #define FF_PROFILE_H264_CAVLC_444 44
2954 
2955 #define FF_PROFILE_VC1_SIMPLE 0
2956 #define FF_PROFILE_VC1_MAIN 1
2957 #define FF_PROFILE_VC1_COMPLEX 2
2958 #define FF_PROFILE_VC1_ADVANCED 3
2959 
2960 #define FF_PROFILE_MPEG4_SIMPLE 0
2961 #define FF_PROFILE_MPEG4_SIMPLE_SCALABLE 1
2962 #define FF_PROFILE_MPEG4_CORE 2
2963 #define FF_PROFILE_MPEG4_MAIN 3
2964 #define FF_PROFILE_MPEG4_N_BIT 4
2965 #define FF_PROFILE_MPEG4_SCALABLE_TEXTURE 5
2966 #define FF_PROFILE_MPEG4_SIMPLE_FACE_ANIMATION 6
2967 #define FF_PROFILE_MPEG4_BASIC_ANIMATED_TEXTURE 7
2968 #define FF_PROFILE_MPEG4_HYBRID 8
2969 #define FF_PROFILE_MPEG4_ADVANCED_REAL_TIME 9
2970 #define FF_PROFILE_MPEG4_CORE_SCALABLE 10
2971 #define FF_PROFILE_MPEG4_ADVANCED_CODING 11
2972 #define FF_PROFILE_MPEG4_ADVANCED_CORE 12
2973 #define FF_PROFILE_MPEG4_ADVANCED_SCALABLE_TEXTURE 13
2974 #define FF_PROFILE_MPEG4_SIMPLE_STUDIO 14
2975 #define FF_PROFILE_MPEG4_ADVANCED_SIMPLE 15
2976 
2977 #define FF_PROFILE_JPEG2000_CSTREAM_RESTRICTION_0 1
2978 #define FF_PROFILE_JPEG2000_CSTREAM_RESTRICTION_1 2
2979 #define FF_PROFILE_JPEG2000_CSTREAM_NO_RESTRICTION 32768
2980 #define FF_PROFILE_JPEG2000_DCINEMA_2K 3
2981 #define FF_PROFILE_JPEG2000_DCINEMA_4K 4
2982 
2983 #define FF_PROFILE_VP9_0 0
2984 #define FF_PROFILE_VP9_1 1
2985 #define FF_PROFILE_VP9_2 2
2986 #define FF_PROFILE_VP9_3 3
2987 
2988 #define FF_PROFILE_HEVC_MAIN 1
2989 #define FF_PROFILE_HEVC_MAIN_10 2
2990 #define FF_PROFILE_HEVC_MAIN_STILL_PICTURE 3
2991 #define FF_PROFILE_HEVC_REXT 4
2992 
2993 #define FF_PROFILE_AV1_MAIN 0
2994 #define FF_PROFILE_AV1_HIGH 1
2995 #define FF_PROFILE_AV1_PROFESSIONAL 2
2996 
2997 #define FF_PROFILE_MJPEG_HUFFMAN_BASELINE_DCT 0xc0
2998 #define FF_PROFILE_MJPEG_HUFFMAN_EXTENDED_SEQUENTIAL_DCT 0xc1
2999 #define FF_PROFILE_MJPEG_HUFFMAN_PROGRESSIVE_DCT 0xc2
3000 #define FF_PROFILE_MJPEG_HUFFMAN_LOSSLESS 0xc3
3001 #define FF_PROFILE_MJPEG_JPEG_LS 0xf7
3002 
3003 #define FF_PROFILE_SBC_MSBC 1
3004 
3005 #define FF_PROFILE_PRORES_PROXY 0
3006 #define FF_PROFILE_PRORES_LT 1
3007 #define FF_PROFILE_PRORES_STANDARD 2
3008 #define FF_PROFILE_PRORES_HQ 3
3009 #define FF_PROFILE_PRORES_4444 4
3010 #define FF_PROFILE_PRORES_XQ 5
3011 
3012 #define FF_PROFILE_ARIB_PROFILE_A 0
3013 #define FF_PROFILE_ARIB_PROFILE_C 1
3014 
3015  /**
3016  * level
3017  * - encoding: Set by user.
3018  * - decoding: Set by libavcodec.
3019  */
3020  int level;
3021 #define FF_LEVEL_UNKNOWN -99
3022 
3023  /**
3024  * Skip loop filtering for selected frames.
3025  * - encoding: unused
3026  * - decoding: Set by user.
3027  */
3029 
3030  /**
3031  * Skip IDCT/dequantization for selected frames.
3032  * - encoding: unused
3033  * - decoding: Set by user.
3034  */
3036 
3037  /**
3038  * Skip decoding for selected frames.
3039  * - encoding: unused
3040  * - decoding: Set by user.
3041  */
3043 
3044  /**
3045  * Header containing style information for text subtitles.
3046  * For SUBTITLE_ASS subtitle type, it should contain the whole ASS
3047  * [Script Info] and [V4+ Styles] section, plus the [Events] line and
3048  * the Format line following. It shouldn't include any Dialogue line.
3049  * - encoding: Set/allocated/freed by user (before avcodec_open2())
3050  * - decoding: Set/allocated/freed by libavcodec (by avcodec_open2())
3051  */
3054 
3055 #if FF_API_VBV_DELAY
3056  /**
3057  * VBV delay coded in the last frame (in periods of a 27 MHz clock).
3058  * Used for compliant TS muxing.
3059  * - encoding: Set by libavcodec.
3060  * - decoding: unused.
3061  * @deprecated this value is now exported as a part of
3062  * AV_PKT_DATA_CPB_PROPERTIES packet side data
3063  */
3065  uint64_t vbv_delay;
3066 #endif
3067 
3068 #if FF_API_SIDEDATA_ONLY_PKT
3069  /**
3070  * Encoding only and set by default. Allow encoders to output packets
3071  * that do not contain any encoded data, only side data.
3072  *
3073  * Some encoders need to output such packets, e.g. to update some stream
3074  * parameters at the end of encoding.
3075  *
3076  * @deprecated this field disables the default behaviour and
3077  * it is kept only for compatibility.
3078  */
3081 #endif
3082 
3083  /**
3084  * Audio only. The number of "priming" samples (padding) inserted by the
3085  * encoder at the beginning of the audio. I.e. this number of leading
3086  * decoded samples must be discarded by the caller to get the original audio
3087  * without leading padding.
3088  *
3089  * - decoding: unused
3090  * - encoding: Set by libavcodec. The timestamps on the output packets are
3091  * adjusted by the encoder so that they always refer to the
3092  * first sample of the data actually contained in the packet,
3093  * including any added padding. E.g. if the timebase is
3094  * 1/samplerate and the timestamp of the first input sample is
3095  * 0, the timestamp of the first output packet will be
3096  * -initial_padding.
3097  */
3099 
3100  /**
3101  * - decoding: For codecs that store a framerate value in the compressed
3102  * bitstream, the decoder may export it here. { 0, 1} when
3103  * unknown.
3104  * - encoding: May be used to signal the framerate of CFR content to an
3105  * encoder.
3106  */
3108 
3109  /**
3110  * Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx.
3111  * - encoding: unused.
3112  * - decoding: Set by libavcodec before calling get_format()
3113  */
3115 
3116  /**
3117  * Timebase in which pkt_dts/pts and AVPacket.dts/pts are.
3118  * - encoding unused.
3119  * - decoding set by user.
3120  */
3122 
3123  /**
3124  * AVCodecDescriptor
3125  * - encoding: unused.
3126  * - decoding: set by libavcodec.
3127  */
3129 
3130 #if !FF_API_LOWRES
3131  /**
3132  * low resolution decoding, 1-> 1/2 size, 2->1/4 size
3133  * - encoding: unused
3134  * - decoding: Set by user.
3135  */
3136  int lowres;
3137 #endif
3138 
3139  /**
3140  * Current statistics for PTS correction.
3141  * - decoding: maintained and used by libavcodec, not intended to be used by user apps
3142  * - encoding: unused
3143  */
3144  int64_t pts_correction_num_faulty_pts; /// Number of incorrect PTS values so far
3145  int64_t pts_correction_num_faulty_dts; /// Number of incorrect DTS values so far
3146  int64_t pts_correction_last_pts; /// PTS of the last frame
3147  int64_t pts_correction_last_dts; /// DTS of the last frame
3148 
3149  /**
3150  * Character encoding of the input subtitles file.
3151  * - decoding: set by user
3152  * - encoding: unused
3153  */
3155 
3156  /**
3157  * Subtitles character encoding mode. Formats or codecs might be adjusting
3158  * this setting (if they are doing the conversion themselves for instance).
3159  * - decoding: set by libavcodec
3160  * - encoding: unused
3161  */
3163 #define FF_SUB_CHARENC_MODE_DO_NOTHING -1 ///< do nothing (demuxer outputs a stream supposed to be already in UTF-8, or the codec is bitmap for instance)
3164 #define FF_SUB_CHARENC_MODE_AUTOMATIC 0 ///< libavcodec will select the mode itself
3165 #define FF_SUB_CHARENC_MODE_PRE_DECODER 1 ///< the AVPacket data needs to be recoded to UTF-8 before being fed to the decoder, requires iconv
3166 #define FF_SUB_CHARENC_MODE_IGNORE 2 ///< neither convert the subtitles, nor check them for valid UTF-8
3167 
3168  /**
3169  * Skip processing alpha if supported by codec.
3170  * Note that if the format uses pre-multiplied alpha (common with VP6,
3171  * and recommended due to better video quality/compression)
3172  * the image will look as if alpha-blended onto a black background.
3173  * However for formats that do not use pre-multiplied alpha
3174  * there might be serious artefacts (though e.g. libswscale currently
3175  * assumes pre-multiplied alpha anyway).
3176  *
3177  * - decoding: set by user
3178  * - encoding: unused
3179  */
3181 
3182  /**
3183  * Number of samples to skip after a discontinuity
3184  * - decoding: unused
3185  * - encoding: set by libavcodec
3186  */
3188 
3189 #if !FF_API_DEBUG_MV
3190  /**
3191  * debug motion vectors
3192  * - encoding: Set by user.
3193  * - decoding: Set by user.
3194  */
3196 #define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames
3197 #define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames
3198 #define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
3199 #endif
3200 
3201  /**
3202  * custom intra quantization matrix
3203  * - encoding: Set by user, can be NULL.
3204  * - decoding: unused.
3205  */
3207 
3208  /**
3209  * dump format separator.
3210  * can be ", " or "\n " or anything else
3211  * - encoding: Set by user.
3212  * - decoding: Set by user.
3213  */
3214  uint8_t *dump_separator;
3215 
3216  /**
3217  * ',' separated list of allowed decoders.
3218  * If NULL then all are allowed
3219  * - encoding: unused
3220  * - decoding: set by user
3221  */
3223 
3224  /**
3225  * Properties of the stream that gets decoded
3226  * - encoding: unused
3227  * - decoding: set by libavcodec
3228  */
3229  unsigned properties;
3230 #define FF_CODEC_PROPERTY_LOSSLESS 0x00000001
3231 #define FF_CODEC_PROPERTY_CLOSED_CAPTIONS 0x00000002
3232 
3233  /**
3234  * Additional data associated with the entire coded stream.
3235  *
3236  * - decoding: unused
3237  * - encoding: may be set by libavcodec after avcodec_open2().
3238  */
3241 
3242  /**
3243  * A reference to the AVHWFramesContext describing the input (for encoding)
3244  * or output (decoding) frames. The reference is set by the caller and
3245  * afterwards owned (and freed) by libavcodec - it should never be read by
3246  * the caller after being set.
3247  *
3248  * - decoding: This field should be set by the caller from the get_format()
3249  * callback. The previous reference (if any) will always be
3250  * unreffed by libavcodec before the get_format() call.
3251  *
3252  * If the default get_buffer2() is used with a hwaccel pixel
3253  * format, then this AVHWFramesContext will be used for
3254  * allocating the frame buffers.
3255  *
3256  * - encoding: For hardware encoders configured to use a hwaccel pixel
3257  * format, this field should be set by the caller to a reference
3258  * to the AVHWFramesContext describing input frames.
3259  * AVHWFramesContext.format must be equal to
3260  * AVCodecContext.pix_fmt.
3261  *
3262  * This field should be set before avcodec_open2() is called.
3263  */
3265 
3266  /**
3267  * Control the form of AVSubtitle.rects[N]->ass
3268  * - decoding: set by user
3269  * - encoding: unused
3270  */
3272 #define FF_SUB_TEXT_FMT_ASS 0
3273 #if FF_API_ASS_TIMING
3274 #define FF_SUB_TEXT_FMT_ASS_WITH_TIMINGS 1
3275 #endif
3276 
3277  /**
3278  * Audio only. The amount of padding (in samples) appended by the encoder to
3279  * the end of the audio. I.e. this number of decoded samples must be
3280  * discarded by the caller from the end of the stream to get the original
3281  * audio without any trailing padding.
3282  *
3283  * - decoding: unused
3284  * - encoding: unused
3285  */
3287 
3288  /**
3289  * The number of pixels per image to maximally accept.
3290  *
3291  * - decoding: set by user
3292  * - encoding: set by user
3293  */
3294  int64_t max_pixels;
3295 
3296  /**
3297  * A reference to the AVHWDeviceContext describing the device which will
3298  * be used by a hardware encoder/decoder. The reference is set by the
3299  * caller and afterwards owned (and freed) by libavcodec.
3300  *
3301  * This should be used if either the codec device does not require
3302  * hardware frames or any that are used are to be allocated internally by
3303  * libavcodec. If the user wishes to supply any of the frames used as
3304  * encoder input or decoder output then hw_frames_ctx should be used
3305  * instead. When hw_frames_ctx is set in get_format() for a decoder, this
3306  * field will be ignored while decoding the associated stream segment, but
3307  * may again be used on a following one after another get_format() call.
3308  *
3309  * For both encoders and decoders this field should be set before
3310  * avcodec_open2() is called and must not be written to thereafter.
3311  *
3312  * Note that some decoders may require this field to be set initially in
3313  * order to support hw_frames_ctx at all - in that case, all frames
3314  * contexts used must be created on the same device.
3315  */
3317 
3318  /**
3319  * Bit set of AV_HWACCEL_FLAG_* flags, which affect hardware accelerated
3320  * decoding (if active).
3321  * - encoding: unused
3322  * - decoding: Set by user (either before avcodec_open2(), or in the
3323  * AVCodecContext.get_format callback)
3324  */
3326 
3327  /**
3328  * Video decoding only. Certain video codecs support cropping, meaning that
3329  * only a sub-rectangle of the decoded frame is intended for display. This
3330  * option controls how cropping is handled by libavcodec.
3331  *
3332  * When set to 1 (the default), libavcodec will apply cropping internally.
3333  * I.e. it will modify the output frame width/height fields and offset the
3334  * data pointers (only by as much as possible while preserving alignment, or
3335  * by the full amount if the AV_CODEC_FLAG_UNALIGNED flag is set) so that
3336  * the frames output by the decoder refer only to the cropped area. The
3337  * crop_* fields of the output frames will be zero.
3338  *
3339  * When set to 0, the width/height fields of the output frames will be set
3340  * to the coded dimensions and the crop_* fields will describe the cropping
3341  * rectangle. Applying the cropping is left to the caller.
3342  *
3343  * @warning When hardware acceleration with opaque output frames is used,
3344  * libavcodec is unable to apply cropping from the top/left border.
3345  *
3346  * @note when this option is set to zero, the width/height fields of the
3347  * AVCodecContext and output AVFrames have different meanings. The codec
3348  * context fields store display dimensions (with the coded dimensions in
3349  * coded_width/height), while the frame fields store the coded dimensions
3350  * (with the display dimensions being determined by the crop_* fields).
3351  */
3353 
3354  /*
3355  * Video decoding only. Sets the number of extra hardware frames which
3356  * the decoder will allocate for use by the caller. This must be set
3357  * before avcodec_open2() is called.
3358  *
3359  * Some hardware decoders require all frames that they will use for
3360  * output to be defined in advance before decoding starts. For such
3361  * decoders, the hardware frame pool must therefore be of a fixed size.
3362  * The extra frames set here are on top of any number that the decoder
3363  * needs internally in order to operate normally (for example, frames
3364  * used as reference pictures).
3365  */
3367 
3368  /**
3369  * The percentage of damaged samples to discard a frame.
3370  *
3371  * - decoding: set by user
3372  * - encoding: unused
3373  */
3375 } AVCodecContext;
3376 
3377 #if FF_API_CODEC_GET_SET
3378 /**
3379  * Accessors for some AVCodecContext fields. These used to be provided for ABI
3380  * compatibility, and do not need to be used anymore.
3381  */
3386 
3391 
3393 unsigned av_codec_get_codec_properties(const AVCodecContext *avctx);
3394 
3395 #if FF_API_LOWRES
3397 int av_codec_get_lowres(const AVCodecContext *avctx);
3399 void av_codec_set_lowres(AVCodecContext *avctx, int val);
3400 #endif
3401 
3403 int av_codec_get_seek_preroll(const AVCodecContext *avctx);
3405 void av_codec_set_seek_preroll(AVCodecContext *avctx, int val);
3406 
3408 uint16_t *av_codec_get_chroma_intra_matrix(const AVCodecContext *avctx);
3410 void av_codec_set_chroma_intra_matrix(AVCodecContext *avctx, uint16_t *val);
3411 #endif
3412 
3413 /**
3414  * AVProfile.
3415  */
3416 typedef struct AVProfile {
3417  int profile;
3418  const char *name; ///< short name for the profile
3419 } AVProfile;
3420 
3421 enum {
3422  /**
3423  * The codec supports this format via the hw_device_ctx interface.
3424  *
3425  * When selecting this format, AVCodecContext.hw_device_ctx should
3426  * have been set to a device of the specified type before calling
3427  * avcodec_open2().
3428  */
3430  /**
3431  * The codec supports this format via the hw_frames_ctx interface.
3432  *
3433  * When selecting this format for a decoder,
3434  * AVCodecContext.hw_frames_ctx should be set to a suitable frames
3435  * context inside the get_format() callback. The frames context
3436  * must have been created on a device of the specified type.
3437  */
3439  /**
3440  * The codec supports this format by some internal method.
3441  *
3442  * This format can be selected without any additional configuration -
3443  * no device or frames context is required.
3444  */
3446  /**
3447  * The codec supports this format by some ad-hoc method.
3448  *
3449  * Additional settings and/or function calls are required. See the
3450  * codec-specific documentation for details. (Methods requiring
3451  * this sort of configuration are deprecated and others should be
3452  * used in preference.)
3453  */
3455 };
3456 
3457 typedef struct AVCodecHWConfig {
3458  /**
3459  * A hardware pixel format which the codec can use.
3460  */
3462  /**
3463  * Bit set of AV_CODEC_HW_CONFIG_METHOD_* flags, describing the possible
3464  * setup methods which can be used with this configuration.
3465  */
3466  int methods;
3467  /**
3468  * The device type associated with the configuration.
3469  *
3470  * Must be set for AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX and
3471  * AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX, otherwise unused.
3472  */
3474 } AVCodecHWConfig;
3475 
3477 
3478 struct AVSubtitle;
3479 
3480 /**
3481  * AVCodec.
3482  */
3483 typedef struct AVCodec {
3484  /**
3485  * Name of the codec implementation.
3486  * The name is globally unique among encoders and among decoders (but an
3487  * encoder and a decoder can share the same name).
3488  * This is the primary way to find a codec from the user perspective.
3489  */
3490  const char *name;
3491  /**
3492  * Descriptive name for the codec, meant to be more human readable than name.
3493  * You should use the NULL_IF_CONFIG_SMALL() macro to define it.
3494  */
3495  const char *long_name;
3498  /**
3499  * Codec capabilities.
3500  * see AV_CODEC_CAP_*
3501  */
3503  const AVRational *supported_framerates; ///< array of supported framerates, or NULL if any, array is terminated by {0,0}
3504  const enum AVPixelFormat *pix_fmts; ///< array of supported pixel formats, or NULL if unknown, array is terminated by -1
3505  const int *supported_samplerates; ///< array of supported audio samplerates, or NULL if unknown, array is terminated by 0
3506  const enum AVSampleFormat *sample_fmts; ///< array of supported sample formats, or NULL if unknown, array is terminated by -1
3507  const uint64_t *channel_layouts; ///< array of support channel layouts, or NULL if unknown. array is terminated by 0
3508  uint8_t max_lowres; ///< maximum value for lowres supported by the decoder
3509  const AVClass *priv_class; ///< AVClass for the private context
3510  const AVProfile *profiles; ///< array of recognized profiles, or NULL if unknown, array is terminated by {FF_PROFILE_UNKNOWN}
3511 
3512  /**
3513  * Group name of the codec implementation.
3514  * This is a short symbolic name of the wrapper backing this codec. A
3515  * wrapper uses some kind of external implementation for the codec, such
3516  * as an external library, or a codec implementation provided by the OS or
3517  * the hardware.
3518  * If this field is NULL, this is a builtin, libavcodec native codec.
3519  * If non-NULL, this will be the suffix in AVCodec.name in most cases
3520  * (usually AVCodec.name will be of the form "<codec_name>_<wrapper_name>").
3521  */
3522  const char *wrapper_name;
3523 
3524  /*****************************************************************
3525  * No fields below this line are part of the public API. They
3526  * may not be used outside of libavcodec and can be changed and
3527  * removed at will.
3528  * New public fields should be added right above.
3529  *****************************************************************
3530  */
3532  struct AVCodec *next;
3533  /**
3534  * @name Frame-level threading support functions
3535  * @{
3536  */
3537  /**
3538  * If defined, called on thread contexts when they are created.
3539  * If the codec allocates writable tables in init(), re-allocate them here.
3540  * priv_data will be set to a copy of the original.
3541  */
3543  /**
3544  * Copy necessary context variables from a previous thread context to the current one.
3545  * If not defined, the next thread will start automatically; otherwise, the codec
3546  * must call ff_thread_finish_setup().
3547  *
3548  * dst and src will (rarely) point to the same context, in which case memcpy should be skipped.
3549  */
3551  /** @} */
3552 
3553  /**
3554  * Private codec-specific defaults.
3555  */
3557 
3558  /**
3559  * Initialize codec static data, called from avcodec_register().
3560  *
3561  * This is not intended for time consuming operations as it is
3562  * run for every codec regardless of that codec being used.
3563  */
3564  void (*init_static_data)(struct AVCodec *codec);
3565 
3567  int (*encode_sub)(AVCodecContext *, uint8_t *buf, int buf_size,
3568  const struct AVSubtitle *sub);
3569  /**
3570  * Encode data to an AVPacket.
3571  *
3572  * @param avctx codec context
3573  * @param avpkt output AVPacket (may contain a user-provided buffer)
3574  * @param[in] frame AVFrame containing the raw data to be encoded
3575  * @param[out] got_packet_ptr encoder sets to 0 or 1 to indicate that a
3576  * non-empty packet was returned in avpkt.
3577  * @return 0 on success, negative error code on failure
3578  */
3579  int (*encode2)(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame,
3580  int *got_packet_ptr);
3581  int (*decode)(AVCodecContext *, void *outdata, int *outdata_size, AVPacket *avpkt);
3583  /**
3584  * Encode API with decoupled packet/frame dataflow. The API is the
3585  * same as the avcodec_ prefixed APIs (avcodec_send_frame() etc.), except
3586  * that:
3587  * - never called if the codec is closed or the wrong type,
3588  * - if AV_CODEC_CAP_DELAY is not set, drain frames are never sent,
3589  * - only one drain frame is ever passed down,
3590  */
3591  int (*send_frame)(AVCodecContext *avctx, const AVFrame *frame);
3592  int (*receive_packet)(AVCodecContext *avctx, AVPacket *avpkt);
3593 
3594  /**
3595  * Decode API with decoupled packet/frame dataflow. This function is called
3596  * to get one output frame. It should call ff_decode_get_packet() to obtain
3597  * input data.
3598  */
3600  /**
3601  * Flush buffers.
3602  * Will be called when seeking
3603  */
3604  void (*flush)(AVCodecContext *);
3605  /**
3606  * Internal codec capabilities.
3607  * See FF_CODEC_CAP_* in internal.h
3608  */
3610 
3611  /**
3612  * Decoding only, a comma-separated list of bitstream filters to apply to
3613  * packets before decoding.
3614  */
3615  const char *bsfs;
3616 
3617  /**
3618  * Array of pointers to hardware configurations supported by the codec,
3619  * or NULL if no hardware supported. The array is terminated by a NULL
3620  * pointer.
3621  *
3622  * The user can only access this field via avcodec_get_hw_config().
3623  */
3624  const struct AVCodecHWConfigInternal **hw_configs;
3625 } AVCodec;
3626 
3627 #if FF_API_CODEC_GET_SET
3629 int av_codec_get_max_lowres(const AVCodec *codec);
3630 #endif
3631 
3632 struct MpegEncContext;
3633 
3634 /**
3635  * Retrieve supported hardware configurations for a codec.
3636  *
3637  * Values of index from zero to some maximum return the indexed configuration
3638  * descriptor; all other values return NULL. If the codec does not support
3639  * any hardware configurations then it will always return NULL.
3640  */
3641 const AVCodecHWConfig *avcodec_get_hw_config(const AVCodec *codec, int index);
3642 
3643 /**
3644  * @defgroup lavc_hwaccel AVHWAccel
3645  *
3646  * @note Nothing in this structure should be accessed by the user. At some
3647  * point in future it will not be externally visible at all.
3648  *
3649  * @{
3650  */
3651 typedef struct AVHWAccel {
3652  /**
3653  * Name of the hardware accelerated codec.
3654  * The name is globally unique among encoders and among decoders (but an
3655  * encoder and a decoder can share the same name).
3656  */
3657  const char *name;
3658 
3659  /**
3660  * Type of codec implemented by the hardware accelerator.
3661  *
3662  * See AVMEDIA_TYPE_xxx
3663  */
3665 
3666  /**
3667  * Codec implemented by the hardware accelerator.
3668  *
3669  * See AV_CODEC_ID_xxx
3670  */
3672 
3673  /**
3674  * Supported pixel format.
3675  *
3676  * Only hardware accelerated formats are supported here.
3677  */
3679 
3680  /**
3681  * Hardware accelerated codec capabilities.
3682  * see AV_HWACCEL_CODEC_CAP_*
3683  */
3685 
3686  /*****************************************************************
3687  * No fields below this line are part of the public API. They
3688  * may not be used outside of libavcodec and can be changed and
3689  * removed at will.
3690  * New public fields should be added right above.
3691  *****************************************************************
3692  */
3693 
3694  /**
3695  * Allocate a custom buffer
3696  */
3698 
3699  /**
3700  * Called at the beginning of each frame or field picture.
3701  *
3702  * Meaningful frame information (codec specific) is guaranteed to
3703  * be parsed at this point. This function is mandatory.
3704  *
3705  * Note that buf can be NULL along with buf_size set to 0.
3706  * Otherwise, this means the whole frame is available at this point.
3707  *
3708  * @param avctx the codec context
3709  * @param buf the frame data buffer base
3710  * @param buf_size the size of the frame in bytes
3711  * @return zero if successful, a negative value otherwise
3712  */
3713  int (*start_frame)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
3714 
3715  /**
3716  * Callback for parameter data (SPS/PPS/VPS etc).
3717  *
3718  * Useful for hardware decoders which keep persistent state about the
3719  * video parameters, and need to receive any changes to update that state.
3720  *
3721  * @param avctx the codec context
3722  * @param type the nal unit type
3723  * @param buf the nal unit data buffer
3724  * @param buf_size the size of the nal unit in bytes
3725  * @return zero if successful, a negative value otherwise
3726  */
3727  int (*decode_params)(AVCodecContext *avctx, int type, const uint8_t *buf, uint32_t buf_size);
3728 
3729  /**
3730  * Callback for each slice.
3731  *
3732  * Meaningful slice information (codec specific) is guaranteed to
3733  * be parsed at this point. This function is mandatory.
3734  * The only exception is XvMC, that works on MB level.
3735  *
3736  * @param avctx the codec context
3737  * @param buf the slice data buffer base
3738  * @param buf_size the size of the slice in bytes
3739  * @return zero if successful, a negative value otherwise
3740  */
3741  int (*decode_slice)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size);
3742 
3743  /**
3744  * Called at the end of each frame or field picture.
3745  *
3746  * The whole picture is parsed at this point and can now be sent
3747  * to the hardware accelerator. This function is mandatory.
3748  *
3749  * @param avctx the codec context
3750  * @return zero if successful, a negative value otherwise
3751  */
3752  int (*end_frame)(AVCodecContext *avctx);
3753 
3754  /**
3755  * Size of per-frame hardware accelerator private data.
3756  *
3757  * Private data is allocated with av_mallocz() before
3758  * AVCodecContext.get_buffer() and deallocated after
3759  * AVCodecContext.release_buffer().
3760  */
3762 
3763  /**
3764  * Called for every Macroblock in a slice.
3765  *
3766  * XvMC uses it to replace the ff_mpv_reconstruct_mb().
3767  * Instead of decoding to raw picture, MB parameters are
3768  * stored in an array provided by the video driver.
3769  *
3770  * @param s the mpeg context
3771  */
3772  void (*decode_mb)(struct MpegEncContext *s);
3773 
3774  /**
3775  * Initialize the hwaccel private data.
3776  *
3777  * This will be called from ff_get_format(), after hwaccel and
3778  * hwaccel_context are set and the hwaccel private data in AVCodecInternal
3779  * is allocated.
3780  */
3781  int (*init)(AVCodecContext *avctx);
3782 
3783  /**
3784  * Uninitialize the hwaccel private data.
3785  *
3786  * This will be called from get_format() or avcodec_close(), after hwaccel
3787  * and hwaccel_context are already uninitialized.
3788  */
3789  int (*uninit)(AVCodecContext *avctx);
3790 
3791  /**
3792  * Size of the private data to allocate in
3793  * AVCodecInternal.hwaccel_priv_data.
3794  */
3796 
3797  /**
3798  * Internal hwaccel capabilities.
3799  */
3801 
3802  /**
3803  * Fill the given hw_frames context with current codec parameters. Called
3804  * from get_format. Refer to avcodec_get_hw_frames_parameters() for
3805  * details.
3806  *
3807  * This CAN be called before AVHWAccel.init is called, and you must assume
3808  * that avctx->hwaccel_priv_data is invalid.
3809  */
3810  int (*frame_params)(AVCodecContext *avctx, AVBufferRef *hw_frames_ctx);
3811 } AVHWAccel;
3812 
3813 /**
3814  * HWAccel is experimental and is thus avoided in favor of non experimental
3815  * codecs
3816  */
3817 #define AV_HWACCEL_CODEC_CAP_EXPERIMENTAL 0x0200
3818 
3819 /**
3820  * Hardware acceleration should be used for decoding even if the codec level
3821  * used is unknown or higher than the maximum supported level reported by the
3822  * hardware driver.
3823  *
3824  * It's generally a good idea to pass this flag unless you have a specific
3825  * reason not to, as hardware tends to under-report supported levels.
3826  */
3827 #define AV_HWACCEL_FLAG_IGNORE_LEVEL (1 << 0)
3828 
3829 /**
3830  * Hardware acceleration can output YUV pixel formats with a different chroma
3831  * sampling than 4:2:0 and/or other than 8 bits per component.
3832  */
3833 #define AV_HWACCEL_FLAG_ALLOW_HIGH_DEPTH (1 << 1)
3834 
3835 /**
3836  * Hardware acceleration should still be attempted for decoding when the
3837  * codec profile does not match the reported capabilities of the hardware.
3838  *
3839  * For example, this can be used to try to decode baseline profile H.264
3840  * streams in hardware - it will often succeed, because many streams marked
3841  * as baseline profile actually conform to constrained baseline profile.
3842  *
3843  * @warning If the stream is actually not supported then the behaviour is
3844  * undefined, and may include returning entirely incorrect output
3845  * while indicating success.
3846  */
3847 #define AV_HWACCEL_FLAG_ALLOW_PROFILE_MISMATCH (1 << 2)
3848 
3849 /**
3850  * @}
3851  */
3852 
3853 #if FF_API_AVPICTURE
3854 /**
3855  * @defgroup lavc_picture AVPicture
3856  *
3857  * Functions for working with AVPicture
3858  * @{
3859  */
3860 
3861 /**
3862  * Picture data structure.
3863  *
3864  * Up to four components can be stored into it, the last component is
3865  * alpha.
3866  * @deprecated use AVFrame or imgutils functions instead
3867  */
3868 typedef struct AVPicture {
3870  uint8_t *data[AV_NUM_DATA_POINTERS]; ///< pointers to the image data planes
3872  int linesize[AV_NUM_DATA_POINTERS]; ///< number of bytes per line
3873 } AVPicture;
3874 
3875 /**
3876  * @}
3877  */
3878 #endif
3879 
3882 
3883  SUBTITLE_BITMAP, ///< A bitmap, pict will be set
3884 
3885  /**
3886  * Plain text, the text field must be set by the decoder and is
3887  * authoritative. ass and pict fields may contain approximations.
3888  */
3890 
3891  /**
3892  * Formatted text, the ass field must be set by the decoder and is
3893  * authoritative. pict and text fields may contain approximations.
3894  */
3896 };
3897 
3898 #define AV_SUBTITLE_FLAG_FORCED 0x00000001
3899 
3900 typedef struct AVSubtitleRect {
3901  int x; ///< top left corner of pict, undefined when pict is not set
3902  int y; ///< top left corner of pict, undefined when pict is not set
3903  int w; ///< width of pict, undefined when pict is not set
3904  int h; ///< height of pict, undefined when pict is not set
3905  int nb_colors; ///< number of colors in pict, undefined when pict is not set
3906 
3907 #if FF_API_AVPICTURE
3908  /**
3909  * @deprecated unused
3910  */
3913 #endif
3914  /**
3915  * data+linesize for the bitmap of this subtitle.
3916  * Can be set for text/ass as well once they are rendered.
3917  */
3918  uint8_t *data[4];
3919  int linesize[4];
3920 
3922 
3923  char *text; ///< 0 terminated plain UTF-8 text
3924 
3925  /**
3926  * 0 terminated ASS/SSA compatible event line.
3927  * The presentation of this is unaffected by the other values in this
3928  * struct.
3929  */
3930  char *ass;
3931 
3932  int flags;
3933 } AVSubtitleRect;
3934 
3935 typedef struct AVSubtitle {
3936  uint16_t format; /* 0 = graphics */
3937  uint32_t start_display_time; /* relative to packet pts, in ms */
3938  uint32_t end_display_time; /* relative to packet pts, in ms */
3939  unsigned num_rects;
3941  int64_t pts; ///< Same as packet pts, in AV_TIME_BASE
3942 } AVSubtitle;
3943 
3944 /**
3945  * This struct describes the properties of an encoded stream.
3946  *
3947  * sizeof(AVCodecParameters) is not a part of the public ABI, this struct must
3948  * be allocated with avcodec_parameters_alloc() and freed with
3949  * avcodec_parameters_free().
3950  */
3951 typedef struct AVCodecParameters {
3952  /**
3953  * General type of the encoded data.
3954  */
3956  /**
3957  * Specific type of the encoded data (the codec used).
3958  */
3960  /**
3961  * Additional information about the codec (corresponds to the AVI FOURCC).
3962  */
3963  uint32_t codec_tag;
3964 
3965  /**
3966  * Extra binary data needed for initializing the decoder, codec-dependent.
3967  *
3968  * Must be allocated with av_malloc() and will be freed by
3969  * avcodec_parameters_free(). The allocated size of extradata must be at
3970  * least extradata_size + AV_INPUT_BUFFER_PADDING_SIZE, with the padding
3971  * bytes zeroed.
3972  */
3973  uint8_t *extradata;
3974  /**
3975  * Size of the extradata content in bytes.
3976  */
3978 
3979  /**
3980  * - video: the pixel format, the value corresponds to enum AVPixelFormat.
3981  * - audio: the sample format, the value corresponds to enum AVSampleFormat.
3982  */
3983  int format;
3984 
3985  /**
3986  * The average bitrate of the encoded data (in bits per second).
3987  */
3988  int64_t bit_rate;
3989 
3990  /**
3991  * The number of bits per sample in the codedwords.
3992  *
3993  * This is basically the bitrate per sample. It is mandatory for a bunch of
3994  * formats to actually decode them. It's the number of bits for one sample in
3995  * the actual coded bitstream.
3996  *
3997  * This could be for example 4 for ADPCM
3998  * For PCM formats this matches bits_per_raw_sample
3999  * Can be 0
4000  */
4002 
4003  /**
4004  * This is the number of valid bits in each output sample. If the
4005  * sample format has more bits, the least significant bits are additional
4006  * padding bits, which are always 0. Use right shifts to reduce the sample
4007  * to its actual size. For example, audio formats with 24 bit samples will
4008  * have bits_per_raw_sample set to 24, and format set to AV_SAMPLE_FMT_S32.
4009  * To get the original sample use "(int32_t)sample >> 8"."
4010  *
4011  * For ADPCM this might be 12 or 16 or similar
4012  * Can be 0
4013  */
4015 
4016  /**
4017  * Codec-specific bitstream restrictions that the stream conforms to.
4018  */
4019  int profile;
4020  int level;
4021 
4022  /**
4023  * Video only. The dimensions of the video frame in pixels.
4024  */
4025  int width;
4026  int height;
4027 
4028  /**
4029  * Video only. The aspect ratio (width / height) which a single pixel
4030  * should have when displayed.
4031  *
4032  * When the aspect ratio is unknown / undefined, the numerator should be
4033  * set to 0 (the denominator may have any value).
4034  */
4036 
4037  /**
4038  * Video only. The order of the fields in interlaced video.
4039  */
4041 
4042  /**
4043  * Video only. Additional colorspace characteristics.
4044  */
4050 
4051  /**
4052  * Video only. Number of delayed frames.
4053  */
4055 
4056  /**
4057  * Audio only. The channel layout bitmask. May be 0 if the channel layout is
4058  * unknown or unspecified, otherwise the number of bits set must be equal to
4059  * the channels field.
4060  */
4061  uint64_t channel_layout;
4062  /**
4063  * Audio only. The number of audio channels.
4064  */
4066  /**
4067  * Audio only. The number of audio samples per second.
4068  */
4070  /**
4071  * Audio only. The number of bytes per coded audio frame, required by some
4072  * formats.
4073  *
4074  * Corresponds to nBlockAlign in WAVEFORMATEX.
4075  */
4077  /**
4078  * Audio only. Audio frame size, if known. Required by some formats to be static.
4079  */
4081 
4082  /**
4083  * Audio only. The amount of padding (in samples) inserted by the encoder at
4084  * the beginning of the audio. I.e. this number of leading decoded samples
4085  * must be discarded by the caller to get the original audio without leading
4086  * padding.
4087  */
4089  /**
4090  * Audio only. The amount of padding (in samples) appended by the encoder to
4091  * the end of the audio. I.e. this number of decoded samples must be
4092  * discarded by the caller from the end of the stream to get the original
4093  * audio without any trailing padding.
4094  */
4096  /**
4097  * Audio only. Number of samples to skip after a discontinuity.
4098  */
4101 
4102 /**
4103  * Iterate over all registered codecs.
4104  *
4105  * @param opaque a pointer where libavcodec will store the iteration state. Must
4106  * point to NULL to start the iteration.
4107  *
4108  * @return the next registered codec or NULL when the iteration is
4109  * finished
4110  */
4111 const AVCodec *av_codec_iterate(void **opaque);
4112 
4113 #if FF_API_NEXT
4114 /**
4115  * If c is NULL, returns the first registered codec,
4116  * if c is non-NULL, returns the next registered codec after c,
4117  * or NULL if c is the last one.
4118  */
4120 AVCodec *av_codec_next(const AVCodec *c);
4121 #endif
4122 
4123 /**
4124  * Return the LIBAVCODEC_VERSION_INT constant.
4125  */
4126 unsigned avcodec_version(void);
4127 
4128 /**
4129  * Return the libavcodec build-time configuration.
4130  */
4131 const char *avcodec_configuration(void);
4132 
4133 /**
4134  * Return the libavcodec license.
4135  */
4136 const char *avcodec_license(void);
4137 
4138 #if FF_API_NEXT
4139 /**
4140  * Register the codec codec and initialize libavcodec.
4141  *
4142  * @warning either this function or avcodec_register_all() must be called
4143  * before any other libavcodec functions.
4144  *
4145  * @see avcodec_register_all()
4146  */
4148 void avcodec_register(AVCodec *codec);
4149 
4150 /**
4151  * Register all the codecs, parsers and bitstream filters which were enabled at
4152  * configuration time. If you do not call this function you can select exactly
4153  * which formats you want to support, by using the individual registration
4154  * functions.
4155  *
4156  * @see avcodec_register
4157  * @see av_register_codec_parser
4158  * @see av_register_bitstream_filter
4159  */
4161 void avcodec_register_all(void);
4162 #endif
4163 
4164 /**
4165  * Allocate an AVCodecContext and set its fields to default values. The
4166  * resulting struct should be freed with avcodec_free_context().
4167  *
4168  * @param codec if non-NULL, allocate private data and initialize defaults
4169  * for the given codec. It is illegal to then call avcodec_open2()
4170  * with a different codec.
4171  * If NULL, then the codec-specific defaults won't be initialized,
4172  * which may result in suboptimal default settings (this is
4173  * important mainly for encoders, e.g. libx264).
4174  *
4175  * @return An AVCodecContext filled with default values or NULL on failure.
4176  */
4178 
4179 /**
4180  * Free the codec context and everything associated with it and write NULL to
4181  * the provided pointer.
4182  */
4183 void avcodec_free_context(AVCodecContext **avctx);
4184 
4185 #if FF_API_GET_CONTEXT_DEFAULTS
4186 /**
4187  * @deprecated This function should not be used, as closing and opening a codec
4188  * context multiple time is not supported. A new codec context should be
4189  * allocated for each new use.
4190  */
4192 #endif
4193 
4194 /**
4195  * Get the AVClass for AVCodecContext. It can be used in combination with
4196  * AV_OPT_SEARCH_FAKE_OBJ for examining options.
4197  *
4198  * @see av_opt_find().
4199  */
4200 const AVClass *avcodec_get_class(void);
4201 
4202 #if FF_API_COPY_CONTEXT
4203 /**
4204  * Get the AVClass for AVFrame. It can be used in combination with
4205  * AV_OPT_SEARCH_FAKE_OBJ for examining options.
4206  *
4207  * @see av_opt_find().
4208  */
4209 const AVClass *avcodec_get_frame_class(void);
4210 
4211 /**
4212  * Get the AVClass for AVSubtitleRect. It can be used in combination with
4213  * AV_OPT_SEARCH_FAKE_OBJ for examining options.
4214  *
4215  * @see av_opt_find().
4216  */
4218 
4219 /**
4220  * Copy the settings of the source AVCodecContext into the destination
4221  * AVCodecContext. The resulting destination codec context will be
4222  * unopened, i.e. you are required to call avcodec_open2() before you
4223  * can use this AVCodecContext to decode/encode video/audio data.
4224  *
4225  * @param dest target codec context, should be initialized with
4226  * avcodec_alloc_context3(NULL), but otherwise uninitialized
4227  * @param src source codec context
4228  * @return AVERROR() on error (e.g. memory allocation error), 0 on success
4229  *
4230  * @deprecated The semantics of this function are ill-defined and it should not
4231  * be used. If you need to transfer the stream parameters from one codec context
4232  * to another, use an intermediate AVCodecParameters instance and the
4233  * avcodec_parameters_from_context() / avcodec_parameters_to_context()
4234  * functions.
4235  */
4237 int avcodec_copy_context(AVCodecContext *dest, const AVCodecContext *src);
4238 #endif
4239 
4240 /**
4241  * Allocate a new AVCodecParameters and set its fields to default values
4242  * (unknown/invalid/0). The returned struct must be freed with
4243  * avcodec_parameters_free().
4244  */
4246 
4247 /**
4248  * Free an AVCodecParameters instance and everything associated with it and
4249  * write NULL to the supplied pointer.
4250  */
4252 
4253 /**
4254  * Copy the contents of src to dst. Any allocated fields in dst are freed and
4255  * replaced with newly allocated duplicates of the corresponding fields in src.
4256  *
4257  * @return >= 0 on success, a negative AVERROR code on failure.
4258  */
4260 
4261 /**
4262  * Fill the parameters struct based on the values from the supplied codec
4263  * context. Any allocated fields in par are freed and replaced with duplicates
4264  * of the corresponding fields in codec.
4265  *
4266  * @return >= 0 on success, a negative AVERROR code on failure
4267  */
4269  const AVCodecContext *codec);
4270 
4271 /**
4272  * Fill the codec context based on the values from the supplied codec
4273  * parameters. Any allocated fields in codec that have a corresponding field in
4274  * par are freed and replaced with duplicates of the corresponding field in par.
4275  * Fields in codec that do not have a counterpart in par are not touched.
4276  *
4277  * @return >= 0 on success, a negative AVERROR code on failure.
4278  */
4280  const AVCodecParameters *par);
4281 
4282 /**
4283  * Initialize the AVCodecContext to use the given AVCodec. Prior to using this
4284  * function the context has to be allocated with avcodec_alloc_context3().
4285  *
4286  * The functions avcodec_find_decoder_by_name(), avcodec_find_encoder_by_name(),
4287  * avcodec_find_decoder() and avcodec_find_encoder() provide an easy way for
4288  * retrieving a codec.
4289  *
4290  * @warning This function is not thread safe!
4291  *
4292  * @note Always call this function before using decoding routines (such as
4293  * @ref avcodec_receive_frame()).
4294  *
4295  * @code
4296  * avcodec_register_all();
4297  * av_dict_set(&opts, "b", "2.5M", 0);
4298  * codec = avcodec_find_decoder(AV_CODEC_ID_H264);
4299  * if (!codec)
4300  * exit(1);
4301  *
4302  * context = avcodec_alloc_context3(codec);
4303  *
4304  * if (avcodec_open2(context, codec, opts) < 0)
4305  * exit(1);
4306  * @endcode
4307  *
4308  * @param avctx The context to initialize.
4309  * @param codec The codec to open this context for. If a non-NULL codec has been
4310  * previously passed to avcodec_alloc_context3() or
4311  * for this context, then this parameter MUST be either NULL or
4312  * equal to the previously passed codec.
4313  * @param options A dictionary filled with AVCodecContext and codec-private options.
4314  * On return this object will be filled with options that were not found.
4315  *
4316  * @return zero on success, a negative value on error
4317  * @see avcodec_alloc_context3(), avcodec_find_decoder(), avcodec_find_encoder(),
4318  * av_dict_set(), av_opt_find().
4319  */
4320 int avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options);
4321 
4322 /**
4323  * Close a given AVCodecContext and free all the data associated with it
4324  * (but not the AVCodecContext itself).
4325  *
4326  * Calling this function on an AVCodecContext that hasn't been opened will free
4327  * the codec-specific data allocated in avcodec_alloc_context3() with a non-NULL
4328  * codec. Subsequent calls will do nothing.
4329  *
4330  * @note Do not use this function. Use avcodec_free_context() to destroy a
4331  * codec context (either open or closed). Opening and closing a codec context
4332  * multiple times is not supported anymore -- use multiple codec contexts
4333  * instead.
4334  */
4335 int avcodec_close(AVCodecContext *avctx);
4336 
4337 /**
4338  * Free all allocated data in the given subtitle struct.
4339  *
4340  * @param sub AVSubtitle to free.
4341  */
4342 void avsubtitle_free(AVSubtitle *sub);
4343 
4344 /**
4345  * @}
4346  */
4347 
4348 /**
4349  * @addtogroup lavc_packet
4350  * @{
4351  */
4352 
4353 /**
4354  * Allocate an AVPacket and set its fields to default values. The resulting
4355  * struct must be freed using av_packet_free().
4356  *
4357  * @return An AVPacket filled with default values or NULL on failure.
4358  *
4359  * @note this only allocates the AVPacket itself, not the data buffers. Those
4360  * must be allocated through other means such as av_new_packet.
4361  *
4362  * @see av_new_packet
4363  */
4364 AVPacket *av_packet_alloc(void);
4365 
4366 /**
4367  * Create a new packet that references the same data as src.
4368  *
4369  * This is a shortcut for av_packet_alloc()+av_packet_ref().
4370  *
4371  * @return newly created AVPacket on success, NULL on error.
4372  *
4373  * @see av_packet_alloc
4374  * @see av_packet_ref
4375  */
4376 AVPacket *av_packet_clone(const AVPacket *src);
4377 
4378 /**
4379  * Free the packet, if the packet is reference counted, it will be
4380  * unreferenced first.
4381  *
4382  * @param pkt packet to be freed. The pointer will be set to NULL.
4383  * @note passing NULL is a no-op.
4384  */
4385 void av_packet_free(AVPacket **pkt);
4386 
4387 /**
4388  * Initialize optional fields of a packet with default values.
4389  *
4390  * Note, this does not touch the data and size members, which have to be
4391  * initialized separately.
4392  *
4393  * @param pkt packet
4394  */
4395 void av_init_packet(AVPacket *pkt);
4396 
4397 /**
4398  * Allocate the payload of a packet and initialize its fields with
4399  * default values.
4400  *
4401  * @param pkt packet
4402  * @param size wanted payload size
4403  * @return 0 if OK, AVERROR_xxx otherwise
4404  */
4405 int av_new_packet(AVPacket *pkt, int size);
4406 
4407 /**
4408  * Reduce packet size, correctly zeroing padding
4409  *
4410  * @param pkt packet
4411  * @param size new size
4412  */
4413 void av_shrink_packet(AVPacket *pkt, int size);
4414 
4415 /**
4416  * Increase packet size, correctly zeroing padding
4417  *
4418  * @param pkt packet
4419  * @param grow_by number of bytes by which to increase the size of the packet
4420  */
4421 int av_grow_packet(AVPacket *pkt, int grow_by);
4422 
4423 /**
4424  * Initialize a reference-counted packet from av_malloc()ed data.
4425  *
4426  * @param pkt packet to be initialized. This function will set the data, size,
4427  * and buf fields, all others are left untouched.
4428  * @param data Data allocated by av_malloc() to be used as packet data. If this
4429  * function returns successfully, the data is owned by the underlying AVBuffer.
4430  * The caller may not access the data through other means.
4431  * @param size size of data in bytes, without the padding. I.e. the full buffer
4432  * size is assumed to be size + AV_INPUT_BUFFER_PADDING_SIZE.
4433  *
4434  * @return 0 on success, a negative AVERROR on error
4435  */
4436 int av_packet_from_data(AVPacket *pkt, uint8_t *data, int size);
4437 
4438 #if FF_API_AVPACKET_OLD_API
4439 /**
4440  * @warning This is a hack - the packet memory allocation stuff is broken. The
4441  * packet is allocated if it was not really allocated.
4442  *
4443  * @deprecated Use av_packet_ref or av_packet_make_refcounted
4444  */
4446 int av_dup_packet(AVPacket *pkt);
4447 /**
4448  * Copy packet, including contents
4449  *
4450  * @return 0 on success, negative AVERROR on fail
4451  *
4452  * @deprecated Use av_packet_ref
4453  */
4455 int av_copy_packet(AVPacket *dst, const AVPacket *src);
4456 
4457 /**
4458  * Copy packet side data
4459  *
4460  * @return 0 on success, negative AVERROR on fail
4461  *
4462  * @deprecated Use av_packet_copy_props
4463  */
4465 int av_copy_packet_side_data(AVPacket *dst, const AVPacket *src);
4466 
4467 /**
4468  * Free a packet.
4469  *
4470  * @deprecated Use av_packet_unref
4471  *
4472  * @param pkt packet to free
4473  */
4475 void av_free_packet(AVPacket *pkt);
4476 #endif
4477 /**
4478  * Allocate new information of a packet.
4479  *
4480  * @param pkt packet
4481  * @param type side information type
4482  * @param size side information size
4483  * @return pointer to fresh allocated data or NULL otherwise
4484  */
4486  int size);
4487 
4488 /**
4489  * Wrap an existing array as a packet side data.
4490  *
4491  * @param pkt packet
4492  * @param type side information type
4493  * @param data the side data array. It must be allocated with the av_malloc()
4494  * family of functions. The ownership of the data is transferred to
4495  * pkt.
4496  * @param size side information size
4497  * @return a non-negative number on success, a negative AVERROR code on
4498  * failure. On failure, the packet is unchanged and the data remains
4499  * owned by the caller.
4500  */
4502  uint8_t *data, size_t size);
4503 
4504 /**
4505  * Shrink the already allocated side data buffer
4506  *
4507  * @param pkt packet
4508  * @param type side information type
4509  * @param size new side information size
4510  * @return 0 on success, < 0 on failure
4511  */
4513  int size);
4514 
4515 /**
4516  * Get side information from packet.
4517  *
4518  * @param pkt packet
4519  * @param type desired side information type
4520  * @param size pointer for side information size to store (optional)
4521  * @return pointer to data if present or NULL otherwise
4522  */
4523 uint8_t* av_packet_get_side_data(const AVPacket *pkt, enum AVPacketSideDataType type,
4524  int *size);
4525 
4526 #if FF_API_MERGE_SD_API
4529 
4532 #endif
4533 
4534 const char *av_packet_side_data_name(enum AVPacketSideDataType type);
4535 
4536 /**
4537  * Pack a dictionary for use in side_data.
4538  *
4539  * @param dict The dictionary to pack.
4540  * @param size pointer to store the size of the returned data
4541  * @return pointer to data if successful, NULL otherwise
4542  */
4543 uint8_t *av_packet_pack_dictionary(AVDictionary *dict, int *size);
4544 /**
4545  * Unpack a dictionary from side_data.
4546  *
4547  * @param data data from side_data
4548  * @param size size of the data
4549  * @param dict the metadata storage dictionary
4550  * @return 0 on success, < 0 on failure
4551  */
4552 int av_packet_unpack_dictionary(const uint8_t *data, int size, AVDictionary **dict);
4553 
4554 
4555 /**
4556  * Convenience function to free all the side data stored.
4557  * All the other fields stay untouched.
4558  *
4559  * @param pkt packet
4560  */
4562 
4563 /**
4564  * Setup a new reference to the data described by a given packet
4565  *
4566  * If src is reference-counted, setup dst as a new reference to the
4567  * buffer in src. Otherwise allocate a new buffer in dst and copy the
4568  * data from src into it.
4569  *
4570  * All the other fields are copied from src.
4571  *
4572  * @see av_packet_unref
4573  *
4574  * @param dst Destination packet
4575  * @param src Source packet
4576  *
4577  * @return 0 on success, a negative AVERROR on error.
4578  */
4579 int av_packet_ref(AVPacket *dst, const AVPacket *src);
4580 
4581 /**
4582  * Wipe the packet.
4583  *
4584  * Unreference the buffer referenced by the packet and reset the
4585  * remaining packet fields to their default values.
4586  *
4587  * @param pkt The packet to be unreferenced.
4588  */
4590 
4591 /**
4592  * Move every field in src to dst and reset src.
4593  *
4594  * @see av_packet_unref
4595  *
4596  * @param src Source packet, will be reset
4597  * @param dst Destination packet
4598  */
4599 void av_packet_move_ref(AVPacket *dst, AVPacket *src);
4600 
4601 /**
4602  * Copy only "properties" fields from src to dst.
4603  *
4604  * Properties for the purpose of this function are all the fields
4605  * beside those related to the packet data (buf, data, size)
4606  *
4607  * @param dst Destination packet
4608  * @param src Source packet
4609  *
4610  * @return 0 on success AVERROR on failure.
4611  */
4612 int av_packet_copy_props(AVPacket *dst, const AVPacket *src);
4613 
4614 /**
4615  * Ensure the data described by a given packet is reference counted.
4616  *
4617  * @note This function does not ensure that the reference will be writable.
4618  * Use av_packet_make_writable instead for that purpose.
4619  *
4620  * @see av_packet_ref
4621  * @see av_packet_make_writable
4622  *
4623  * @param pkt packet whose data should be made reference counted.
4624  *
4625  * @return 0 on success, a negative AVERROR on error. On failure, the
4626  * packet is unchanged.
4627  */
4629 
4630 /**
4631  * Create a writable reference for the data described by a given packet,
4632  * avoiding data copy if possible.
4633  *
4634  * @param pkt Packet whose data should be made writable.
4635  *
4636  * @return 0 on success, a negative AVERROR on failure. On failure, the
4637  * packet is unchanged.
4638  */
4640 
4641 /**
4642  * Convert valid timing fields (timestamps / durations) in a packet from one
4643  * timebase to another. Timestamps with unknown values (AV_NOPTS_VALUE) will be
4644  * ignored.
4645  *
4646  * @param pkt packet on which the conversion will be performed
4647  * @param tb_src source timebase, in which the timing fields in pkt are
4648  * expressed
4649  * @param tb_dst destination timebase, to which the timing fields will be
4650  * converted
4651  */
4652 void av_packet_rescale_ts(AVPacket *pkt, AVRational tb_src, AVRational tb_dst);
4653 
4654 /**
4655  * @}
4656  */
4657 
4658 /**
4659  * @addtogroup lavc_decoding
4660  * @{
4661  */
4662 
4663 /**
4664  * Find a registered decoder with a matching codec ID.
4665  *
4666  * @param id AVCodecID of the requested decoder
4667  * @return A decoder if one was found, NULL otherwise.
4668  */
4670 
4671 /**
4672  * Find a registered decoder with the specified name.
4673  *
4674  * @param name name of the requested decoder
4675  * @return A decoder if one was found, NULL otherwise.
4676  */
4677 AVCodec *avcodec_find_decoder_by_name(const char *name);
4678 
4679 /**
4680  * The default callback for AVCodecContext.get_buffer2(). It is made public so
4681  * it can be called by custom get_buffer2() implementations for decoders without
4682  * AV_CODEC_CAP_DR1 set.
4683  */
4685 
4686 /**
4687  * Modify width and height values so that they will result in a memory
4688  * buffer that is acceptable for the codec if you do not use any horizontal
4689  * padding.
4690  *
4691  * May only be used if a codec with AV_CODEC_CAP_DR1 has been opened.
4692  */
4694 
4695 /**
4696  * Modify width and height values so that they will result in a memory
4697  * buffer that is acceptable for the codec if you also ensure that all
4698  * line sizes are a multiple of the respective linesize_align[i].
4699  *
4700  * May only be used if a codec with AV_CODEC_CAP_DR1 has been opened.
4701  */
4703  int linesize_align[AV_NUM_DATA_POINTERS]);
4704 
4705 /**
4706  * Converts AVChromaLocation to swscale x/y chroma position.
4707  *
4708  * The positions represent the chroma (0,0) position in a coordinates system
4709  * with luma (0,0) representing the origin and luma(1,1) representing 256,256
4710  *
4711  * @param xpos horizontal chroma sample position
4712  * @param ypos vertical chroma sample position
4713  */
4714 int avcodec_enum_to_chroma_pos(int *xpos, int *ypos, enum AVChromaLocation pos);
4715 
4716 /**
4717  * Converts swscale x/y chroma position to AVChromaLocation.
4718  *
4719  * The positions represent the chroma (0,0) position in a coordinates system
4720  * with luma (0,0) representing the origin and luma(1,1) representing 256,256
4721  *
4722  * @param xpos horizontal chroma sample position
4723  * @param ypos vertical chroma sample position
4724  */
4725 enum AVChromaLocation avcodec_chroma_pos_to_enum(int xpos, int ypos);
4726 
4727 /**
4728  * Decode the audio frame of size avpkt->size from avpkt->data into frame.
4729  *
4730  * Some decoders may support multiple frames in a single AVPacket. Such
4731  * decoders would then just decode the first frame and the return value would be
4732  * less than the packet size. In this case, avcodec_decode_audio4 has to be
4733  * called again with an AVPacket containing the remaining data in order to
4734  * decode the second frame, etc... Even if no frames are returned, the packet
4735  * needs to be fed to the decoder with remaining data until it is completely
4736  * consumed or an error occurs.
4737  *
4738  * Some decoders (those marked with AV_CODEC_CAP_DELAY) have a delay between input
4739  * and output. This means that for some packets they will not immediately
4740  * produce decoded output and need to be flushed at the end of decoding to get
4741  * all the decoded data. Flushing is done by calling this function with packets
4742  * with avpkt->data set to NULL and avpkt->size set to 0 until it stops
4743  * returning samples. It is safe to flush even those decoders that are not
4744  * marked with AV_CODEC_CAP_DELAY, then no samples will be returned.
4745  *
4746  * @warning The input buffer, avpkt->data must be AV_INPUT_BUFFER_PADDING_SIZE
4747  * larger than the actual read bytes because some optimized bitstream
4748  * readers read 32 or 64 bits at once and could read over the end.
4749  *
4750  * @note The AVCodecContext MUST have been opened with @ref avcodec_open2()
4751  * before packets may be fed to the decoder.
4752  *
4753  * @param avctx the codec context
4754  * @param[out] frame The AVFrame in which to store decoded audio samples.
4755  * The decoder will allocate a buffer for the decoded frame by
4756  * calling the AVCodecContext.get_buffer2() callback.
4757  * When AVCodecContext.refcounted_frames is set to 1, the frame is
4758  * reference counted and the returned reference belongs to the
4759  * caller. The caller must release the frame using av_frame_unref()
4760  * when the frame is no longer needed. The caller may safely write
4761  * to the frame if av_frame_is_writable() returns 1.
4762  * When AVCodecContext.refcounted_frames is set to 0, the returned
4763  * reference belongs to the decoder and is valid only until the
4764  * next call to this function or until closing or flushing the
4765  * decoder. The caller may not write to it.
4766  * @param[out] got_frame_ptr Zero if no frame could be decoded, otherwise it is
4767  * non-zero. Note that this field being set to zero
4768  * does not mean that an error has occurred. For
4769  * decoders with AV_CODEC_CAP_DELAY set, no given decode
4770  * call is guaranteed to produce a frame.
4771  * @param[in] avpkt The input AVPacket containing the input buffer.
4772  * At least avpkt->data and avpkt->size should be set. Some
4773  * decoders might also require additional fields to be set.
4774  * @return A negative error code is returned if an error occurred during
4775  * decoding, otherwise the number of bytes consumed from the input
4776  * AVPacket is returned.
4777  *
4778 * @deprecated Use avcodec_send_packet() and avcodec_receive_frame().
4779  */
4782  int *got_frame_ptr, const AVPacket *avpkt);
4783 
4784 /**
4785  * Decode the video frame of size avpkt->size from avpkt->data into picture.
4786  * Some decoders may support multiple frames in a single AVPacket, such
4787  * decoders would then just decode the first frame.
4788  *
4789  * @warning The input buffer must be AV_INPUT_BUFFER_PADDING_SIZE larger than
4790  * the actual read bytes because some optimized bitstream readers read 32 or 64
4791  * bits at once and could read over the end.
4792  *
4793  * @warning The end of the input buffer buf should be set to 0 to ensure that
4794  * no overreading happens for damaged MPEG streams.
4795  *
4796  * @note Codecs which have the AV_CODEC_CAP_DELAY capability set have a delay
4797  * between input and output, these need to be fed with avpkt->data=NULL,
4798  * avpkt->size=0 at the end to return the remaining frames.
4799  *
4800  * @note The AVCodecContext MUST have been opened with @ref avcodec_open2()
4801  * before packets may be fed to the decoder.
4802  *
4803  * @param avctx the codec context
4804  * @param[out] picture The AVFrame in which the decoded video frame will be stored.
4805  * Use av_frame_alloc() to get an AVFrame. The codec will
4806  * allocate memory for the actual bitmap by calling the
4807  * AVCodecContext.get_buffer2() callback.
4808  * When AVCodecContext.refcounted_frames is set to 1, the frame is
4809  * reference counted and the returned reference belongs to the
4810  * caller. The caller must release the frame using av_frame_unref()
4811  * when the frame is no longer needed. The caller may safely write
4812  * to the frame if av_frame_is_writable() returns 1.
4813  * When AVCodecContext.refcounted_frames is set to 0, the returned
4814  * reference belongs to the decoder and is valid only until the
4815  * next call to this function or until closing or flushing the
4816  * decoder. The caller may not write to it.
4817  *
4818  * @param[in] avpkt The input AVPacket containing the input buffer.
4819  * You can create such packet with av_init_packet() and by then setting
4820  * data and size, some decoders might in addition need other fields like
4821  * flags&AV_PKT_FLAG_KEY. All decoders are designed to use the least
4822  * fields possible.
4823  * @param[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
4824  * @return On error a negative value is returned, otherwise the number of bytes
4825  * used or zero if no frame could be decompressed.
4826  *
4827  * @deprecated Use avcodec_send_packet() and avcodec_receive_frame().
4828  */
4830 int avcodec_decode_video2(AVCodecContext *avctx, AVFrame *picture,
4831  int *got_picture_ptr,
4832  const AVPacket *avpkt);
4833 
4834 /**
4835  * Decode a subtitle message.
4836  * Return a negative value on error, otherwise return the number of bytes used.
4837  * If no subtitle could be decompressed, got_sub_ptr is zero.
4838  * Otherwise, the subtitle is stored in *sub.
4839  * Note that AV_CODEC_CAP_DR1 is not available for subtitle codecs. This is for
4840  * simplicity, because the performance difference is expect to be negligible
4841  * and reusing a get_buffer written for video codecs would probably perform badly
4842  * due to a potentially very different allocation pattern.
4843  *
4844  * Some decoders (those marked with AV_CODEC_CAP_DELAY) have a delay between input
4845  * and output. This means that for some packets they will not immediately
4846  * produce decoded output and need to be flushed at the end of decoding to get
4847  * all the decoded data. Flushing is done by calling this function with packets
4848  * with avpkt->data set to NULL and avpkt->size set to 0 until it stops
4849  * returning subtitles. It is safe to flush even those decoders that are not
4850  * marked with AV_CODEC_CAP_DELAY, then no subtitles will be returned.
4851  *
4852  * @note The AVCodecContext MUST have been opened with @ref avcodec_open2()
4853  * before packets may be fed to the decoder.
4854  *
4855  * @param avctx the codec context
4856  * @param[out] sub The Preallocated AVSubtitle in which the decoded subtitle will be stored,
4857  * must be freed with avsubtitle_free if *got_sub_ptr is set.
4858  * @param[in,out] got_sub_ptr Zero if no subtitle could be decompressed, otherwise, it is nonzero.
4859  * @param[in] avpkt The input AVPacket containing the input buffer.
4860  */
4862  int *got_sub_ptr,
4863  AVPacket *avpkt);
4864 
4865 /**
4866  * Supply raw packet data as input to a decoder.
4867  *
4868  * Internally, this call will copy relevant AVCodecContext fields, which can
4869  * influence decoding per-packet, and apply them when the packet is actually
4870  * decoded. (For example AVCodecContext.skip_frame, which might direct the
4871  * decoder to drop the frame contained by the packet sent with this function.)
4872  *
4873  * @warning The input buffer, avpkt->data must be AV_INPUT_BUFFER_PADDING_SIZE
4874  * larger than the actual read bytes because some optimized bitstream
4875  * readers read 32 or 64 bits at once and could read over the end.
4876  *
4877  * @warning Do not mix this API with the legacy API (like avcodec_decode_video2())
4878  * on the same AVCodecContext. It will return unexpected results now
4879  * or in future libavcodec versions.
4880  *
4881  * @note The AVCodecContext MUST have been opened with @ref avcodec_open2()
4882  * before packets may be fed to the decoder.
4883  *
4884  * @param avctx codec context
4885  * @param[in] avpkt The input AVPacket. Usually, this will be a single video
4886  * frame, or several complete audio frames.
4887  * Ownership of the packet remains with the caller, and the
4888  * decoder will not write to the packet. The decoder may create
4889  * a reference to the packet data (or copy it if the packet is
4890  * not reference-counted).
4891  * Unlike with older APIs, the packet is always fully consumed,
4892  * and if it contains multiple frames (e.g. some audio codecs),
4893  * will require you to call avcodec_receive_frame() multiple
4894  * times afterwards before you can send a new packet.
4895  * It can be NULL (or an AVPacket with data set to NULL and
4896  * size set to 0); in this case, it is considered a flush
4897  * packet, which signals the end of the stream. Sending the
4898  * first flush packet will return success. Subsequent ones are
4899  * unnecessary and will return AVERROR_EOF. If the decoder
4900  * still has frames buffered, it will return them after sending
4901  * a flush packet.
4902  *
4903  * @return 0 on success, otherwise negative error code:
4904  * AVERROR(EAGAIN): input is not accepted in the current state - user
4905  * must read output with avcodec_receive_frame() (once
4906  * all output is read, the packet should be resent, and
4907  * the call will not fail with EAGAIN).
4908  * AVERROR_EOF: the decoder has been flushed, and no new packets can
4909  * be sent to it (also returned if more than 1 flush
4910  * packet is sent)
4911  * AVERROR(EINVAL): codec not opened, it is an encoder, or requires flush
4912  * AVERROR(ENOMEM): failed to add packet to internal queue, or similar
4913  * other errors: legitimate decoding errors
4914  */
4915 int avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt);
4916 
4917 /**
4918  * Return decoded output data from a decoder.
4919  *
4920  * @param avctx codec context
4921  * @param frame This will be set to a reference-counted video or audio
4922  * frame (depending on the decoder type) allocated by the
4923  * decoder. Note that the function will always call
4924  * av_frame_unref(frame) before doing anything else.
4925  *
4926  * @return
4927  * 0: success, a frame was returned
4928  * AVERROR(EAGAIN): output is not available in this state - user must try
4929  * to send new input
4930  * AVERROR_EOF: the decoder has been fully flushed, and there will be
4931  * no more output frames
4932  * AVERROR(EINVAL): codec not opened, or it is an encoder
4933  * AVERROR_INPUT_CHANGED: current decoded frame has changed parameters
4934  * with respect to first decoded frame. Applicable
4935  * when flag AV_CODEC_FLAG_DROPCHANGED is set.
4936  * other negative values: legitimate decoding errors
4937  */
4939 
4940 /**
4941  * Supply a raw video or audio frame to the encoder. Use avcodec_receive_packet()
4942  * to retrieve buffered output packets.
4943  *
4944  * @param avctx codec context
4945  * @param[in] frame AVFrame containing the raw audio or video frame to be encoded.
4946  * Ownership of the frame remains with the caller, and the
4947  * encoder will not write to the frame. The encoder may create
4948  * a reference to the frame data (or copy it if the frame is
4949  * not reference-counted).
4950  * It can be NULL, in which case it is considered a flush
4951  * packet. This signals the end of the stream. If the encoder
4952  * still has packets buffered, it will return them after this
4953  * call. Once flushing mode has been entered, additional flush
4954  * packets are ignored, and sending frames will return
4955  * AVERROR_EOF.
4956  *
4957  * For audio:
4958  * If AV_CODEC_CAP_VARIABLE_FRAME_SIZE is set, then each frame
4959  * can have any number of samples.
4960  * If it is not set, frame->nb_samples must be equal to
4961  * avctx->frame_size for all frames except the last.
4962  * The final frame may be smaller than avctx->frame_size.
4963  * @return 0 on success, otherwise negative error code:
4964  * AVERROR(EAGAIN): input is not accepted in the current state - user
4965  * must read output with avcodec_receive_packet() (once
4966  * all output is read, the packet should be resent, and
4967  * the call will not fail with EAGAIN).
4968  * AVERROR_EOF: the encoder has been flushed, and no new frames can
4969  * be sent to it
4970  * AVERROR(EINVAL): codec not opened, refcounted_frames not set, it is a
4971  * decoder, or requires flush
4972  * AVERROR(ENOMEM): failed to add packet to internal queue, or similar
4973  * other errors: legitimate decoding errors
4974  */
4975 int avcodec_send_frame(AVCodecContext *avctx, const AVFrame *frame);
4976 
4977 /**
4978  * Read encoded data from the encoder.
4979  *
4980  * @param avctx codec context
4981  * @param avpkt This will be set to a reference-counted packet allocated by the
4982  * encoder. Note that the function will always call
4983  * av_frame_unref(frame) before doing anything else.
4984  * @return 0 on success, otherwise negative error code:
4985  * AVERROR(EAGAIN): output is not available in the current state - user
4986  * must try to send input
4987  * AVERROR_EOF: the encoder has been fully flushed, and there will be
4988  * no more output packets
4989  * AVERROR(EINVAL): codec not opened, or it is an encoder
4990  * other errors: legitimate decoding errors
4991  */
4992 int avcodec_receive_packet(AVCodecContext *avctx, AVPacket *avpkt);
4993 
4994 /**
4995  * Create and return a AVHWFramesContext with values adequate for hardware
4996  * decoding. This is meant to get called from the get_format callback, and is
4997  * a helper for preparing a AVHWFramesContext for AVCodecContext.hw_frames_ctx.
4998  * This API is for decoding with certain hardware acceleration modes/APIs only.
4999  *
5000  * The returned AVHWFramesContext is not initialized. The caller must do this
5001  * with av_hwframe_ctx_init().
5002  *
5003  * Calling this function is not a requirement, but makes it simpler to avoid
5004  * codec or hardware API specific details when manually allocating frames.
5005  *
5006  * Alternatively to this, an API user can set AVCodecContext.hw_device_ctx,
5007  * which sets up AVCodecContext.hw_frames_ctx fully automatically, and makes
5008  * it unnecessary to call this function or having to care about
5009  * AVHWFramesContext initialization at all.
5010  *
5011  * There are a number of requirements for calling this function:
5012  *
5013  * - It must be called from get_format with the same avctx parameter that was
5014  * passed to get_format. Calling it outside of get_format is not allowed, and
5015  * can trigger undefined behavior.
5016  * - The function is not always supported (see description of return values).
5017  * Even if this function returns successfully, hwaccel initialization could
5018  * fail later. (The degree to which implementations check whether the stream
5019  * is actually supported varies. Some do this check only after the user's
5020  * get_format callback returns.)
5021  * - The hw_pix_fmt must be one of the choices suggested by get_format. If the
5022  * user decides to use a AVHWFramesContext prepared with this API function,
5023  * the user must return the same hw_pix_fmt from get_format.
5024  * - The device_ref passed to this function must support the given hw_pix_fmt.
5025  * - After calling this API function, it is the user's responsibility to
5026  * initialize the AVHWFramesContext (returned by the out_frames_ref parameter),
5027  * and to set AVCodecContext.hw_frames_ctx to it. If done, this must be done
5028  * before returning from get_format (this is implied by the normal
5029  * AVCodecContext.hw_frames_ctx API rules).
5030  * - The AVHWFramesContext parameters may change every time time get_format is
5031  * called. Also, AVCodecContext.hw_frames_ctx is reset before get_format. So
5032  * you are inherently required to go through this process again on every
5033  * get_format call.
5034  * - It is perfectly possible to call this function without actually using
5035  * the resulting AVHWFramesContext. One use-case might be trying to reuse a
5036  * previously initialized AVHWFramesContext, and calling this API function
5037  * only to test whether the required frame parameters have changed.
5038  * - Fields that use dynamically allocated values of any kind must not be set
5039  * by the user unless setting them is explicitly allowed by the documentation.
5040  * If the user sets AVHWFramesContext.free and AVHWFramesContext.user_opaque,
5041  * the new free callback must call the potentially set previous free callback.
5042  * This API call may set any dynamically allocated fields, including the free
5043  * callback.
5044  *
5045  * The function will set at least the following fields on AVHWFramesContext
5046  * (potentially more, depending on hwaccel API):
5047  *
5048  * - All fields set by av_hwframe_ctx_alloc().
5049  * - Set the format field to hw_pix_fmt.
5050  * - Set the sw_format field to the most suited and most versatile format. (An
5051  * implication is that this will prefer generic formats over opaque formats
5052  * with arbitrary restrictions, if possible.)
5053  * - Set the width/height fields to the coded frame size, rounded up to the
5054  * API-specific minimum alignment.
5055  * - Only _if_ the hwaccel requires a pre-allocated pool: set the initial_pool_size
5056  * field to the number of maximum reference surfaces possible with the codec,
5057  * plus 1 surface for the user to work (meaning the user can safely reference
5058  * at most 1 decoded surface at a time), plus additional buffering introduced
5059  * by frame threading. If the hwaccel does not require pre-allocation, the
5060  * field is left to 0, and the decoder will allocate new surfaces on demand
5061  * during decoding.
5062  * - Possibly AVHWFramesContext.hwctx fields, depending on the underlying
5063  * hardware API.
5064  *
5065  * Essentially, out_frames_ref returns the same as av_hwframe_ctx_alloc(), but
5066  * with basic frame parameters set.
5067  *
5068  * The function is stateless, and does not change the AVCodecContext or the
5069  * device_ref AVHWDeviceContext.
5070  *
5071  * @param avctx The context which is currently calling get_format, and which
5072  * implicitly contains all state needed for filling the returned
5073  * AVHWFramesContext properly.
5074  * @param device_ref A reference to the AVHWDeviceContext describing the device
5075  * which will be used by the hardware decoder.
5076  * @param hw_pix_fmt The hwaccel format you are going to return from get_format.
5077  * @param out_frames_ref On success, set to a reference to an _uninitialized_
5078  * AVHWFramesContext, created from the given device_ref.
5079  * Fields will be set to values required for decoding.
5080  * Not changed if an error is returned.
5081  * @return zero on success, a negative value on error. The following error codes
5082  * have special semantics:
5083  * AVERROR(ENOENT): the decoder does not support this functionality. Setup
5084  * is always manual, or it is a decoder which does not
5085  * support setting AVCodecContext.hw_frames_ctx at all,
5086  * or it is a software format.
5087  * AVERROR(EINVAL): it is known that hardware decoding is not supported for
5088  * this configuration, or the device_ref is not supported
5089  * for the hwaccel referenced by hw_pix_fmt.
5090  */
5092  AVBufferRef *device_ref,
5094  AVBufferRef **out_frames_ref);
5095 
5096 
5097 
5098 /**
5099  * @defgroup lavc_parsing Frame parsing
5100  * @{
5101  */
5102 
5105  AV_PICTURE_STRUCTURE_TOP_FIELD, //< coded as top field
5106  AV_PICTURE_STRUCTURE_BOTTOM_FIELD, //< coded as bottom field
5107  AV_PICTURE_STRUCTURE_FRAME, //< coded as frame
5108 };
5109 
5110 typedef struct AVCodecParserContext {
5111  void *priv_data;
5113  int64_t frame_offset; /* offset of the current frame */
5114  int64_t cur_offset; /* current offset
5115  (incremented by each av_parser_parse()) */
5116  int64_t next_frame_offset; /* offset of the next frame */
5117  /* video info */
5118  int pict_type; /* XXX: Put it back in AVCodecContext. */
5119  /**
5120  * This field is used for proper frame duration computation in lavf.
5121  * It signals, how much longer the frame duration of the current frame
5122  * is compared to normal frame duration.
5123  *
5124  * frame_duration = (1 + repeat_pict) * time_base
5125  *
5126  * It is used by codecs like H.264 to display telecined material.
5127  */
5128  int repeat_pict; /* XXX: Put it back in AVCodecContext. */
5129  int64_t pts; /* pts of the current frame */
5130  int64_t dts; /* dts of the current frame */
5131 
5132  /* private data */
5133  int64_t last_pts;
5134  int64_t last_dts;
5136 
5137 #define AV_PARSER_PTS_NB 4
5142 
5143  int flags;
5144 #define PARSER_FLAG_COMPLETE_FRAMES 0x0001
5145 #define PARSER_FLAG_ONCE 0x0002
5146 /// Set if the parser has a valid file offset
5147 #define PARSER_FLAG_FETCHED_OFFSET 0x0004
5148 #define PARSER_FLAG_USE_CODEC_TS 0x1000
5149 
5150  int64_t offset; ///< byte offset from starting packet start
5152 
5153  /**
5154  * Set by parser to 1 for key frames and 0 for non-key frames.
5155  * It is initialized to -1, so if the parser doesn't set this flag,
5156  * old-style fallback using AV_PICTURE_TYPE_I picture type as key frames
5157  * will be used.
5158  */
5160 
5161 #if FF_API_CONVERGENCE_DURATION
5162  /**
5163  * @deprecated unused
5164  */
5167 #endif
5168 
5169  // Timestamp generation support:
5170  /**
5171  * Synchronization point for start of timestamp generation.
5172  *
5173  * Set to >0 for sync point, 0 for no sync point and <0 for undefined
5174  * (default).
5175  *
5176  * For example, this corresponds to presence of H.264 buffering period
5177  * SEI message.
5178  */
5180 
5181  /**
5182  * Offset of the current timestamp against last timestamp sync point in
5183  * units of AVCodecContext.time_base.
5184  *
5185  * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
5186  * contain a valid timestamp offset.
5187  *
5188  * Note that the timestamp of sync point has usually a nonzero
5189  * dts_ref_dts_delta, which refers to the previous sync point. Offset of
5190  * the next frame after timestamp sync point will be usually 1.
5191  *
5192  * For example, this corresponds to H.264 cpb_removal_delay.
5193  */
5195 
5196  /**
5197  * Presentation delay of current frame in units of AVCodecContext.time_base.
5198  *
5199  * Set to INT_MIN when dts_sync_point unused. Otherwise, it must
5200  * contain valid non-negative timestamp delta (presentation time of a frame
5201  * must not lie in the past).
5202  *
5203  * This delay represents the difference between decoding and presentation
5204  * time of the frame.
5205  *
5206  * For example, this corresponds to H.264 dpb_output_delay.
5207  */
5209 
5210  /**
5211  * Position of the packet in file.
5212  *
5213  * Analogous to cur_frame_pts/dts
5214  */
5216 
5217  /**
5218  * Byte position of currently parsed frame in stream.
5219  */
5220  int64_t pos;
5221 
5222  /**
5223  * Previous frame byte position.
5224  */
5225  int64_t last_pos;
5226 
5227  /**
5228  * Duration of the current frame.
5229  * For audio, this is in units of 1 / AVCodecContext.sample_rate.
5230  * For all other types, this is in units of AVCodecContext.time_base.
5231  */
5233 
5235 
5236  /**
5237  * Indicate whether a picture is coded as a frame, top field or bottom field.
5238  *
5239  * For example, H.264 field_pic_flag equal to 0 corresponds to
5240  * AV_PICTURE_STRUCTURE_FRAME. An H.264 picture with field_pic_flag
5241  * equal to 1 and bottom_field_flag equal to 0 corresponds to
5242  * AV_PICTURE_STRUCTURE_TOP_FIELD.
5243  */
5245 
5246  /**
5247  * Picture number incremented in presentation or output order.
5248  * This field may be reinitialized at the first picture of a new sequence.
5249  *
5250  * For example, this corresponds to H.264 PicOrderCnt.
5251  */
5253 
5254  /**
5255  * Dimensions of the decoded video intended for presentation.
5256  */
5257  int width;
5258  int height;
5259 
5260  /**
5261  * Dimensions of the coded video.
5262  */
5265 
5266  /**
5267  * The format of the coded data, corresponds to enum AVPixelFormat for video
5268  * and for enum AVSampleFormat for audio.
5269  *
5270  * Note that a decoder can have considerable freedom in how exactly it
5271  * decodes the data, so the format reported here might be different from the
5272  * one returned by a decoder.
5273  */
5274  int format;
5276 
5277 typedef struct AVCodecParser {
5278  int codec_ids[5]; /* several codec IDs are permitted */
5281  /* This callback never returns an error, a negative value means that
5282  * the frame start was in a previous packet. */
5284  AVCodecContext *avctx,
5285  const uint8_t **poutbuf, int *poutbuf_size,
5286  const uint8_t *buf, int buf_size);
5288  int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
5290 } AVCodecParser;
5291 
5292 /**
5293  * Iterate over all registered codec parsers.
5294  *
5295  * @param opaque a pointer where libavcodec will store the iteration state. Must
5296  * point to NULL to start the iteration.
5297  *
5298  * @return the next registered codec parser or NULL when the iteration is
5299  * finished
5300  */
5301 const AVCodecParser *av_parser_iterate(void **opaque);
5302 
5305 
5308 AVCodecParserContext *av_parser_init(int codec_id);
5309 
5310 /**
5311  * Parse a packet.
5312  *
5313  * @param s parser context.
5314  * @param avctx codec context.
5315  * @param poutbuf set to pointer to parsed buffer or NULL if not yet finished.
5316  * @param poutbuf_size set to size of parsed buffer or zero if not yet finished.
5317  * @param buf input buffer.
5318  * @param buf_size buffer size in bytes without the padding. I.e. the full buffer
5319  size is assumed to be buf_size + AV_INPUT_BUFFER_PADDING_SIZE.
5320  To signal EOF, this should be 0 (so that the last frame
5321  can be output).
5322  * @param pts input presentation timestamp.
5323  * @param dts input decoding timestamp.
5324  * @param pos input byte position in stream.
5325  * @return the number of bytes of the input bitstream used.
5326  *
5327  * Example:
5328  * @code
5329  * while(in_len){
5330  * len = av_parser_parse2(myparser, AVCodecContext, &data, &size,
5331  * in_data, in_len,
5332  * pts, dts, pos);
5333  * in_data += len;
5334  * in_len -= len;
5335  *
5336  * if(size)
5337  * decode_frame(data, size);
5338  * }
5339  * @endcode
5340  */
5342  AVCodecContext *avctx,
5343  uint8_t **poutbuf, int *poutbuf_size,
5344  const uint8_t *buf, int buf_size,
5345  int64_t pts, int64_t dts,
5346  int64_t pos);
5347 
5348 /**
5349  * @return 0 if the output buffer is a subset of the input, 1 if it is allocated and must be freed
5350  * @deprecated use AVBitStreamFilter
5351  */
5353  AVCodecContext *avctx,
5354  uint8_t **poutbuf, int *poutbuf_size,
5355  const uint8_t *buf, int buf_size, int keyframe);
5357 
5358 /**
5359  * @}
5360  * @}
5361  */
5362 
5363 /**
5364  * @addtogroup lavc_encoding
5365  * @{
5366  */
5367 
5368 /**
5369  * Find a registered encoder with a matching codec ID.
5370  *
5371  * @param id AVCodecID of the requested encoder
5372  * @return An encoder if one was found, NULL otherwise.
5373  */
5375 
5376 /**
5377  * Find a registered encoder with the specified name.
5378  *
5379  * @param name name of the requested encoder
5380  * @return An encoder if one was found, NULL otherwise.
5381  */
5382 AVCodec *avcodec_find_encoder_by_name(const char *name);
5383 
5384 /**
5385  * Encode a frame of audio.
5386  *
5387  * Takes input samples from frame and writes the next output packet, if
5388  * available, to avpkt. The output packet does not necessarily contain data for
5389  * the most recent frame, as encoders can delay, split, and combine input frames
5390  * internally as needed.
5391  *
5392  * @param avctx codec context
5393  * @param avpkt output AVPacket.
5394  * The user can supply an output buffer by setting
5395  * avpkt->data and avpkt->size prior to calling the
5396  * function, but if the size of the user-provided data is not
5397  * large enough, encoding will fail. If avpkt->data and
5398  * avpkt->size are set, avpkt->destruct must also be set. All
5399  * other AVPacket fields will be reset by the encoder using
5400  * av_init_packet(). If avpkt->data is NULL, the encoder will
5401  * allocate it. The encoder will set avpkt->size to the size
5402  * of the output packet.
5403  *
5404  * If this function fails or produces no output, avpkt will be
5405  * freed using av_packet_unref().
5406  * @param[in] frame AVFrame containing the raw audio data to be encoded.
5407  * May be NULL when flushing an encoder that has the
5408  * AV_CODEC_CAP_DELAY capability set.
5409  * If AV_CODEC_CAP_VARIABLE_FRAME_SIZE is set, then each frame
5410  * can have any number of samples.
5411  * If it is not set, frame->nb_samples must be equal to
5412  * avctx->frame_size for all frames except the last.
5413  * The final frame may be smaller than avctx->frame_size.
5414  * @param[out] got_packet_ptr This field is set to 1 by libavcodec if the
5415  * output packet is non-empty, and to 0 if it is
5416  * empty. If the function returns an error, the
5417  * packet can be assumed to be invalid, and the
5418  * value of got_packet_ptr is undefined and should
5419  * not be used.
5420  * @return 0 on success, negative error code on failure
5421  *
5422  * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead
5423  */
5425 int avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt,
5426  const AVFrame *frame, int *got_packet_ptr);
5427 
5428 /**
5429  * Encode a frame of video.
5430  *
5431  * Takes input raw video data from frame and writes the next output packet, if
5432  * available, to avpkt. The output packet does not necessarily contain data for
5433  * the most recent frame, as encoders can delay and reorder input frames
5434  * internally as needed.
5435  *
5436  * @param avctx codec context
5437  * @param avpkt output AVPacket.
5438  * The user can supply an output buffer by setting
5439  * avpkt->data and avpkt->size prior to calling the
5440  * function, but if the size of the user-provided data is not
5441  * large enough, encoding will fail. All other AVPacket fields
5442  * will be reset by the encoder using av_init_packet(). If
5443  * avpkt->data is NULL, the encoder will allocate it.
5444  * The encoder will set avpkt->size to the size of the
5445  * output packet. The returned data (if any) belongs to the
5446  * caller, he is responsible for freeing it.
5447  *
5448  * If this function fails or produces no output, avpkt will be
5449  * freed using av_packet_unref().
5450  * @param[in] frame AVFrame containing the raw video data to be encoded.
5451  * May be NULL when flushing an encoder that has the
5452  * AV_CODEC_CAP_DELAY capability set.
5453  * @param[out] got_packet_ptr This field is set to 1 by libavcodec if the
5454  * output packet is non-empty, and to 0 if it is
5455  * empty. If the function returns an error, the
5456  * packet can be assumed to be invalid, and the
5457  * value of got_packet_ptr is undefined and should
5458  * not be used.
5459  * @return 0 on success, negative error code on failure
5460  *
5461  * @deprecated use avcodec_send_frame()/avcodec_receive_packet() instead
5462  */
5464 int avcodec_encode_video2(AVCodecContext *avctx, AVPacket *avpkt,
5465  const AVFrame *frame, int *got_packet_ptr);
5466 
5467 int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
5468  const AVSubtitle *sub);
5469 
5470 
5471 /**
5472  * @}
5473  */
5474 
5475 #if FF_API_AVPICTURE
5476 /**
5477  * @addtogroup lavc_picture
5478  * @{
5479  */
5480 
5481 /**
5482  * @deprecated unused
5483  */
5485 int avpicture_alloc(AVPicture *picture, enum AVPixelFormat pix_fmt, int width, int height);
5486 
5487 /**
5488  * @deprecated unused
5489  */
5491 void avpicture_free(AVPicture *picture);
5492 
5493 /**
5494  * @deprecated use av_image_fill_arrays() instead.
5495  */
5497 int avpicture_fill(AVPicture *picture, const uint8_t *ptr,
5498  enum AVPixelFormat pix_fmt, int width, int height);
5499 
5500 /**
5501  * @deprecated use av_image_copy_to_buffer() instead.
5502  */
5504 int avpicture_layout(const AVPicture *src, enum AVPixelFormat pix_fmt,
5505  int width, int height,
5506  unsigned char *dest, int dest_size);
5507 
5508 /**
5509  * @deprecated use av_image_get_buffer_size() instead.
5510  */
5513 
5514 /**
5515  * @deprecated av_image_copy() instead.
5516  */
5518 void av_picture_copy(AVPicture *dst, const AVPicture *src,
5519  enum AVPixelFormat pix_fmt, int width, int height);
5520 
5521 /**
5522  * @deprecated unused
5523  */
5525 int av_picture_crop(AVPicture *dst, const AVPicture *src,
5526  enum AVPixelFormat pix_fmt, int top_band, int left_band);
5527 
5528 /**
5529  * @deprecated unused
5530  */
5532 int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width, enum AVPixelFormat pix_fmt,
5533  int padtop, int padbottom, int padleft, int padright, int *color);
5534 
5535 /**
5536  * @}
5537  */
5538 #endif
5539 
5540 /**
5541  * @defgroup lavc_misc Utility functions
5542  * @ingroup libavc
5543  *
5544  * Miscellaneous utility functions related to both encoding and decoding
5545  * (or neither).
5546  * @{
5547  */
5548 
5549 /**
5550  * @defgroup lavc_misc_pixfmt Pixel formats
5551  *
5552  * Functions for working with pixel formats.
5553  * @{
5554  */
5555 
5556 #if FF_API_GETCHROMA
5557 /**
5558  * @deprecated Use av_pix_fmt_get_chroma_sub_sample
5559  */
5560 
5562 void avcodec_get_chroma_sub_sample(enum AVPixelFormat pix_fmt, int *h_shift, int *v_shift);
5563 #endif
5564 
5565 /**
5566  * Return a value representing the fourCC code associated to the
5567  * pixel format pix_fmt, or 0 if no associated fourCC code can be
5568  * found.
5569  */
5571 
5572 /**
5573  * @deprecated see av_get_pix_fmt_loss()
5574  */
5575 int avcodec_get_pix_fmt_loss(enum AVPixelFormat dst_pix_fmt, enum AVPixelFormat src_pix_fmt,
5576  int has_alpha);
5577 
5578 /**
5579  * Find the best pixel format to convert to given a certain source pixel
5580  * format. When converting from one pixel format to another, information loss
5581  * may occur. For example, when converting from RGB24 to GRAY, the color
5582  * information will be lost. Similarly, other losses occur when converting from
5583  * some formats to other formats. avcodec_find_best_pix_fmt_of_2() searches which of
5584  * the given pixel formats should be used to suffer the least amount of loss.
5585  * The pixel formats from which it chooses one, are determined by the
5586  * pix_fmt_list parameter.
5587  *
5588  *
5589  * @param[in] pix_fmt_list AV_PIX_FMT_NONE terminated array of pixel formats to choose from
5590  * @param[in] src_pix_fmt source pixel format
5591  * @param[in] has_alpha Whether the source pixel format alpha channel is used.
5592  * @param[out] loss_ptr Combination of flags informing you what kind of losses will occur.
5593  * @return The best pixel format to convert to or -1 if none was found.
5594  */
5595 enum AVPixelFormat avcodec_find_best_pix_fmt_of_list(const enum AVPixelFormat *pix_fmt_list,
5596  enum AVPixelFormat src_pix_fmt,
5597  int has_alpha, int *loss_ptr);
5598 
5599 /**
5600  * @deprecated see av_find_best_pix_fmt_of_2()
5601  */
5602 enum AVPixelFormat avcodec_find_best_pix_fmt_of_2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
5603  enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr);
5604 
5606 enum AVPixelFormat avcodec_find_best_pix_fmt2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2,
5607  enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr);
5608 
5609 enum AVPixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum AVPixelFormat * fmt);
5610 
5611 /**
5612  * @}
5613  */
5614 
5615 #if FF_API_TAG_STRING
5616 /**
5617  * Put a string representing the codec tag codec_tag in buf.
5618  *
5619  * @param buf buffer to place codec tag in
5620  * @param buf_size size in bytes of buf
5621  * @param codec_tag codec tag to assign
5622  * @return the length of the string that would have been generated if
5623  * enough space had been available, excluding the trailing null
5624  *
5625  * @deprecated see av_fourcc_make_string() and av_fourcc2str().
5626  */
5628 size_t av_get_codec_tag_string(char *buf, size_t buf_size, unsigned int codec_tag);
5629 #endif
5630 
5631 void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
5632 
5633 /**
5634  * Return a name for the specified profile, if available.
5635  *
5636  * @param codec the codec that is searched for the given profile
5637  * @param profile the profile value for which a name is requested
5638  * @return A name for the profile if found, NULL otherwise.
5639  */
5640 const char *av_get_profile_name(const AVCodec *codec, int profile);
5641 
5642 /**
5643  * Return a name for the specified profile, if available.
5644  *
5645  * @param codec_id the ID of the codec to which the requested profile belongs
5646  * @param profile the profile value for which a name is requested
5647  * @return A name for the profile if found, NULL otherwise.
5648  *
5649  * @note unlike av_get_profile_name(), which searches a list of profiles
5650  * supported by a specific decoder or encoder implementation, this
5651  * function searches the list of profiles from the AVCodecDescriptor
5652  */
5653 const char *avcodec_profile_name(enum AVCodecID codec_id, int profile);
5654 
5655 int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void *arg, int *ret, int count, int size);
5656 int avcodec_default_execute2(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2, int, int),void *arg, int *ret, int count);
5657 //FIXME func typedef
5658 
5659 /**
5660  * Fill AVFrame audio data and linesize pointers.
5661  *
5662  * The buffer buf must be a preallocated buffer with a size big enough
5663  * to contain the specified samples amount. The filled AVFrame data
5664  * pointers will point to this buffer.
5665  *
5666  * AVFrame extended_data channel pointers are allocated if necessary for
5667  * planar audio.
5668  *
5669  * @param frame the AVFrame
5670  * frame->nb_samples must be set prior to calling the
5671  * function. This function fills in frame->data,
5672  * frame->extended_data, frame->linesize[0].
5673  * @param nb_channels channel count
5674  * @param sample_fmt sample format
5675  * @param buf buffer to use for frame data
5676  * @param buf_size size of buffer
5677  * @param align plane size sample alignment (0 = default)
5678  * @return >=0 on success, negative error code on failure
5679  * @todo return the size in bytes required to store the samples in
5680  * case of success, at the next libavutil bump
5681  */
5682 int avcodec_fill_audio_frame(AVFrame *frame, int nb_channels,
5683  enum AVSampleFormat sample_fmt, const uint8_t *buf,
5684  int buf_size, int align);
5685 
5686 /**
5687  * Reset the internal decoder state / flush internal buffers. Should be called
5688  * e.g. when seeking or when switching to a different stream.
5689  *
5690  * @note when refcounted frames are not used (i.e. avctx->refcounted_frames is 0),
5691  * this invalidates the frames previously returned from the decoder. When
5692  * refcounted frames are used, the decoder just releases any references it might
5693  * keep internally, but the caller's reference remains valid.
5694  */
5696 
5697 /**
5698  * Return codec bits per sample.
5699  *
5700  * @param[in] codec_id the codec
5701  * @return Number of bits per sample or zero if unknown for the given codec.
5702  */
5703 int av_get_bits_per_sample(enum AVCodecID codec_id);
5704 
5705 /**
5706  * Return the PCM codec associated with a sample format.
5707  * @param be endianness, 0 for little, 1 for big,
5708  * -1 (or anything else) for native
5709  * @return AV_CODEC_ID_PCM_* or AV_CODEC_ID_NONE
5710  */
5711 enum AVCodecID av_get_pcm_codec(enum AVSampleFormat fmt, int be);
5712 
5713 /**
5714  * Return codec bits per sample.
5715  * Only return non-zero if the bits per sample is exactly correct, not an
5716  * approximation.
5717  *
5718  * @param[in] codec_id the codec
5719  * @return Number of bits per sample or zero if unknown for the given codec.
5720  */
5721 int av_get_exact_bits_per_sample(enum AVCodecID codec_id);
5722 
5723 /**
5724  * Return audio frame duration.
5725  *
5726  * @param avctx codec context
5727  * @param frame_bytes size of the frame, or 0 if unknown
5728  * @return frame duration, in samples, if known. 0 if not able to
5729  * determine.
5730  */
5731 int av_get_audio_frame_duration(AVCodecContext *avctx, int frame_bytes);
5732 
5733 /**
5734  * This function is the same as av_get_audio_frame_duration(), except it works
5735  * with AVCodecParameters instead of an AVCodecContext.
5736  */
5737 int av_get_audio_frame_duration2(AVCodecParameters *par, int frame_bytes);
5738 
5739 #if FF_API_OLD_BSF
5741  void *priv_data;
5742  const struct AVBitStreamFilter *filter;
5745  /**
5746  * Internal default arguments, used if NULL is passed to av_bitstream_filter_filter().
5747  * Not for access by library users.
5748  */
5749  char *args;
5751 #endif
5752 
5754 
5755 /**
5756  * The bitstream filter state.
5757  *
5758  * This struct must be allocated with av_bsf_alloc() and freed with
5759  * av_bsf_free().
5760  *
5761  * The fields in the struct will only be changed (by the caller or by the
5762  * filter) as described in their documentation, and are to be considered
5763  * immutable otherwise.
5764  */
5765 typedef struct AVBSFContext {
5766  /**
5767  * A class for logging and AVOptions
5768  */
5770 
5771  /**
5772  * The bitstream filter this context is an instance of.
5773  */
5774  const struct AVBitStreamFilter *filter;
5775 
5776  /**
5777  * Opaque libavcodec internal data. Must not be touched by the caller in any
5778  * way.
5779  */
5780  AVBSFInternal *internal;
5781 
5782  /**
5783  * Opaque filter-specific private data. If filter->priv_class is non-NULL,
5784  * this is an AVOptions-enabled struct.
5785  */
5786  void *priv_data;
5787 
5788  /**
5789  * Parameters of the input stream. This field is allocated in
5790  * av_bsf_alloc(), it needs to be filled by the caller before
5791  * av_bsf_init().
5792  */
5794 
5795  /**
5796  * Parameters of the output stream. This field is allocated in
5797  * av_bsf_alloc(), it is set by the filter in av_bsf_init().
5798  */
5800 
5801  /**
5802  * The timebase used for the timestamps of the input packets. Set by the
5803  * caller before av_bsf_init().
5804  */
5806 
5807  /**
5808  * The timebase used for the timestamps of the output packets. Set by the
5809  * filter in av_bsf_init().
5810  */
5812 } AVBSFContext;
5813 
5814 typedef struct AVBitStreamFilter {
5815  const char *name;
5816 
5817  /**
5818  * A list of codec ids supported by the filter, terminated by
5819  * AV_CODEC_ID_NONE.
5820  * May be NULL, in that case the bitstream filter works with any codec id.
5821  */
5822  const enum AVCodecID *codec_ids;
5823 
5824  /**
5825  * A class for the private data, used to declare bitstream filter private
5826  * AVOptions. This field is NULL for bitstream filters that do not declare
5827  * any options.
5828  *
5829  * If this field is non-NULL, the first member of the filter private data
5830  * must be a pointer to AVClass, which will be set by libavcodec generic
5831  * code to this class.
5832  */
5834 
5835  /*****************************************************************
5836  * No fields below this line are part of the public API. They
5837  * may not be used outside of libavcodec and can be changed and
5838  * removed at will.
5839  * New public fields should be added right above.
5840  *****************************************************************
5841  */
5842 
5844  int (*init)(AVBSFContext *ctx);
5846  void (*close)(AVBSFContext *ctx);
5847  void (*flush)(AVBSFContext *ctx);
5849 
5850 #if FF_API_OLD_BSF
5851 /**
5852  * @deprecated the old bitstream filtering API (using AVBitStreamFilterContext)
5853  * is deprecated. Use the new bitstream filtering API (using AVBSFContext).
5854  */
5857 /**
5858  * @deprecated the old bitstream filtering API (using AVBitStreamFilterContext)
5859  * is deprecated. Use av_bsf_get_by_name(), av_bsf_alloc(), and av_bsf_init()
5860  * from the new bitstream filtering API (using AVBSFContext).
5861  */
5864 /**
5865  * @deprecated the old bitstream filtering API (using AVBitStreamFilterContext)
5866  * is deprecated. Use av_bsf_send_packet() and av_bsf_receive_packet() from the
5867  * new bitstream filtering API (using AVBSFContext).
5868  */
5871  AVCodecContext *avctx, const char *args,
5872  uint8_t **poutbuf, int *poutbuf_size,
5873  const uint8_t *buf, int buf_size, int keyframe);
5874 /**
5875  * @deprecated the old bitstream filtering API (using AVBitStreamFilterContext)
5876  * is deprecated. Use av_bsf_free() from the new bitstream filtering API (using
5877  * AVBSFContext).
5878  */
5881 /**
5882  * @deprecated the old bitstream filtering API (using AVBitStreamFilterContext)
5883  * is deprecated. Use av_bsf_iterate() from the new bitstream filtering API (using
5884  * AVBSFContext).
5885  */
5888 #endif
5889 
5890 /**
5891  * @return a bitstream filter with the specified name or NULL if no such
5892  * bitstream filter exists.
5893  */
5894 const AVBitStreamFilter *av_bsf_get_by_name(const char *name);
5895 
5896 /**
5897  * Iterate over all registered bitstream filters.
5898  *
5899  * @param opaque a pointer where libavcodec will store the iteration state. Must
5900  * point to NULL to start the iteration.
5901  *
5902  * @return the next registered bitstream filter or NULL when the iteration is
5903  * finished
5904  */
5905 const AVBitStreamFilter *av_bsf_iterate(void **opaque);
5906 #if FF_API_NEXT
5908 const AVBitStreamFilter *av_bsf_next(void **opaque);
5909 #endif
5910 
5911 /**
5912  * Allocate a context for a given bitstream filter. The caller must fill in the
5913  * context parameters as described in the documentation and then call
5914  * av_bsf_init() before sending any data to the filter.
5915  *
5916  * @param filter the filter for which to allocate an instance.
5917  * @param ctx a pointer into which the pointer to the newly-allocated context
5918  * will be written. It must be freed with av_bsf_free() after the
5919  * filtering is done.
5920  *
5921  * @return 0 on success, a negative AVERROR code on failure
5922  */
5923 int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **ctx);
5924 
5925 /**
5926  * Prepare the filter for use, after all the parameters and options have been
5927  * set.
5928  */
5929 int av_bsf_init(AVBSFContext *ctx);
5930 
5931 /**
5932  * Submit a packet for filtering.
5933  *
5934  * After sending each packet, the filter must be completely drained by calling
5935  * av_bsf_receive_packet() repeatedly until it returns AVERROR(EAGAIN) or
5936  * AVERROR_EOF.
5937  *
5938  * @param pkt the packet to filter. The bitstream filter will take ownership of
5939  * the packet and reset the contents of pkt. pkt is not touched if an error occurs.
5940  * This parameter may be NULL, which signals the end of the stream (i.e. no more
5941  * packets will be sent). That will cause the filter to output any packets it
5942  * may have buffered internally.
5943  *
5944  * @return 0 on success, a negative AVERROR on error.
5945  */
5947 
5948 /**
5949  * Retrieve a filtered packet.
5950  *
5951  * @param[out] pkt this struct will be filled with the contents of the filtered
5952  * packet. It is owned by the caller and must be freed using
5953  * av_packet_unref() when it is no longer needed.
5954  * This parameter should be "clean" (i.e. freshly allocated
5955  * with av_packet_alloc() or unreffed with av_packet_unref())
5956  * when this function is called. If this function returns
5957  * successfully, the contents of pkt will be completely
5958  * overwritten by the returned data. On failure, pkt is not
5959  * touched.
5960  *
5961  * @return 0 on success. AVERROR(EAGAIN) if more packets need to be sent to the
5962  * filter (using av_bsf_send_packet()) to get more output. AVERROR_EOF if there
5963  * will be no further output from the filter. Another negative AVERROR value if
5964  * an error occurs.
5965  *
5966  * @note one input packet may result in several output packets, so after sending
5967  * a packet with av_bsf_send_packet(), this function needs to be called
5968  * repeatedly until it stops returning 0. It is also possible for a filter to
5969  * output fewer packets than were sent to it, so this function may return
5970  * AVERROR(EAGAIN) immediately after a successful av_bsf_send_packet() call.
5971  */
5973 
5974 /**
5975  * Reset the internal bitstream filter state / flush internal buffers.
5976  */
5977 void av_bsf_flush(AVBSFContext *ctx);
5978 
5979 /**
5980  * Free a bitstream filter context and everything associated with it; write NULL
5981  * into the supplied pointer.
5982  */
5983 void av_bsf_free(AVBSFContext **ctx);
5984 
5985 /**
5986  * Get the AVClass for AVBSFContext. It can be used in combination with
5987  * AV_OPT_SEARCH_FAKE_OBJ for examining options.
5988  *
5989  * @see av_opt_find().
5990  */
5991 const AVClass *av_bsf_get_class(void);
5992 
5993 /**
5994  * Structure for chain/list of bitstream filters.
5995  * Empty list can be allocated by av_bsf_list_alloc().
5996  */
5997 typedef struct AVBSFList AVBSFList;
5998 
5999 /**
6000  * Allocate empty list of bitstream filters.
6001  * The list must be later freed by av_bsf_list_free()
6002  * or finalized by av_bsf_list_finalize().
6003  *
6004  * @return Pointer to @ref AVBSFList on success, NULL in case of failure
6005  */
6007 
6008 /**
6009  * Free list of bitstream filters.
6010  *
6011  * @param lst Pointer to pointer returned by av_bsf_list_alloc()
6012  */
6013 void av_bsf_list_free(AVBSFList **lst);
6014 
6015 /**
6016  * Append bitstream filter to the list of bitstream filters.
6017  *
6018  * @param lst List to append to
6019  * @param bsf Filter context to be appended
6020  *
6021  * @return >=0 on success, negative AVERROR in case of failure
6022  */
6023 int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf);
6024 
6025 /**
6026  * Construct new bitstream filter context given it's name and options
6027  * and append it to the list of bitstream filters.
6028  *
6029  * @param lst List to append to
6030  * @param bsf_name Name of the bitstream filter
6031  * @param options Options for the bitstream filter, can be set to NULL
6032  *
6033  * @return >=0 on success, negative AVERROR in case of failure
6034  */
6035 int av_bsf_list_append2(AVBSFList *lst, const char * bsf_name, AVDictionary **options);
6036 /**
6037  * Finalize list of bitstream filters.
6038  *
6039  * This function will transform @ref AVBSFList to single @ref AVBSFContext,
6040  * so the whole chain of bitstream filters can be treated as single filter
6041  * freshly allocated by av_bsf_alloc().
6042  * If the call is successful, @ref AVBSFList structure is freed and lst
6043  * will be set to NULL. In case of failure, caller is responsible for
6044  * freeing the structure by av_bsf_list_free()
6045  *
6046  * @param lst Filter list structure to be transformed
6047  * @param[out] bsf Pointer to be set to newly created @ref AVBSFContext structure
6048  * representing the chain of bitstream filters
6049  *
6050  * @return >=0 on success, negative AVERROR in case of failure
6051  */
6052 int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf);
6053 
6054 /**
6055  * Parse string describing list of bitstream filters and create single
6056  * @ref AVBSFContext describing the whole chain of bitstream filters.
6057  * Resulting @ref AVBSFContext can be treated as any other @ref AVBSFContext freshly
6058  * allocated by av_bsf_alloc().
6059  *
6060  * @param str String describing chain of bitstream filters in format
6061  * `bsf1[=opt1=val1:opt2=val2][,bsf2]`
6062  * @param[out] bsf Pointer to be set to newly created @ref AVBSFContext structure
6063  * representing the chain of bitstream filters
6064  *
6065  * @return >=0 on success, negative AVERROR in case of failure
6066  */
6067 int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf);
6068 
6069 /**
6070  * Get null/pass-through bitstream filter.
6071  *
6072  * @param[out] bsf Pointer to be set to new instance of pass-through bitstream filter
6073  *
6074  * @return
6075  */
6077 
6078 /* memory */
6079 
6080 /**
6081  * Same behaviour av_fast_malloc but the buffer has additional
6082  * AV_INPUT_BUFFER_PADDING_SIZE at the end which will always be 0.
6083  *
6084  * In addition the whole buffer will initially and after resizes
6085  * be 0-initialized so that no uninitialized data will ever appear.
6086  */
6087 void av_fast_padded_malloc(void *ptr, unsigned int *size, size_t min_size);
6088 
6089 /**
6090  * Same behaviour av_fast_padded_malloc except that buffer will always
6091  * be 0-initialized after call.
6092  */
6093 void av_fast_padded_mallocz(void *ptr, unsigned int *size, size_t min_size);
6094 
6095 /**
6096  * Encode extradata length to a buffer. Used by xiph codecs.
6097  *
6098  * @param s buffer to write to; must be at least (v/255+1) bytes long
6099  * @param v size of extradata in bytes
6100  * @return number of bytes written to the buffer.
6101  */
6102 unsigned int av_xiphlacing(unsigned char *s, unsigned int v);
6103 
6104 #if FF_API_USER_VISIBLE_AVHWACCEL
6105 /**
6106  * Register the hardware accelerator hwaccel.
6107  *
6108  * @deprecated This function doesn't do anything.
6109  */
6111 void av_register_hwaccel(AVHWAccel *hwaccel);
6112 
6113 /**
6114  * If hwaccel is NULL, returns the first registered hardware accelerator,
6115  * if hwaccel is non-NULL, returns the next registered hardware accelerator
6116  * after hwaccel, or NULL if hwaccel is the last one.
6117  *
6118  * @deprecated AVHWaccel structures contain no user-serviceable parts, so
6119  * this function should not be used.
6120  */
6122 AVHWAccel *av_hwaccel_next(const AVHWAccel *hwaccel);
6123 #endif
6124 
6125 #if FF_API_LOCKMGR
6126 /**
6127  * Lock operation used by lockmgr
6128  *
6129  * @deprecated Deprecated together with av_lockmgr_register().
6130  */
6131 enum AVLockOp {
6132  AV_LOCK_CREATE, ///< Create a mutex
6133  AV_LOCK_OBTAIN, ///< Lock the mutex
6134  AV_LOCK_RELEASE, ///< Unlock the mutex
6135  AV_LOCK_DESTROY, ///< Free mutex resources
6136 };
6137 
6138 /**
6139  * Register a user provided lock manager supporting the operations
6140  * specified by AVLockOp. The "mutex" argument to the function points
6141  * to a (void *) where the lockmgr should store/get a pointer to a user
6142  * allocated mutex. It is NULL upon AV_LOCK_CREATE and equal to the
6143  * value left by the last call for all other ops. If the lock manager is
6144  * unable to perform the op then it should leave the mutex in the same
6145  * state as when it was called and return a non-zero value. However,
6146  * when called with AV_LOCK_DESTROY the mutex will always be assumed to
6147  * have been successfully destroyed. If av_lockmgr_register succeeds
6148  * it will return a non-negative value, if it fails it will return a
6149  * negative value and destroy all mutex and unregister all callbacks.
6150  * av_lockmgr_register is not thread-safe, it must be called from a
6151  * single thread before any calls which make use of locking are used.
6152  *
6153  * @param cb User defined callback. av_lockmgr_register invokes calls
6154  * to this callback and the previously registered callback.
6155  * The callback will be used to create more than one mutex
6156  * each of which must be backed by its own underlying locking
6157  * mechanism (i.e. do not use a single static object to
6158  * implement your lock manager). If cb is set to NULL the
6159  * lockmgr will be unregistered.
6160  *
6161  * @deprecated This function does nothing, and always returns 0. Be sure to
6162  * build with thread support to get basic thread safety.
6163  */
6165 int av_lockmgr_register(int (*cb)(void **mutex, enum AVLockOp op));
6166 #endif
6167 
6168 /**
6169  * Get the type of the given codec.
6170  */
6171 enum AVMediaType avcodec_get_type(enum AVCodecID codec_id);
6172 
6173 /**
6174  * Get the name of a codec.
6175  * @return a static string identifying the codec; never NULL
6176  */
6177 const char *avcodec_get_name(enum AVCodecID id);
6178 
6179 /**
6180  * @return a positive value if s is open (i.e. avcodec_open2() was called on it
6181  * with no corresponding avcodec_close()), 0 otherwise.
6182  */
6184 
6185 /**
6186  * @return a non-zero number if codec is an encoder, zero otherwise
6187  */
6188 int av_codec_is_encoder(const AVCodec *codec);
6189 
6190 /**
6191  * @return a non-zero number if codec is a decoder, zero otherwise
6192  */
6193 int av_codec_is_decoder(const AVCodec *codec);
6194 
6195 /**
6196  * @return descriptor for given codec ID or NULL if no descriptor exists.
6197  */
6199 
6200 /**
6201  * Iterate over all codec descriptors known to libavcodec.
6202  *
6203  * @param prev previous descriptor. NULL to get the first descriptor.
6204  *
6205  * @return next descriptor or NULL after the last descriptor
6206  */
6208 
6209 /**
6210  * @return codec descriptor with the given name or NULL if no such descriptor
6211  * exists.
6212  */
6213 const AVCodecDescriptor *avcodec_descriptor_get_by_name(const char *name);
6214 
6215 
6216 /**
6217  * @return
6218  * 0 - not have JJM Graphic Card
6219  * 1 - have JJM Graphic Card
6220  */
6221 int is_have_jjm(void);
6222 /**
6223  * Allocate a CPB properties structure and initialize its fields to default
6224  * values.
6225  *
6226  * @param size if non-NULL, the size of the allocated struct will be written
6227  * here. This is useful for embedding it in side data.
6228  *
6229  * @return the newly allocated struct or NULL on failure
6230  */
6232 
6233 /**
6234  * @}
6235  */
6236 
6237 #endif /* AVCODEC_AVCODEC_H */
avcodec_get_type
enum AVMediaType avcodec_get_type(enum AVCodecID codec_id)
Get the type of the given codec.
AV_CODEC_ID_PCM_S16LE
@ AV_CODEC_ID_PCM_S16LE
Definition: avcodec.h:464
AV_CODEC_ID_TRUEMOTION2
@ AV_CODEC_ID_TRUEMOTION2
Definition: avcodec.h:295
AVSubtitle
Definition: avcodec.h:3935
AV_CODEC_ID_ANSI
@ AV_CODEC_ID_ANSI
Definition: avcodec.h:360
avcodec_close
int avcodec_close(AVCodecContext *avctx)
Close a given AVCodecContext and free all the data associated with it (but not the AVCodecContext its...
AV_CODEC_ID_TRUEMOTION2RT
@ AV_CODEC_ID_TRUEMOTION2RT
Definition: avcodec.h:432
avcodec_encode_subtitle
int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size, const AVSubtitle *sub)
AVPanScan::id
int id
id
Definition: avcodec.h:1106
AVCodecContext::frame_size
int frame_size
Number of samples per channel in an audio frame.
Definition: avcodec.h:2247
AV_CODEC_ID_EIA_608
@ AV_CODEC_ID_EIA_608
Definition: avcodec.h:670
AVBSFInternal
struct AVBSFInternal AVBSFInternal
Definition: avcodec.h:5753
av_packet_unref
void av_packet_unref(AVPacket *pkt)
Wipe the packet.
AV_CODEC_ID_MACE6
@ AV_CODEC_ID_MACE6
Definition: avcodec.h:575
AVCodecContext::hwaccel
const struct AVHWAccel * hwaccel
Hardware accelerator in use.
Definition: avcodec.h:2731
AVCodec
AVCodec.
Definition: avcodec.h:3483
AVCodecContext::hwaccel_context
void * hwaccel_context
Hardware accelerator context.
Definition: avcodec.h:2743
av_codec_get_codec_properties
attribute_deprecated unsigned av_codec_get_codec_properties(const AVCodecContext *avctx)
AV_CODEC_ID_VP6F
@ AV_CODEC_ID_VP6F
Definition: avcodec.h:310
AVBSFContext::par_in
AVCodecParameters * par_in
Parameters of the input stream.
Definition: avcodec.h:5793
AV_CODEC_ID_MSCC
@ AV_CODEC_ID_MSCC
Definition: avcodec.h:446
AV_CODEC_ID_IDCIN
@ AV_CODEC_ID_IDCIN
Definition: avcodec.h:265
hw_pix_fmt
static enum AVPixelFormat hw_pix_fmt
Definition: hw_decode.c:46
AV_CODEC_ID_SANM
@ AV_CODEC_ID_SANM
Definition: avcodec.h:400
AV_CODEC_ID_PCM_F32BE
@ AV_CODEC_ID_PCM_F32BE
Definition: avcodec.h:484
AV_CODEC_ID_DSD_LSBF
@ AV_CODEC_ID_DSD_LSBF
Definition: avcodec.h:639
AVCodecParameters::extradata
uint8_t * extradata
Extra binary data needed for initializing the decoder, codec-dependent.
Definition: avcodec.h:3973
AV_CODEC_ID_ADPCM_MS
@ AV_CODEC_ID_ADPCM_MS
Definition: avcodec.h:509
AV_CODEC_ID_LAGARITH
@ AV_CODEC_ID_LAGARITH
Definition: avcodec.h:365
AVCodecParserContext::convergence_duration
attribute_deprecated int64_t convergence_duration
Definition: avcodec.h:5166
AVPixelFormat
AVPixelFormat
Pixel format.
Definition: pixfmt.h:64
AV_CODEC_ID_DPX
@ AV_CODEC_ID_DPX
Definition: avcodec.h:346
AV_CODEC_ID_ADPCM_IMA_QT
@ AV_CODEC_ID_ADPCM_IMA_QT
Definition: avcodec.h:503
AV_FIELD_PROGRESSIVE
@ AV_FIELD_PROGRESSIVE
Definition: avcodec.h:1547
AVCodecParserContext::pts
int64_t pts
Definition: avcodec.h:5129
av_codec_set_pkt_timebase
attribute_deprecated void av_codec_set_pkt_timebase(AVCodecContext *avctx, AVRational val)
AV_CODEC_ID_INDEO5
@ AV_CODEC_ID_INDEO5
Definition: avcodec.h:330
AV_CODEC_ID_AC3
@ AV_CODEC_ID_AC3
Definition: avcodec.h:568
AVPanScan::position
int16_t position[3][2]
position of the top left corner in 1/16 pel for up to 3 fields/frames
Definition: avcodec.h:1121
AVCodecContext::log_level_offset
int log_level_offset
Definition: avcodec.h:1573
AV_AUDIO_SERVICE_TYPE_VOICE_OVER
@ AV_AUDIO_SERVICE_TYPE_VOICE_OVER
Definition: avcodec.h:823
AVCodecContext::keyint_min
int keyint_min
minimum GOP size
Definition: avcodec.h:2148
av_bsf_iterate
const AVBitStreamFilter * av_bsf_iterate(void **opaque)
Iterate over all registered bitstream filters.
AV_AUDIO_SERVICE_TYPE_EMERGENCY
@ AV_AUDIO_SERVICE_TYPE_EMERGENCY
Definition: avcodec.h:822
avcodec_receive_packet
int avcodec_receive_packet(AVCodecContext *avctx, AVPacket *avpkt)
Read encoded data from the encoder.
AVCodecContext::workaround_bugs
int workaround_bugs
Work around bugs in encoders which sometimes cannot be detected automatically.
Definition: avcodec.h:2601
AVSubtitle::rects
AVSubtitleRect ** rects
Definition: avcodec.h:3940
AV_PKT_DATA_NB
@ AV_PKT_DATA_NB
The number of side data types.
Definition: avcodec.h:1416
av_xiphlacing
unsigned int av_xiphlacing(unsigned char *s, unsigned int v)
Encode extradata length to a buffer.
av_codec_is_decoder
int av_codec_is_decoder(const AVCodec *codec)
AVCodecContext::get_format
enum AVPixelFormat(* get_format)(struct AVCodecContext *s, const enum AVPixelFormat *fmt)
callback to negotiate the pixelFormat
Definition: avcodec.h:1819
AVCodecParserContext::dts_sync_point
int dts_sync_point
Synchronization point for start of timestamp generation.
Definition: avcodec.h:5179
AV_CODEC_ID_PCM_BLURAY
@ AV_CODEC_ID_PCM_BLURAY
Definition: avcodec.h:488
AV_CODEC_ID_PBM
@ AV_CODEC_ID_PBM
Definition: avcodec.h:281
AV_CODEC_ID_APE
@ AV_CODEC_ID_APE
Definition: avcodec.h:597
AVCodecParameters::codec_type
enum AVMediaType codec_type
General type of the encoded data.
Definition: avcodec.h:3955
AVCodecContext::audio_service_type
enum AVAudioServiceType audio_service_type
Type of service that the audio stream conveys.
Definition: avcodec.h:2292
AVCodecContext::channel_layout
uint64_t channel_layout
Audio channel layout.
Definition: avcodec.h:2278
AVCodecContext::colorspace
enum AVColorSpace colorspace
YUV colorspace type.
Definition: avcodec.h:2195
AV_CODEC_ID_HUFFYUV
@ AV_CODEC_ID_HUFFYUV
Definition: avcodec.h:243
AVCodecContext::mpeg_quant
attribute_deprecated int mpeg_quant
Definition: avcodec.h:1862
AVCodec::long_name
const char * long_name
Descriptive name for the codec, meant to be more human readable than name.
Definition: avcodec.h:3495
AV_CODEC_ID_TQI
@ AV_CODEC_ID_TQI
Definition: avcodec.h:340
AV_CODEC_ID_ESCAPE130
@ AV_CODEC_ID_ESCAPE130
Definition: avcodec.h:388
AVColorTransferCharacteristic
AVColorTransferCharacteristic
Color Transfer Characteristic.
Definition: pixfmt.h:581
AV_CODEC_ID_V308
@ AV_CODEC_ID_V308
Definition: avcodec.h:421
AVCodecContext::av_class
const AVClass * av_class
information on struct for av_log
Definition: avcodec.h:1572
AVCodecHWConfig::methods
int methods
Bit set of AV_CODEC_HW_CONFIG_METHOD_* flags, describing the possible setup methods which can be used...
Definition: avcodec.h:3466
AV_PKT_DATA_MPEGTS_STREAM_ID
@ AV_PKT_DATA_MPEGTS_STREAM_ID
MPEGTS stream ID as uint8_t, this is required to pass the stream ID information from the demuxer to t...
Definition: avcodec.h:1360
av_parser_next
attribute_deprecated AVCodecParser * av_parser_next(const AVCodecParser *c)
AV_CODEC_ID_ADPCM_DTK
@ AV_CODEC_ID_ADPCM_DTK
Definition: avcodec.h:537
AVCodecParserContext::pict_type
int pict_type
Definition: avcodec.h:5118
avcodec_encode_audio2
attribute_deprecated int avcodec_encode_audio2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of audio.
AVCodecContext::sample_rate
int sample_rate
samples per second
Definition: avcodec.h:2227
AV_CODEC_ID_HCOM
@ AV_CODEC_ID_HCOM
Definition: avcodec.h:655
AV_CODEC_ID_ZMBV
@ AV_CODEC_ID_ZMBV
Definition: avcodec.h:299
AVCodecContext::rc_min_rate
int64_t rc_min_rate
minimum bitrate
Definition: avcodec.h:2452
AV_CODEC_ID_HYMT
@ AV_CODEC_ID_HYMT
Definition: avcodec.h:456
AVCodecParserContext::output_picture_number
int output_picture_number
Picture number incremented in presentation or output order.
Definition: avcodec.h:5252
AV_CODEC_ID_INTERPLAY_ACM
@ AV_CODEC_ID_INTERPLAY_ACM
Definition: avcodec.h:644
AVCodecContext::thread_safe_callbacks
int thread_safe_callbacks
Set by the client if its custom get_buffer() callback can be called synchronously from another thread...
Definition: avcodec.h:2855
AVCodecParameters
This struct describes the properties of an encoded stream.
Definition: avcodec.h:3951
AV_PKT_DATA_PARAM_CHANGE
@ AV_PKT_DATA_PARAM_CHANGE
An AV_PKT_DATA_PARAM_CHANGE side data packet is laid out as follows:
Definition: avcodec.h:1217
AVCodec::priv_class
const AVClass * priv_class
AVClass for the private context.
Definition: avcodec.h:3509
AV_CODEC_HW_CONFIG_METHOD_AD_HOC
@ AV_CODEC_HW_CONFIG_METHOD_AD_HOC
The codec supports this format by some ad-hoc method.
Definition: avcodec.h:3454
AVCodecParameters::color_space
enum AVColorSpace color_space
Definition: avcodec.h:4048
avcodec_decode_audio4
attribute_deprecated int avcodec_decode_audio4(AVCodecContext *avctx, AVFrame *frame, int *got_frame_ptr, const AVPacket *avpkt)
Decode the audio frame of size avpkt->size from avpkt->data into frame.
av_bsf_list_append
int av_bsf_list_append(AVBSFList *lst, AVBSFContext *bsf)
Append bitstream filter to the list of bitstream filters.
AVProfile::name
const char * name
short name for the profile
Definition: avcodec.h:3418
AV_CODEC_ID_SRGC
@ AV_CODEC_ID_SRGC
Definition: avcodec.h:447
AVHWAccel::type
enum AVMediaType type
Type of codec implemented by the hardware accelerator.
Definition: avcodec.h:3664
AV_CODEC_ID_8SVX_EXP
@ AV_CODEC_ID_8SVX_EXP
Definition: avcodec.h:619
AV_CODEC_ID_LOCO
@ AV_CODEC_ID_LOCO
Definition: avcodec.h:290
AV_PICTURE_STRUCTURE_UNKNOWN
@ AV_PICTURE_STRUCTURE_UNKNOWN
Definition: avcodec.h:5104
AVHWAccel::caps_internal
int caps_internal
Internal hwaccel capabilities.
Definition: avcodec.h:3800
AVCodecDescriptor::long_name
const char * long_name
A more descriptive name for this codec.
Definition: avcodec.h:729
avcodec_parameters_from_context
int avcodec_parameters_from_context(AVCodecParameters *par, const AVCodecContext *codec)
Fill the parameters struct based on the values from the supplied codec context.
av_bitstream_filter_filter
attribute_deprecated int av_bitstream_filter_filter(AVBitStreamFilterContext *bsfc, AVCodecContext *avctx, const char *args, uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size, int keyframe)
AVPanScan
Pan Scan area.
Definition: avcodec.h:1100
AVCodecParserContext::duration
int duration
Duration of the current frame.
Definition: avcodec.h:5232
AVCodecContext::err_recognition
int err_recognition
Error recognition; may misdetect some more or less valid parts as errors.
Definition: avcodec.h:2696
avcodec_string
void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode)
rational.h
AV_CODEC_ID_DIRAC
@ AV_CODEC_ID_DIRAC
Definition: avcodec.h:334
AVCodecDescriptor::name
const char * name
Name of the codec described by this descriptor.
Definition: avcodec.h:725
AVBitStreamFilter::name
const char * name
Definition: avcodec.h:5815
AVCodecContext::coded_side_data
AVPacketSideData * coded_side_data
Additional data associated with the entire coded stream.
Definition: avcodec.h:3239
AV_CODEC_ID_MP3ON4
@ AV_CODEC_ID_MP3ON4
Definition: avcodec.h:579
av_grow_packet
int av_grow_packet(AVPacket *pkt, int grow_by)
Increase packet size, correctly zeroing padding.
AVSubtitleRect
Definition: avcodec.h:3900
AVSubtitle::num_rects
unsigned num_rects
Definition: avcodec.h:3939
av_free_packet
attribute_deprecated void av_free_packet(AVPacket *pkt)
Free a packet.
av_parser_iterate
const AVCodecParser * av_parser_iterate(void **opaque)
Iterate over all registered codec parsers.
AV_CODEC_ID_RAWVIDEO
@ AV_CODEC_ID_RAWVIDEO
Definition: avcodec.h:231
AVCodecContext::intra_matrix
uint16_t * intra_matrix
custom intra quantization matrix Must be allocated with the av_malloc() family of functions,...
Definition: avcodec.h:2067
AVCodecContext::mv0_threshold
int mv0_threshold
Note: Value depends upon the compare function used for fullpel ME.
Definition: avcodec.h:2168
AV_CODEC_ID_MVC2
@ AV_CODEC_ID_MVC2
Definition: avcodec.h:403
av_bsf_send_packet
int av_bsf_send_packet(AVBSFContext *ctx, AVPacket *pkt)
Submit a packet for filtering.
AVCodecContext::lumi_masking
float lumi_masking
luminance masking (0-> disabled)
Definition: avcodec.h:1886
AVCodec::pix_fmts
enum AVPixelFormat * pix_fmts
array of supported pixel formats, or NULL if unknown, array is terminated by -1
Definition: avcodec.h:3504
avcodec_find_encoder
AVCodec * avcodec_find_encoder(enum AVCodecID id)
Find a registered encoder with a matching codec ID.
AVCodec::wrapper_name
const char * wrapper_name
Group name of the codec implementation.
Definition: avcodec.h:3522
AV_CODEC_ID_MPEG4
@ AV_CODEC_ID_MPEG4
Definition: avcodec.h:230
AV_CODEC_ID_PCM_S32LE_PLANAR
@ AV_CODEC_ID_PCM_S32LE_PLANAR
Definition: avcodec.h:493
AV_PKT_DATA_ENCRYPTION_INFO
@ AV_PKT_DATA_ENCRYPTION_INFO
This side data contains encryption info for how to decrypt the packet.
Definition: avcodec.h:1400
AV_CODEC_ID_RA_144
@ AV_CODEC_ID_RA_144
Definition: avcodec.h:552
AVFrame
This structure describes decoded (raw) audio or video data.
Definition: frame.h:295
AV_CODEC_ID_TXD
@ AV_CODEC_ID_TXD
Definition: avcodec.h:323
AVCodecContext::color_trc
enum AVColorTransferCharacteristic color_trc
Color Transfer Characteristic.
Definition: avcodec.h:2188
AVPacketSideData
Definition: avcodec.h:1421
AVCodecParserContext::pts_dts_delta
int pts_dts_delta
Presentation delay of current frame in units of AVCodecContext.time_base.
Definition: avcodec.h:5208
AVCodecContext::slice_offset
int * slice_offset
slice offsets in the frame in bytes
Definition: avcodec.h:1937
AVCodec::capabilities
int capabilities
Codec capabilities.
Definition: avcodec.h:3502
AV_CODEC_ID_WNV1
@ AV_CODEC_ID_WNV1
Definition: avcodec.h:291
AV_CODEC_ID_MWSC
@ AV_CODEC_ID_MWSC
Definition: avcodec.h:453
av_codec_get_codec_descriptor
const attribute_deprecated AVCodecDescriptor * av_codec_get_codec_descriptor(const AVCodecContext *avctx)
AV_CODEC_ID_INDEO3
@ AV_CODEC_ID_INDEO3
Definition: avcodec.h:246
avcodec_decode_subtitle2
int avcodec_decode_subtitle2(AVCodecContext *avctx, AVSubtitle *sub, int *got_sub_ptr, AVPacket *avpkt)
Decode a subtitle message.
AVPacket::data
uint8_t * data
Definition: avcodec.h:1478
AV_CODEC_ID_DVB_TELETEXT
@ AV_CODEC_ID_DVB_TELETEXT
Definition: avcodec.h:666
AV_CODEC_ID_PCM_S16BE_PLANAR
@ AV_CODEC_ID_PCM_S16BE_PLANAR
Definition: avcodec.h:494
AV_CODEC_ID_PPM
@ AV_CODEC_ID_PPM
Definition: avcodec.h:280
av_codec_get_max_lowres
attribute_deprecated int av_codec_get_max_lowres(const AVCodec *codec)
av_lockmgr_register
attribute_deprecated int av_lockmgr_register(int(*cb)(void **mutex, enum AVLockOp op))
Register a user provided lock manager supporting the operations specified by AVLockOp.
av_codec_set_chroma_intra_matrix
attribute_deprecated void av_codec_set_chroma_intra_matrix(AVCodecContext *avctx, uint16_t *val)
AV_CODEC_ID_VP6
@ AV_CODEC_ID_VP6
Definition: avcodec.h:309
AVBitStreamFilter::priv_data_size
int priv_data_size
Definition: avcodec.h:5843
AVCodecContext::field_order
enum AVFieldOrder field_order
Field order.
Definition: avcodec.h:2224
AV_CODEC_ID_A64_MULTI
@ AV_CODEC_ID_A64_MULTI
Definition: avcodec.h:361
AVCodecParameters::seek_preroll
int seek_preroll
Audio only.
Definition: avcodec.h:4099
AVHWAccel::capabilities
int capabilities
Hardware accelerated codec capabilities.
Definition: avcodec.h:3684
AV_CODEC_ID_FFMETADATA
@ AV_CODEC_ID_FFMETADATA
Dummy codec for streams containing only metadata information.
Definition: avcodec.h:708
AV_CODEC_ID_PGM
@ AV_CODEC_ID_PGM
Definition: avcodec.h:282
AV_PKT_DATA_PALETTE
@ AV_PKT_DATA_PALETTE
An AV_PKT_DATA_PALETTE side data packet contains exactly AVPALETTE_SIZE bytes worth of palette.
Definition: avcodec.h:1191
AV_CODEC_ID_FLIC
@ AV_CODEC_ID_FLIC
Definition: avcodec.h:268
AV_CODEC_ID_ADPCM_EA_R3
@ AV_CODEC_ID_ADPCM_EA_R3
Definition: avcodec.h:524
AV_LOCK_RELEASE
@ AV_LOCK_RELEASE
Unlock the mutex.
Definition: avcodec.h:6134
AV_CODEC_ID_AVS2
@ AV_CODEC_ID_AVS2
Definition: avcodec.h:412
AV_CODEC_ID_PCM_U24LE
@ AV_CODEC_ID_PCM_U24LE
Definition: avcodec.h:478
AV_CODEC_ID_ALAC
@ AV_CODEC_ID_ALAC
Definition: avcodec.h:581
AVCodecContext::p_tex_bits
attribute_deprecated int p_tex_bits
Definition: avcodec.h:2566
AV_PKT_DATA_ENCRYPTION_INIT_INFO
@ AV_PKT_DATA_ENCRYPTION_INIT_INFO
This side data is encryption initialization data.
Definition: avcodec.h:1394
AVCodecContext::b_quant_offset
float b_quant_offset
qscale offset between IP and B-frames
Definition: avcodec.h:1849
AVCodecParserContext::height
int height
Definition: avcodec.h:5258
avcodec_align_dimensions
void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height)
Modify width and height values so that they will result in a memory buffer that is acceptable for the...
RcOverride::qscale
int qscale
Definition: avcodec.h:834
AV_CODEC_ID_AMR_NB
@ AV_CODEC_ID_AMR_NB
Definition: avcodec.h:548
AVHWAccel::init
int(* init)(AVCodecContext *avctx)
Initialize the hwaccel private data.
Definition: avcodec.h:3781
AVLockOp
AVLockOp
Lock operation used by lockmgr.
Definition: avcodec.h:6131
AV_CODEC_ID_ADPCM_AICA
@ AV_CODEC_ID_ADPCM_AICA
Definition: avcodec.h:542
AVCodecContext::debug_mv
int debug_mv
debug motion vectors
Definition: avcodec.h:3195
AV_CODEC_ID_ADPCM_IMA_OKI
@ AV_CODEC_ID_ADPCM_IMA_OKI
Definition: avcodec.h:536
avcodec_register_all
attribute_deprecated void avcodec_register_all(void)
Register all the codecs, parsers and bitstream filters which were enabled at configuration time.
AVCodecContext::subtitle_header
uint8_t * subtitle_header
Header containing style information for text subtitles.
Definition: avcodec.h:3052
AVBitStreamFilterContext::filter
const struct AVBitStreamFilter * filter
Definition: avcodec.h:5742
version.h
AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
@ AV_SIDE_DATA_PARAM_CHANGE_SAMPLE_RATE
Definition: avcodec.h:1536
AVSubtitleRect::linesize
int linesize[4]
Definition: avcodec.h:3919
AV_CODEC_ID_SOL_DPCM
@ AV_CODEC_ID_SOL_DPCM
Definition: avcodec.h:559
AVCodecContext::skip_count
attribute_deprecated int skip_count
Definition: avcodec.h:2572
AVBSFContext::av_class
const AVClass * av_class
A class for logging and AVOptions.
Definition: avcodec.h:5769
AV_CODEC_ID_TRUEMOTION1
@ AV_CODEC_ID_TRUEMOTION1
Definition: avcodec.h:269
AV_CODEC_ID_PCM_ZORK
@ AV_CODEC_ID_PCM_ZORK
Definition: avcodec.h:481
AV_PKT_DATA_AFD
@ AV_PKT_DATA_AFD
Active Format Description data consisting of a single byte as specified in ETSI TS 101 154 using AVAc...
Definition: avcodec.h:1406
AV_CODEC_ID_ON2AVC
@ AV_CODEC_ID_ON2AVC
Definition: avcodec.h:630
AV_CODEC_ID_GDV
@ AV_CODEC_ID_GDV
Definition: avcodec.h:449
AVCodecParserContext::cur_frame_start_index
int cur_frame_start_index
Definition: avcodec.h:5138
av_codec_set_seek_preroll
attribute_deprecated void av_codec_set_seek_preroll(AVCodecContext *avctx, int val)
AV_CODEC_ID_WMAV2
@ AV_CODEC_ID_WMAV2
Definition: avcodec.h:573
AV_CODEC_ID_ADPCM_G722
@ AV_CODEC_ID_ADPCM_G722
Definition: avcodec.h:531
avcodec_profile_name
const char * avcodec_profile_name(enum AVCodecID codec_id, int profile)
Return a name for the specified profile, if available.
AV_CODEC_ID_ATRAC3PAL
@ AV_CODEC_ID_ATRAC3PAL
Definition: avcodec.h:649
AV_CODEC_ID_ARBC
@ AV_CODEC_ID_ARBC
Definition: avcodec.h:457
AVPacket::duration
int64_t duration
Duration of this packet in AVStream->time_base units, 0 if unknown.
Definition: avcodec.h:1496
AVCodecParameters::codec_tag
uint32_t codec_tag
Additional information about the codec (corresponds to the AVI FOURCC).
Definition: avcodec.h:3963
AV_CODEC_ID_SCREENPRESSO
@ AV_CODEC_ID_SCREENPRESSO
Definition: avcodec.h:410
AVCodecContext::me_pre_cmp
int me_pre_cmp
motion estimation prepass comparison function
Definition: avcodec.h:2015
AV_CODEC_ID_VB
@ AV_CODEC_ID_VB
Definition: avcodec.h:326
AV_CODEC_ID_FLAC
@ AV_CODEC_ID_FLAC
Definition: avcodec.h:577
AV_CODEC_ID_IMC
@ AV_CODEC_ID_IMC
Definition: avcodec.h:592
AVColorPrimaries
AVColorPrimaries
Chromaticity coordinates of the source primaries.
Definition: pixfmt.h:556
avcodec_default_get_format
enum AVPixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum AVPixelFormat *fmt)
avcodec_find_best_pix_fmt_of_list
enum AVPixelFormat avcodec_find_best_pix_fmt_of_list(const enum AVPixelFormat *pix_fmt_list, enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
Find the best pixel format to convert to given a certain source pixel format.
AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT
@ AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_LAYOUT
Definition: avcodec.h:1535
AVCodecContext::mb_decision
int mb_decision
macroblock decision mode
Definition: avcodec.h:2055
avcodec_is_open
int avcodec_is_open(AVCodecContext *s)
AV_CODEC_ID_APNG
@ AV_CODEC_ID_APNG
Definition: avcodec.h:429
AV_CODEC_ID_THP
@ AV_CODEC_ID_THP
Definition: avcodec.h:318
AV_PKT_DATA_SPHERICAL
@ AV_PKT_DATA_SPHERICAL
This side data should be associated with a video stream and corresponds to the AVSphericalMapping str...
Definition: avcodec.h:1373
AV_CODEC_ID_YOP
@ AV_CODEC_ID_YOP
Definition: avcodec.h:357
AV_CODEC_ID_MXPEG
@ AV_CODEC_ID_MXPEG
Definition: avcodec.h:364
AVCodecContext::qmax
int qmax
maximum quantizer
Definition: avcodec.h:2416
AVCodecContext::frame_skip_threshold
attribute_deprecated int frame_skip_threshold
Definition: avcodec.h:2496
AV_CODEC_ID_HDMV_PGS_SUBTITLE
@ AV_CODEC_ID_HDMV_PGS_SUBTITLE
Definition: avcodec.h:665
AV_CODEC_ID_R10K
@ AV_CODEC_ID_R10K
Definition: avcodec.h:363
av_packet_free_side_data
void av_packet_free_side_data(AVPacket *pkt)
Convenience function to free all the side data stored.
AVCodecContext::request_channel_layout
uint64_t request_channel_layout
Request decoder to use this channel layout if it can (0 for default)
Definition: avcodec.h:2285
AV_CODEC_ID_TRUEHD
@ AV_CODEC_ID_TRUEHD
Definition: avcodec.h:609
AVCodecParserContext::coded_width
int coded_width
Dimensions of the coded video.
Definition: avcodec.h:5263
AVCodecContext::delay
int delay
Codec delay.
Definition: avcodec.h:1723
AVCodecContext::me_subpel_quality
int me_subpel_quality
subpel ME quality
Definition: avcodec.h:2029
AVCodecContext::mb_cmp
int mb_cmp
macroblock comparison function (not supported yet)
Definition: avcodec.h:1965
av_packet_free
void av_packet_free(AVPacket **pkt)
Free the packet, if the packet is reference counted, it will be unreferenced first.
AVBSFContext
The bitstream filter state.
Definition: avcodec.h:5765
AVPicture::data
attribute_deprecated uint8_t * data[AV_NUM_DATA_POINTERS]
pointers to the image data planes
Definition: avcodec.h:3870
AV_CODEC_ID_PCM_S16LE_PLANAR
@ AV_CODEC_ID_PCM_S16LE_PLANAR
Definition: avcodec.h:482
AV_CODEC_ID_ADPCM_THP_LE
@ AV_CODEC_ID_ADPCM_THP_LE
Definition: avcodec.h:540
AV_CODEC_ID_DSICINVIDEO
@ AV_CODEC_ID_DSICINVIDEO
Definition: avcodec.h:312
AV_CODEC_ID_TGQ
@ AV_CODEC_ID_TGQ
Definition: avcodec.h:339
AV_CODEC_ID_RSCC
@ AV_CODEC_ID_RSCC
Definition: avcodec.h:411
AVCodecContext::slice_count
int slice_count
slice count
Definition: avcodec.h:1921
AV_CODEC_ID_AMR_WB
@ AV_CODEC_ID_AMR_WB
Definition: avcodec.h:549
av_bsf_get_null_filter
int av_bsf_get_null_filter(AVBSFContext **bsf)
Get null/pass-through bitstream filter.
AV_CODEC_ID_BIN_DATA
@ AV_CODEC_ID_BIN_DATA
Definition: avcodec.h:699
AV_CODEC_ID_H261
@ AV_CODEC_ID_H261
Definition: avcodec.h:221
AVPictureStructure
AVPictureStructure
Definition: avcodec.h:5103
AV_CODEC_ID_MP3ADU
@ AV_CODEC_ID_MP3ADU
Definition: avcodec.h:578
avcodec_pix_fmt_to_codec_tag
unsigned int avcodec_pix_fmt_to_codec_tag(enum AVPixelFormat pix_fmt)
Return a value representing the fourCC code associated to the pixel format pix_fmt,...
AVCodecParser::next
struct AVCodecParser * next
Definition: avcodec.h:5289
SUBTITLE_ASS
@ SUBTITLE_ASS
Formatted text, the ass field must be set by the decoder and is authoritative.
Definition: avcodec.h:3895
AV_CODEC_ID_SRT
@ AV_CODEC_ID_SRT
Definition: avcodec.h:667
AV_CODEC_ID_PCM_S64LE
@ AV_CODEC_ID_PCM_S64LE
Definition: avcodec.h:496
AV_AUDIO_SERVICE_TYPE_NB
@ AV_AUDIO_SERVICE_TYPE_NB
Not part of ABI.
Definition: avcodec.h:825
AVProfile
AVProfile.
Definition: avcodec.h:3416
AV_CODEC_ID_DSD_MSBF_PLANAR
@ AV_CODEC_ID_DSD_MSBF_PLANAR
Definition: avcodec.h:642
AV_CODEC_ID_ADPCM_CT
@ AV_CODEC_ID_ADPCM_CT
Definition: avcodec.h:515
AVCodecContext::frame_bits
attribute_deprecated int frame_bits
Definition: avcodec.h:2578
AVCodecParameters::color_primaries
enum AVColorPrimaries color_primaries
Definition: avcodec.h:4046
AV_CODEC_ID_MAD
@ AV_CODEC_ID_MAD
Definition: avcodec.h:347
AVCodecContext::framerate
AVRational framerate
Definition: avcodec.h:3107
AVCodecContext::skip_top
int skip_top
Number of macroblock rows at the top which are skipped.
Definition: avcodec.h:2100
AVCodec::max_lowres
uint8_t max_lowres
maximum value for lowres supported by the decoder
Definition: avcodec.h:3508
avcodec_enum_to_chroma_pos
int avcodec_enum_to_chroma_pos(int *xpos, int *ypos, enum AVChromaLocation pos)
Converts AVChromaLocation to swscale x/y chroma position.
AVCodecParserContext::offset
int64_t offset
byte offset from starting packet start
Definition: avcodec.h:5150
av_packet_split_side_data
attribute_deprecated int av_packet_split_side_data(AVPacket *pkt)
AVCodec::encode_sub
int(* encode_sub)(AVCodecContext *, uint8_t *buf, int buf_size, const struct AVSubtitle *sub)
Definition: avcodec.h:3567
avcodec_get_pix_fmt_loss
int avcodec_get_pix_fmt_loss(enum AVPixelFormat dst_pix_fmt, enum AVPixelFormat src_pix_fmt, int has_alpha)
AVCodecContext::pre_me
attribute_deprecated int pre_me
Definition: avcodec.h:2007
AVHWAccel
Definition: avcodec.h:3651
AV_CODEC_ID_SHEERVIDEO
@ AV_CODEC_ID_SHEERVIDEO
Definition: avcodec.h:435
AVCodecContext::prediction_method
attribute_deprecated int prediction_method
Definition: avcodec.h:1926
AVCodecParserContext::key_frame
int key_frame
Set by parser to 1 for key frames and 0 for non-key frames.
Definition: avcodec.h:5159
AVCodecContext::skip_idct
enum AVDiscard skip_idct
Skip IDCT/dequantization for selected frames.
Definition: avcodec.h:3035
AV_CODEC_ID_ASS
@ AV_CODEC_ID_ASS
Definition: avcodec.h:682
AVCodecParameters::channels
int channels
Audio only.
Definition: avcodec.h:4065
AVCodecContext::i_quant_factor
float i_quant_factor
qscale factor between P- and I-frames If > 0 then the last P-frame quantizer will be used (q = lastp_...
Definition: avcodec.h:1872
av_codec_is_encoder
int av_codec_is_encoder(const AVCodec *codec)
AVCodecContext::nsse_weight
int nsse_weight
noise vs.
Definition: avcodec.h:2893
av_bsf_alloc
int av_bsf_alloc(const AVBitStreamFilter *filter, AVBSFContext **ctx)
Allocate a context for a given bitstream filter.
AV_CODEC_ID_PIXLET
@ AV_CODEC_ID_PIXLET
Definition: avcodec.h:438
av_packet_add_side_data
int av_packet_add_side_data(AVPacket *pkt, enum AVPacketSideDataType type, uint8_t *data, size_t size)
Wrap an existing array as a packet side data.
AV_CODEC_ID_MPL2
@ AV_CODEC_ID_MPL2
Definition: avcodec.h:679
AV_CODEC_ID_IFF_ILBM
@ AV_CODEC_ID_IFF_ILBM
Definition: avcodec.h:354
AV_CODEC_ID_SPEEX
@ AV_CODEC_ID_SPEEX
Definition: avcodec.h:600
AVCodecContext::codec
const struct AVCodec * codec
Definition: avcodec.h:1576
AV_CODEC_ID_PCM_S16BE
@ AV_CODEC_ID_PCM_S16BE
Definition: avcodec.h:465
AVCodecContext::skip_frame
enum AVDiscard skip_frame
Skip decoding for selected frames.
Definition: avcodec.h:3042
AVCodecParameters::bits_per_raw_sample
int bits_per_raw_sample
This is the number of valid bits in each output sample.
Definition: avcodec.h:4014
AVCodec::sample_fmts
enum AVSampleFormat * sample_fmts
array of supported sample formats, or NULL if unknown, array is terminated by -1
Definition: avcodec.h:3506
AVPacket::convergence_duration
attribute_deprecated int64_t convergence_duration
Definition: avcodec.h:1507
AVCodecContext::thread_count
int thread_count
thread count is used to decide how many independent tasks should be passed to execute()
Definition: avcodec.h:2826
av_packet_pack_dictionary
uint8_t * av_packet_pack_dictionary(AVDictionary *dict, int *size)
Pack a dictionary for use in side_data.
AV_CODEC_ID_MIMIC
@ AV_CODEC_ID_MIMIC
Definition: avcodec.h:331
AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX
@ AV_CODEC_HW_CONFIG_METHOD_HW_FRAMES_CTX
The codec supports this format via the hw_frames_ctx interface.
Definition: avcodec.h:3438
av_shrink_packet
void av_shrink_packet(AVPacket *pkt, int size)
Reduce packet size, correctly zeroing padding.
AVCodec::bsfs
const char * bsfs
Decoding only, a comma-separated list of bitstream filters to apply to packets before decoding.
Definition: avcodec.h:3615
AVCodecDescriptor::mime_types
const char *const * mime_types
MIME type(s) associated with the codec.
Definition: avcodec.h:739
AV_CODEC_ID_XAN_DPCM
@ AV_CODEC_ID_XAN_DPCM
Definition: avcodec.h:558
AV_CODEC_ID_MSZH
@ AV_CODEC_ID_MSZH
Definition: avcodec.h:271
AV_CODEC_ID_YUV4
@ AV_CODEC_ID_YUV4
Definition: avcodec.h:423
samplefmt.h
AVSubtitleRect::x
int x
top left corner of pict, undefined when pict is not set
Definition: avcodec.h:3901
AV_CODEC_ID_R210
@ AV_CODEC_ID_R210
Definition: avcodec.h:351
AVCodecContext::initial_padding
int initial_padding
Audio only.
Definition: avcodec.h:3098
AV_CODEC_ID_SMACKAUDIO
@ AV_CODEC_ID_SMACKAUDIO
Definition: avcodec.h:588
av_packet_shrink_side_data
int av_packet_shrink_side_data(AVPacket *pkt, enum AVPacketSideDataType type, int size)
Shrink the already allocated side data buffer.
AVCodecContext::refs
int refs
number of reference frames
Definition: avcodec.h:2155
avcodec_default_execute2
int avcodec_default_execute2(AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2, int, int), void *arg, int *ret, int count)
AVPanScan::width
int width
width and height in 1/16 pel
Definition: avcodec.h:1113
AVDISCARD_NONE
@ AVDISCARD_NONE
discard nothing
Definition: avcodec.h:806
AVCodecContext::flags
int flags
AV_CODEC_FLAG_*.
Definition: avcodec.h:1647
AVCodecContext::bit_rate_tolerance
int bit_rate_tolerance
number of bits the bitstream is allowed to diverge from the reference.
Definition: avcodec.h:1625
AV_CODEC_ID_JACOSUB
@ AV_CODEC_ID_JACOSUB
Definition: avcodec.h:671
AV_FIELD_UNKNOWN
@ AV_FIELD_UNKNOWN
Definition: avcodec.h:1546
AVCodecContext::dct_algo
int dct_algo
DCT algorithm, see FF_DCT_* below.
Definition: avcodec.h:2757
av_parser_init
AVCodecParserContext * av_parser_init(int codec_id)
AV_CODEC_ID_SUBVIEWER
@ AV_CODEC_ID_SUBVIEWER
Definition: avcodec.h:676
pts
static int64_t pts
Definition: transcode_aac.c:647
AVCodecContext::coded_height
int coded_height
Definition: avcodec.h:1755
AVBitStreamFilterContext::next
struct AVBitStreamFilterContext * next
Definition: avcodec.h:5744
AV_PKT_DATA_DISPLAYMATRIX
@ AV_PKT_DATA_DISPLAYMATRIX
This side data contains a 3x3 transformation matrix describing an affine transformation that needs to...
Definition: avcodec.h:1253
AVBSFContext::par_out
AVCodecParameters * par_out
Parameters of the output stream.
Definition: avcodec.h:5799
AV_CODEC_ID_SMC
@ AV_CODEC_ID_SMC
Definition: avcodec.h:267
avcodec_copy_context
attribute_deprecated int avcodec_copy_context(AVCodecContext *dest, const AVCodecContext *src)
Copy the settings of the source AVCodecContext into the destination AVCodecContext.
AV_CODEC_ID_MP3
@ AV_CODEC_ID_MP3
preferred ID for decoding MPEG audio layer 1, 2 or 3
Definition: avcodec.h:566
avcodec_find_encoder_by_name
AVCodec * avcodec_find_encoder_by_name(const char *name)
Find a registered encoder with the specified name.
AV_CODEC_ID_SUBVIEWER1
@ AV_CODEC_ID_SUBVIEWER1
Definition: avcodec.h:675
avpicture_get_size
attribute_deprecated int avpicture_get_size(enum AVPixelFormat pix_fmt, int width, int height)
AV_CODEC_ID_MSMPEG4V2
@ AV_CODEC_ID_MSMPEG4V2
Definition: avcodec.h:233
AV_CODEC_ID_8SVX_FIB
@ AV_CODEC_ID_8SVX_FIB
Definition: avcodec.h:620
AV_CODEC_ID_FFWAVESYNTH
@ AV_CODEC_ID_FFWAVESYNTH
Definition: avcodec.h:634
AVCodecParserContext::dts
int64_t dts
Definition: avcodec.h:5130
AVSubtitleRect::ass
char * ass
0 terminated ASS/SSA compatible event line.
Definition: avcodec.h:3930
AVHWAccel::priv_data_size
int priv_data_size
Size of the private data to allocate in AVCodecInternal.hwaccel_priv_data.
Definition: avcodec.h:3795
av_codec_set_codec_descriptor
attribute_deprecated void av_codec_set_codec_descriptor(AVCodecContext *avctx, const AVCodecDescriptor *desc)
av_bsf_get_by_name
const AVBitStreamFilter * av_bsf_get_by_name(const char *name)
AV_CODEC_ID_ATRAC3
@ AV_CODEC_ID_ATRAC3
Definition: avcodec.h:596
avsubtitle_free
void avsubtitle_free(AVSubtitle *sub)
Free all allocated data in the given subtitle struct.
AV_PKT_DATA_STRINGS_METADATA
@ AV_PKT_DATA_STRINGS_METADATA
A list of zero terminated key/value strings.
Definition: avcodec.h:1317
AV_LOCK_OBTAIN
@ AV_LOCK_OBTAIN
Lock the mutex.
Definition: avcodec.h:6133
AV_CODEC_ID_DVB_SUBTITLE
@ AV_CODEC_ID_DVB_SUBTITLE
Definition: avcodec.h:660
AV_PKT_DATA_REPLAYGAIN
@ AV_PKT_DATA_REPLAYGAIN
This side data should be associated with an audio stream and contains ReplayGain information in form ...
Definition: avcodec.h:1244
AVCodecContext::get_buffer2
int(* get_buffer2)(struct AVCodecContext *s, AVFrame *frame, int flags)
This callback is called at the beginning of each frame to get data buffer(s) for it.
Definition: avcodec.h:2382
AV_CODEC_ID_SIPR
@ AV_CODEC_ID_SIPR
Definition: avcodec.h:606
AVCodecParameters::color_trc
enum AVColorTransferCharacteristic color_trc
Definition: avcodec.h:4047
AV_CODEC_ID_ADPCM_SBPRO_2
@ AV_CODEC_ID_ADPCM_SBPRO_2
Definition: avcodec.h:520
av_packet_side_data_name
const char * av_packet_side_data_name(enum AVPacketSideDataType type)
AV_CODEC_ID_WMAV1
@ AV_CODEC_ID_WMAV1
Definition: avcodec.h:572
AV_CODEC_ID_SBC
@ AV_CODEC_ID_SBC
Definition: avcodec.h:653
AVCodecContext::p_count
attribute_deprecated int p_count
Definition: avcodec.h:2570
AV_CODEC_ID_PCM_S8
@ AV_CODEC_ID_PCM_S8
Definition: avcodec.h:468
AV_PICTURE_STRUCTURE_FRAME
@ AV_PICTURE_STRUCTURE_FRAME
Definition: avcodec.h:5107
AV_CODEC_ID_WMAVOICE
@ AV_CODEC_ID_WMAVOICE
Definition: avcodec.h:601
RcOverride::quality_factor
float quality_factor
Definition: avcodec.h:835
AVCodecContext::color_primaries
enum AVColorPrimaries color_primaries
Chromaticity coordinates of the source primaries.
Definition: avcodec.h:2181
AVCodecParserContext::cur_frame_end
int64_t cur_frame_end[AV_PARSER_PTS_NB]
Definition: avcodec.h:5151
AV_CODEC_ID_MDEC
@ AV_CODEC_ID_MDEC
Definition: avcodec.h:255
AVCodec::supported_samplerates
const int * supported_samplerates
array of supported audio samplerates, or NULL if unknown, array is terminated by 0
Definition: avcodec.h:3505
AV_PKT_DATA_WEBVTT_SETTINGS
@ AV_PKT_DATA_WEBVTT_SETTINGS
The optional settings (rendering instructions) that immediately follow the timestamp specifier of a W...
Definition: avcodec.h:1347
AV_CODEC_ID_MACE3
@ AV_CODEC_ID_MACE3
Definition: avcodec.h:574
AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX
@ AV_CODEC_HW_CONFIG_METHOD_HW_DEVICE_CTX
The codec supports this format via the hw_device_ctx interface.
Definition: avcodec.h:3429
AV_CODEC_ID_ATRAC3P
@ AV_CODEC_ID_ATRAC3P
Definition: avcodec.h:604
AVCodecContext::pts_correction_num_faulty_pts
int64_t pts_correction_num_faulty_pts
Current statistics for PTS correction.
Definition: avcodec.h:3144
AV_CODEC_ID_H263I
@ AV_CODEC_ID_H263I
Definition: avcodec.h:238
AVCodecParserContext::parser
struct AVCodecParser * parser
Definition: avcodec.h:5112
av_bsf_get_class
const AVClass * av_bsf_get_class(void)
Get the AVClass for AVBSFContext.
AV_CODEC_ID_XFACE
@ AV_CODEC_ID_XFACE
Definition: avcodec.h:426
AV_CODEC_ID_TTA
@ AV_CODEC_ID_TTA
Definition: avcodec.h:587
AVCodecContext::rc_initial_buffer_occupancy
int rc_initial_buffer_occupancy
Number of bits which should be loaded into the rc buffer before decoding starts.
Definition: avcodec.h:2473
AV_CODEC_ID_TTF
@ AV_CODEC_ID_TTF
Definition: avcodec.h:689
AVHWAccel::alloc_frame
int(* alloc_frame)(AVCodecContext *avctx, AVFrame *frame)
Allocate a custom buffer.
Definition: avcodec.h:3697
AV_PKT_DATA_AUDIO_SERVICE_TYPE
@ AV_PKT_DATA_AUDIO_SERVICE_TYPE
This side data should be associated with an audio stream and corresponds to enum AVAudioServiceType.
Definition: avcodec.h:1265
AVCodecParameters::frame_size
int frame_size
Audio only.
Definition: avcodec.h:4080
AV_CODEC_ID_S302M
@ AV_CODEC_ID_S302M
Definition: avcodec.h:490
AV_CODEC_ID_CFHD
@ AV_CODEC_ID_CFHD
Definition: avcodec.h:431
AVCodecContext::extradata_size
int extradata_size
Definition: avcodec.h:1669
AVCodecContext::has_b_frames
int has_b_frames
Size of the frame reordering buffer in the decoder.
Definition: avcodec.h:1857
AV_CODEC_ID_4XM
@ AV_CODEC_ID_4XM
Definition: avcodec.h:252
AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
@ AV_SIDE_DATA_PARAM_CHANGE_DIMENSIONS
Definition: avcodec.h:1537
AV_CODEC_ID_ADPCM_G726
@ AV_CODEC_ID_ADPCM_G726
Definition: avcodec.h:514
avcodec_alloc_context3
AVCodecContext * avcodec_alloc_context3(const AVCodec *codec)
Allocate an AVCodecContext and set its fields to default values.
AV_CODEC_ID_MPEG4SYSTEMS
@ AV_CODEC_ID_MPEG4SYSTEMS
FAKE codec to indicate a MPEG-4 Systems stream (only used by libavformat)
Definition: avcodec.h:706
AVCodec::supported_framerates
const AVRational * supported_framerates
array of supported framerates, or NULL if any, array is terminated by {0,0}
Definition: avcodec.h:3503
AV_CODEC_ID_DSICINAUDIO
@ AV_CODEC_ID_DSICINAUDIO
Definition: avcodec.h:591
AVCodecDescriptor
This struct describes the properties of a single codec described by an AVCodecID.
Definition: avcodec.h:717
AV_CODEC_ID_PCM_LXF
@ AV_CODEC_ID_PCM_LXF
Definition: avcodec.h:489
AVCodecContext::stats_in
char * stats_in
pass2 encoding statistics input buffer Concatenated stuff from stats_out of pass1 should be placed he...
Definition: avcodec.h:2594
av_new_packet
int av_new_packet(AVPacket *pkt, int size)
Allocate the payload of a packet and initialize its fields with default values.
AVCodecContext::global_quality
int global_quality
Global quality for codecs which cannot change it per frame.
Definition: avcodec.h:1633
AV_PKT_DATA_STEREO3D
@ AV_PKT_DATA_STEREO3D
This side data should be associated with a video stream and contains Stereoscopic 3D information in f...
Definition: avcodec.h:1259
AV_CODEC_ID_BMP
@ AV_CODEC_ID_BMP
Definition: avcodec.h:296
AV_CODEC_ID_WMAPRO
@ AV_CODEC_ID_WMAPRO
Definition: avcodec.h:602
AVCodecParserContext::fetch_timestamp
int fetch_timestamp
Definition: avcodec.h:5135
AV_CODEC_ID_KMVC
@ AV_CODEC_ID_KMVC
Definition: avcodec.h:303
AV_CODEC_ID_XMA1
@ AV_CODEC_ID_XMA1
Definition: avcodec.h:645
AVFieldOrder
AVFieldOrder
Definition: avcodec.h:1545
AV_PKT_DATA_MASTERING_DISPLAY_METADATA
@ AV_PKT_DATA_MASTERING_DISPLAY_METADATA
Mastering display metadata (based on SMPTE-2086:2014).
Definition: avcodec.h:1367
AVHWAccel::uninit
int(* uninit)(AVCodecContext *avctx)
Uninitialize the hwaccel private data.
Definition: avcodec.h:3789
AV_CODEC_ID_ADPCM_AFC
@ AV_CODEC_ID_ADPCM_AFC
Definition: avcodec.h:535
AV_CODEC_ID_ADPCM_IMA_EA_SEAD
@ AV_CODEC_ID_ADPCM_IMA_EA_SEAD
Definition: avcodec.h:526
AVCodecParameters::sample_aspect_ratio
AVRational sample_aspect_ratio
Video only.
Definition: avcodec.h:4035
avpicture_alloc
attribute_deprecated int avpicture_alloc(AVPicture *picture, enum AVPixelFormat pix_fmt, int width, int height)
AV_CODEC_ID_RL2
@ AV_CODEC_ID_RL2
Definition: avcodec.h:332
RcOverride
Definition: avcodec.h:831
AV_AUDIO_SERVICE_TYPE_VISUALLY_IMPAIRED
@ AV_AUDIO_SERVICE_TYPE_VISUALLY_IMPAIRED
Definition: avcodec.h:818
AVCodecParserContext::last_pts
int64_t last_pts
Definition: avcodec.h:5133
AVSubtitleRect::y
int y
top left corner of pict, undefined when pict is not set
Definition: avcodec.h:3902
AV_CODEC_ID_VP9
@ AV_CODEC_ID_VP9
Definition: avcodec.h:386
AVCodecParameters::width
int width
Video only.
Definition: avcodec.h:4025
AV_CODEC_ID_NUV
@ AV_CODEC_ID_NUV
Definition: avcodec.h:302
AVCodecContext::ticks_per_frame
int ticks_per_frame
For some codecs, the time base is closer to the field rate than the frame rate.
Definition: avcodec.h:1699
AV_CODEC_ID_MP2
@ AV_CODEC_ID_MP2
Definition: avcodec.h:565
AV_CODEC_ID_ADPCM_IMA_DK3
@ AV_CODEC_ID_ADPCM_IMA_DK3
Definition: avcodec.h:505
AV_CODEC_ID_VMDAUDIO
@ AV_CODEC_ID_VMDAUDIO
Definition: avcodec.h:576
AV_CODEC_ID_WS_VQA
@ AV_CODEC_ID_WS_VQA
Definition: avcodec.h:262
AVCodecContext::sub_text_format
int sub_text_format
Control the form of AVSubtitle.rects[N]->ass.
Definition: avcodec.h:3271
AVCodecContext::mv_bits
attribute_deprecated int mv_bits
Definition: avcodec.h:2560
is_have_jjm
int is_have_jjm(void)
AVCodecContext::error_concealment
int error_concealment
error concealment flags
Definition: avcodec.h:2642
AV_CODEC_ID_WMV2
@ AV_CODEC_ID_WMV2
Definition: avcodec.h:236
avcodec_receive_frame
int avcodec_receive_frame(AVCodecContext *avctx, AVFrame *frame)
Return decoded output data from a decoder.
av_dup_packet
attribute_deprecated int av_dup_packet(AVPacket *pkt)
AVHWDeviceType
AVHWDeviceType
Definition: hwcontext.h:27
AVSubtitleType
AVSubtitleType
Definition: avcodec.h:3880
AV_CODEC_ID_ADPCM_IMA_APC
@ AV_CODEC_ID_ADPCM_IMA_APC
Definition: avcodec.h:532
AVCodecDescriptor::type
enum AVMediaType type
Definition: avcodec.h:719
AVCodecContext::thread_type
int thread_type
Which multithreading methods to use.
Definition: avcodec.h:2836
AV_CODEC_ID_ATRAC9
@ AV_CODEC_ID_ATRAC9
Definition: avcodec.h:654
AVPicture
Picture data structure.
Definition: avcodec.h:3868
AVCodecContext::brd_scale
attribute_deprecated int brd_scale
Definition: avcodec.h:2140
AV_CODEC_ID_UTVIDEO
@ AV_CODEC_ID_UTVIDEO
Definition: avcodec.h:371
AV_CODEC_ID_ALIAS_PIX
@ AV_CODEC_ID_ALIAS_PIX
Definition: avcodec.h:395
AVCodecContext::bits_per_raw_sample
int bits_per_raw_sample
Bits per sample/pixel of internal libavcodec pixel/sample format.
Definition: avcodec.h:2798
AVPacketSideData::data
uint8_t * data
Definition: avcodec.h:1422
AV_CODEC_ID_ADPCM_IMA_ISS
@ AV_CODEC_ID_ADPCM_IMA_ISS
Definition: avcodec.h:530
AV_CODEC_ID_BINKAUDIO_DCT
@ AV_CODEC_ID_BINKAUDIO_DCT
Definition: avcodec.h:613
avcodec_fill_audio_frame
int avcodec_fill_audio_frame(AVFrame *frame, int nb_channels, enum AVSampleFormat sample_fmt, const uint8_t *buf, int buf_size, int align)
Fill AVFrame audio data and linesize pointers.
RcOverride::start_frame
int start_frame
Definition: avcodec.h:832
AV_CODEC_ID_TIERTEXSEQVIDEO
@ AV_CODEC_ID_TIERTEXSEQVIDEO
Definition: avcodec.h:313
AV_CODEC_ID_PCM_F24LE
@ AV_CODEC_ID_PCM_F24LE
Definition: avcodec.h:499
AVCodecParserContext::format
int format
The format of the coded data, corresponds to enum AVPixelFormat for video and for enum AVSampleFormat...
Definition: avcodec.h:5274
AVBSFContext::time_base_in
AVRational time_base_in
The timebase used for the timestamps of the input packets.
Definition: avcodec.h:5805
AVCodecDescriptor::profiles
const struct AVProfile * profiles
If non-NULL, an array of profiles recognized for this codec.
Definition: avcodec.h:744
AV_CODEC_ID_AURA2
@ AV_CODEC_ID_AURA2
Definition: avcodec.h:342
AV_CODEC_ID_MSMPEG4V1
@ AV_CODEC_ID_MSMPEG4V1
Definition: avcodec.h:232
AVAudioServiceType
AVAudioServiceType
Definition: avcodec.h:815
AVCodecHWConfig::pix_fmt
enum AVPixelFormat pix_fmt
A hardware pixel format which the codec can use.
Definition: avcodec.h:3461
AVSubtitle::pts
int64_t pts
Same as packet pts, in AV_TIME_BASE.
Definition: avcodec.h:3941
pix_fmt
static enum AVPixelFormat pix_fmt
Definition: demuxing_decoding.c:40
avcodec_align_dimensions2
void avcodec_align_dimensions2(AVCodecContext *s, int *width, int *height, int linesize_align[AV_NUM_DATA_POINTERS])
Modify width and height values so that they will result in a memory buffer that is acceptable for the...
AV_CODEC_ID_SONIC_LS
@ AV_CODEC_ID_SONIC_LS
Definition: avcodec.h:636
AV_CODEC_ID_TARGA_Y216
@ AV_CODEC_ID_TARGA_Y216
Definition: avcodec.h:420
AV_CODEC_ID_PCM_MULAW
@ AV_CODEC_ID_PCM_MULAW
Definition: avcodec.h:470
AVCodec::update_thread_context
int(* update_thread_context)(AVCodecContext *dst, const AVCodecContext *src)
Copy necessary context variables from a previous thread context to the current one.
Definition: avcodec.h:3550
AVCodecContext::max_pixels
int64_t max_pixels
The number of pixels per image to maximally accept.
Definition: avcodec.h:3294
AV_CODEC_ID_PCM_U16BE
@ AV_CODEC_ID_PCM_U16BE
Definition: avcodec.h:467
av_picture_copy
attribute_deprecated void av_picture_copy(AVPicture *dst, const AVPicture *src, enum AVPixelFormat pix_fmt, int width, int height)
AVBitStreamFilter::codec_ids
enum AVCodecID * codec_ids
A list of codec ids supported by the filter, terminated by AV_CODEC_ID_NONE.
Definition: avcodec.h:5822
avcodec_get_name
const char * avcodec_get_name(enum AVCodecID id)
Get the name of a codec.
av_bsf_free
void av_bsf_free(AVBSFContext **ctx)
Free a bitstream filter context and everything associated with it; write NULL into the supplied point...
AV_CODEC_ID_CODEC2
@ AV_CODEC_ID_CODEC2
Definition: avcodec.h:632
AV_CODEC_ID_ADPCM_IMA_SMJPEG
@ AV_CODEC_ID_ADPCM_IMA_SMJPEG
Definition: avcodec.h:508
AV_CODEC_ID_DOLBY_E
@ AV_CODEC_ID_DOLBY_E
Definition: avcodec.h:650
AV_CODEC_ID_PCM_DVD
@ AV_CODEC_ID_PCM_DVD
Definition: avcodec.h:483
AVHWAccel::decode_params
int(* decode_params)(AVCodecContext *avctx, int type, const uint8_t *buf, uint32_t buf_size)
Callback for parameter data (SPS/PPS/VPS etc).
Definition: avcodec.h:3727
AV_CODEC_ID_FFVHUFF
@ AV_CODEC_ID_FFVHUFF
Definition: avcodec.h:285
AVCodecContext::rc_max_rate
int64_t rc_max_rate
maximum bitrate
Definition: avcodec.h:2445
AV_CODEC_ID_SVQ3
@ AV_CODEC_ID_SVQ3
Definition: avcodec.h:241
AV_CODEC_ID_RALF
@ AV_CODEC_ID_RALF
Definition: avcodec.h:622
AV_CODEC_ID_VC1IMAGE
@ AV_CODEC_ID_VC1IMAGE
Definition: avcodec.h:370
AVCodecContext::error
uint64_t error[AV_NUM_DATA_POINTERS]
error
Definition: avcodec.h:2750
AV_CODEC_ID_WRAPPED_AVFRAME
@ AV_CODEC_ID_WRAPPED_AVFRAME
Passthrough codec, AVFrames wrapped in AVPacket.
Definition: avcodec.h:709
AV_CODEC_ID_XAN_WC4
@ AV_CODEC_ID_XAN_WC4
Definition: avcodec.h:259
AVSubtitleRect::text
char * text
0 terminated plain UTF-8 text
Definition: avcodec.h:3923
AVCPBProperties
This structure describes the bitrate properties of an encoded bitstream.
Definition: avcodec.h:1129
AVSideDataParamChangeFlags
AVSideDataParamChangeFlags
Definition: avcodec.h:1533
AVDISCARD_BIDIR
@ AVDISCARD_BIDIR
discard all bidirectional frames
Definition: avcodec.h:809
AV_CODEC_ID_H264
@ AV_CODEC_ID_H264
Definition: avcodec.h:245
av_packet_new_side_data
uint8_t * av_packet_new_side_data(AVPacket *pkt, enum AVPacketSideDataType type, int size)
Allocate new information of a packet.
av_get_codec_tag_string
attribute_deprecated size_t av_get_codec_tag_string(char *buf, size_t buf_size, unsigned int codec_tag)
Put a string representing the codec tag codec_tag in buf.
AVCodecContext::codec_id
enum AVCodecID codec_id
Definition: avcodec.h:1577
AVCodecContext::p_masking
float p_masking
p block masking (0-> disabled)
Definition: avcodec.h:1907
av_packet_get_side_data
uint8_t * av_packet_get_side_data(const AVPacket *pkt, enum AVPacketSideDataType type, int *size)
Get side information from packet.
av_bitstream_filter_next
const attribute_deprecated AVBitStreamFilter * av_bitstream_filter_next(const AVBitStreamFilter *f)
AVCodec::init_thread_copy
int(* init_thread_copy)(AVCodecContext *)
If defined, called on thread contexts when they are created.
Definition: avcodec.h:3542
AV_CODEC_ID_DVD_NAV
@ AV_CODEC_ID_DVD_NAV
Definition: avcodec.h:697
AV_CODEC_ID_ARIB_CAPTION
@ AV_CODEC_ID_ARIB_CAPTION
Definition: avcodec.h:685
AVCodecDescriptor::props
int props
Codec properties, a combination of AV_CODEC_PROP_* flags.
Definition: avcodec.h:733
AV_CODEC_ID_PNG
@ AV_CODEC_ID_PNG
Definition: avcodec.h:279
AV_CODEC_ID_AVUI
@ AV_CODEC_ID_AVUI
Definition: avcodec.h:418
AVCodecParserContext::dts_ref_dts_delta
int dts_ref_dts_delta
Offset of the current timestamp against last timestamp sync point in units of AVCodecContext....
Definition: avcodec.h:5194
AVCodecParserContext::repeat_pict
int repeat_pict
This field is used for proper frame duration computation in lavf.
Definition: avcodec.h:5128
AV_CODEC_ID_TDSC
@ AV_CODEC_ID_TDSC
Definition: avcodec.h:405
AV_PICTURE_STRUCTURE_BOTTOM_FIELD
@ AV_PICTURE_STRUCTURE_BOTTOM_FIELD
Definition: avcodec.h:5106
AV_CODEC_ID_AVRN
@ AV_CODEC_ID_AVRN
Definition: avcodec.h:424
AV_CODEC_ID_WEBVTT
@ AV_CODEC_ID_WEBVTT
Definition: avcodec.h:678
AVCodecContext::rc_buffer_size
int rc_buffer_size
decoder bitstream buffer size
Definition: avcodec.h:2430
AVCodecContext::sub_charenc
char * sub_charenc
DTS of the last frame.
Definition: avcodec.h:3154
AV_CODEC_ID_AVS3
@ AV_CODEC_ID_AVS3
Definition: avcodec.h:413
AVCPBProperties::avg_bitrate
int avg_bitrate
Average bitrate of the stream, in bits per second.
Definition: avcodec.h:1153
AVDISCARD_ALL
@ AVDISCARD_ALL
discard all
Definition: avcodec.h:812
AV_CODEC_ID_PCM_ALAW
@ AV_CODEC_ID_PCM_ALAW
Definition: avcodec.h:471
AV_CODEC_ID_WMV3
@ AV_CODEC_ID_WMV3
Definition: avcodec.h:289
AV_CODEC_ID_FLASHSV2
@ AV_CODEC_ID_FLASHSV2
Definition: avcodec.h:349
avcodec_descriptor_next
const AVCodecDescriptor * avcodec_descriptor_next(const AVCodecDescriptor *prev)
Iterate over all codec descriptors known to libavcodec.
AV_CODEC_ID_EXR
@ AV_CODEC_ID_EXR
Definition: avcodec.h:398
AVPacket::buf
AVBufferRef * buf
A reference to the reference-counted buffer where the packet data is stored.
Definition: avcodec.h:1461
AV_CODEC_ID_ADPCM_EA_XAS
@ AV_CODEC_ID_ADPCM_EA_XAS
Definition: avcodec.h:528
AVSubtitleRect::w
int w
width of pict, undefined when pict is not set
Definition: avcodec.h:3903
AV_CODEC_ID_SP5X
@ AV_CODEC_ID_SP5X
Definition: avcodec.h:228
AVClass
Describe the class of an AVClass context structure.
Definition: log.h:67
avcodec_get_class
const AVClass * avcodec_get_class(void)
Get the AVClass for AVCodecContext.
AVCodecContext::max_prediction_order
attribute_deprecated int max_prediction_order
Definition: avcodec.h:2525
AV_CODEC_ID_MSS1
@ AV_CODEC_ID_MSS1
Definition: avcodec.h:380
AV_CODEC_ID_XWD
@ AV_CODEC_ID_XWD
Definition: avcodec.h:376
AV_CODEC_ID_DST
@ AV_CODEC_ID_DST
Definition: avcodec.h:647
AVCodecContext::apply_cropping
int apply_cropping
Video decoding only.
Definition: avcodec.h:3352
AVCodecContext::color_range
enum AVColorRange color_range
MPEG vs JPEG YUV range.
Definition: avcodec.h:2202
AV_CODEC_ID_INTERPLAY_VIDEO
@ AV_CODEC_ID_INTERPLAY_VIDEO
Definition: avcodec.h:257
AVCodecParser::codec_ids
int codec_ids[5]
Definition: avcodec.h:5278
AV_CODEC_ID_AV1
@ AV_CODEC_ID_AV1
Definition: avcodec.h:444
avcodec_parameters_free
void avcodec_parameters_free(AVCodecParameters **par)
Free an AVCodecParameters instance and everything associated with it and write NULL to the supplied p...
AV_CODEC_ID_ADPCM_YAMAHA
@ AV_CODEC_ID_ADPCM_YAMAHA
Definition: avcodec.h:517
AV_CODEC_ID_ZEROCODEC
@ AV_CODEC_ID_ZEROCODEC
Definition: avcodec.h:379
AV_CODEC_ID_TIMED_ID3
@ AV_CODEC_ID_TIMED_ID3
Definition: avcodec.h:698
AV_CODEC_ID_ADPCM_IMA_WS
@ AV_CODEC_ID_ADPCM_IMA_WS
Definition: avcodec.h:507
AVCodecContext::i_tex_bits
attribute_deprecated int i_tex_bits
Definition: avcodec.h:2564
AV_CODEC_ID_PCM_U24BE
@ AV_CODEC_ID_PCM_U24BE
Definition: avcodec.h:479
AVCodecContext::slice_flags
int slice_flags
slice flags
Definition: avcodec.h:2045
av_bsf_list_alloc
AVBSFList * av_bsf_list_alloc(void)
Allocate empty list of bitstream filters.
AVCodec::type
enum AVMediaType type
Definition: avcodec.h:3496
AVCodecParser::parser_close
void(* parser_close)(AVCodecParserContext *s)
Definition: avcodec.h:5287
AV_CODEC_ID_PICTOR
@ AV_CODEC_ID_PICTOR
Definition: avcodec.h:359
AVCodecContext::misc_bits
attribute_deprecated int misc_bits
Definition: avcodec.h:2574
AV_CODEC_ID_MOV_TEXT
@ AV_CODEC_ID_MOV_TEXT
Definition: avcodec.h:664
AV_CODEC_ID_FITS
@ AV_CODEC_ID_FITS
Definition: avcodec.h:450
avcodec_free_context
void avcodec_free_context(AVCodecContext **avctx)
Free the codec context and everything associated with it and write NULL to the provided pointer.
AVRational
Rational number (pair of numerator and denominator).
Definition: rational.h:58
AV_CODEC_ID_INTERPLAY_DPCM
@ AV_CODEC_ID_INTERPLAY_DPCM
Definition: avcodec.h:557
AV_CODEC_ID_ADPCM_IMA_EA_EACS
@ AV_CODEC_ID_ADPCM_IMA_EA_EACS
Definition: avcodec.h:527
AV_CODEC_ID_PCM_U32BE
@ AV_CODEC_ID_PCM_U32BE
Definition: avcodec.h:475
AVCodecContext::nb_coded_side_data
int nb_coded_side_data
Definition: avcodec.h:3240
AVCodecContext::qblur
float qblur
amount of qscale smoothing over time (0.0-1.0)
Definition: avcodec.h:2402
AV_CODEC_ID_Y41P
@ AV_CODEC_ID_Y41P
Definition: avcodec.h:415
AV_CODEC_ID_WMALOSSLESS
@ AV_CODEC_ID_WMALOSSLESS
Definition: avcodec.h:603
AV_PICTURE_STRUCTURE_TOP_FIELD
@ AV_PICTURE_STRUCTURE_TOP_FIELD
Definition: avcodec.h:5105
AV_CODEC_ID_ADPCM_VIMA
@ AV_CODEC_ID_ADPCM_VIMA
Definition: avcodec.h:533
AV_CODEC_ID_ADPCM_IMA_DK4
@ AV_CODEC_ID_ADPCM_IMA_DK4
Definition: avcodec.h:506
AVCodecContext::bit_rate
int64_t bit_rate
the average bitrate
Definition: avcodec.h:1617
AV_CODEC_ID_G723_1
@ AV_CODEC_ID_G723_1
Definition: avcodec.h:617
AVPacketSideData::type
enum AVPacketSideDataType type
Definition: avcodec.h:1424
AVCodecParser::split
int(* split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size)
Definition: avcodec.h:5288
AV_CODEC_ID_CINEPAK
@ AV_CODEC_ID_CINEPAK
Definition: avcodec.h:261
AV_CODEC_ID_PGMYUV
@ AV_CODEC_ID_PGMYUV
Definition: avcodec.h:283
AV_CODEC_ID_DVD_SUBTITLE
@ AV_CODEC_ID_DVD_SUBTITLE
Definition: avcodec.h:659
AV_CODEC_ID_MOTIONPIXELS
@ AV_CODEC_ID_MOTIONPIXELS
Definition: avcodec.h:337
AVBitStreamFilter::close
void(* close)(AVBSFContext *ctx)
Definition: avcodec.h:5846
AV_CODEC_ID_CPIA
@ AV_CODEC_ID_CPIA
Definition: avcodec.h:425
AVHWAccel::end_frame
int(* end_frame)(AVCodecContext *avctx)
Called at the end of each frame or field picture.
Definition: avcodec.h:3752
AV_CODEC_ID_SMV
@ AV_CODEC_ID_SMV
Definition: avcodec.h:638
AVCodecContext::subtitle_header_size
int subtitle_header_size
Definition: avcodec.h:3053
AVSubtitleRect::data
uint8_t * data[4]
data+linesize for the bitmap of this subtitle.
Definition: avcodec.h:3918
AV_CODEC_ID_PCM_S64BE
@ AV_CODEC_ID_PCM_S64BE
Definition: avcodec.h:497
AV_CODEC_ID_ZLIB
@ AV_CODEC_ID_ZLIB
Definition: avcodec.h:272
AVCodec::profiles
const AVProfile * profiles
array of recognized profiles, or NULL if unknown, array is terminated by {FF_PROFILE_UNKNOWN}
Definition: avcodec.h:3510
AV_CODEC_ID_SPEEDHQ
@ AV_CODEC_ID_SPEEDHQ
Definition: avcodec.h:439
AV_CODEC_ID_FMVC
@ AV_CODEC_ID_FMVC
Definition: avcodec.h:440
AVCodecContext::trailing_padding
int trailing_padding
Audio only.
Definition: avcodec.h:3286
av_codec_get_pkt_timebase
attribute_deprecated AVRational av_codec_get_pkt_timebase(const AVCodecContext *avctx)
Accessors for some AVCodecContext fields.
avcodec_get_context_defaults3
int avcodec_get_context_defaults3(AVCodecContext *s, const AVCodec *codec)
AVBitStreamFilter::priv_class
const AVClass * priv_class
A class for the private data, used to declare bitstream filter private AVOptions.
Definition: avcodec.h:5833
AVCodecContext::ildct_cmp
int ildct_cmp
interlaced DCT comparison function
Definition: avcodec.h:1971
AVCodecContext::b_frame_strategy
attribute_deprecated int b_frame_strategy
Definition: avcodec.h:1841
AVCodecContext::noise_reduction
attribute_deprecated int noise_reduction
Definition: avcodec.h:2085
avcodec_license
const char * avcodec_license(void)
Return the libavcodec license.
AV_CODEC_ID_MPEG2TS
@ AV_CODEC_ID_MPEG2TS
FAKE codec to indicate a raw MPEG-2 TS stream (only used by libavformat)
Definition: avcodec.h:704
AV_CODEC_ID_ADPCM_IMA_AMV
@ AV_CODEC_ID_ADPCM_IMA_AMV
Definition: avcodec.h:522
AV_CODEC_ID_ANM
@ AV_CODEC_ID_ANM
Definition: avcodec.h:352
AVCodecContext::rc_min_vbv_overflow_use
float rc_min_vbv_overflow_use
Ratecontrol attempt to use, at least, times the amount needed to prevent a vbv overflow.
Definition: avcodec.h:2466
avcodec_open2
int avcodec_open2(AVCodecContext *avctx, const AVCodec *codec, AVDictionary **options)
Initialize the AVCodecContext to use the given AVCodec.
AVCodecParserContext::flags
int flags
Definition: avcodec.h:5143
avcodec_version
unsigned avcodec_version(void)
Return the LIBAVCODEC_VERSION_INT constant.
AV_AUDIO_SERVICE_TYPE_MAIN
@ AV_AUDIO_SERVICE_TYPE_MAIN
Definition: avcodec.h:816
AVCodecContext::me_cmp
int me_cmp
motion estimation comparison function
Definition: avcodec.h:1953
AV_CODEC_ID_ROQ_DPCM
@ AV_CODEC_ID_ROQ_DPCM
Definition: avcodec.h:556
AVCodecParserContext::picture_structure
enum AVPictureStructure picture_structure
Indicate whether a picture is coded as a frame, top field or bottom field.
Definition: avcodec.h:5244
AVCodecContext::context_model
attribute_deprecated int context_model
Definition: avcodec.h:2490
AV_CODEC_ID_FLASHSV
@ AV_CODEC_ID_FLASHSV
Definition: avcodec.h:304
AVCodecContext::trellis
int trellis
trellis RD quantization
Definition: avcodec.h:2516
AVProfile::profile
int profile
Definition: avcodec.h:3417
AV_CODEC_ID_SMPTE_KLV
@ AV_CODEC_ID_SMPTE_KLV
Definition: avcodec.h:696
AVCodec::receive_packet
int(* receive_packet)(AVCodecContext *avctx, AVPacket *avpkt)
Definition: avcodec.h:3592
AV_CODEC_ID_QDM2
@ AV_CODEC_ID_QDM2
Definition: avcodec.h:584
AV_CODEC_ID_WMV1
@ AV_CODEC_ID_WMV1
Definition: avcodec.h:235
AV_PKT_DATA_SUBTITLE_POSITION
@ AV_PKT_DATA_SUBTITLE_POSITION
Subtitle event position.
Definition: avcodec.h:1328
AVCodec::init
int(* init)(AVCodecContext *)
Definition: avcodec.h:3566
av_packet_ref
int av_packet_ref(AVPacket *dst, const AVPacket *src)
Setup a new reference to the data described by a given packet.
AV_CODEC_ID_FIRST_UNKNOWN
@ AV_CODEC_ID_FIRST_UNKNOWN
A dummy ID pointing at the start of various fake codecs.
Definition: avcodec.h:688
av_packet_move_ref
void av_packet_move_ref(AVPacket *dst, AVPacket *src)
Move every field in src to dst and reset src.
AV_CODEC_ID_VMDVIDEO
@ AV_CODEC_ID_VMDVIDEO
Definition: avcodec.h:270
AV_CODEC_ID_VP6A
@ AV_CODEC_ID_VP6A
Definition: avcodec.h:324
av_cpb_properties_alloc
AVCPBProperties * av_cpb_properties_alloc(size_t *size)
Allocate a CPB properties structure and initialize its fields to default values.
AV_CODEC_ID_VP4
@ AV_CODEC_ID_VP4
Definition: avcodec.h:460
AV_CODEC_ID_MAGICYUV
@ AV_CODEC_ID_MAGICYUV
Definition: avcodec.h:434
AVCodecContext::level
int level
level
Definition: avcodec.h:3020
AV_CODEC_ID_MP4ALS
@ AV_CODEC_ID_MP4ALS
Definition: avcodec.h:610
AVCodecParameters::level
int level
Definition: avcodec.h:4020
AVCodecParameters::sample_rate
int sample_rate
Audio only.
Definition: avcodec.h:4069
AV_CODEC_ID_MPEG1VIDEO
@ AV_CODEC_ID_MPEG1VIDEO
Definition: avcodec.h:219
AV_CODEC_ID_PCM_S24LE_PLANAR
@ AV_CODEC_ID_PCM_S24LE_PLANAR
Definition: avcodec.h:492
AV_CODEC_ID_ADPCM_XA
@ AV_CODEC_ID_ADPCM_XA
Definition: avcodec.h:511
AV_CODEC_ID_CDGRAPHICS
@ AV_CODEC_ID_CDGRAPHICS
Definition: avcodec.h:350
AV_CODEC_ID_VCR1
@ AV_CODEC_ID_VCR1
Definition: avcodec.h:253
avcodec_get_subtitle_rect_class
const AVClass * avcodec_get_subtitle_rect_class(void)
Get the AVClass for AVSubtitleRect.
av_packet_merge_side_data
attribute_deprecated int av_packet_merge_side_data(AVPacket *pkt)
AV_CODEC_ID_GSM
@ AV_CODEC_ID_GSM
as in Berlin toast format
Definition: avcodec.h:583
AVCodecID
AVCodecID
Identify the syntax and semantics of the bitstream.
Definition: avcodec.h:215
AV_CODEC_ID_PCM_VIDC
@ AV_CODEC_ID_PCM_VIDC
Definition: avcodec.h:500
AV_CODEC_ID_EAC3
@ AV_CODEC_ID_EAC3
Definition: avcodec.h:605
AV_CODEC_ID_MJPEGB
@ AV_CODEC_ID_MJPEGB
Definition: avcodec.h:226
AVCodecContext::temporal_cplx_masking
float temporal_cplx_masking
temporary complexity masking (0-> disabled)
Definition: avcodec.h:1893
AVCodecParameters::extradata_size
int extradata_size
Size of the extradata content in bytes.
Definition: avcodec.h:3977
av_register_bitstream_filter
attribute_deprecated void av_register_bitstream_filter(AVBitStreamFilter *bsf)
AV_CODEC_ID_ATRAC3AL
@ AV_CODEC_ID_ATRAC3AL
Definition: avcodec.h:648
AV_AUDIO_SERVICE_TYPE_KARAOKE
@ AV_AUDIO_SERVICE_TYPE_KARAOKE
Definition: avcodec.h:824
AV_CODEC_ID_AAC
@ AV_CODEC_ID_AAC
Definition: avcodec.h:567
avcodec_get_frame_class
const AVClass * avcodec_get_frame_class(void)
Get the AVClass for AVFrame.
AV_CODEC_ID_FRAPS
@ AV_CODEC_ID_FRAPS
Definition: avcodec.h:294
AVCodecContext::qcompress
float qcompress
amount of qscale change between easy & hard scenes (0.0-1.0)
Definition: avcodec.h:2401
AVCodecContext::time_base
AVRational time_base
This is the fundamental unit of time (in seconds) in terms of which frame timestamps are represented.
Definition: avcodec.h:1690
AV_CODEC_ID_LSCR
@ AV_CODEC_ID_LSCR
Definition: avcodec.h:459
AV_CODEC_ID_WCMV
@ AV_CODEC_ID_WCMV
Definition: avcodec.h:454
AVCodecContext::lowres
int lowres
low resolution decoding, 1-> 1/2 size, 2->1/4 size
Definition: avcodec.h:2806
AV_CODEC_ID_QCELP
@ AV_CODEC_ID_QCELP
Definition: avcodec.h:589
av_get_bits_per_sample
int av_get_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
AV_CODEC_ID_INDEO2
@ AV_CODEC_ID_INDEO2
Definition: avcodec.h:293
AVCodecContext::stats_out
char * stats_out
pass1 encoding statistics output buffer
Definition: avcodec.h:2586
AV_CODEC_ID_SSA
@ AV_CODEC_ID_SSA
Definition: avcodec.h:663
AV_CODEC_ID_FFV1
@ AV_CODEC_ID_FFV1
Definition: avcodec.h:251
AVDISCARD_NONKEY
@ AVDISCARD_NONKEY
discard all frames except keyframes
Definition: avcodec.h:811
AV_CODEC_ID_PAM
@ AV_CODEC_ID_PAM
Definition: avcodec.h:284
av_packet_from_data
int av_packet_from_data(AVPacket *pkt, uint8_t *data, int size)
Initialize a reference-counted packet from av_malloc()ed data.
AVCodecContext::rc_override
RcOverride * rc_override
Definition: avcodec.h:2438
AV_CODEC_ID_PCM_S24LE
@ AV_CODEC_ID_PCM_S24LE
Definition: avcodec.h:476
AV_CODEC_ID_ROQ
@ AV_CODEC_ID_ROQ
Definition: avcodec.h:256
AVCodecContext::vbv_delay
attribute_deprecated uint64_t vbv_delay
VBV delay coded in the last frame (in periods of a 27 MHz clock).
Definition: avcodec.h:3065
AVCodecContext::flags2
int flags2
AV_CODEC_FLAG2_*.
Definition: avcodec.h:1654
AV_CODEC_ID_CLJR
@ AV_CODEC_ID_CLJR
Definition: avcodec.h:254
AV_CODEC_ID_OTF
@ AV_CODEC_ID_OTF
Definition: avcodec.h:695
AV_CODEC_ID_SCPR
@ AV_CODEC_ID_SCPR
Definition: avcodec.h:441
AVMediaType
AVMediaType
Definition: avutil.h:199
av_codec_set_lowres
attribute_deprecated void av_codec_set_lowres(AVCodecContext *avctx, int val)
av_bsf_list_free
void av_bsf_list_free(AVBSFList **lst)
Free list of bitstream filters.
AVCodecParserContext::frame_offset
int64_t frame_offset
Definition: avcodec.h:5113
AV_CODEC_ID_ADPCM_ADX
@ AV_CODEC_ID_ADPCM_ADX
Definition: avcodec.h:512
AVPacket::size
int size
Definition: avcodec.h:1479
AVCodecContext::gop_size
int gop_size
the number of pictures in a group of pictures, or 0 for intra_only
Definition: avcodec.h:1762
AV_CODEC_ID_IDF
@ AV_CODEC_ID_IDF
Definition: avcodec.h:694
av_bsf_flush
void av_bsf_flush(AVBSFContext *ctx)
Reset the internal bitstream filter state / flush internal buffers.
AVDISCARD_DEFAULT
@ AVDISCARD_DEFAULT
discard useless packets like 0 size packets in avi
Definition: avcodec.h:807
AVCodecContext::extra_hw_frames
int extra_hw_frames
Definition: avcodec.h:3366
av_bsf_list_parse_str
int av_bsf_list_parse_str(const char *str, AVBSFContext **bsf)
Parse string describing list of bitstream filters and create single AVBSFContext describing the whole...
AV_CODEC_ID_YLC
@ AV_CODEC_ID_YLC
Definition: avcodec.h:436
AV_CODEC_ID_ADPCM_IMA_RAD
@ AV_CODEC_ID_ADPCM_IMA_RAD
Definition: avcodec.h:538
av_bsf_next
const attribute_deprecated AVBitStreamFilter * av_bsf_next(void **opaque)
cpu.h
AV_CODEC_ID_DSD_MSBF
@ AV_CODEC_ID_DSD_MSBF
Definition: avcodec.h:640
AVCodecParserContext::next_frame_offset
int64_t next_frame_offset
Definition: avcodec.h:5116
av_get_profile_name
const char * av_get_profile_name(const AVCodec *codec, int profile)
Return a name for the specified profile, if available.
AV_CODEC_ID_RASC
@ AV_CODEC_ID_RASC
Definition: avcodec.h:455
AVCodecParserContext::cur_frame_offset
int64_t cur_frame_offset[AV_PARSER_PTS_NB]
Definition: avcodec.h:5139
height
static int height
Definition: demuxing_decoding.c:39
AV_CODEC_ID_DXV
@ AV_CODEC_ID_DXV
Definition: avcodec.h:409
AV_CODEC_ID_DTS
@ AV_CODEC_ID_DTS
Definition: avcodec.h:569
AVCodecContext::frame_skip_exp
attribute_deprecated int frame_skip_exp
Definition: avcodec.h:2504
AVCodecContext::sample_fmt
enum AVSampleFormat sample_fmt
audio sample format
Definition: avcodec.h:2235
AVCodecContext::pkt_timebase
AVRational pkt_timebase
Timebase in which pkt_dts/pts and AVPacket.dts/pts are.
Definition: avcodec.h:3121
AV_CODEC_ID_AYUV
@ AV_CODEC_ID_AYUV
Definition: avcodec.h:419
AV_CODEC_ID_H263
@ AV_CODEC_ID_H263
Definition: avcodec.h:222
AVCodec::defaults
const AVCodecDefault * defaults
Private codec-specific defaults.
Definition: avcodec.h:3556
AV_CODEC_ID_ADPCM_SWF
@ AV_CODEC_ID_ADPCM_SWF
Definition: avcodec.h:516
avcodec_find_best_pix_fmt2
attribute_deprecated enum AVPixelFormat avcodec_find_best_pix_fmt2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2, enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
AV_CODEC_ID_SMVJPEG
@ AV_CODEC_ID_SMVJPEG
Definition: avcodec.h:428
AV_CODEC_ID_V408
@ AV_CODEC_ID_V408
Definition: avcodec.h:422
AVCodecParserContext::width
int width
Dimensions of the decoded video intended for presentation.
Definition: avcodec.h:5257
AV_NUM_DATA_POINTERS
#define AV_NUM_DATA_POINTERS
Definition: frame.h:296
AV_CODEC_ID_BINTEXT
@ AV_CODEC_ID_BINTEXT
Definition: avcodec.h:692
AV_CODEC_ID_QDMC
@ AV_CODEC_ID_QDMC
Definition: avcodec.h:615
AV_CODEC_ID_V210
@ AV_CODEC_ID_V210
Definition: avcodec.h:345
AVCodecContext::rtp_payload_size
attribute_deprecated int rtp_payload_size
Definition: avcodec.h:2549
AVCodecContext::me_range
int me_range
maximum motion estimation search range in subpel units If 0 then no limit.
Definition: avcodec.h:2038
AVCodecParser::parser_parse
int(* parser_parse)(AVCodecParserContext *s, AVCodecContext *avctx, const uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size)
Definition: avcodec.h:5283
AVCodecParameters::profile
int profile
Codec-specific bitstream restrictions that the stream conforms to.
Definition: avcodec.h:4019
AV_CODEC_ID_MSRLE
@ AV_CODEC_ID_MSRLE
Definition: avcodec.h:263
AV_CODEC_ID_CYUV
@ AV_CODEC_ID_CYUV
Definition: avcodec.h:244
AV_CODEC_ID_PCX
@ AV_CODEC_ID_PCX
Definition: avcodec.h:327
AV_CODEC_ID_OPUS
@ AV_CODEC_ID_OPUS
Definition: avcodec.h:625
AVCodecContext::skip_alpha
int skip_alpha
Skip processing alpha if supported by codec.
Definition: avcodec.h:3180
AVCodecContext::chroma_intra_matrix
uint16_t * chroma_intra_matrix
custom intra quantization matrix
Definition: avcodec.h:3206
AVCodecContext::skip_bottom
int skip_bottom
Number of macroblock rows at the bottom which are skipped.
Definition: avcodec.h:2107
AVCodecContext::last_predictor_count
int last_predictor_count
amount of previous MV predictors (2a+1 x 2a+1 square)
Definition: avcodec.h:2002
AV_PKT_DATA_H263_MB_INFO
@ AV_PKT_DATA_H263_MB_INFO
An AV_PKT_DATA_H263_MB_INFO side data packet contains a number of structures with info about macroblo...
Definition: avcodec.h:1238
av_codec_get_chroma_intra_matrix
attribute_deprecated uint16_t * av_codec_get_chroma_intra_matrix(const AVCodecContext *avctx)
AVSubtitle::end_display_time
uint32_t end_display_time
Definition: avcodec.h:3938
AV_CODEC_ID_8BPS
@ AV_CODEC_ID_8BPS
Definition: avcodec.h:266
frame.h
AVCodec::init_static_data
void(* init_static_data)(struct AVCodec *codec)
Initialize codec static data, called from avcodec_register().
Definition: avcodec.h:3564
AVSubtitleRect::type
enum AVSubtitleType type
Definition: avcodec.h:3921
SUBTITLE_TEXT
@ SUBTITLE_TEXT
Plain text, the text field must be set by the decoder and is authoritative.
Definition: avcodec.h:3889
AVCodec::send_frame
int(* send_frame)(AVCodecContext *avctx, const AVFrame *frame)
Encode API with decoupled packet/frame dataflow.
Definition: avcodec.h:3591
buffer.h
attribute_deprecated
#define attribute_deprecated
Definition: attributes.h:98
avcodec_find_decoder
AVCodec * avcodec_find_decoder(enum AVCodecID id)
Find a registered decoder with a matching codec ID.
SUBTITLE_NONE
@ SUBTITLE_NONE
Definition: avcodec.h:3881
AVPacket::dts
int64_t dts
Decompression timestamp in AVStream->time_base units; the time at which the packet is decompressed.
Definition: avcodec.h:1477
AV_CODEC_ID_COMFORT_NOISE
@ AV_CODEC_ID_COMFORT_NOISE
Definition: avcodec.h:626
encode
static void encode(AVCodecContext *ctx, AVFrame *frame, AVPacket *pkt, FILE *output)
Definition: encode_audio.c:95
AVCodecContext::me_sub_cmp
int me_sub_cmp
subpixel motion estimation comparison function
Definition: avcodec.h:1959
AVCodecContext::pts_correction_num_faulty_dts
int64_t pts_correction_num_faulty_dts
Number of incorrect PTS values so far.
Definition: avcodec.h:3145
av_register_codec_parser
attribute_deprecated void av_register_codec_parser(AVCodecParser *parser)
AVCodecContext::coder_type
attribute_deprecated int coder_type
Definition: avcodec.h:2484
AV_CODEC_ID_IMM4
@ AV_CODEC_ID_IMM4
Definition: avcodec.h:451
AVCodecContext::pts_correction_last_pts
int64_t pts_correction_last_pts
Number of incorrect DTS values so far.
Definition: avcodec.h:3146
AV_CODEC_ID_QPEG
@ AV_CODEC_ID_QPEG
Definition: avcodec.h:278
avcodec_find_best_pix_fmt_of_2
enum AVPixelFormat avcodec_find_best_pix_fmt_of_2(enum AVPixelFormat dst_pix_fmt1, enum AVPixelFormat dst_pix_fmt2, enum AVPixelFormat src_pix_fmt, int has_alpha, int *loss_ptr)
AVPacketSideData::size
int size
Definition: avcodec.h:1423
AVCPBProperties::max_bitrate
int max_bitrate
Maximum bitrate of the stream, in bits per second.
Definition: avcodec.h:1135
AV_FIELD_TT
@ AV_FIELD_TT
Definition: avcodec.h:1548
AV_CODEC_ID_RV30
@ AV_CODEC_ID_RV30
Definition: avcodec.h:286
width
static int width
Definition: demuxing_decoding.c:39
avcodec_default_execute
int avcodec_default_execute(AVCodecContext *c, int(*func)(AVCodecContext *c2, void *arg2), void *arg, int *ret, int count, int size)
AVCodecContext::request_sample_fmt
enum AVSampleFormat request_sample_fmt
desired sample format
Definition: avcodec.h:2300
AVPacketSideDataType
AVPacketSideDataType
Definition: avcodec.h:1185
av_bsf_list_finalize
int av_bsf_list_finalize(AVBSFList **lst, AVBSFContext **bsf)
Finalize list of bitstream filters.
av_picture_pad
attribute_deprecated int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width, enum AVPixelFormat pix_fmt, int padtop, int padbottom, int padleft, int padright, int *color)
avcodec_encode_video2
attribute_deprecated int avcodec_encode_video2(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode a frame of video.
attributes.h
AV_PKT_DATA_CONTENT_LIGHT_LEVEL
@ AV_PKT_DATA_CONTENT_LIGHT_LEVEL
Content light level (based on CTA-861.3).
Definition: avcodec.h:1380
AV_CODEC_ID_MMVIDEO
@ AV_CODEC_ID_MMVIDEO
Definition: avcodec.h:298
av_packet_make_refcounted
int av_packet_make_refcounted(AVPacket *pkt)
Ensure the data described by a given packet is reference counted.
AVPacket::flags
int flags
A combination of AV_PKT_FLAG values.
Definition: avcodec.h:1484
av_packet_alloc
AVPacket * av_packet_alloc(void)
Allocate an AVPacket and set its fields to default values.
AV_CODEC_ID_QDRAW
@ AV_CODEC_ID_QDRAW
Definition: avcodec.h:276
AV_CODEC_ID_V210X
@ AV_CODEC_ID_V210X
Definition: avcodec.h:343
AVCodecContext::skip_loop_filter
enum AVDiscard skip_loop_filter
Skip loop filtering for selected frames.
Definition: avcodec.h:3028
av_packet_unpack_dictionary
int av_packet_unpack_dictionary(const uint8_t *data, int size, AVDictionary **dict)
Unpack a dictionary from side_data.
AV_CODEC_ID_BITPACKED
@ AV_CODEC_ID_BITPACKED
Definition: avcodec.h:445
AV_CODEC_ID_XPM
@ AV_CODEC_ID_XPM
Definition: avcodec.h:443
AV_CODEC_ID_DXA
@ AV_CODEC_ID_DXA
Definition: avcodec.h:316
AV_CODEC_ID_SVG
@ AV_CODEC_ID_SVG
Definition: avcodec.h:448
AV_CODEC_ID_INDEO4
@ AV_CODEC_ID_INDEO4
Definition: avcodec.h:329
av_packet_rescale_ts
void av_packet_rescale_ts(AVPacket *pkt, AVRational tb_src, AVRational tb_dst)
Convert valid timing fields (timestamps / durations) in a packet from one timebase to another.
AVCodecContext::i_count
attribute_deprecated int i_count
Definition: avcodec.h:2568
AVCodecDefault
struct AVCodecDefault AVCodecDefault
Definition: avcodec.h:3476
av_hwaccel_next
attribute_deprecated AVHWAccel * av_hwaccel_next(const AVHWAccel *hwaccel)
If hwaccel is NULL, returns the first registered hardware accelerator, if hwaccel is non-NULL,...
AV_CODEC_ID_SVQ1
@ AV_CODEC_ID_SVQ1
Definition: avcodec.h:240
AV_LOCK_CREATE
@ AV_LOCK_CREATE
Create a mutex.
Definition: avcodec.h:6132
avpicture_free
attribute_deprecated void avpicture_free(AVPicture *picture)
AV_PKT_DATA_METADATA_UPDATE
@ AV_PKT_DATA_METADATA_UPDATE
A list of zero terminated key/value strings.
Definition: avcodec.h:1354
frame
static AVFrame * frame
Definition: demuxing_decoding.c:53
SUBTITLE_BITMAP
@ SUBTITLE_BITMAP
A bitmap, pict will be set.
Definition: avcodec.h:3883
AV_CODEC_ID_TSCC2
@ AV_CODEC_ID_TSCC2
Definition: avcodec.h:382
av_picture_crop
attribute_deprecated int av_picture_crop(AVPicture *dst, const AVPicture *src, enum AVPixelFormat pix_fmt, int top_band, int left_band)
AVCodecContext::b_quant_factor
float b_quant_factor
qscale factor between IP and B-frames If > 0 then the last P-frame quantizer will be used (q= lastp_q...
Definition: avcodec.h:1836
AV_CODEC_ID_ASV1
@ AV_CODEC_ID_ASV1
Definition: avcodec.h:249
AVCodecParserContext::cur_frame_pts
int64_t cur_frame_pts[AV_PARSER_PTS_NB]
Definition: avcodec.h:5140
AV_CODEC_ID_MSS2
@ AV_CODEC_ID_MSS2
Definition: avcodec.h:385
AVCodecContext::channels
int channels
number of audio channels
Definition: avcodec.h:2228
AVCodec::encode2
int(* encode2)(AVCodecContext *avctx, AVPacket *avpkt, const AVFrame *frame, int *got_packet_ptr)
Encode data to an AVPacket.
Definition: avcodec.h:3579
AVChromaLocation
AVChromaLocation
Location of chroma samples.
Definition: pixfmt.h:703
AVCodec::id
enum AVCodecID id
Definition: avcodec.h:3497
AVCodecParserContext::cur_frame_pos
int64_t cur_frame_pos[AV_PARSER_PTS_NB]
Position of the packet in file.
Definition: avcodec.h:5215
AV_CODEC_ID_HQ_HQA
@ AV_CODEC_ID_HQ_HQA
Definition: avcodec.h:406
AV_CODEC_ID_VP5
@ AV_CODEC_ID_VP5
Definition: avcodec.h:308
AVHWAccel::name
const char * name
Name of the hardware accelerated codec.
Definition: avcodec.h:3657
AV_CODEC_ID_XAN_WC3
@ AV_CODEC_ID_XAN_WC3
Definition: avcodec.h:258
avcodec_parameters_alloc
AVCodecParameters * avcodec_parameters_alloc(void)
Allocate a new AVCodecParameters and set its fields to default values (unknown/invalid/0).
AV_CODEC_ID_STL
@ AV_CODEC_ID_STL
Definition: avcodec.h:674
AVCPBProperties::vbv_delay
uint64_t vbv_delay
The delay between the time the packet this structure is associated with is received and the time when...
Definition: avcodec.h:1171
AV_CODEC_ID_VP3
@ AV_CODEC_ID_VP3
Definition: avcodec.h:247
AV_CODEC_ID_GIF
@ AV_CODEC_ID_GIF
Definition: avcodec.h:315
AV_LOCK_DESTROY
@ AV_LOCK_DESTROY
Free mutex resources.
Definition: avcodec.h:6135
AV_CODEC_ID_TGV
@ AV_CODEC_ID_TGV
Definition: avcodec.h:338
AV_CODEC_ID_MJPEG
@ AV_CODEC_ID_MJPEG
Definition: avcodec.h:225
AV_CODEC_ID_VP7
@ AV_CODEC_ID_VP7
Definition: avcodec.h:399
AVSubtitleRect::flags
int flags
Definition: avcodec.h:3932
AVCodecContext::bits_per_coded_sample
int bits_per_coded_sample
bits per sample/pixel from the demuxer (needed for huffyuv).
Definition: avcodec.h:2791
avcodec_default_get_buffer2
int avcodec_default_get_buffer2(AVCodecContext *s, AVFrame *frame, int flags)
The default callback for AVCodecContext.get_buffer2().
avcodec_send_packet
int avcodec_send_packet(AVCodecContext *avctx, const AVPacket *avpkt)
Supply raw packet data as input to a decoder.
AV_PKT_DATA_JP_DUALMONO
@ AV_PKT_DATA_JP_DUALMONO
An AV_PKT_DATA_JP_DUALMONO side data packet indicates that the packet may contain "dual mono" audio s...
Definition: avcodec.h:1311
AVCodecContext::timecode_frame_start
attribute_deprecated int64_t timecode_frame_start
Definition: avcodec.h:2529
AV_CODEC_ID_ATRAC1
@ AV_CODEC_ID_ATRAC1
Definition: avcodec.h:611
AV_CODEC_ID_HQX
@ AV_CODEC_ID_HQX
Definition: avcodec.h:404
av_packet_copy_props
int av_packet_copy_props(AVPacket *dst, const AVPacket *src)
Copy only "properties" fields from src to dst.
AV_CODEC_ID_RA_288
@ AV_CODEC_ID_RA_288
Definition: avcodec.h:553
AV_CODEC_ID_ADPCM_MTAF
@ AV_CODEC_ID_ADPCM_MTAF
Definition: avcodec.h:544
AV_CODEC_ID_ADPCM_EA_MAXIS_XA
@ AV_CODEC_ID_ADPCM_EA_MAXIS_XA
Definition: avcodec.h:529
AV_CODEC_ID_RV40
@ AV_CODEC_ID_RV40
Definition: avcodec.h:287
AV_CODEC_ID_RV10
@ AV_CODEC_ID_RV10
Definition: avcodec.h:223
AVCodecParserContext::pos
int64_t pos
Byte position of currently parsed frame in stream.
Definition: avcodec.h:5220
AVCodecContext::b_sensitivity
attribute_deprecated int b_sensitivity
Definition: avcodec.h:2173
AVSubtitle::format
uint16_t format
Definition: avcodec.h:3936
AV_CODEC_ID_FIRST_AUDIO
@ AV_CODEC_ID_FIRST_AUDIO
A dummy id pointing at the start of audio codecs.
Definition: avcodec.h:463
AVDISCARD_NONINTRA
@ AVDISCARD_NONINTRA
discard all non intra frames
Definition: avcodec.h:810
log.h
AV_CODEC_ID_NONE
@ AV_CODEC_ID_NONE
Definition: avcodec.h:216
AVPacket::pts
int64_t pts
Presentation timestamp in AVStream->time_base units; the time at which the decompressed packet will b...
Definition: avcodec.h:1471
RcOverride::end_frame
int end_frame
Definition: avcodec.h:833
AVCodecContext::properties
unsigned properties
Properties of the stream that gets decoded.
Definition: avcodec.h:3229
AV_CODEC_ID_MTS2
@ AV_CODEC_ID_MTS2
Definition: avcodec.h:383
AV_CODEC_ID_PJS
@ AV_CODEC_ID_PJS
Definition: avcodec.h:681
avcodec_register
attribute_deprecated void avcodec_register(AVCodec *codec)
Register the codec codec and initialize libavcodec.
AVCodecContext::extradata
uint8_t * extradata
some codecs need / can use extradata like Huffman tables.
Definition: avcodec.h:1668
AVSubtitleRect::nb_colors
int nb_colors
number of colors in pict, undefined when pict is not set
Definition: avcodec.h:3905
AVHWAccel::decode_slice
int(* decode_slice)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size)
Callback for each slice.
Definition: avcodec.h:3741
AV_CODEC_ID_AVS
@ AV_CODEC_ID_AVS
Definition: avcodec.h:300
AV_CODEC_ID_ASV2
@ AV_CODEC_ID_ASV2
Definition: avcodec.h:250
av_codec_next
attribute_deprecated AVCodec * av_codec_next(const AVCodec *c)
If c is NULL, returns the first registered codec, if c is non-NULL, returns the next registered codec...
AV_CODEC_ID_THEORA
@ AV_CODEC_ID_THEORA
Definition: avcodec.h:248
AVCodecContext::rtp_callback
attribute_deprecated void(* rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb)
Definition: avcodec.h:2543
avcodec_descriptor_get
const AVCodecDescriptor * avcodec_descriptor_get(enum AVCodecID id)
AV_CODEC_ID_EVRC
@ AV_CODEC_ID_EVRC
Definition: avcodec.h:637
AVCodecParameters::height
int height
Definition: avcodec.h:4026
avcodec_parameters_to_context
int avcodec_parameters_to_context(AVCodecContext *codec, const AVCodecParameters *par)
Fill the codec context based on the values from the supplied codec parameters.
AV_CODEC_ID_FRWU
@ AV_CODEC_ID_FRWU
Definition: avcodec.h:348
AV_AUDIO_SERVICE_TYPE_HEARING_IMPAIRED
@ AV_AUDIO_SERVICE_TYPE_HEARING_IMPAIRED
Definition: avcodec.h:819
AV_CODEC_ID_SUBRIP
@ AV_CODEC_ID_SUBRIP
Definition: avcodec.h:677
AVCodecParameters::block_align
int block_align
Audio only.
Definition: avcodec.h:4076
AV_CODEC_ID_TTML
@ AV_CODEC_ID_TTML
Definition: avcodec.h:684
AV_CODEC_ID_SAMI
@ AV_CODEC_ID_SAMI
Definition: avcodec.h:672
av_codec_get_lowres
attribute_deprecated int av_codec_get_lowres(const AVCodecContext *avctx)
AVCodecContext::intra_dc_precision
int intra_dc_precision
precision of the intra DC coefficient - 8
Definition: avcodec.h:2093
avcodec_decode_video2
attribute_deprecated int avcodec_decode_video2(AVCodecContext *avctx, AVFrame *picture, int *got_picture_ptr, const AVPacket *avpkt)
Decode the video frame of size avpkt->size from avpkt->data into picture.
AV_CODEC_ID_CAVS
@ AV_CODEC_ID_CAVS
Definition: avcodec.h:305
AVColorSpace
AVColorSpace
YUV colorspace type.
Definition: pixfmt.h:610
AV_AUDIO_SERVICE_TYPE_EFFECTS
@ AV_AUDIO_SERVICE_TYPE_EFFECTS
Definition: avcodec.h:817
AVCodecContext::cutoff
int cutoff
Audio cutoff bandwidth (0 means "automatic")
Definition: avcodec.h:2271
AVCodecContext::frame_skip_cmp
attribute_deprecated int frame_skip_cmp
Definition: avcodec.h:2508
AVCodecContext::hwaccel_flags
int hwaccel_flags
Bit set of AV_HWACCEL_FLAG_* flags, which affect hardware accelerated decoding (if active).
Definition: avcodec.h:3325
AV_CODEC_ID_DSD_LSBF_PLANAR
@ AV_CODEC_ID_DSD_LSBF_PLANAR
Definition: avcodec.h:641
AVCodecParserContext::cur_offset
int64_t cur_offset
Definition: avcodec.h:5114
AV_CODEC_ID_FIRST_SUBTITLE
@ AV_CODEC_ID_FIRST_SUBTITLE
A dummy ID pointing at the start of subtitle codecs.
Definition: avcodec.h:658
AV_CODEC_ID_BMV_AUDIO
@ AV_CODEC_ID_BMV_AUDIO
Definition: avcodec.h:621
AV_PKT_DATA_A53_CC
@ AV_PKT_DATA_A53_CC
ATSC A53 Part 4 Closed Captions.
Definition: avcodec.h:1387
AVSampleFormat
AVSampleFormat
Audio sample formats.
Definition: samplefmt.h:58
AV_CODEC_ID_PAF_VIDEO
@ AV_CODEC_ID_PAF_VIDEO
Definition: avcodec.h:397
AV_CODEC_ID_FIC
@ AV_CODEC_ID_FIC
Definition: avcodec.h:394
AV_CODEC_ID_PCM_F64BE
@ AV_CODEC_ID_PCM_F64BE
Definition: avcodec.h:486
av_fast_padded_malloc
void av_fast_padded_malloc(void *ptr, unsigned int *size, size_t min_size)
Same behaviour av_fast_malloc but the buffer has additional AV_INPUT_BUFFER_PADDING_SIZE at the end w...
AVCodecParser::parser_init
int(* parser_init)(AVCodecParserContext *s)
Definition: avcodec.h:5280
AVCodecContext::pts_correction_last_dts
int64_t pts_correction_last_dts
PTS of the last frame.
Definition: avcodec.h:3147
AV_CODEC_ID_RV20
@ AV_CODEC_ID_RV20
Definition: avcodec.h:224
AV_CODEC_ID_HEVC
@ AV_CODEC_ID_HEVC
Definition: avcodec.h:392
AVCodecContext::dia_size
int dia_size
ME diamond size & shape.
Definition: avcodec.h:1995
AV_CODEC_ID_KGV1
@ AV_CODEC_ID_KGV1
Definition: avcodec.h:356
AVCodecContext::dump_separator
uint8_t * dump_separator
dump format separator.
Definition: avcodec.h:3214
AVCodecContext::header_bits
attribute_deprecated int header_bits
Definition: avcodec.h:2562
AV_CODEC_ID_A64_MULTI5
@ AV_CODEC_ID_A64_MULTI5
Definition: avcodec.h:362
AV_CODEC_ID_HNM4_VIDEO
@ AV_CODEC_ID_HNM4_VIDEO
Definition: avcodec.h:391
AV_CODEC_ID_DVVIDEO
@ AV_CODEC_ID_DVVIDEO
Definition: avcodec.h:242
AV_CODEC_ID_PCM_S32BE
@ AV_CODEC_ID_PCM_S32BE
Definition: avcodec.h:473
AVBitStreamFilter::filter
int(* filter)(AVBSFContext *ctx, AVPacket *pkt)
Definition: avcodec.h:5845
AV_CODEC_ID_CMV
@ AV_CODEC_ID_CMV
Definition: avcodec.h:336
AV_CODEC_ID_CLLC
@ AV_CODEC_ID_CLLC
Definition: avcodec.h:384
AV_CODEC_ID_DSS_SP
@ AV_CODEC_ID_DSS_SP
Definition: avcodec.h:631
AVCodecContext::mb_lmin
int mb_lmin
minimum MB Lagrange multiplier
Definition: avcodec.h:2114
AV_CODEC_ID_C93
@ AV_CODEC_ID_C93
Definition: avcodec.h:320
av_get_audio_frame_duration
int av_get_audio_frame_duration(AVCodecContext *avctx, int frame_bytes)
Return audio frame duration.
AVSubtitleRect::pict
attribute_deprecated AVPicture pict
Definition: avcodec.h:3912
AVCodecContext::idct_algo
int idct_algo
IDCT algorithm, see FF_IDCT_* below.
Definition: avcodec.h:2770
AVCodec::name
const char * name
Name of the codec implementation.
Definition: avcodec.h:3490
AVCodecContext::hw_device_ctx
AVBufferRef * hw_device_ctx
A reference to the AVHWDeviceContext describing the device which will be used by a hardware encoder/d...
Definition: avcodec.h:3316
AV_CODEC_ID_VC1
@ AV_CODEC_ID_VC1
Definition: avcodec.h:288
AV_PKT_DATA_CPB_PROPERTIES
@ AV_PKT_DATA_CPB_PROPERTIES
This side data corresponds to the AVCPBProperties struct.
Definition: avcodec.h:1290
AV_PKT_DATA_SKIP_SAMPLES
@ AV_PKT_DATA_SKIP_SAMPLES
Recommmends skipping the specified number of samples.
Definition: avcodec.h:1301
AVCodecContext::chroma_sample_location
enum AVChromaLocation chroma_sample_location
This defines the location of chroma samples.
Definition: avcodec.h:2209
AVCodecParameters::color_range
enum AVColorRange color_range
Video only.
Definition: avcodec.h:4045
AV_CODEC_ID_WEBP
@ AV_CODEC_ID_WEBP
Definition: avcodec.h:390
AV_CODEC_ID_PCM_F16LE
@ AV_CODEC_ID_PCM_F16LE
Definition: avcodec.h:498
AVCodec::decode
int(* decode)(AVCodecContext *, void *outdata, int *outdata_size, AVPacket *avpkt)
Definition: avcodec.h:3581
AV_CODEC_ID_VIXL
@ AV_CODEC_ID_VIXL
Definition: avcodec.h:277
AV_CODEC_ID_ADPCM_IMA_DAT4
@ AV_CODEC_ID_ADPCM_IMA_DAT4
Definition: avcodec.h:543
AV_CODEC_ID_JPEG2000
@ AV_CODEC_ID_JPEG2000
Definition: avcodec.h:306
av_register_hwaccel
attribute_deprecated void av_register_hwaccel(AVHWAccel *hwaccel)
Register the hardware accelerator hwaccel.
AV_CODEC_ID_METASOUND
@ AV_CODEC_ID_METASOUND
Definition: avcodec.h:628
AV_CODEC_ID_BETHSOFTVID
@ AV_CODEC_ID_BETHSOFTVID
Definition: avcodec.h:321
AVCPBProperties::min_bitrate
int min_bitrate
Minimum bitrate of the stream, in bits per second.
Definition: avcodec.h:1144
AVBSFContext::time_base_out
AVRational time_base_out
The timebase used for the timestamps of the output packets.
Definition: avcodec.h:5811
AVCodecContext::height
int height
Definition: avcodec.h:1740
AV_CODEC_ID_ULTI
@ AV_CODEC_ID_ULTI
Definition: avcodec.h:275
AV_CODEC_ID_XBM
@ AV_CODEC_ID_XBM
Definition: avcodec.h:378
avcodec_send_frame
int avcodec_send_frame(AVCodecContext *avctx, const AVFrame *frame)
Supply a raw video or audio frame to the encoder.
AVCodecContext::pix_fmt
enum AVPixelFormat pix_fmt
Pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:1777
AVBitStreamFilterContext::parser
AVCodecParserContext * parser
Definition: avcodec.h:5743
AV_CODEC_ID_MVC1
@ AV_CODEC_ID_MVC1
Definition: avcodec.h:402
AVCodec::priv_data_size
int priv_data_size
Definition: avcodec.h:3531
av_bitstream_filter_close
attribute_deprecated void av_bitstream_filter_close(AVBitStreamFilterContext *bsf)
av_codec_iterate
const AVCodec * av_codec_iterate(void **opaque)
Iterate over all registered codecs.
AV_CODEC_ID_VPLAYER
@ AV_CODEC_ID_VPLAYER
Definition: avcodec.h:680
AVCodecParameters::field_order
enum AVFieldOrder field_order
Video only.
Definition: avcodec.h:4040
av_get_exact_bits_per_sample
int av_get_exact_bits_per_sample(enum AVCodecID codec_id)
Return codec bits per sample.
AVCodecContext::hw_frames_ctx
AVBufferRef * hw_frames_ctx
A reference to the AVHWFramesContext describing the input (for encoding) or output (decoding) frames.
Definition: avcodec.h:3264
AV_CODEC_ID_XSUB
@ AV_CODEC_ID_XSUB
Definition: avcodec.h:662
AV_CODEC_ID_IAC
@ AV_CODEC_ID_IAC
Definition: avcodec.h:623
AV_CODEC_ID_ADPCM_EA
@ AV_CODEC_ID_ADPCM_EA
Definition: avcodec.h:513
AVCodecParserContext
Definition: avcodec.h:5110
avcodec_get_chroma_sub_sample
attribute_deprecated void avcodec_get_chroma_sub_sample(enum AVPixelFormat pix_fmt, int *h_shift, int *v_shift)
AVCodecContext::sub_charenc_mode
int sub_charenc_mode
Subtitles character encoding mode.
Definition: avcodec.h:3162
AVBSFContext::priv_data
void * priv_data
Opaque filter-specific private data.
Definition: avcodec.h:5786
AV_CODEC_ID_GSM_MS
@ AV_CODEC_ID_GSM_MS
Definition: avcodec.h:595
AV_CODEC_ID_SMACKVIDEO
@ AV_CODEC_ID_SMACKVIDEO
Definition: avcodec.h:301
AVHWAccel::decode_mb
void(* decode_mb)(struct MpegEncContext *s)
Called for every Macroblock in a slice.
Definition: avcodec.h:3772
avcodec_get_hw_frames_parameters
int avcodec_get_hw_frames_parameters(AVCodecContext *avctx, AVBufferRef *device_ref, enum AVPixelFormat hw_pix_fmt, AVBufferRef **out_frames_ref)
Create and return a AVHWFramesContext with values adequate for hardware decoding.
AV_CODEC_HW_CONFIG_METHOD_INTERNAL
@ AV_CODEC_HW_CONFIG_METHOD_INTERNAL
The codec supports this format by some internal method.
Definition: avcodec.h:3445
AV_CODEC_ID_BMV_VIDEO
@ AV_CODEC_ID_BMV_VIDEO
Definition: avcodec.h:372
AVCodec::caps_internal
int caps_internal
Internal codec capabilities.
Definition: avcodec.h:3609
AVSubtitleRect::h
int h
height of pict, undefined when pict is not set
Definition: avcodec.h:3904
AVCodecContext::block_align
int block_align
number of bytes per packet if constant and known or 0 Used by some WAV based audio codecs.
Definition: avcodec.h:2264
pixfmt.h
avcodec_flush_buffers
void avcodec_flush_buffers(AVCodecContext *avctx)
Reset the internal decoder state / flush internal buffers.
AVCodec::hw_configs
const struct AVCodecHWConfigInternal ** hw_configs
Array of pointers to hardware configurations supported by the codec, or NULL if no hardware supported...
Definition: avcodec.h:3624
AVCodecParserContext::coded_height
int coded_height
Definition: avcodec.h:5264
AVCPBProperties::buffer_size
int buffer_size
The size of the buffer to which the ratecontrol is applied, in bits.
Definition: avcodec.h:1162
AVCodecContext::strict_std_compliance
int strict_std_compliance
strictly follow the standard (MPEG-4, ...).
Definition: avcodec.h:2630
avpicture_layout
attribute_deprecated int avpicture_layout(const AVPicture *src, enum AVPixelFormat pix_fmt, int width, int height, unsigned char *dest, int dest_size)
AV_CODEC_ID_AVRP
@ AV_CODEC_ID_AVRP
Definition: avcodec.h:416
AV_CODEC_ID_AIC
@ AV_CODEC_ID_AIC
Definition: avcodec.h:387
AV_CODEC_ID_CSCD
@ AV_CODEC_ID_CSCD
Definition: avcodec.h:297
AVCodecContext::opaque
void * opaque
Private data of the user, can be used to carry app specific stuff.
Definition: avcodec.h:1609
AV_CODEC_ID_WESTWOOD_SND1
@ AV_CODEC_ID_WESTWOOD_SND1
Definition: avcodec.h:582
AVCodecParser::priv_data_size
int priv_data_size
Definition: avcodec.h:5279
dict.h
AVPacket::side_data
AVPacketSideData * side_data
Additional packet data that can be provided by the container.
Definition: avcodec.h:1489
AV_CODEC_ID_TEXT
@ AV_CODEC_ID_TEXT
raw UTF-8 text
Definition: avcodec.h:661
AV_CODEC_ID_JV
@ AV_CODEC_ID_JV
Definition: avcodec.h:367
AVCodecContext::refcounted_frames
attribute_deprecated int refcounted_frames
If non-zero, the decoded audio and video frames returned from avcodec_decode_video2() and avcodec_dec...
Definition: avcodec.h:2398
AV_CODEC_ID_MUSEPACK8
@ AV_CODEC_ID_MUSEPACK8
Definition: avcodec.h:599
AV_CODEC_ID_AGM
@ AV_CODEC_ID_AGM
Definition: avcodec.h:458
AVCodecContext::draw_horiz_band
void(* draw_horiz_band)(struct AVCodecContext *s, const AVFrame *src, int offset[AV_NUM_DATA_POINTERS], int y, int type, int height)
If non NULL, 'draw_horiz_band' is called by the libavcodec decoder to draw a horizontal band.
Definition: avcodec.h:1802
AVCodecParameters::chroma_location
enum AVChromaLocation chroma_location
Definition: avcodec.h:4049
AVCodecContext::scenechange_threshold
attribute_deprecated int scenechange_threshold
Definition: avcodec.h:2081
AV_AUDIO_SERVICE_TYPE_COMMENTARY
@ AV_AUDIO_SERVICE_TYPE_COMMENTARY
Definition: avcodec.h:821
AVCodecParameters::trailing_padding
int trailing_padding
Audio only.
Definition: avcodec.h:4095
AV_CODEC_ID_AMV
@ AV_CODEC_ID_AMV
Definition: avcodec.h:325
av_codec_get_seek_preroll
attribute_deprecated int av_codec_get_seek_preroll(const AVCodecContext *avctx)
AV_CODEC_ID_PROSUMER
@ AV_CODEC_ID_PROSUMER
Definition: avcodec.h:452
AVCodecContext::max_qdiff
int max_qdiff
maximum quantizer difference between frames
Definition: avcodec.h:2423
avcodec_find_decoder_by_name
AVCodec * avcodec_find_decoder_by_name(const char *name)
Find a registered decoder with the specified name.
AV_CODEC_ID_ESCAPE124
@ AV_CODEC_ID_ESCAPE124
Definition: avcodec.h:333
AVCodecContext::dark_masking
float dark_masking
darkness masking (0-> disabled)
Definition: avcodec.h:1914
AVCodecContext::coded_frame
attribute_deprecated AVFrame * coded_frame
the picture in the bitstream
Definition: avcodec.h:2817
AVCodecContext
main external API structure.
Definition: avcodec.h:1567
AVCodecContext::active_thread_type
int active_thread_type
Which multithreading methods are in use by the codec.
Definition: avcodec.h:2845
AV_CODEC_ID_SNOW
@ AV_CODEC_ID_SNOW
Definition: avcodec.h:427
AV_CODEC_ID_HAP
@ AV_CODEC_ID_HAP
Definition: avcodec.h:407
AVCodecContext::codec_descriptor
const AVCodecDescriptor * codec_descriptor
AVCodecDescriptor.
Definition: avcodec.h:3128
AV_CODEC_ID_H263P
@ AV_CODEC_ID_H263P
Definition: avcodec.h:237
AVCodecParserContext::field_order
enum AVFieldOrder field_order
Definition: avcodec.h:5234
AV_CODEC_ID_ADPCM_AGM
@ AV_CODEC_ID_ADPCM_AGM
Definition: avcodec.h:545
AVCodecContext::execute
int(* execute)(struct AVCodecContext *c, int(*func)(struct AVCodecContext *c2, void *arg), void *arg2, int *ret, int count, int size)
The codec may call this to execute several independent things.
Definition: avcodec.h:2866
AV_CODEC_ID_G729
@ AV_CODEC_ID_G729
Definition: avcodec.h:618
AV_CODEC_ID_ADPCM_G726LE
@ AV_CODEC_ID_ADPCM_G726LE
Definition: avcodec.h:539
channel_layout.h
av_bsf_init
int av_bsf_init(AVBSFContext *ctx)
Prepare the filter for use, after all the parameters and options have been set.
AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT
@ AV_SIDE_DATA_PARAM_CHANGE_CHANNEL_COUNT
Definition: avcodec.h:1534
av_copy_packet
attribute_deprecated int av_copy_packet(AVPacket *dst, const AVPacket *src)
Copy packet, including contents.
AV_CODEC_ID_V410
@ AV_CODEC_ID_V410
Definition: avcodec.h:375
pkt
static AVPacket pkt
Definition: demuxing_decoding.c:54
AV_CODEC_ID_BINKVIDEO
@ AV_CODEC_ID_BINKVIDEO
Definition: avcodec.h:353
AVBitStreamFilter
Definition: avcodec.h:5814
AVCodecContext::qmin
int qmin
minimum quantizer
Definition: avcodec.h:2409
AV_PKT_DATA_NEW_EXTRADATA
@ AV_PKT_DATA_NEW_EXTRADATA
The AV_PKT_DATA_NEW_EXTRADATA is used to notify the codec or the format that the extradata buffer was...
Definition: avcodec.h:1200
av_get_pcm_codec
enum AVCodecID av_get_pcm_codec(enum AVSampleFormat fmt, int be)
Return the PCM codec associated with a sample format.
AV_CODEC_ID_JPEGLS
@ AV_CODEC_ID_JPEGLS
Definition: avcodec.h:229
AVHWAccel::frame_priv_data_size
int frame_priv_data_size
Size of per-frame hardware accelerator private data.
Definition: avcodec.h:3761
AVCodecContext::bidir_refine
int bidir_refine
Definition: avcodec.h:2135
AVCodecContext::profile
int profile
profile
Definition: avcodec.h:2900
av_fast_padded_mallocz
void av_fast_padded_mallocz(void *ptr, unsigned int *size, size_t min_size)
Same behaviour av_fast_padded_malloc except that buffer will always be 0-initialized after call.
AV_CODEC_ID_DVAUDIO
@ AV_CODEC_ID_DVAUDIO
Definition: avcodec.h:571
AV_CODEC_ID_PSD
@ AV_CODEC_ID_PSD
Definition: avcodec.h:437
av_packet_make_writable
int av_packet_make_writable(AVPacket *pkt)
Create a writable reference for the data described by a given packet, avoiding data copy if possible.
AVDictionary
struct AVDictionary AVDictionary
Definition: dict.h:86
AV_CODEC_ID_BFI
@ AV_CODEC_ID_BFI
Definition: avcodec.h:335
AVCodecContext::spatial_cplx_masking
float spatial_cplx_masking
spatial complexity masking (0-> disabled)
Definition: avcodec.h:1900
AVBitStreamFilterContext::priv_data
void * priv_data
Definition: avcodec.h:5741
AV_CODEC_ID_ADPCM_EA_R1
@ AV_CODEC_ID_ADPCM_EA_R1
Definition: avcodec.h:523
AVCodecContext::i_quant_offset
float i_quant_offset
qscale offset between P and I-frames
Definition: avcodec.h:1879
AVCodecContext::discard_damaged_percentage
int discard_damaged_percentage
The percentage of damaged samples to discard a frame.
Definition: avcodec.h:3374
AV_CODEC_ID_PCM_U32LE
@ AV_CODEC_ID_PCM_U32LE
Definition: avcodec.h:474
av_bsf_receive_packet
int av_bsf_receive_packet(AVBSFContext *ctx, AVPacket *pkt)
Retrieve a filtered packet.
AV_CODEC_ID_ADPCM_EA_R2
@ AV_CODEC_ID_ADPCM_EA_R2
Definition: avcodec.h:525
AVCodecContext::mb_lmax
int mb_lmax
maximum MB Lagrange multiplier
Definition: avcodec.h:2121
av_get_audio_frame_duration2
int av_get_audio_frame_duration2(AVCodecParameters *par, int frame_bytes)
This function is the same as av_get_audio_frame_duration(), except it works with AVCodecParameters in...
AV_CODEC_ID_PROBE
@ AV_CODEC_ID_PROBE
codec_id is not known (like AV_CODEC_ID_NONE) but lavf should attempt to identify it
Definition: avcodec.h:702
avcodec_chroma_pos_to_enum
enum AVChromaLocation avcodec_chroma_pos_to_enum(int xpos, int ypos)
Converts swscale x/y chroma position to AVChromaLocation.
AV_CODEC_ID_MSA1
@ AV_CODEC_ID_MSA1
Definition: avcodec.h:381
AVPacket::stream_index
int stream_index
Definition: avcodec.h:1480
avcodec_get_hw_config
const AVCodecHWConfig * avcodec_get_hw_config(const AVCodec *codec, int index)
Retrieve supported hardware configurations for a codec.
AVCodecContext::pre_dia_size
int pre_dia_size
ME prepass diamond size & shape.
Definition: avcodec.h:2022
AVBitStreamFilterContext::args
char * args
Internal default arguments, used if NULL is passed to av_bitstream_filter_filter().
Definition: avcodec.h:5749
AVCodecContext::debug
int debug
debug
Definition: avcodec.h:2652
AV_CODEC_ID_VMNC
@ AV_CODEC_ID_VMNC
Definition: avcodec.h:307
AV_CODEC_ID_TRUESPEECH
@ AV_CODEC_ID_TRUESPEECH
Definition: avcodec.h:586
AVHWAccel::start_frame
int(* start_frame)(AVCodecContext *avctx, const uint8_t *buf, uint32_t buf_size)
Called at the beginning of each frame or field picture.
Definition: avcodec.h:3713
AVBSFContext::filter
const struct AVBitStreamFilter * filter
The bitstream filter this context is an instance of.
Definition: avcodec.h:5774
AVCodec::close
int(* close)(AVCodecContext *)
Definition: avcodec.h:3582
AV_CODEC_ID_XBIN
@ AV_CODEC_ID_XBIN
Definition: avcodec.h:693
AV_CODEC_ID_ADPCM_THP
@ AV_CODEC_ID_ADPCM_THP
Definition: avcodec.h:521
AVCodecContext::coded_width
int coded_width
Bitstream width / height, may be different from width/height e.g.
Definition: avcodec.h:1755
AV_CODEC_ID_MICRODVD
@ AV_CODEC_ID_MICRODVD
Definition: avcodec.h:669
AVCodecContext::codec_type
enum AVMediaType codec_type
Definition: avcodec.h:1575
AVCodecContext::seek_preroll
int seek_preroll
Number of samples to skip after a discontinuity.
Definition: avcodec.h:3187
av_parser_parse2
int av_parser_parse2(AVCodecParserContext *s, AVCodecContext *avctx, uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size, int64_t pts, int64_t dts, int64_t pos)
Parse a packet.
AV_CODEC_ID_DDS
@ AV_CODEC_ID_DDS
Definition: avcodec.h:408
AV_CODEC_ID_PCM_S32LE
@ AV_CODEC_ID_PCM_S32LE
Definition: avcodec.h:472
avutil.h
AV_CODEC_ID_SONIC
@ AV_CODEC_ID_SONIC
Definition: avcodec.h:635
AVCodecParameters::bits_per_coded_sample
int bits_per_coded_sample
The number of bits per sample in the codedwords.
Definition: avcodec.h:4001
AVCodecContext::max_b_frames
int max_b_frames
maximum number of B-frames between non-B-frames Note: The output will be delayed by max_b_frames+1 re...
Definition: avcodec.h:1827
AV_CODEC_ID_QTRLE
@ AV_CODEC_ID_QTRLE
Definition: avcodec.h:273
AVBufferRef
A reference to a data buffer.
Definition: buffer.h:81
AV_CODEC_ID_ADPCM_SBPRO_4
@ AV_CODEC_ID_ADPCM_SBPRO_4
Definition: avcodec.h:518
AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL
@ AV_PKT_DATA_MATROSKA_BLOCKADDITIONAL
Data found in BlockAdditional element of matroska container.
Definition: avcodec.h:1336
AV_CODEC_ID_PCM_U8
@ AV_CODEC_ID_PCM_U8
Definition: avcodec.h:469
AV_CODEC_ID_RPZA
@ AV_CODEC_ID_RPZA
Definition: avcodec.h:260
AVCodec::receive_frame
int(* receive_frame)(AVCodecContext *avctx, AVFrame *frame)
Decode API with decoupled packet/frame dataflow.
Definition: avcodec.h:3599
AV_CODEC_ID_SDX2_DPCM
@ AV_CODEC_ID_SDX2_DPCM
Definition: avcodec.h:561
AVCodecParameters::video_delay
int video_delay
Video only.
Definition: avcodec.h:4054
AVCodecContext::frame_number
int frame_number
Frame counter, set by libavcodec.
Definition: avcodec.h:2258
AV_CODEC_ID_VBLE
@ AV_CODEC_ID_VBLE
Definition: avcodec.h:373
AVCodecContext::rc_max_available_vbv_use
float rc_max_available_vbv_use
Ratecontrol attempt to use, at maximum, of what can be used without an underflow.
Definition: avcodec.h:2459
AVCodecParameters::format
int format
Definition: avcodec.h:3983
AV_CODEC_ID_PCM_S24DAUD
@ AV_CODEC_ID_PCM_S24DAUD
Definition: avcodec.h:480
AV_CODEC_ID_XMA2
@ AV_CODEC_ID_XMA2
Definition: avcodec.h:646
AV_CODEC_ID_G2M
@ AV_CODEC_ID_G2M
Definition: avcodec.h:389
AV_CODEC_ID_TSCC
@ AV_CODEC_ID_TSCC
Definition: avcodec.h:274
AVCodecContext::chromaoffset
attribute_deprecated int chromaoffset
Definition: avcodec.h:2160
AV_AUDIO_SERVICE_TYPE_DIALOGUE
@ AV_AUDIO_SERVICE_TYPE_DIALOGUE
Definition: avcodec.h:820
AV_CODEC_ID_PCM_F64LE
@ AV_CODEC_ID_PCM_F64LE
Definition: avcodec.h:487
AVCodecContext::codec_tag
unsigned int codec_tag
fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
Definition: avcodec.h:1592
av_parser_change
int av_parser_change(AVCodecParserContext *s, AVCodecContext *avctx, uint8_t **poutbuf, int *poutbuf_size, const uint8_t *buf, int buf_size, int keyframe)
AV_PARSER_PTS_NB
#define AV_PARSER_PTS_NB
Definition: avcodec.h:5137
AVCodecParameters::codec_id
enum AVCodecID codec_id
Specific type of the encoded data (the codec used).
Definition: avcodec.h:3959
AVCodecContext::slices
int slices
Number of slices.
Definition: avcodec.h:2218
AVCodecContext::priv_data
void * priv_data
Definition: avcodec.h:1594
AVPacket
This structure stores compressed data.
Definition: avcodec.h:1455
AVCodec::flush
void(* flush)(AVCodecContext *)
Flush buffers.
Definition: avcodec.h:3604
AV_CODEC_ID_ADPCM_IMA_WAV
@ AV_CODEC_ID_ADPCM_IMA_WAV
Definition: avcodec.h:504
AVCodecParserContext::last_pos
int64_t last_pos
Previous frame byte position.
Definition: avcodec.h:5225
AVCodec::next
struct AVCodec * next
Definition: avcodec.h:3532
AV_CODEC_ID_SGIRLE
@ AV_CODEC_ID_SGIRLE
Definition: avcodec.h:401
AVCodecContext::inter_matrix
uint16_t * inter_matrix
custom inter quantization matrix Must be allocated with the av_malloc() family of functions,...
Definition: avcodec.h:2076
avpicture_fill
attribute_deprecated int avpicture_fill(AVPicture *picture, const uint8_t *ptr, enum AVPixelFormat pix_fmt, int width, int height)
AVHWAccel::frame_params
int(* frame_params)(AVCodecContext *avctx, AVBufferRef *hw_frames_ctx)
Fill the given hw_frames context with current codec parameters.
Definition: avcodec.h:3810
AVPacket::pos
int64_t pos
byte position in stream, -1 if unknown
Definition: avcodec.h:1498
AVCodecParser
Definition: avcodec.h:5277
AV_FIELD_TB
@ AV_FIELD_TB
Definition: avcodec.h:1550
AV_CODEC_ID_TAK
@ AV_CODEC_ID_TAK
Definition: avcodec.h:627
AVCodecContext::rc_override_count
int rc_override_count
ratecontrol override, see RcOverride
Definition: avcodec.h:2437
av_copy_packet_side_data
attribute_deprecated int av_copy_packet_side_data(AVPacket *dst, const AVPacket *src)
Copy packet side data.
AV_PKT_DATA_FALLBACK_TRACK
@ AV_PKT_DATA_FALLBACK_TRACK
This side data contains an integer value representing the stream index of a "fallback" track.
Definition: avcodec.h:1285
AVCodecParameters::channel_layout
uint64_t channel_layout
Audio only.
Definition: avcodec.h:4061
AVCodecContext::reordered_opaque
int64_t reordered_opaque
opaque 64-bit number (generally a PTS) that will be reordered and output in AVFrame....
Definition: avcodec.h:2724
avcodec_configuration
const char * avcodec_configuration(void)
Return the libavcodec build-time configuration.
AVBitStreamFilter::init
int(* init)(AVBSFContext *ctx)
Definition: avcodec.h:5844
AVPicture::linesize
attribute_deprecated int linesize[AV_NUM_DATA_POINTERS]
number of bytes per line
Definition: avcodec.h:3872
AV_CODEC_ID_ILBC
@ AV_CODEC_ID_ILBC
Definition: avcodec.h:624
AV_FIELD_BB
@ AV_FIELD_BB
Definition: avcodec.h:1549
AV_CODEC_ID_PCM_S8_PLANAR
@ AV_CODEC_ID_PCM_S8_PLANAR
Definition: avcodec.h:491
AVCodecContext::width
int width
picture width / height.
Definition: avcodec.h:1740
AVCodecDescriptor::id
enum AVCodecID id
Definition: avcodec.h:718
AVCodecContext::me_penalty_compensation
attribute_deprecated int me_penalty_compensation
Definition: avcodec.h:2128
AVCodecContext::min_prediction_order
attribute_deprecated int min_prediction_order
Definition: avcodec.h:2521
AV_CODEC_ID_PCM_U16LE
@ AV_CODEC_ID_PCM_U16LE
Definition: avcodec.h:466
AV_CODEC_ID_012V
@ AV_CODEC_ID_012V
Definition: avcodec.h:417
AV_PKT_DATA_QUALITY_STATS
@ AV_PKT_DATA_QUALITY_STATS
This side data contains quality related information from the encoder.
Definition: avcodec.h:1277
AV_CODEC_ID_VP8
@ AV_CODEC_ID_VP8
Definition: avcodec.h:358
hwcontext.h
AV_CODEC_ID_PCM_F32LE
@ AV_CODEC_ID_PCM_F32LE
Definition: avcodec.h:485
AVCodecParameters::bit_rate
int64_t bit_rate
The average bitrate of the encoded data (in bits per second).
Definition: avcodec.h:3988
AV_CODEC_ID_BRENDER_PIX
@ AV_CODEC_ID_BRENDER_PIX
Definition: avcodec.h:396
AV_CODEC_ID_AAC_LATM
@ AV_CODEC_ID_AAC_LATM
Definition: avcodec.h:614
AV_CODEC_ID_WAVPACK
@ AV_CODEC_ID_WAVPACK
Definition: avcodec.h:590
av_bsf_list_append2
int av_bsf_list_append2(AVBSFList *lst, const char *bsf_name, AVDictionary **options)
Construct new bitstream filter context given it's name and options and append it to the list of bitst...
AV_CODEC_ID_COOK
@ AV_CODEC_ID_COOK
Definition: avcodec.h:585
AV_CODEC_ID_4GV
@ AV_CODEC_ID_4GV
Definition: avcodec.h:643
AV_CODEC_ID_MSMPEG4V3
@ AV_CODEC_ID_MSMPEG4V3
Definition: avcodec.h:234
AVCodecParserContext::priv_data
void * priv_data
Definition: avcodec.h:5111
AVPanScan::height
int height
Definition: avcodec.h:1114
AV_CODEC_ID_SGI
@ AV_CODEC_ID_SGI
Definition: avcodec.h:319
AV_CODEC_ID_HDMV_TEXT_SUBTITLE
@ AV_CODEC_ID_HDMV_TEXT_SUBTITLE
Definition: avcodec.h:683
AV_CODEC_ID_SUNRAST
@ AV_CODEC_ID_SUNRAST
Definition: avcodec.h:328
AVCodecHWConfig
Definition: avcodec.h:3457
AV_CODEC_ID_ADPCM_4XM
@ AV_CODEC_ID_ADPCM_4XM
Definition: avcodec.h:510
AV_CODEC_ID_CLEARVIDEO
@ AV_CODEC_ID_CLEARVIDEO
Definition: avcodec.h:442
AVBitStreamFilterContext
Definition: avcodec.h:5740
AV_CODEC_ID_TARGA
@ AV_CODEC_ID_TARGA
Definition: avcodec.h:311
AV_PKT_DATA_WEBVTT_IDENTIFIER
@ AV_PKT_DATA_WEBVTT_IDENTIFIER
The optional first identifier line of a WebVTT cue.
Definition: avcodec.h:1341
AV_CODEC_ID_VORBIS
@ AV_CODEC_ID_VORBIS
Definition: avcodec.h:570
AV_CODEC_ID_TIFF
@ AV_CODEC_ID_TIFF
Definition: avcodec.h:314
AVCodecContext::sw_pix_fmt
enum AVPixelFormat sw_pix_fmt
Nominal unaccelerated pixel format, see AV_PIX_FMT_xxx.
Definition: avcodec.h:3114
AV_CODEC_ID_WMV3IMAGE
@ AV_CODEC_ID_WMV3IMAGE
Definition: avcodec.h:369
AVCodecParserContext::cur_frame_dts
int64_t cur_frame_dts[AV_PARSER_PTS_NB]
Definition: avcodec.h:5141
AV_CODEC_ID_APTX
@ AV_CODEC_ID_APTX
Definition: avcodec.h:651
AVBitStreamFilter::flush
void(* flush)(AVBSFContext *ctx)
Definition: avcodec.h:5847
AV_CODEC_ID_DXTORY
@ AV_CODEC_ID_DXTORY
Definition: avcodec.h:374
AV_CODEC_ID_MSVIDEO1
@ AV_CODEC_ID_MSVIDEO1
Definition: avcodec.h:264
AV_CODEC_ID_M101
@ AV_CODEC_ID_M101
Definition: avcodec.h:433
AV_CODEC_ID_REALTEXT
@ AV_CODEC_ID_REALTEXT
Definition: avcodec.h:673
AV_CODEC_ID_MUSEPACK7
@ AV_CODEC_ID_MUSEPACK7
Definition: avcodec.h:593
AV_CODEC_ID_ADPCM_PSX
@ AV_CODEC_ID_ADPCM_PSX
Definition: avcodec.h:541
AV_CODEC_ID_FLV1
@ AV_CODEC_ID_FLV1
Definition: avcodec.h:239
AVCodecContext::codec_whitelist
char * codec_whitelist
',' separated list of allowed decoders.
Definition: avcodec.h:3222
AVDiscard
AVDiscard
Definition: avcodec.h:803
AVDISCARD_NONREF
@ AVDISCARD_NONREF
discard all non reference
Definition: avcodec.h:808
AV_CODEC_ID_BINKAUDIO_RDFT
@ AV_CODEC_ID_BINKAUDIO_RDFT
Definition: avcodec.h:612
AV_CODEC_ID_DFA
@ AV_CODEC_ID_DFA
Definition: avcodec.h:368
AVColorRange
AVColorRange
Visual content value range.
Definition: pixfmt.h:649
AVCodecParserContext::last_dts
int64_t last_dts
Definition: avcodec.h:5134
AV_CODEC_ID_SHORTEN
@ AV_CODEC_ID_SHORTEN
Definition: avcodec.h:580
AV_FIELD_BT
@ AV_FIELD_BT
Definition: avcodec.h:1551
AV_CODEC_ID_MPEG2VIDEO
@ AV_CODEC_ID_MPEG2VIDEO
preferred ID for MPEG-1/2 video decoding
Definition: avcodec.h:220
AVCodecContext::frame_skip_factor
attribute_deprecated int frame_skip_factor
Definition: avcodec.h:2500
AV_CODEC_ID_LJPEG
@ AV_CODEC_ID_LJPEG
Definition: avcodec.h:227
AV_CODEC_ID_TWINVQ
@ AV_CODEC_ID_TWINVQ
Definition: avcodec.h:608
AV_CODEC_ID_MP1
@ AV_CODEC_ID_MP1
Definition: avcodec.h:607
AVCodecParameters::initial_padding
int initial_padding
Audio only.
Definition: avcodec.h:4088
AVCodecContext::execute2
int(* execute2)(struct AVCodecContext *c, int(*func)(struct AVCodecContext *c2, void *arg, int jobnr, int threadnr), void *arg2, int *ret, int count)
The codec may call this to execute several independent things.
Definition: avcodec.h:2886
AV_CODEC_ID_CELT
@ AV_CODEC_ID_CELT
Definition: avcodec.h:616
AV_CODEC_ID_GREMLIN_DPCM
@ AV_CODEC_ID_GREMLIN_DPCM
Definition: avcodec.h:562
AV_CODEC_ID_AASC
@ AV_CODEC_ID_AASC
Definition: avcodec.h:292
AV_CODEC_ID_PCM_S24BE
@ AV_CODEC_ID_PCM_S24BE
Definition: avcodec.h:477
AV_CODEC_ID_TMV
@ AV_CODEC_ID_TMV
Definition: avcodec.h:344
AV_CODEC_ID_CDXL
@ AV_CODEC_ID_CDXL
Definition: avcodec.h:377
AVCodecHWConfig::device_type
enum AVHWDeviceType device_type
The device type associated with the configuration.
Definition: avcodec.h:3473
AVHWAccel::pix_fmt
enum AVPixelFormat pix_fmt
Supported pixel format.
Definition: avcodec.h:3678
AVCodecContext::sample_aspect_ratio
AVRational sample_aspect_ratio
sample aspect ratio (0 if unknown) That is the width of a pixel divided by the height of the pixel.
Definition: avcodec.h:1946
AVCodec::channel_layouts
const uint64_t * channel_layouts
array of support channel layouts, or NULL if unknown. array is terminated by 0
Definition: avcodec.h:3507
AVSubtitle::start_display_time
uint32_t start_display_time
Definition: avcodec.h:3937
AV_CODEC_ID_APTX_HD
@ AV_CODEC_ID_APTX_HD
Definition: avcodec.h:652
AV_CODEC_ID_DNXHD
@ AV_CODEC_ID_DNXHD
Definition: avcodec.h:317
avcodec_descriptor_get_by_name
const AVCodecDescriptor * avcodec_descriptor_get_by_name(const char *name)
AV_CODEC_ID_PAF_AUDIO
@ AV_CODEC_ID_PAF_AUDIO
Definition: avcodec.h:629
avcodec_parameters_copy
int avcodec_parameters_copy(AVCodecParameters *dst, const AVCodecParameters *src)
Copy the contents of src to dst.
AVPacket::time_base
AVRational time_base
Definition: avcodec.h:1509
AV_CODEC_ID_MLP
@ AV_CODEC_ID_MLP
Definition: avcodec.h:594
AV_CODEC_ID_NELLYMOSER
@ AV_CODEC_ID_NELLYMOSER
Definition: avcodec.h:598
AVPacket::side_data_elems
int side_data_elems
Definition: avcodec.h:1490
AV_CODEC_ID_PTX
@ AV_CODEC_ID_PTX
Definition: avcodec.h:322
AVCodecContext::compression_level
int compression_level
Definition: avcodec.h:1639
AVBSFList
struct AVBSFList AVBSFList
Structure for chain/list of bitstream filters.
Definition: avcodec.h:5997
av_parser_close
void av_parser_close(AVCodecParserContext *s)
AV_CODEC_ID_AURA
@ AV_CODEC_ID_AURA
Definition: avcodec.h:341
AV_CODEC_ID_PRORES
@ AV_CODEC_ID_PRORES
Definition: avcodec.h:366
av_packet_clone
AVPacket * av_packet_clone(const AVPacket *src)
Create a new packet that references the same data as src.
av_bitstream_filter_init
attribute_deprecated AVBitStreamFilterContext * av_bitstream_filter_init(const char *name)
av_init_packet
void av_init_packet(AVPacket *pkt)
Initialize optional fields of a packet with default values.
AV_CODEC_ID_ADPCM_SBPRO_3
@ AV_CODEC_ID_ADPCM_SBPRO_3
Definition: avcodec.h:519
AV_CODEC_ID_DAALA
@ AV_CODEC_ID_DAALA
Definition: avcodec.h:430
AV_CODEC_ID_SCTE_35
@ AV_CODEC_ID_SCTE_35
Contain timestamp estimated through PCR of program stream.
Definition: avcodec.h:691
AVHWAccel::id
enum AVCodecID id
Codec implemented by the hardware accelerator.
Definition: avcodec.h:3671
AVCodecContext::side_data_only_packets
attribute_deprecated int side_data_only_packets
Encoding only and set by default.
Definition: avcodec.h:3080