123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084 |
- <!DOCTYPE html>
- <html lang="en">
- <head>
- <meta charset="utf-8" />
- <meta http-equiv="X-UA-Compatible" content="IE=edge" />
- <title>FFmpeg documentation</title>
- <link rel="stylesheet" href="bootstrap.min.css" />
- <link rel="stylesheet" href="style.min.css" />
-
- <meta name="description" content="FFmpeg Codecs Documentation: ">
- <meta name="keywords" content="FFmpeg documentation : FFmpeg Codecs ">
- <meta name="Generator" content="texi2html 5.0">
- <!-- Created on March 9, 2020 by texi2html 5.0 -->
- <!--
- texi2html was written by:
- Lionel Cons <Lionel.Cons@cern.ch> (original author)
- Karl Berry <karl@freefriends.org>
- Olaf Bachmann <obachman@mathematik.uni-kl.de>
- and many others.
- Maintained by: Many creative people.
- Send bugs and suggestions to <texi2html-bug@nongnu.org>
-
- -->
- <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- </head>
- <body>
- <div class="container">
-
- <h1 class="titlefont">FFmpeg Codecs Documentation</h1>
- <hr>
- <a name="SEC_Top"></a>
-
- <a name="SEC_Contents"></a>
- <h1>Table of Contents</h1>
-
- <div class="contents">
-
- <ul class="no-bullet">
- <li><a name="toc-Description" href="#Description">1 Description</a></li>
- <li><a name="toc-Codec-Options" href="#Codec-Options">2 Codec Options</a></li>
- <li><a name="toc-Decoders" href="#Decoders">3 Decoders</a></li>
- <li><a name="toc-Video-Decoders" href="#Video-Decoders">4 Video Decoders</a>
- <ul class="no-bullet">
- <li><a name="toc-rawvideo" href="#rawvideo">4.1 rawvideo</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-31" href="#Options-31">4.1.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libdav1d" href="#libdav1d">4.2 libdav1d</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-29" href="#Options-29">4.2.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libdavs2" href="#libdavs2">4.3 libdavs2</a></li>
- </ul></li>
- <li><a name="toc-Audio-Decoders" href="#Audio-Decoders">5 Audio Decoders</a>
- <ul class="no-bullet">
- <li><a name="toc-ac3" href="#ac3">5.1 ac3</a>
- <ul class="no-bullet">
- <li><a name="toc-AC_002d3-Decoder-Options" href="#AC_002d3-Decoder-Options">5.1.1 AC-3 Decoder Options</a></li>
- </ul></li>
- <li><a name="toc-flac-2" href="#flac-2">5.2 flac</a>
- <ul class="no-bullet">
- <li><a name="toc-FLAC-Decoder-options" href="#FLAC-Decoder-options">5.2.1 FLAC Decoder options</a></li>
- </ul></li>
- <li><a name="toc-ffwavesynth" href="#ffwavesynth">5.3 ffwavesynth</a></li>
- <li><a name="toc-libcelt" href="#libcelt">5.4 libcelt</a></li>
- <li><a name="toc-libgsm" href="#libgsm">5.5 libgsm</a></li>
- <li><a name="toc-libilbc" href="#libilbc">5.6 libilbc</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-4" href="#Options-4">5.6.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopencore_002damrnb" href="#libopencore_002damrnb">5.7 libopencore-amrnb</a></li>
- <li><a name="toc-libopencore_002damrwb" href="#libopencore_002damrwb">5.8 libopencore-amrwb</a></li>
- <li><a name="toc-libopus" href="#libopus">5.9 libopus</a></li>
- </ul></li>
- <li><a name="toc-Subtitles-Decoders" href="#Subtitles-Decoders">6 Subtitles Decoders</a>
- <ul class="no-bullet">
- <li><a name="toc-libaribb24" href="#libaribb24">6.1 libaribb24</a>
- <ul class="no-bullet">
- <li><a name="toc-libaribb24-Decoder-Options" href="#libaribb24-Decoder-Options">6.1.1 libaribb24 Decoder Options</a></li>
- </ul></li>
- <li><a name="toc-dvbsub" href="#dvbsub">6.2 dvbsub</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-16" href="#Options-16">6.2.1 Options</a></li>
- </ul></li>
- <li><a name="toc-dvdsub" href="#dvdsub">6.3 dvdsub</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-30" href="#Options-30">6.3.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libzvbi_002dteletext" href="#libzvbi_002dteletext">6.4 libzvbi-teletext</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-35" href="#Options-35">6.4.1 Options</a></li>
- </ul>
- </li>
- </ul></li>
- <li><a name="toc-Encoders" href="#Encoders">7 Encoders</a></li>
- <li><a name="toc-Audio-Encoders" href="#Audio-Encoders">8 Audio Encoders</a>
- <ul class="no-bullet">
- <li><a name="toc-aac" href="#aac">8.1 aac</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-34" href="#Options-34">8.1.1 Options</a></li>
- </ul></li>
- <li><a name="toc-ac3-and-ac3_005ffixed" href="#ac3-and-ac3_005ffixed">8.2 ac3 and ac3_fixed</a>
- <ul class="no-bullet">
- <li><a name="toc-AC_002d3-Metadata" href="#AC_002d3-Metadata">8.2.1 AC-3 Metadata</a>
- <ul class="no-bullet">
- <li><a name="toc-Metadata-Control-Options" href="#Metadata-Control-Options">8.2.1.1 Metadata Control Options</a></li>
- <li><a name="toc-Downmix-Levels" href="#Downmix-Levels">8.2.1.2 Downmix Levels</a></li>
- <li><a name="toc-Audio-Production-Information" href="#Audio-Production-Information">8.2.1.3 Audio Production Information</a></li>
- <li><a name="toc-Other-Metadata-Options" href="#Other-Metadata-Options">8.2.1.4 Other Metadata Options</a></li>
- </ul></li>
- <li><a name="toc-Extended-Bitstream-Information" href="#Extended-Bitstream-Information">8.2.2 Extended Bitstream Information</a>
- <ul class="no-bullet">
- <li><a name="toc-Extended-Bitstream-Information-_002d-Part-1" href="#Extended-Bitstream-Information-_002d-Part-1">8.2.2.1 Extended Bitstream Information - Part 1</a></li>
- <li><a name="toc-Extended-Bitstream-Information-_002d-Part-2" href="#Extended-Bitstream-Information-_002d-Part-2">8.2.2.2 Extended Bitstream Information - Part 2</a></li>
- </ul></li>
- <li><a name="toc-Other-AC_002d3-Encoding-Options" href="#Other-AC_002d3-Encoding-Options">8.2.3 Other AC-3 Encoding Options</a></li>
- <li><a name="toc-Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options" href="#Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options">8.2.4 Floating-Point-Only AC-3 Encoding Options</a></li>
- </ul></li>
- <li><a name="toc-flac-1" href="#flac-1">8.3 flac</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-20" href="#Options-20">8.3.1 Options</a></li>
- </ul></li>
- <li><a name="toc-opus" href="#opus">8.4 opus</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-17" href="#Options-17">8.4.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libfdk_005faac" href="#libfdk_005faac">8.5 libfdk_aac</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-32" href="#Options-32">8.5.1 Options</a></li>
- <li><a name="toc-Examples-1" href="#Examples-1">8.5.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-libmp3lame-1" href="#libmp3lame-1">8.6 libmp3lame</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-6" href="#Options-6">8.6.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopencore_002damrnb-1" href="#libopencore_002damrnb-1">8.7 libopencore-amrnb</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-21" href="#Options-21">8.7.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopus-1" href="#libopus-1">8.8 libopus</a>
- <ul class="no-bullet">
- <li><a name="toc-Option-Mapping" href="#Option-Mapping">8.8.1 Option Mapping</a></li>
- </ul></li>
- <li><a name="toc-libshine-1" href="#libshine-1">8.9 libshine</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-25" href="#Options-25">8.9.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libtwolame" href="#libtwolame">8.10 libtwolame</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-23" href="#Options-23">8.10.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libvo_002damrwbenc" href="#libvo_002damrwbenc">8.11 libvo-amrwbenc</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-19" href="#Options-19">8.11.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libvorbis" href="#libvorbis">8.12 libvorbis</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-7" href="#Options-7">8.12.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libwavpack-1" href="#libwavpack-1">8.13 libwavpack</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-12" href="#Options-12">8.13.1 Options</a></li>
- </ul></li>
- <li><a name="toc-mjpeg" href="#mjpeg">8.14 mjpeg</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-28" href="#Options-28">8.14.1 Options</a></li>
- </ul></li>
- <li><a name="toc-wavpack" href="#wavpack">8.15 wavpack</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-10" href="#Options-10">8.15.1 Options</a>
- <ul class="no-bullet">
- <li><a name="toc-Shared-options" href="#Shared-options">8.15.1.1 Shared options</a></li>
- <li><a name="toc-Private-options-1" href="#Private-options-1">8.15.1.2 Private options</a></li>
- </ul>
- </li>
- </ul>
- </li>
- </ul></li>
- <li><a name="toc-Video-Encoders" href="#Video-Encoders">9 Video Encoders</a>
- <ul class="no-bullet">
- <li><a name="toc-Hap" href="#Hap">9.1 Hap</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-15" href="#Options-15">9.1.1 Options</a></li>
- </ul></li>
- <li><a name="toc-jpeg2000" href="#jpeg2000">9.2 jpeg2000</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-14" href="#Options-14">9.2.1 Options</a></li>
- </ul></li>
- <li><a name="toc-librav1e" href="#librav1e">9.3 librav1e</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-1" href="#Options-1">9.3.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libaom_002dav1" href="#libaom_002dav1">9.4 libaom-av1</a>
- <ul class="no-bullet">
- <li><a name="toc-Options" href="#Options">9.4.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libkvazaar" href="#libkvazaar">9.5 libkvazaar</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-22" href="#Options-22">9.5.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libopenh264" href="#libopenh264">9.6 libopenh264</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-5" href="#Options-5">9.6.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libtheora" href="#libtheora">9.7 libtheora</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-9" href="#Options-9">9.7.1 Options</a></li>
- <li><a name="toc-Examples" href="#Examples">9.7.2 Examples</a></li>
- </ul></li>
- <li><a name="toc-libvpx" href="#libvpx">9.8 libvpx</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-24" href="#Options-24">9.8.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libwebp" href="#libwebp">9.9 libwebp</a>
- <ul class="no-bullet">
- <li><a name="toc-Pixel-Format" href="#Pixel-Format">9.9.1 Pixel Format</a></li>
- <li><a name="toc-Options-13" href="#Options-13">9.9.2 Options</a></li>
- </ul></li>
- <li><a name="toc-libx264_002c-libx264rgb" href="#libx264_002c-libx264rgb">9.10 libx264, libx264rgb</a>
- <ul class="no-bullet">
- <li><a name="toc-Supported-Pixel-Formats" href="#Supported-Pixel-Formats">9.10.1 Supported Pixel Formats</a></li>
- <li><a name="toc-Options-18" href="#Options-18">9.10.2 Options</a></li>
- </ul></li>
- <li><a name="toc-libx265" href="#libx265">9.11 libx265</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-26" href="#Options-26">9.11.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libxavs2" href="#libxavs2">9.12 libxavs2</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-11" href="#Options-11">9.12.1 Options</a></li>
- </ul></li>
- <li><a name="toc-libxvid" href="#libxvid">9.13 libxvid</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-3" href="#Options-3">9.13.1 Options</a></li>
- </ul></li>
- <li><a name="toc-mpeg2" href="#mpeg2">9.14 mpeg2</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-33" href="#Options-33">9.14.1 Options</a></li>
- </ul></li>
- <li><a name="toc-png" href="#png">9.15 png</a>
- <ul class="no-bullet">
- <li><a name="toc-Private-options" href="#Private-options">9.15.1 Private options</a></li>
- </ul></li>
- <li><a name="toc-ProRes" href="#ProRes">9.16 ProRes</a>
- <ul class="no-bullet">
- <li><a name="toc-Private-Options-for-prores_002dks" href="#Private-Options-for-prores_002dks">9.16.1 Private Options for prores-ks</a></li>
- <li><a name="toc-Speed-considerations" href="#Speed-considerations">9.16.2 Speed considerations</a></li>
- </ul></li>
- <li><a name="toc-QSV-encoders" href="#QSV-encoders">9.17 QSV encoders</a></li>
- <li><a name="toc-snow" href="#snow">9.18 snow</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-2" href="#Options-2">9.18.1 Options</a></li>
- </ul></li>
- <li><a name="toc-VAAPI-encoders" href="#VAAPI-encoders">9.19 VAAPI encoders</a></li>
- <li><a name="toc-vc2" href="#vc2">9.20 vc2</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-27" href="#Options-27">9.20.1 Options</a></li>
- </ul>
- </li>
- </ul></li>
- <li><a name="toc-Subtitles-Encoders" href="#Subtitles-Encoders">10 Subtitles Encoders</a>
- <ul class="no-bullet">
- <li><a name="toc-dvdsub-1" href="#dvdsub-1">10.1 dvdsub</a>
- <ul class="no-bullet">
- <li><a name="toc-Options-8" href="#Options-8">10.1.1 Options</a></li>
- </ul>
- </li>
- </ul></li>
- <li><a name="toc-See-Also" href="#See-Also">11 See Also</a></li>
- <li><a name="toc-Authors" href="#Authors">12 Authors</a></li>
- </ul>
- </div>
-
-
- <hr size="6">
- <a name="Description"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Description">1 Description</a></h1>
-
- <p>This document describes the codecs (decoders and encoders) provided by
- the libavcodec library.
- </p>
-
- <p><a name="codec_002doptions"></a>
- </p><a name="Codec-Options"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Codec-Options">2 Codec Options</a></h1>
-
- <p>libavcodec provides some generic global options, which can be set on
- all the encoders and decoders. In addition each codec may support
- so-called private options, which are specific for a given codec.
- </p>
- <p>Sometimes, a global option may only affect a specific kind of codec,
- and may be nonsensical or ignored by another, so you need to be aware
- of the meaning of the specified options. Also some options are
- meant only for decoding or encoding.
- </p>
- <p>Options may be set by specifying -<var>option</var> <var>value</var> in the
- FFmpeg tools, or by setting the value explicitly in the
- <code>AVCodecContext</code> options or using the ‘<tt>libavutil/opt.h</tt>’ API
- for programmatic use.
- </p>
- <p>The list of supported options follow:
- </p>
- <dl compact="compact">
- <dt>‘<samp>b <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set bitrate in bits/s. Default value is 200K.
- </p>
- </dd>
- <dt>‘<samp>ab <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dd><p>Set audio bitrate (in bits/s). Default value is 128K.
- </p>
- </dd>
- <dt>‘<samp>bt <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set video bitrate tolerance (in bits/s). In 1-pass mode, bitrate
- tolerance specifies how far ratecontrol is willing to deviate from the
- target average bitrate value. This is not related to min/max
- bitrate. Lowering tolerance too much has an adverse effect on quality.
- </p>
- </dd>
- <dt>‘<samp>flags <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp>’</dt>
- <dd><p>Set generic flags.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>mv4</samp>’</dt>
- <dd><p>Use four motion vector by macroblock (mpeg4).
- </p></dd>
- <dt>‘<samp>qpel</samp>’</dt>
- <dd><p>Use 1/4 pel motion compensation.
- </p></dd>
- <dt>‘<samp>loop</samp>’</dt>
- <dd><p>Use loop filter.
- </p></dd>
- <dt>‘<samp>qscale</samp>’</dt>
- <dd><p>Use fixed qscale.
- </p></dd>
- <dt>‘<samp>pass1</samp>’</dt>
- <dd><p>Use internal 2pass ratecontrol in first pass mode.
- </p></dd>
- <dt>‘<samp>pass2</samp>’</dt>
- <dd><p>Use internal 2pass ratecontrol in second pass mode.
- </p></dd>
- <dt>‘<samp>gray</samp>’</dt>
- <dd><p>Only decode/encode grayscale.
- </p></dd>
- <dt>‘<samp>emu_edge</samp>’</dt>
- <dd><p>Do not draw edges.
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>Set error[?] variables during encoding.
- </p></dd>
- <dt>‘<samp>truncated</samp>’</dt>
- <dd><p>Input bitstream might be randomly truncated.
- </p></dd>
- <dt>‘<samp>drop_changed</samp>’</dt>
- <dd><p>Don’t output frames whose parameters differ from first decoded frame in stream.
- Error AVERROR_INPUT_CHANGED is returned when a frame is dropped.
- </p>
- </dd>
- <dt>‘<samp>ildct</samp>’</dt>
- <dd><p>Use interlaced DCT.
- </p></dd>
- <dt>‘<samp>low_delay</samp>’</dt>
- <dd><p>Force low delay.
- </p></dd>
- <dt>‘<samp>global_header</samp>’</dt>
- <dd><p>Place global headers in extradata instead of every keyframe.
- </p></dd>
- <dt>‘<samp>bitexact</samp>’</dt>
- <dd><p>Only write platform-, build- and time-independent data. (except (I)DCT).
- This ensures that file and data checksums are reproducible and match between
- platforms. Its primary use is for regression testing.
- </p></dd>
- <dt>‘<samp>aic</samp>’</dt>
- <dd><p>Apply H263 advanced intra coding / mpeg4 ac prediction.
- </p></dd>
- <dt>‘<samp>cbp</samp>’</dt>
- <dd><p>Deprecated, use mpegvideo private options instead.
- </p></dd>
- <dt>‘<samp>qprd</samp>’</dt>
- <dd><p>Deprecated, use mpegvideo private options instead.
- </p></dd>
- <dt>‘<samp>ilme</samp>’</dt>
- <dd><p>Apply interlaced motion estimation.
- </p></dd>
- <dt>‘<samp>cgop</samp>’</dt>
- <dd><p>Use closed gop.
- </p></dd>
- <dt>‘<samp>output_corrupt</samp>’</dt>
- <dd><p>Output even potentially corrupted frames.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>me_method <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set motion estimation method.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>zero motion estimation (fastest)
- </p></dd>
- <dt>‘<samp>full</samp>’</dt>
- <dd><p>full motion estimation (slowest)
- </p></dd>
- <dt>‘<samp>epzs</samp>’</dt>
- <dd><p>EPZS motion estimation (default)
- </p></dd>
- <dt>‘<samp>esa</samp>’</dt>
- <dd><p>esa motion estimation (alias for full)
- </p></dd>
- <dt>‘<samp>tesa</samp>’</dt>
- <dd><p>tesa motion estimation
- </p></dd>
- <dt>‘<samp>dia</samp>’</dt>
- <dd><p>dia motion estimation (alias for epzs)
- </p></dd>
- <dt>‘<samp>log</samp>’</dt>
- <dd><p>log motion estimation
- </p></dd>
- <dt>‘<samp>phods</samp>’</dt>
- <dd><p>phods motion estimation
- </p></dd>
- <dt>‘<samp>x1</samp>’</dt>
- <dd><p>X1 motion estimation
- </p></dd>
- <dt>‘<samp>hex</samp>’</dt>
- <dd><p>hex motion estimation
- </p></dd>
- <dt>‘<samp>umh</samp>’</dt>
- <dd><p>umh motion estimation
- </p></dd>
- <dt>‘<samp>iter</samp>’</dt>
- <dd><p>iter motion estimation
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>extradata_size <var>integer</var></samp>’</dt>
- <dd><p>Set extradata size.
- </p>
- </dd>
- <dt>‘<samp>time_base <var>rational number</var></samp>’</dt>
- <dd><p>Set codec time base.
- </p>
- <p>It is the fundamental unit of time (in seconds) in terms of which
- frame timestamps are represented. For fixed-fps content, timebase
- should be <code>1 / frame_rate</code> and timestamp increments should be
- identically 1.
- </p>
- </dd>
- <dt>‘<samp>g <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set the group of picture (GOP) size. Default value is 12.
- </p>
- </dd>
- <dt>‘<samp>ar <var>integer</var> (<em>decoding/encoding,audio</em>)</samp>’</dt>
- <dd><p>Set audio sampling rate (in Hz).
- </p>
- </dd>
- <dt>‘<samp>ac <var>integer</var> (<em>decoding/encoding,audio</em>)</samp>’</dt>
- <dd><p>Set number of audio channels.
- </p>
- </dd>
- <dt>‘<samp>cutoff <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dd><p>Set cutoff bandwidth. (Supported only by selected encoders, see
- their respective documentation sections.)
- </p>
- </dd>
- <dt>‘<samp>frame_size <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dd><p>Set audio frame size.
- </p>
- <p>Each submitted frame except the last must contain exactly frame_size
- samples per channel. May be 0 when the codec has
- CODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is not
- restricted. It is set by some decoders to indicate constant frame
- size.
- </p>
- </dd>
- <dt>‘<samp>frame_number <var>integer</var></samp>’</dt>
- <dd><p>Set the frame number.
- </p>
- </dd>
- <dt>‘<samp>delay <var>integer</var></samp>’</dt>
- <dt>‘<samp>qcomp <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set video quantizer scale compression (VBR). It is used as a constant
- in the ratecontrol equation. Recommended range for default rc_eq:
- 0.0-1.0.
- </p>
- </dd>
- <dt>‘<samp>qblur <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set video quantizer scale blur (VBR).
- </p>
- </dd>
- <dt>‘<samp>qmin <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set min video quantizer scale (VBR). Must be included between -1 and
- 69, default value is 2.
- </p>
- </dd>
- <dt>‘<samp>qmax <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set max video quantizer scale (VBR). Must be included between -1 and
- 1024, default value is 31.
- </p>
- </dd>
- <dt>‘<samp>qdiff <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set max difference between the quantizer scale (VBR).
- </p>
- </dd>
- <dt>‘<samp>bf <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set max number of B frames between non-B-frames.
- </p>
- <p>Must be an integer between -1 and 16. 0 means that B-frames are
- disabled. If a value of -1 is used, it will choose an automatic value
- depending on the encoder.
- </p>
- <p>Default value is 0.
- </p>
- </dd>
- <dt>‘<samp>b_qfactor <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set qp factor between P and B frames.
- </p>
- </dd>
- <dt>‘<samp>rc_strategy <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set ratecontrol method.
- </p>
- </dd>
- <dt>‘<samp>b_strategy <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set strategy to choose between I/P/B-frames.
- </p>
- </dd>
- <dt>‘<samp>ps <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set RTP payload size in bytes.
- </p>
- </dd>
- <dt>‘<samp>mv_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>header_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>i_tex_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>p_tex_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>i_count <var>integer</var></samp>’</dt>
- <dt>‘<samp>p_count <var>integer</var></samp>’</dt>
- <dt>‘<samp>skip_count <var>integer</var></samp>’</dt>
- <dt>‘<samp>misc_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>frame_bits <var>integer</var></samp>’</dt>
- <dt>‘<samp>codec_tag <var>integer</var></samp>’</dt>
- <dt>‘<samp>bug <var>flags</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Workaround not auto detected encoder bugs.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>autodetect</samp>’</dt>
- <dt>‘<samp>old_msmpeg4</samp>’</dt>
- <dd><p>some old lavc generated msmpeg4v3 files (no autodetection)
- </p></dd>
- <dt>‘<samp>xvid_ilace</samp>’</dt>
- <dd><p>Xvid interlacing bug (autodetected if fourcc==XVIX)
- </p></dd>
- <dt>‘<samp>ump4</samp>’</dt>
- <dd><p>(autodetected if fourcc==UMP4)
- </p></dd>
- <dt>‘<samp>no_padding</samp>’</dt>
- <dd><p>padding bug (autodetected)
- </p></dd>
- <dt>‘<samp>amv</samp>’</dt>
- <dt>‘<samp>ac_vlc</samp>’</dt>
- <dd><p>illegal vlc bug (autodetected per fourcc)
- </p></dd>
- <dt>‘<samp>qpel_chroma</samp>’</dt>
- <dt>‘<samp>std_qpel</samp>’</dt>
- <dd><p>old standard qpel (autodetected per fourcc/version)
- </p></dd>
- <dt>‘<samp>qpel_chroma2</samp>’</dt>
- <dt>‘<samp>direct_blocksize</samp>’</dt>
- <dd><p>direct-qpel-blocksize bug (autodetected per fourcc/version)
- </p></dd>
- <dt>‘<samp>edge</samp>’</dt>
- <dd><p>edge padding bug (autodetected per fourcc/version)
- </p></dd>
- <dt>‘<samp>hpel_chroma</samp>’</dt>
- <dt>‘<samp>dc_clip</samp>’</dt>
- <dt>‘<samp>ms</samp>’</dt>
- <dd><p>Workaround various bugs in microsoft broken decoders.
- </p></dd>
- <dt>‘<samp>trunc</samp>’</dt>
- <dd><p>trancated frames
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>lelim <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set single coefficient elimination threshold for luminance (negative
- values also consider DC coefficient).
- </p>
- </dd>
- <dt>‘<samp>celim <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set single coefficient elimination threshold for chrominance (negative
- values also consider dc coefficient)
- </p>
- </dd>
- <dt>‘<samp>strict <var>integer</var> (<em>decoding/encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Specify how strictly to follow the standards.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>very</samp>’</dt>
- <dd><p>strictly conform to an older more strict version of the spec or reference software
- </p></dd>
- <dt>‘<samp>strict</samp>’</dt>
- <dd><p>strictly conform to all the things in the spec no matter what consequences
- </p></dd>
- <dt>‘<samp>normal</samp>’</dt>
- <dt>‘<samp>unofficial</samp>’</dt>
- <dd><p>allow unofficial extensions
- </p></dd>
- <dt>‘<samp>experimental</samp>’</dt>
- <dd><p>allow non standardized experimental things, experimental
- (unfinished/work in progress/not well tested) decoders and encoders.
- Note: experimental decoders can pose a security risk, do not use this for
- decoding untrusted input.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>b_qoffset <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set QP offset between P and B frames.
- </p>
- </dd>
- <dt>‘<samp>err_detect <var>flags</var> (<em>decoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set error detection flags.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>crccheck</samp>’</dt>
- <dd><p>verify embedded CRCs
- </p></dd>
- <dt>‘<samp>bitstream</samp>’</dt>
- <dd><p>detect bitstream specification deviations
- </p></dd>
- <dt>‘<samp>buffer</samp>’</dt>
- <dd><p>detect improper bitstream length
- </p></dd>
- <dt>‘<samp>explode</samp>’</dt>
- <dd><p>abort decoding on minor error detection
- </p></dd>
- <dt>‘<samp>ignore_err</samp>’</dt>
- <dd><p>ignore decoding errors, and continue decoding.
- This is useful if you want to analyze the content of a video and thus want
- everything to be decoded no matter what. This option will not result in a video
- that is pleasing to watch in case of errors.
- </p></dd>
- <dt>‘<samp>careful</samp>’</dt>
- <dd><p>consider things that violate the spec and have not been seen in the wild as errors
- </p></dd>
- <dt>‘<samp>compliant</samp>’</dt>
- <dd><p>consider all spec non compliancies as errors
- </p></dd>
- <dt>‘<samp>aggressive</samp>’</dt>
- <dd><p>consider things that a sane encoder should not do as an error
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>has_b_frames <var>integer</var></samp>’</dt>
- <dt>‘<samp>block_align <var>integer</var></samp>’</dt>
- <dt>‘<samp>mpeg_quant <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Use MPEG quantizers instead of H.263.
- </p>
- </dd>
- <dt>‘<samp>qsquish <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>How to keep quantizer between qmin and qmax (0 = clip, 1 = use
- differentiable function).
- </p>
- </dd>
- <dt>‘<samp>rc_qmod_amp <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set experimental quantizer modulation.
- </p>
- </dd>
- <dt>‘<samp>rc_qmod_freq <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set experimental quantizer modulation.
- </p>
- </dd>
- <dt>‘<samp>rc_override_count <var>integer</var></samp>’</dt>
- <dt>‘<samp>rc_eq <var>string</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set rate control equation. When computing the expression, besides the
- standard functions defined in the section ’Expression Evaluation’, the
- following functions are available: bits2qp(bits), qp2bits(qp). Also
- the following constants are available: iTex pTex tex mv fCode iCount
- mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
- avgTex.
- </p>
- </dd>
- <dt>‘<samp>maxrate <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
- </p>
- </dd>
- <dt>‘<samp>minrate <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set min bitrate tolerance (in bits/s). Most useful in setting up a CBR
- encode. It is of little use elsewise.
- </p>
- </dd>
- <dt>‘<samp>bufsize <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set ratecontrol buffer size (in bits).
- </p>
- </dd>
- <dt>‘<samp>rc_buf_aggressivity <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Currently useless.
- </p>
- </dd>
- <dt>‘<samp>i_qfactor <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set QP factor between P and I frames.
- </p>
- </dd>
- <dt>‘<samp>i_qoffset <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set QP offset between P and I frames.
- </p>
- </dd>
- <dt>‘<samp>rc_init_cplx <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set initial complexity for 1-pass encoding.
- </p>
- </dd>
- <dt>‘<samp>dct <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set DCT algorithm.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>autoselect a good one (default)
- </p></dd>
- <dt>‘<samp>fastint</samp>’</dt>
- <dd><p>fast integer
- </p></dd>
- <dt>‘<samp>int</samp>’</dt>
- <dd><p>accurate integer
- </p></dd>
- <dt>‘<samp>mmx</samp>’</dt>
- <dt>‘<samp>altivec</samp>’</dt>
- <dt>‘<samp>faan</samp>’</dt>
- <dd><p>floating point AAN DCT
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>lumi_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Compress bright areas stronger than medium ones.
- </p>
- </dd>
- <dt>‘<samp>tcplx_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set temporal complexity masking.
- </p>
- </dd>
- <dt>‘<samp>scplx_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set spatial complexity masking.
- </p>
- </dd>
- <dt>‘<samp>p_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set inter masking.
- </p>
- </dd>
- <dt>‘<samp>dark_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Compress dark areas stronger than medium ones.
- </p>
- </dd>
- <dt>‘<samp>idct <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Select IDCT implementation.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dt>‘<samp>int</samp>’</dt>
- <dt>‘<samp>simple</samp>’</dt>
- <dt>‘<samp>simplemmx</samp>’</dt>
- <dt>‘<samp>simpleauto</samp>’</dt>
- <dd><p>Automatically pick a IDCT compatible with the simple one
- </p>
- </dd>
- <dt>‘<samp>arm</samp>’</dt>
- <dt>‘<samp>altivec</samp>’</dt>
- <dt>‘<samp>sh4</samp>’</dt>
- <dt>‘<samp>simplearm</samp>’</dt>
- <dt>‘<samp>simplearmv5te</samp>’</dt>
- <dt>‘<samp>simplearmv6</samp>’</dt>
- <dt>‘<samp>simpleneon</samp>’</dt>
- <dt>‘<samp>simplealpha</samp>’</dt>
- <dt>‘<samp>ipp</samp>’</dt>
- <dt>‘<samp>xvidmmx</samp>’</dt>
- <dt>‘<samp>faani</samp>’</dt>
- <dd><p>floating point AAN IDCT
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>slice_count <var>integer</var></samp>’</dt>
- <dt>‘<samp>ec <var>flags</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Set error concealment strategy.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>guess_mvs</samp>’</dt>
- <dd><p>iterative motion vector (MV) search (slow)
- </p></dd>
- <dt>‘<samp>deblock</samp>’</dt>
- <dd><p>use strong deblock filter for damaged MBs
- </p></dd>
- <dt>‘<samp>favor_inter</samp>’</dt>
- <dd><p>favor predicting from the previous frame instead of the current
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>bits_per_coded_sample <var>integer</var></samp>’</dt>
- <dt>‘<samp>pred <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set prediction method.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>left</samp>’</dt>
- <dt>‘<samp>plane</samp>’</dt>
- <dt>‘<samp>median</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>aspect <var>rational number</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set sample aspect ratio.
- </p>
- </dd>
- <dt>‘<samp>sar <var>rational number</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set sample aspect ratio. Alias to <var>aspect</var>.
- </p>
- </dd>
- <dt>‘<samp>debug <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp>’</dt>
- <dd><p>Print specific debug info.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>pict</samp>’</dt>
- <dd><p>picture info
- </p></dd>
- <dt>‘<samp>rc</samp>’</dt>
- <dd><p>rate control
- </p></dd>
- <dt>‘<samp>bitstream</samp>’</dt>
- <dt>‘<samp>mb_type</samp>’</dt>
- <dd><p>macroblock (MB) type
- </p></dd>
- <dt>‘<samp>qp</samp>’</dt>
- <dd><p>per-block quantization parameter (QP)
- </p></dd>
- <dt>‘<samp>dct_coeff</samp>’</dt>
- <dt>‘<samp>green_metadata</samp>’</dt>
- <dd><p>display complexity metadata for the upcoming frame, GoP or for a given duration.
- </p>
- </dd>
- <dt>‘<samp>skip</samp>’</dt>
- <dt>‘<samp>startcode</samp>’</dt>
- <dt>‘<samp>er</samp>’</dt>
- <dd><p>error recognition
- </p></dd>
- <dt>‘<samp>mmco</samp>’</dt>
- <dd><p>memory management control operations (H.264)
- </p></dd>
- <dt>‘<samp>bugs</samp>’</dt>
- <dt>‘<samp>buffers</samp>’</dt>
- <dd><p>picture buffer allocations
- </p></dd>
- <dt>‘<samp>thread_ops</samp>’</dt>
- <dd><p>threading operations
- </p></dd>
- <dt>‘<samp>nomc</samp>’</dt>
- <dd><p>skip motion compensation
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>cmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set full pel me compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>subcmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set sub pel me compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>mbcmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set macroblock compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>ildctcmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set interlaced dct compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>dia_size <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set diamond type & size for motion estimation.
- </p>
- </dd>
- <dt>‘<samp>last_pred <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set amount of motion predictors from the previous frame.
- </p>
- </dd>
- <dt>‘<samp>preme <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set pre motion estimation.
- </p>
- </dd>
- <dt>‘<samp>precmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set pre motion estimation compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>pre_dia_size <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set diamond type & size for motion estimation pre-pass.
- </p>
- </dd>
- <dt>‘<samp>subq <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set sub pel motion estimation quality.
- </p>
- </dd>
- <dt>‘<samp>dtg_active_format <var>integer</var></samp>’</dt>
- <dt>‘<samp>me_range <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set limit motion vectors range (1023 for DivX player).
- </p>
- </dd>
- <dt>‘<samp>ibias <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set intra quant bias.
- </p>
- </dd>
- <dt>‘<samp>pbias <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set inter quant bias.
- </p>
- </dd>
- <dt>‘<samp>color_table_id <var>integer</var></samp>’</dt>
- <dt>‘<samp>global_quality <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dt>‘<samp>coder <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>vlc</samp>’</dt>
- <dd><p>variable length coder / huffman coder
- </p></dd>
- <dt>‘<samp>ac</samp>’</dt>
- <dd><p>arithmetic coder
- </p></dd>
- <dt>‘<samp>raw</samp>’</dt>
- <dd><p>raw (no encoding)
- </p></dd>
- <dt>‘<samp>rle</samp>’</dt>
- <dd><p>run-length coder
- </p></dd>
- <dt>‘<samp>deflate</samp>’</dt>
- <dd><p>deflate-based coder
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>context <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set context model.
- </p>
- </dd>
- <dt>‘<samp>slice_flags <var>integer</var></samp>’</dt>
- <dt>‘<samp>mbd <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set macroblock decision algorithm (high quality mode).
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>simple</samp>’</dt>
- <dd><p>use mbcmp (default)
- </p></dd>
- <dt>‘<samp>bits</samp>’</dt>
- <dd><p>use fewest bits
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>use best rate distortion
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>stream_codec_tag <var>integer</var></samp>’</dt>
- <dt>‘<samp>sc_threshold <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set scene change threshold.
- </p>
- </dd>
- <dt>‘<samp>lmin <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set min lagrange factor (VBR).
- </p>
- </dd>
- <dt>‘<samp>lmax <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set max lagrange factor (VBR).
- </p>
- </dd>
- <dt>‘<samp>nr <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set noise reduction.
- </p>
- </dd>
- <dt>‘<samp>rc_init_occupancy <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set number of bits which should be loaded into the rc buffer before
- decoding starts.
- </p>
- </dd>
- <dt>‘<samp>flags2 <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>fast</samp>’</dt>
- <dd><p>Allow non spec compliant speedup tricks.
- </p></dd>
- <dt>‘<samp>noout</samp>’</dt>
- <dd><p>Skip bitstream encoding.
- </p></dd>
- <dt>‘<samp>ignorecrop</samp>’</dt>
- <dd><p>Ignore cropping information from sps.
- </p></dd>
- <dt>‘<samp>local_header</samp>’</dt>
- <dd><p>Place global headers at every keyframe instead of in extradata.
- </p></dd>
- <dt>‘<samp>chunks</samp>’</dt>
- <dd><p>Frame data might be split into multiple chunks.
- </p></dd>
- <dt>‘<samp>showall</samp>’</dt>
- <dd><p>Show all frames before the first keyframe.
- </p></dd>
- <dt>‘<samp>export_mvs</samp>’</dt>
- <dd><p>Export motion vectors into frame side-data (see <code>AV_FRAME_DATA_MOTION_VECTORS</code>)
- for codecs that support it. See also ‘<tt>doc/examples/export_mvs.c</tt>’.
- </p></dd>
- <dt>‘<samp>skip_manual</samp>’</dt>
- <dd><p>Do not skip samples and export skip information as frame side data.
- </p></dd>
- <dt>‘<samp>ass_ro_flush_noop</samp>’</dt>
- <dd><p>Do not reset ASS ReadOrder field on flush.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>export_side_data <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>mvs</samp>’</dt>
- <dd><p>Export motion vectors into frame side-data (see <code>AV_FRAME_DATA_MOTION_VECTORS</code>)
- for codecs that support it. See also ‘<tt>doc/examples/export_mvs.c</tt>’.
- </p></dd>
- <dt>‘<samp>prft</samp>’</dt>
- <dd><p>Export encoder Producer Reference Time into packet side-data (see <code>AV_PKT_DATA_PRFT</code>)
- for codecs that support it.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>error <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dt>‘<samp>qns <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Deprecated, use mpegvideo private options instead.
- </p>
- </dd>
- <dt>‘<samp>threads <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Set the number of threads to be used, in case the selected codec
- implementation supports multi-threading.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>auto, 0</samp>’</dt>
- <dd><p>automatically select the number of threads to set
- </p></dd>
- </dl>
-
- <p>Default value is ‘<samp>auto</samp>’.
- </p>
- </dd>
- <dt>‘<samp>me_threshold <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set motion estimation threshold.
- </p>
- </dd>
- <dt>‘<samp>mb_threshold <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set macroblock threshold.
- </p>
- </dd>
- <dt>‘<samp>dc <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set intra_dc_precision.
- </p>
- </dd>
- <dt>‘<samp>nssew <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set nsse weight.
- </p>
- </dd>
- <dt>‘<samp>skip_top <var>integer</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Set number of macroblock rows at the top which are skipped.
- </p>
- </dd>
- <dt>‘<samp>skip_bottom <var>integer</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Set number of macroblock rows at the bottom which are skipped.
- </p>
- </dd>
- <dt>‘<samp>profile <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>unknown</samp>’</dt>
- <dt>‘<samp>aac_main</samp>’</dt>
- <dt>‘<samp>aac_low</samp>’</dt>
- <dt>‘<samp>aac_ssr</samp>’</dt>
- <dt>‘<samp>aac_ltp</samp>’</dt>
- <dt>‘<samp>aac_he</samp>’</dt>
- <dt>‘<samp>aac_he_v2</samp>’</dt>
- <dt>‘<samp>aac_ld</samp>’</dt>
- <dt>‘<samp>aac_eld</samp>’</dt>
- <dt>‘<samp>mpeg2_aac_low</samp>’</dt>
- <dt>‘<samp>mpeg2_aac_he</samp>’</dt>
- <dt>‘<samp>mpeg4_sp</samp>’</dt>
- <dt>‘<samp>mpeg4_core</samp>’</dt>
- <dt>‘<samp>mpeg4_main</samp>’</dt>
- <dt>‘<samp>mpeg4_asp</samp>’</dt>
- <dt>‘<samp>dts</samp>’</dt>
- <dt>‘<samp>dts_es</samp>’</dt>
- <dt>‘<samp>dts_96_24</samp>’</dt>
- <dt>‘<samp>dts_hd_hra</samp>’</dt>
- <dt>‘<samp>dts_hd_ma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>level <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>unknown</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>lowres <var>integer</var> (<em>decoding,audio,video</em>)</samp>’</dt>
- <dd><p>Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
- </p>
- </dd>
- <dt>‘<samp>skip_threshold <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set frame skip threshold.
- </p>
- </dd>
- <dt>‘<samp>skip_factor <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set frame skip factor.
- </p>
- </dd>
- <dt>‘<samp>skip_exp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set frame skip exponent.
- Negative values behave identical to the corresponding positive ones, except
- that the score is normalized.
- Positive values exist primarily for compatibility reasons and are not so useful.
- </p>
- </dd>
- <dt>‘<samp>skipcmp <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set frame skip compare function.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>sum of absolute differences, fast (default)
- </p></dd>
- <dt>‘<samp>sse</samp>’</dt>
- <dd><p>sum of squared errors
- </p></dd>
- <dt>‘<samp>satd</samp>’</dt>
- <dd><p>sum of absolute Hadamard transformed differences
- </p></dd>
- <dt>‘<samp>dct</samp>’</dt>
- <dd><p>sum of absolute DCT transformed differences
- </p></dd>
- <dt>‘<samp>psnr</samp>’</dt>
- <dd><p>sum of squared quantization errors (avoid, low quality)
- </p></dd>
- <dt>‘<samp>bit</samp>’</dt>
- <dd><p>number of bits needed for the block
- </p></dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>rate distortion optimal, slow
- </p></dd>
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>0
- </p></dd>
- <dt>‘<samp>vsad</samp>’</dt>
- <dd><p>sum of absolute vertical differences
- </p></dd>
- <dt>‘<samp>vsse</samp>’</dt>
- <dd><p>sum of squared vertical differences
- </p></dd>
- <dt>‘<samp>nsse</samp>’</dt>
- <dd><p>noise preserving sum of squared differences
- </p></dd>
- <dt>‘<samp>w53</samp>’</dt>
- <dd><p>5/3 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>w97</samp>’</dt>
- <dd><p>9/7 wavelet, only used in snow
- </p></dd>
- <dt>‘<samp>dctmax</samp>’</dt>
- <dt>‘<samp>chroma</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>border_mask <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Increase the quantizer for macroblocks close to borders.
- </p>
- </dd>
- <dt>‘<samp>mblmin <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set min macroblock lagrange factor (VBR).
- </p>
- </dd>
- <dt>‘<samp>mblmax <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set max macroblock lagrange factor (VBR).
- </p>
- </dd>
- <dt>‘<samp>mepc <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set motion estimation bitrate penalty compensation (1.0 = 256).
- </p>
- </dd>
- <dt>‘<samp>skip_loop_filter <var>integer</var> (<em>decoding,video</em>)</samp>’</dt>
- <dt>‘<samp>skip_idct <var>integer</var> (<em>decoding,video</em>)</samp>’</dt>
- <dt>‘<samp>skip_frame <var>integer</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd>
- <p>Make decoder discard processing depending on the frame type selected
- by the option value.
- </p>
- <p>‘<samp>skip_loop_filter</samp>’ skips frame loop filtering, ‘<samp>skip_idct</samp>’
- skips frame IDCT/dequantization, ‘<samp>skip_frame</samp>’ skips decoding.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>none</samp>’</dt>
- <dd><p>Discard no frame.
- </p>
- </dd>
- <dt>‘<samp>default</samp>’</dt>
- <dd><p>Discard useless frames like 0-sized frames.
- </p>
- </dd>
- <dt>‘<samp>noref</samp>’</dt>
- <dd><p>Discard all non-reference frames.
- </p>
- </dd>
- <dt>‘<samp>bidir</samp>’</dt>
- <dd><p>Discard all bidirectional frames.
- </p>
- </dd>
- <dt>‘<samp>nokey</samp>’</dt>
- <dd><p>Discard all frames excepts keyframes.
- </p>
- </dd>
- <dt>‘<samp>nointra</samp>’</dt>
- <dd><p>Discard all frames except I frames.
- </p>
- </dd>
- <dt>‘<samp>all</samp>’</dt>
- <dd><p>Discard all frames.
- </p></dd>
- </dl>
-
- <p>Default value is ‘<samp>default</samp>’.
- </p>
- </dd>
- <dt>‘<samp>bidir_refine <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Refine the two motion vectors used in bidirectional macroblocks.
- </p>
- </dd>
- <dt>‘<samp>brd_scale <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Downscale frames for dynamic B-frame decision.
- </p>
- </dd>
- <dt>‘<samp>keyint_min <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set minimum interval between IDR-frames.
- </p>
- </dd>
- <dt>‘<samp>refs <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set reference frames to consider for motion compensation.
- </p>
- </dd>
- <dt>‘<samp>chromaoffset <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set chroma qp offset from luma.
- </p>
- </dd>
- <dt>‘<samp>trellis <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dd><p>Set rate-distortion optimal quantization.
- </p>
- </dd>
- <dt>‘<samp>mv0_threshold <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dt>‘<samp>b_sensitivity <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Adjust sensitivity of b_frame_strategy 1.
- </p>
- </dd>
- <dt>‘<samp>compression_level <var>integer</var> (<em>encoding,audio,video</em>)</samp>’</dt>
- <dt>‘<samp>min_prediction_order <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dt>‘<samp>max_prediction_order <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dt>‘<samp>timecode_frame_start <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Set GOP timecode frame start number, in non drop frame format.
- </p>
- </dd>
- <dt>‘<samp>request_channels <var>integer</var> (<em>decoding,audio</em>)</samp>’</dt>
- <dd><p>Set desired number of audio channels.
- </p>
- </dd>
- <dt>‘<samp>bits_per_raw_sample <var>integer</var></samp>’</dt>
- <dt>‘<samp>channel_layout <var>integer</var> (<em>decoding/encoding,audio</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p></dd>
- <dt>‘<samp>request_channel_layout <var>integer</var> (<em>decoding,audio</em>)</samp>’</dt>
- <dd>
- <p>Possible values:
- </p></dd>
- <dt>‘<samp>rc_max_vbv_use <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dt>‘<samp>rc_min_vbv_use <var>float</var> (<em>encoding,video</em>)</samp>’</dt>
- <dt>‘<samp>ticks_per_frame <var>integer</var> (<em>decoding/encoding,audio,video</em>)</samp>’</dt>
- <dt>‘<samp>color_primaries <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>bt709</samp>’</dt>
- <dd><p>BT.709
- </p></dd>
- <dt>‘<samp>bt470m</samp>’</dt>
- <dd><p>BT.470 M
- </p></dd>
- <dt>‘<samp>bt470bg</samp>’</dt>
- <dd><p>BT.470 BG
- </p></dd>
- <dt>‘<samp>smpte170m</samp>’</dt>
- <dd><p>SMPTE 170 M
- </p></dd>
- <dt>‘<samp>smpte240m</samp>’</dt>
- <dd><p>SMPTE 240 M
- </p></dd>
- <dt>‘<samp>film</samp>’</dt>
- <dd><p>Film
- </p></dd>
- <dt>‘<samp>bt2020</samp>’</dt>
- <dd><p>BT.2020
- </p></dd>
- <dt>‘<samp>smpte428</samp>’</dt>
- <dt>‘<samp>smpte428_1</samp>’</dt>
- <dd><p>SMPTE ST 428-1
- </p></dd>
- <dt>‘<samp>smpte431</samp>’</dt>
- <dd><p>SMPTE 431-2
- </p></dd>
- <dt>‘<samp>smpte432</samp>’</dt>
- <dd><p>SMPTE 432-1
- </p></dd>
- <dt>‘<samp>jedec-p22</samp>’</dt>
- <dd><p>JEDEC P22
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>color_trc <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>bt709</samp>’</dt>
- <dd><p>BT.709
- </p></dd>
- <dt>‘<samp>gamma22</samp>’</dt>
- <dd><p>BT.470 M
- </p></dd>
- <dt>‘<samp>gamma28</samp>’</dt>
- <dd><p>BT.470 BG
- </p></dd>
- <dt>‘<samp>smpte170m</samp>’</dt>
- <dd><p>SMPTE 170 M
- </p></dd>
- <dt>‘<samp>smpte240m</samp>’</dt>
- <dd><p>SMPTE 240 M
- </p></dd>
- <dt>‘<samp>linear</samp>’</dt>
- <dd><p>Linear
- </p></dd>
- <dt>‘<samp>log</samp>’</dt>
- <dt>‘<samp>log100</samp>’</dt>
- <dd><p>Log
- </p></dd>
- <dt>‘<samp>log_sqrt</samp>’</dt>
- <dt>‘<samp>log316</samp>’</dt>
- <dd><p>Log square root
- </p></dd>
- <dt>‘<samp>iec61966_2_4</samp>’</dt>
- <dt>‘<samp>iec61966-2-4</samp>’</dt>
- <dd><p>IEC 61966-2-4
- </p></dd>
- <dt>‘<samp>bt1361</samp>’</dt>
- <dt>‘<samp>bt1361e</samp>’</dt>
- <dd><p>BT.1361
- </p></dd>
- <dt>‘<samp>iec61966_2_1</samp>’</dt>
- <dt>‘<samp>iec61966-2-1</samp>’</dt>
- <dd><p>IEC 61966-2-1
- </p></dd>
- <dt>‘<samp>bt2020_10</samp>’</dt>
- <dt>‘<samp>bt2020_10bit</samp>’</dt>
- <dd><p>BT.2020 - 10 bit
- </p></dd>
- <dt>‘<samp>bt2020_12</samp>’</dt>
- <dt>‘<samp>bt2020_12bit</samp>’</dt>
- <dd><p>BT.2020 - 12 bit
- </p></dd>
- <dt>‘<samp>smpte2084</samp>’</dt>
- <dd><p>SMPTE ST 2084
- </p></dd>
- <dt>‘<samp>smpte428</samp>’</dt>
- <dt>‘<samp>smpte428_1</samp>’</dt>
- <dd><p>SMPTE ST 428-1
- </p></dd>
- <dt>‘<samp>arib-std-b67</samp>’</dt>
- <dd><p>ARIB STD-B67
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>colorspace <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>rgb</samp>’</dt>
- <dd><p>RGB
- </p></dd>
- <dt>‘<samp>bt709</samp>’</dt>
- <dd><p>BT.709
- </p></dd>
- <dt>‘<samp>fcc</samp>’</dt>
- <dd><p>FCC
- </p></dd>
- <dt>‘<samp>bt470bg</samp>’</dt>
- <dd><p>BT.470 BG
- </p></dd>
- <dt>‘<samp>smpte170m</samp>’</dt>
- <dd><p>SMPTE 170 M
- </p></dd>
- <dt>‘<samp>smpte240m</samp>’</dt>
- <dd><p>SMPTE 240 M
- </p></dd>
- <dt>‘<samp>ycocg</samp>’</dt>
- <dd><p>YCOCG
- </p></dd>
- <dt>‘<samp>bt2020nc</samp>’</dt>
- <dt>‘<samp>bt2020_ncl</samp>’</dt>
- <dd><p>BT.2020 NCL
- </p></dd>
- <dt>‘<samp>bt2020c</samp>’</dt>
- <dt>‘<samp>bt2020_cl</samp>’</dt>
- <dd><p>BT.2020 CL
- </p></dd>
- <dt>‘<samp>smpte2085</samp>’</dt>
- <dd><p>SMPTE 2085
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>color_range <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>If used as input parameter, it serves as a hint to the decoder, which
- color_range the input has.
- Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>tv</samp>’</dt>
- <dt>‘<samp>mpeg</samp>’</dt>
- <dd><p>MPEG (219*2^(n-8))
- </p></dd>
- <dt>‘<samp>pc</samp>’</dt>
- <dt>‘<samp>jpeg</samp>’</dt>
- <dd><p>JPEG (2^n-1)
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>chroma_sample_location <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>left</samp>’</dt>
- <dt>‘<samp>center</samp>’</dt>
- <dt>‘<samp>topleft</samp>’</dt>
- <dt>‘<samp>top</samp>’</dt>
- <dt>‘<samp>bottomleft</samp>’</dt>
- <dt>‘<samp>bottom</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>log_level_offset <var>integer</var></samp>’</dt>
- <dd><p>Set the log level offset.
- </p>
- </dd>
- <dt>‘<samp>slices <var>integer</var> (<em>encoding,video</em>)</samp>’</dt>
- <dd><p>Number of slices, used in parallelized encoding.
- </p>
- </dd>
- <dt>‘<samp>thread_type <var>flags</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Select which multithreading methods to use.
- </p>
- <p>Use of ‘<samp>frame</samp>’ will increase decoding delay by one frame per
- thread, so clients which cannot provide future frames should not use
- it.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>slice</samp>’</dt>
- <dd><p>Decode more than one part of a single frame at once.
- </p>
- <p>Multithreading using slices works only when the video was encoded with
- slices.
- </p>
- </dd>
- <dt>‘<samp>frame</samp>’</dt>
- <dd><p>Decode more than one frame at once.
- </p></dd>
- </dl>
-
- <p>Default value is ‘<samp>slice+frame</samp>’.
- </p>
- </dd>
- <dt>‘<samp>audio_service_type <var>integer</var> (<em>encoding,audio</em>)</samp>’</dt>
- <dd><p>Set audio service type.
- </p>
- <p>Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>ma</samp>’</dt>
- <dd><p>Main Audio Service
- </p></dd>
- <dt>‘<samp>ef</samp>’</dt>
- <dd><p>Effects
- </p></dd>
- <dt>‘<samp>vi</samp>’</dt>
- <dd><p>Visually Impaired
- </p></dd>
- <dt>‘<samp>hi</samp>’</dt>
- <dd><p>Hearing Impaired
- </p></dd>
- <dt>‘<samp>di</samp>’</dt>
- <dd><p>Dialogue
- </p></dd>
- <dt>‘<samp>co</samp>’</dt>
- <dd><p>Commentary
- </p></dd>
- <dt>‘<samp>em</samp>’</dt>
- <dd><p>Emergency
- </p></dd>
- <dt>‘<samp>vo</samp>’</dt>
- <dd><p>Voice Over
- </p></dd>
- <dt>‘<samp>ka</samp>’</dt>
- <dd><p>Karaoke
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>request_sample_fmt <var>sample_fmt</var> (<em>decoding,audio</em>)</samp>’</dt>
- <dd><p>Set sample format audio decoders should prefer. Default value is
- <code>none</code>.
- </p>
- </dd>
- <dt>‘<samp>pkt_timebase <var>rational number</var></samp>’</dt>
- <dt>‘<samp>sub_charenc <var>encoding</var> (<em>decoding,subtitles</em>)</samp>’</dt>
- <dd><p>Set the input subtitles character encoding.
- </p>
- </dd>
- <dt>‘<samp>field_order <var>field_order</var> (<em>video</em>)</samp>’</dt>
- <dd><p>Set/override the field order of the video.
- Possible values:
- </p><dl compact="compact">
- <dt>‘<samp>progressive</samp>’</dt>
- <dd><p>Progressive video
- </p></dd>
- <dt>‘<samp>tt</samp>’</dt>
- <dd><p>Interlaced video, top field coded and displayed first
- </p></dd>
- <dt>‘<samp>bb</samp>’</dt>
- <dd><p>Interlaced video, bottom field coded and displayed first
- </p></dd>
- <dt>‘<samp>tb</samp>’</dt>
- <dd><p>Interlaced video, top coded first, bottom displayed first
- </p></dd>
- <dt>‘<samp>bt</samp>’</dt>
- <dd><p>Interlaced video, bottom coded first, top displayed first
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>skip_alpha <var>bool</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Set to 1 to disable processing alpha (transparency). This works like the
- ‘<samp>gray</samp>’ flag in the ‘<samp>flags</samp>’ option which skips chroma information
- instead of alpha. Default is 0.
- </p>
- </dd>
- <dt>‘<samp>codec_whitelist <var>list</var> (<em>input</em>)</samp>’</dt>
- <dd><p>"," separated list of allowed decoders. By default all are allowed.
- </p>
- </dd>
- <dt>‘<samp>dump_separator <var>string</var> (<em>input</em>)</samp>’</dt>
- <dd><p>Separator used to separate the fields printed on the command line about the
- Stream parameters.
- For example, to separate the fields with newlines and indentation:
- </p><div class="example">
- <pre class="example">ffprobe -dump_separator "
- " -i ~/videos/matrixbench_mpeg2.mpg
- </pre></div>
-
- </dd>
- <dt>‘<samp>max_pixels <var>integer</var> (<em>decoding/encoding,video</em>)</samp>’</dt>
- <dd><p>Maximum number of pixels per image. This value can be used to avoid out of
- memory failures due to large images.
- </p>
- </dd>
- <dt>‘<samp>apply_cropping <var>bool</var> (<em>decoding,video</em>)</samp>’</dt>
- <dd><p>Enable cropping if cropping parameters are multiples of the required
- alignment for the left and top parameters. If the alignment is not met the
- cropping will be partially applied to maintain alignment.
- Default is 1 (enabled).
- Note: The required alignment depends on if <code>AV_CODEC_FLAG_UNALIGNED</code> is set and the
- CPU. <code>AV_CODEC_FLAG_UNALIGNED</code> cannot be changed from the command line. Also hardware
- decoders will not apply left/top Cropping.
- </p>
-
- </dd>
- </dl>
-
-
- <a name="Decoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Decoders">3 Decoders</a></h1>
-
- <p>Decoders are configured elements in FFmpeg which allow the decoding of
- multimedia streams.
- </p>
- <p>When you configure your FFmpeg build, all the supported native decoders
- are enabled by default. Decoders requiring an external library must be enabled
- manually via the corresponding <code>--enable-lib</code> option. You can list all
- available decoders using the configure option <code>--list-decoders</code>.
- </p>
- <p>You can disable all the decoders with the configure option
- <code>--disable-decoders</code> and selectively enable / disable single decoders
- with the options <code>--enable-decoder=<var>DECODER</var></code> /
- <code>--disable-decoder=<var>DECODER</var></code>.
- </p>
- <p>The option <code>-decoders</code> of the ff* tools will display the list of
- enabled decoders.
- </p>
-
- <a name="Video-Decoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Video-Decoders">4 Video Decoders</a></h1>
-
- <p>A description of some of the currently available video decoders
- follows.
- </p>
- <a name="rawvideo"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-rawvideo">4.1 rawvideo</a></h2>
-
- <p>Raw video decoder.
- </p>
- <p>This decoder decodes rawvideo streams.
- </p>
- <a name="Options-31"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-31">4.1.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>top <var>top_field_first</var></samp>’</dt>
- <dd><p>Specify the assumed field type of the input video.
- </p><dl compact="compact">
- <dt>‘<samp>-1</samp>’</dt>
- <dd><p>the video is assumed to be progressive (default)
- </p></dd>
- <dt>‘<samp>0</samp>’</dt>
- <dd><p>bottom-field-first is assumed
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dd><p>top-field-first is assumed
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="libdav1d"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libdav1d">4.2 libdav1d</a></h2>
-
- <p>dav1d AV1 decoder.
- </p>
- <p>libdav1d allows libavcodec to decode the AOMedia Video 1 (AV1) codec.
- Requires the presence of the libdav1d headers and library during configuration.
- You need to explicitly configure the build with <code>--enable-libdav1d</code>.
- </p>
- <a name="Options-29"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-29">4.2.1 Options</a></h3>
-
- <p>The following options are supported by the libdav1d wrapper.
- </p>
- <dl compact="compact">
- <dt>‘<samp>framethreads</samp>’</dt>
- <dd><p>Set amount of frame threads to use during decoding. The default value is 0 (autodetect).
- </p>
- </dd>
- <dt>‘<samp>tilethreads</samp>’</dt>
- <dd><p>Set amount of tile threads to use during decoding. The default value is 0 (autodetect).
- </p>
- </dd>
- <dt>‘<samp>filmgrain</samp>’</dt>
- <dd><p>Apply film grain to the decoded video if present in the bitstream. Defaults to the
- internal default of the library.
- </p>
- </dd>
- <dt>‘<samp>oppoint</samp>’</dt>
- <dd><p>Select an operating point of a scalable AV1 bitstream (0 - 31). Defaults to the
- internal default of the library.
- </p>
- </dd>
- <dt>‘<samp>alllayers</samp>’</dt>
- <dd><p>Output all spatial layers of a scalable AV1 bitstream. The default value is false.
- </p>
- </dd>
- </dl>
-
- <a name="libdavs2"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libdavs2">4.3 libdavs2</a></h2>
-
- <p>AVS2-P2/IEEE1857.4 video decoder wrapper.
- </p>
- <p>This decoder allows libavcodec to decode AVS2 streams with davs2 library.
- </p>
-
- <a name="Audio-Decoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Audio-Decoders">5 Audio Decoders</a></h1>
-
- <p>A description of some of the currently available audio decoders
- follows.
- </p>
- <a name="ac3"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-ac3">5.1 ac3</a></h2>
-
- <p>AC-3 audio decoder.
- </p>
- <p>This decoder implements part of ATSC A/52:2010 and ETSI TS 102 366, as well as
- the undocumented RealAudio 3 (a.k.a. dnet).
- </p>
- <a name="AC_002d3-Decoder-Options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-AC_002d3-Decoder-Options">5.1.1 AC-3 Decoder Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>-drc_scale <var>value</var></samp>’</dt>
- <dd><p>Dynamic Range Scale Factor. The factor to apply to dynamic range values
- from the AC-3 stream. This factor is applied exponentially.
- There are 3 notable scale factor ranges:
- </p><dl compact="compact">
- <dt>‘<samp>drc_scale == 0</samp>’</dt>
- <dd><p>DRC disabled. Produces full range audio.
- </p></dd>
- <dt>‘<samp>0 < drc_scale <= 1</samp>’</dt>
- <dd><p>DRC enabled. Applies a fraction of the stream DRC value.
- Audio reproduction is between full range and full compression.
- </p></dd>
- <dt>‘<samp>drc_scale > 1</samp>’</dt>
- <dd><p>DRC enabled. Applies drc_scale asymmetrically.
- Loud sounds are fully compressed. Soft sounds are enhanced.
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="flac-2"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-flac-2">5.2 flac</a></h2>
-
- <p>FLAC audio decoder.
- </p>
- <p>This decoder aims to implement the complete FLAC specification from Xiph.
- </p>
- <a name="FLAC-Decoder-options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-FLAC-Decoder-options">5.2.1 FLAC Decoder options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>-use_buggy_lpc</samp>’</dt>
- <dd><p>The lavc FLAC encoder used to produce buggy streams with high lpc values
- (like the default value). This option makes it possible to decode such streams
- correctly by using lavc’s old buggy lpc logic for decoding.
- </p>
- </dd>
- </dl>
-
- <a name="ffwavesynth"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-ffwavesynth">5.3 ffwavesynth</a></h2>
-
- <p>Internal wave synthesizer.
- </p>
- <p>This decoder generates wave patterns according to predefined sequences. Its
- use is purely internal and the format of the data it accepts is not publicly
- documented.
- </p>
- <a name="libcelt"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libcelt">5.4 libcelt</a></h2>
-
- <p>libcelt decoder wrapper.
- </p>
- <p>libcelt allows libavcodec to decode the Xiph CELT ultra-low delay audio codec.
- Requires the presence of the libcelt headers and library during configuration.
- You need to explicitly configure the build with <code>--enable-libcelt</code>.
- </p>
- <a name="libgsm"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libgsm">5.5 libgsm</a></h2>
-
- <p>libgsm decoder wrapper.
- </p>
- <p>libgsm allows libavcodec to decode the GSM full rate audio codec. Requires
- the presence of the libgsm headers and library during configuration. You need
- to explicitly configure the build with <code>--enable-libgsm</code>.
- </p>
- <p>This decoder supports both the ordinary GSM and the Microsoft variant.
- </p>
- <a name="libilbc"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libilbc">5.6 libilbc</a></h2>
-
- <p>libilbc decoder wrapper.
- </p>
- <p>libilbc allows libavcodec to decode the Internet Low Bitrate Codec (iLBC)
- audio codec. Requires the presence of the libilbc headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libilbc</code>.
- </p>
- <a name="Options-4"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-4">5.6.1 Options</a></h3>
-
- <p>The following option is supported by the libilbc wrapper.
- </p>
- <dl compact="compact">
- <dt>‘<samp>enhance</samp>’</dt>
- <dd>
- <p>Enable the enhancement of the decoded audio when set to 1. The default
- value is 0 (disabled).
- </p>
- </dd>
- </dl>
-
- <a name="libopencore_002damrnb"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopencore_002damrnb">5.7 libopencore-amrnb</a></h2>
-
- <p>libopencore-amrnb decoder wrapper.
- </p>
- <p>libopencore-amrnb allows libavcodec to decode the Adaptive Multi-Rate
- Narrowband audio codec. Using it requires the presence of the
- libopencore-amrnb headers and library during configuration. You need to
- explicitly configure the build with <code>--enable-libopencore-amrnb</code>.
- </p>
- <p>An FFmpeg native decoder for AMR-NB exists, so users can decode AMR-NB
- without this library.
- </p>
- <a name="libopencore_002damrwb"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopencore_002damrwb">5.8 libopencore-amrwb</a></h2>
-
- <p>libopencore-amrwb decoder wrapper.
- </p>
- <p>libopencore-amrwb allows libavcodec to decode the Adaptive Multi-Rate
- Wideband audio codec. Using it requires the presence of the
- libopencore-amrwb headers and library during configuration. You need to
- explicitly configure the build with <code>--enable-libopencore-amrwb</code>.
- </p>
- <p>An FFmpeg native decoder for AMR-WB exists, so users can decode AMR-WB
- without this library.
- </p>
- <a name="libopus"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopus">5.9 libopus</a></h2>
-
- <p>libopus decoder wrapper.
- </p>
- <p>libopus allows libavcodec to decode the Opus Interactive Audio Codec.
- Requires the presence of the libopus headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libopus</code>.
- </p>
- <p>An FFmpeg native decoder for Opus exists, so users can decode Opus
- without this library.
- </p>
-
- <a name="Subtitles-Decoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Subtitles-Decoders">6 Subtitles Decoders</a></h1>
-
- <a name="libaribb24"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libaribb24">6.1 libaribb24</a></h2>
-
- <p>ARIB STD-B24 caption decoder.
- </p>
- <p>Implements profiles A and C of the ARIB STD-B24 standard.
- </p>
- <a name="libaribb24-Decoder-Options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-libaribb24-Decoder-Options">6.1.1 libaribb24 Decoder Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>-aribb24-base-path <var>path</var></samp>’</dt>
- <dd><p>Sets the base path for the libaribb24 library. This is utilized for reading of
- configuration files (for custom unicode conversions), and for dumping of
- non-text symbols as images under that location.
- </p>
- <p>Unset by default.
- </p>
- </dd>
- <dt>‘<samp>-aribb24-skip-ruby-text <var>boolean</var></samp>’</dt>
- <dd><p>Tells the decoder wrapper to skip text blocks that contain half-height ruby
- text.
- </p>
- <p>Enabled by default.
- </p>
- </dd>
- </dl>
-
- <a name="dvbsub"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-dvbsub">6.2 dvbsub</a></h2>
-
- <a name="Options-16"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-16">6.2.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>compute_clut</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>-1</samp>’</dt>
- <dd><p>Compute clut if no matching CLUT is in the stream.
- </p></dd>
- <dt>‘<samp>0</samp>’</dt>
- <dd><p>Never compute CLUT
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dd><p>Always compute CLUT and override the one provided in the stream.
- </p></dd>
- </dl>
- </dd>
- <dt>‘<samp>dvb_substream</samp>’</dt>
- <dd><p>Selects the dvb substream, or all substreams if -1 which is default.
- </p>
- </dd>
- </dl>
-
- <a name="dvdsub"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-dvdsub">6.3 dvdsub</a></h2>
-
- <p>This codec decodes the bitmap subtitles used in DVDs; the same subtitles can
- also be found in VobSub file pairs and in some Matroska files.
- </p>
- <a name="Options-30"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-30">6.3.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>palette</samp>’</dt>
- <dd><p>Specify the global palette used by the bitmaps. When stored in VobSub, the
- palette is normally specified in the index file; in Matroska, the palette is
- stored in the codec extra-data in the same format as in VobSub. In DVDs, the
- palette is stored in the IFO file, and therefore not available when reading
- from dumped VOB files.
- </p>
- <p>The format for this option is a string containing 16 24-bits hexadecimal
- numbers (without 0x prefix) separated by commas, for example <code>0d00ee,
- ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1,
- 7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b</code>.
- </p>
- </dd>
- <dt>‘<samp>ifo_palette</samp>’</dt>
- <dd><p>Specify the IFO file from which the global palette is obtained.
- (experimental)
- </p>
- </dd>
- <dt>‘<samp>forced_subs_only</samp>’</dt>
- <dd><p>Only decode subtitle entries marked as forced. Some titles have forced
- and non-forced subtitles in the same track. Setting this flag to <code>1</code>
- will only keep the forced subtitles. Default value is <code>0</code>.
- </p></dd>
- </dl>
-
- <a name="libzvbi_002dteletext"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libzvbi_002dteletext">6.4 libzvbi-teletext</a></h2>
-
- <p>Libzvbi allows libavcodec to decode DVB teletext pages and DVB teletext
- subtitles. Requires the presence of the libzvbi headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libzvbi</code>.
- </p>
- <a name="Options-35"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-35">6.4.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>txt_page</samp>’</dt>
- <dd><p>List of teletext page numbers to decode. Pages that do not match the specified
- list are dropped. You may use the special <code>*</code> string to match all pages,
- or <code>subtitle</code> to match all subtitle pages.
- Default value is *.
- </p></dd>
- <dt>‘<samp>txt_default_region</samp>’</dt>
- <dd><p>Set default G0 character set used for decoding, a value between 0 and 80 (see
- ETS 300 706, Section 15, Table 32). Default value is -1, which does not
- override the libzvbi default. This option is needed for some legacy level 1.0
- transmissions which cannot signal the proper charset.
- </p></dd>
- <dt>‘<samp>txt_chop_top</samp>’</dt>
- <dd><p>Discards the top teletext line. Default value is 1.
- </p></dd>
- <dt>‘<samp>txt_format</samp>’</dt>
- <dd><p>Specifies the format of the decoded subtitles.
- </p><dl compact="compact">
- <dt>‘<samp>bitmap</samp>’</dt>
- <dd><p>The default format, you should use this for teletext pages, because certain
- graphics and colors cannot be expressed in simple text or even ASS.
- </p></dd>
- <dt>‘<samp>text</samp>’</dt>
- <dd><p>Simple text based output without formatting.
- </p></dd>
- <dt>‘<samp>ass</samp>’</dt>
- <dd><p>Formatted ASS output, subtitle pages and teletext pages are returned in
- different styles, subtitle pages are stripped down to text, but an effort is
- made to keep the text alignment and the formatting.
- </p></dd>
- </dl>
- </dd>
- <dt>‘<samp>txt_left</samp>’</dt>
- <dd><p>X offset of generated bitmaps, default is 0.
- </p></dd>
- <dt>‘<samp>txt_top</samp>’</dt>
- <dd><p>Y offset of generated bitmaps, default is 0.
- </p></dd>
- <dt>‘<samp>txt_chop_spaces</samp>’</dt>
- <dd><p>Chops leading and trailing spaces and removes empty lines from the generated
- text. This option is useful for teletext based subtitles where empty spaces may
- be present at the start or at the end of the lines or empty lines may be
- present between the subtitle lines because of double-sized teletext characters.
- Default value is 1.
- </p></dd>
- <dt>‘<samp>txt_duration</samp>’</dt>
- <dd><p>Sets the display duration of the decoded teletext pages or subtitles in
- milliseconds. Default value is -1 which means infinity or until the next
- subtitle event comes.
- </p></dd>
- <dt>‘<samp>txt_transparent</samp>’</dt>
- <dd><p>Force transparent background of the generated teletext bitmaps. Default value
- is 0 which means an opaque background.
- </p></dd>
- <dt>‘<samp>txt_opacity</samp>’</dt>
- <dd><p>Sets the opacity (0-255) of the teletext background. If
- ‘<samp>txt_transparent</samp>’ is not set, it only affects characters between a start
- box and an end box, typically subtitles. Default value is 0 if
- ‘<samp>txt_transparent</samp>’ is set, 255 otherwise.
- </p>
- </dd>
- </dl>
-
- <a name="Encoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Encoders">7 Encoders</a></h1>
-
- <p>Encoders are configured elements in FFmpeg which allow the encoding of
- multimedia streams.
- </p>
- <p>When you configure your FFmpeg build, all the supported native encoders
- are enabled by default. Encoders requiring an external library must be enabled
- manually via the corresponding <code>--enable-lib</code> option. You can list all
- available encoders using the configure option <code>--list-encoders</code>.
- </p>
- <p>You can disable all the encoders with the configure option
- <code>--disable-encoders</code> and selectively enable / disable single encoders
- with the options <code>--enable-encoder=<var>ENCODER</var></code> /
- <code>--disable-encoder=<var>ENCODER</var></code>.
- </p>
- <p>The option <code>-encoders</code> of the ff* tools will display the list of
- enabled encoders.
- </p>
-
- <a name="Audio-Encoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Audio-Encoders">8 Audio Encoders</a></h1>
-
- <p>A description of some of the currently available audio encoders
- follows.
- </p>
- <p><a name="aacenc"></a>
- </p><a name="aac"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-aac">8.1 aac</a></h2>
-
- <p>Advanced Audio Coding (AAC) encoder.
- </p>
- <p>This encoder is the default AAC encoder, natively implemented into FFmpeg. Its
- quality is on par or better than libfdk_aac at the default bitrate of 128kbps.
- This encoder also implements more options, profiles and samplerates than
- other encoders (with only the AAC-HE profile pending to be implemented) so this
- encoder has become the default and is the recommended choice.
- </p>
- <a name="Options-34"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-34">8.1.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bit rate in bits/s. Setting this automatically activates constant bit rate
- (CBR) mode. If this option is unspecified it is set to 128kbps.
- </p>
- </dd>
- <dt>‘<samp>q</samp>’</dt>
- <dd><p>Set quality for variable bit rate (VBR) mode. This option is valid only using
- the <code>ffmpeg</code> command-line tool. For library interface users, use
- ‘<samp>global_quality</samp>’.
- </p>
- </dd>
- <dt>‘<samp>cutoff</samp>’</dt>
- <dd><p>Set cutoff frequency. If unspecified will allow the encoder to dynamically
- adjust the cutoff to improve clarity on low bitrates.
- </p>
- </dd>
- <dt>‘<samp>aac_coder</samp>’</dt>
- <dd><p>Set AAC encoder coding method. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>twoloop</samp>’</dt>
- <dd><p>Two loop searching (TLS) method.
- </p>
- <p>This method first sets quantizers depending on band thresholds and then tries
- to find an optimal combination by adding or subtracting a specific value from
- all quantizers and adjusting some individual quantizer a little. Will tune
- itself based on whether ‘<samp>aac_is</samp>’, ‘<samp>aac_ms</samp>’ and ‘<samp>aac_pns</samp>’
- are enabled.
- </p>
- </dd>
- <dt>‘<samp>anmr</samp>’</dt>
- <dd><p>Average noise to mask ratio (ANMR) trellis-based solution.
- </p>
- <p>This is an experimental coder which currently produces a lower quality, is more
- unstable and is slower than the default twoloop coder but has potential.
- Currently has no support for the ‘<samp>aac_is</samp>’ or ‘<samp>aac_pns</samp>’ options.
- Not currently recommended.
- </p>
- </dd>
- <dt>‘<samp>fast</samp>’</dt>
- <dd><p>Constant quantizer method.
- </p>
- <p>Uses a cheaper version of twoloop algorithm that doesn’t try to do as many
- clever adjustments. Worse with low bitrates (less than 64kbps), but is better
- and much faster at higher bitrates.
- This is the default choice for a coder
- </p>
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>aac_ms</samp>’</dt>
- <dd><p>Sets mid/side coding mode. The default value of "auto" will automatically use
- M/S with bands which will benefit from such coding. Can be forced for all bands
- using the value "enable", which is mainly useful for debugging or disabled using
- "disable".
- </p>
- </dd>
- <dt>‘<samp>aac_is</samp>’</dt>
- <dd><p>Sets intensity stereo coding tool usage. By default, it’s enabled and will
- automatically toggle IS for similar pairs of stereo bands if it’s beneficial.
- Can be disabled for debugging by setting the value to "disable".
- </p>
- </dd>
- <dt>‘<samp>aac_pns</samp>’</dt>
- <dd><p>Uses perceptual noise substitution to replace low entropy high frequency bands
- with imperceptible white noise during the decoding process. By default, it’s
- enabled, but can be disabled for debugging purposes by using "disable".
- </p>
- </dd>
- <dt>‘<samp>aac_tns</samp>’</dt>
- <dd><p>Enables the use of a multitap FIR filter which spans through the high frequency
- bands to hide quantization noise during the encoding process and is reverted
- by the decoder. As well as decreasing unpleasant artifacts in the high range
- this also reduces the entropy in the high bands and allows for more bits to
- be used by the mid-low bands. By default it’s enabled but can be disabled for
- debugging by setting the option to "disable".
- </p>
- </dd>
- <dt>‘<samp>aac_ltp</samp>’</dt>
- <dd><p>Enables the use of the long term prediction extension which increases coding
- efficiency in very low bandwidth situations such as encoding of voice or
- solo piano music by extending constant harmonic peaks in bands throughout
- frames. This option is implied by profile:a aac_low and is incompatible with
- aac_pred. Use in conjunction with ‘<samp>-ar</samp>’ to decrease the samplerate.
- </p>
- </dd>
- <dt>‘<samp>aac_pred</samp>’</dt>
- <dd><p>Enables the use of a more traditional style of prediction where the spectral
- coefficients transmitted are replaced by the difference of the current
- coefficients minus the previous "predicted" coefficients. In theory and sometimes
- in practice this can improve quality for low to mid bitrate audio.
- This option implies the aac_main profile and is incompatible with aac_ltp.
- </p>
- </dd>
- <dt>‘<samp>profile</samp>’</dt>
- <dd><p>Sets the encoding profile, possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>aac_low</samp>’</dt>
- <dd><p>The default, AAC "Low-complexity" profile. Is the most compatible and produces
- decent quality.
- </p>
- </dd>
- <dt>‘<samp>mpeg2_aac_low</samp>’</dt>
- <dd><p>Equivalent to <code>-profile:a aac_low -aac_pns 0</code>. PNS was introduced with the
- MPEG4 specifications.
- </p>
- </dd>
- <dt>‘<samp>aac_ltp</samp>’</dt>
- <dd><p>Long term prediction profile, is enabled by and will enable the ‘<samp>aac_ltp</samp>’
- option. Introduced in MPEG4.
- </p>
- </dd>
- <dt>‘<samp>aac_main</samp>’</dt>
- <dd><p>Main-type prediction profile, is enabled by and will enable the ‘<samp>aac_pred</samp>’
- option. Introduced in MPEG2.
- </p>
- </dd>
- </dl>
- <p>If this option is unspecified it is set to ‘<samp>aac_low</samp>’.
- </p></dd>
- </dl>
-
- <a name="ac3-and-ac3_005ffixed"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-ac3-and-ac3_005ffixed">8.2 ac3 and ac3_fixed</a></h2>
-
- <p>AC-3 audio encoders.
- </p>
- <p>These encoders implement part of ATSC A/52:2010 and ETSI TS 102 366, as well as
- the undocumented RealAudio 3 (a.k.a. dnet).
- </p>
- <p>The <var>ac3</var> encoder uses floating-point math, while the <var>ac3_fixed</var>
- encoder only uses fixed-point integer math. This does not mean that one is
- always faster, just that one or the other may be better suited to a
- particular system. The floating-point encoder will generally produce better
- quality audio for a given bitrate. The <var>ac3_fixed</var> encoder is not the
- default codec for any of the output formats, so it must be specified explicitly
- using the option <code>-acodec ac3_fixed</code> in order to use it.
- </p>
- <a name="AC_002d3-Metadata"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-AC_002d3-Metadata">8.2.1 AC-3 Metadata</a></h3>
-
- <p>The AC-3 metadata options are used to set parameters that describe the audio,
- but in most cases do not affect the audio encoding itself. Some of the options
- do directly affect or influence the decoding and playback of the resulting
- bitstream, while others are just for informational purposes. A few of the
- options will add bits to the output stream that could otherwise be used for
- audio data, and will thus affect the quality of the output. Those will be
- indicated accordingly with a note in the option list below.
- </p>
- <p>These parameters are described in detail in several publicly-available
- documents.
- </p><ul>
- <li> <a href="http://www.atsc.org/cms/standards/a_52-2010.pdf">A/52:2010 - Digital Audio Compression (AC-3) (E-AC-3) Standard</a>
- </li><li> <a href="http://www.atsc.org/cms/standards/a_54a_with_corr_1.pdf">A/54 - Guide to the Use of the ATSC Digital Television Standard</a>
- </li><li> <a href="http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/18_Metadata.Guide.pdf">Dolby Metadata Guide</a>
- </li><li> <a href="http://www.dolby.com/uploadedFiles/zz-_Shared_Assets/English_PDFs/Professional/46_DDEncodingGuidelines.pdf">Dolby Digital Professional Encoding Guidelines</a>
- </li></ul>
-
- <a name="Metadata-Control-Options"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Metadata-Control-Options">8.2.1.1 Metadata Control Options</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>-per_frame_metadata <var>boolean</var></samp>’</dt>
- <dd><p>Allow Per-Frame Metadata. Specifies if the encoder should check for changing
- metadata for each frame.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dd><p>The metadata values set at initialization will be used for every frame in the
- stream. (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dd><p>Metadata values can be changed before encoding each frame.
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Downmix-Levels"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Downmix-Levels">8.2.1.2 Downmix Levels</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>-center_mixlev <var>level</var></samp>’</dt>
- <dd><p>Center Mix Level. The amount of gain the decoder should apply to the center
- channel when downmixing to stereo. This field will only be written to the
- bitstream if a center channel is present. The value is specified as a scale
- factor. There are 3 valid values:
- </p><dl compact="compact">
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3dB gain
- </p></dd>
- <dt>‘<samp>0.595</samp>’</dt>
- <dd><p>Apply -4.5dB gain (default)
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6dB gain
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-surround_mixlev <var>level</var></samp>’</dt>
- <dd><p>Surround Mix Level. The amount of gain the decoder should apply to the surround
- channel(s) when downmixing to stereo. This field will only be written to the
- bitstream if one or more surround channels are present. The value is specified
- as a scale factor. There are 3 valid values:
- </p><dl compact="compact">
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3dB gain
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6dB gain (default)
- </p></dd>
- <dt>‘<samp>0.000</samp>’</dt>
- <dd><p>Silence Surround Channel(s)
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Audio-Production-Information"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Audio-Production-Information">8.2.1.3 Audio Production Information</a></h4>
- <p>Audio Production Information is optional information describing the mixing
- environment. Either none or both of the fields are written to the bitstream.
- </p>
- <dl compact="compact">
- <dt>‘<samp>-mixing_level <var>number</var></samp>’</dt>
- <dd><p>Mixing Level. Specifies peak sound pressure level (SPL) in the production
- environment when the mix was mastered. Valid values are 80 to 111, or -1 for
- unknown or not indicated. The default value is -1, but that value cannot be
- used if the Audio Production Information is written to the bitstream. Therefore,
- if the <code>room_type</code> option is not the default value, the <code>mixing_level</code>
- option must not be -1.
- </p>
- </dd>
- <dt>‘<samp>-room_type <var>type</var></samp>’</dt>
- <dd><p>Room Type. Describes the equalization used during the final mixing session at
- the studio or on the dubbing stage. A large room is a dubbing stage with the
- industry standard X-curve equalization; a small room has flat equalization.
- This field will not be written to the bitstream if both the <code>mixing_level</code>
- option and the <code>room_type</code> option have the default values.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>notindicated</samp>’</dt>
- <dd><p>Not Indicated (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>large</samp>’</dt>
- <dd><p>Large Room
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dt>‘<samp>small</samp>’</dt>
- <dd><p>Small Room
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Other-Metadata-Options"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Other-Metadata-Options">8.2.1.4 Other Metadata Options</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>-copyright <var>boolean</var></samp>’</dt>
- <dd><p>Copyright Indicator. Specifies whether a copyright exists for this audio.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>No Copyright Exists (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Copyright Exists
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-dialnorm <var>value</var></samp>’</dt>
- <dd><p>Dialogue Normalization. Indicates how far the average dialogue level of the
- program is below digital 100% full scale (0 dBFS). This parameter determines a
- level shift during audio reproduction that sets the average volume of the
- dialogue to a preset level. The goal is to match volume level between program
- sources. A value of -31dB will result in no volume level change, relative to
- the source volume, during audio reproduction. Valid values are whole numbers in
- the range -31 to -1, with -31 being the default.
- </p>
- </dd>
- <dt>‘<samp>-dsur_mode <var>mode</var></samp>’</dt>
- <dd><p>Dolby Surround Mode. Specifies whether the stereo signal uses Dolby Surround
- (Pro Logic). This field will only be written to the bitstream if the audio
- stream is stereo. Using this option does <b>NOT</b> mean the encoder will actually
- apply Dolby Surround processing.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>notindicated</samp>’</dt>
- <dd><p>Not Indicated (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Not Dolby Surround Encoded
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Dolby Surround Encoded
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-original <var>boolean</var></samp>’</dt>
- <dd><p>Original Bit Stream Indicator. Specifies whether this audio is from the
- original source and not a copy.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Not Original Source
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Original Source (default)
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Extended-Bitstream-Information"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Extended-Bitstream-Information">8.2.2 Extended Bitstream Information</a></h3>
- <p>The extended bitstream options are part of the Alternate Bit Stream Syntax as
- specified in Annex D of the A/52:2010 standard. It is grouped into 2 parts.
- If any one parameter in a group is specified, all values in that group will be
- written to the bitstream. Default values are used for those that are written
- but have not been specified. If the mixing levels are written, the decoder
- will use these values instead of the ones specified in the <code>center_mixlev</code>
- and <code>surround_mixlev</code> options if it supports the Alternate Bit Stream
- Syntax.
- </p>
- <a name="Extended-Bitstream-Information-_002d-Part-1"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Extended-Bitstream-Information-_002d-Part-1">8.2.2.1 Extended Bitstream Information - Part 1</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>-dmix_mode <var>mode</var></samp>’</dt>
- <dd><p>Preferred Stereo Downmix Mode. Allows the user to select either Lt/Rt
- (Dolby Surround) or Lo/Ro (normal stereo) as the preferred stereo downmix mode.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>notindicated</samp>’</dt>
- <dd><p>Not Indicated (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>ltrt</samp>’</dt>
- <dd><p>Lt/Rt Downmix Preferred
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dt>‘<samp>loro</samp>’</dt>
- <dd><p>Lo/Ro Downmix Preferred
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-ltrt_cmixlev <var>level</var></samp>’</dt>
- <dd><p>Lt/Rt Center Mix Level. The amount of gain the decoder should apply to the
- center channel when downmixing to stereo in Lt/Rt mode.
- </p><dl compact="compact">
- <dt>‘<samp>1.414</samp>’</dt>
- <dd><p>Apply +3dB gain
- </p></dd>
- <dt>‘<samp>1.189</samp>’</dt>
- <dd><p>Apply +1.5dB gain
- </p></dd>
- <dt>‘<samp>1.000</samp>’</dt>
- <dd><p>Apply 0dB gain
- </p></dd>
- <dt>‘<samp>0.841</samp>’</dt>
- <dd><p>Apply -1.5dB gain
- </p></dd>
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3.0dB gain
- </p></dd>
- <dt>‘<samp>0.595</samp>’</dt>
- <dd><p>Apply -4.5dB gain (default)
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6.0dB gain
- </p></dd>
- <dt>‘<samp>0.000</samp>’</dt>
- <dd><p>Silence Center Channel
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-ltrt_surmixlev <var>level</var></samp>’</dt>
- <dd><p>Lt/Rt Surround Mix Level. The amount of gain the decoder should apply to the
- surround channel(s) when downmixing to stereo in Lt/Rt mode.
- </p><dl compact="compact">
- <dt>‘<samp>0.841</samp>’</dt>
- <dd><p>Apply -1.5dB gain
- </p></dd>
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3.0dB gain
- </p></dd>
- <dt>‘<samp>0.595</samp>’</dt>
- <dd><p>Apply -4.5dB gain
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6.0dB gain (default)
- </p></dd>
- <dt>‘<samp>0.000</samp>’</dt>
- <dd><p>Silence Surround Channel(s)
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-loro_cmixlev <var>level</var></samp>’</dt>
- <dd><p>Lo/Ro Center Mix Level. The amount of gain the decoder should apply to the
- center channel when downmixing to stereo in Lo/Ro mode.
- </p><dl compact="compact">
- <dt>‘<samp>1.414</samp>’</dt>
- <dd><p>Apply +3dB gain
- </p></dd>
- <dt>‘<samp>1.189</samp>’</dt>
- <dd><p>Apply +1.5dB gain
- </p></dd>
- <dt>‘<samp>1.000</samp>’</dt>
- <dd><p>Apply 0dB gain
- </p></dd>
- <dt>‘<samp>0.841</samp>’</dt>
- <dd><p>Apply -1.5dB gain
- </p></dd>
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3.0dB gain
- </p></dd>
- <dt>‘<samp>0.595</samp>’</dt>
- <dd><p>Apply -4.5dB gain (default)
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6.0dB gain
- </p></dd>
- <dt>‘<samp>0.000</samp>’</dt>
- <dd><p>Silence Center Channel
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-loro_surmixlev <var>level</var></samp>’</dt>
- <dd><p>Lo/Ro Surround Mix Level. The amount of gain the decoder should apply to the
- surround channel(s) when downmixing to stereo in Lo/Ro mode.
- </p><dl compact="compact">
- <dt>‘<samp>0.841</samp>’</dt>
- <dd><p>Apply -1.5dB gain
- </p></dd>
- <dt>‘<samp>0.707</samp>’</dt>
- <dd><p>Apply -3.0dB gain
- </p></dd>
- <dt>‘<samp>0.595</samp>’</dt>
- <dd><p>Apply -4.5dB gain
- </p></dd>
- <dt>‘<samp>0.500</samp>’</dt>
- <dd><p>Apply -6.0dB gain (default)
- </p></dd>
- <dt>‘<samp>0.000</samp>’</dt>
- <dd><p>Silence Surround Channel(s)
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Extended-Bitstream-Information-_002d-Part-2"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Extended-Bitstream-Information-_002d-Part-2">8.2.2.2 Extended Bitstream Information - Part 2</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>-dsurex_mode <var>mode</var></samp>’</dt>
- <dd><p>Dolby Surround EX Mode. Indicates whether the stream uses Dolby Surround EX
- (7.1 matrixed to 5.1). Using this option does <b>NOT</b> mean the encoder will actually
- apply Dolby Surround EX processing.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>notindicated</samp>’</dt>
- <dd><p>Not Indicated (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Dolby Surround EX Off
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Dolby Surround EX On
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-dheadphone_mode <var>mode</var></samp>’</dt>
- <dd><p>Dolby Headphone Mode. Indicates whether the stream uses Dolby Headphone
- encoding (multi-channel matrixed to 2.0 for use with headphones). Using this
- option does <b>NOT</b> mean the encoder will actually apply Dolby Headphone
- processing.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>notindicated</samp>’</dt>
- <dd><p>Not Indicated (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Dolby Headphone Off
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Dolby Headphone On
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-ad_conv_type <var>type</var></samp>’</dt>
- <dd><p>A/D Converter Type. Indicates whether the audio has passed through HDCD A/D
- conversion.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>standard</samp>’</dt>
- <dd><p>Standard A/D Converter (default)
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>hdcd</samp>’</dt>
- <dd><p>HDCD A/D Converter
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="Other-AC_002d3-Encoding-Options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Other-AC_002d3-Encoding-Options">8.2.3 Other AC-3 Encoding Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>-stereo_rematrixing <var>boolean</var></samp>’</dt>
- <dd><p>Stereo Rematrixing. Enables/Disables use of rematrixing for stereo input. This
- is an optional AC-3 feature that increases quality by selectively encoding
- the left/right channels as mid/side. This option is enabled by default, and it
- is highly recommended that it be left as enabled except for testing purposes.
- </p>
- </dd>
- <dt>‘<samp>cutoff <var>frequency</var></samp>’</dt>
- <dd><p>Set lowpass cutoff frequency. If unspecified, the encoder selects a default
- determined by various other encoding parameters.
- </p>
- </dd>
- </dl>
-
- <a name="Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Floating_002dPoint_002dOnly-AC_002d3-Encoding-Options">8.2.4 Floating-Point-Only AC-3 Encoding Options</a></h3>
-
- <p>These options are only valid for the floating-point encoder and do not exist
- for the fixed-point encoder due to the corresponding features not being
- implemented in fixed-point.
- </p>
- <dl compact="compact">
- <dt>‘<samp>-channel_coupling <var>boolean</var></samp>’</dt>
- <dd><p>Enables/Disables use of channel coupling, which is an optional AC-3 feature
- that increases quality by combining high frequency information from multiple
- channels into a single channel. The per-channel high frequency information is
- sent with less accuracy in both the frequency and time domains. This allows
- more bits to be used for lower frequencies while preserving enough information
- to reconstruct the high frequencies. This option is enabled by default for the
- floating-point encoder and should generally be left as enabled except for
- testing purposes or to increase encoding speed.
- </p><dl compact="compact">
- <dt>‘<samp>-1</samp>’</dt>
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Selected by Encoder (default)
- </p></dd>
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Disable Channel Coupling
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>Enable Channel Coupling
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>-cpl_start_band <var>number</var></samp>’</dt>
- <dd><p>Coupling Start Band. Sets the channel coupling start band, from 1 to 15. If a
- value higher than the bandwidth is used, it will be reduced to 1 less than the
- coupling end band. If <var>auto</var> is used, the start band will be determined by
- the encoder based on the bit rate, sample rate, and channel layout. This option
- has no effect if channel coupling is disabled.
- </p><dl compact="compact">
- <dt>‘<samp>-1</samp>’</dt>
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Selected by Encoder (default)
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <p><a name="flac"></a>
- </p><a name="flac-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-flac-1">8.3 flac</a></h2>
-
- <p>FLAC (Free Lossless Audio Codec) Encoder
- </p>
- <a name="Options-20"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-20">8.3.1 Options</a></h3>
-
- <p>The following options are supported by FFmpeg’s flac encoder.
- </p>
- <dl compact="compact">
- <dt>‘<samp>compression_level</samp>’</dt>
- <dd><p>Sets the compression level, which chooses defaults for many other options
- if they are not set explicitly. Valid values are from 0 to 12, 5 is the
- default.
- </p>
- </dd>
- <dt>‘<samp>frame_size</samp>’</dt>
- <dd><p>Sets the size of the frames in samples per channel.
- </p>
- </dd>
- <dt>‘<samp>lpc_coeff_precision</samp>’</dt>
- <dd><p>Sets the LPC coefficient precision, valid values are from 1 to 15, 15 is the
- default.
- </p>
- </dd>
- <dt>‘<samp>lpc_type</samp>’</dt>
- <dd><p>Sets the first stage LPC algorithm
- </p><dl compact="compact">
- <dt>‘<samp>none</samp>’</dt>
- <dd><p>LPC is not used
- </p>
- </dd>
- <dt>‘<samp>fixed</samp>’</dt>
- <dd><p>fixed LPC coefficients
- </p>
- </dd>
- <dt>‘<samp>levinson</samp>’</dt>
- <dt>‘<samp>cholesky</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>lpc_passes</samp>’</dt>
- <dd><p>Number of passes to use for Cholesky factorization during LPC analysis
- </p>
- </dd>
- <dt>‘<samp>min_partition_order</samp>’</dt>
- <dd><p>The minimum partition order
- </p>
- </dd>
- <dt>‘<samp>max_partition_order</samp>’</dt>
- <dd><p>The maximum partition order
- </p>
- </dd>
- <dt>‘<samp>prediction_order_method</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>estimation</samp>’</dt>
- <dt>‘<samp>2level</samp>’</dt>
- <dt>‘<samp>4level</samp>’</dt>
- <dt>‘<samp>8level</samp>’</dt>
- <dt>‘<samp>search</samp>’</dt>
- <dd><p>Bruteforce search
- </p></dd>
- <dt>‘<samp>log</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>ch_mode</samp>’</dt>
- <dd><p>Channel mode
- </p><dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>The mode is chosen automatically for each frame
- </p></dd>
- <dt>‘<samp>indep</samp>’</dt>
- <dd><p>Channels are independently coded
- </p></dd>
- <dt>‘<samp>left_side</samp>’</dt>
- <dt>‘<samp>right_side</samp>’</dt>
- <dt>‘<samp>mid_side</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>exact_rice_parameters</samp>’</dt>
- <dd><p>Chooses if rice parameters are calculated exactly or approximately.
- if set to 1 then they are chosen exactly, which slows the code down slightly and
- improves compression slightly.
- </p>
- </dd>
- <dt>‘<samp>multi_dim_quant</samp>’</dt>
- <dd><p>Multi Dimensional Quantization. If set to 1 then a 2nd stage LPC algorithm is
- applied after the first stage to finetune the coefficients. This is quite slow
- and slightly improves compression.
- </p>
- </dd>
- </dl>
-
- <p><a name="opusenc"></a>
- </p><a name="opus"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-opus">8.4 opus</a></h2>
-
- <p>Opus encoder.
- </p>
- <p>This is a native FFmpeg encoder for the Opus format. Currently its in development and
- only implements the CELT part of the codec. Its quality is usually worse and at best
- is equal to the libopus encoder.
- </p>
- <a name="Options-17"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-17">8.4.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bit rate in bits/s. If unspecified it uses the number of channels and the layout
- to make a good guess.
- </p>
- </dd>
- <dt>‘<samp>opus_delay</samp>’</dt>
- <dd><p>Sets the maximum delay in milliseconds. Lower delays than 20ms will very quickly
- decrease quality.
- </p></dd>
- </dl>
-
- <p><a name="libfdk_002daac_002denc"></a>
- </p><a name="libfdk_005faac"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libfdk_005faac">8.5 libfdk_aac</a></h2>
-
- <p>libfdk-aac AAC (Advanced Audio Coding) encoder wrapper.
- </p>
- <p>The libfdk-aac library is based on the Fraunhofer FDK AAC code from
- the Android project.
- </p>
- <p>Requires the presence of the libfdk-aac headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libfdk-aac</code>. The library is also incompatible with GPL,
- so if you allow the use of GPL, you should configure with
- <code>--enable-gpl --enable-nonfree --enable-libfdk-aac</code>.
- </p>
- <p>This encoder is considered to produce output on par or worse at 128kbps to the
- <a href="#aacenc">the native FFmpeg AAC encoder</a> but can often produce better
- sounding audio at identical or lower bitrates and has support for the
- AAC-HE profiles.
- </p>
- <p>VBR encoding, enabled through the ‘<samp>vbr</samp>’ or ‘<samp>flags
- +qscale</samp>’ options, is experimental and only works with some
- combinations of parameters.
- </p>
- <p>Support for encoding 7.1 audio is only available with libfdk-aac 0.1.3 or
- higher.
- </p>
- <p>For more information see the fdk-aac project at
- <a href="http://sourceforge.net/p/opencore-amr/fdk-aac/">http://sourceforge.net/p/opencore-amr/fdk-aac/</a>.
- </p>
- <a name="Options-32"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-32">8.5.1 Options</a></h3>
-
- <p>The following options are mapped on the shared FFmpeg codec options.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bit rate in bits/s. If the bitrate is not explicitly specified, it
- is automatically set to a suitable value depending on the selected
- profile.
- </p>
- <p>In case VBR mode is enabled the option is ignored.
- </p>
- </dd>
- <dt>‘<samp>ar</samp>’</dt>
- <dd><p>Set audio sampling rate (in Hz).
- </p>
- </dd>
- <dt>‘<samp>channels</samp>’</dt>
- <dd><p>Set the number of audio channels.
- </p>
- </dd>
- <dt>‘<samp>flags +qscale</samp>’</dt>
- <dd><p>Enable fixed quality, VBR (Variable Bit Rate) mode.
- Note that VBR is implicitly enabled when the ‘<samp>vbr</samp>’ value is
- positive.
- </p>
- </dd>
- <dt>‘<samp>cutoff</samp>’</dt>
- <dd><p>Set cutoff frequency. If not specified (or explicitly set to 0) it
- will use a value automatically computed by the library. Default value
- is 0.
- </p>
- </dd>
- <dt>‘<samp>profile</samp>’</dt>
- <dd><p>Set audio profile.
- </p>
- <p>The following profiles are recognized:
- </p><dl compact="compact">
- <dt>‘<samp>aac_low</samp>’</dt>
- <dd><p>Low Complexity AAC (LC)
- </p>
- </dd>
- <dt>‘<samp>aac_he</samp>’</dt>
- <dd><p>High Efficiency AAC (HE-AAC)
- </p>
- </dd>
- <dt>‘<samp>aac_he_v2</samp>’</dt>
- <dd><p>High Efficiency AAC version 2 (HE-AACv2)
- </p>
- </dd>
- <dt>‘<samp>aac_ld</samp>’</dt>
- <dd><p>Low Delay AAC (LD)
- </p>
- </dd>
- <dt>‘<samp>aac_eld</samp>’</dt>
- <dd><p>Enhanced Low Delay AAC (ELD)
- </p></dd>
- </dl>
-
- <p>If not specified it is set to ‘<samp>aac_low</samp>’.
- </p></dd>
- </dl>
-
- <p>The following are private options of the libfdk_aac encoder.
- </p>
- <dl compact="compact">
- <dt>‘<samp>afterburner</samp>’</dt>
- <dd><p>Enable afterburner feature if set to 1, disabled if set to 0. This
- improves the quality but also the required processing power.
- </p>
- <p>Default value is 1.
- </p>
- </dd>
- <dt>‘<samp>eld_sbr</samp>’</dt>
- <dd><p>Enable SBR (Spectral Band Replication) for ELD if set to 1, disabled
- if set to 0.
- </p>
- <p>Default value is 0.
- </p>
- </dd>
- <dt>‘<samp>eld_v2</samp>’</dt>
- <dd><p>Enable ELDv2 (LD-MPS extension for ELD stereo signals) for ELDv2 if set to 1,
- disabled if set to 0.
- </p>
- <p>Note that option is available when fdk-aac version (AACENCODER_LIB_VL0.AACENCODER_LIB_VL1.AACENCODER_LIB_VL2) > (4.0.0).
- </p>
- <p>Default value is 0.
- </p>
- </dd>
- <dt>‘<samp>signaling</samp>’</dt>
- <dd><p>Set SBR/PS signaling style.
- </p>
- <p>It can assume one of the following values:
- </p><dl compact="compact">
- <dt>‘<samp>default</samp>’</dt>
- <dd><p>choose signaling implicitly (explicit hierarchical by default,
- implicit if global header is disabled)
- </p>
- </dd>
- <dt>‘<samp>implicit</samp>’</dt>
- <dd><p>implicit backwards compatible signaling
- </p>
- </dd>
- <dt>‘<samp>explicit_sbr</samp>’</dt>
- <dd><p>explicit SBR, implicit PS signaling
- </p>
- </dd>
- <dt>‘<samp>explicit_hierarchical</samp>’</dt>
- <dd><p>explicit hierarchical signaling
- </p></dd>
- </dl>
-
- <p>Default value is ‘<samp>default</samp>’.
- </p>
- </dd>
- <dt>‘<samp>latm</samp>’</dt>
- <dd><p>Output LATM/LOAS encapsulated data if set to 1, disabled if set to 0.
- </p>
- <p>Default value is 0.
- </p>
- </dd>
- <dt>‘<samp>header_period</samp>’</dt>
- <dd><p>Set StreamMuxConfig and PCE repetition period (in frames) for sending
- in-band configuration buffers within LATM/LOAS transport layer.
- </p>
- <p>Must be a 16-bits non-negative integer.
- </p>
- <p>Default value is 0.
- </p>
- </dd>
- <dt>‘<samp>vbr</samp>’</dt>
- <dd><p>Set VBR mode, from 1 to 5. 1 is lowest quality (though still pretty
- good) and 5 is highest quality. A value of 0 will disable VBR, and CBR
- (Constant Bit Rate) is enabled.
- </p>
- <p>Currently only the ‘<samp>aac_low</samp>’ profile supports VBR encoding.
- </p>
- <p>VBR modes 1-5 correspond to roughly the following average bit rates:
- </p>
- <dl compact="compact">
- <dt>‘<samp>1</samp>’</dt>
- <dd><p>32 kbps/channel
- </p></dd>
- <dt>‘<samp>2</samp>’</dt>
- <dd><p>40 kbps/channel
- </p></dd>
- <dt>‘<samp>3</samp>’</dt>
- <dd><p>48-56 kbps/channel
- </p></dd>
- <dt>‘<samp>4</samp>’</dt>
- <dd><p>64 kbps/channel
- </p></dd>
- <dt>‘<samp>5</samp>’</dt>
- <dd><p>about 80-96 kbps/channel
- </p></dd>
- </dl>
-
- <p>Default value is 0.
- </p></dd>
- </dl>
-
- <a name="Examples-1"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Examples-1">8.5.2 Examples</a></h3>
-
- <ul>
- <li>
- Use <code>ffmpeg</code> to convert an audio file to VBR AAC in an M4A (MP4)
- container:
- <div class="example">
- <pre class="example">ffmpeg -i input.wav -codec:a libfdk_aac -vbr 3 output.m4a
- </pre></div>
-
- </li><li>
- Use <code>ffmpeg</code> to convert an audio file to CBR 64k kbps AAC, using the
- High-Efficiency AAC profile:
- <div class="example">
- <pre class="example">ffmpeg -i input.wav -c:a libfdk_aac -profile:a aac_he -b:a 64k output.m4a
- </pre></div>
- </li></ul>
-
- <p><a name="libmp3lame"></a>
- </p><a name="libmp3lame-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libmp3lame-1">8.6 libmp3lame</a></h2>
-
- <p>LAME (Lame Ain’t an MP3 Encoder) MP3 encoder wrapper.
- </p>
- <p>Requires the presence of the libmp3lame headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libmp3lame</code>.
- </p>
- <p>See <a href="#libshine">libshine</a> for a fixed-point MP3 encoder, although with a
- lower quality.
- </p>
- <a name="Options-6"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-6">8.6.1 Options</a></h3>
-
- <p>The following options are supported by the libmp3lame wrapper. The
- <code>lame</code>-equivalent of the options are listed in parentheses.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>-b</em>)</samp>’</dt>
- <dd><p>Set bitrate expressed in bits/s for CBR or ABR. LAME <code>bitrate</code> is
- expressed in kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>q (<em>-V</em>)</samp>’</dt>
- <dd><p>Set constant quality setting for VBR. This option is valid only
- using the <code>ffmpeg</code> command-line tool. For library interface
- users, use ‘<samp>global_quality</samp>’.
- </p>
- </dd>
- <dt>‘<samp>compression_level (<em>-q</em>)</samp>’</dt>
- <dd><p>Set algorithm quality. Valid arguments are integers in the 0-9 range,
- with 0 meaning highest quality but slowest, and 9 meaning fastest
- while producing the worst quality.
- </p>
- </dd>
- <dt>‘<samp>cutoff (<em>--lowpass</em>)</samp>’</dt>
- <dd><p>Set lowpass cutoff frequency. If unspecified, the encoder dynamically
- adjusts the cutoff.
- </p>
- </dd>
- <dt>‘<samp>reservoir</samp>’</dt>
- <dd><p>Enable use of bit reservoir when set to 1. Default value is 1. LAME
- has this enabled by default, but can be overridden by use
- ‘<samp>--nores</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>joint_stereo (<em>-m j</em>)</samp>’</dt>
- <dd><p>Enable the encoder to use (on a frame by frame basis) either L/R
- stereo or mid/side stereo. Default value is 1.
- </p>
- </dd>
- <dt>‘<samp>abr (<em>--abr</em>)</samp>’</dt>
- <dd><p>Enable the encoder to use ABR when set to 1. The <code>lame</code>
- ‘<samp>--abr</samp>’ sets the target bitrate, while this options only
- tells FFmpeg to use ABR still relies on ‘<samp>b</samp>’ to set bitrate.
- </p>
- </dd>
- </dl>
-
- <a name="libopencore_002damrnb-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopencore_002damrnb-1">8.7 libopencore-amrnb</a></h2>
-
- <p>OpenCORE Adaptive Multi-Rate Narrowband encoder.
- </p>
- <p>Requires the presence of the libopencore-amrnb headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libopencore-amrnb --enable-version3</code>.
- </p>
- <p>This is a mono-only encoder. Officially it only supports 8000Hz sample rate,
- but you can override it by setting ‘<samp>strict</samp>’ to ‘<samp>unofficial</samp>’ or
- lower.
- </p>
- <a name="Options-21"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-21">8.7.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bitrate in bits per second. Only the following bitrates are supported,
- otherwise libavcodec will round to the nearest valid bitrate.
- </p>
- <dl compact="compact">
- <dt>‘<samp>4750</samp>’</dt>
- <dt>‘<samp>5150</samp>’</dt>
- <dt>‘<samp>5900</samp>’</dt>
- <dt>‘<samp>6700</samp>’</dt>
- <dt>‘<samp>7400</samp>’</dt>
- <dt>‘<samp>7950</samp>’</dt>
- <dt>‘<samp>10200</samp>’</dt>
- <dt>‘<samp>12200</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>dtx</samp>’</dt>
- <dd><p>Allow discontinuous transmission (generate comfort noise) when set to 1. The
- default value is 0 (disabled).
- </p>
- </dd>
- </dl>
-
- <a name="libopus-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopus-1">8.8 libopus</a></h2>
-
- <p>libopus Opus Interactive Audio Codec encoder wrapper.
- </p>
- <p>Requires the presence of the libopus headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libopus</code>.
- </p>
- <a name="Option-Mapping"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Option-Mapping">8.8.1 Option Mapping</a></h3>
-
- <p>Most libopus options are modelled after the <code>opusenc</code> utility from
- opus-tools. The following is an option mapping chart describing options
- supported by the libopus wrapper, and their <code>opusenc</code>-equivalent
- in parentheses.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>bitrate</em>)</samp>’</dt>
- <dd><p>Set the bit rate in bits/s. FFmpeg’s ‘<samp>b</samp>’ option is
- expressed in bits/s, while <code>opusenc</code>’s ‘<samp>bitrate</samp>’ in
- kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>vbr (<em>vbr</em>, <em>hard-cbr</em>, and <em>cvbr</em>)</samp>’</dt>
- <dd><p>Set VBR mode. The FFmpeg ‘<samp>vbr</samp>’ option has the following
- valid arguments, with the <code>opusenc</code> equivalent options
- in parentheses:
- </p>
- <dl compact="compact">
- <dt>‘<samp>off (<em>hard-cbr</em>)</samp>’</dt>
- <dd><p>Use constant bit rate encoding.
- </p>
- </dd>
- <dt>‘<samp>on (<em>vbr</em>)</samp>’</dt>
- <dd><p>Use variable bit rate encoding (the default).
- </p>
- </dd>
- <dt>‘<samp>constrained (<em>cvbr</em>)</samp>’</dt>
- <dd><p>Use constrained variable bit rate encoding.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>compression_level (<em>comp</em>)</samp>’</dt>
- <dd><p>Set encoding algorithm complexity. Valid options are integers in
- the 0-10 range. 0 gives the fastest encodes but lower quality, while 10
- gives the highest quality but slowest encoding. The default is 10.
- </p>
- </dd>
- <dt>‘<samp>frame_duration (<em>framesize</em>)</samp>’</dt>
- <dd><p>Set maximum frame size, or duration of a frame in milliseconds. The
- argument must be exactly the following: 2.5, 5, 10, 20, 40, 60. Smaller
- frame sizes achieve lower latency but less quality at a given bitrate.
- Sizes greater than 20ms are only interesting at fairly low bitrates.
- The default is 20ms.
- </p>
- </dd>
- <dt>‘<samp>packet_loss (<em>expect-loss</em>)</samp>’</dt>
- <dd><p>Set expected packet loss percentage. The default is 0.
- </p>
- </dd>
- <dt>‘<samp>application (N.A.)</samp>’</dt>
- <dd><p>Set intended application type. Valid options are listed below:
- </p>
- <dl compact="compact">
- <dt>‘<samp>voip</samp>’</dt>
- <dd><p>Favor improved speech intelligibility.
- </p></dd>
- <dt>‘<samp>audio</samp>’</dt>
- <dd><p>Favor faithfulness to the input (the default).
- </p></dd>
- <dt>‘<samp>lowdelay</samp>’</dt>
- <dd><p>Restrict to only the lowest delay modes.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>cutoff (N.A.)</samp>’</dt>
- <dd><p>Set cutoff bandwidth in Hz. The argument must be exactly one of the
- following: 4000, 6000, 8000, 12000, or 20000, corresponding to
- narrowband, mediumband, wideband, super wideband, and fullband
- respectively. The default is 0 (cutoff disabled).
- </p>
- </dd>
- <dt>‘<samp>mapping_family (<em>mapping_family</em>)</samp>’</dt>
- <dd><p>Set channel mapping family to be used by the encoder. The default value of -1
- uses mapping family 0 for mono and stereo inputs, and mapping family 1
- otherwise. The default also disables the surround masking and LFE bandwidth
- optimzations in libopus, and requires that the input contains 8 channels or
- fewer.
- </p>
- <p>Other values include 0 for mono and stereo, 1 for surround sound with masking
- and LFE bandwidth optimizations, and 255 for independent streams with an
- unspecified channel layout.
- </p>
- </dd>
- <dt>‘<samp>apply_phase_inv (N.A.) (requires libopus >= 1.2)</samp>’</dt>
- <dd><p>If set to 0, disables the use of phase inversion for intensity stereo,
- improving the quality of mono downmixes, but slightly reducing normal stereo
- quality. The default is 1 (phase inversion enabled).
- </p>
- </dd>
- </dl>
-
- <p><a name="libshine"></a>
- </p><a name="libshine-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libshine-1">8.9 libshine</a></h2>
-
- <p>Shine Fixed-Point MP3 encoder wrapper.
- </p>
- <p>Shine is a fixed-point MP3 encoder. It has a far better performance on
- platforms without an FPU, e.g. armel CPUs, and some phones and tablets.
- However, as it is more targeted on performance than quality, it is not on par
- with LAME and other production-grade encoders quality-wise. Also, according to
- the project’s homepage, this encoder may not be free of bugs as the code was
- written a long time ago and the project was dead for at least 5 years.
- </p>
- <p>This encoder only supports stereo and mono input. This is also CBR-only.
- </p>
- <p>The original project (last updated in early 2007) is at
- <a href="http://sourceforge.net/projects/libshine-fxp/">http://sourceforge.net/projects/libshine-fxp/</a>. We only support the
- updated fork by the Savonet/Liquidsoap project at <a href="https://github.com/savonet/shine">https://github.com/savonet/shine</a>.
- </p>
- <p>Requires the presence of the libshine headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libshine</code>.
- </p>
- <p>See also <a href="#libmp3lame">libmp3lame</a>.
- </p>
- <a name="Options-25"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-25">8.9.1 Options</a></h3>
-
- <p>The following options are supported by the libshine wrapper. The
- <code>shineenc</code>-equivalent of the options are listed in parentheses.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>-b</em>)</samp>’</dt>
- <dd><p>Set bitrate expressed in bits/s for CBR. <code>shineenc</code> ‘<samp>-b</samp>’ option
- is expressed in kilobits/s.
- </p>
- </dd>
- </dl>
-
- <a name="libtwolame"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libtwolame">8.10 libtwolame</a></h2>
-
- <p>TwoLAME MP2 encoder wrapper.
- </p>
- <p>Requires the presence of the libtwolame headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libtwolame</code>.
- </p>
- <a name="Options-23"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-23">8.10.1 Options</a></h3>
-
- <p>The following options are supported by the libtwolame wrapper. The
- <code>twolame</code>-equivalent options follow the FFmpeg ones and are in
- parentheses.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>-b</em>)</samp>’</dt>
- <dd><p>Set bitrate expressed in bits/s for CBR. <code>twolame</code> ‘<samp>b</samp>’
- option is expressed in kilobits/s. Default value is 128k.
- </p>
- </dd>
- <dt>‘<samp>q (<em>-V</em>)</samp>’</dt>
- <dd><p>Set quality for experimental VBR support. Maximum value range is
- from -50 to 50, useful range is from -10 to 10. The higher the
- value, the better the quality. This option is valid only using the
- <code>ffmpeg</code> command-line tool. For library interface users,
- use ‘<samp>global_quality</samp>’.
- </p>
- </dd>
- <dt>‘<samp>mode (<em>--mode</em>)</samp>’</dt>
- <dd><p>Set the mode of the resulting audio. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Choose mode automatically based on the input. This is the default.
- </p></dd>
- <dt>‘<samp>stereo</samp>’</dt>
- <dd><p>Stereo
- </p></dd>
- <dt>‘<samp>joint_stereo</samp>’</dt>
- <dd><p>Joint stereo
- </p></dd>
- <dt>‘<samp>dual_channel</samp>’</dt>
- <dd><p>Dual channel
- </p></dd>
- <dt>‘<samp>mono</samp>’</dt>
- <dd><p>Mono
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>psymodel (<em>--psyc-mode</em>)</samp>’</dt>
- <dd><p>Set psychoacoustic model to use in encoding. The argument must be
- an integer between -1 and 4, inclusive. The higher the value, the
- better the quality. The default value is 3.
- </p>
- </dd>
- <dt>‘<samp>energy_levels (<em>--energy</em>)</samp>’</dt>
- <dd><p>Enable energy levels extensions when set to 1. The default value is
- 0 (disabled).
- </p>
- </dd>
- <dt>‘<samp>error_protection (<em>--protect</em>)</samp>’</dt>
- <dd><p>Enable CRC error protection when set to 1. The default value is 0
- (disabled).
- </p>
- </dd>
- <dt>‘<samp>copyright (<em>--copyright</em>)</samp>’</dt>
- <dd><p>Set MPEG audio copyright flag when set to 1. The default value is 0
- (disabled).
- </p>
- </dd>
- <dt>‘<samp>original (<em>--original</em>)</samp>’</dt>
- <dd><p>Set MPEG audio original flag when set to 1. The default value is 0
- (disabled).
- </p>
- </dd>
- </dl>
-
- <a name="libvo_002damrwbenc"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libvo_002damrwbenc">8.11 libvo-amrwbenc</a></h2>
-
- <p>VisualOn Adaptive Multi-Rate Wideband encoder.
- </p>
- <p>Requires the presence of the libvo-amrwbenc headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libvo-amrwbenc --enable-version3</code>.
- </p>
- <p>This is a mono-only encoder. Officially it only supports 16000Hz sample
- rate, but you can override it by setting ‘<samp>strict</samp>’ to
- ‘<samp>unofficial</samp>’ or lower.
- </p>
- <a name="Options-19"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-19">8.11.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bitrate in bits/s. Only the following bitrates are supported, otherwise
- libavcodec will round to the nearest valid bitrate.
- </p>
- <dl compact="compact">
- <dt>‘<samp>6600</samp>’</dt>
- <dt>‘<samp>8850</samp>’</dt>
- <dt>‘<samp>12650</samp>’</dt>
- <dt>‘<samp>14250</samp>’</dt>
- <dt>‘<samp>15850</samp>’</dt>
- <dt>‘<samp>18250</samp>’</dt>
- <dt>‘<samp>19850</samp>’</dt>
- <dt>‘<samp>23050</samp>’</dt>
- <dt>‘<samp>23850</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>dtx</samp>’</dt>
- <dd><p>Allow discontinuous transmission (generate comfort noise) when set to 1. The
- default value is 0 (disabled).
- </p>
- </dd>
- </dl>
-
- <a name="libvorbis"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libvorbis">8.12 libvorbis</a></h2>
-
- <p>libvorbis encoder wrapper.
- </p>
- <p>Requires the presence of the libvorbisenc headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libvorbis</code>.
- </p>
- <a name="Options-7"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-7">8.12.1 Options</a></h3>
-
- <p>The following options are supported by the libvorbis wrapper. The
- <code>oggenc</code>-equivalent of the options are listed in parentheses.
- </p>
- <p>To get a more accurate and extensive documentation of the libvorbis
- options, consult the libvorbisenc’s and <code>oggenc</code>’s documentations.
- See <a href="http://xiph.org/vorbis/">http://xiph.org/vorbis/</a>,
- <a href="http://wiki.xiph.org/Vorbis-tools">http://wiki.xiph.org/Vorbis-tools</a>, and oggenc(1).
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>-b</em>)</samp>’</dt>
- <dd><p>Set bitrate expressed in bits/s for ABR. <code>oggenc</code> ‘<samp>-b</samp>’ is
- expressed in kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>q (<em>-q</em>)</samp>’</dt>
- <dd><p>Set constant quality setting for VBR. The value should be a float
- number in the range of -1.0 to 10.0. The higher the value, the better
- the quality. The default value is ‘<samp>3.0</samp>’.
- </p>
- <p>This option is valid only using the <code>ffmpeg</code> command-line tool.
- For library interface users, use ‘<samp>global_quality</samp>’.
- </p>
- </dd>
- <dt>‘<samp>cutoff (<em>--advanced-encode-option lowpass_frequency=N</em>)</samp>’</dt>
- <dd><p>Set cutoff bandwidth in Hz, a value of 0 disables cutoff. <code>oggenc</code>’s
- related option is expressed in kHz. The default value is ‘<samp>0</samp>’ (cutoff
- disabled).
- </p>
- </dd>
- <dt>‘<samp>minrate (<em>-m</em>)</samp>’</dt>
- <dd><p>Set minimum bitrate expressed in bits/s. <code>oggenc</code> ‘<samp>-m</samp>’ is
- expressed in kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>maxrate (<em>-M</em>)</samp>’</dt>
- <dd><p>Set maximum bitrate expressed in bits/s. <code>oggenc</code> ‘<samp>-M</samp>’ is
- expressed in kilobits/s. This only has effect on ABR mode.
- </p>
- </dd>
- <dt>‘<samp>iblock (<em>--advanced-encode-option impulse_noisetune=N</em>)</samp>’</dt>
- <dd><p>Set noise floor bias for impulse blocks. The value is a float number from
- -15.0 to 0.0. A negative bias instructs the encoder to pay special attention
- to the crispness of transients in the encoded audio. The tradeoff for better
- transient response is a higher bitrate.
- </p>
- </dd>
- </dl>
-
- <p><a name="libwavpack"></a>
- </p><a name="libwavpack-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libwavpack-1">8.13 libwavpack</a></h2>
-
- <p>A wrapper providing WavPack encoding through libwavpack.
- </p>
- <p>Only lossless mode using 32-bit integer samples is supported currently.
- </p>
- <p>Requires the presence of the libwavpack headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libwavpack</code>.
- </p>
- <p>Note that a libavcodec-native encoder for the WavPack codec exists so users can
- encode audios with this codec without using this encoder. See <a href="#wavpackenc">wavpackenc</a>.
- </p>
- <a name="Options-12"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-12">8.13.1 Options</a></h3>
-
- <p><code>wavpack</code> command line utility’s corresponding options are listed in
- parentheses, if any.
- </p>
- <dl compact="compact">
- <dt>‘<samp>frame_size (<em>--blocksize</em>)</samp>’</dt>
- <dd><p>Default is 32768.
- </p>
- </dd>
- <dt>‘<samp>compression_level</samp>’</dt>
- <dd><p>Set speed vs. compression tradeoff. Acceptable arguments are listed below:
- </p>
- <dl compact="compact">
- <dt>‘<samp>0 (<em>-f</em>)</samp>’</dt>
- <dd><p>Fast mode.
- </p>
- </dd>
- <dt>‘<samp>1</samp>’</dt>
- <dd><p>Normal (default) settings.
- </p>
- </dd>
- <dt>‘<samp>2 (<em>-h</em>)</samp>’</dt>
- <dd><p>High quality.
- </p>
- </dd>
- <dt>‘<samp>3 (<em>-hh</em>)</samp>’</dt>
- <dd><p>Very high quality.
- </p>
- </dd>
- <dt>‘<samp>4-8 (<em>-hh -x</em><var>EXTRAPROC</var>)</samp>’</dt>
- <dd><p>Same as ‘<samp>3</samp>’, but with extra processing enabled.
- </p>
- <p>‘<samp>4</samp>’ is the same as ‘<samp>-x2</samp>’ and ‘<samp>8</samp>’ is the same as ‘<samp>-x6</samp>’.
- </p>
- </dd>
- </dl>
- </dd>
- </dl>
-
- <p><a name="mjpegenc"></a>
- </p><a name="mjpeg"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-mjpeg">8.14 mjpeg</a></h2>
-
- <p>Motion JPEG encoder.
- </p>
- <a name="Options-28"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-28">8.14.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>huffman</samp>’</dt>
- <dd><p>Set the huffman encoding strategy. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>default</samp>’</dt>
- <dd><p>Use the default huffman tables. This is the default strategy.
- </p>
- </dd>
- <dt>‘<samp>optimal</samp>’</dt>
- <dd><p>Compute and use optimal huffman tables.
- </p>
- </dd>
- </dl>
- </dd>
- </dl>
-
- <p><a name="wavpackenc"></a>
- </p><a name="wavpack"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-wavpack">8.15 wavpack</a></h2>
-
- <p>WavPack lossless audio encoder.
- </p>
- <p>This is a libavcodec-native WavPack encoder. There is also an encoder based on
- libwavpack, but there is virtually no reason to use that encoder.
- </p>
- <p>See also <a href="#libwavpack">libwavpack</a>.
- </p>
- <a name="Options-10"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-10">8.15.1 Options</a></h3>
-
- <p>The equivalent options for <code>wavpack</code> command line utility are listed in
- parentheses.
- </p>
- <a name="Shared-options"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Shared-options">8.15.1.1 Shared options</a></h4>
-
- <p>The following shared options are effective for this encoder. Only special notes
- about this particular encoder will be documented here. For the general meaning
- of the options, see <a href="#codec_002doptions">the Codec Options chapter</a>.
- </p>
- <dl compact="compact">
- <dt>‘<samp>frame_size (<em>--blocksize</em>)</samp>’</dt>
- <dd><p>For this encoder, the range for this option is between 128 and 131072. Default
- is automatically decided based on sample rate and number of channel.
- </p>
- <p>For the complete formula of calculating default, see
- ‘<tt>libavcodec/wavpackenc.c</tt>’.
- </p>
- </dd>
- <dt>‘<samp>compression_level (<em>-f</em>, <em>-h</em>, <em>-hh</em>, and <em>-x</em>)</samp>’</dt>
- <dd><p>This option’s syntax is consistent with <a href="#libwavpack">libwavpack</a>’s.
- </p></dd>
- </dl>
-
- <a name="Private-options-1"></a>
- <h4 class="subsubsection"><a href="ffmpeg-codecs.html#toc-Private-options-1">8.15.1.2 Private options</a></h4>
-
- <dl compact="compact">
- <dt>‘<samp>joint_stereo (<em>-j</em>)</samp>’</dt>
- <dd><p>Set whether to enable joint stereo. Valid values are:
- </p>
- <dl compact="compact">
- <dt>‘<samp>on (<em>1</em>)</samp>’</dt>
- <dd><p>Force mid/side audio encoding.
- </p></dd>
- <dt>‘<samp>off (<em>0</em>)</samp>’</dt>
- <dd><p>Force left/right audio encoding.
- </p></dd>
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Let the encoder decide automatically.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>optimize_mono</samp>’</dt>
- <dd><p>Set whether to enable optimization for mono. This option is only effective for
- non-mono streams. Available values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>on</samp>’</dt>
- <dd><p>enabled
- </p></dd>
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>disabled
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
-
- <a name="Video-Encoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Video-Encoders">9 Video Encoders</a></h1>
-
- <p>A description of some of the currently available video encoders
- follows.
- </p>
- <a name="Hap"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-Hap">9.1 Hap</a></h2>
-
- <p>Vidvox Hap video encoder.
- </p>
- <a name="Options-15"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-15">9.1.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>format <var>integer</var></samp>’</dt>
- <dd><p>Specifies the Hap format to encode.
- </p>
- <dl compact="compact">
- <dt>‘<samp>hap</samp>’</dt>
- <dt>‘<samp>hap_alpha</samp>’</dt>
- <dt>‘<samp>hap_q</samp>’</dt>
- </dl>
-
- <p>Default value is ‘<samp>hap</samp>’.
- </p>
- </dd>
- <dt>‘<samp>chunks <var>integer</var></samp>’</dt>
- <dd><p>Specifies the number of chunks to split frames into, between 1 and 64. This
- permits multithreaded decoding of large frames, potentially at the cost of
- data-rate. The encoder may modify this value to divide frames evenly.
- </p>
- <p>Default value is <var>1</var>.
- </p>
- </dd>
- <dt>‘<samp>compressor <var>integer</var></samp>’</dt>
- <dd><p>Specifies the second-stage compressor to use. If set to ‘<samp>none</samp>’,
- ‘<samp>chunks</samp>’ will be limited to 1, as chunked uncompressed frames offer no
- benefit.
- </p>
- <dl compact="compact">
- <dt>‘<samp>none</samp>’</dt>
- <dt>‘<samp>snappy</samp>’</dt>
- </dl>
-
- <p>Default value is ‘<samp>snappy</samp>’.
- </p>
- </dd>
- </dl>
-
- <a name="jpeg2000"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-jpeg2000">9.2 jpeg2000</a></h2>
-
- <p>The native jpeg 2000 encoder is lossy by default, the <code>-q:v</code>
- option can be used to set the encoding quality. Lossless encoding
- can be selected with <code>-pred 1</code>.
- </p>
- <a name="Options-14"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-14">9.2.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>format</samp>’</dt>
- <dd><p>Can be set to either <code>j2k</code> or <code>jp2</code> (the default) that
- makes it possible to store non-rgb pix_fmts.
- </p>
- </dd>
- </dl>
-
- <a name="librav1e"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-librav1e">9.3 librav1e</a></h2>
-
- <p>rav1e AV1 encoder wrapper.
- </p>
- <p>Requires the presence of the rav1e headers and library during configuration.
- You need to explicitly configure the build with <code>--enable-librav1e</code>.
- </p>
- <a name="Options-1"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-1">9.3.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>qmax</samp>’</dt>
- <dd><p>Sets the maximum quantizer to use when using bitrate mode.
- </p>
- </dd>
- <dt>‘<samp>qmin</samp>’</dt>
- <dd><p>Sets the minimum quantizer to use when using bitrate mode.
- </p>
- </dd>
- <dt>‘<samp>qp</samp>’</dt>
- <dd><p>Uses quantizer mode to encode at the given quantizer (0-255).
- </p>
- </dd>
- <dt>‘<samp>speed</samp>’</dt>
- <dd><p>Selects the speed preset (0-10) to encode with.
- </p>
- </dd>
- <dt>‘<samp>tiles</samp>’</dt>
- <dd><p>Selects how many tiles to encode with.
- </p>
- </dd>
- <dt>‘<samp>tile-rows</samp>’</dt>
- <dd><p>Selects how many rows of tiles to encode with.
- </p>
- </dd>
- <dt>‘<samp>tile-columns</samp>’</dt>
- <dd><p>Selects how many columns of tiles to encode with.
- </p>
- </dd>
- <dt>‘<samp>rav1e-params</samp>’</dt>
- <dd><p>Set rav1e options using a list of <var>key</var>=<var>value</var> pairs separated
- by ":". See <code>rav1e --help</code> for a list of options.
- </p>
- <p>For example to specify librav1e encoding options with ‘<samp>-rav1e-params</samp>’:
- </p>
- <div class="example">
- <pre class="example">ffmpeg -i input -c:v librav1e -b:v 500K -rav1e-params speed=5:low_latency=true output.mp4
- </pre></div>
-
- </dd>
- </dl>
-
- <a name="libaom_002dav1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libaom_002dav1">9.4 libaom-av1</a></h2>
-
- <p>libaom AV1 encoder wrapper.
- </p>
- <p>Requires the presence of the libaom headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libaom</code>.
- </p>
- <a name="Options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options">9.4.1 Options</a></h3>
-
- <p>The wrapper supports the following standard libavcodec options:
- </p>
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set bitrate target in bits/second. By default this will use
- variable-bitrate mode. If ‘<samp>maxrate</samp>’ and ‘<samp>minrate</samp>’ are
- also set to the same value then it will use constant-bitrate mode,
- otherwise if ‘<samp>crf</samp>’ is set as well then it will use
- constrained-quality mode.
- </p>
- </dd>
- <dt>‘<samp>g keyint_min</samp>’</dt>
- <dd><p>Set key frame placement. The GOP size sets the maximum distance between
- key frames; if zero the output stream will be intra-only. The minimum
- distance is ignored unless it is the same as the GOP size, in which case
- key frames will always appear at a fixed interval. Not set by default,
- so without this option the library has completely free choice about
- where to place key frames.
- </p>
- </dd>
- <dt>‘<samp>qmin qmax</samp>’</dt>
- <dd><p>Set minimum/maximum quantisation values. Valid range is from 0 to 63
- (warning: this does not match the quantiser values actually used by AV1
- - divide by four to map real quantiser values to this range). Defaults
- to min/max (no constraint).
- </p>
- </dd>
- <dt>‘<samp>minrate maxrate bufsize rc_init_occupancy</samp>’</dt>
- <dd><p>Set rate control buffering parameters. Not used if not set - defaults
- to unconstrained variable bitrate.
- </p>
- </dd>
- <dt>‘<samp>threads</samp>’</dt>
- <dd><p>Set the number of threads to use while encoding. This may require the
- ‘<samp>tiles</samp>’ or ‘<samp>row-mt</samp>’ options to also be set to actually
- use the specified number of threads fully. Defaults to the number of
- hardware threads supported by the host machine.
- </p>
- </dd>
- <dt>‘<samp>profile</samp>’</dt>
- <dd><p>Set the encoding profile. Defaults to using the profile which matches
- the bit depth and chroma subsampling of the input.
- </p>
- </dd>
- </dl>
-
- <p>The wrapper also has some specific options:
- </p>
- <dl compact="compact">
- <dt>‘<samp>cpu-used</samp>’</dt>
- <dd><p>Set the quality/encoding speed tradeoff. Valid range is from 0 to 8,
- higher numbers indicating greater speed and lower quality. The default
- value is 1, which will be slow and high quality.
- </p>
- </dd>
- <dt>‘<samp>auto-alt-ref</samp>’</dt>
- <dd><p>Enable use of alternate reference frames. Defaults to the internal
- default of the library.
- </p>
- </dd>
- <dt>‘<samp>arnr-max-frames (<em>frames</em>)</samp>’</dt>
- <dd><p>Set altref noise reduction max frame count. Default is -1.
- </p>
- </dd>
- <dt>‘<samp>arnr-strength (<em>strength</em>)</samp>’</dt>
- <dd><p>Set altref noise reduction filter strength. Range is -1 to 6. Default is -1.
- </p>
- </dd>
- <dt>‘<samp>aq-mode (<em>aq-mode</em>)</samp>’</dt>
- <dd><p>Set adaptive quantization mode. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>0</em>)</samp>’</dt>
- <dd><p>Disabled.
- </p>
- </dd>
- <dt>‘<samp>variance (<em>1</em>)</samp>’</dt>
- <dd><p>Variance-based.
- </p>
- </dd>
- <dt>‘<samp>complexity (<em>2</em>)</samp>’</dt>
- <dd><p>Complexity-based.
- </p>
- </dd>
- <dt>‘<samp>cyclic (<em>3</em>)</samp>’</dt>
- <dd><p>Cyclic refresh.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>lag-in-frames</samp>’</dt>
- <dd><p>Set the maximum number of frames which the encoder may keep in flight
- at any one time for lookahead purposes. Defaults to the internal
- default of the library.
- </p>
- </dd>
- <dt>‘<samp>error-resilience</samp>’</dt>
- <dd><p>Enable error resilience features:
- </p><dl compact="compact">
- <dt>‘<samp>default</samp>’</dt>
- <dd><p>Improve resilience against losses of whole frames.
- </p></dd>
- </dl>
- <p>Not enabled by default.
- </p>
- </dd>
- <dt>‘<samp>crf</samp>’</dt>
- <dd><p>Set the quality/size tradeoff for constant-quality (no bitrate target)
- and constrained-quality (with maximum bitrate target) modes. Valid
- range is 0 to 63, higher numbers indicating lower quality and smaller
- output size. Only used if set; by default only the bitrate target is
- used.
- </p>
- </dd>
- <dt>‘<samp>static-thresh</samp>’</dt>
- <dd><p>Set a change threshold on blocks below which they will be skipped by
- the encoder. Defined in arbitrary units as a nonnegative integer,
- defaulting to zero (no blocks are skipped).
- </p>
- </dd>
- <dt>‘<samp>drop-threshold</samp>’</dt>
- <dd><p>Set a threshold for dropping frames when close to rate control bounds.
- Defined as a percentage of the target buffer - when the rate control
- buffer falls below this percentage, frames will be dropped until it
- has refilled above the threshold. Defaults to zero (no frames are
- dropped).
- </p>
- </dd>
- <dt>‘<samp>denoise-noise-level (<em>level</em>)</samp>’</dt>
- <dd><p>Amount of noise to be removed for grain synthesis. Grain synthesis is disabled if
- this option is not set or set to 0.
- </p>
- </dd>
- <dt>‘<samp>denoise-block-size (<em>pixels</em>)</samp>’</dt>
- <dd><p>Block size used for denoising for grain synthesis. If not set, AV1 codec
- uses the default value of 32.
- </p>
- </dd>
- <dt>‘<samp>undershoot-pct (<em>pct</em>)</samp>’</dt>
- <dd><p>Set datarate undershoot (min) percentage of the target bitrate. Range is -1 to 100.
- Default is -1.
- </p>
- </dd>
- <dt>‘<samp>overshoot-pct (<em>pct</em>)</samp>’</dt>
- <dd><p>Set datarate overshoot (max) percentage of the target bitrate. Range is -1 to 1000.
- Default is -1.
- </p>
- </dd>
- <dt>‘<samp>minsection-pct (<em>pct</em>)</samp>’</dt>
- <dd><p>Minimum percentage variation of the GOP bitrate from the target bitrate. If minsection-pct
- is not set, the libaomenc wrapper computes it as follows: <code>(minrate * 100 / bitrate)</code>.
- Range is -1 to 100. Default is -1 (unset).
- </p>
- </dd>
- <dt>‘<samp>maxsection-pct (<em>pct</em>)</samp>’</dt>
- <dd><p>Maximum percentage variation of the GOP bitrate from the target bitrate. If maxsection-pct
- is not set, the libaomenc wrapper computes it as follows: <code>(maxrate * 100 / bitrate)</code>.
- Range is -1 to 5000. Default is -1 (unset).
- </p>
- </dd>
- <dt>‘<samp>frame-parallel (<em>boolean</em>)</samp>’</dt>
- <dd><p>Enable frame parallel decodability features. Default is true.
- </p>
- </dd>
- <dt>‘<samp>tiles</samp>’</dt>
- <dd><p>Set the number of tiles to encode the input video with, as columns x
- rows. Larger numbers allow greater parallelism in both encoding and
- decoding, but may decrease coding efficiency. Defaults to the minimum
- number of tiles required by the size of the input video (this is 1x1
- (that is, a single tile) for sizes up to and including 4K).
- </p>
- </dd>
- <dt>‘<samp>tile-columns tile-rows</samp>’</dt>
- <dd><p>Set the number of tiles as log2 of the number of tile rows and columns.
- Provided for compatibility with libvpx/VP9.
- </p>
- </dd>
- <dt>‘<samp>row-mt (Requires libaom >= 1.0.0-759-g90a15f4f2)</samp>’</dt>
- <dd><p>Enable row based multi-threading. Disabled by default.
- </p>
- </dd>
- <dt>‘<samp>enable-cdef (<em>boolean</em>)</samp>’</dt>
- <dd><p>Enable Constrained Directional Enhancement Filter. The libaom-av1
- encoder enables CDEF by default.
- </p>
- </dd>
- <dt>‘<samp>enable-restoration (<em>boolean</em>)</samp>’</dt>
- <dd><p>Enable Loop Restoration Filter. Default is true for libaom-av1.
- </p>
- </dd>
- <dt>‘<samp>enable-global-motion (<em>boolean</em>)</samp>’</dt>
- <dd><p>Enable the use of global motion for block prediction. Default is true.
- </p>
- </dd>
- <dt>‘<samp>enable-intrabc (<em>boolean</em>)</samp>’</dt>
- <dd><p>Enable block copy mode for intra block prediction. This mode is
- useful for screen content. Default is true.
- </p>
- </dd>
- </dl>
-
- <a name="libkvazaar"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libkvazaar">9.5 libkvazaar</a></h2>
-
- <p>Kvazaar H.265/HEVC encoder.
- </p>
- <p>Requires the presence of the libkvazaar headers and library during
- configuration. You need to explicitly configure the build with
- ‘<samp>--enable-libkvazaar</samp>’.
- </p>
- <a name="Options-22"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-22">9.5.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set target video bitrate in bit/s and enable rate control.
- </p>
- </dd>
- <dt>‘<samp>kvazaar-params</samp>’</dt>
- <dd><p>Set kvazaar parameters as a list of <var>name</var>=<var>value</var> pairs separated
- by commas (,). See kvazaar documentation for a list of options.
- </p>
- </dd>
- </dl>
-
- <a name="libopenh264"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libopenh264">9.6 libopenh264</a></h2>
-
- <p>Cisco libopenh264 H.264/MPEG-4 AVC encoder wrapper.
- </p>
- <p>This encoder requires the presence of the libopenh264 headers and
- library during configuration. You need to explicitly configure the
- build with <code>--enable-libopenh264</code>. The library is detected using
- <code>pkg-config</code>.
- </p>
- <p>For more information about the library see
- <a href="http://www.openh264.org">http://www.openh264.org</a>.
- </p>
- <a name="Options-5"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-5">9.6.1 Options</a></h3>
-
- <p>The following FFmpeg global options affect the configurations of the
- libopenh264 encoder.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set the bitrate (as a number of bits per second).
- </p>
- </dd>
- <dt>‘<samp>g</samp>’</dt>
- <dd><p>Set the GOP size.
- </p>
- </dd>
- <dt>‘<samp>maxrate</samp>’</dt>
- <dd><p>Set the max bitrate (as a number of bits per second).
- </p>
- </dd>
- <dt>‘<samp>flags +global_header</samp>’</dt>
- <dd><p>Set global header in the bitstream.
- </p>
- </dd>
- <dt>‘<samp>slices</samp>’</dt>
- <dd><p>Set the number of slices, used in parallelized encoding. Default value
- is 0. This is only used when ‘<samp>slice_mode</samp>’ is set to
- ‘<samp>fixed</samp>’.
- </p>
- </dd>
- <dt>‘<samp>slice_mode</samp>’</dt>
- <dd><p>Set slice mode. Can assume one of the following possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>fixed</samp>’</dt>
- <dd><p>a fixed number of slices
- </p></dd>
- <dt>‘<samp>rowmb</samp>’</dt>
- <dd><p>one slice per row of macroblocks
- </p></dd>
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>automatic number of slices according to number of threads
- </p></dd>
- <dt>‘<samp>dyn</samp>’</dt>
- <dd><p>dynamic slicing
- </p></dd>
- </dl>
-
- <p>Default value is ‘<samp>auto</samp>’.
- </p>
- </dd>
- <dt>‘<samp>loopfilter</samp>’</dt>
- <dd><p>Enable loop filter, if set to 1 (automatically enabled). To disable
- set a value of 0.
- </p>
- </dd>
- <dt>‘<samp>profile</samp>’</dt>
- <dd><p>Set profile restrictions. If set to the value of ‘<samp>main</samp>’ enable
- CABAC (set the <code>SEncParamExt.iEntropyCodingModeFlag</code> flag to 1).
- </p>
- </dd>
- <dt>‘<samp>max_nal_size</samp>’</dt>
- <dd><p>Set maximum NAL size in bytes.
- </p>
- </dd>
- <dt>‘<samp>allow_skip_frames</samp>’</dt>
- <dd><p>Allow skipping frames to hit the target bitrate if set to 1.
- </p></dd>
- </dl>
-
- <a name="libtheora"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libtheora">9.7 libtheora</a></h2>
-
- <p>libtheora Theora encoder wrapper.
- </p>
- <p>Requires the presence of the libtheora headers and library during
- configuration. You need to explicitly configure the build with
- <code>--enable-libtheora</code>.
- </p>
- <p>For more information about the libtheora project see
- <a href="http://www.theora.org/">http://www.theora.org/</a>.
- </p>
- <a name="Options-9"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-9">9.7.1 Options</a></h3>
-
- <p>The following global options are mapped to internal libtheora options
- which affect the quality and the bitrate of the encoded stream.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Set the video bitrate in bit/s for CBR (Constant Bit Rate) mode. In
- case VBR (Variable Bit Rate) mode is enabled this option is ignored.
- </p>
- </dd>
- <dt>‘<samp>flags</samp>’</dt>
- <dd><p>Used to enable constant quality mode (VBR) encoding through the
- ‘<samp>qscale</samp>’ flag, and to enable the <code>pass1</code> and <code>pass2</code>
- modes.
- </p>
- </dd>
- <dt>‘<samp>g</samp>’</dt>
- <dd><p>Set the GOP size.
- </p>
- </dd>
- <dt>‘<samp>global_quality</samp>’</dt>
- <dd><p>Set the global quality as an integer in lambda units.
- </p>
- <p>Only relevant when VBR mode is enabled with <code>flags +qscale</code>. The
- value is converted to QP units by dividing it by <code>FF_QP2LAMBDA</code>,
- clipped in the [0 - 10] range, and then multiplied by 6.3 to get a
- value in the native libtheora range [0-63]. A higher value corresponds
- to a higher quality.
- </p>
- </dd>
- <dt>‘<samp>q</samp>’</dt>
- <dd><p>Enable VBR mode when set to a non-negative value, and set constant
- quality value as a double floating point value in QP units.
- </p>
- <p>The value is clipped in the [0-10] range, and then multiplied by 6.3
- to get a value in the native libtheora range [0-63].
- </p>
- <p>This option is valid only using the <code>ffmpeg</code> command-line
- tool. For library interface users, use ‘<samp>global_quality</samp>’.
- </p></dd>
- </dl>
-
- <a name="Examples"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Examples">9.7.2 Examples</a></h3>
-
- <ul>
- <li>
- Set maximum constant quality (VBR) encoding with <code>ffmpeg</code>:
- <div class="example">
- <pre class="example">ffmpeg -i INPUT -codec:v libtheora -q:v 10 OUTPUT.ogg
- </pre></div>
-
- </li><li>
- Use <code>ffmpeg</code> to convert a CBR 1000 kbps Theora video stream:
- <div class="example">
- <pre class="example">ffmpeg -i INPUT -codec:v libtheora -b:v 1000k OUTPUT.ogg
- </pre></div>
- </li></ul>
-
- <a name="libvpx"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libvpx">9.8 libvpx</a></h2>
-
- <p>VP8/VP9 format supported through libvpx.
- </p>
- <p>Requires the presence of the libvpx headers and library during configuration.
- You need to explicitly configure the build with <code>--enable-libvpx</code>.
- </p>
- <a name="Options-24"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-24">9.8.1 Options</a></h3>
-
- <p>The following options are supported by the libvpx wrapper. The
- <code>vpxenc</code>-equivalent options or values are listed in parentheses
- for easy migration.
- </p>
- <p>To reduce the duplication of documentation, only the private options
- and some others requiring special attention are documented here. For
- the documentation of the undocumented generic options, see
- <a href="#codec_002doptions">the Codec Options chapter</a>.
- </p>
- <p>To get more documentation of the libvpx options, invoke the command
- <code>ffmpeg -h encoder=libvpx</code>, <code>ffmpeg -h encoder=libvpx-vp9</code> or
- <code>vpxenc --help</code>. Further information is available in the libvpx API
- documentation.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>target-bitrate</em>)</samp>’</dt>
- <dd><p>Set bitrate in bits/s. Note that FFmpeg’s ‘<samp>b</samp>’ option is
- expressed in bits/s, while <code>vpxenc</code>’s ‘<samp>target-bitrate</samp>’ is in
- kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>g (<em>kf-max-dist</em>)</samp>’</dt>
- <dt>‘<samp>keyint_min (<em>kf-min-dist</em>)</samp>’</dt>
- <dt>‘<samp>qmin (<em>min-q</em>)</samp>’</dt>
- <dt>‘<samp>qmax (<em>max-q</em>)</samp>’</dt>
- <dt>‘<samp>bufsize (<em>buf-sz</em>, <em>buf-optimal-sz</em>)</samp>’</dt>
- <dd><p>Set ratecontrol buffer size (in bits). Note <code>vpxenc</code>’s options are
- specified in milliseconds, the libvpx wrapper converts this value as follows:
- <code>buf-sz = bufsize * 1000 / bitrate</code>,
- <code>buf-optimal-sz = bufsize * 1000 / bitrate * 5 / 6</code>.
- </p>
- </dd>
- <dt>‘<samp>rc_init_occupancy (<em>buf-initial-sz</em>)</samp>’</dt>
- <dd><p>Set number of bits which should be loaded into the rc buffer before decoding
- starts. Note <code>vpxenc</code>’s option is specified in milliseconds, the libvpx
- wrapper converts this value as follows:
- <code>rc_init_occupancy * 1000 / bitrate</code>.
- </p>
- </dd>
- <dt>‘<samp>undershoot-pct</samp>’</dt>
- <dd><p>Set datarate undershoot (min) percentage of the target bitrate.
- </p>
- </dd>
- <dt>‘<samp>overshoot-pct</samp>’</dt>
- <dd><p>Set datarate overshoot (max) percentage of the target bitrate.
- </p>
- </dd>
- <dt>‘<samp>skip_threshold (<em>drop-frame</em>)</samp>’</dt>
- <dt>‘<samp>qcomp (<em>bias-pct</em>)</samp>’</dt>
- <dt>‘<samp>maxrate (<em>maxsection-pct</em>)</samp>’</dt>
- <dd><p>Set GOP max bitrate in bits/s. Note <code>vpxenc</code>’s option is specified as a
- percentage of the target bitrate, the libvpx wrapper converts this value as
- follows: <code>(maxrate * 100 / bitrate)</code>.
- </p>
- </dd>
- <dt>‘<samp>minrate (<em>minsection-pct</em>)</samp>’</dt>
- <dd><p>Set GOP min bitrate in bits/s. Note <code>vpxenc</code>’s option is specified as a
- percentage of the target bitrate, the libvpx wrapper converts this value as
- follows: <code>(minrate * 100 / bitrate)</code>.
- </p>
- </dd>
- <dt>‘<samp>minrate, maxrate, b <em>end-usage=cbr</em></samp>’</dt>
- <dd><p><code>(minrate == maxrate == bitrate)</code>.
- </p>
- </dd>
- <dt>‘<samp>crf (<em>end-usage=cq</em>, <em>cq-level</em>)</samp>’</dt>
- <dt>‘<samp>tune (<em>tune</em>)</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>psnr (<em>psnr</em>)</samp>’</dt>
- <dt>‘<samp>ssim (<em>ssim</em>)</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>quality, deadline (<em>deadline</em>)</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>best</samp>’</dt>
- <dd><p>Use best quality deadline. Poorly named and quite slow, this option should be
- avoided as it may give worse quality output than good.
- </p></dd>
- <dt>‘<samp>good</samp>’</dt>
- <dd><p>Use good quality deadline. This is a good trade-off between speed and quality
- when used with the ‘<samp>cpu-used</samp>’ option.
- </p></dd>
- <dt>‘<samp>realtime</samp>’</dt>
- <dd><p>Use realtime quality deadline.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>speed, cpu-used (<em>cpu-used</em>)</samp>’</dt>
- <dd><p>Set quality/speed ratio modifier. Higher values speed up the encode at the cost
- of quality.
- </p>
- </dd>
- <dt>‘<samp>nr (<em>noise-sensitivity</em>)</samp>’</dt>
- <dt>‘<samp>static-thresh</samp>’</dt>
- <dd><p>Set a change threshold on blocks below which they will be skipped by the
- encoder.
- </p>
- </dd>
- <dt>‘<samp>slices (<em>token-parts</em>)</samp>’</dt>
- <dd><p>Note that FFmpeg’s ‘<samp>slices</samp>’ option gives the total number of partitions,
- while <code>vpxenc</code>’s ‘<samp>token-parts</samp>’ is given as
- <code>log2(partitions)</code>.
- </p>
- </dd>
- <dt>‘<samp>max-intra-rate</samp>’</dt>
- <dd><p>Set maximum I-frame bitrate as a percentage of the target bitrate. A value of 0
- means unlimited.
- </p>
- </dd>
- <dt>‘<samp>force_key_frames</samp>’</dt>
- <dd><p><code>VPX_EFLAG_FORCE_KF</code>
- </p>
- </dd>
- <dt>‘<samp>Alternate reference frame related</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>auto-alt-ref</samp>’</dt>
- <dd><p>Enable use of alternate reference frames (2-pass only).
- Values greater than 1 enable multi-layer alternate reference frames (VP9 only).
- </p></dd>
- <dt>‘<samp>arnr-maxframes</samp>’</dt>
- <dd><p>Set altref noise reduction max frame count.
- </p></dd>
- <dt>‘<samp>arnr-type</samp>’</dt>
- <dd><p>Set altref noise reduction filter type: backward, forward, centered.
- </p></dd>
- <dt>‘<samp>arnr-strength</samp>’</dt>
- <dd><p>Set altref noise reduction filter strength.
- </p></dd>
- <dt>‘<samp>rc-lookahead, lag-in-frames (<em>lag-in-frames</em>)</samp>’</dt>
- <dd><p>Set number of frames to look ahead for frametype and ratecontrol.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>error-resilient</samp>’</dt>
- <dd><p>Enable error resiliency features.
- </p>
- </dd>
- <dt>‘<samp>sharpness <var>integer</var></samp>’</dt>
- <dd><p>Increase sharpness at the expense of lower PSNR.
- The valid range is [0, 7].
- </p>
- </dd>
- <dt>‘<samp>ts-parameters</samp>’</dt>
- <dd><p>Sets the temporal scalability configuration using a :-separated list of
- key=value pairs. For example, to specify temporal scalability parameters
- with <code>ffmpeg</code>:
- </p><div class="example">
- <pre class="example">ffmpeg -i INPUT -c:v libvpx -ts-parameters ts_number_layers=3:\
- ts_target_bitrate=250,500,1000:ts_rate_decimator=4,2,1:\
- ts_periodicity=4:ts_layer_id=0,2,1,2:ts_layering_mode=3 OUTPUT
- </pre></div>
- <p>Below is a brief explanation of each of the parameters, please
- refer to <code>struct vpx_codec_enc_cfg</code> in <code>vpx/vpx_encoder.h</code> for more
- details.
- </p><dl compact="compact">
- <dt>‘<samp>ts_number_layers</samp>’</dt>
- <dd><p>Number of temporal coding layers.
- </p></dd>
- <dt>‘<samp>ts_target_bitrate</samp>’</dt>
- <dd><p>Target bitrate for each temporal layer (in kbps).
- (bitrate should be inclusive of the lower temporal layer).
- </p></dd>
- <dt>‘<samp>ts_rate_decimator</samp>’</dt>
- <dd><p>Frame rate decimation factor for each temporal layer.
- </p></dd>
- <dt>‘<samp>ts_periodicity</samp>’</dt>
- <dd><p>Length of the sequence defining frame temporal layer membership.
- </p></dd>
- <dt>‘<samp>ts_layer_id</samp>’</dt>
- <dd><p>Template defining the membership of frames to temporal layers.
- </p></dd>
- <dt>‘<samp>ts_layering_mode</samp>’</dt>
- <dd><p>(optional) Selecting the temporal structure from a set of pre-defined temporal layering modes.
- Currently supports the following options.
- </p><dl compact="compact">
- <dt>‘<samp>0</samp>’</dt>
- <dd><p>No temporal layering flags are provided internally,
- relies on flags being passed in using <code>metadata</code> field in <code>AVFrame</code>
- with following keys.
- </p><dl compact="compact">
- <dt>‘<samp>vp8-flags</samp>’</dt>
- <dd><p>Sets the flags passed into the encoder to indicate the referencing scheme for
- the current frame.
- Refer to function <code>vpx_codec_encode</code> in <code>vpx/vpx_encoder.h</code> for more
- details.
- </p></dd>
- <dt>‘<samp>temporal_id</samp>’</dt>
- <dd><p>Explicitly sets the temporal id of the current frame to encode.
- </p></dd>
- </dl>
- </dd>
- <dt>‘<samp>2</samp>’</dt>
- <dd><p>Two temporal layers. 0-1...
- </p></dd>
- <dt>‘<samp>3</samp>’</dt>
- <dd><p>Three temporal layers. 0-2-1-2...; with single reference frame.
- </p></dd>
- <dt>‘<samp>4</samp>’</dt>
- <dd><p>Same as option "3", except there is a dependency between
- the two temporal layer 2 frames within the temporal period.
- </p></dd>
- </dl>
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>VP9-specific options</samp>’</dt>
- <dd><dl compact="compact">
- <dt>‘<samp>lossless</samp>’</dt>
- <dd><p>Enable lossless mode.
- </p></dd>
- <dt>‘<samp>tile-columns</samp>’</dt>
- <dd><p>Set number of tile columns to use. Note this is given as
- <code>log2(tile_columns)</code>. For example, 8 tile columns would be requested by
- setting the ‘<samp>tile-columns</samp>’ option to 3.
- </p></dd>
- <dt>‘<samp>tile-rows</samp>’</dt>
- <dd><p>Set number of tile rows to use. Note this is given as <code>log2(tile_rows)</code>.
- For example, 4 tile rows would be requested by setting the ‘<samp>tile-rows</samp>’
- option to 2.
- </p></dd>
- <dt>‘<samp>frame-parallel</samp>’</dt>
- <dd><p>Enable frame parallel decodability features.
- </p></dd>
- <dt>‘<samp>aq-mode</samp>’</dt>
- <dd><p>Set adaptive quantization mode (0: off (default), 1: variance 2: complexity, 3:
- cyclic refresh, 4: equator360).
- </p></dd>
- <dt>‘<samp>colorspace <em>color-space</em></samp>’</dt>
- <dd><p>Set input color space. The VP9 bitstream supports signaling the following
- colorspaces:
- </p><dl compact="compact">
- <dt>‘<samp>‘<samp>rgb</samp>’ <em>sRGB</em></samp>’</dt>
- <dt>‘<samp>‘<samp>bt709</samp>’ <em>bt709</em></samp>’</dt>
- <dt>‘<samp>‘<samp>unspecified</samp>’ <em>unknown</em></samp>’</dt>
- <dt>‘<samp>‘<samp>bt470bg</samp>’ <em>bt601</em></samp>’</dt>
- <dt>‘<samp>‘<samp>smpte170m</samp>’ <em>smpte170</em></samp>’</dt>
- <dt>‘<samp>‘<samp>smpte240m</samp>’ <em>smpte240</em></samp>’</dt>
- <dt>‘<samp>‘<samp>bt2020_ncl</samp>’ <em>bt2020</em></samp>’</dt>
- </dl>
- </dd>
- <dt>‘<samp>row-mt <var>boolean</var></samp>’</dt>
- <dd><p>Enable row based multi-threading.
- </p></dd>
- <dt>‘<samp>tune-content</samp>’</dt>
- <dd><p>Set content type: default (0), screen (1), film (2).
- </p></dd>
- <dt>‘<samp>corpus-complexity</samp>’</dt>
- <dd><p>Corpus VBR mode is a variant of standard VBR where the complexity distribution
- midpoint is passed in rather than calculated for a specific clip or chunk.
- </p>
- <p>The valid range is [0, 10000]. 0 (default) uses standard VBR.
- </p></dd>
- <dt>‘<samp>enable-tpl <var>boolean</var></samp>’</dt>
- <dd><p>Enable temporal dependency model.
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <p>For more information about libvpx see:
- <a href="http://www.webmproject.org/">http://www.webmproject.org/</a>
- </p>
- <a name="libwebp"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libwebp">9.9 libwebp</a></h2>
-
- <p>libwebp WebP Image encoder wrapper
- </p>
- <p>libwebp is Google’s official encoder for WebP images. It can encode in either
- lossy or lossless mode. Lossy images are essentially a wrapper around a VP8
- frame. Lossless images are a separate codec developed by Google.
- </p>
- <a name="Pixel-Format"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Pixel-Format">9.9.1 Pixel Format</a></h3>
-
- <p>Currently, libwebp only supports YUV420 for lossy and RGB for lossless due
- to limitations of the format and libwebp. Alpha is supported for either mode.
- Because of API limitations, if RGB is passed in when encoding lossy or YUV is
- passed in for encoding lossless, the pixel format will automatically be
- converted using functions from libwebp. This is not ideal and is done only for
- convenience.
- </p>
- <a name="Options-13"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-13">9.9.2 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>-lossless <var>boolean</var></samp>’</dt>
- <dd><p>Enables/Disables use of lossless mode. Default is 0.
- </p>
- </dd>
- <dt>‘<samp>-compression_level <var>integer</var></samp>’</dt>
- <dd><p>For lossy, this is a quality/speed tradeoff. Higher values give better quality
- for a given size at the cost of increased encoding time. For lossless, this is
- a size/speed tradeoff. Higher values give smaller size at the cost of increased
- encoding time. More specifically, it controls the number of extra algorithms
- and compression tools used, and varies the combination of these tools. This
- maps to the <var>method</var> option in libwebp. The valid range is 0 to 6.
- Default is 4.
- </p>
- </dd>
- <dt>‘<samp>-qscale <var>float</var></samp>’</dt>
- <dd><p>For lossy encoding, this controls image quality, 0 to 100. For lossless
- encoding, this controls the effort and time spent at compressing more. The
- default value is 75. Note that for usage via libavcodec, this option is called
- <var>global_quality</var> and must be multiplied by <var>FF_QP2LAMBDA</var>.
- </p>
- </dd>
- <dt>‘<samp>-preset <var>type</var></samp>’</dt>
- <dd><p>Configuration preset. This does some automatic settings based on the general
- type of the image.
- </p><dl compact="compact">
- <dt>‘<samp>none</samp>’</dt>
- <dd><p>Do not use a preset.
- </p></dd>
- <dt>‘<samp>default</samp>’</dt>
- <dd><p>Use the encoder default.
- </p></dd>
- <dt>‘<samp>picture</samp>’</dt>
- <dd><p>Digital picture, like portrait, inner shot
- </p></dd>
- <dt>‘<samp>photo</samp>’</dt>
- <dd><p>Outdoor photograph, with natural lighting
- </p></dd>
- <dt>‘<samp>drawing</samp>’</dt>
- <dd><p>Hand or line drawing, with high-contrast details
- </p></dd>
- <dt>‘<samp>icon</samp>’</dt>
- <dd><p>Small-sized colorful images
- </p></dd>
- <dt>‘<samp>text</samp>’</dt>
- <dd><p>Text-like
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <a name="libx264_002c-libx264rgb"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libx264_002c-libx264rgb">9.10 libx264, libx264rgb</a></h2>
-
- <p>x264 H.264/MPEG-4 AVC encoder wrapper.
- </p>
- <p>This encoder requires the presence of the libx264 headers and library
- during configuration. You need to explicitly configure the build with
- <code>--enable-libx264</code>.
- </p>
- <p>libx264 supports an impressive number of features, including 8x8 and
- 4x4 adaptive spatial transform, adaptive B-frame placement, CAVLC/CABAC
- entropy coding, interlacing (MBAFF), lossless mode, psy optimizations
- for detail retention (adaptive quantization, psy-RD, psy-trellis).
- </p>
- <p>Many libx264 encoder options are mapped to FFmpeg global codec
- options, while unique encoder options are provided through private
- options. Additionally the ‘<samp>x264opts</samp>’ and ‘<samp>x264-params</samp>’
- private options allows one to pass a list of key=value tuples as accepted
- by the libx264 <code>x264_param_parse</code> function.
- </p>
- <p>The x264 project website is at
- <a href="http://www.videolan.org/developers/x264.html">http://www.videolan.org/developers/x264.html</a>.
- </p>
- <p>The libx264rgb encoder is the same as libx264, except it accepts packed RGB
- pixel formats as input instead of YUV.
- </p>
- <a name="Supported-Pixel-Formats"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Supported-Pixel-Formats">9.10.1 Supported Pixel Formats</a></h3>
-
- <p>x264 supports 8- to 10-bit color spaces. The exact bit depth is controlled at
- x264’s configure time. FFmpeg only supports one bit depth in one particular
- build. In other words, it is not possible to build one FFmpeg with multiple
- versions of x264 with different bit depths.
- </p>
- <a name="Options-18"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-18">9.10.2 Options</a></h3>
-
- <p>The following options are supported by the libx264 wrapper. The
- <code>x264</code>-equivalent options or values are listed in parentheses
- for easy migration.
- </p>
- <p>To reduce the duplication of documentation, only the private options
- and some others requiring special attention are documented here. For
- the documentation of the undocumented generic options, see
- <a href="#codec_002doptions">the Codec Options chapter</a>.
- </p>
- <p>To get a more accurate and extensive documentation of the libx264
- options, invoke the command <code>x264 --fullhelp</code> or consult
- the libx264 documentation.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b (<em>bitrate</em>)</samp>’</dt>
- <dd><p>Set bitrate in bits/s. Note that FFmpeg’s ‘<samp>b</samp>’ option is
- expressed in bits/s, while <code>x264</code>’s ‘<samp>bitrate</samp>’ is in
- kilobits/s.
- </p>
- </dd>
- <dt>‘<samp>bf (<em>bframes</em>)</samp>’</dt>
- <dt>‘<samp>g (<em>keyint</em>)</samp>’</dt>
- <dt>‘<samp>qmin (<em>qpmin</em>)</samp>’</dt>
- <dd><p>Minimum quantizer scale.
- </p>
- </dd>
- <dt>‘<samp>qmax (<em>qpmax</em>)</samp>’</dt>
- <dd><p>Maximum quantizer scale.
- </p>
- </dd>
- <dt>‘<samp>qdiff (<em>qpstep</em>)</samp>’</dt>
- <dd><p>Maximum difference between quantizer scales.
- </p>
- </dd>
- <dt>‘<samp>qblur (<em>qblur</em>)</samp>’</dt>
- <dd><p>Quantizer curve blur
- </p>
- </dd>
- <dt>‘<samp>qcomp (<em>qcomp</em>)</samp>’</dt>
- <dd><p>Quantizer curve compression factor
- </p>
- </dd>
- <dt>‘<samp>refs (<em>ref</em>)</samp>’</dt>
- <dd><p>Number of reference frames each P-frame can use. The range is from <var>0-16</var>.
- </p>
- </dd>
- <dt>‘<samp>sc_threshold (<em>scenecut</em>)</samp>’</dt>
- <dd><p>Sets the threshold for the scene change detection.
- </p>
- </dd>
- <dt>‘<samp>trellis (<em>trellis</em>)</samp>’</dt>
- <dd><p>Performs Trellis quantization to increase efficiency. Enabled by default.
- </p>
- </dd>
- <dt>‘<samp>nr (<em>nr</em>)</samp>’</dt>
- <dt>‘<samp>me_range (<em>merange</em>)</samp>’</dt>
- <dd><p>Maximum range of the motion search in pixels.
- </p>
- </dd>
- <dt>‘<samp>me_method (<em>me</em>)</samp>’</dt>
- <dd><p>Set motion estimation method. Possible values in the decreasing order
- of speed:
- </p>
- <dl compact="compact">
- <dt>‘<samp>dia (<em>dia</em>)</samp>’</dt>
- <dt>‘<samp>epzs (<em>dia</em>)</samp>’</dt>
- <dd><p>Diamond search with radius 1 (fastest). ‘<samp>epzs</samp>’ is an alias for
- ‘<samp>dia</samp>’.
- </p></dd>
- <dt>‘<samp>hex (<em>hex</em>)</samp>’</dt>
- <dd><p>Hexagonal search with radius 2.
- </p></dd>
- <dt>‘<samp>umh (<em>umh</em>)</samp>’</dt>
- <dd><p>Uneven multi-hexagon search.
- </p></dd>
- <dt>‘<samp>esa (<em>esa</em>)</samp>’</dt>
- <dd><p>Exhaustive search.
- </p></dd>
- <dt>‘<samp>tesa (<em>tesa</em>)</samp>’</dt>
- <dd><p>Hadamard exhaustive search (slowest).
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>forced-idr</samp>’</dt>
- <dd><p>Normally, when forcing a I-frame type, the encoder can select any type
- of I-frame. This option forces it to choose an IDR-frame.
- </p>
- </dd>
- <dt>‘<samp>subq (<em>subme</em>)</samp>’</dt>
- <dd><p>Sub-pixel motion estimation method.
- </p>
- </dd>
- <dt>‘<samp>b_strategy (<em>b-adapt</em>)</samp>’</dt>
- <dd><p>Adaptive B-frame placement decision algorithm. Use only on first-pass.
- </p>
- </dd>
- <dt>‘<samp>keyint_min (<em>min-keyint</em>)</samp>’</dt>
- <dd><p>Minimum GOP size.
- </p>
- </dd>
- <dt>‘<samp>coder</samp>’</dt>
- <dd><p>Set entropy encoder. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>ac</samp>’</dt>
- <dd><p>Enable CABAC.
- </p>
- </dd>
- <dt>‘<samp>vlc</samp>’</dt>
- <dd><p>Enable CAVLC and disable CABAC. It generates the same effect as
- <code>x264</code>’s ‘<samp>--no-cabac</samp>’ option.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>cmp</samp>’</dt>
- <dd><p>Set full pixel motion estimation comparison algorithm. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>chroma</samp>’</dt>
- <dd><p>Enable chroma in motion estimation.
- </p>
- </dd>
- <dt>‘<samp>sad</samp>’</dt>
- <dd><p>Ignore chroma in motion estimation. It generates the same effect as
- <code>x264</code>’s ‘<samp>--no-chroma-me</samp>’ option.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>threads (<em>threads</em>)</samp>’</dt>
- <dd><p>Number of encoding threads.
- </p>
- </dd>
- <dt>‘<samp>thread_type</samp>’</dt>
- <dd><p>Set multithreading technique. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>slice</samp>’</dt>
- <dd><p>Slice-based multithreading. It generates the same effect as
- <code>x264</code>’s ‘<samp>--sliced-threads</samp>’ option.
- </p></dd>
- <dt>‘<samp>frame</samp>’</dt>
- <dd><p>Frame-based multithreading.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>flags</samp>’</dt>
- <dd><p>Set encoding flags. It can be used to disable closed GOP and enable
- open GOP by setting it to <code>-cgop</code>. The result is similar to
- the behavior of <code>x264</code>’s ‘<samp>--open-gop</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>rc_init_occupancy (<em>vbv-init</em>)</samp>’</dt>
- <dt>‘<samp>preset (<em>preset</em>)</samp>’</dt>
- <dd><p>Set the encoding preset.
- </p>
- </dd>
- <dt>‘<samp>tune (<em>tune</em>)</samp>’</dt>
- <dd><p>Set tuning of the encoding params.
- </p>
- </dd>
- <dt>‘<samp>profile (<em>profile</em>)</samp>’</dt>
- <dd><p>Set profile restrictions.
- </p>
- </dd>
- <dt>‘<samp>fastfirstpass</samp>’</dt>
- <dd><p>Enable fast settings when encoding first pass, when set to 1. When set
- to 0, it has the same effect of <code>x264</code>’s
- ‘<samp>--slow-firstpass</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>crf (<em>crf</em>)</samp>’</dt>
- <dd><p>Set the quality for constant quality mode.
- </p>
- </dd>
- <dt>‘<samp>crf_max (<em>crf-max</em>)</samp>’</dt>
- <dd><p>In CRF mode, prevents VBV from lowering quality beyond this point.
- </p>
- </dd>
- <dt>‘<samp>qp (<em>qp</em>)</samp>’</dt>
- <dd><p>Set constant quantization rate control method parameter.
- </p>
- </dd>
- <dt>‘<samp>aq-mode (<em>aq-mode</em>)</samp>’</dt>
- <dd><p>Set AQ method. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>0</em>)</samp>’</dt>
- <dd><p>Disabled.
- </p>
- </dd>
- <dt>‘<samp>variance (<em>1</em>)</samp>’</dt>
- <dd><p>Variance AQ (complexity mask).
- </p>
- </dd>
- <dt>‘<samp>autovariance (<em>2</em>)</samp>’</dt>
- <dd><p>Auto-variance AQ (experimental).
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>aq-strength (<em>aq-strength</em>)</samp>’</dt>
- <dd><p>Set AQ strength, reduce blocking and blurring in flat and textured areas.
- </p>
- </dd>
- <dt>‘<samp>psy</samp>’</dt>
- <dd><p>Use psychovisual optimizations when set to 1. When set to 0, it has the
- same effect as <code>x264</code>’s ‘<samp>--no-psy</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>psy-rd (<em>psy-rd</em>)</samp>’</dt>
- <dd><p>Set strength of psychovisual optimization, in
- <var>psy-rd</var>:<var>psy-trellis</var> format.
- </p>
- </dd>
- <dt>‘<samp>rc-lookahead (<em>rc-lookahead</em>)</samp>’</dt>
- <dd><p>Set number of frames to look ahead for frametype and ratecontrol.
- </p>
- </dd>
- <dt>‘<samp>weightb</samp>’</dt>
- <dd><p>Enable weighted prediction for B-frames when set to 1. When set to 0,
- it has the same effect as <code>x264</code>’s ‘<samp>--no-weightb</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>weightp (<em>weightp</em>)</samp>’</dt>
- <dd><p>Set weighted prediction method for P-frames. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>0</em>)</samp>’</dt>
- <dd><p>Disabled
- </p></dd>
- <dt>‘<samp>simple (<em>1</em>)</samp>’</dt>
- <dd><p>Enable only weighted refs
- </p></dd>
- <dt>‘<samp>smart (<em>2</em>)</samp>’</dt>
- <dd><p>Enable both weighted refs and duplicates
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>ssim (<em>ssim</em>)</samp>’</dt>
- <dd><p>Enable calculation and printing SSIM stats after the encoding.
- </p>
- </dd>
- <dt>‘<samp>intra-refresh (<em>intra-refresh</em>)</samp>’</dt>
- <dd><p>Enable the use of Periodic Intra Refresh instead of IDR frames when set
- to 1.
- </p>
- </dd>
- <dt>‘<samp>avcintra-class (<em>class</em>)</samp>’</dt>
- <dd><p>Configure the encoder to generate AVC-Intra.
- Valid values are 50,100 and 200
- </p>
- </dd>
- <dt>‘<samp>bluray-compat (<em>bluray-compat</em>)</samp>’</dt>
- <dd><p>Configure the encoder to be compatible with the bluray standard.
- It is a shorthand for setting "bluray-compat=1 force-cfr=1".
- </p>
- </dd>
- <dt>‘<samp>b-bias (<em>b-bias</em>)</samp>’</dt>
- <dd><p>Set the influence on how often B-frames are used.
- </p>
- </dd>
- <dt>‘<samp>b-pyramid (<em>b-pyramid</em>)</samp>’</dt>
- <dd><p>Set method for keeping of some B-frames as references. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>none</em>)</samp>’</dt>
- <dd><p>Disabled.
- </p></dd>
- <dt>‘<samp>strict (<em>strict</em>)</samp>’</dt>
- <dd><p>Strictly hierarchical pyramid.
- </p></dd>
- <dt>‘<samp>normal (<em>normal</em>)</samp>’</dt>
- <dd><p>Non-strict (not Blu-ray compatible).
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>mixed-refs</samp>’</dt>
- <dd><p>Enable the use of one reference per partition, as opposed to one
- reference per macroblock when set to 1. When set to 0, it has the
- same effect as <code>x264</code>’s ‘<samp>--no-mixed-refs</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>8x8dct</samp>’</dt>
- <dd><p>Enable adaptive spatial transform (high profile 8x8 transform)
- when set to 1. When set to 0, it has the same effect as
- <code>x264</code>’s ‘<samp>--no-8x8dct</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>fast-pskip</samp>’</dt>
- <dd><p>Enable early SKIP detection on P-frames when set to 1. When set
- to 0, it has the same effect as <code>x264</code>’s
- ‘<samp>--no-fast-pskip</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>aud (<em>aud</em>)</samp>’</dt>
- <dd><p>Enable use of access unit delimiters when set to 1.
- </p>
- </dd>
- <dt>‘<samp>mbtree</samp>’</dt>
- <dd><p>Enable use macroblock tree ratecontrol when set to 1. When set
- to 0, it has the same effect as <code>x264</code>’s
- ‘<samp>--no-mbtree</samp>’ option.
- </p>
- </dd>
- <dt>‘<samp>deblock (<em>deblock</em>)</samp>’</dt>
- <dd><p>Set loop filter parameters, in <var>alpha</var>:<var>beta</var> form.
- </p>
- </dd>
- <dt>‘<samp>cplxblur (<em>cplxblur</em>)</samp>’</dt>
- <dd><p>Set fluctuations reduction in QP (before curve compression).
- </p>
- </dd>
- <dt>‘<samp>partitions (<em>partitions</em>)</samp>’</dt>
- <dd><p>Set partitions to consider as a comma-separated list of. Possible
- values in the list:
- </p>
- <dl compact="compact">
- <dt>‘<samp>p8x8</samp>’</dt>
- <dd><p>8x8 P-frame partition.
- </p></dd>
- <dt>‘<samp>p4x4</samp>’</dt>
- <dd><p>4x4 P-frame partition.
- </p></dd>
- <dt>‘<samp>b8x8</samp>’</dt>
- <dd><p>4x4 B-frame partition.
- </p></dd>
- <dt>‘<samp>i8x8</samp>’</dt>
- <dd><p>8x8 I-frame partition.
- </p></dd>
- <dt>‘<samp>i4x4</samp>’</dt>
- <dd><p>4x4 I-frame partition.
- (Enabling ‘<samp>p4x4</samp>’ requires ‘<samp>p8x8</samp>’ to be enabled. Enabling
- ‘<samp>i8x8</samp>’ requires adaptive spatial transform (‘<samp>8x8dct</samp>’
- option) to be enabled.)
- </p></dd>
- <dt>‘<samp>none (<em>none</em>)</samp>’</dt>
- <dd><p>Do not consider any partitions.
- </p></dd>
- <dt>‘<samp>all (<em>all</em>)</samp>’</dt>
- <dd><p>Consider every partition.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>direct-pred (<em>direct</em>)</samp>’</dt>
- <dd><p>Set direct MV prediction mode. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>none</em>)</samp>’</dt>
- <dd><p>Disable MV prediction.
- </p></dd>
- <dt>‘<samp>spatial (<em>spatial</em>)</samp>’</dt>
- <dd><p>Enable spatial predicting.
- </p></dd>
- <dt>‘<samp>temporal (<em>temporal</em>)</samp>’</dt>
- <dd><p>Enable temporal predicting.
- </p></dd>
- <dt>‘<samp>auto (<em>auto</em>)</samp>’</dt>
- <dd><p>Automatically decided.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>slice-max-size (<em>slice-max-size</em>)</samp>’</dt>
- <dd><p>Set the limit of the size of each slice in bytes. If not specified
- but RTP payload size (‘<samp>ps</samp>’) is specified, that is used.
- </p>
- </dd>
- <dt>‘<samp>stats (<em>stats</em>)</samp>’</dt>
- <dd><p>Set the file name for multi-pass stats.
- </p>
- </dd>
- <dt>‘<samp>nal-hrd (<em>nal-hrd</em>)</samp>’</dt>
- <dd><p>Set signal HRD information (requires ‘<samp>vbv-bufsize</samp>’ to be set).
- Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>none (<em>none</em>)</samp>’</dt>
- <dd><p>Disable HRD information signaling.
- </p></dd>
- <dt>‘<samp>vbr (<em>vbr</em>)</samp>’</dt>
- <dd><p>Variable bit rate.
- </p></dd>
- <dt>‘<samp>cbr (<em>cbr</em>)</samp>’</dt>
- <dd><p>Constant bit rate (not allowed in MP4 container).
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>x264opts (N.A.)</samp>’</dt>
- <dd><p>Set any x264 option, see <code>x264 --fullhelp</code> for a list.
- </p>
- <p>Argument is a list of <var>key</var>=<var>value</var> couples separated by
- ":". In <var>filter</var> and <var>psy-rd</var> options that use ":" as a separator
- themselves, use "," instead. They accept it as well since long ago but this
- is kept undocumented for some reason.
- </p>
- <p>For example to specify libx264 encoding options with <code>ffmpeg</code>:
- </p><div class="example">
- <pre class="example">ffmpeg -i foo.mpg -c:v libx264 -x264opts keyint=123:min-keyint=20 -an out.mkv
- </pre></div>
-
- </dd>
- <dt>‘<samp>a53cc <var>boolean</var></samp>’</dt>
- <dd><p>Import closed captions (which must be ATSC compatible format) into output.
- Only the mpeg2 and h264 decoders provide these. Default is 1 (on).
- </p>
- </dd>
- <dt>‘<samp>x264-params (N.A.)</samp>’</dt>
- <dd><p>Override the x264 configuration using a :-separated list of key=value
- parameters.
- </p>
- <p>This option is functionally the same as the ‘<samp>x264opts</samp>’, but is
- duplicated for compatibility with the Libav fork.
- </p>
- <p>For example to specify libx264 encoding options with <code>ffmpeg</code>:
- </p><div class="example">
- <pre class="example">ffmpeg -i INPUT -c:v libx264 -x264-params level=30:bframes=0:weightp=0:\
- cabac=0:ref=1:vbv-maxrate=768:vbv-bufsize=2000:analyse=all:me=umh:\
- no-fast-pskip=1:subq=6:8x8dct=0:trellis=0 OUTPUT
- </pre></div>
- </dd>
- </dl>
-
- <p>Encoding ffpresets for common usages are provided so they can be used with the
- general presets system (e.g. passing the ‘<samp>pre</samp>’ option).
- </p>
- <a name="libx265"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libx265">9.11 libx265</a></h2>
-
- <p>x265 H.265/HEVC encoder wrapper.
- </p>
- <p>This encoder requires the presence of the libx265 headers and library
- during configuration. You need to explicitly configure the build with
- ‘<samp>--enable-libx265</samp>’.
- </p>
- <a name="Options-26"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-26">9.11.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Sets target video bitrate.
- </p>
- </dd>
- <dt>‘<samp>bf</samp>’</dt>
- <dt>‘<samp>g</samp>’</dt>
- <dd><p>Set the GOP size.
- </p>
- </dd>
- <dt>‘<samp>keyint_min</samp>’</dt>
- <dd><p>Minimum GOP size.
- </p>
- </dd>
- <dt>‘<samp>refs</samp>’</dt>
- <dd><p>Number of reference frames each P-frame can use. The range is from <var>1-16</var>.
- </p>
- </dd>
- <dt>‘<samp>preset</samp>’</dt>
- <dd><p>Set the x265 preset.
- </p>
- </dd>
- <dt>‘<samp>tune</samp>’</dt>
- <dd><p>Set the x265 tune parameter.
- </p>
- </dd>
- <dt>‘<samp>profile</samp>’</dt>
- <dd><p>Set profile restrictions.
- </p>
- </dd>
- <dt>‘<samp>crf</samp>’</dt>
- <dd><p>Set the quality for constant quality mode.
- </p>
- </dd>
- <dt>‘<samp>qp</samp>’</dt>
- <dd><p>Set constant quantization rate control method parameter.
- </p>
- </dd>
- <dt>‘<samp>qmin</samp>’</dt>
- <dd><p>Minimum quantizer scale.
- </p>
- </dd>
- <dt>‘<samp>qmax</samp>’</dt>
- <dd><p>Maximum quantizer scale.
- </p>
- </dd>
- <dt>‘<samp>qdiff</samp>’</dt>
- <dd><p>Maximum difference between quantizer scales.
- </p>
- </dd>
- <dt>‘<samp>qblur</samp>’</dt>
- <dd><p>Quantizer curve blur
- </p>
- </dd>
- <dt>‘<samp>qcomp</samp>’</dt>
- <dd><p>Quantizer curve compression factor
- </p>
- </dd>
- <dt>‘<samp>i_qfactor</samp>’</dt>
- <dt>‘<samp>b_qfactor</samp>’</dt>
- <dt>‘<samp>forced-idr</samp>’</dt>
- <dd><p>Normally, when forcing a I-frame type, the encoder can select any type
- of I-frame. This option forces it to choose an IDR-frame.
- </p>
- </dd>
- <dt>‘<samp>x265-params</samp>’</dt>
- <dd><p>Set x265 options using a list of <var>key</var>=<var>value</var> couples separated
- by ":". See <code>x265 --help</code> for a list of options.
- </p>
- <p>For example to specify libx265 encoding options with ‘<samp>-x265-params</samp>’:
- </p>
- <div class="example">
- <pre class="example">ffmpeg -i input -c:v libx265 -x265-params crf=26:psy-rd=1 output.mp4
- </pre></div>
- </dd>
- </dl>
-
- <a name="libxavs2"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libxavs2">9.12 libxavs2</a></h2>
-
- <p>xavs2 AVS2-P2/IEEE1857.4 encoder wrapper.
- </p>
- <p>This encoder requires the presence of the libxavs2 headers and library
- during configuration. You need to explicitly configure the build with
- ‘<samp>--enable-libxavs2</samp>’.
- </p>
- <p>The following standard libavcodec options are used:
- </p><ul>
- <li>
- ‘<samp>b</samp>’ / ‘<samp>bit_rate</samp>’
- </li><li>
- ‘<samp>g</samp>’ / ‘<samp>gop_size</samp>’
- </li><li>
- ‘<samp>bf</samp>’ / ‘<samp>max_b_frames</samp>’
- </li></ul>
-
- <p>The encoder also has its own specific options:
- </p><a name="Options-11"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-11">9.12.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>lcu_row_threads</samp>’</dt>
- <dd><p>Set the number of parallel threads for rows from 1 to 8 (default 5).
- </p>
- </dd>
- <dt>‘<samp>initial_qp</samp>’</dt>
- <dd><p>Set the xavs2 quantization parameter from 1 to 63 (default 34). This is
- used to set the initial qp for the first frame.
- </p>
- </dd>
- <dt>‘<samp>qp</samp>’</dt>
- <dd><p>Set the xavs2 quantization parameter from 1 to 63 (default 34). This is
- used to set the qp value under constant-QP mode.
- </p>
- </dd>
- <dt>‘<samp>max_qp</samp>’</dt>
- <dd><p>Set the max qp for rate control from 1 to 63 (default 55).
- </p>
- </dd>
- <dt>‘<samp>min_qp</samp>’</dt>
- <dd><p>Set the min qp for rate control from 1 to 63 (default 20).
- </p>
- </dd>
- <dt>‘<samp>speed_level</samp>’</dt>
- <dd><p>Set the Speed level from 0 to 9 (default 0). Higher is better but slower.
- </p>
- </dd>
- <dt>‘<samp>log_level</samp>’</dt>
- <dd><p>Set the log level from -1 to 3 (default 0). -1: none, 0: error,
- 1: warning, 2: info, 3: debug.
- </p>
- </dd>
- <dt>‘<samp>xavs2-params</samp>’</dt>
- <dd><p>Set xavs2 options using a list of <var>key</var>=<var>value</var> couples separated
- by ":".
- </p>
- <p>For example to specify libxavs2 encoding options with ‘<samp>-xavs2-params</samp>’:
- </p>
- <div class="example">
- <pre class="example">ffmpeg -i input -c:v libxavs2 -xavs2-params RdoqLevel=0 output.avs2
- </pre></div>
- </dd>
- </dl>
-
- <a name="libxvid"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-libxvid">9.13 libxvid</a></h2>
-
- <p>Xvid MPEG-4 Part 2 encoder wrapper.
- </p>
- <p>This encoder requires the presence of the libxvidcore headers and library
- during configuration. You need to explicitly configure the build with
- <code>--enable-libxvid --enable-gpl</code>.
- </p>
- <p>The native <code>mpeg4</code> encoder supports the MPEG-4 Part 2 format, so
- users can encode to this format without this library.
- </p>
- <a name="Options-3"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-3">9.13.1 Options</a></h3>
-
- <p>The following options are supported by the libxvid wrapper. Some of
- the following options are listed but are not documented, and
- correspond to shared codec options. See <a href="#codec_002doptions">the Codec Options chapter</a> for their documentation. The other shared options
- which are not listed have no effect for the libxvid encoder.
- </p>
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dt>‘<samp>g</samp>’</dt>
- <dt>‘<samp>qmin</samp>’</dt>
- <dt>‘<samp>qmax</samp>’</dt>
- <dt>‘<samp>mpeg_quant</samp>’</dt>
- <dt>‘<samp>threads</samp>’</dt>
- <dt>‘<samp>bf</samp>’</dt>
- <dt>‘<samp>b_qfactor</samp>’</dt>
- <dt>‘<samp>b_qoffset</samp>’</dt>
- <dt>‘<samp>flags</samp>’</dt>
- <dd><p>Set specific encoding flags. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>mv4</samp>’</dt>
- <dd><p>Use four motion vector by macroblock.
- </p>
- </dd>
- <dt>‘<samp>aic</samp>’</dt>
- <dd><p>Enable high quality AC prediction.
- </p>
- </dd>
- <dt>‘<samp>gray</samp>’</dt>
- <dd><p>Only encode grayscale.
- </p>
- </dd>
- <dt>‘<samp>gmc</samp>’</dt>
- <dd><p>Enable the use of global motion compensation (GMC).
- </p>
- </dd>
- <dt>‘<samp>qpel</samp>’</dt>
- <dd><p>Enable quarter-pixel motion compensation.
- </p>
- </dd>
- <dt>‘<samp>cgop</samp>’</dt>
- <dd><p>Enable closed GOP.
- </p>
- </dd>
- <dt>‘<samp>global_header</samp>’</dt>
- <dd><p>Place global headers in extradata instead of every keyframe.
- </p>
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>trellis</samp>’</dt>
- <dt>‘<samp>me_method</samp>’</dt>
- <dd><p>Set motion estimation method. Possible values in decreasing order of
- speed and increasing order of quality:
- </p>
- <dl compact="compact">
- <dt>‘<samp>zero</samp>’</dt>
- <dd><p>Use no motion estimation (default).
- </p>
- </dd>
- <dt>‘<samp>phods</samp>’</dt>
- <dt>‘<samp>x1</samp>’</dt>
- <dt>‘<samp>log</samp>’</dt>
- <dd><p>Enable advanced diamond zonal search for 16x16 blocks and half-pixel
- refinement for 16x16 blocks. ‘<samp>x1</samp>’ and ‘<samp>log</samp>’ are aliases for
- ‘<samp>phods</samp>’.
- </p>
- </dd>
- <dt>‘<samp>epzs</samp>’</dt>
- <dd><p>Enable all of the things described above, plus advanced diamond zonal
- search for 8x8 blocks, half-pixel refinement for 8x8 blocks, and motion
- estimation on chroma planes.
- </p>
- </dd>
- <dt>‘<samp>full</samp>’</dt>
- <dd><p>Enable all of the things described above, plus extended 16x16 and 8x8
- blocks search.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>mbd</samp>’</dt>
- <dd><p>Set macroblock decision algorithm. Possible values in the increasing
- order of quality:
- </p>
- <dl compact="compact">
- <dt>‘<samp>simple</samp>’</dt>
- <dd><p>Use macroblock comparing function algorithm (default).
- </p>
- </dd>
- <dt>‘<samp>bits</samp>’</dt>
- <dd><p>Enable rate distortion-based half pixel and quarter pixel refinement for
- 16x16 blocks.
- </p>
- </dd>
- <dt>‘<samp>rd</samp>’</dt>
- <dd><p>Enable all of the things described above, plus rate distortion-based
- half pixel and quarter pixel refinement for 8x8 blocks, and rate
- distortion-based search using square pattern.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>lumi_aq</samp>’</dt>
- <dd><p>Enable lumi masking adaptive quantization when set to 1. Default is 0
- (disabled).
- </p>
- </dd>
- <dt>‘<samp>variance_aq</samp>’</dt>
- <dd><p>Enable variance adaptive quantization when set to 1. Default is 0
- (disabled).
- </p>
- <p>When combined with ‘<samp>lumi_aq</samp>’, the resulting quality will not
- be better than any of the two specified individually. In other
- words, the resulting quality will be the worse one of the two
- effects.
- </p>
- </dd>
- <dt>‘<samp>ssim</samp>’</dt>
- <dd><p>Set structural similarity (SSIM) displaying method. Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>off</samp>’</dt>
- <dd><p>Disable displaying of SSIM information.
- </p>
- </dd>
- <dt>‘<samp>avg</samp>’</dt>
- <dd><p>Output average SSIM at the end of encoding to stdout. The format of
- showing the average SSIM is:
- </p>
- <div class="example">
- <pre class="example">Average SSIM: %f
- </pre></div>
-
- <p>For users who are not familiar with C, %f means a float number, or
- a decimal (e.g. 0.939232).
- </p>
- </dd>
- <dt>‘<samp>frame</samp>’</dt>
- <dd><p>Output both per-frame SSIM data during encoding and average SSIM at
- the end of encoding to stdout. The format of per-frame information
- is:
- </p>
- <div class="example">
- <pre class="example"> SSIM: avg: %1.3f min: %1.3f max: %1.3f
- </pre></div>
-
- <p>For users who are not familiar with C, %1.3f means a float number
- rounded to 3 digits after the dot (e.g. 0.932).
- </p>
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>ssim_acc</samp>’</dt>
- <dd><p>Set SSIM accuracy. Valid options are integers within the range of
- 0-4, while 0 gives the most accurate result and 4 computes the
- fastest.
- </p>
- </dd>
- </dl>
-
- <a name="mpeg2"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-mpeg2">9.14 mpeg2</a></h2>
-
- <p>MPEG-2 video encoder.
- </p>
- <a name="Options-33"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-33">9.14.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>seq_disp_ext <var>integer</var></samp>’</dt>
- <dd><p>Specifies if the encoder should write a sequence_display_extension to the
- output.
- </p><dl compact="compact">
- <dt>‘<samp>-1</samp>’</dt>
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Decide automatically to write it or not (this is the default) by checking if
- the data to be written is different from the default or unspecified values.
- </p></dd>
- <dt>‘<samp>0</samp>’</dt>
- <dt>‘<samp>never</samp>’</dt>
- <dd><p>Never write it.
- </p></dd>
- <dt>‘<samp>1</samp>’</dt>
- <dt>‘<samp>always</samp>’</dt>
- <dd><p>Always write it.
- </p></dd>
- </dl>
- </dd>
- <dt>‘<samp>video_format <var>integer</var></samp>’</dt>
- <dd><p>Specifies the video_format written into the sequence display extension
- indicating the source of the video pictures. The default is ‘<samp>unspecified</samp>’,
- can be ‘<samp>component</samp>’, ‘<samp>pal</samp>’, ‘<samp>ntsc</samp>’, ‘<samp>secam</samp>’ or ‘<samp>mac</samp>’.
- For maximum compatibility, use ‘<samp>component</samp>’.
- </p></dd>
- <dt>‘<samp>a53cc <var>boolean</var></samp>’</dt>
- <dd><p>Import closed captions (which must be ATSC compatible format) into output.
- Default is 1 (on).
- </p></dd>
- </dl>
-
- <a name="png"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-png">9.15 png</a></h2>
-
- <p>PNG image encoder.
- </p>
- <a name="Private-options"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Private-options">9.15.1 Private options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>dpi <var>integer</var></samp>’</dt>
- <dd><p>Set physical density of pixels, in dots per inch, unset by default
- </p></dd>
- <dt>‘<samp>dpm <var>integer</var></samp>’</dt>
- <dd><p>Set physical density of pixels, in dots per meter, unset by default
- </p></dd>
- </dl>
-
- <a name="ProRes"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-ProRes">9.16 ProRes</a></h2>
-
- <p>Apple ProRes encoder.
- </p>
- <p>FFmpeg contains 2 ProRes encoders, the prores-aw and prores-ks encoder.
- The used encoder can be chosen with the <code>-vcodec</code> option.
- </p>
- <a name="Private-Options-for-prores_002dks"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Private-Options-for-prores_002dks">9.16.1 Private Options for prores-ks</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>profile <var>integer</var></samp>’</dt>
- <dd><p>Select the ProRes profile to encode
- </p><dl compact="compact">
- <dt>‘<samp>proxy</samp>’</dt>
- <dt>‘<samp>lt</samp>’</dt>
- <dt>‘<samp>standard</samp>’</dt>
- <dt>‘<samp>hq</samp>’</dt>
- <dt>‘<samp>4444</samp>’</dt>
- <dt>‘<samp>4444xq</samp>’</dt>
- </dl>
-
- </dd>
- <dt>‘<samp>quant_mat <var>integer</var></samp>’</dt>
- <dd><p>Select quantization matrix.
- </p><dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dt>‘<samp>default</samp>’</dt>
- <dt>‘<samp>proxy</samp>’</dt>
- <dt>‘<samp>lt</samp>’</dt>
- <dt>‘<samp>standard</samp>’</dt>
- <dt>‘<samp>hq</samp>’</dt>
- </dl>
- <p>If set to <var>auto</var>, the matrix matching the profile will be picked.
- If not set, the matrix providing the highest quality, <var>default</var>, will be
- picked.
- </p>
- </dd>
- <dt>‘<samp>bits_per_mb <var>integer</var></samp>’</dt>
- <dd><p>How many bits to allot for coding one macroblock. Different profiles use
- between 200 and 2400 bits per macroblock, the maximum is 8000.
- </p>
- </dd>
- <dt>‘<samp>mbs_per_slice <var>integer</var></samp>’</dt>
- <dd><p>Number of macroblocks in each slice (1-8); the default value (8)
- should be good in almost all situations.
- </p>
- </dd>
- <dt>‘<samp>vendor <var>string</var></samp>’</dt>
- <dd><p>Override the 4-byte vendor ID.
- A custom vendor ID like <var>apl0</var> would claim the stream was produced by
- the Apple encoder.
- </p>
- </dd>
- <dt>‘<samp>alpha_bits <var>integer</var></samp>’</dt>
- <dd><p>Specify number of bits for alpha component.
- Possible values are <var>0</var>, <var>8</var> and <var>16</var>.
- Use <var>0</var> to disable alpha plane coding.
- </p>
- </dd>
- </dl>
-
- <a name="Speed-considerations"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Speed-considerations">9.16.2 Speed considerations</a></h3>
-
- <p>In the default mode of operation the encoder has to honor frame constraints
- (i.e. not produce frames with size bigger than requested) while still making
- output picture as good as possible.
- A frame containing a lot of small details is harder to compress and the encoder
- would spend more time searching for appropriate quantizers for each slice.
- </p>
- <p>Setting a higher ‘<samp>bits_per_mb</samp>’ limit will improve the speed.
- </p>
- <p>For the fastest encoding speed set the ‘<samp>qscale</samp>’ parameter (4 is the
- recommended value) and do not set a size constraint.
- </p>
- <a name="QSV-encoders"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-QSV-encoders">9.17 QSV encoders</a></h2>
-
- <p>The family of Intel QuickSync Video encoders (MPEG-2, H.264, HEVC, JPEG/MJPEG and VP9)
- </p>
- <p>The ratecontrol method is selected as follows:
- </p>
- <ul>
- <li>
- When ‘<samp>global_quality</samp>’ is specified, a quality-based mode is used.
- Specifically this means either
- <ul class="no-bullet">
- <li>-
- <var>CQP</var> - constant quantizer scale, when the ‘<samp>qscale</samp>’ codec flag is
- also set (the ‘<samp>-qscale</samp>’ ffmpeg option).
-
- </li><li>-
- <var>LA_ICQ</var> - intelligent constant quality with lookahead, when the
- ‘<samp>look_ahead</samp>’ option is also set.
-
- </li><li>-
- <var>ICQ</var> – intelligent constant quality otherwise.
- </li></ul>
-
- </li><li>
- Otherwise, a bitrate-based mode is used. For all of those, you should specify at
- least the desired average bitrate with the ‘<samp>b</samp>’ option.
- <ul class="no-bullet">
- <li>-
- <var>LA</var> - VBR with lookahead, when the ‘<samp>look_ahead</samp>’ option is specified.
-
- </li><li>-
- <var>VCM</var> - video conferencing mode, when the ‘<samp>vcm</samp>’ option is set.
-
- </li><li>-
- <var>CBR</var> - constant bitrate, when ‘<samp>maxrate</samp>’ is specified and equal to
- the average bitrate.
-
- </li><li>-
- <var>VBR</var> - variable bitrate, when ‘<samp>maxrate</samp>’ is specified, but is higher
- than the average bitrate.
-
- </li><li>-
- <var>AVBR</var> - average VBR mode, when ‘<samp>maxrate</samp>’ is not specified. This mode
- is further configured by the ‘<samp>avbr_accuracy</samp>’ and
- ‘<samp>avbr_convergence</samp>’ options.
- </li></ul>
- </li></ul>
-
- <p>Note that depending on your system, a different mode than the one you specified
- may be selected by the encoder. Set the verbosity level to <var>verbose</var> or
- higher to see the actual settings used by the QSV runtime.
- </p>
- <p>Additional libavcodec global options are mapped to MSDK options as follows:
- </p>
- <ul>
- <li>
- ‘<samp>g/gop_size</samp>’ -> ‘<samp>GopPicSize</samp>’
-
- </li><li>
- ‘<samp>bf/max_b_frames</samp>’+1 -> ‘<samp>GopRefDist</samp>’
-
- </li><li>
- ‘<samp>rc_init_occupancy/rc_initial_buffer_occupancy</samp>’ ->
- ‘<samp>InitialDelayInKB</samp>’
-
- </li><li>
- ‘<samp>slices</samp>’ -> ‘<samp>NumSlice</samp>’
-
- </li><li>
- ‘<samp>refs</samp>’ -> ‘<samp>NumRefFrame</samp>’
-
- </li><li>
- ‘<samp>b_strategy/b_frame_strategy</samp>’ -> ‘<samp>BRefType</samp>’
-
- </li><li>
- ‘<samp>cgop/CLOSED_GOP</samp>’ codec flag -> ‘<samp>GopOptFlag</samp>’
-
- </li><li>
- For the <var>CQP</var> mode, the ‘<samp>i_qfactor/i_qoffset</samp>’ and
- ‘<samp>b_qfactor/b_qoffset</samp>’ set the difference between <var>QPP</var> and <var>QPI</var>,
- and <var>QPP</var> and <var>QPB</var> respectively.
-
- </li><li>
- Setting the ‘<samp>coder</samp>’ option to the value <var>vlc</var> will make the H.264
- encoder use CAVLC instead of CABAC.
-
- </li></ul>
-
- <a name="snow"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-snow">9.18 snow</a></h2>
-
- <a name="Options-2"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-2">9.18.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>iterative_dia_size</samp>’</dt>
- <dd><p>dia size for the iterative motion estimation
- </p></dd>
- </dl>
-
- <a name="VAAPI-encoders"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-VAAPI-encoders">9.19 VAAPI encoders</a></h2>
-
- <p>Wrappers for hardware encoders accessible via VAAPI.
- </p>
- <p>These encoders only accept input in VAAPI hardware surfaces. If you have input
- in software frames, use the ‘<samp>hwupload</samp>’ filter to upload them to the GPU.
- </p>
- <p>The following standard libavcodec options are used:
- </p><ul>
- <li>
- ‘<samp>g</samp>’ / ‘<samp>gop_size</samp>’
- </li><li>
- ‘<samp>bf</samp>’ / ‘<samp>max_b_frames</samp>’
- </li><li>
- ‘<samp>profile</samp>’
-
- <p>If not set, this will be determined automatically from the format of the input
- frames and the profiles supported by the driver.
- </p></li><li>
- ‘<samp>level</samp>’
- </li><li>
- ‘<samp>b</samp>’ / ‘<samp>bit_rate</samp>’
- </li><li>
- ‘<samp>maxrate</samp>’ / ‘<samp>rc_max_rate</samp>’
- </li><li>
- ‘<samp>bufsize</samp>’ / ‘<samp>rc_buffer_size</samp>’
- </li><li>
- ‘<samp>rc_init_occupancy</samp>’ / ‘<samp>rc_initial_buffer_occupancy</samp>’
- </li><li>
- ‘<samp>compression_level</samp>’
-
- <p>Speed / quality tradeoff: higher values are faster / worse quality.
- </p></li><li>
- ‘<samp>q</samp>’ / ‘<samp>global_quality</samp>’
-
- <p>Size / quality tradeoff: higher values are smaller / worse quality.
- </p></li><li>
- ‘<samp>qmin</samp>’
- </li><li>
- ‘<samp>qmax</samp>’
- </li><li>
- ‘<samp>i_qfactor</samp>’ / ‘<samp>i_quant_factor</samp>’
- </li><li>
- ‘<samp>i_qoffset</samp>’ / ‘<samp>i_quant_offset</samp>’
- </li><li>
- ‘<samp>b_qfactor</samp>’ / ‘<samp>b_quant_factor</samp>’
- </li><li>
- ‘<samp>b_qoffset</samp>’ / ‘<samp>b_quant_offset</samp>’
- </li><li>
- ‘<samp>slices</samp>’
- </li></ul>
-
- <p>All encoders support the following options:
- </p><dl compact="compact">
- <dt>‘<samp>low_power</samp>’</dt>
- <dd><p>Some drivers/platforms offer a second encoder for some codecs intended to use
- less power than the default encoder; setting this option will attempt to use
- that encoder. Note that it may support a reduced feature set, so some other
- options may not be available in this mode.
- </p>
- </dd>
- <dt>‘<samp>idr_interval</samp>’</dt>
- <dd><p>Set the number of normal intra frames between full-refresh (IDR) frames in
- open-GOP mode. The intra frames are still IRAPs, but will not include global
- headers and may have non-decodable leading pictures.
- </p>
- </dd>
- <dt>‘<samp>b_depth</samp>’</dt>
- <dd><p>Set the B-frame reference depth. When set to one (the default), all B-frames
- will refer only to P- or I-frames. When set to greater values multiple layers
- of B-frames will be present, frames in each layer only referring to frames in
- higher layers.
- </p>
- </dd>
- <dt>‘<samp>rc_mode</samp>’</dt>
- <dd><p>Set the rate control mode to use. A given driver may only support a subset of
- modes.
- </p>
- <p>Possible modes:
- </p><dl compact="compact">
- <dt>‘<samp>auto</samp>’</dt>
- <dd><p>Choose the mode automatically based on driver support and the other options.
- This is the default.
- </p></dd>
- <dt>‘<samp>CQP</samp>’</dt>
- <dd><p>Constant-quality.
- </p></dd>
- <dt>‘<samp>CBR</samp>’</dt>
- <dd><p>Constant-bitrate.
- </p></dd>
- <dt>‘<samp>VBR</samp>’</dt>
- <dd><p>Variable-bitrate.
- </p></dd>
- <dt>‘<samp>ICQ</samp>’</dt>
- <dd><p>Intelligent constant-quality.
- </p></dd>
- <dt>‘<samp>QVBR</samp>’</dt>
- <dd><p>Quality-defined variable-bitrate.
- </p></dd>
- <dt>‘<samp>AVBR</samp>’</dt>
- <dd><p>Average variable bitrate.
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- <p>Each encoder also has its own specific options:
- </p><dl compact="compact">
- <dt>‘<samp>h264_vaapi</samp>’</dt>
- <dd><p>‘<samp>profile</samp>’ sets the value of <em>profile_idc</em> and the <em>constraint_set*_flag</em>s.
- ‘<samp>level</samp>’ sets the value of <em>level_idc</em>.
- </p>
- <dl compact="compact">
- <dt>‘<samp>coder</samp>’</dt>
- <dd><p>Set entropy encoder (default is <em>cabac</em>). Possible values:
- </p>
- <dl compact="compact">
- <dt>‘<samp>ac</samp>’</dt>
- <dt>‘<samp>cabac</samp>’</dt>
- <dd><p>Use CABAC.
- </p>
- </dd>
- <dt>‘<samp>vlc</samp>’</dt>
- <dt>‘<samp>cavlc</samp>’</dt>
- <dd><p>Use CAVLC.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>aud</samp>’</dt>
- <dd><p>Include access unit delimiters in the stream (not included by default).
- </p>
- </dd>
- <dt>‘<samp>sei</samp>’</dt>
- <dd><p>Set SEI message types to include.
- Some combination of the following values:
- </p><dl compact="compact">
- <dt>‘<samp>identifier</samp>’</dt>
- <dd><p>Include a <em>user_data_unregistered</em> message containing information about
- the encoder.
- </p></dd>
- <dt>‘<samp>timing</samp>’</dt>
- <dd><p>Include picture timing parameters (<em>buffering_period</em> and
- <em>pic_timing</em> messages).
- </p></dd>
- <dt>‘<samp>recovery_point</samp>’</dt>
- <dd><p>Include recovery points where appropriate (<em>recovery_point</em> messages).
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>hevc_vaapi</samp>’</dt>
- <dd><p>‘<samp>profile</samp>’ and ‘<samp>level</samp>’ set the values of
- <em>general_profile_idc</em> and <em>general_level_idc</em> respectively.
- </p>
- <dl compact="compact">
- <dt>‘<samp>aud</samp>’</dt>
- <dd><p>Include access unit delimiters in the stream (not included by default).
- </p>
- </dd>
- <dt>‘<samp>tier</samp>’</dt>
- <dd><p>Set <em>general_tier_flag</em>. This may affect the level chosen for the stream
- if it is not explicitly specified.
- </p>
- </dd>
- <dt>‘<samp>sei</samp>’</dt>
- <dd><p>Set SEI message types to include.
- Some combination of the following values:
- </p><dl compact="compact">
- <dt>‘<samp>hdr</samp>’</dt>
- <dd><p>Include HDR metadata if the input frames have it
- (<em>mastering_display_colour_volume</em> and <em>content_light_level</em>
- messages).
- </p></dd>
- </dl>
-
- </dd>
- </dl>
-
- </dd>
- <dt>‘<samp>mjpeg_vaapi</samp>’</dt>
- <dd><p>Only baseline DCT encoding is supported. The encoder always uses the standard
- quantisation and huffman tables - ‘<samp>global_quality</samp>’ scales the standard
- quantisation table (range 1-100).
- </p>
- <p>For YUV, 4:2:0, 4:2:2 and 4:4:4 subsampling modes are supported. RGB is also
- supported, and will create an RGB JPEG.
- </p>
- <dl compact="compact">
- <dt>‘<samp>jfif</samp>’</dt>
- <dd><p>Include JFIF header in each frame (not included by default).
- </p></dd>
- <dt>‘<samp>huffman</samp>’</dt>
- <dd><p>Include standard huffman tables (on by default). Turning this off will save
- a few hundred bytes in each output frame, but may lose compatibility with some
- JPEG decoders which don’t fully handle MJPEG.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>mpeg2_vaapi</samp>’</dt>
- <dd><p>‘<samp>profile</samp>’ and ‘<samp>level</samp>’ set the value of <em>profile_and_level_indication</em>.
- </p>
- </dd>
- <dt>‘<samp>vp8_vaapi</samp>’</dt>
- <dd><p>B-frames are not supported.
- </p>
- <p>‘<samp>global_quality</samp>’ sets the <em>q_idx</em> used for non-key frames (range 0-127).
- </p>
- <dl compact="compact">
- <dt>‘<samp>loop_filter_level</samp>’</dt>
- <dt>‘<samp>loop_filter_sharpness</samp>’</dt>
- <dd><p>Manually set the loop filter parameters.
- </p></dd>
- </dl>
-
- </dd>
- <dt>‘<samp>vp9_vaapi</samp>’</dt>
- <dd><p>‘<samp>global_quality</samp>’ sets the <em>q_idx</em> used for P-frames (range 0-255).
- </p>
- <dl compact="compact">
- <dt>‘<samp>loop_filter_level</samp>’</dt>
- <dt>‘<samp>loop_filter_sharpness</samp>’</dt>
- <dd><p>Manually set the loop filter parameters.
- </p></dd>
- </dl>
-
- <p>B-frames are supported, but the output stream is always in encode order rather than display
- order. If B-frames are enabled, it may be necessary to use the ‘<samp>vp9_raw_reorder</samp>’
- bitstream filter to modify the output stream to display frames in the correct order.
- </p>
- <p>Only normal frames are produced - the ‘<samp>vp9_superframe</samp>’ bitstream filter may be
- required to produce a stream usable with all decoders.
- </p>
- </dd>
- </dl>
-
- <a name="vc2"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-vc2">9.20 vc2</a></h2>
-
- <p>SMPTE VC-2 (previously BBC Dirac Pro). This codec was primarily aimed at
- professional broadcasting but since it supports yuv420, yuv422 and yuv444 at
- 8 (limited range or full range), 10 or 12 bits, this makes it suitable for
- other tasks which require low overhead and low compression (like screen
- recording).
- </p>
- <a name="Options-27"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-27">9.20.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>b</samp>’</dt>
- <dd><p>Sets target video bitrate. Usually that’s around 1:6 of the uncompressed
- video bitrate (e.g. for 1920x1080 50fps yuv422p10 that’s around 400Mbps). Higher
- values (close to the uncompressed bitrate) turn on lossless compression mode.
- </p>
- </dd>
- <dt>‘<samp>field_order</samp>’</dt>
- <dd><p>Enables field coding when set (e.g. to tt - top field first) for interlaced
- inputs. Should increase compression with interlaced content as it splits the
- fields and encodes each separately.
- </p>
- </dd>
- <dt>‘<samp>wavelet_depth</samp>’</dt>
- <dd><p>Sets the total amount of wavelet transforms to apply, between 1 and 5 (default).
- Lower values reduce compression and quality. Less capable decoders may not be
- able to handle values of ‘<samp>wavelet_depth</samp>’ over 3.
- </p>
- </dd>
- <dt>‘<samp>wavelet_type</samp>’</dt>
- <dd><p>Sets the transform type. Currently only <var>5_3</var> (LeGall) and <var>9_7</var>
- (Deslauriers-Dubuc)
- are implemented, with 9_7 being the one with better compression and thus
- is the default.
- </p>
- </dd>
- <dt>‘<samp>slice_width</samp>’</dt>
- <dt>‘<samp>slice_height</samp>’</dt>
- <dd><p>Sets the slice size for each slice. Larger values result in better compression.
- For compatibility with other more limited decoders use ‘<samp>slice_width</samp>’ of
- 32 and ‘<samp>slice_height</samp>’ of 8.
- </p>
- </dd>
- <dt>‘<samp>tolerance</samp>’</dt>
- <dd><p>Sets the undershoot tolerance of the rate control system in percent. This is
- to prevent an expensive search from being run.
- </p>
- </dd>
- <dt>‘<samp>qm</samp>’</dt>
- <dd><p>Sets the quantization matrix preset to use by default or when ‘<samp>wavelet_depth</samp>’
- is set to 5
- </p><ul class="no-bullet">
- <li>-
- <var>default</var>
- Uses the default quantization matrix from the specifications, extended with
- values for the fifth level. This provides a good balance between keeping detail
- and omitting artifacts.
-
- </li><li>-
- <var>flat</var>
- Use a completely zeroed out quantization matrix. This increases PSNR but might
- reduce perception. Use in bogus benchmarks.
-
- </li><li>-
- <var>color</var>
- Reduces detail but attempts to preserve color at extremely low bitrates.
- </li></ul>
-
- </dd>
- </dl>
-
-
- <a name="Subtitles-Encoders"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Subtitles-Encoders">10 Subtitles Encoders</a></h1>
-
- <a name="dvdsub-1"></a>
- <h2 class="section"><a href="ffmpeg-codecs.html#toc-dvdsub-1">10.1 dvdsub</a></h2>
-
- <p>This codec encodes the bitmap subtitle format that is used in DVDs.
- Typically they are stored in VOBSUB file pairs (*.idx + *.sub),
- and they can also be used in Matroska files.
- </p>
- <a name="Options-8"></a>
- <h3 class="subsection"><a href="ffmpeg-codecs.html#toc-Options-8">10.1.1 Options</a></h3>
-
- <dl compact="compact">
- <dt>‘<samp>palette</samp>’</dt>
- <dd><p>Specify the global palette used by the bitmaps.
- </p>
- <p>The format for this option is a string containing 16 24-bits hexadecimal
- numbers (without 0x prefix) separated by commas, for example <code>0d00ee,
- ee450d, 101010, eaeaea, 0ce60b, ec14ed, ebff0b, 0d617a, 7b7b7b, d1d1d1,
- 7b2a0e, 0d950c, 0f007b, cf0dec, cfa80c, 7c127b</code>.
- </p>
- </dd>
- <dt>‘<samp>even_rows_fix</samp>’</dt>
- <dd><p>When set to 1, enable a work-around that makes the number of pixel rows
- even in all subtitles. This fixes a problem with some players that
- cut off the bottom row if the number is odd. The work-around just adds
- a fully transparent row if needed. The overhead is low, typically
- one byte per subtitle on average.
- </p>
- <p>By default, this work-around is disabled.
- </p></dd>
- </dl>
-
-
- <a name="See-Also"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-See-Also">11 See Also</a></h1>
-
- <p><a href="ffmpeg.html">ffmpeg</a>, <a href="ffplay.html">ffplay</a>, <a href="ffprobe.html">ffprobe</a>,
- <a href="libavcodec.html">libavcodec</a>
- </p>
-
- <a name="Authors"></a>
- <h1 class="chapter"><a href="ffmpeg-codecs.html#toc-Authors">12 Authors</a></h1>
-
- <p>The FFmpeg developers.
- </p>
- <p>For details about the authorship, see the Git history of the project
- (git://source.ffmpeg.org/ffmpeg), e.g. by typing the command
- <code>git log</code> in the FFmpeg source directory, or browsing the
- online repository at <a href="http://source.ffmpeg.org">http://source.ffmpeg.org</a>.
- </p>
- <p>Maintainers for the specific components are listed in the file
- ‘<tt>MAINTAINERS</tt>’ in the source code tree.
- </p>
-
- </div>
- </body>
- </html>
|