codecs.texi 26 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100
  1. @anchor{codec-options}
  2. @chapter Codec Options
  3. @c man begin CODEC OPTIONS
  4. libavcodec provides some generic global options, which can be set on
  5. all the encoders and decoders. In addition each codec may support
  6. so-called private options, which are specific for a given codec.
  7. Sometimes, a global option may only affect a specific kind of codec,
  8. and may be unsensical or ignored by another, so you need to be aware
  9. of the meaning of the specified options. Also some options are
  10. meant only for decoding or encoding.
  11. Options may be set by specifying -@var{option} @var{value} in the
  12. FFmpeg tools, or by setting the value explicitly in the
  13. @code{AVCodecContext} options or using the @file{libavutil/opt.h} API
  14. for programmatic use.
  15. The list of supported options follow:
  16. @table @option
  17. @item b @var{integer} (@emph{encoding,audio,video})
  18. Set bitrate in bits/s. Default value is 200K.
  19. @item ab @var{integer} (@emph{encoding,audio})
  20. Set audio bitrate (in bits/s). Default value is 128K.
  21. @item bt @var{integer} (@emph{encoding,video})
  22. Set video bitrate tolerance (in bits/s). In 1-pass mode, bitrate
  23. tolerance specifies how far ratecontrol is willing to deviate from the
  24. target average bitrate value. This is not related to min/max
  25. bitrate. Lowering tolerance too much has an adverse effect on quality.
  26. @item flags @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
  27. Set generic flags.
  28. Possible values:
  29. @table @samp
  30. @item mv4
  31. Use four motion vector by macroblock (mpeg4).
  32. @item qpel
  33. Use 1/4 pel motion compensation.
  34. @item loop
  35. Use loop filter.
  36. @item qscale
  37. Use fixed qscale.
  38. @item gmc
  39. Use gmc.
  40. @item mv0
  41. Always try a mb with mv=<0,0>.
  42. @item input_preserved
  43. @item pass1
  44. Use internal 2pass ratecontrol in first pass mode.
  45. @item pass2
  46. Use internal 2pass ratecontrol in second pass mode.
  47. @item gray
  48. Only decode/encode grayscale.
  49. @item emu_edge
  50. Do not draw edges.
  51. @item psnr
  52. Set error[?] variables during encoding.
  53. @item truncated
  54. @item naq
  55. Normalize adaptive quantization.
  56. @item ildct
  57. Use interlaced DCT.
  58. @item low_delay
  59. Force low delay.
  60. @item global_header
  61. Place global headers in extradata instead of every keyframe.
  62. @item bitexact
  63. Use only bitexact stuff (except (I)DCT).
  64. @item aic
  65. Apply H263 advanced intra coding / mpeg4 ac prediction.
  66. @item cbp
  67. Deprecated, use mpegvideo private options instead.
  68. @item qprd
  69. Deprecated, use mpegvideo private options instead.
  70. @item ilme
  71. Apply interlaced motion estimation.
  72. @item cgop
  73. Use closed gop.
  74. @end table
  75. @item me_method @var{integer} (@emph{encoding,video})
  76. Set motion estimation method.
  77. Possible values:
  78. @table @samp
  79. @item zero
  80. zero motion estimation (fastest)
  81. @item full
  82. full motion estimation (slowest)
  83. @item epzs
  84. EPZS motion estimation (default)
  85. @item esa
  86. esa motion estimation (alias for full)
  87. @item tesa
  88. tesa motion estimation
  89. @item dia
  90. dia motion estimation (alias for epzs)
  91. @item log
  92. log motion estimation
  93. @item phods
  94. phods motion estimation
  95. @item x1
  96. X1 motion estimation
  97. @item hex
  98. hex motion estimation
  99. @item umh
  100. umh motion estimation
  101. @item iter
  102. iter motion estimation
  103. @end table
  104. @item extradata_size @var{integer}
  105. Set extradata size.
  106. @item time_base @var{rational number}
  107. Set codec time base.
  108. It is the fundamental unit of time (in seconds) in terms of which
  109. frame timestamps are represented. For fixed-fps content, timebase
  110. should be @code{1 / frame_rate} and timestamp increments should be
  111. identically 1.
  112. @item g @var{integer} (@emph{encoding,video})
  113. Set the group of picture size. Default value is 12.
  114. @item ar @var{integer} (@emph{decoding/encoding,audio})
  115. Set audio sampling rate (in Hz).
  116. @item ac @var{integer} (@emph{decoding/encoding,audio})
  117. Set number of audio channels.
  118. @item cutoff @var{integer} (@emph{encoding,audio})
  119. Set cutoff bandwidth.
  120. @item frame_size @var{integer} (@emph{encoding,audio})
  121. Set audio frame size.
  122. Each submitted frame except the last must contain exactly frame_size
  123. samples per channel. May be 0 when the codec has
  124. CODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is not
  125. restricted. It is set by some decoders to indicate constant frame
  126. size.
  127. @item frame_number @var{integer}
  128. Set the frame number.
  129. @item delay @var{integer}
  130. @item qcomp @var{float} (@emph{encoding,video})
  131. Set video quantizer scale compression (VBR). It is used as a constant
  132. in the ratecontrol equation. Recommended range for default rc_eq:
  133. 0.0-1.0.
  134. @item qblur @var{float} (@emph{encoding,video})
  135. Set video quantizer scale blur (VBR).
  136. @item qmin @var{integer} (@emph{encoding,video})
  137. Set min video quantizer scale (VBR). Must be included between -1 and
  138. 69, default value is 2.
  139. @item qmax @var{integer} (@emph{encoding,video})
  140. Set max video quantizer scale (VBR). Must be included between -1 and
  141. 1024, default value is 31.
  142. @item qdiff @var{integer} (@emph{encoding,video})
  143. Set max difference between the quantizer scale (VBR).
  144. @item bf @var{integer} (@emph{encoding,video})
  145. Set max number of B frames between non-B-frames.
  146. Must be an integer between -1 and 16. 0 means that B-frames are
  147. disabled. If a value of -1 is used, it will choose an automatic value
  148. depending on the encoder.
  149. Default value is 0.
  150. @item b_qfactor @var{float} (@emph{encoding,video})
  151. Set qp factor between P and B frames.
  152. @item rc_strategy @var{integer} (@emph{encoding,video})
  153. Set ratecontrol method.
  154. @item b_strategy @var{integer} (@emph{encoding,video})
  155. Set strategy to choose between I/P/B-frames.
  156. @item ps @var{integer} (@emph{encoding,video})
  157. Set RTP payload size in bytes.
  158. @item mv_bits @var{integer}
  159. @item header_bits @var{integer}
  160. @item i_tex_bits @var{integer}
  161. @item p_tex_bits @var{integer}
  162. @item i_count @var{integer}
  163. @item p_count @var{integer}
  164. @item skip_count @var{integer}
  165. @item misc_bits @var{integer}
  166. @item frame_bits @var{integer}
  167. @item codec_tag @var{integer}
  168. @item bug @var{flags} (@emph{decoding,video})
  169. Workaround not auto detected encoder bugs.
  170. Possible values:
  171. @table @samp
  172. @item autodetect
  173. @item old_msmpeg4
  174. some old lavc generated msmpeg4v3 files (no autodetection)
  175. @item xvid_ilace
  176. Xvid interlacing bug (autodetected if fourcc==XVIX)
  177. @item ump4
  178. (autodetected if fourcc==UMP4)
  179. @item no_padding
  180. padding bug (autodetected)
  181. @item amv
  182. @item ac_vlc
  183. illegal vlc bug (autodetected per fourcc)
  184. @item qpel_chroma
  185. @item std_qpel
  186. old standard qpel (autodetected per fourcc/version)
  187. @item qpel_chroma2
  188. @item direct_blocksize
  189. direct-qpel-blocksize bug (autodetected per fourcc/version)
  190. @item edge
  191. edge padding bug (autodetected per fourcc/version)
  192. @item hpel_chroma
  193. @item dc_clip
  194. @item ms
  195. Workaround various bugs in microsoft broken decoders.
  196. @item trunc
  197. trancated frames
  198. @end table
  199. @item lelim @var{integer} (@emph{encoding,video})
  200. Set single coefficient elimination threshold for luminance (negative
  201. values also consider DC coefficient).
  202. @item celim @var{integer} (@emph{encoding,video})
  203. Set single coefficient elimination threshold for chrominance (negative
  204. values also consider dc coefficient)
  205. @item strict @var{integer} (@emph{decoding/encoding,audio,video})
  206. Specify how strictly to follow the standards.
  207. Possible values:
  208. @table @samp
  209. @item very
  210. strictly conform to a older more strict version of the spec or reference software
  211. @item strict
  212. strictly conform to all the things in the spec no matter what consequences
  213. @item normal
  214. @item unofficial
  215. allow unofficial extensions
  216. @item experimental
  217. allow non standardized experimental things, experimental
  218. (unfinished/work in progress/not well tested) decoders and encoders.
  219. Note: experimental decoders can pose a security risk, do not use this for
  220. decoding untrusted input.
  221. @end table
  222. @item b_qoffset @var{float} (@emph{encoding,video})
  223. Set QP offset between P and B frames.
  224. @item err_detect @var{flags} (@emph{decoding,audio,video})
  225. Set error detection flags.
  226. Possible values:
  227. @table @samp
  228. @item crccheck
  229. verify embedded CRCs
  230. @item bitstream
  231. detect bitstream specification deviations
  232. @item buffer
  233. detect improper bitstream length
  234. @item explode
  235. abort decoding on minor error detection
  236. @item careful
  237. consider things that violate the spec and have not been seen in the wild as errors
  238. @item compliant
  239. consider all spec non compliancies as errors
  240. @item aggressive
  241. consider things that a sane encoder should not do as an error
  242. @end table
  243. @item has_b_frames @var{integer}
  244. @item block_align @var{integer}
  245. @item mpeg_quant @var{integer} (@emph{encoding,video})
  246. Use MPEG quantizers instead of H.263.
  247. @item qsquish @var{float} (@emph{encoding,video})
  248. How to keep quantizer between qmin and qmax (0 = clip, 1 = use
  249. differentiable function).
  250. @item rc_qmod_amp @var{float} (@emph{encoding,video})
  251. Set experimental quantizer modulation.
  252. @item rc_qmod_freq @var{integer} (@emph{encoding,video})
  253. Set experimental quantizer modulation.
  254. @item rc_override_count @var{integer}
  255. @item rc_eq @var{string} (@emph{encoding,video})
  256. Set rate control equation. When computing the expression, besides the
  257. standard functions defined in the section 'Expression Evaluation', the
  258. following functions are available: bits2qp(bits), qp2bits(qp). Also
  259. the following constants are available: iTex pTex tex mv fCode iCount
  260. mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
  261. avgTex.
  262. @item maxrate @var{integer} (@emph{encoding,audio,video})
  263. Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
  264. @item minrate @var{integer} (@emph{encoding,audio,video})
  265. Set min bitrate tolerance (in bits/s). Most useful in setting up a CBR
  266. encode. It is of little use elsewise.
  267. @item bufsize @var{integer} (@emph{encoding,audio,video})
  268. Set ratecontrol buffer size (in bits).
  269. @item rc_buf_aggressivity @var{float} (@emph{encoding,video})
  270. Currently useless.
  271. @item i_qfactor @var{float} (@emph{encoding,video})
  272. Set QP factor between P and I frames.
  273. @item i_qoffset @var{float} (@emph{encoding,video})
  274. Set QP offset between P and I frames.
  275. @item rc_init_cplx @var{float} (@emph{encoding,video})
  276. Set initial complexity for 1-pass encoding.
  277. @item dct @var{integer} (@emph{encoding,video})
  278. Set DCT algorithm.
  279. Possible values:
  280. @table @samp
  281. @item auto
  282. autoselect a good one (default)
  283. @item fastint
  284. fast integer
  285. @item int
  286. accurate integer
  287. @item mmx
  288. @item altivec
  289. @item faan
  290. floating point AAN DCT
  291. @end table
  292. @item lumi_mask @var{float} (@emph{encoding,video})
  293. Compress bright areas stronger than medium ones.
  294. @item tcplx_mask @var{float} (@emph{encoding,video})
  295. Set temporal complexity masking.
  296. @item scplx_mask @var{float} (@emph{encoding,video})
  297. Set spatial complexity masking.
  298. @item p_mask @var{float} (@emph{encoding,video})
  299. Set inter masking.
  300. @item dark_mask @var{float} (@emph{encoding,video})
  301. Compress dark areas stronger than medium ones.
  302. @item idct @var{integer} (@emph{decoding/encoding,video})
  303. Select IDCT implementation.
  304. Possible values:
  305. @table @samp
  306. @item auto
  307. @item int
  308. @item simple
  309. @item simplemmx
  310. @item arm
  311. @item altivec
  312. @item sh4
  313. @item simplearm
  314. @item simplearmv5te
  315. @item simplearmv6
  316. @item simpleneon
  317. @item simplealpha
  318. @item ipp
  319. @item xvidmmx
  320. @item faani
  321. floating point AAN IDCT
  322. @end table
  323. @item slice_count @var{integer}
  324. @item ec @var{flags} (@emph{decoding,video})
  325. Set error concealment strategy.
  326. Possible values:
  327. @table @samp
  328. @item guess_mvs
  329. iterative motion vector (MV) search (slow)
  330. @item deblock
  331. use strong deblock filter for damaged MBs
  332. @end table
  333. @item bits_per_coded_sample @var{integer}
  334. @item pred @var{integer} (@emph{encoding,video})
  335. Set prediction method.
  336. Possible values:
  337. @table @samp
  338. @item left
  339. @item plane
  340. @item median
  341. @end table
  342. @item aspect @var{rational number} (@emph{encoding,video})
  343. Set sample aspect ratio.
  344. @item debug @var{flags} (@emph{decoding/encoding,audio,video,subtitles})
  345. Print specific debug info.
  346. Possible values:
  347. @table @samp
  348. @item pict
  349. picture info
  350. @item rc
  351. rate control
  352. @item bitstream
  353. @item mb_type
  354. macroblock (MB) type
  355. @item qp
  356. per-block quantization parameter (QP)
  357. @item mv
  358. motion vector
  359. @item dct_coeff
  360. @item skip
  361. @item startcode
  362. @item pts
  363. @item er
  364. error recognition
  365. @item mmco
  366. memory management control operations (H.264)
  367. @item bugs
  368. @item vis_qp
  369. visualize quantization parameter (QP), lower QP are tinted greener
  370. @item vis_mb_type
  371. visualize block types
  372. @item buffers
  373. picture buffer allocations
  374. @item thread_ops
  375. threading operations
  376. @end table
  377. @item vismv @var{integer} (@emph{decoding,video})
  378. Visualize motion vectors (MVs).
  379. Possible values:
  380. @table @samp
  381. @item pf
  382. forward predicted MVs of P-frames
  383. @item bf
  384. forward predicted MVs of B-frames
  385. @item bb
  386. backward predicted MVs of B-frames
  387. @end table
  388. @item cmp @var{integer} (@emph{encoding,video})
  389. Set full pel me compare function.
  390. Possible values:
  391. @table @samp
  392. @item sad
  393. sum of absolute differences, fast (default)
  394. @item sse
  395. sum of squared errors
  396. @item satd
  397. sum of absolute Hadamard transformed differences
  398. @item dct
  399. sum of absolute DCT transformed differences
  400. @item psnr
  401. sum of squared quantization errors (avoid, low quality)
  402. @item bit
  403. number of bits needed for the block
  404. @item rd
  405. rate distortion optimal, slow
  406. @item zero
  407. 0
  408. @item vsad
  409. sum of absolute vertical differences
  410. @item vsse
  411. sum of squared vertical differences
  412. @item nsse
  413. noise preserving sum of squared differences
  414. @item w53
  415. 5/3 wavelet, only used in snow
  416. @item w97
  417. 9/7 wavelet, only used in snow
  418. @item dctmax
  419. @item chroma
  420. @end table
  421. @item subcmp @var{integer} (@emph{encoding,video})
  422. Set sub pel me compare function.
  423. Possible values:
  424. @table @samp
  425. @item sad
  426. sum of absolute differences, fast (default)
  427. @item sse
  428. sum of squared errors
  429. @item satd
  430. sum of absolute Hadamard transformed differences
  431. @item dct
  432. sum of absolute DCT transformed differences
  433. @item psnr
  434. sum of squared quantization errors (avoid, low quality)
  435. @item bit
  436. number of bits needed for the block
  437. @item rd
  438. rate distortion optimal, slow
  439. @item zero
  440. 0
  441. @item vsad
  442. sum of absolute vertical differences
  443. @item vsse
  444. sum of squared vertical differences
  445. @item nsse
  446. noise preserving sum of squared differences
  447. @item w53
  448. 5/3 wavelet, only used in snow
  449. @item w97
  450. 9/7 wavelet, only used in snow
  451. @item dctmax
  452. @item chroma
  453. @end table
  454. @item mbcmp @var{integer} (@emph{encoding,video})
  455. Set macroblock compare function.
  456. Possible values:
  457. @table @samp
  458. @item sad
  459. sum of absolute differences, fast (default)
  460. @item sse
  461. sum of squared errors
  462. @item satd
  463. sum of absolute Hadamard transformed differences
  464. @item dct
  465. sum of absolute DCT transformed differences
  466. @item psnr
  467. sum of squared quantization errors (avoid, low quality)
  468. @item bit
  469. number of bits needed for the block
  470. @item rd
  471. rate distortion optimal, slow
  472. @item zero
  473. 0
  474. @item vsad
  475. sum of absolute vertical differences
  476. @item vsse
  477. sum of squared vertical differences
  478. @item nsse
  479. noise preserving sum of squared differences
  480. @item w53
  481. 5/3 wavelet, only used in snow
  482. @item w97
  483. 9/7 wavelet, only used in snow
  484. @item dctmax
  485. @item chroma
  486. @end table
  487. @item ildctcmp @var{integer} (@emph{encoding,video})
  488. Set interlaced dct compare function.
  489. Possible values:
  490. @table @samp
  491. @item sad
  492. sum of absolute differences, fast (default)
  493. @item sse
  494. sum of squared errors
  495. @item satd
  496. sum of absolute Hadamard transformed differences
  497. @item dct
  498. sum of absolute DCT transformed differences
  499. @item psnr
  500. sum of squared quantization errors (avoid, low quality)
  501. @item bit
  502. number of bits needed for the block
  503. @item rd
  504. rate distortion optimal, slow
  505. @item zero
  506. 0
  507. @item vsad
  508. sum of absolute vertical differences
  509. @item vsse
  510. sum of squared vertical differences
  511. @item nsse
  512. noise preserving sum of squared differences
  513. @item w53
  514. 5/3 wavelet, only used in snow
  515. @item w97
  516. 9/7 wavelet, only used in snow
  517. @item dctmax
  518. @item chroma
  519. @end table
  520. @item dia_size @var{integer} (@emph{encoding,video})
  521. Set diamond type & size for motion estimation.
  522. @item last_pred @var{integer} (@emph{encoding,video})
  523. Set amount of motion predictors from the previous frame.
  524. @item preme @var{integer} (@emph{encoding,video})
  525. Set pre motion estimation.
  526. @item precmp @var{integer} (@emph{encoding,video})
  527. Set pre motion estimation compare function.
  528. Possible values:
  529. @table @samp
  530. @item sad
  531. sum of absolute differences, fast (default)
  532. @item sse
  533. sum of squared errors
  534. @item satd
  535. sum of absolute Hadamard transformed differences
  536. @item dct
  537. sum of absolute DCT transformed differences
  538. @item psnr
  539. sum of squared quantization errors (avoid, low quality)
  540. @item bit
  541. number of bits needed for the block
  542. @item rd
  543. rate distortion optimal, slow
  544. @item zero
  545. 0
  546. @item vsad
  547. sum of absolute vertical differences
  548. @item vsse
  549. sum of squared vertical differences
  550. @item nsse
  551. noise preserving sum of squared differences
  552. @item w53
  553. 5/3 wavelet, only used in snow
  554. @item w97
  555. 9/7 wavelet, only used in snow
  556. @item dctmax
  557. @item chroma
  558. @end table
  559. @item pre_dia_size @var{integer} (@emph{encoding,video})
  560. Set diamond type & size for motion estimation pre-pass.
  561. @item subq @var{integer} (@emph{encoding,video})
  562. Set sub pel motion estimation quality.
  563. @item dtg_active_format @var{integer}
  564. @item me_range @var{integer} (@emph{encoding,video})
  565. Set limit motion vectors range (1023 for DivX player).
  566. @item ibias @var{integer} (@emph{encoding,video})
  567. Set intra quant bias.
  568. @item pbias @var{integer} (@emph{encoding,video})
  569. Set inter quant bias.
  570. @item color_table_id @var{integer}
  571. @item global_quality @var{integer} (@emph{encoding,audio,video})
  572. @item coder @var{integer} (@emph{encoding,video})
  573. Possible values:
  574. @table @samp
  575. @item vlc
  576. variable length coder / huffman coder
  577. @item ac
  578. arithmetic coder
  579. @item raw
  580. raw (no encoding)
  581. @item rle
  582. run-length coder
  583. @item deflate
  584. deflate-based coder
  585. @end table
  586. @item context @var{integer} (@emph{encoding,video})
  587. Set context model.
  588. @item slice_flags @var{integer}
  589. @item xvmc_acceleration @var{integer}
  590. @item mbd @var{integer} (@emph{encoding,video})
  591. Set macroblock decision algorithm (high quality mode).
  592. Possible values:
  593. @table @samp
  594. @item simple
  595. use mbcmp (default)
  596. @item bits
  597. use fewest bits
  598. @item rd
  599. use best rate distortion
  600. @end table
  601. @item stream_codec_tag @var{integer}
  602. @item sc_threshold @var{integer} (@emph{encoding,video})
  603. Set scene change threshold.
  604. @item lmin @var{integer} (@emph{encoding,video})
  605. Set min lagrange factor (VBR).
  606. @item lmax @var{integer} (@emph{encoding,video})
  607. Set max lagrange factor (VBR).
  608. @item nr @var{integer} (@emph{encoding,video})
  609. Set noise reduction.
  610. @item rc_init_occupancy @var{integer} (@emph{encoding,video})
  611. Set number of bits which should be loaded into the rc buffer before
  612. decoding starts.
  613. @item flags2 @var{flags} (@emph{decoding/encoding,audio,video})
  614. Possible values:
  615. @table @samp
  616. @item fast
  617. Allow non spec compliant speedup tricks.
  618. @item sgop
  619. Deprecated, use mpegvideo private options instead.
  620. @item noout
  621. Skip bitstream encoding.
  622. @item ignorecrop
  623. Ignore cropping information from sps.
  624. @item local_header
  625. Place global headers at every keyframe instead of in extradata.
  626. @item chunks
  627. Frame data might be split into multiple chunks.
  628. @item showall
  629. Show all frames before the first keyframe.
  630. @item skiprd
  631. Deprecated, use mpegvideo private options instead.
  632. @end table
  633. @item error @var{integer} (@emph{encoding,video})
  634. @item qns @var{integer} (@emph{encoding,video})
  635. Deprecated, use mpegvideo private options instead.
  636. @item threads @var{integer} (@emph{decoding/encoding,video})
  637. Possible values:
  638. @table @samp
  639. @item auto
  640. detect a good number of threads
  641. @end table
  642. @item me_threshold @var{integer} (@emph{encoding,video})
  643. Set motion estimation threshold.
  644. @item mb_threshold @var{integer} (@emph{encoding,video})
  645. Set macroblock threshold.
  646. @item dc @var{integer} (@emph{encoding,video})
  647. Set intra_dc_precision.
  648. @item nssew @var{integer} (@emph{encoding,video})
  649. Set nsse weight.
  650. @item skip_top @var{integer} (@emph{decoding,video})
  651. Set number of macroblock rows at the top which are skipped.
  652. @item skip_bottom @var{integer} (@emph{decoding,video})
  653. Set number of macroblock rows at the bottom which are skipped.
  654. @item profile @var{integer} (@emph{encoding,audio,video})
  655. Possible values:
  656. @table @samp
  657. @item unknown
  658. @item aac_main
  659. @item aac_low
  660. @item aac_ssr
  661. @item aac_ltp
  662. @item aac_he
  663. @item aac_he_v2
  664. @item aac_ld
  665. @item aac_eld
  666. @item mpeg2_aac_low
  667. @item mpeg2_aac_he
  668. @item dts
  669. @item dts_es
  670. @item dts_96_24
  671. @item dts_hd_hra
  672. @item dts_hd_ma
  673. @end table
  674. @item level @var{integer} (@emph{encoding,audio,video})
  675. Possible values:
  676. @table @samp
  677. @item unknown
  678. @end table
  679. @item lowres @var{integer} (@emph{decoding,audio,video})
  680. Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
  681. @item skip_threshold @var{integer} (@emph{encoding,video})
  682. Set frame skip threshold.
  683. @item skip_factor @var{integer} (@emph{encoding,video})
  684. Set frame skip factor.
  685. @item skip_exp @var{integer} (@emph{encoding,video})
  686. Set frame skip exponent.
  687. Negative values behave identical to the corresponding positive ones, except
  688. that the score is normalized.
  689. Positive values exist primarly for compatibility reasons and are not so useful.
  690. @item skipcmp @var{integer} (@emph{encoding,video})
  691. Set frame skip compare function.
  692. Possible values:
  693. @table @samp
  694. @item sad
  695. sum of absolute differences, fast (default)
  696. @item sse
  697. sum of squared errors
  698. @item satd
  699. sum of absolute Hadamard transformed differences
  700. @item dct
  701. sum of absolute DCT transformed differences
  702. @item psnr
  703. sum of squared quantization errors (avoid, low quality)
  704. @item bit
  705. number of bits needed for the block
  706. @item rd
  707. rate distortion optimal, slow
  708. @item zero
  709. 0
  710. @item vsad
  711. sum of absolute vertical differences
  712. @item vsse
  713. sum of squared vertical differences
  714. @item nsse
  715. noise preserving sum of squared differences
  716. @item w53
  717. 5/3 wavelet, only used in snow
  718. @item w97
  719. 9/7 wavelet, only used in snow
  720. @item dctmax
  721. @item chroma
  722. @end table
  723. @item border_mask @var{float} (@emph{encoding,video})
  724. Increase the quantizer for macroblocks close to borders.
  725. @item mblmin @var{integer} (@emph{encoding,video})
  726. Set min macroblock lagrange factor (VBR).
  727. @item mblmax @var{integer} (@emph{encoding,video})
  728. Set max macroblock lagrange factor (VBR).
  729. @item mepc @var{integer} (@emph{encoding,video})
  730. Set motion estimation bitrate penalty compensation (1.0 = 256).
  731. @item skip_loop_filter @var{integer} (@emph{decoding,video})
  732. @item skip_idct @var{integer} (@emph{decoding,video})
  733. @item skip_frame @var{integer} (@emph{decoding,video})
  734. Make decoder discard processing depending on the frame type selected
  735. by the option value.
  736. @option{skip_loop_filter} skips frame loop filtering, @option{skip_idct}
  737. skips frame IDCT/dequantization, @option{skip_frame} skips decoding.
  738. Possible values:
  739. @table @samp
  740. @item none
  741. Discard no frame.
  742. @item default
  743. Discard useless frames like 0-sized frames.
  744. @item noref
  745. Discard all non-reference frames.
  746. @item bidir
  747. Discard all bidirectional frames.
  748. @item nokey
  749. Discard all frames excepts keyframes.
  750. @item all
  751. Discard all frames.
  752. @end table
  753. Default value is @samp{default}.
  754. @item bidir_refine @var{integer} (@emph{encoding,video})
  755. Refine the two motion vectors used in bidirectional macroblocks.
  756. @item brd_scale @var{integer} (@emph{encoding,video})
  757. Downscale frames for dynamic B-frame decision.
  758. @item keyint_min @var{integer} (@emph{encoding,video})
  759. Set minimum interval between IDR-frames.
  760. @item refs @var{integer} (@emph{encoding,video})
  761. Set reference frames to consider for motion compensation.
  762. @item chromaoffset @var{integer} (@emph{encoding,video})
  763. Set chroma qp offset from luma.
  764. @item trellis @var{integer} (@emph{encoding,audio,video})
  765. Set rate-distortion optimal quantization.
  766. @item sc_factor @var{integer} (@emph{encoding,video})
  767. Set value multiplied by qscale for each frame and added to
  768. scene_change_score.
  769. @item mv0_threshold @var{integer} (@emph{encoding,video})
  770. @item b_sensitivity @var{integer} (@emph{encoding,video})
  771. Adjust sensitivity of b_frame_strategy 1.
  772. @item compression_level @var{integer} (@emph{encoding,audio,video})
  773. @item min_prediction_order @var{integer} (@emph{encoding,audio})
  774. @item max_prediction_order @var{integer} (@emph{encoding,audio})
  775. @item timecode_frame_start @var{integer} (@emph{encoding,video})
  776. Set GOP timecode frame start number, in non drop frame format.
  777. @item request_channels @var{integer} (@emph{decoding,audio})
  778. Set desired number of audio channels.
  779. @item bits_per_raw_sample @var{integer}
  780. @item channel_layout @var{integer} (@emph{decoding/encoding,audio})
  781. Possible values:
  782. @table @samp
  783. @end table
  784. @item request_channel_layout @var{integer} (@emph{decoding,audio})
  785. Possible values:
  786. @table @samp
  787. @end table
  788. @item rc_max_vbv_use @var{float} (@emph{encoding,video})
  789. @item rc_min_vbv_use @var{float} (@emph{encoding,video})
  790. @item ticks_per_frame @var{integer} (@emph{decoding/encoding,audio,video})
  791. @item color_primaries @var{integer} (@emph{decoding/encoding,video})
  792. @item color_trc @var{integer} (@emph{decoding/encoding,video})
  793. @item colorspace @var{integer} (@emph{decoding/encoding,video})
  794. @item color_range @var{integer} (@emph{decoding/encoding,video})
  795. @item chroma_sample_location @var{integer} (@emph{decoding/encoding,video})
  796. @item log_level_offset @var{integer}
  797. Set the log level offset.
  798. @item slices @var{integer} (@emph{encoding,video})
  799. Number of slices, used in parallelized encoding.
  800. @item thread_type @var{flags} (@emph{decoding/encoding,video})
  801. Select multithreading type.
  802. Possible values:
  803. @table @samp
  804. @item slice
  805. @item frame
  806. @end table
  807. @item audio_service_type @var{integer} (@emph{encoding,audio})
  808. Set audio service type.
  809. Possible values:
  810. @table @samp
  811. @item ma
  812. Main Audio Service
  813. @item ef
  814. Effects
  815. @item vi
  816. Visually Impaired
  817. @item hi
  818. Hearing Impaired
  819. @item di
  820. Dialogue
  821. @item co
  822. Commentary
  823. @item em
  824. Emergency
  825. @item vo
  826. Voice Over
  827. @item ka
  828. Karaoke
  829. @end table
  830. @item request_sample_fmt @var{sample_fmt} (@emph{decoding,audio})
  831. Set sample format audio decoders should prefer. Default value is
  832. @code{none}.
  833. @item pkt_timebase @var{rational number}
  834. @item sub_charenc @var{encoding} (@emph{decoding,subtitles})
  835. Set the input subtitles character encoding.
  836. @item field_order @var{field_order} (@emph{video})
  837. Set/override the field order of the video.
  838. Possible values:
  839. @table @samp
  840. @item progressive
  841. Progressive video
  842. @item tt
  843. Interlaced video, top field coded and displayed first
  844. @item bb
  845. Interlaced video, bottom field coded and displayed first
  846. @item tb
  847. Interlaced video, top coded first, bottom displayed first
  848. @item bt
  849. Interlaced video, bottom coded first, top displayed first
  850. @end table
  851. @item skip_alpha @var{integer} (@emph{decoding,video})
  852. Set to 1 to disable processing alpha (transparency). This works like the
  853. @samp{gray} flag in the @option{flags} option which skips chroma information
  854. instead of alpha. Default is 0.
  855. @end table
  856. @c man end CODEC OPTIONS
  857. @ifclear config-writeonly
  858. @include decoders.texi
  859. @end ifclear
  860. @ifclear config-readonly
  861. @include encoders.texi
  862. @end ifclear