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.

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