You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

2940 lines
90KB

  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. #ifndef AVCODEC_H
  21. #define AVCODEC_H
  22. /**
  23. * @file avcodec.h
  24. * external API header
  25. */
  26. #include "avutil.h"
  27. #include <sys/types.h> /* size_t */
  28. #define AV_STRINGIFY(s) AV_TOSTRING(s)
  29. #define AV_TOSTRING(s) #s
  30. #define LIBAVCODEC_VERSION_INT ((51<<16)+(40<<8)+4)
  31. #define LIBAVCODEC_VERSION 51.40.4
  32. #define LIBAVCODEC_BUILD LIBAVCODEC_VERSION_INT
  33. #define LIBAVCODEC_IDENT "Lavc" AV_STRINGIFY(LIBAVCODEC_VERSION)
  34. #define AV_NOPTS_VALUE INT64_C(0x8000000000000000)
  35. #define AV_TIME_BASE 1000000
  36. #define AV_TIME_BASE_Q (AVRational){1, AV_TIME_BASE}
  37. /**
  38. * Identifies the syntax and semantics of the bitstream.
  39. * The principle is roughly:
  40. * Two decoders with the same ID can decode the same streams.
  41. * Two encoders with the same ID can encode compatible streams.
  42. * There may be slight deviations from the principle due to implementation
  43. * details.
  44. *
  45. * If you add a codec ID to this list, add it so that
  46. * 1. no value of a existing codec ID changes (that would break ABI),
  47. * 2. it is as close as possible to similar codecs.
  48. */
  49. enum CodecID {
  50. CODEC_ID_NONE,
  51. CODEC_ID_MPEG1VIDEO,
  52. CODEC_ID_MPEG2VIDEO, /* preferred ID for MPEG-1/2 video decoding */
  53. CODEC_ID_MPEG2VIDEO_XVMC,
  54. CODEC_ID_H261,
  55. CODEC_ID_H263,
  56. CODEC_ID_RV10,
  57. CODEC_ID_RV20,
  58. CODEC_ID_MJPEG,
  59. CODEC_ID_MJPEGB,
  60. CODEC_ID_LJPEG,
  61. CODEC_ID_SP5X,
  62. CODEC_ID_JPEGLS,
  63. CODEC_ID_MPEG4,
  64. CODEC_ID_RAWVIDEO,
  65. CODEC_ID_MSMPEG4V1,
  66. CODEC_ID_MSMPEG4V2,
  67. CODEC_ID_MSMPEG4V3,
  68. CODEC_ID_WMV1,
  69. CODEC_ID_WMV2,
  70. CODEC_ID_H263P,
  71. CODEC_ID_H263I,
  72. CODEC_ID_FLV1,
  73. CODEC_ID_SVQ1,
  74. CODEC_ID_SVQ3,
  75. CODEC_ID_DVVIDEO,
  76. CODEC_ID_HUFFYUV,
  77. CODEC_ID_CYUV,
  78. CODEC_ID_H264,
  79. CODEC_ID_INDEO3,
  80. CODEC_ID_VP3,
  81. CODEC_ID_THEORA,
  82. CODEC_ID_ASV1,
  83. CODEC_ID_ASV2,
  84. CODEC_ID_FFV1,
  85. CODEC_ID_4XM,
  86. CODEC_ID_VCR1,
  87. CODEC_ID_CLJR,
  88. CODEC_ID_MDEC,
  89. CODEC_ID_ROQ,
  90. CODEC_ID_INTERPLAY_VIDEO,
  91. CODEC_ID_XAN_WC3,
  92. CODEC_ID_XAN_WC4,
  93. CODEC_ID_RPZA,
  94. CODEC_ID_CINEPAK,
  95. CODEC_ID_WS_VQA,
  96. CODEC_ID_MSRLE,
  97. CODEC_ID_MSVIDEO1,
  98. CODEC_ID_IDCIN,
  99. CODEC_ID_8BPS,
  100. CODEC_ID_SMC,
  101. CODEC_ID_FLIC,
  102. CODEC_ID_TRUEMOTION1,
  103. CODEC_ID_VMDVIDEO,
  104. CODEC_ID_MSZH,
  105. CODEC_ID_ZLIB,
  106. CODEC_ID_QTRLE,
  107. CODEC_ID_SNOW,
  108. CODEC_ID_TSCC,
  109. CODEC_ID_ULTI,
  110. CODEC_ID_QDRAW,
  111. CODEC_ID_VIXL,
  112. CODEC_ID_QPEG,
  113. CODEC_ID_XVID,
  114. CODEC_ID_PNG,
  115. CODEC_ID_PPM,
  116. CODEC_ID_PBM,
  117. CODEC_ID_PGM,
  118. CODEC_ID_PGMYUV,
  119. CODEC_ID_PAM,
  120. CODEC_ID_FFVHUFF,
  121. CODEC_ID_RV30,
  122. CODEC_ID_RV40,
  123. CODEC_ID_VC1,
  124. CODEC_ID_WMV3,
  125. CODEC_ID_LOCO,
  126. CODEC_ID_WNV1,
  127. CODEC_ID_AASC,
  128. CODEC_ID_INDEO2,
  129. CODEC_ID_FRAPS,
  130. CODEC_ID_TRUEMOTION2,
  131. CODEC_ID_BMP,
  132. CODEC_ID_CSCD,
  133. CODEC_ID_MMVIDEO,
  134. CODEC_ID_ZMBV,
  135. CODEC_ID_AVS,
  136. CODEC_ID_SMACKVIDEO,
  137. CODEC_ID_NUV,
  138. CODEC_ID_KMVC,
  139. CODEC_ID_FLASHSV,
  140. CODEC_ID_CAVS,
  141. CODEC_ID_JPEG2000,
  142. CODEC_ID_VMNC,
  143. CODEC_ID_VP5,
  144. CODEC_ID_VP6,
  145. CODEC_ID_VP6F,
  146. CODEC_ID_TARGA,
  147. CODEC_ID_DSICINVIDEO,
  148. CODEC_ID_TIERTEXSEQVIDEO,
  149. CODEC_ID_TIFF,
  150. CODEC_ID_GIF,
  151. CODEC_ID_FFH264,
  152. CODEC_ID_DXA,
  153. CODEC_ID_DNXHD,
  154. CODEC_ID_THP,
  155. CODEC_ID_SGI,
  156. CODEC_ID_C93,
  157. CODEC_ID_BETHSOFTVID,
  158. CODEC_ID_PTX,
  159. CODEC_ID_TXD,
  160. /* various PCM "codecs" */
  161. CODEC_ID_PCM_S16LE= 0x10000,
  162. CODEC_ID_PCM_S16BE,
  163. CODEC_ID_PCM_U16LE,
  164. CODEC_ID_PCM_U16BE,
  165. CODEC_ID_PCM_S8,
  166. CODEC_ID_PCM_U8,
  167. CODEC_ID_PCM_MULAW,
  168. CODEC_ID_PCM_ALAW,
  169. CODEC_ID_PCM_S32LE,
  170. CODEC_ID_PCM_S32BE,
  171. CODEC_ID_PCM_U32LE,
  172. CODEC_ID_PCM_U32BE,
  173. CODEC_ID_PCM_S24LE,
  174. CODEC_ID_PCM_S24BE,
  175. CODEC_ID_PCM_U24LE,
  176. CODEC_ID_PCM_U24BE,
  177. CODEC_ID_PCM_S24DAUD,
  178. CODEC_ID_PCM_ZORK,
  179. /* various ADPCM codecs */
  180. CODEC_ID_ADPCM_IMA_QT= 0x11000,
  181. CODEC_ID_ADPCM_IMA_WAV,
  182. CODEC_ID_ADPCM_IMA_DK3,
  183. CODEC_ID_ADPCM_IMA_DK4,
  184. CODEC_ID_ADPCM_IMA_WS,
  185. CODEC_ID_ADPCM_IMA_SMJPEG,
  186. CODEC_ID_ADPCM_MS,
  187. CODEC_ID_ADPCM_4XM,
  188. CODEC_ID_ADPCM_XA,
  189. CODEC_ID_ADPCM_ADX,
  190. CODEC_ID_ADPCM_EA,
  191. CODEC_ID_ADPCM_G726,
  192. CODEC_ID_ADPCM_CT,
  193. CODEC_ID_ADPCM_SWF,
  194. CODEC_ID_ADPCM_YAMAHA,
  195. CODEC_ID_ADPCM_SBPRO_4,
  196. CODEC_ID_ADPCM_SBPRO_3,
  197. CODEC_ID_ADPCM_SBPRO_2,
  198. CODEC_ID_ADPCM_THP,
  199. /* AMR */
  200. CODEC_ID_AMR_NB= 0x12000,
  201. CODEC_ID_AMR_WB,
  202. /* RealAudio codecs*/
  203. CODEC_ID_RA_144= 0x13000,
  204. CODEC_ID_RA_288,
  205. /* various DPCM codecs */
  206. CODEC_ID_ROQ_DPCM= 0x14000,
  207. CODEC_ID_INTERPLAY_DPCM,
  208. CODEC_ID_XAN_DPCM,
  209. CODEC_ID_SOL_DPCM,
  210. CODEC_ID_MP2= 0x15000,
  211. CODEC_ID_MP3, /* preferred ID for decoding MPEG audio layer 1, 2 or 3 */
  212. CODEC_ID_AAC,
  213. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  214. CODEC_ID_MPEG4AAC,
  215. #endif
  216. CODEC_ID_AC3,
  217. CODEC_ID_DTS,
  218. CODEC_ID_VORBIS,
  219. CODEC_ID_DVAUDIO,
  220. CODEC_ID_WMAV1,
  221. CODEC_ID_WMAV2,
  222. CODEC_ID_MACE3,
  223. CODEC_ID_MACE6,
  224. CODEC_ID_VMDAUDIO,
  225. CODEC_ID_SONIC,
  226. CODEC_ID_SONIC_LS,
  227. CODEC_ID_FLAC,
  228. CODEC_ID_MP3ADU,
  229. CODEC_ID_MP3ON4,
  230. CODEC_ID_SHORTEN,
  231. CODEC_ID_ALAC,
  232. CODEC_ID_WESTWOOD_SND1,
  233. CODEC_ID_GSM, /* as in Berlin toast format */
  234. CODEC_ID_QDM2,
  235. CODEC_ID_COOK,
  236. CODEC_ID_TRUESPEECH,
  237. CODEC_ID_TTA,
  238. CODEC_ID_SMACKAUDIO,
  239. CODEC_ID_QCELP,
  240. CODEC_ID_WAVPACK,
  241. CODEC_ID_DSICINAUDIO,
  242. CODEC_ID_IMC,
  243. CODEC_ID_MUSEPACK7,
  244. CODEC_ID_MLP,
  245. CODEC_ID_GSM_MS, /* as found in WAV */
  246. CODEC_ID_ATRAC3,
  247. CODEC_ID_VOXWARE,
  248. /* subtitle codecs */
  249. CODEC_ID_DVD_SUBTITLE= 0x17000,
  250. CODEC_ID_DVB_SUBTITLE,
  251. CODEC_ID_TEXT, /* raw UTF-8 text */
  252. CODEC_ID_XSUB,
  253. CODEC_ID_MPEG2TS= 0x20000, /* _FAKE_ codec to indicate a raw MPEG-2 TS
  254. * stream (only used by libavformat) */
  255. };
  256. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  257. /* CODEC_ID_MP3LAME is obsolete */
  258. #define CODEC_ID_MP3LAME CODEC_ID_MP3
  259. #define CODEC_ID_MPEG4AAC CODEC_ID_AAC
  260. #endif
  261. enum CodecType {
  262. CODEC_TYPE_UNKNOWN = -1,
  263. CODEC_TYPE_VIDEO,
  264. CODEC_TYPE_AUDIO,
  265. CODEC_TYPE_DATA,
  266. CODEC_TYPE_SUBTITLE,
  267. CODEC_TYPE_NB
  268. };
  269. /* Currently unused, may be used if 24/32 bits samples are ever supported. */
  270. /* all in native-endian format */
  271. enum SampleFormat {
  272. SAMPLE_FMT_NONE = -1,
  273. SAMPLE_FMT_U8, ///< unsigned 8 bits
  274. SAMPLE_FMT_S16, ///< signed 16 bits
  275. SAMPLE_FMT_S24, ///< signed 24 bits
  276. SAMPLE_FMT_S32, ///< signed 32 bits
  277. SAMPLE_FMT_FLT, ///< float
  278. };
  279. /* in bytes */
  280. #define AVCODEC_MAX_AUDIO_FRAME_SIZE 192000 // 1 second of 48khz 32bit audio
  281. /**
  282. * Required number of additionally allocated bytes at the end of the input bitstream for decoding.
  283. * This is mainly needed because some optimized bitstream readers read
  284. * 32 or 64 bit at once and could read over the end.<br>
  285. * Note: If the first 23 bits of the additional bytes are not 0, then damaged
  286. * MPEG bitstreams could cause overread and segfault.
  287. */
  288. #define FF_INPUT_BUFFER_PADDING_SIZE 8
  289. /**
  290. * minimum encoding buffer size
  291. * Used to avoid some checks during header writing.
  292. */
  293. #define FF_MIN_BUFFER_SIZE 16384
  294. /* motion estimation type, EPZS by default */
  295. enum Motion_Est_ID {
  296. ME_ZERO = 1,
  297. ME_FULL,
  298. ME_LOG,
  299. ME_PHODS,
  300. ME_EPZS,
  301. ME_X1,
  302. ME_HEX,
  303. ME_UMH,
  304. ME_ITER,
  305. };
  306. enum AVDiscard{
  307. /* We leave some space between them for extensions (drop some
  308. * keyframes for intra-only or drop just some bidir frames). */
  309. AVDISCARD_NONE =-16, ///< discard nothing
  310. AVDISCARD_DEFAULT= 0, ///< discard useless packets like 0 size packets in avi
  311. AVDISCARD_NONREF = 8, ///< discard all non reference
  312. AVDISCARD_BIDIR = 16, ///< discard all bidirectional frames
  313. AVDISCARD_NONKEY = 32, ///< discard all frames except keyframes
  314. AVDISCARD_ALL = 48, ///< discard all
  315. };
  316. typedef struct RcOverride{
  317. int start_frame;
  318. int end_frame;
  319. int qscale; // If this is 0 then quality_factor will be used instead.
  320. float quality_factor;
  321. } RcOverride;
  322. #define FF_MAX_B_FRAMES 16
  323. /* encoding support
  324. These flags can be passed in AVCodecContext.flags before initialization.
  325. Note: Not everything is supported yet.
  326. */
  327. #define CODEC_FLAG_QSCALE 0x0002 ///< Use fixed qscale.
  328. #define CODEC_FLAG_4MV 0x0004 ///< 4 MV per MB allowed / advanced prediction for H.263.
  329. #define CODEC_FLAG_QPEL 0x0010 ///< Use qpel MC.
  330. #define CODEC_FLAG_GMC 0x0020 ///< Use GMC.
  331. #define CODEC_FLAG_MV0 0x0040 ///< Always try a MB with MV=<0,0>.
  332. #define CODEC_FLAG_PART 0x0080 ///< Use data partitioning.
  333. /* The parent program guarantees that the input for B-frames containing
  334. * streams is not written to for at least s->max_b_frames+1 frames, if
  335. * this is not set the input will be copied. */
  336. #define CODEC_FLAG_INPUT_PRESERVED 0x0100
  337. #define CODEC_FLAG_PASS1 0x0200 ///< Use internal 2pass ratecontrol in first pass mode.
  338. #define CODEC_FLAG_PASS2 0x0400 ///< Use internal 2pass ratecontrol in second pass mode.
  339. #define CODEC_FLAG_EXTERN_HUFF 0x1000 ///< Use external Huffman table (for MJPEG).
  340. #define CODEC_FLAG_GRAY 0x2000 ///< Only decode/encode grayscale.
  341. #define CODEC_FLAG_EMU_EDGE 0x4000///< Don't draw edges.
  342. #define CODEC_FLAG_PSNR 0x8000 ///< error[?] variables will be set during encoding.
  343. #define CODEC_FLAG_TRUNCATED 0x00010000 /** Input bitstream might be truncated at a random location instead
  344. of only at frame boundaries. */
  345. #define CODEC_FLAG_NORMALIZE_AQP 0x00020000 ///< Normalize adaptive quantization.
  346. #define CODEC_FLAG_INTERLACED_DCT 0x00040000 ///< Use interlaced DCT.
  347. #define CODEC_FLAG_LOW_DELAY 0x00080000 ///< Force low delay.
  348. #define CODEC_FLAG_ALT_SCAN 0x00100000 ///< Use alternate scan.
  349. #define CODEC_FLAG_TRELLIS_QUANT 0x00200000 ///< Use trellis quantization.
  350. #define CODEC_FLAG_GLOBAL_HEADER 0x00400000 ///< Place global headers in extradata instead of every keyframe.
  351. #define CODEC_FLAG_BITEXACT 0x00800000 ///< Use only bitexact stuff (except (I)DCT).
  352. /* Fx : Flag for h263+ extra options */
  353. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  354. #define CODEC_FLAG_H263P_AIC 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction (remove this)
  355. #endif
  356. #define CODEC_FLAG_AC_PRED 0x01000000 ///< H.263 advanced intra coding / MPEG-4 AC prediction
  357. #define CODEC_FLAG_H263P_UMV 0x02000000 ///< unlimited motion vector
  358. #define CODEC_FLAG_CBP_RD 0x04000000 ///< Use rate distortion optimization for cbp.
  359. #define CODEC_FLAG_QP_RD 0x08000000 ///< Use rate distortion optimization for qp selectioon.
  360. #define CODEC_FLAG_H263P_AIV 0x00000008 ///< H.263 alternative inter VLC
  361. #define CODEC_FLAG_OBMC 0x00000001 ///< OBMC
  362. #define CODEC_FLAG_LOOP_FILTER 0x00000800 ///< loop filter
  363. #define CODEC_FLAG_H263P_SLICE_STRUCT 0x10000000
  364. #define CODEC_FLAG_INTERLACED_ME 0x20000000 ///< interlaced motion estimation
  365. #define CODEC_FLAG_SVCD_SCAN_OFFSET 0x40000000 ///< Will reserve space for SVCD scan offset user data.
  366. #define CODEC_FLAG_CLOSED_GOP ((int)0x80000000)
  367. #define CODEC_FLAG2_FAST 0x00000001 ///< Allow non spec compliant speedup tricks.
  368. #define CODEC_FLAG2_STRICT_GOP 0x00000002 ///< Strictly enforce GOP size.
  369. #define CODEC_FLAG2_NO_OUTPUT 0x00000004 ///< Skip bitstream encoding.
  370. #define CODEC_FLAG2_LOCAL_HEADER 0x00000008 ///< Place global headers at every keyframe instead of in extradata.
  371. #define CODEC_FLAG2_BPYRAMID 0x00000010 ///< H.264 allow B-frames to be used as references.
  372. #define CODEC_FLAG2_WPRED 0x00000020 ///< H.264 weighted biprediction for B-frames
  373. #define CODEC_FLAG2_MIXED_REFS 0x00000040 ///< H.264 one reference per partition, as opposed to one reference per macroblock
  374. #define CODEC_FLAG2_8X8DCT 0x00000080 ///< H.264 high profile 8x8 transform
  375. #define CODEC_FLAG2_FASTPSKIP 0x00000100 ///< H.264 fast pskip
  376. #define CODEC_FLAG2_AUD 0x00000200 ///< H.264 access unit delimiters
  377. #define CODEC_FLAG2_BRDO 0x00000400 ///< B-frame rate-distortion optimization
  378. #define CODEC_FLAG2_INTRA_VLC 0x00000800 ///< Use MPEG-2 intra VLC table.
  379. #define CODEC_FLAG2_MEMC_ONLY 0x00001000 ///< Only do ME/MC (I frames -> ref, P frame -> ME+MC).
  380. #define CODEC_FLAG2_DROP_FRAME_TIMECODE 0x00002000 ///< timecode is in drop frame format.
  381. #define CODEC_FLAG2_SKIP_RD 0x00004000 ///< RD optimal MB level residual skipping
  382. #define CODEC_FLAG2_CHUNKS 0x00008000 ///< Input bitstream might be truncated at a packet boundaries instead of only at frame boundaries.
  383. #define CODEC_FLAG2_NON_LINEAR_QUANT 0x00010000 ///< Use MPEG-2 nonlinear quantizer.
  384. /* Unsupported options :
  385. * Syntax Arithmetic coding (SAC)
  386. * Reference Picture Selection
  387. * Independent Segment Decoding */
  388. /* /Fx */
  389. /* codec capabilities */
  390. #define CODEC_CAP_DRAW_HORIZ_BAND 0x0001 ///< Decoder can use draw_horiz_band callback.
  391. /**
  392. * Codec uses get_buffer() for allocating buffers.
  393. * direct rendering method 1
  394. */
  395. #define CODEC_CAP_DR1 0x0002
  396. /* If 'parse_only' field is true, then avcodec_parse_frame() can be used. */
  397. #define CODEC_CAP_PARSE_ONLY 0x0004
  398. #define CODEC_CAP_TRUNCATED 0x0008
  399. /* Codec can export data for HW decoding (XvMC). */
  400. #define CODEC_CAP_HWACCEL 0x0010
  401. /**
  402. * Codec has a nonzero delay and needs to be fed with NULL at the end to get the delayed data.
  403. * If this is not set, the codec is guaranteed to never be fed with NULL data.
  404. */
  405. #define CODEC_CAP_DELAY 0x0020
  406. /**
  407. * Codec can be fed a final frame with a smaller size.
  408. * This can be used to prevent truncation of the last audio samples.
  409. */
  410. #define CODEC_CAP_SMALL_LAST_FRAME 0x0040
  411. //The following defines may change, don't expect compatibility if you use them.
  412. #define MB_TYPE_INTRA4x4 0x0001
  413. #define MB_TYPE_INTRA16x16 0x0002 //FIXME H.264-specific
  414. #define MB_TYPE_INTRA_PCM 0x0004 //FIXME H.264-specific
  415. #define MB_TYPE_16x16 0x0008
  416. #define MB_TYPE_16x8 0x0010
  417. #define MB_TYPE_8x16 0x0020
  418. #define MB_TYPE_8x8 0x0040
  419. #define MB_TYPE_INTERLACED 0x0080
  420. #define MB_TYPE_DIRECT2 0x0100 //FIXME
  421. #define MB_TYPE_ACPRED 0x0200
  422. #define MB_TYPE_GMC 0x0400
  423. #define MB_TYPE_SKIP 0x0800
  424. #define MB_TYPE_P0L0 0x1000
  425. #define MB_TYPE_P1L0 0x2000
  426. #define MB_TYPE_P0L1 0x4000
  427. #define MB_TYPE_P1L1 0x8000
  428. #define MB_TYPE_L0 (MB_TYPE_P0L0 | MB_TYPE_P1L0)
  429. #define MB_TYPE_L1 (MB_TYPE_P0L1 | MB_TYPE_P1L1)
  430. #define MB_TYPE_L0L1 (MB_TYPE_L0 | MB_TYPE_L1)
  431. #define MB_TYPE_QUANT 0x00010000
  432. #define MB_TYPE_CBP 0x00020000
  433. //Note bits 24-31 are reserved for codec specific use (h264 ref0, mpeg1 0mv, ...)
  434. /**
  435. * Pan Scan area.
  436. * This specifies the area which should be displayed.
  437. * Note there may be multiple such areas for one frame.
  438. */
  439. typedef struct AVPanScan{
  440. /**
  441. * id
  442. * - encoding: Set by user.
  443. * - decoding: Set by libavcodec.
  444. */
  445. int id;
  446. /**
  447. * width and height in 1/16 pel
  448. * - encoding: Set by user.
  449. * - decoding: Set by libavcodec.
  450. */
  451. int width;
  452. int height;
  453. /**
  454. * position of the top left corner in 1/16 pel for up to 3 fields/frames
  455. * - encoding: Set by user.
  456. * - decoding: Set by libavcodec.
  457. */
  458. int16_t position[3][2];
  459. }AVPanScan;
  460. #define FF_COMMON_FRAME \
  461. /**\
  462. * pointer to the picture planes.\
  463. * This might be different from the first allocated byte\
  464. * - encoding: \
  465. * - decoding: \
  466. */\
  467. uint8_t *data[4];\
  468. int linesize[4];\
  469. /**\
  470. * pointer to the first allocated byte of the picture. Can be used in get_buffer/release_buffer.\
  471. * This isn't used by libavcodec unless the default get/release_buffer() is used.\
  472. * - encoding: \
  473. * - decoding: \
  474. */\
  475. uint8_t *base[4];\
  476. /**\
  477. * 1 -> keyframe, 0-> not\
  478. * - encoding: Set by libavcodec.\
  479. * - decoding: Set by libavcodec.\
  480. */\
  481. int key_frame;\
  482. \
  483. /**\
  484. * Picture type of the frame, see ?_TYPE below.\
  485. * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
  486. * - decoding: Set by libavcodec.\
  487. */\
  488. int pict_type;\
  489. \
  490. /**\
  491. * presentation timestamp in time_base units (time when frame should be shown to user)\
  492. * If AV_NOPTS_VALUE then frame_rate = 1/time_base will be assumed.\
  493. * - encoding: MUST be set by user.\
  494. * - decoding: Set by libavcodec.\
  495. */\
  496. int64_t pts;\
  497. \
  498. /**\
  499. * picture number in bitstream order\
  500. * - encoding: set by\
  501. * - decoding: Set by libavcodec.\
  502. */\
  503. int coded_picture_number;\
  504. /**\
  505. * picture number in display order\
  506. * - encoding: set by\
  507. * - decoding: Set by libavcodec.\
  508. */\
  509. int display_picture_number;\
  510. \
  511. /**\
  512. * quality (between 1 (good) and FF_LAMBDA_MAX (bad)) \
  513. * - encoding: Set by libavcodec. for coded_picture (and set by user for input).\
  514. * - decoding: Set by libavcodec.\
  515. */\
  516. int quality; \
  517. \
  518. /**\
  519. * buffer age (1->was last buffer and dint change, 2->..., ...).\
  520. * Set to INT_MAX if the buffer has not been used yet.\
  521. * - encoding: unused\
  522. * - decoding: MUST be set by get_buffer().\
  523. */\
  524. int age;\
  525. \
  526. /**\
  527. * is this picture used as reference\
  528. * - encoding: unused\
  529. * - decoding: Set by libavcodec. (before get_buffer() call)).\
  530. */\
  531. int reference;\
  532. \
  533. /**\
  534. * QP table\
  535. * - encoding: unused\
  536. * - decoding: Set by libavcodec.\
  537. */\
  538. int8_t *qscale_table;\
  539. /**\
  540. * QP store stride\
  541. * - encoding: unused\
  542. * - decoding: Set by libavcodec.\
  543. */\
  544. int qstride;\
  545. \
  546. /**\
  547. * mbskip_table[mb]>=1 if MB didn't change\
  548. * stride= mb_width = (width+15)>>4\
  549. * - encoding: unused\
  550. * - decoding: Set by libavcodec.\
  551. */\
  552. uint8_t *mbskip_table;\
  553. \
  554. /**\
  555. * motion vector table\
  556. * @code\
  557. * example:\
  558. * int mv_sample_log2= 4 - motion_subsample_log2;\
  559. * int mb_width= (width+15)>>4;\
  560. * int mv_stride= (mb_width << mv_sample_log2) + 1;\
  561. * motion_val[direction][x + y*mv_stride][0->mv_x, 1->mv_y];\
  562. * @endcode\
  563. * - encoding: Set by user.\
  564. * - decoding: Set by libavcodec.\
  565. */\
  566. int16_t (*motion_val[2])[2];\
  567. \
  568. /**\
  569. * macroblock type table\
  570. * mb_type_base + mb_width + 2\
  571. * - encoding: Set by user.\
  572. * - decoding: Set by libavcodec.\
  573. */\
  574. uint32_t *mb_type;\
  575. \
  576. /**\
  577. * log2 of the size of the block which a single vector in motion_val represents: \
  578. * (4->16x16, 3->8x8, 2-> 4x4, 1-> 2x2)\
  579. * - encoding: unused\
  580. * - decoding: Set by libavcodec.\
  581. */\
  582. uint8_t motion_subsample_log2;\
  583. \
  584. /**\
  585. * for some private data of the user\
  586. * - encoding: unused\
  587. * - decoding: Set by user.\
  588. */\
  589. void *opaque;\
  590. \
  591. /**\
  592. * error\
  593. * - encoding: Set by libavcodec. if flags&CODEC_FLAG_PSNR.\
  594. * - decoding: unused\
  595. */\
  596. uint64_t error[4];\
  597. \
  598. /**\
  599. * type of the buffer (to keep track of who has to deallocate data[*])\
  600. * - encoding: Set by the one who allocates it.\
  601. * - decoding: Set by the one who allocates it.\
  602. * Note: User allocated (direct rendering) & internal buffers cannot coexist currently.\
  603. */\
  604. int type;\
  605. \
  606. /**\
  607. * When decoding, this signals how much the picture must be delayed.\
  608. * extra_delay = repeat_pict / (2*fps)\
  609. * - encoding: unused\
  610. * - decoding: Set by libavcodec.\
  611. */\
  612. int repeat_pict;\
  613. \
  614. /**\
  615. * \
  616. */\
  617. int qscale_type;\
  618. \
  619. /**\
  620. * The content of the picture is interlaced.\
  621. * - encoding: Set by user.\
  622. * - decoding: Set by libavcodec. (default 0)\
  623. */\
  624. int interlaced_frame;\
  625. \
  626. /**\
  627. * If the content is interlaced, is top field displayed first.\
  628. * - encoding: Set by user.\
  629. * - decoding: Set by libavcodec.\
  630. */\
  631. int top_field_first;\
  632. \
  633. /**\
  634. * Pan scan.\
  635. * - encoding: Set by user.\
  636. * - decoding: Set by libavcodec.\
  637. */\
  638. AVPanScan *pan_scan;\
  639. \
  640. /**\
  641. * Tell user application that palette has changed from previous frame.\
  642. * - encoding: ??? (no palette-enabled encoder yet)\
  643. * - decoding: Set by libavcodec. (default 0).\
  644. */\
  645. int palette_has_changed;\
  646. \
  647. /**\
  648. * codec suggestion on buffer type if != 0\
  649. * - encoding: unused\
  650. * - decoding: Set by libavcodec. (before get_buffer() call)).\
  651. */\
  652. int buffer_hints;\
  653. \
  654. /**\
  655. * DCT coefficients\
  656. * - encoding: unused\
  657. * - decoding: Set by libavcodec.\
  658. */\
  659. short *dct_coeff;\
  660. \
  661. /**\
  662. * motion referece frame index\
  663. * - encoding: Set by user.\
  664. * - decoding: Set by libavcodec.\
  665. */\
  666. int8_t *ref_index[2];
  667. #define FF_QSCALE_TYPE_MPEG1 0
  668. #define FF_QSCALE_TYPE_MPEG2 1
  669. #define FF_QSCALE_TYPE_H264 2
  670. #define FF_BUFFER_TYPE_INTERNAL 1
  671. #define FF_BUFFER_TYPE_USER 2 ///< direct rendering buffers (image is (de)allocated by user)
  672. #define FF_BUFFER_TYPE_SHARED 4 ///< Buffer from somewhere else; don't deallocate image (data/base), all other tables are not shared.
  673. #define FF_BUFFER_TYPE_COPY 8 ///< Just a (modified) copy of some other buffer, don't deallocate anything.
  674. #define FF_I_TYPE 1 // Intra
  675. #define FF_P_TYPE 2 // Predicted
  676. #define FF_B_TYPE 3 // Bi-dir predicted
  677. #define FF_S_TYPE 4 // S(GMC)-VOP MPEG4
  678. #define FF_SI_TYPE 5
  679. #define FF_SP_TYPE 6
  680. #define FF_BUFFER_HINTS_VALID 0x01 // Buffer hints value is meaningful (if 0 ignore).
  681. #define FF_BUFFER_HINTS_READABLE 0x02 // Codec will read from buffer.
  682. #define FF_BUFFER_HINTS_PRESERVE 0x04 // User must not alter buffer content.
  683. #define FF_BUFFER_HINTS_REUSABLE 0x08 // Codec will reuse the buffer (update).
  684. /**
  685. * Audio Video Frame.
  686. */
  687. typedef struct AVFrame {
  688. FF_COMMON_FRAME
  689. } AVFrame;
  690. #define DEFAULT_FRAME_RATE_BASE 1001000
  691. /**
  692. * main external API structure
  693. */
  694. typedef struct AVCodecContext {
  695. /**
  696. * information on struct for av_log
  697. * - set by avcodec_alloc_context
  698. */
  699. AVClass *av_class;
  700. /**
  701. * the average bitrate
  702. * - encoding: Set by user; unused for constant quantizer encoding.
  703. * - decoding: Set by libavcodec. 0 or some bitrate if this info is available in the stream.
  704. */
  705. int bit_rate;
  706. /**
  707. * number of bits the bitstream is allowed to diverge from the reference.
  708. * the reference can be CBR (for CBR pass1) or VBR (for pass2)
  709. * - encoding: Set by user; unused for constant quantizer encoding.
  710. * - decoding: unused
  711. */
  712. int bit_rate_tolerance;
  713. /**
  714. * CODEC_FLAG_*.
  715. * - encoding: Set by user.
  716. * - decoding: Set by user.
  717. */
  718. int flags;
  719. /**
  720. * Some codecs need additional format info. It is stored here.
  721. * If any muxer uses this then ALL demuxers/parsers AND encoders for the
  722. * specific codec MUST set it correctly otherwise stream copy breaks.
  723. * In general use of this field by muxers is not recommanded.
  724. * - encoding: Set by libavcodec.
  725. * - decoding: Set by libavcodec. (FIXME: Is this OK?)
  726. */
  727. int sub_id;
  728. /**
  729. * Motion estimation algorithm used for video coding.
  730. * 1 (zero), 2 (full), 3 (log), 4 (phods), 5 (epzs), 6 (x1), 7 (hex),
  731. * 8 (umh), 9 (iter) [7, 8 are x264 specific, 9 is snow specific]
  732. * - encoding: MUST be set by user.
  733. * - decoding: unused
  734. */
  735. int me_method;
  736. /**
  737. * some codecs need / can use extradata like Huffman tables.
  738. * mjpeg: Huffman tables
  739. * rv10: additional flags
  740. * mpeg4: global headers (they can be in the bitstream or here)
  741. * The allocated memory should be FF_INPUT_BUFFER_PADDING_SIZE bytes larger
  742. * than extradata_size to avoid prolems if it is read with the bitstream reader.
  743. * The bytewise contents of extradata must not depend on the architecture or CPU endianness.
  744. * - encoding: Set/allocated/freed by libavcodec.
  745. * - decoding: Set/allocated/freed by user.
  746. */
  747. uint8_t *extradata;
  748. int extradata_size;
  749. /**
  750. * This is the fundamental unit of time (in seconds) in terms
  751. * of which frame timestamps are represented. For fixed-fps content,
  752. * timebase should be 1/framerate and timestamp increments should be
  753. * identically 1.
  754. * - encoding: MUST be set by user.
  755. * - decoding: Set by libavcodec.
  756. */
  757. AVRational time_base;
  758. /* video only */
  759. /**
  760. * picture width / height.
  761. * - encoding: MUST be set by user.
  762. * - decoding: Set by libavcodec.
  763. * Note: For compatibility it is possible to set this instead of
  764. * coded_width/height before decoding.
  765. */
  766. int width, height;
  767. #define FF_ASPECT_EXTENDED 15
  768. /**
  769. * the number of pictures in a group of pictures, or 0 for intra_only
  770. * - encoding: Set by user.
  771. * - decoding: unused
  772. */
  773. int gop_size;
  774. /**
  775. * Pixel format, see PIX_FMT_xxx.
  776. * - encoding: Set by user.
  777. * - decoding: Set by libavcodec.
  778. */
  779. enum PixelFormat pix_fmt;
  780. /**
  781. * Frame rate emulation. If not zero, the lower layer (i.e. format handler)
  782. * has to read frames at native frame rate.
  783. * - encoding: Set by user.
  784. * - decoding: unused
  785. */
  786. int rate_emu;
  787. /**
  788. * If non NULL, 'draw_horiz_band' is called by the libavcodec
  789. * decoder to draw a horizontal band. It improves cache usage. Not
  790. * all codecs can do that. You must check the codec capabilities
  791. * beforehand.
  792. * - encoding: unused
  793. * - decoding: Set by user.
  794. * @param height the height of the slice
  795. * @param y the y position of the slice
  796. * @param type 1->top field, 2->bottom field, 3->frame
  797. * @param offset offset into the AVFrame.data from which the slice should be read
  798. */
  799. void (*draw_horiz_band)(struct AVCodecContext *s,
  800. const AVFrame *src, int offset[4],
  801. int y, int type, int height);
  802. /* audio only */
  803. int sample_rate; ///< samples per second
  804. int channels;
  805. /**
  806. * audio sample format
  807. * - encoding: Set by user.
  808. * - decoding: Set by libavcodec.
  809. */
  810. enum SampleFormat sample_fmt; ///< sample format, currently unused
  811. /* The following data should not be initialized. */
  812. /**
  813. * Samples per packet, initialized when calling 'init'.
  814. */
  815. int frame_size;
  816. int frame_number; ///< audio or video frame number
  817. int real_pict_num; ///< Returns the real picture number of previous encoded frame.
  818. /**
  819. * Number of frames the decoded output will be delayed relative to
  820. * the encoded input.
  821. * - encoding: Set by libavcodec.
  822. * - decoding: unused
  823. */
  824. int delay;
  825. /* - encoding parameters */
  826. float qcompress; ///< amount of qscale change between easy & hard scenes (0.0-1.0)
  827. float qblur; ///< amount of qscale smoothing over time (0.0-1.0)
  828. /**
  829. * minimum quantizer
  830. * - encoding: Set by user.
  831. * - decoding: unused
  832. */
  833. int qmin;
  834. /**
  835. * maximum quantizer
  836. * - encoding: Set by user.
  837. * - decoding: unused
  838. */
  839. int qmax;
  840. /**
  841. * maximum quantizer difference between frames
  842. * - encoding: Set by user.
  843. * - decoding: unused
  844. */
  845. int max_qdiff;
  846. /**
  847. * maximum number of B-frames between non-B-frames
  848. * Note: The output will be delayed by max_b_frames+1 relative to the input.
  849. * - encoding: Set by user.
  850. * - decoding: unused
  851. */
  852. int max_b_frames;
  853. /**
  854. * qscale factor between IP and B-frames
  855. * - encoding: Set by user.
  856. * - decoding: unused
  857. */
  858. float b_quant_factor;
  859. /** obsolete FIXME remove */
  860. int rc_strategy;
  861. #define FF_RC_STRATEGY_XVID 1
  862. int b_frame_strategy;
  863. /**
  864. * hurry up amount
  865. * - encoding: unused
  866. * - decoding: Set by user. 1-> Skip B-frames, 2-> Skip IDCT/dequant too, 5-> Skip everything except header
  867. * @deprecated Deprecated in favor of skip_idct and skip_frame.
  868. */
  869. int hurry_up;
  870. struct AVCodec *codec;
  871. void *priv_data;
  872. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  873. /* unused, FIXME remove*/
  874. int rtp_mode;
  875. #endif
  876. int rtp_payload_size; /* The size of the RTP payload: the coder will */
  877. /* do its best to deliver a chunk with size */
  878. /* below rtp_payload_size, the chunk will start */
  879. /* with a start code on some codecs like H.263. */
  880. /* This doesn't take account of any particular */
  881. /* headers inside the transmitted RTP payload. */
  882. /* The RTP callback: This function is called */
  883. /* every time the encoder has a packet to send. */
  884. /* It depends on the encoder if the data starts */
  885. /* with a Start Code (it should). H.263 does. */
  886. /* mb_nb contains the number of macroblocks */
  887. /* encoded in the RTP payload. */
  888. void (*rtp_callback)(struct AVCodecContext *avctx, void *data, int size, int mb_nb);
  889. /* statistics, used for 2-pass encoding */
  890. int mv_bits;
  891. int header_bits;
  892. int i_tex_bits;
  893. int p_tex_bits;
  894. int i_count;
  895. int p_count;
  896. int skip_count;
  897. int misc_bits;
  898. /**
  899. * number of bits used for the previously encoded frame
  900. * - encoding: Set by libavcodec.
  901. * - decoding: unused
  902. */
  903. int frame_bits;
  904. /**
  905. * Private data of the user, can be used to carry app specific stuff.
  906. * - encoding: Set by user.
  907. * - decoding: Set by user.
  908. */
  909. void *opaque;
  910. char codec_name[32];
  911. enum CodecType codec_type; /* see CODEC_TYPE_xxx */
  912. enum CodecID codec_id; /* see CODEC_ID_xxx */
  913. /**
  914. * fourcc (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
  915. * This is used to work around some encoder bugs.
  916. * A demuxer should set this to what is stored in the field used to identify the codec.
  917. * If there are multiple such fields in a container then the demuxer should choose the one
  918. * which maximizes the information about the used codec.
  919. * If the codec tag field in a container is larger then 32 bits then the demuxer should
  920. * remap the longer ID to 32 bits with a table or other structure. Alternatively a new
  921. * extra_codec_tag + size could be added but for this a clear advantage must be demonstrated
  922. * first.
  923. * - encoding: Set by user, if not then the default based on codec_id will be used.
  924. * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
  925. */
  926. unsigned int codec_tag;
  927. /**
  928. * Work around bugs in encoders which sometimes cannot be detected automatically.
  929. * - encoding: Set by user
  930. * - decoding: Set by user
  931. */
  932. int workaround_bugs;
  933. #define FF_BUG_AUTODETECT 1 ///< autodetection
  934. #define FF_BUG_OLD_MSMPEG4 2
  935. #define FF_BUG_XVID_ILACE 4
  936. #define FF_BUG_UMP4 8
  937. #define FF_BUG_NO_PADDING 16
  938. #define FF_BUG_AMV 32
  939. #define FF_BUG_AC_VLC 0 ///< Will be removed, libavcodec can now handle these non-compliant files by default.
  940. #define FF_BUG_QPEL_CHROMA 64
  941. #define FF_BUG_STD_QPEL 128
  942. #define FF_BUG_QPEL_CHROMA2 256
  943. #define FF_BUG_DIRECT_BLOCKSIZE 512
  944. #define FF_BUG_EDGE 1024
  945. #define FF_BUG_HPEL_CHROMA 2048
  946. #define FF_BUG_DC_CLIP 4096
  947. #define FF_BUG_MS 8192 ///< Work around various bugs in Microsoft's broken decoders.
  948. //#define FF_BUG_FAKE_SCALABILITY 16 //Autodetection should work 100%.
  949. /**
  950. * luma single coefficient elimination threshold
  951. * - encoding: Set by user.
  952. * - decoding: unused
  953. */
  954. int luma_elim_threshold;
  955. /**
  956. * chroma single coeff elimination threshold
  957. * - encoding: Set by user.
  958. * - decoding: unused
  959. */
  960. int chroma_elim_threshold;
  961. /**
  962. * strictly follow the standard (MPEG4, ...).
  963. * - encoding: Set by user.
  964. * - decoding: unused
  965. */
  966. int strict_std_compliance;
  967. #define FF_COMPLIANCE_VERY_STRICT 2 ///< Strictly conform to a older more strict version of the spec or reference software.
  968. #define FF_COMPLIANCE_STRICT 1 ///< Strictly conform to all the things in the spec no matter what consequences.
  969. #define FF_COMPLIANCE_NORMAL 0
  970. #define FF_COMPLIANCE_INOFFICIAL -1 ///< Allow inofficial extensions.
  971. #define FF_COMPLIANCE_EXPERIMENTAL -2 ///< Allow nonstandardized experimental things.
  972. /**
  973. * qscale offset between IP and B-frames
  974. * If > 0 then the last P-frame quantizer will be used (q= lastp_q*factor+offset).
  975. * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
  976. * - encoding: Set by user.
  977. * - decoding: unused
  978. */
  979. float b_quant_offset;
  980. /**
  981. * Error resilience; higher values will detect more errors but may
  982. * misdetect some more or less valid parts as errors.
  983. * - encoding: unused
  984. * - decoding: Set by user.
  985. */
  986. int error_resilience;
  987. #define FF_ER_CAREFUL 1
  988. #define FF_ER_COMPLIANT 2
  989. #define FF_ER_AGGRESSIVE 3
  990. #define FF_ER_VERY_AGGRESSIVE 4
  991. /**
  992. * Called at the beginning of each frame to get a buffer for it.
  993. * If pic.reference is set then the frame will be read later by libavcodec.
  994. * avcodec_align_dimensions() should be used to find the required width and
  995. * height, as they normally need to be rounded up to the next multiple of 16.
  996. * - encoding: unused
  997. * - decoding: Set by libavcodec., user can override.
  998. */
  999. int (*get_buffer)(struct AVCodecContext *c, AVFrame *pic);
  1000. /**
  1001. * Called to release buffers which where allocated with get_buffer.
  1002. * A released buffer can be reused in get_buffer().
  1003. * pic.data[*] must be set to NULL.
  1004. * - encoding: unused
  1005. * - decoding: Set by libavcodec., user can override.
  1006. */
  1007. void (*release_buffer)(struct AVCodecContext *c, AVFrame *pic);
  1008. /**
  1009. * If 1 the stream has a 1 frame delay during decoding.
  1010. * - encoding: Set by libavcodec.
  1011. * - decoding: Set by libavcodec.
  1012. */
  1013. int has_b_frames;
  1014. /**
  1015. * number of bytes per packet if constant and known or 0
  1016. * Used by some WAV based audio codecs.
  1017. */
  1018. int block_align;
  1019. int parse_only; /* - decoding only: If true, only parsing is done
  1020. (function avcodec_parse_frame()). The frame
  1021. data is returned. Only MPEG codecs support this now. */
  1022. /**
  1023. * 0-> h263 quant 1-> mpeg quant
  1024. * - encoding: Set by user.
  1025. * - decoding: unused
  1026. */
  1027. int mpeg_quant;
  1028. /**
  1029. * pass1 encoding statistics output buffer
  1030. * - encoding: Set by libavcodec.
  1031. * - decoding: unused
  1032. */
  1033. char *stats_out;
  1034. /**
  1035. * pass2 encoding statistics input buffer
  1036. * Concatenated stuff from stats_out of pass1 should be placed here.
  1037. * - encoding: Allocated/set/freed by user.
  1038. * - decoding: unused
  1039. */
  1040. char *stats_in;
  1041. /**
  1042. * ratecontrol qmin qmax limiting method
  1043. * 0-> clipping, 1-> use a nice continous function to limit qscale wthin qmin/qmax.
  1044. * - encoding: Set by user.
  1045. * - decoding: unused
  1046. */
  1047. float rc_qsquish;
  1048. float rc_qmod_amp;
  1049. int rc_qmod_freq;
  1050. /**
  1051. * ratecontrol override, see RcOverride
  1052. * - encoding: Allocated/set/freed by user.
  1053. * - decoding: unused
  1054. */
  1055. RcOverride *rc_override;
  1056. int rc_override_count;
  1057. /**
  1058. * rate control equation
  1059. * - encoding: Set by user
  1060. * - decoding: unused
  1061. */
  1062. char *rc_eq;
  1063. /**
  1064. * maximum bitrate
  1065. * - encoding: Set by user.
  1066. * - decoding: unused
  1067. */
  1068. int rc_max_rate;
  1069. /**
  1070. * minimum bitrate
  1071. * - encoding: Set by user.
  1072. * - decoding: unused
  1073. */
  1074. int rc_min_rate;
  1075. /**
  1076. * decoder bitstream buffer size
  1077. * - encoding: Set by user.
  1078. * - decoding: unused
  1079. */
  1080. int rc_buffer_size;
  1081. float rc_buffer_aggressivity;
  1082. /**
  1083. * qscale factor between P and I-frames
  1084. * If > 0 then the last p frame quantizer will be used (q= lastp_q*factor+offset).
  1085. * If < 0 then normal ratecontrol will be done (q= -normal_q*factor+offset).
  1086. * - encoding: Set by user.
  1087. * - decoding: unused
  1088. */
  1089. float i_quant_factor;
  1090. /**
  1091. * qscale offset between P and I-frames
  1092. * - encoding: Set by user.
  1093. * - decoding: unused
  1094. */
  1095. float i_quant_offset;
  1096. /**
  1097. * initial complexity for pass1 ratecontrol
  1098. * - encoding: Set by user.
  1099. * - decoding: unused
  1100. */
  1101. float rc_initial_cplx;
  1102. /**
  1103. * DCT algorithm, see FF_DCT_* below
  1104. * - encoding: Set by user.
  1105. * - decoding: unused
  1106. */
  1107. int dct_algo;
  1108. #define FF_DCT_AUTO 0
  1109. #define FF_DCT_FASTINT 1
  1110. #define FF_DCT_INT 2
  1111. #define FF_DCT_MMX 3
  1112. #define FF_DCT_MLIB 4
  1113. #define FF_DCT_ALTIVEC 5
  1114. #define FF_DCT_FAAN 6
  1115. /**
  1116. * luminance masking (0-> disabled)
  1117. * - encoding: Set by user.
  1118. * - decoding: unused
  1119. */
  1120. float lumi_masking;
  1121. /**
  1122. * temporary complexity masking (0-> disabled)
  1123. * - encoding: Set by user.
  1124. * - decoding: unused
  1125. */
  1126. float temporal_cplx_masking;
  1127. /**
  1128. * spatial complexity masking (0-> disabled)
  1129. * - encoding: Set by user.
  1130. * - decoding: unused
  1131. */
  1132. float spatial_cplx_masking;
  1133. /**
  1134. * p block masking (0-> disabled)
  1135. * - encoding: Set by user.
  1136. * - decoding: unused
  1137. */
  1138. float p_masking;
  1139. /**
  1140. * darkness masking (0-> disabled)
  1141. * - encoding: Set by user.
  1142. * - decoding: unused
  1143. */
  1144. float dark_masking;
  1145. /* for binary compatibility */
  1146. int unused;
  1147. /**
  1148. * IDCT algorithm, see FF_IDCT_* below.
  1149. * - encoding: Set by user.
  1150. * - decoding: Set by user.
  1151. */
  1152. int idct_algo;
  1153. #define FF_IDCT_AUTO 0
  1154. #define FF_IDCT_INT 1
  1155. #define FF_IDCT_SIMPLE 2
  1156. #define FF_IDCT_SIMPLEMMX 3
  1157. #define FF_IDCT_LIBMPEG2MMX 4
  1158. #define FF_IDCT_PS2 5
  1159. #define FF_IDCT_MLIB 6
  1160. #define FF_IDCT_ARM 7
  1161. #define FF_IDCT_ALTIVEC 8
  1162. #define FF_IDCT_SH4 9
  1163. #define FF_IDCT_SIMPLEARM 10
  1164. #define FF_IDCT_H264 11
  1165. #define FF_IDCT_VP3 12
  1166. #define FF_IDCT_IPP 13
  1167. #define FF_IDCT_XVIDMMX 14
  1168. #define FF_IDCT_CAVS 15
  1169. #define FF_IDCT_SIMPLEARMV5TE 16
  1170. #define FF_IDCT_SIMPLEARMV6 17
  1171. /**
  1172. * slice count
  1173. * - encoding: Set by libavcodec.
  1174. * - decoding: Set by user (or 0).
  1175. */
  1176. int slice_count;
  1177. /**
  1178. * slice offsets in the frame in bytes
  1179. * - encoding: Set/allocated by libavcodec.
  1180. * - decoding: Set/allocated by user (or NULL).
  1181. */
  1182. int *slice_offset;
  1183. /**
  1184. * error concealment flags
  1185. * - encoding: unused
  1186. * - decoding: Set by user.
  1187. */
  1188. int error_concealment;
  1189. #define FF_EC_GUESS_MVS 1
  1190. #define FF_EC_DEBLOCK 2
  1191. /**
  1192. * dsp_mask could be add used to disable unwanted CPU features
  1193. * CPU features (i.e. MMX, SSE. ...)
  1194. *
  1195. * With the FORCE flag you may instead enable given CPU features.
  1196. * (Dangerous: Usable in case of misdetection, improper usage however will
  1197. * result into program crash.)
  1198. */
  1199. unsigned dsp_mask;
  1200. #define FF_MM_FORCE 0x80000000 /* Force usage of selected flags (OR) */
  1201. /* lower 16 bits - CPU features */
  1202. #define FF_MM_MMX 0x0001 /* standard MMX */
  1203. #define FF_MM_3DNOW 0x0004 /* AMD 3DNOW */
  1204. #define FF_MM_MMXEXT 0x0002 /* SSE integer functions or AMD MMX ext */
  1205. #define FF_MM_SSE 0x0008 /* SSE functions */
  1206. #define FF_MM_SSE2 0x0010 /* PIV SSE2 functions */
  1207. #define FF_MM_3DNOWEXT 0x0020 /* AMD 3DNowExt */
  1208. #define FF_MM_SSE3 0x0040 /* Prescott SSE3 functions */
  1209. #define FF_MM_SSSE3 0x0080 /* Conroe SSSE3 functions */
  1210. #define FF_MM_IWMMXT 0x0100 /* XScale IWMMXT */
  1211. /**
  1212. * bits per sample/pixel from the demuxer (needed for huffyuv).
  1213. * - encoding: Set by libavcodec.
  1214. * - decoding: Set by user.
  1215. */
  1216. int bits_per_sample;
  1217. /**
  1218. * prediction method (needed for huffyuv)
  1219. * - encoding: Set by user.
  1220. * - decoding: unused
  1221. */
  1222. int prediction_method;
  1223. #define FF_PRED_LEFT 0
  1224. #define FF_PRED_PLANE 1
  1225. #define FF_PRED_MEDIAN 2
  1226. /**
  1227. * sample aspect ratio (0 if unknown)
  1228. * Numerator and denominator must be relatively prime and smaller than 256 for some video standards.
  1229. * - encoding: Set by user.
  1230. * - decoding: Set by libavcodec.
  1231. */
  1232. AVRational sample_aspect_ratio;
  1233. /**
  1234. * the picture in the bitstream
  1235. * - encoding: Set by libavcodec.
  1236. * - decoding: Set by libavcodec.
  1237. */
  1238. AVFrame *coded_frame;
  1239. /**
  1240. * debug
  1241. * - encoding: Set by user.
  1242. * - decoding: Set by user.
  1243. */
  1244. int debug;
  1245. #define FF_DEBUG_PICT_INFO 1
  1246. #define FF_DEBUG_RC 2
  1247. #define FF_DEBUG_BITSTREAM 4
  1248. #define FF_DEBUG_MB_TYPE 8
  1249. #define FF_DEBUG_QP 16
  1250. #define FF_DEBUG_MV 32
  1251. #define FF_DEBUG_DCT_COEFF 0x00000040
  1252. #define FF_DEBUG_SKIP 0x00000080
  1253. #define FF_DEBUG_STARTCODE 0x00000100
  1254. #define FF_DEBUG_PTS 0x00000200
  1255. #define FF_DEBUG_ER 0x00000400
  1256. #define FF_DEBUG_MMCO 0x00000800
  1257. #define FF_DEBUG_BUGS 0x00001000
  1258. #define FF_DEBUG_VIS_QP 0x00002000
  1259. #define FF_DEBUG_VIS_MB_TYPE 0x00004000
  1260. /**
  1261. * debug
  1262. * - encoding: Set by user.
  1263. * - decoding: Set by user.
  1264. */
  1265. int debug_mv;
  1266. #define FF_DEBUG_VIS_MV_P_FOR 0x00000001 //visualize forward predicted MVs of P frames
  1267. #define FF_DEBUG_VIS_MV_B_FOR 0x00000002 //visualize forward predicted MVs of B frames
  1268. #define FF_DEBUG_VIS_MV_B_BACK 0x00000004 //visualize backward predicted MVs of B frames
  1269. /**
  1270. * error
  1271. * - encoding: Set by libavcodec if flags&CODEC_FLAG_PSNR.
  1272. * - decoding: unused
  1273. */
  1274. uint64_t error[4];
  1275. /**
  1276. * minimum MB quantizer
  1277. * - encoding: unused
  1278. * - decoding: unused
  1279. */
  1280. int mb_qmin;
  1281. /**
  1282. * maximum MB quantizer
  1283. * - encoding: unused
  1284. * - decoding: unused
  1285. */
  1286. int mb_qmax;
  1287. /**
  1288. * motion estimation comparison function
  1289. * - encoding: Set by user.
  1290. * - decoding: unused
  1291. */
  1292. int me_cmp;
  1293. /**
  1294. * subpixel motion estimation comparison function
  1295. * - encoding: Set by user.
  1296. * - decoding: unused
  1297. */
  1298. int me_sub_cmp;
  1299. /**
  1300. * macroblock comparison function (not supported yet)
  1301. * - encoding: Set by user.
  1302. * - decoding: unused
  1303. */
  1304. int mb_cmp;
  1305. /**
  1306. * interlaced DCT comparison function
  1307. * - encoding: Set by user.
  1308. * - decoding: unused
  1309. */
  1310. int ildct_cmp;
  1311. #define FF_CMP_SAD 0
  1312. #define FF_CMP_SSE 1
  1313. #define FF_CMP_SATD 2
  1314. #define FF_CMP_DCT 3
  1315. #define FF_CMP_PSNR 4
  1316. #define FF_CMP_BIT 5
  1317. #define FF_CMP_RD 6
  1318. #define FF_CMP_ZERO 7
  1319. #define FF_CMP_VSAD 8
  1320. #define FF_CMP_VSSE 9
  1321. #define FF_CMP_NSSE 10
  1322. #define FF_CMP_W53 11
  1323. #define FF_CMP_W97 12
  1324. #define FF_CMP_DCTMAX 13
  1325. #define FF_CMP_DCT264 14
  1326. #define FF_CMP_CHROMA 256
  1327. /**
  1328. * ME diamond size & shape
  1329. * - encoding: Set by user.
  1330. * - decoding: unused
  1331. */
  1332. int dia_size;
  1333. /**
  1334. * amount of previous MV predictors (2a+1 x 2a+1 square)
  1335. * - encoding: Set by user.
  1336. * - decoding: unused
  1337. */
  1338. int last_predictor_count;
  1339. /**
  1340. * prepass for motion estimation
  1341. * - encoding: Set by user.
  1342. * - decoding: unused
  1343. */
  1344. int pre_me;
  1345. /**
  1346. * motion estimation prepass comparison function
  1347. * - encoding: Set by user.
  1348. * - decoding: unused
  1349. */
  1350. int me_pre_cmp;
  1351. /**
  1352. * ME prepass diamond size & shape
  1353. * - encoding: Set by user.
  1354. * - decoding: unused
  1355. */
  1356. int pre_dia_size;
  1357. /**
  1358. * subpel ME quality
  1359. * - encoding: Set by user.
  1360. * - decoding: unused
  1361. */
  1362. int me_subpel_quality;
  1363. /**
  1364. * callback to negotiate the pixelFormat
  1365. * @param fmt is the list of formats which are supported by the codec,
  1366. * it is terminated by -1 as 0 is a valid format, the formats are ordered by quality.
  1367. * The first is always the native one.
  1368. * @return the chosen format
  1369. * - encoding: unused
  1370. * - decoding: Set by user, if not set the native format will be chosen.
  1371. */
  1372. enum PixelFormat (*get_format)(struct AVCodecContext *s, const enum PixelFormat * fmt);
  1373. /**
  1374. * DTG active format information (additional aspect ratio
  1375. * information only used in DVB MPEG-2 transport streams)
  1376. * 0 if not set.
  1377. *
  1378. * - encoding: unused
  1379. * - decoding: Set by decoder.
  1380. */
  1381. int dtg_active_format;
  1382. #define FF_DTG_AFD_SAME 8
  1383. #define FF_DTG_AFD_4_3 9
  1384. #define FF_DTG_AFD_16_9 10
  1385. #define FF_DTG_AFD_14_9 11
  1386. #define FF_DTG_AFD_4_3_SP_14_9 13
  1387. #define FF_DTG_AFD_16_9_SP_14_9 14
  1388. #define FF_DTG_AFD_SP_4_3 15
  1389. /**
  1390. * maximum motion estimation search range in subpel units
  1391. * If 0 then no limit.
  1392. *
  1393. * - encoding: Set by user.
  1394. * - decoding: unused
  1395. */
  1396. int me_range;
  1397. /**
  1398. * intra quantizer bias
  1399. * - encoding: Set by user.
  1400. * - decoding: unused
  1401. */
  1402. int intra_quant_bias;
  1403. #define FF_DEFAULT_QUANT_BIAS 999999
  1404. /**
  1405. * inter quantizer bias
  1406. * - encoding: Set by user.
  1407. * - decoding: unused
  1408. */
  1409. int inter_quant_bias;
  1410. /**
  1411. * color table ID
  1412. * - encoding: unused
  1413. * - decoding: Which clrtable should be used for 8bit RGB images.
  1414. * Tables have to be stored somewhere. FIXME
  1415. */
  1416. int color_table_id;
  1417. /**
  1418. * internal_buffer count
  1419. * Don't touch, used by libavcodec default_get_buffer().
  1420. */
  1421. int internal_buffer_count;
  1422. /**
  1423. * internal_buffers
  1424. * Don't touch, used by libavcodec default_get_buffer().
  1425. */
  1426. void *internal_buffer;
  1427. #define FF_LAMBDA_SHIFT 7
  1428. #define FF_LAMBDA_SCALE (1<<FF_LAMBDA_SHIFT)
  1429. #define FF_QP2LAMBDA 118 ///< factor to convert from H.263 QP to lambda
  1430. #define FF_LAMBDA_MAX (256*128-1)
  1431. #define FF_QUALITY_SCALE FF_LAMBDA_SCALE //FIXME maybe remove
  1432. /**
  1433. * Global quality for codecs which cannot change it per frame.
  1434. * This should be proportional to MPEG-1/2/4 qscale.
  1435. * - encoding: Set by user.
  1436. * - decoding: unused
  1437. */
  1438. int global_quality;
  1439. #define FF_CODER_TYPE_VLC 0
  1440. #define FF_CODER_TYPE_AC 1
  1441. #define FF_CODER_TYPE_RAW 2
  1442. #define FF_CODER_TYPE_RLE 3
  1443. #define FF_CODER_TYPE_DEFLATE 4
  1444. /**
  1445. * coder type
  1446. * - encoding: Set by user.
  1447. * - decoding: unused
  1448. */
  1449. int coder_type;
  1450. /**
  1451. * context model
  1452. * - encoding: Set by user.
  1453. * - decoding: unused
  1454. */
  1455. int context_model;
  1456. #if 0
  1457. /**
  1458. *
  1459. * - encoding: unused
  1460. * - decoding: Set by user.
  1461. */
  1462. uint8_t * (*realloc)(struct AVCodecContext *s, uint8_t *buf, int buf_size);
  1463. #endif
  1464. /**
  1465. * slice flags
  1466. * - encoding: unused
  1467. * - decoding: Set by user.
  1468. */
  1469. int slice_flags;
  1470. #define SLICE_FLAG_CODED_ORDER 0x0001 ///< draw_horiz_band() is called in coded order instead of display
  1471. #define SLICE_FLAG_ALLOW_FIELD 0x0002 ///< allow draw_horiz_band() with field slices (MPEG2 field pics)
  1472. #define SLICE_FLAG_ALLOW_PLANE 0x0004 ///< allow draw_horiz_band() with 1 component at a time (SVQ1)
  1473. /**
  1474. * XVideo Motion Acceleration
  1475. * - encoding: forbidden
  1476. * - decoding: set by decoder
  1477. */
  1478. int xvmc_acceleration;
  1479. /**
  1480. * macroblock decision mode
  1481. * - encoding: Set by user.
  1482. * - decoding: unused
  1483. */
  1484. int mb_decision;
  1485. #define FF_MB_DECISION_SIMPLE 0 ///< uses mb_cmp
  1486. #define FF_MB_DECISION_BITS 1 ///< chooses the one which needs the fewest bits
  1487. #define FF_MB_DECISION_RD 2 ///< rate distoration
  1488. /**
  1489. * custom intra quantization matrix
  1490. * - encoding: Set by user, can be NULL.
  1491. * - decoding: Set by libavcodec.
  1492. */
  1493. uint16_t *intra_matrix;
  1494. /**
  1495. * custom inter quantization matrix
  1496. * - encoding: Set by user, can be NULL.
  1497. * - decoding: Set by libavcodec.
  1498. */
  1499. uint16_t *inter_matrix;
  1500. /**
  1501. * fourcc from the AVI stream header (LSB first, so "ABCD" -> ('D'<<24) + ('C'<<16) + ('B'<<8) + 'A').
  1502. * This is used to work around some encoder bugs.
  1503. * - encoding: unused
  1504. * - decoding: Set by user, will be converted to uppercase by libavcodec during init.
  1505. */
  1506. unsigned int stream_codec_tag;
  1507. /**
  1508. * scene change detection threshold
  1509. * 0 is default, larger means fewer detected scene changes.
  1510. * - encoding: Set by user.
  1511. * - decoding: unused
  1512. */
  1513. int scenechange_threshold;
  1514. /**
  1515. * minimum Lagrange multipler
  1516. * - encoding: Set by user.
  1517. * - decoding: unused
  1518. */
  1519. int lmin;
  1520. /**
  1521. * maximum Lagrange multipler
  1522. * - encoding: Set by user.
  1523. * - decoding: unused
  1524. */
  1525. int lmax;
  1526. /**
  1527. * palette control structure
  1528. * - encoding: ??? (no palette-enabled encoder yet)
  1529. * - decoding: Set by user.
  1530. */
  1531. struct AVPaletteControl *palctrl;
  1532. /**
  1533. * noise reduction strength
  1534. * - encoding: Set by user.
  1535. * - decoding: unused
  1536. */
  1537. int noise_reduction;
  1538. /**
  1539. * Called at the beginning of a frame to get cr buffer for it.
  1540. * Buffer type (size, hints) must be the same. libavcodec won't check it.
  1541. * libavcodec will pass previous buffer in pic, function should return
  1542. * same buffer or new buffer with old frame "painted" into it.
  1543. * If pic.data[0] == NULL must behave like get_buffer().
  1544. * - encoding: unused
  1545. * - decoding: Set by libavcodec., user can override
  1546. */
  1547. int (*reget_buffer)(struct AVCodecContext *c, AVFrame *pic);
  1548. /**
  1549. * Number of bits which should be loaded into the rc buffer before decoding starts.
  1550. * - encoding: Set by user.
  1551. * - decoding: unused
  1552. */
  1553. int rc_initial_buffer_occupancy;
  1554. /**
  1555. *
  1556. * - encoding: Set by user.
  1557. * - decoding: unused
  1558. */
  1559. int inter_threshold;
  1560. /**
  1561. * CODEC_FLAG2_*
  1562. * - encoding: Set by user.
  1563. * - decoding: Set by user.
  1564. */
  1565. int flags2;
  1566. /**
  1567. * Simulates errors in the bitstream to test error concealment.
  1568. * - encoding: Set by user.
  1569. * - decoding: unused
  1570. */
  1571. int error_rate;
  1572. /**
  1573. * MP3 antialias algorithm, see FF_AA_* below.
  1574. * - encoding: unused
  1575. * - decoding: Set by user.
  1576. */
  1577. int antialias_algo;
  1578. #define FF_AA_AUTO 0
  1579. #define FF_AA_FASTINT 1 //not implemented yet
  1580. #define FF_AA_INT 2
  1581. #define FF_AA_FLOAT 3
  1582. /**
  1583. * quantizer noise shaping
  1584. * - encoding: Set by user.
  1585. * - decoding: unused
  1586. */
  1587. int quantizer_noise_shaping;
  1588. /**
  1589. * thread count
  1590. * is used to decide how many independent tasks should be passed to execute()
  1591. * - encoding: Set by user.
  1592. * - decoding: Set by user.
  1593. */
  1594. int thread_count;
  1595. /**
  1596. * The codec may call this to execute several independent things.
  1597. * It will return only after finishing all tasks.
  1598. * The user may replace this with some multithreaded implementation,
  1599. * the default implementation will execute the parts serially.
  1600. * @param count the number of things to execute
  1601. * - encoding: Set by libavcodec, user can override.
  1602. * - decoding: Set by libavcodec, user can override.
  1603. */
  1604. int (*execute)(struct AVCodecContext *c, int (*func)(struct AVCodecContext *c2, void *arg), void **arg2, int *ret, int count);
  1605. /**
  1606. * thread opaque
  1607. * Can be used by execute() to store some per AVCodecContext stuff.
  1608. * - encoding: set by execute()
  1609. * - decoding: set by execute()
  1610. */
  1611. void *thread_opaque;
  1612. /**
  1613. * Motion estimation threshold below which no motion estimation is
  1614. * performed, but instead the user specified motion vectors are used.
  1615. *
  1616. * - encoding: Set by user.
  1617. * - decoding: unused
  1618. */
  1619. int me_threshold;
  1620. /**
  1621. * Macroblock threshold below which the user specified macroblock types will be used.
  1622. * - encoding: Set by user.
  1623. * - decoding: unused
  1624. */
  1625. int mb_threshold;
  1626. /**
  1627. * precision of the intra DC coefficient - 8
  1628. * - encoding: Set by user.
  1629. * - decoding: unused
  1630. */
  1631. int intra_dc_precision;
  1632. /**
  1633. * noise vs. sse weight for the nsse comparsion function
  1634. * - encoding: Set by user.
  1635. * - decoding: unused
  1636. */
  1637. int nsse_weight;
  1638. /**
  1639. * Number of macroblock rows at the top which are skipped.
  1640. * - encoding: unused
  1641. * - decoding: Set by user.
  1642. */
  1643. int skip_top;
  1644. /**
  1645. * Number of macroblock rows at the bottom which are skipped.
  1646. * - encoding: unused
  1647. * - decoding: Set by user.
  1648. */
  1649. int skip_bottom;
  1650. /**
  1651. * profile
  1652. * - encoding: Set by user.
  1653. * - decoding: Set by libavcodec.
  1654. */
  1655. int profile;
  1656. #define FF_PROFILE_UNKNOWN -99
  1657. #define FF_PROFILE_AAC_MAIN 0
  1658. #define FF_PROFILE_AAC_LOW 1
  1659. #define FF_PROFILE_AAC_SSR 2
  1660. #define FF_PROFILE_AAC_LTP 3
  1661. /**
  1662. * level
  1663. * - encoding: Set by user.
  1664. * - decoding: Set by libavcodec.
  1665. */
  1666. int level;
  1667. #define FF_LEVEL_UNKNOWN -99
  1668. /**
  1669. * low resolution decoding, 1-> 1/2 size, 2->1/4 size
  1670. * - encoding: unused
  1671. * - decoding: Set by user.
  1672. */
  1673. int lowres;
  1674. /**
  1675. * Bitstream width / height, may be different from width/height if lowres
  1676. * or other things are used.
  1677. * - encoding: unused
  1678. * - decoding: Set by user before init if known. Codec should override / dynamically change if needed.
  1679. */
  1680. int coded_width, coded_height;
  1681. /**
  1682. * frame skip threshold
  1683. * - encoding: Set by user.
  1684. * - decoding: unused
  1685. */
  1686. int frame_skip_threshold;
  1687. /**
  1688. * frame skip factor
  1689. * - encoding: Set by user.
  1690. * - decoding: unused
  1691. */
  1692. int frame_skip_factor;
  1693. /**
  1694. * frame skip exponent
  1695. * - encoding: Set by user.
  1696. * - decoding: unused
  1697. */
  1698. int frame_skip_exp;
  1699. /**
  1700. * frame skip comparison function
  1701. * - encoding: Set by user.
  1702. * - decoding: unused
  1703. */
  1704. int frame_skip_cmp;
  1705. /**
  1706. * Border processing masking, raises the quantizer for mbs on the borders
  1707. * of the picture.
  1708. * - encoding: Set by user.
  1709. * - decoding: unused
  1710. */
  1711. float border_masking;
  1712. /**
  1713. * minimum MB lagrange multipler
  1714. * - encoding: Set by user.
  1715. * - decoding: unused
  1716. */
  1717. int mb_lmin;
  1718. /**
  1719. * maximum MB lagrange multipler
  1720. * - encoding: Set by user.
  1721. * - decoding: unused
  1722. */
  1723. int mb_lmax;
  1724. /**
  1725. *
  1726. * - encoding: Set by user.
  1727. * - decoding: unused
  1728. */
  1729. int me_penalty_compensation;
  1730. /**
  1731. *
  1732. * - encoding: unused
  1733. * - decoding: Set by user.
  1734. */
  1735. enum AVDiscard skip_loop_filter;
  1736. /**
  1737. *
  1738. * - encoding: unused
  1739. * - decoding: Set by user.
  1740. */
  1741. enum AVDiscard skip_idct;
  1742. /**
  1743. *
  1744. * - encoding: unused
  1745. * - decoding: Set by user.
  1746. */
  1747. enum AVDiscard skip_frame;
  1748. /**
  1749. *
  1750. * - encoding: Set by user.
  1751. * - decoding: unused
  1752. */
  1753. int bidir_refine;
  1754. /**
  1755. *
  1756. * - encoding: Set by user.
  1757. * - decoding: unused
  1758. */
  1759. int brd_scale;
  1760. /**
  1761. * constant rate factor - quality-based VBR - values ~correspond to qps
  1762. * - encoding: Set by user.
  1763. * - decoding: unused
  1764. */
  1765. float crf;
  1766. /**
  1767. * constant quantization parameter rate control method
  1768. * - encoding: Set by user.
  1769. * - decoding: unused
  1770. */
  1771. int cqp;
  1772. /**
  1773. * minimum GOP size
  1774. * - encoding: Set by user.
  1775. * - decoding: unused
  1776. */
  1777. int keyint_min;
  1778. /**
  1779. * number of reference frames
  1780. * - encoding: Set by user.
  1781. * - decoding: unused
  1782. */
  1783. int refs;
  1784. /**
  1785. * chroma qp offset from luma
  1786. * - encoding: Set by user.
  1787. * - decoding: unused
  1788. */
  1789. int chromaoffset;
  1790. /**
  1791. * Influences how often B-frames are used.
  1792. * - encoding: Set by user.
  1793. * - decoding: unused
  1794. */
  1795. int bframebias;
  1796. /**
  1797. * trellis RD quantization
  1798. * - encoding: Set by user.
  1799. * - decoding: unused
  1800. */
  1801. int trellis;
  1802. /**
  1803. * Reduce fluctuations in qp (before curve compression).
  1804. * - encoding: Set by user.
  1805. * - decoding: unused
  1806. */
  1807. float complexityblur;
  1808. /**
  1809. * in-loop deblocking filter alphac0 parameter
  1810. * alpha is in the range -6...6
  1811. * - encoding: Set by user.
  1812. * - decoding: unused
  1813. */
  1814. int deblockalpha;
  1815. /**
  1816. * in-loop deblocking filter beta parameter
  1817. * beta is in the range -6...6
  1818. * - encoding: Set by user.
  1819. * - decoding: unused
  1820. */
  1821. int deblockbeta;
  1822. /**
  1823. * macroblock subpartition sizes to consider - p8x8, p4x4, b8x8, i8x8, i4x4
  1824. * - encoding: Set by user.
  1825. * - decoding: unused
  1826. */
  1827. int partitions;
  1828. #define X264_PART_I4X4 0x001 /* Analyse i4x4 */
  1829. #define X264_PART_I8X8 0x002 /* Analyse i8x8 (requires 8x8 transform) */
  1830. #define X264_PART_P8X8 0x010 /* Analyse p16x8, p8x16 and p8x8 */
  1831. #define X264_PART_P4X4 0x020 /* Analyse p8x4, p4x8, p4x4 */
  1832. #define X264_PART_B8X8 0x100 /* Analyse b16x8, b8x16 and b8x8 */
  1833. /**
  1834. * direct MV prediction mode - 0 (none), 1 (spatial), 2 (temporal)
  1835. * - encoding: Set by user.
  1836. * - decoding: unused
  1837. */
  1838. int directpred;
  1839. /**
  1840. * Audio cutoff bandwidth (0 means "automatic"), currently used only by FAAC.
  1841. * - encoding: Set by user.
  1842. * - decoding: unused
  1843. */
  1844. int cutoff;
  1845. /**
  1846. * Multiplied by qscale for each frame and added to scene_change_score.
  1847. * - encoding: Set by user.
  1848. * - decoding: unused
  1849. */
  1850. int scenechange_factor;
  1851. /**
  1852. *
  1853. * Note: Value depends upon the compare function used for fullpel ME.
  1854. * - encoding: Set by user.
  1855. * - decoding: unused
  1856. */
  1857. int mv0_threshold;
  1858. /**
  1859. * Adjusts sensitivity of b_frame_strategy 1.
  1860. * - encoding: Set by user.
  1861. * - decoding: unused
  1862. */
  1863. int b_sensitivity;
  1864. /**
  1865. * - encoding: Set by user.
  1866. * - decoding: unused
  1867. */
  1868. int compression_level;
  1869. #define FF_COMPRESSION_DEFAULT -1
  1870. /**
  1871. * Sets whether to use LPC mode - used by FLAC encoder.
  1872. * - encoding: Set by user.
  1873. * - decoding: unused
  1874. */
  1875. int use_lpc;
  1876. /**
  1877. * LPC coefficient precision - used by FLAC encoder
  1878. * - encoding: Set by user.
  1879. * - decoding: unused
  1880. */
  1881. int lpc_coeff_precision;
  1882. /**
  1883. * - encoding: Set by user.
  1884. * - decoding: unused
  1885. */
  1886. int min_prediction_order;
  1887. /**
  1888. * - encoding: Set by user.
  1889. * - decoding: unused
  1890. */
  1891. int max_prediction_order;
  1892. /**
  1893. * search method for selecting prediction order
  1894. * - encoding: Set by user.
  1895. * - decoding: unused
  1896. */
  1897. int prediction_order_method;
  1898. /**
  1899. * - encoding: Set by user.
  1900. * - decoding: unused
  1901. */
  1902. int min_partition_order;
  1903. /**
  1904. * - encoding: Set by user.
  1905. * - decoding: unused
  1906. */
  1907. int max_partition_order;
  1908. /**
  1909. * GOP timecode frame start number, in non drop frame format
  1910. * - encoding: Set by user.
  1911. * - decoding: unused
  1912. */
  1913. int64_t timecode_frame_start;
  1914. } AVCodecContext;
  1915. /**
  1916. * AVCodec.
  1917. */
  1918. typedef struct AVCodec {
  1919. /**
  1920. * Name of the codec implementation.
  1921. * The name is globally unique among encoders and among decoders (but an
  1922. * encoder and a decoder can share the same name).
  1923. * This is the primary way to find a codec from the user perspective.
  1924. */
  1925. const char *name;
  1926. enum CodecType type;
  1927. enum CodecID id;
  1928. int priv_data_size;
  1929. int (*init)(AVCodecContext *);
  1930. int (*encode)(AVCodecContext *, uint8_t *buf, int buf_size, void *data);
  1931. int (*close)(AVCodecContext *);
  1932. int (*decode)(AVCodecContext *, void *outdata, int *outdata_size,
  1933. uint8_t *buf, int buf_size);
  1934. int capabilities;
  1935. struct AVCodec *next;
  1936. void (*flush)(AVCodecContext *);
  1937. const AVRational *supported_framerates; ///array of supported framerates, or NULL if any, array is terminated by {0,0}
  1938. const enum PixelFormat *pix_fmts; ///array of supported pixel formats, or NULL if unknown, array is terminanted by -1
  1939. } AVCodec;
  1940. /**
  1941. * four components are given, that's all.
  1942. * the last component is alpha
  1943. */
  1944. typedef struct AVPicture {
  1945. uint8_t *data[4];
  1946. int linesize[4]; ///< number of bytes per line
  1947. } AVPicture;
  1948. /**
  1949. * AVPaletteControl
  1950. * This structure defines a method for communicating palette changes
  1951. * between and demuxer and a decoder.
  1952. *
  1953. * @deprecated Use AVPacket to send palette changes instead.
  1954. * This is totally broken.
  1955. */
  1956. #define AVPALETTE_SIZE 1024
  1957. #define AVPALETTE_COUNT 256
  1958. typedef struct AVPaletteControl {
  1959. /* Demuxer sets this to 1 to indicate the palette has changed;
  1960. * decoder resets to 0. */
  1961. int palette_changed;
  1962. /* 4-byte ARGB palette entries, stored in native byte order; note that
  1963. * the individual palette components should be on a 8-bit scale; if
  1964. * the palette data comes from an IBM VGA native format, the component
  1965. * data is probably 6 bits in size and needs to be scaled. */
  1966. unsigned int palette[AVPALETTE_COUNT];
  1967. } AVPaletteControl attribute_deprecated;
  1968. typedef struct AVSubtitleRect {
  1969. uint16_t x;
  1970. uint16_t y;
  1971. uint16_t w;
  1972. uint16_t h;
  1973. uint16_t nb_colors;
  1974. int linesize;
  1975. uint32_t *rgba_palette;
  1976. uint8_t *bitmap;
  1977. } AVSubtitleRect;
  1978. typedef struct AVSubtitle {
  1979. uint16_t format; /* 0 = graphics */
  1980. uint32_t start_display_time; /* relative to packet pts, in ms */
  1981. uint32_t end_display_time; /* relative to packet pts, in ms */
  1982. uint32_t num_rects;
  1983. AVSubtitleRect *rects;
  1984. } AVSubtitle;
  1985. /* resample.c */
  1986. struct ReSampleContext;
  1987. struct AVResampleContext;
  1988. typedef struct ReSampleContext ReSampleContext;
  1989. ReSampleContext *audio_resample_init(int output_channels, int input_channels,
  1990. int output_rate, int input_rate);
  1991. int audio_resample(ReSampleContext *s, short *output, short *input, int nb_samples);
  1992. void audio_resample_close(ReSampleContext *s);
  1993. struct AVResampleContext *av_resample_init(int out_rate, int in_rate, int filter_length, int log2_phase_count, int linear, double cutoff);
  1994. int av_resample(struct AVResampleContext *c, short *dst, short *src, int *consumed, int src_size, int dst_size, int update_ctx);
  1995. void av_resample_compensate(struct AVResampleContext *c, int sample_delta, int compensation_distance);
  1996. void av_resample_close(struct AVResampleContext *c);
  1997. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  1998. /* YUV420 format is assumed ! */
  1999. /**
  2000. * @deprecated Use the software scaler (swscale) instead.
  2001. */
  2002. typedef struct ImgReSampleContext ImgReSampleContext attribute_deprecated;
  2003. /**
  2004. * @deprecated Use the software scaler (swscale) instead.
  2005. */
  2006. attribute_deprecated ImgReSampleContext *img_resample_init(int output_width, int output_height,
  2007. int input_width, int input_height);
  2008. /**
  2009. * @deprecated Use the software scaler (swscale) instead.
  2010. */
  2011. attribute_deprecated ImgReSampleContext *img_resample_full_init(int owidth, int oheight,
  2012. int iwidth, int iheight,
  2013. int topBand, int bottomBand,
  2014. int leftBand, int rightBand,
  2015. int padtop, int padbottom,
  2016. int padleft, int padright);
  2017. /**
  2018. * @deprecated Use the software scaler (swscale) instead.
  2019. */
  2020. attribute_deprecated void img_resample(struct ImgReSampleContext *s,
  2021. AVPicture *output, const AVPicture *input);
  2022. /**
  2023. * @deprecated Use the software scaler (swscale) instead.
  2024. */
  2025. attribute_deprecated void img_resample_close(struct ImgReSampleContext *s);
  2026. #endif
  2027. /**
  2028. * Allocate memory for a picture. Call avpicture_free to free it.
  2029. *
  2030. * @param picture the picture to be filled in
  2031. * @param pix_fmt the format of the picture
  2032. * @param width the width of the picture
  2033. * @param height the height of the picture
  2034. * @return zero if successful, a negative value if not
  2035. */
  2036. int avpicture_alloc(AVPicture *picture, int pix_fmt, int width, int height);
  2037. /**
  2038. * Free a picture previously allocated by avpicture_alloc().
  2039. *
  2040. * @param picture the AVPicture to be freed
  2041. */
  2042. void avpicture_free(AVPicture *picture);
  2043. /**
  2044. * Fill in the AVPicture fields.
  2045. * The fields of the given AVPicture are filled in by using the 'ptr' address
  2046. * which points to the image data buffer. Depending on the specified picture
  2047. * format, one or multiple image data pointers and line sizes will be set.
  2048. * If a planar format is specified, several pointers will be set pointing to
  2049. * the different picture planes and the line sizes of the different planes
  2050. * will be stored in the lines_sizes array.
  2051. *
  2052. * @param picture AVPicture whose fields are to be filled in
  2053. * @param ptr Buffer which will contain or contains the actual image data
  2054. * @param pix_fmt The format in which the picture data is stored.
  2055. * @param width the width of the image in pixels
  2056. * @param height the height of the image in pixels
  2057. * @return size of the image data in bytes
  2058. */
  2059. int avpicture_fill(AVPicture *picture, uint8_t *ptr,
  2060. int pix_fmt, int width, int height);
  2061. int avpicture_layout(const AVPicture* src, int pix_fmt, int width, int height,
  2062. unsigned char *dest, int dest_size);
  2063. /**
  2064. * Calculate the size in bytes that a picture of the given width and height
  2065. * would occupy if stored in the given picture format.
  2066. *
  2067. * @param pix_fmt the given picture format
  2068. * @param width the width of the image
  2069. * @param height the height of the image
  2070. * @return Image data size in bytes
  2071. */
  2072. int avpicture_get_size(int pix_fmt, int width, int height);
  2073. void avcodec_get_chroma_sub_sample(int pix_fmt, int *h_shift, int *v_shift);
  2074. const char *avcodec_get_pix_fmt_name(int pix_fmt);
  2075. void avcodec_set_dimensions(AVCodecContext *s, int width, int height);
  2076. enum PixelFormat avcodec_get_pix_fmt(const char* name);
  2077. unsigned int avcodec_pix_fmt_to_codec_tag(enum PixelFormat p);
  2078. #define FF_LOSS_RESOLUTION 0x0001 /**< loss due to resolution change */
  2079. #define FF_LOSS_DEPTH 0x0002 /**< loss due to color depth change */
  2080. #define FF_LOSS_COLORSPACE 0x0004 /**< loss due to color space conversion */
  2081. #define FF_LOSS_ALPHA 0x0008 /**< loss of alpha bits */
  2082. #define FF_LOSS_COLORQUANT 0x0010 /**< loss due to color quantization */
  2083. #define FF_LOSS_CHROMA 0x0020 /**< loss of chroma (e.g. RGB to gray conversion) */
  2084. /**
  2085. * Computes what kind of losses will occur when converting from one specific
  2086. * pixel format to another.
  2087. * When converting from one pixel format to another, information loss may occur.
  2088. * For example, when converting from RGB24 to GRAY, the color information will
  2089. * be lost. Similarly, other losses occur when converting from some formats to
  2090. * other formats. These losses can involve loss of chroma, but also loss of
  2091. * resolution, loss of color depth, loss due to the color space conversion, loss
  2092. * of the alpha bits or loss due to color quantization.
  2093. * avcodec_get_fix_fmt_loss() informs you about the various types of losses
  2094. * which will occur when converting from one pixel format to another.
  2095. *
  2096. * @param[in] dst_pix_fmt destination pixel format
  2097. * @param[in] src_pix_fmt source pixel format
  2098. * @param[in] has_alpha Whether the source pixel format alpha channel is used.
  2099. * @return Combination of flags informing you what kind of losses will occur.
  2100. */
  2101. int avcodec_get_pix_fmt_loss(int dst_pix_fmt, int src_pix_fmt,
  2102. int has_alpha);
  2103. /**
  2104. * Finds the best pixel format to convert to given a certain source pixel
  2105. * format. When converting from one pixel format to another, information loss
  2106. * may occur. For example, when converting from RGB24 to GRAY, the color
  2107. * information will be lost. Similarly, other losses occur when converting from
  2108. * some formats to other formats. avcodec_find_best_pix_fmt() searches which of
  2109. * the given pixel formats should be used to suffer the least amount of loss.
  2110. * The pixel formats from which it chooses one, are determined by the
  2111. * \p pix_fmt_mask parameter.
  2112. *
  2113. * @code
  2114. * src_pix_fmt = PIX_FMT_YUV420P;
  2115. * pix_fmt_mask = (1 << PIX_FMT_YUV422P) || (1 << PIX_FMT_RGB24);
  2116. * dst_pix_fmt = avcodec_find_best_pix_fmt(pix_fmt_mask, src_pix_fmt, alpha, &loss);
  2117. * @endcode
  2118. *
  2119. * @param[in] pix_fmt_mask bitmask determining which pixel format to choose from
  2120. * @param[in] src_pix_fmt source pixel format
  2121. * @param[in] has_alpha Whether the source pixel format alpha channel is used.
  2122. * @param[out] loss_ptr Combination of flags informing you what kind of losses will occur.
  2123. * @return The best pixel format to convert to or -1 if none was found.
  2124. */
  2125. int avcodec_find_best_pix_fmt(int pix_fmt_mask, int src_pix_fmt,
  2126. int has_alpha, int *loss_ptr);
  2127. /**
  2128. * Print in buf the string corresponding to the pixel format with
  2129. * number pix_fmt, or an header if pix_fmt is negative.
  2130. *
  2131. * @param buf[in] the buffer where to write the string
  2132. * @param buf_size[in] the size of buf
  2133. * @param pix_fmt[in] the number of the pixel format to print the corresponding info string, or
  2134. * a negative value to print the corresponding header.
  2135. * Meaningful values for obtaining a pixel format info vary from 0 to PIX_FMT_NB -1.
  2136. */
  2137. void avcodec_pix_fmt_string (char *buf, int buf_size, int pix_fmt);
  2138. #define FF_ALPHA_TRANSP 0x0001 /* image has some totally transparent pixels */
  2139. #define FF_ALPHA_SEMI_TRANSP 0x0002 /* image has some transparent pixels */
  2140. /**
  2141. * Tell if an image really has transparent alpha values.
  2142. * @return ored mask of FF_ALPHA_xxx constants
  2143. */
  2144. int img_get_alpha_info(const AVPicture *src,
  2145. int pix_fmt, int width, int height);
  2146. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  2147. /**
  2148. * convert among pixel formats
  2149. * @deprecated Use the software scaler (swscale) instead.
  2150. */
  2151. attribute_deprecated int img_convert(AVPicture *dst, int dst_pix_fmt,
  2152. const AVPicture *src, int pix_fmt,
  2153. int width, int height);
  2154. #endif
  2155. /* deinterlace a picture */
  2156. /* deinterlace - if not supported return -1 */
  2157. int avpicture_deinterlace(AVPicture *dst, const AVPicture *src,
  2158. int pix_fmt, int width, int height);
  2159. /* external high level API */
  2160. extern AVCodec *first_avcodec;
  2161. /* returns LIBAVCODEC_VERSION_INT constant */
  2162. unsigned avcodec_version(void);
  2163. /* returns LIBAVCODEC_BUILD constant */
  2164. unsigned avcodec_build(void);
  2165. /**
  2166. * Initializes libavcodec.
  2167. *
  2168. * @warning This function \e must be called before any other libavcodec
  2169. * function.
  2170. */
  2171. void avcodec_init(void);
  2172. void register_avcodec(AVCodec *format);
  2173. /**
  2174. * Finds an encoder with a matching codec ID.
  2175. *
  2176. * @param id CodecID of the requested encoder
  2177. * @return An encoder if one was found, NULL otherwise.
  2178. */
  2179. AVCodec *avcodec_find_encoder(enum CodecID id);
  2180. /**
  2181. * Finds an encoder with the specified name.
  2182. *
  2183. * @param name name of the requested encoder
  2184. * @return An encoder if one was found, NULL otherwise.
  2185. */
  2186. AVCodec *avcodec_find_encoder_by_name(const char *name);
  2187. /**
  2188. * Finds a decoder with a matching codec ID.
  2189. *
  2190. * @param id CodecID of the requested decoder
  2191. * @return A decoder if one was found, NULL otherwise.
  2192. */
  2193. AVCodec *avcodec_find_decoder(enum CodecID id);
  2194. /**
  2195. * Finds an decoder with the specified name.
  2196. *
  2197. * @param name name of the requested decoder
  2198. * @return A decoder if one was found, NULL otherwise.
  2199. */
  2200. AVCodec *avcodec_find_decoder_by_name(const char *name);
  2201. void avcodec_string(char *buf, int buf_size, AVCodecContext *enc, int encode);
  2202. /**
  2203. * Sets the fields of the given AVCodecContext to default values.
  2204. *
  2205. * @param s The AVCodecContext of which the fields should be set to default values.
  2206. */
  2207. void avcodec_get_context_defaults(AVCodecContext *s);
  2208. /** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
  2209. * we WILL change its arguments and name a few times! */
  2210. void avcodec_get_context_defaults2(AVCodecContext *s, enum CodecType);
  2211. /**
  2212. * Allocates an AVCodecContext and sets its fields to default values. The
  2213. * resulting struct can be deallocated by simply calling av_free().
  2214. *
  2215. * @return An AVCodecContext filled with default values or NULL on failure.
  2216. * @see avcodec_get_context_defaults
  2217. */
  2218. AVCodecContext *avcodec_alloc_context(void);
  2219. /** THIS FUNCTION IS NOT YET PART OF THE PUBLIC API!
  2220. * we WILL change its arguments and name a few times! */
  2221. AVCodecContext *avcodec_alloc_context2(enum CodecType);
  2222. /**
  2223. * Sets the fields of the given AVFrame to default values.
  2224. *
  2225. * @param pic The AVFrame of which the fields should be set to default values.
  2226. */
  2227. void avcodec_get_frame_defaults(AVFrame *pic);
  2228. /**
  2229. * Allocates an AVFrame and sets its fields to default values. The resulting
  2230. * struct can be deallocated by simply calling av_free().
  2231. *
  2232. * @return An AVFrame filled with default values or NULL on failure.
  2233. * @see avcodec_get_frame_defaults
  2234. */
  2235. AVFrame *avcodec_alloc_frame(void);
  2236. int avcodec_default_get_buffer(AVCodecContext *s, AVFrame *pic);
  2237. void avcodec_default_release_buffer(AVCodecContext *s, AVFrame *pic);
  2238. int avcodec_default_reget_buffer(AVCodecContext *s, AVFrame *pic);
  2239. void avcodec_align_dimensions(AVCodecContext *s, int *width, int *height);
  2240. /**
  2241. * Checks if the given dimension of a picture is valid, meaning that all
  2242. * bytes of the picture can be addressed with a signed int.
  2243. *
  2244. * @param[in] w Width of the picture.
  2245. * @param[in] h Height of the picture.
  2246. * @return Zero if valid, a negative value if invalid.
  2247. */
  2248. int avcodec_check_dimensions(void *av_log_ctx, unsigned int w, unsigned int h);
  2249. enum PixelFormat avcodec_default_get_format(struct AVCodecContext *s, const enum PixelFormat * fmt);
  2250. int avcodec_thread_init(AVCodecContext *s, int thread_count);
  2251. void avcodec_thread_free(AVCodecContext *s);
  2252. int avcodec_thread_execute(AVCodecContext *s, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
  2253. int avcodec_default_execute(AVCodecContext *c, int (*func)(AVCodecContext *c2, void *arg2),void **arg, int *ret, int count);
  2254. //FIXME func typedef
  2255. /**
  2256. * Initializes the AVCodecContext to use the given AVCodec. Prior to using this
  2257. * function the context has to be allocated.
  2258. *
  2259. * The functions avcodec_find_decoder_by_name(), avcodec_find_encoder_by_name(),
  2260. * avcodec_find_decoder() and avcodec_find_encoder() provide an easy way for
  2261. * retrieving a codec.
  2262. *
  2263. * @warning This function is not thread safe!
  2264. *
  2265. * @code
  2266. * avcodec_register_all();
  2267. * codec = avcodec_find_decoder(CODEC_ID_H264);
  2268. * if (!codec)
  2269. * exit(1);
  2270. *
  2271. * context = avcodec_alloc_context();
  2272. *
  2273. * if (avcodec_open(context, codec) < 0)
  2274. * exit(1);
  2275. * @endcode
  2276. *
  2277. * @param avctx The context which will be set up to use the given codec.
  2278. * @param codec The codec to use within the context.
  2279. * @return zero on success, a negative value on error
  2280. * @see avcodec_alloc_context, avcodec_find_decoder, avcodec_find_encoder
  2281. */
  2282. int avcodec_open(AVCodecContext *avctx, AVCodec *codec);
  2283. /**
  2284. * @deprecated Use avcodec_decode_audio2() instead.
  2285. */
  2286. attribute_deprecated int avcodec_decode_audio(AVCodecContext *avctx, int16_t *samples,
  2287. int *frame_size_ptr,
  2288. uint8_t *buf, int buf_size);
  2289. /**
  2290. * Decodes an audio frame from \p buf into \p samples.
  2291. * The avcodec_decode_audio2() function decodes an audio frame from the input
  2292. * buffer \p buf of size \p buf_size. To decode it, it makes use of the
  2293. * audio codec which was coupled with \p avctx using avcodec_open(). The
  2294. * resulting decoded frame is stored in output buffer \p samples. If no frame
  2295. * could be decompressed, \p frame_size_ptr is zero. Otherwise, it is the
  2296. * decompressed frame size in \e bytes.
  2297. *
  2298. * @warning You \e must set \p frame_size_ptr to the allocated size of the
  2299. * output buffer before calling avcodec_decode_audio2().
  2300. *
  2301. * @warning The input buffer must be \c FF_INPUT_BUFFER_PADDING_SIZE larger than
  2302. * the actual read bytes because some optimized bitstream readers read 32 or 64
  2303. * bits at once and could read over the end.
  2304. *
  2305. * @warning The end of the input buffer \p buf should be set to 0 to ensure that
  2306. * no overreading happens for damaged MPEG streams.
  2307. *
  2308. * @note You might have to align the input buffer \p buf and output buffer \p
  2309. * samples. The alignment requirements depend on the CPU: On some CPUs it isn't
  2310. * necessary at all, on others it won't work at all if not aligned and on others
  2311. * it will work but it will have an impact on performance. In practice, the
  2312. * bitstream should have 4 byte alignment at minimum and all sample data should
  2313. * be 16 byte aligned unless the CPU doesn't need it (AltiVec and SSE do). If
  2314. * the linesize is not a multiple of 16 then there's no sense in aligning the
  2315. * start of the buffer to 16.
  2316. *
  2317. * @param avctx the codec context
  2318. * @param[out] samples the output buffer
  2319. * @param[in,out] frame_size_ptr the output buffer size in bytes
  2320. * @param[in] buf the input buffer
  2321. * @param[in] buf_size the input buffer size in bytes
  2322. * @return On error a negative value is returned, otherwise the number of bytes
  2323. * used or zero if no frame could be decompressed.
  2324. */
  2325. int avcodec_decode_audio2(AVCodecContext *avctx, int16_t *samples,
  2326. int *frame_size_ptr,
  2327. uint8_t *buf, int buf_size);
  2328. /**
  2329. * Decodes a video frame from \p buf into \p picture.
  2330. * The avcodec_decode_video() function decodes a video frame from the input
  2331. * buffer \p buf of size \p buf_size. To decode it, it makes use of the
  2332. * video codec which was coupled with \p avctx using avcodec_open(). The
  2333. * resulting decoded frame is stored in \p picture.
  2334. *
  2335. * @warning The input buffer must be \c FF_INPUT_BUFFER_PADDING_SIZE larger than
  2336. * the actual read bytes because some optimized bitstream readers read 32 or 64
  2337. * bits at once and could read over the end.
  2338. *
  2339. * @warning The end of the input buffer \p buf should be set to 0 to ensure that
  2340. * no overreading happens for damaged MPEG streams.
  2341. *
  2342. * @note You might have to align the input buffer \p buf and output buffer \p
  2343. * samples. The alignment requirements depend on the CPU: on some CPUs it isn't
  2344. * necessary at all, on others it won't work at all if not aligned and on others
  2345. * it will work but it will have an impact on performance. In practice, the
  2346. * bitstream should have 4 byte alignment at minimum and all sample data should
  2347. * be 16 byte aligned unless the CPU doesn't need it (AltiVec and SSE do). If
  2348. * the linesize is not a multiple of 16 then there's no sense in aligning the
  2349. * start of the buffer to 16.
  2350. *
  2351. * @param avctx the codec context
  2352. * @param[out] picture The AVFrame in which the decoded video frame will be stored.
  2353. * @param[in] buf the input buffer
  2354. * @param[in] buf_size the size of the input buffer in bytes
  2355. * @param[in,out] got_picture_ptr Zero if no frame could be decompressed, otherwise, it is nonzero.
  2356. * @return On error a negative value is returned, otherwise the number of bytes
  2357. * used or zero if no frame could be decompressed.
  2358. */
  2359. int avcodec_decode_video(AVCodecContext *avctx, AVFrame *picture,
  2360. int *got_picture_ptr,
  2361. uint8_t *buf, int buf_size);
  2362. /* Decode a subtitle message. Return -1 if error, otherwise return the
  2363. * number of bytes used. If no subtitle could be decompressed,
  2364. * got_sub_ptr is zero. Otherwise, the subtitle is stored in *sub. */
  2365. int avcodec_decode_subtitle(AVCodecContext *avctx, AVSubtitle *sub,
  2366. int *got_sub_ptr,
  2367. const uint8_t *buf, int buf_size);
  2368. int avcodec_parse_frame(AVCodecContext *avctx, uint8_t **pdata,
  2369. int *data_size_ptr,
  2370. uint8_t *buf, int buf_size);
  2371. /**
  2372. * Encodes an audio frame from \p samples into \p buf.
  2373. * The avcodec_encode_audio() function encodes an audio frame from the input
  2374. * buffer \p samples. To encode it, it makes use of the audio codec which was
  2375. * coupled with \p avctx using avcodec_open(). The resulting encoded frame is
  2376. * stored in output buffer \p buf.
  2377. *
  2378. * @note The output buffer should be at least \c FF_MIN_BUFFER_SIZE bytes large.
  2379. *
  2380. * @param avctx the codec context
  2381. * @param[out] buf the output buffer
  2382. * @param[in] buf_size the output buffer size
  2383. * @param[in] samples the input buffer containing the samples
  2384. * @return On error a negative value is returned, on succes zero or the number
  2385. * of bytes used from the input buffer.
  2386. */
  2387. int avcodec_encode_audio(AVCodecContext *avctx, uint8_t *buf, int buf_size,
  2388. const short *samples);
  2389. /**
  2390. * Encodes a video frame from \p pict into \p buf.
  2391. * The avcodec_encode_video() function encodes a video frame from the input
  2392. * \p pict. To encode it, it makes use of the video codec which was coupled with
  2393. * \p avctx using avcodec_open(). The resulting encoded bytes representing the
  2394. * frame are stored in the output buffer \p buf. The input picture should be
  2395. * stored using a specific format, namely \c avctx.pix_fmt.
  2396. *
  2397. * @param avctx the codec context
  2398. * @param[out] buf the output buffer for the bitstream of encoded frame
  2399. * @param[in] buf_size the size of the output buffer in bytes
  2400. * @param[in] pict the input picture to encode
  2401. * @return On error a negative value is returned, on success zero or the number
  2402. * of bytes used from the input buffer.
  2403. */
  2404. int avcodec_encode_video(AVCodecContext *avctx, uint8_t *buf, int buf_size,
  2405. const AVFrame *pict);
  2406. int avcodec_encode_subtitle(AVCodecContext *avctx, uint8_t *buf, int buf_size,
  2407. const AVSubtitle *sub);
  2408. int avcodec_close(AVCodecContext *avctx);
  2409. void avcodec_register_all(void);
  2410. /**
  2411. * Flush buffers, should be called when seeking or when switching to a different stream.
  2412. */
  2413. void avcodec_flush_buffers(AVCodecContext *avctx);
  2414. void avcodec_default_free_buffers(AVCodecContext *s);
  2415. /* misc useful functions */
  2416. /**
  2417. * Returns a single letter to describe the given picture type \p pict_type.
  2418. *
  2419. * @param[in] pict_type the picture type
  2420. * @return A single character representing the picture type.
  2421. */
  2422. char av_get_pict_type_char(int pict_type);
  2423. /**
  2424. * Returns codec bits per sample.
  2425. *
  2426. * @param[in] codec_id the codec
  2427. * @return Number of bits per sample or zero if unknown for the given codec.
  2428. */
  2429. int av_get_bits_per_sample(enum CodecID codec_id);
  2430. /* frame parsing */
  2431. typedef struct AVCodecParserContext {
  2432. void *priv_data;
  2433. struct AVCodecParser *parser;
  2434. int64_t frame_offset; /* offset of the current frame */
  2435. int64_t cur_offset; /* current offset
  2436. (incremented by each av_parser_parse()) */
  2437. int64_t last_frame_offset; /* offset of the last frame */
  2438. /* video info */
  2439. int pict_type; /* XXX: Put it back in AVCodecContext. */
  2440. int repeat_pict; /* XXX: Put it back in AVCodecContext. */
  2441. int64_t pts; /* pts of the current frame */
  2442. int64_t dts; /* dts of the current frame */
  2443. /* private data */
  2444. int64_t last_pts;
  2445. int64_t last_dts;
  2446. int fetch_timestamp;
  2447. #define AV_PARSER_PTS_NB 4
  2448. int cur_frame_start_index;
  2449. int64_t cur_frame_offset[AV_PARSER_PTS_NB];
  2450. int64_t cur_frame_pts[AV_PARSER_PTS_NB];
  2451. int64_t cur_frame_dts[AV_PARSER_PTS_NB];
  2452. int flags;
  2453. #define PARSER_FLAG_COMPLETE_FRAMES 0x0001
  2454. int64_t offset; ///< byte offset from starting packet start
  2455. int64_t last_offset;
  2456. } AVCodecParserContext;
  2457. typedef struct AVCodecParser {
  2458. int codec_ids[5]; /* several codec IDs are permitted */
  2459. int priv_data_size;
  2460. int (*parser_init)(AVCodecParserContext *s);
  2461. int (*parser_parse)(AVCodecParserContext *s,
  2462. AVCodecContext *avctx,
  2463. const uint8_t **poutbuf, int *poutbuf_size,
  2464. const uint8_t *buf, int buf_size);
  2465. void (*parser_close)(AVCodecParserContext *s);
  2466. int (*split)(AVCodecContext *avctx, const uint8_t *buf, int buf_size);
  2467. struct AVCodecParser *next;
  2468. } AVCodecParser;
  2469. extern AVCodecParser *av_first_parser;
  2470. void av_register_codec_parser(AVCodecParser *parser);
  2471. AVCodecParserContext *av_parser_init(int codec_id);
  2472. int av_parser_parse(AVCodecParserContext *s,
  2473. AVCodecContext *avctx,
  2474. uint8_t **poutbuf, int *poutbuf_size,
  2475. const uint8_t *buf, int buf_size,
  2476. int64_t pts, int64_t dts);
  2477. int av_parser_change(AVCodecParserContext *s,
  2478. AVCodecContext *avctx,
  2479. uint8_t **poutbuf, int *poutbuf_size,
  2480. const uint8_t *buf, int buf_size, int keyframe);
  2481. void av_parser_close(AVCodecParserContext *s);
  2482. extern AVCodecParser aac_parser;
  2483. extern AVCodecParser ac3_parser;
  2484. extern AVCodecParser cavsvideo_parser;
  2485. extern AVCodecParser dca_parser;
  2486. extern AVCodecParser dvbsub_parser;
  2487. extern AVCodecParser dvdsub_parser;
  2488. extern AVCodecParser h261_parser;
  2489. extern AVCodecParser h263_parser;
  2490. extern AVCodecParser h264_parser;
  2491. extern AVCodecParser mjpeg_parser;
  2492. extern AVCodecParser mpeg4video_parser;
  2493. extern AVCodecParser mpegaudio_parser;
  2494. extern AVCodecParser mpegvideo_parser;
  2495. extern AVCodecParser pnm_parser;
  2496. extern AVCodecParser vc1_parser;
  2497. typedef struct AVBitStreamFilterContext {
  2498. void *priv_data;
  2499. struct AVBitStreamFilter *filter;
  2500. AVCodecParserContext *parser;
  2501. struct AVBitStreamFilterContext *next;
  2502. } AVBitStreamFilterContext;
  2503. typedef struct AVBitStreamFilter {
  2504. const char *name;
  2505. int priv_data_size;
  2506. int (*filter)(AVBitStreamFilterContext *bsfc,
  2507. AVCodecContext *avctx, const char *args,
  2508. uint8_t **poutbuf, int *poutbuf_size,
  2509. const uint8_t *buf, int buf_size, int keyframe);
  2510. struct AVBitStreamFilter *next;
  2511. } AVBitStreamFilter;
  2512. extern AVBitStreamFilter *av_first_bitstream_filter;
  2513. void av_register_bitstream_filter(AVBitStreamFilter *bsf);
  2514. AVBitStreamFilterContext *av_bitstream_filter_init(const char *name);
  2515. int av_bitstream_filter_filter(AVBitStreamFilterContext *bsfc,
  2516. AVCodecContext *avctx, const char *args,
  2517. uint8_t **poutbuf, int *poutbuf_size,
  2518. const uint8_t *buf, int buf_size, int keyframe);
  2519. void av_bitstream_filter_close(AVBitStreamFilterContext *bsf);
  2520. extern AVBitStreamFilter dump_extradata_bsf;
  2521. extern AVBitStreamFilter remove_extradata_bsf;
  2522. extern AVBitStreamFilter noise_bsf;
  2523. extern AVBitStreamFilter mp3_header_compress_bsf;
  2524. extern AVBitStreamFilter mp3_header_decompress_bsf;
  2525. extern AVBitStreamFilter mjpega_dump_header_bsf;
  2526. extern AVBitStreamFilter imx_dump_header_bsf;
  2527. /* memory */
  2528. /**
  2529. * Reallocates the given block if it is not large enough, otherwise it
  2530. * does nothing.
  2531. *
  2532. * @see av_realloc
  2533. */
  2534. void *av_fast_realloc(void *ptr, unsigned int *size, unsigned int min_size);
  2535. /* for static data only */
  2536. /**
  2537. * Frees all static arrays and resets their pointers to 0.
  2538. * Call this function to release all statically allocated tables.
  2539. *
  2540. * @deprecated. Code which uses av_free_static is broken/misdesigned
  2541. * and should correctly use static arrays
  2542. *
  2543. */
  2544. attribute_deprecated void av_free_static(void);
  2545. /**
  2546. * Allocation of static arrays.
  2547. *
  2548. * @warning Do not use for normal allocation.
  2549. *
  2550. * @param[in] size The amount of memory you need in bytes.
  2551. * @return block of memory of the requested size
  2552. * @deprecated. Code which uses av_mallocz_static is broken/misdesigned
  2553. * and should correctly use static arrays
  2554. */
  2555. attribute_deprecated void *av_mallocz_static(unsigned int size);
  2556. /**
  2557. * Copy image 'src' to 'dst'.
  2558. */
  2559. void av_picture_copy(AVPicture *dst, const AVPicture *src,
  2560. int pix_fmt, int width, int height);
  2561. /**
  2562. * Crop image top and left side.
  2563. */
  2564. int av_picture_crop(AVPicture *dst, const AVPicture *src,
  2565. int pix_fmt, int top_band, int left_band);
  2566. /**
  2567. * Pad image.
  2568. */
  2569. int av_picture_pad(AVPicture *dst, const AVPicture *src, int height, int width, int pix_fmt,
  2570. int padtop, int padbottom, int padleft, int padright, int *color);
  2571. #if LIBAVCODEC_VERSION_INT < ((52<<16)+(0<<8)+0)
  2572. /**
  2573. * @deprecated Use the software scaler (swscale) instead.
  2574. */
  2575. attribute_deprecated void img_copy(AVPicture *dst, const AVPicture *src,
  2576. int pix_fmt, int width, int height);
  2577. /**
  2578. * @deprecated Use the software scaler (swscale) instead.
  2579. */
  2580. attribute_deprecated int img_crop(AVPicture *dst, const AVPicture *src,
  2581. int pix_fmt, int top_band, int left_band);
  2582. /**
  2583. * @deprecated Use the software scaler (swscale) instead.
  2584. */
  2585. attribute_deprecated int img_pad(AVPicture *dst, const AVPicture *src, int height, int width, int pix_fmt,
  2586. int padtop, int padbottom, int padleft, int padright, int *color);
  2587. #endif
  2588. extern unsigned int av_xiphlacing(unsigned char *s, unsigned int v);
  2589. /**
  2590. * Parses \p str and put in \p width_ptr and \p height_ptr the detected values.
  2591. *
  2592. * @return 0 in case of a successful parsing, a negative value otherwise
  2593. * @param[in] str the string to parse: it has to be a string in the format
  2594. * <width>x<height> or a valid video frame size abbreviation.
  2595. * @param[in,out] width_ptr pointer to the variable which will contain the detected
  2596. * frame width value
  2597. * @param[in,out] height_ptr pointer to the variable which will contain the detected
  2598. * frame height value
  2599. */
  2600. int av_parse_video_frame_size(int *width_ptr, int *height_ptr, const char *str);
  2601. /**
  2602. * Parses \p str and put in \p frame_rate the detected values.
  2603. *
  2604. * @return 0 in case of a successful parsing, a negative value otherwise
  2605. * @param[in] str the string to parse: it has to be a string in the format
  2606. * <frame_rate_nom>/<frame_rate_den>, a float number or a valid video rate abbreviation
  2607. * @param[in,out] frame_rate pointer to the AVRational which will contain the detected
  2608. * frame rate
  2609. */
  2610. int av_parse_video_frame_rate(AVRational *frame_rate, const char *str);
  2611. /* error handling */
  2612. #if EINVAL > 0
  2613. #define AVERROR(e) (-(e)) /**< Returns a negative error code from a POSIX error code, to return from library functions. */
  2614. #define AVUNERROR(e) (-(e)) /**< Returns a POSIX error code from a library function error return value. */
  2615. #else
  2616. /* Some platforms have E* and errno already negated. */
  2617. #define AVERROR(e) (e)
  2618. #define AVUNERROR(e) (e)
  2619. #endif
  2620. #define AVERROR_UNKNOWN AVERROR(EINVAL) /**< unknown error */
  2621. #define AVERROR_IO AVERROR(EIO) /**< I/O error */
  2622. #define AVERROR_NUMEXPECTED AVERROR(EDOM) /**< Number syntax expected in filename. */
  2623. #define AVERROR_INVALIDDATA AVERROR(EINVAL) /**< invalid data found */
  2624. #define AVERROR_NOMEM AVERROR(ENOMEM) /**< not enough memory */
  2625. #define AVERROR_NOFMT AVERROR(EILSEQ) /**< unknown format */
  2626. #define AVERROR_NOTSUPP AVERROR(ENOSYS) /**< Operation not supported. */
  2627. #define AVERROR_NOENT AVERROR(ENOENT) /**< No such file or directory. */
  2628. #endif /* AVCODEC_H */