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

ffplay-all.html 807KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327332833293330333133323333333433353336333733383339334033413342334333443345334633473348334933503351335233533354335533563357335833593360336133623363336433653366336733683369337033713372337333743375337633773378337933803381338233833384338533863387338833893390339133923393339433953396339733983399340034013402340334043405340634073408340934103411341234133414341534163417341834193420342134223423342434253426342734283429343034313432343334343435343634373438343934403441344234433444344534463447344834493450345134523453345434553456345734583459346034613462346334643465346634673468346934703471347234733474347534763477347834793480348134823483348434853486348734883489349034913492349334943495349634973498349935003501350235033504350535063507350835093510351135123513351435153516351735183519352035213522352335243525352635273528352935303531353235333534353535363537353835393540354135423543354435453546354735483549355035513552355335543555355635573558355935603561356235633564356535663567356835693570357135723573357435753576357735783579358035813582358335843585358635873588358935903591359235933594359535963597359835993600360136023603360436053606360736083609361036113612361336143615361636173618361936203621362236233624362536263627362836293630363136323633363436353636363736383639364036413642364336443645364636473648364936503651365236533654365536563657365836593660366136623663366436653666366736683669367036713672367336743675367636773678367936803681368236833684368536863687368836893690369136923693369436953696369736983699370037013702370337043705370637073708370937103711371237133714371537163717371837193720372137223723372437253726372737283729373037313732373337343735373637373738373937403741374237433744374537463747374837493750375137523753375437553756375737583759376037613762376337643765376637673768376937703771377237733774377537763777377837793780378137823783378437853786378737883789379037913792379337943795379637973798379938003801380238033804380538063807380838093810381138123813381438153816381738183819382038213822382338243825382638273828382938303831383238333834383538363837383838393840384138423843384438453846384738483849385038513852385338543855385638573858385938603861386238633864386538663867386838693870387138723873387438753876387738783879388038813882388338843885388638873888388938903891389238933894389538963897389838993900390139023903390439053906390739083909391039113912391339143915391639173918391939203921392239233924392539263927392839293930393139323933393439353936393739383939394039413942394339443945394639473948394939503951395239533954395539563957395839593960396139623963396439653966396739683969397039713972397339743975397639773978397939803981398239833984398539863987398839893990399139923993399439953996399739983999400040014002400340044005400640074008400940104011401240134014401540164017401840194020402140224023402440254026402740284029403040314032403340344035403640374038403940404041404240434044404540464047404840494050405140524053405440554056405740584059406040614062406340644065406640674068406940704071407240734074407540764077407840794080408140824083408440854086408740884089409040914092409340944095409640974098409941004101410241034104410541064107410841094110411141124113411441154116411741184119412041214122412341244125412641274128412941304131413241334134413541364137413841394140414141424143414441454146414741484149415041514152415341544155415641574158415941604161416241634164416541664167416841694170417141724173417441754176417741784179418041814182418341844185418641874188418941904191419241934194419541964197419841994200420142024203420442054206420742084209421042114212421342144215421642174218421942204221422242234224422542264227422842294230423142324233423442354236423742384239424042414242424342444245424642474248424942504251425242534254425542564257425842594260426142624263426442654266426742684269427042714272427342744275427642774278427942804281428242834284428542864287428842894290429142924293429442954296429742984299430043014302430343044305430643074308430943104311431243134314431543164317431843194320432143224323432443254326432743284329433043314332433343344335433643374338433943404341434243434344434543464347434843494350435143524353435443554356435743584359436043614362436343644365436643674368436943704371437243734374437543764377437843794380438143824383438443854386438743884389439043914392439343944395439643974398439944004401440244034404440544064407440844094410441144124413441444154416441744184419442044214422442344244425442644274428442944304431443244334434443544364437443844394440444144424443444444454446444744484449445044514452445344544455445644574458445944604461446244634464446544664467446844694470447144724473447444754476447744784479448044814482448344844485448644874488448944904491449244934494449544964497449844994500450145024503450445054506450745084509451045114512451345144515451645174518451945204521452245234524452545264527452845294530453145324533453445354536453745384539454045414542454345444545454645474548454945504551455245534554455545564557455845594560456145624563456445654566456745684569457045714572457345744575457645774578457945804581458245834584458545864587458845894590459145924593459445954596459745984599460046014602460346044605460646074608460946104611461246134614461546164617461846194620462146224623462446254626462746284629463046314632463346344635463646374638463946404641464246434644464546464647464846494650465146524653465446554656465746584659466046614662466346644665466646674668466946704671467246734674467546764677467846794680468146824683468446854686468746884689469046914692469346944695469646974698469947004701470247034704470547064707470847094710471147124713471447154716471747184719472047214722472347244725472647274728472947304731473247334734473547364737473847394740474147424743474447454746474747484749475047514752475347544755475647574758475947604761476247634764476547664767476847694770477147724773477447754776477747784779478047814782478347844785478647874788478947904791479247934794479547964797479847994800480148024803480448054806480748084809481048114812481348144815481648174818481948204821482248234824482548264827482848294830483148324833483448354836483748384839484048414842484348444845484648474848484948504851485248534854485548564857485848594860486148624863486448654866486748684869487048714872487348744875487648774878487948804881488248834884488548864887488848894890489148924893489448954896489748984899490049014902490349044905490649074908490949104911491249134914491549164917491849194920492149224923492449254926492749284929493049314932493349344935493649374938493949404941494249434944494549464947494849494950495149524953495449554956495749584959496049614962496349644965496649674968496949704971497249734974497549764977497849794980498149824983498449854986498749884989499049914992499349944995499649974998499950005001500250035004500550065007500850095010501150125013501450155016501750185019502050215022502350245025502650275028502950305031503250335034503550365037503850395040504150425043504450455046504750485049505050515052505350545055505650575058505950605061506250635064506550665067506850695070507150725073507450755076507750785079508050815082508350845085508650875088508950905091509250935094509550965097509850995100510151025103510451055106510751085109511051115112511351145115511651175118511951205121512251235124512551265127512851295130513151325133513451355136513751385139514051415142514351445145514651475148514951505151515251535154515551565157515851595160516151625163516451655166516751685169517051715172517351745175517651775178517951805181518251835184518551865187518851895190519151925193519451955196519751985199520052015202520352045205520652075208520952105211521252135214521552165217521852195220522152225223522452255226522752285229523052315232523352345235523652375238523952405241524252435244524552465247524852495250525152525253525452555256525752585259526052615262526352645265526652675268526952705271527252735274527552765277527852795280528152825283528452855286528752885289529052915292529352945295529652975298529953005301530253035304530553065307530853095310531153125313531453155316531753185319532053215322532353245325532653275328532953305331533253335334533553365337533853395340534153425343534453455346534753485349535053515352535353545355535653575358535953605361536253635364536553665367536853695370537153725373537453755376537753785379538053815382538353845385538653875388538953905391539253935394539553965397539853995400540154025403540454055406540754085409541054115412541354145415541654175418541954205421542254235424542554265427542854295430543154325433543454355436543754385439544054415442544354445445544654475448544954505451545254535454545554565457545854595460546154625463546454655466546754685469547054715472547354745475547654775478547954805481548254835484548554865487548854895490549154925493549454955496549754985499550055015502550355045505550655075508550955105511551255135514551555165517551855195520552155225523552455255526552755285529553055315532553355345535553655375538553955405541554255435544554555465547554855495550555155525553555455555556555755585559556055615562556355645565556655675568556955705571557255735574557555765577557855795580558155825583558455855586558755885589559055915592559355945595559655975598559956005601560256035604560556065607560856095610561156125613561456155616561756185619562056215622562356245625562656275628562956305631563256335634563556365637563856395640564156425643564456455646564756485649565056515652565356545655565656575658565956605661566256635664566556665667566856695670567156725673567456755676567756785679568056815682568356845685568656875688568956905691569256935694569556965697569856995700570157025703570457055706570757085709571057115712571357145715571657175718571957205721572257235724572557265727572857295730573157325733573457355736573757385739574057415742574357445745574657475748574957505751575257535754575557565757575857595760576157625763576457655766576757685769577057715772577357745775577657775778577957805781578257835784578557865787578857895790579157925793579457955796579757985799580058015802580358045805580658075808580958105811581258135814581558165817581858195820582158225823582458255826582758285829583058315832583358345835583658375838583958405841584258435844584558465847584858495850585158525853585458555856585758585859586058615862586358645865586658675868586958705871587258735874587558765877587858795880588158825883588458855886588758885889589058915892589358945895589658975898589959005901590259035904590559065907590859095910591159125913591459155916591759185919592059215922592359245925592659275928592959305931593259335934593559365937593859395940594159425943594459455946594759485949595059515952595359545955595659575958595959605961596259635964596559665967596859695970597159725973597459755976597759785979598059815982598359845985598659875988598959905991599259935994599559965997599859996000600160026003600460056006600760086009601060116012601360146015601660176018601960206021602260236024602560266027602860296030603160326033603460356036603760386039604060416042604360446045604660476048604960506051605260536054605560566057605860596060606160626063606460656066606760686069607060716072607360746075607660776078607960806081608260836084608560866087608860896090609160926093609460956096609760986099610061016102610361046105610661076108610961106111611261136114611561166117611861196120612161226123612461256126612761286129613061316132613361346135613661376138613961406141614261436144614561466147614861496150615161526153615461556156615761586159616061616162616361646165616661676168616961706171617261736174617561766177617861796180618161826183618461856186618761886189619061916192619361946195619661976198619962006201620262036204620562066207620862096210621162126213621462156216621762186219622062216222622362246225622662276228622962306231623262336234623562366237623862396240624162426243624462456246624762486249625062516252625362546255625662576258625962606261626262636264626562666267626862696270627162726273627462756276627762786279628062816282628362846285628662876288628962906291629262936294629562966297629862996300630163026303630463056306630763086309631063116312631363146315631663176318631963206321632263236324632563266327632863296330633163326333633463356336633763386339634063416342634363446345634663476348634963506351635263536354635563566357635863596360636163626363636463656366636763686369637063716372637363746375637663776378637963806381638263836384638563866387638863896390639163926393639463956396639763986399640064016402640364046405640664076408640964106411641264136414641564166417641864196420642164226423642464256426642764286429643064316432643364346435643664376438643964406441644264436444644564466447644864496450645164526453645464556456645764586459646064616462646364646465646664676468646964706471647264736474647564766477647864796480648164826483648464856486648764886489649064916492649364946495649664976498649965006501650265036504650565066507650865096510651165126513651465156516651765186519652065216522652365246525652665276528652965306531653265336534653565366537653865396540654165426543654465456546654765486549655065516552655365546555655665576558655965606561656265636564656565666567656865696570657165726573657465756576657765786579658065816582658365846585658665876588658965906591659265936594659565966597659865996600660166026603660466056606660766086609661066116612661366146615661666176618661966206621662266236624662566266627662866296630663166326633663466356636663766386639664066416642664366446645664666476648664966506651665266536654665566566657665866596660666166626663666466656666666766686669667066716672667366746675667666776678667966806681668266836684668566866687668866896690669166926693669466956696669766986699670067016702670367046705670667076708670967106711671267136714671567166717671867196720672167226723672467256726672767286729673067316732673367346735673667376738673967406741674267436744674567466747674867496750675167526753675467556756675767586759676067616762676367646765676667676768676967706771677267736774677567766777677867796780678167826783678467856786678767886789679067916792679367946795679667976798679968006801680268036804680568066807680868096810681168126813681468156816681768186819682068216822682368246825682668276828682968306831683268336834683568366837683868396840684168426843684468456846684768486849685068516852685368546855685668576858685968606861686268636864686568666867686868696870687168726873687468756876687768786879688068816882688368846885688668876888688968906891689268936894689568966897689868996900690169026903690469056906690769086909691069116912691369146915691669176918691969206921692269236924692569266927692869296930693169326933693469356936693769386939694069416942694369446945694669476948694969506951695269536954695569566957695869596960696169626963696469656966696769686969697069716972697369746975697669776978697969806981698269836984698569866987698869896990699169926993699469956996699769986999700070017002700370047005700670077008700970107011701270137014701570167017701870197020702170227023702470257026702770287029703070317032703370347035703670377038703970407041704270437044704570467047704870497050705170527053705470557056705770587059706070617062706370647065706670677068706970707071707270737074707570767077707870797080708170827083708470857086708770887089709070917092709370947095709670977098709971007101710271037104710571067107710871097110711171127113711471157116711771187119712071217122712371247125712671277128712971307131713271337134713571367137713871397140714171427143714471457146714771487149715071517152715371547155715671577158715971607161716271637164716571667167716871697170717171727173717471757176717771787179718071817182718371847185718671877188718971907191719271937194719571967197719871997200720172027203720472057206720772087209721072117212721372147215721672177218721972207221722272237224722572267227722872297230723172327233723472357236723772387239724072417242724372447245724672477248724972507251725272537254725572567257725872597260726172627263726472657266726772687269727072717272727372747275727672777278727972807281728272837284728572867287728872897290729172927293729472957296729772987299730073017302730373047305730673077308730973107311731273137314731573167317731873197320732173227323732473257326732773287329733073317332733373347335733673377338733973407341734273437344734573467347734873497350735173527353735473557356735773587359736073617362736373647365736673677368736973707371737273737374737573767377737873797380738173827383738473857386738773887389739073917392739373947395739673977398739974007401740274037404740574067407740874097410741174127413741474157416741774187419742074217422742374247425742674277428742974307431743274337434743574367437743874397440744174427443744474457446744774487449745074517452745374547455745674577458745974607461746274637464746574667467746874697470747174727473747474757476747774787479748074817482748374847485748674877488748974907491749274937494749574967497749874997500750175027503750475057506750775087509751075117512751375147515751675177518751975207521752275237524752575267527752875297530753175327533753475357536753775387539754075417542754375447545754675477548754975507551755275537554755575567557755875597560756175627563756475657566756775687569757075717572757375747575757675777578757975807581758275837584758575867587758875897590759175927593759475957596759775987599760076017602760376047605760676077608760976107611761276137614761576167617761876197620762176227623762476257626762776287629763076317632763376347635763676377638763976407641764276437644764576467647764876497650765176527653765476557656765776587659766076617662766376647665766676677668766976707671767276737674767576767677767876797680768176827683768476857686768776887689769076917692769376947695769676977698769977007701770277037704770577067707770877097710771177127713771477157716771777187719772077217722772377247725772677277728772977307731773277337734773577367737773877397740774177427743774477457746774777487749775077517752775377547755775677577758775977607761776277637764776577667767776877697770777177727773777477757776777777787779778077817782778377847785778677877788778977907791779277937794779577967797779877997800780178027803780478057806780778087809781078117812781378147815781678177818781978207821782278237824782578267827782878297830783178327833783478357836783778387839784078417842784378447845784678477848784978507851785278537854785578567857785878597860786178627863786478657866786778687869787078717872787378747875787678777878787978807881788278837884788578867887788878897890789178927893789478957896789778987899790079017902790379047905790679077908790979107911791279137914791579167917791879197920792179227923792479257926792779287929793079317932793379347935793679377938793979407941794279437944794579467947794879497950795179527953795479557956795779587959796079617962796379647965796679677968796979707971797279737974797579767977797879797980798179827983798479857986798779887989799079917992799379947995799679977998799980008001800280038004800580068007800880098010801180128013801480158016801780188019802080218022802380248025802680278028802980308031803280338034803580368037803880398040804180428043804480458046804780488049805080518052805380548055805680578058805980608061806280638064806580668067806880698070807180728073807480758076807780788079808080818082808380848085808680878088808980908091809280938094809580968097809880998100810181028103810481058106810781088109811081118112811381148115811681178118811981208121812281238124812581268127812881298130813181328133813481358136813781388139814081418142814381448145814681478148814981508151815281538154815581568157815881598160816181628163816481658166816781688169817081718172817381748175817681778178817981808181818281838184818581868187818881898190819181928193819481958196819781988199820082018202820382048205820682078208820982108211821282138214821582168217821882198220822182228223822482258226822782288229823082318232823382348235823682378238823982408241824282438244824582468247824882498250825182528253825482558256825782588259826082618262826382648265826682678268826982708271827282738274827582768277827882798280828182828283828482858286828782888289829082918292829382948295829682978298829983008301830283038304830583068307830883098310831183128313831483158316831783188319832083218322832383248325832683278328832983308331833283338334833583368337833883398340834183428343834483458346834783488349835083518352835383548355835683578358835983608361836283638364836583668367836883698370837183728373837483758376837783788379838083818382838383848385838683878388838983908391839283938394839583968397839883998400840184028403840484058406840784088409841084118412841384148415841684178418841984208421842284238424842584268427842884298430843184328433843484358436843784388439844084418442844384448445844684478448844984508451845284538454845584568457845884598460846184628463846484658466846784688469847084718472847384748475847684778478847984808481848284838484848584868487848884898490849184928493849484958496849784988499850085018502850385048505850685078508850985108511851285138514851585168517851885198520852185228523852485258526852785288529853085318532853385348535853685378538853985408541854285438544854585468547854885498550855185528553855485558556855785588559856085618562856385648565856685678568856985708571857285738574857585768577857885798580858185828583858485858586858785888589859085918592859385948595859685978598859986008601860286038604860586068607860886098610861186128613861486158616861786188619862086218622862386248625862686278628862986308631863286338634863586368637863886398640864186428643864486458646864786488649865086518652865386548655865686578658865986608661866286638664866586668667866886698670867186728673867486758676867786788679868086818682868386848685868686878688868986908691869286938694869586968697869886998700870187028703870487058706870787088709871087118712871387148715871687178718871987208721872287238724872587268727872887298730873187328733873487358736873787388739874087418742874387448745874687478748874987508751875287538754875587568757875887598760876187628763876487658766876787688769877087718772877387748775877687778778877987808781878287838784878587868787878887898790879187928793879487958796879787988799880088018802880388048805880688078808880988108811881288138814881588168817881888198820882188228823882488258826882788288829883088318832883388348835883688378838883988408841884288438844884588468847884888498850885188528853885488558856885788588859886088618862886388648865886688678868886988708871887288738874887588768877887888798880888188828883888488858886888788888889889088918892889388948895889688978898889989008901890289038904890589068907890889098910891189128913891489158916891789188919892089218922892389248925892689278928892989308931893289338934893589368937893889398940894189428943894489458946894789488949895089518952895389548955895689578958895989608961896289638964896589668967896889698970897189728973897489758976897789788979898089818982898389848985898689878988898989908991899289938994899589968997899889999000900190029003900490059006900790089009901090119012901390149015901690179018901990209021902290239024902590269027902890299030903190329033903490359036903790389039904090419042904390449045904690479048904990509051905290539054905590569057905890599060906190629063906490659066906790689069907090719072907390749075907690779078907990809081908290839084908590869087908890899090909190929093909490959096909790989099910091019102910391049105910691079108910991109111911291139114911591169117911891199120912191229123912491259126912791289129913091319132913391349135913691379138913991409141914291439144914591469147914891499150915191529153915491559156915791589159916091619162916391649165916691679168916991709171917291739174917591769177917891799180918191829183918491859186918791889189919091919192919391949195919691979198919992009201920292039204920592069207920892099210921192129213921492159216921792189219922092219222922392249225922692279228922992309231923292339234923592369237923892399240924192429243924492459246924792489249925092519252925392549255925692579258925992609261926292639264926592669267926892699270927192729273927492759276927792789279928092819282928392849285928692879288928992909291929292939294929592969297929892999300930193029303930493059306930793089309931093119312931393149315931693179318931993209321932293239324932593269327932893299330933193329333933493359336933793389339934093419342934393449345934693479348934993509351935293539354935593569357935893599360936193629363936493659366936793689369937093719372937393749375937693779378937993809381938293839384938593869387938893899390939193929393939493959396939793989399940094019402940394049405940694079408940994109411941294139414941594169417941894199420942194229423942494259426942794289429943094319432943394349435943694379438943994409441944294439444944594469447944894499450945194529453945494559456945794589459946094619462946394649465946694679468946994709471947294739474947594769477947894799480948194829483948494859486948794889489949094919492949394949495949694979498949995009501950295039504950595069507950895099510951195129513951495159516951795189519952095219522952395249525952695279528952995309531953295339534953595369537953895399540954195429543954495459546954795489549955095519552955395549555955695579558955995609561956295639564956595669567956895699570957195729573957495759576957795789579958095819582958395849585958695879588958995909591959295939594959595969597959895999600960196029603960496059606960796089609961096119612961396149615961696179618961996209621962296239624962596269627962896299630963196329633963496359636963796389639964096419642964396449645964696479648964996509651965296539654965596569657965896599660966196629663966496659666966796689669967096719672967396749675967696779678967996809681968296839684968596869687968896899690969196929693969496959696969796989699970097019702970397049705970697079708970997109711971297139714971597169717971897199720972197229723972497259726972797289729973097319732973397349735973697379738973997409741974297439744974597469747974897499750975197529753975497559756975797589759976097619762976397649765976697679768976997709771977297739774977597769777977897799780978197829783978497859786978797889789979097919792979397949795979697979798979998009801980298039804980598069807980898099810981198129813981498159816981798189819982098219822982398249825982698279828982998309831983298339834983598369837983898399840984198429843984498459846984798489849985098519852985398549855985698579858985998609861986298639864986598669867986898699870987198729873987498759876987798789879988098819882988398849885988698879888988998909891989298939894989598969897989898999900990199029903990499059906990799089909991099119912991399149915991699179918991999209921992299239924992599269927992899299930993199329933993499359936993799389939994099419942994399449945994699479948994999509951995299539954995599569957995899599960996199629963996499659966996799689969997099719972997399749975997699779978997999809981998299839984998599869987998899899990999199929993999499959996999799989999100001000110002100031000410005100061000710008100091001010011100121001310014100151001610017100181001910020100211002210023100241002510026100271002810029100301003110032100331003410035100361003710038100391004010041100421004310044100451004610047100481004910050100511005210053100541005510056100571005810059100601006110062100631006410065100661006710068100691007010071100721007310074100751007610077100781007910080100811008210083100841008510086100871008810089100901009110092100931009410095100961009710098100991010010101101021010310104101051010610107101081010910110101111011210113101141011510116101171011810119101201012110122101231012410125101261012710128101291013010131101321013310134101351013610137101381013910140101411014210143101441014510146101471014810149101501015110152101531015410155101561015710158101591016010161101621016310164101651016610167101681016910170101711017210173101741017510176101771017810179101801018110182101831018410185101861018710188101891019010191101921019310194101951019610197101981019910200102011020210203102041020510206102071020810209102101021110212102131021410215102161021710218102191022010221102221022310224102251022610227102281022910230102311023210233102341023510236102371023810239102401024110242102431024410245102461024710248102491025010251102521025310254102551025610257102581025910260102611026210263102641026510266102671026810269102701027110272102731027410275102761027710278102791028010281102821028310284102851028610287102881028910290102911029210293102941029510296102971029810299103001030110302103031030410305103061030710308103091031010311103121031310314103151031610317103181031910320103211032210323103241032510326103271032810329103301033110332103331033410335103361033710338103391034010341103421034310344103451034610347103481034910350103511035210353103541035510356103571035810359103601036110362103631036410365103661036710368103691037010371103721037310374103751037610377103781037910380103811038210383103841038510386103871038810389103901039110392103931039410395103961039710398103991040010401104021040310404104051040610407104081040910410104111041210413104141041510416104171041810419104201042110422104231042410425104261042710428104291043010431104321043310434104351043610437104381043910440104411044210443104441044510446104471044810449104501045110452104531045410455104561045710458104591046010461104621046310464104651046610467104681046910470104711047210473104741047510476104771047810479104801048110482104831048410485104861048710488104891049010491104921049310494104951049610497104981049910500105011050210503105041050510506105071050810509105101051110512105131051410515105161051710518105191052010521105221052310524105251052610527105281052910530105311053210533105341053510536105371053810539105401054110542105431054410545105461054710548105491055010551105521055310554105551055610557105581055910560105611056210563105641056510566105671056810569105701057110572105731057410575105761057710578105791058010581105821058310584105851058610587105881058910590105911059210593105941059510596105971059810599106001060110602106031060410605106061060710608106091061010611106121061310614106151061610617106181061910620106211062210623106241062510626106271062810629106301063110632106331063410635106361063710638106391064010641106421064310644106451064610647106481064910650106511065210653106541065510656106571065810659106601066110662106631066410665106661066710668106691067010671106721067310674106751067610677106781067910680106811068210683106841068510686106871068810689106901069110692106931069410695106961069710698106991070010701107021070310704107051070610707107081070910710107111071210713107141071510716107171071810719107201072110722107231072410725107261072710728107291073010731107321073310734107351073610737107381073910740107411074210743107441074510746107471074810749107501075110752107531075410755107561075710758107591076010761107621076310764107651076610767107681076910770107711077210773107741077510776107771077810779107801078110782107831078410785107861078710788107891079010791107921079310794107951079610797107981079910800108011080210803108041080510806108071080810809108101081110812108131081410815108161081710818108191082010821108221082310824108251082610827108281082910830108311083210833108341083510836108371083810839108401084110842108431084410845108461084710848108491085010851108521085310854108551085610857108581085910860108611086210863108641086510866108671086810869108701087110872108731087410875108761087710878108791088010881108821088310884108851088610887108881088910890108911089210893108941089510896108971089810899109001090110902109031090410905109061090710908109091091010911109121091310914109151091610917109181091910920109211092210923109241092510926109271092810929109301093110932109331093410935109361093710938109391094010941109421094310944109451094610947109481094910950109511095210953109541095510956109571095810959109601096110962109631096410965109661096710968109691097010971109721097310974109751097610977109781097910980109811098210983109841098510986109871098810989109901099110992109931099410995109961099710998109991100011001110021100311004110051100611007110081100911010110111101211013110141101511016110171101811019110201102111022110231102411025110261102711028110291103011031110321103311034110351103611037110381103911040110411104211043110441104511046110471104811049110501105111052110531105411055110561105711058110591106011061110621106311064110651106611067110681106911070110711107211073110741107511076110771107811079110801108111082110831108411085110861108711088110891109011091110921109311094110951109611097110981109911100111011110211103111041110511106111071110811109111101111111112111131111411115111161111711118111191112011121111221112311124111251112611127111281112911130111311113211133111341113511136111371113811139111401114111142111431114411145111461114711148111491115011151111521115311154111551115611157111581115911160111611116211163111641116511166111671116811169111701117111172111731117411175111761117711178111791118011181111821118311184111851118611187111881118911190111911119211193111941119511196111971119811199112001120111202112031120411205112061120711208112091121011211112121121311214112151121611217112181121911220112211122211223112241122511226112271122811229112301123111232112331123411235112361123711238112391124011241112421124311244112451124611247112481124911250112511125211253112541125511256112571125811259112601126111262112631126411265112661126711268112691127011271112721127311274112751127611277112781127911280112811128211283112841128511286112871128811289112901129111292112931129411295112961129711298112991130011301113021130311304113051130611307113081130911310113111131211313113141131511316113171131811319113201132111322113231132411325113261132711328113291133011331113321133311334113351133611337113381133911340113411134211343113441134511346113471134811349113501135111352113531135411355113561135711358113591136011361113621136311364113651136611367113681136911370113711137211373113741137511376113771137811379113801138111382113831138411385113861138711388113891139011391113921139311394113951139611397113981139911400114011140211403114041140511406114071140811409114101141111412114131141411415114161141711418114191142011421114221142311424114251142611427114281142911430114311143211433114341143511436114371143811439114401144111442114431144411445114461144711448114491145011451114521145311454114551145611457114581145911460114611146211463114641146511466114671146811469114701147111472114731147411475114761147711478114791148011481114821148311484114851148611487114881148911490114911149211493114941149511496114971149811499115001150111502115031150411505115061150711508115091151011511115121151311514115151151611517115181151911520115211152211523115241152511526115271152811529115301153111532115331153411535115361153711538115391154011541115421154311544115451154611547115481154911550115511155211553115541155511556115571155811559115601156111562115631156411565115661156711568115691157011571115721157311574115751157611577115781157911580115811158211583115841158511586115871158811589115901159111592115931159411595115961159711598115991160011601116021160311604116051160611607116081160911610116111161211613116141161511616116171161811619116201162111622116231162411625116261162711628116291163011631116321163311634116351163611637116381163911640116411164211643116441164511646116471164811649116501165111652116531165411655116561165711658116591166011661116621166311664116651166611667116681166911670116711167211673116741167511676116771167811679116801168111682116831168411685116861168711688116891169011691116921169311694116951169611697116981169911700117011170211703117041170511706117071170811709117101171111712117131171411715117161171711718117191172011721117221172311724117251172611727117281172911730117311173211733117341173511736117371173811739117401174111742117431174411745117461174711748117491175011751117521175311754117551175611757117581175911760117611176211763117641176511766117671176811769117701177111772117731177411775117761177711778117791178011781117821178311784117851178611787117881178911790117911179211793117941179511796117971179811799118001180111802118031180411805118061180711808118091181011811118121181311814118151181611817118181181911820118211182211823118241182511826118271182811829118301183111832118331183411835118361183711838118391184011841118421184311844118451184611847118481184911850118511185211853118541185511856118571185811859118601186111862118631186411865118661186711868118691187011871118721187311874118751187611877118781187911880118811188211883118841188511886118871188811889118901189111892118931189411895118961189711898118991190011901119021190311904119051190611907119081190911910119111191211913119141191511916119171191811919119201192111922119231192411925119261192711928119291193011931119321193311934119351193611937119381193911940119411194211943119441194511946119471194811949119501195111952119531195411955119561195711958119591196011961119621196311964119651196611967119681196911970119711197211973119741197511976119771197811979119801198111982119831198411985119861198711988119891199011991119921199311994119951199611997119981199912000120011200212003120041200512006120071200812009120101201112012120131201412015120161201712018120191202012021120221202312024120251202612027120281202912030120311203212033120341203512036120371203812039120401204112042120431204412045120461204712048120491205012051120521205312054120551205612057120581205912060120611206212063120641206512066120671206812069120701207112072120731207412075120761207712078120791208012081120821208312084120851208612087120881208912090120911209212093120941209512096120971209812099121001210112102121031210412105121061210712108121091211012111121121211312114121151211612117121181211912120121211212212123121241212512126121271212812129121301213112132121331213412135121361213712138121391214012141121421214312144121451214612147121481214912150121511215212153121541215512156121571215812159121601216112162121631216412165121661216712168121691217012171121721217312174121751217612177121781217912180121811218212183121841218512186121871218812189121901219112192121931219412195121961219712198121991220012201122021220312204122051220612207122081220912210122111221212213122141221512216122171221812219122201222112222122231222412225122261222712228122291223012231122321223312234122351223612237122381223912240122411224212243122441224512246122471224812249122501225112252122531225412255122561225712258122591226012261122621226312264122651226612267122681226912270122711227212273122741227512276122771227812279122801228112282122831228412285122861228712288122891229012291122921229312294122951229612297122981229912300123011230212303123041230512306123071230812309123101231112312123131231412315123161231712318123191232012321123221232312324123251232612327123281232912330123311233212333123341233512336123371233812339123401234112342123431234412345123461234712348123491235012351123521235312354123551235612357123581235912360123611236212363123641236512366123671236812369123701237112372123731237412375123761237712378123791238012381123821238312384123851238612387123881238912390123911239212393123941239512396123971239812399124001240112402124031240412405124061240712408124091241012411124121241312414124151241612417124181241912420124211242212423124241242512426124271242812429124301243112432124331243412435124361243712438124391244012441124421244312444124451244612447124481244912450124511245212453124541245512456124571245812459124601246112462124631246412465124661246712468124691247012471124721247312474124751247612477124781247912480124811248212483124841248512486124871248812489124901249112492124931249412495124961249712498124991250012501125021250312504125051250612507125081250912510125111251212513125141251512516125171251812519125201252112522125231252412525125261252712528125291253012531125321253312534125351253612537125381253912540125411254212543125441254512546125471254812549125501255112552125531255412555125561255712558125591256012561125621256312564125651256612567125681256912570125711257212573125741257512576125771257812579125801258112582125831258412585125861258712588125891259012591125921259312594125951259612597125981259912600126011260212603126041260512606126071260812609126101261112612126131261412615126161261712618126191262012621126221262312624126251262612627126281262912630126311263212633126341263512636126371263812639126401264112642126431264412645126461264712648126491265012651126521265312654126551265612657126581265912660126611266212663126641266512666126671266812669126701267112672126731267412675126761267712678126791268012681126821268312684126851268612687126881268912690126911269212693126941269512696126971269812699127001270112702127031270412705127061270712708127091271012711127121271312714127151271612717127181271912720127211272212723127241272512726127271272812729127301273112732127331273412735127361273712738127391274012741127421274312744127451274612747127481274912750127511275212753127541275512756127571275812759127601276112762127631276412765127661276712768127691277012771127721277312774127751277612777127781277912780127811278212783127841278512786127871278812789127901279112792127931279412795127961279712798127991280012801128021280312804128051280612807128081280912810128111281212813128141281512816128171281812819128201282112822128231282412825128261282712828128291283012831128321283312834128351283612837128381283912840128411284212843128441284512846128471284812849128501285112852128531285412855128561285712858128591286012861128621286312864128651286612867128681286912870128711287212873128741287512876128771287812879128801288112882128831288412885128861288712888128891289012891128921289312894128951289612897128981289912900129011290212903129041290512906129071290812909129101291112912129131291412915129161291712918129191292012921129221292312924129251292612927129281292912930129311293212933129341293512936129371293812939129401294112942129431294412945129461294712948129491295012951129521295312954129551295612957129581295912960129611296212963129641296512966129671296812969129701297112972129731297412975129761297712978129791298012981129821298312984129851298612987129881298912990129911299212993129941299512996129971299812999130001300113002130031300413005130061300713008130091301013011130121301313014130151301613017130181301913020130211302213023130241302513026130271302813029130301303113032130331303413035130361303713038130391304013041130421304313044130451304613047130481304913050130511305213053130541305513056130571305813059130601306113062130631306413065130661306713068130691307013071130721307313074130751307613077130781307913080130811308213083130841308513086130871308813089130901309113092130931309413095130961309713098130991310013101131021310313104131051310613107131081310913110131111311213113131141311513116131171311813119131201312113122131231312413125131261312713128131291313013131131321313313134131351313613137131381313913140131411314213143131441314513146131471314813149131501315113152131531315413155131561315713158131591316013161131621316313164131651316613167131681316913170131711317213173131741317513176131771317813179131801318113182131831318413185131861318713188131891319013191131921319313194131951319613197131981319913200132011320213203132041320513206132071320813209132101321113212132131321413215132161321713218132191322013221132221322313224132251322613227132281322913230132311323213233132341323513236132371323813239132401324113242132431324413245132461324713248132491325013251132521325313254132551325613257132581325913260132611326213263132641326513266132671326813269132701327113272132731327413275132761327713278132791328013281132821328313284132851328613287132881328913290132911329213293132941329513296132971329813299133001330113302133031330413305133061330713308133091331013311133121331313314133151331613317133181331913320133211332213323133241332513326133271332813329133301333113332133331333413335133361333713338133391334013341133421334313344133451334613347133481334913350133511335213353133541335513356133571335813359133601336113362133631336413365133661336713368133691337013371133721337313374133751337613377133781337913380133811338213383133841338513386133871338813389133901339113392133931339413395133961339713398133991340013401134021340313404134051340613407134081340913410134111341213413134141341513416134171341813419134201342113422134231342413425134261342713428134291343013431134321343313434134351343613437134381343913440134411344213443134441344513446134471344813449134501345113452134531345413455134561345713458134591346013461134621346313464134651346613467134681346913470134711347213473134741347513476134771347813479134801348113482134831348413485134861348713488134891349013491134921349313494134951349613497134981349913500135011350213503135041350513506135071350813509135101351113512135131351413515135161351713518135191352013521135221352313524135251352613527135281352913530135311353213533135341353513536135371353813539135401354113542135431354413545135461354713548135491355013551135521355313554135551355613557135581355913560135611356213563135641356513566135671356813569135701357113572135731357413575135761357713578135791358013581135821358313584135851358613587135881358913590135911359213593135941359513596135971359813599136001360113602136031360413605136061360713608136091361013611136121361313614136151361613617136181361913620136211362213623136241362513626136271362813629136301363113632136331363413635136361363713638136391364013641136421364313644136451364613647136481364913650136511365213653136541365513656136571365813659136601366113662136631366413665136661366713668136691367013671136721367313674136751367613677136781367913680136811368213683136841368513686136871368813689136901369113692136931369413695136961369713698136991370013701137021370313704137051370613707137081370913710137111371213713137141371513716137171371813719137201372113722137231372413725137261372713728137291373013731137321373313734137351373613737137381373913740137411374213743137441374513746137471374813749137501375113752137531375413755137561375713758137591376013761137621376313764137651376613767137681376913770137711377213773137741377513776137771377813779137801378113782137831378413785137861378713788137891379013791137921379313794137951379613797137981379913800138011380213803138041380513806138071380813809138101381113812138131381413815138161381713818138191382013821138221382313824138251382613827138281382913830138311383213833138341383513836138371383813839138401384113842138431384413845138461384713848138491385013851138521385313854138551385613857138581385913860138611386213863138641386513866138671386813869138701387113872138731387413875138761387713878138791388013881138821388313884138851388613887138881388913890138911389213893138941389513896138971389813899139001390113902139031390413905139061390713908139091391013911139121391313914139151391613917139181391913920139211392213923139241392513926139271392813929139301393113932139331393413935139361393713938139391394013941139421394313944139451394613947139481394913950139511395213953139541395513956139571395813959139601396113962139631396413965139661396713968139691397013971139721397313974139751397613977139781397913980139811398213983139841398513986139871398813989139901399113992139931399413995139961399713998139991400014001140021400314004140051400614007140081400914010140111401214013140141401514016140171401814019140201402114022140231402414025140261402714028140291403014031140321403314034140351403614037140381403914040140411404214043140441404514046140471404814049140501405114052140531405414055140561405714058140591406014061140621406314064140651406614067140681406914070140711407214073140741407514076140771407814079140801408114082140831408414085140861408714088140891409014091140921409314094140951409614097140981409914100141011410214103141041410514106141071410814109141101411114112141131411414115141161411714118141191412014121141221412314124141251412614127141281412914130141311413214133141341413514136141371413814139141401414114142141431414414145141461414714148141491415014151141521415314154141551415614157141581415914160141611416214163141641416514166141671416814169141701417114172141731417414175141761417714178141791418014181141821418314184141851418614187141881418914190141911419214193141941419514196141971419814199142001420114202142031420414205142061420714208142091421014211142121421314214142151421614217142181421914220142211422214223142241422514226142271422814229142301423114232142331423414235142361423714238142391424014241142421424314244142451424614247142481424914250142511425214253142541425514256142571425814259142601426114262142631426414265142661426714268142691427014271142721427314274142751427614277142781427914280142811428214283142841428514286142871428814289142901429114292142931429414295142961429714298142991430014301143021430314304143051430614307143081430914310143111431214313143141431514316143171431814319143201432114322143231432414325143261432714328143291433014331143321433314334143351433614337143381433914340143411434214343143441434514346143471434814349143501435114352143531435414355143561435714358143591436014361143621436314364143651436614367143681436914370143711437214373143741437514376143771437814379143801438114382143831438414385143861438714388143891439014391143921439314394143951439614397143981439914400144011440214403144041440514406144071440814409144101441114412144131441414415144161441714418144191442014421144221442314424144251442614427144281442914430144311443214433144341443514436144371443814439144401444114442144431444414445144461444714448144491445014451144521445314454144551445614457144581445914460144611446214463144641446514466144671446814469144701447114472144731447414475144761447714478144791448014481144821448314484144851448614487144881448914490144911449214493144941449514496144971449814499145001450114502145031450414505145061450714508145091451014511145121451314514145151451614517145181451914520145211452214523145241452514526145271452814529145301453114532145331453414535145361453714538145391454014541145421454314544145451454614547145481454914550145511455214553145541455514556145571455814559145601456114562145631456414565145661456714568145691457014571145721457314574145751457614577145781457914580145811458214583145841458514586145871458814589145901459114592145931459414595145961459714598145991460014601146021460314604146051460614607146081460914610146111461214613146141461514616146171461814619146201462114622146231462414625146261462714628146291463014631146321463314634146351463614637146381463914640146411464214643146441464514646146471464814649146501465114652146531465414655146561465714658146591466014661146621466314664146651466614667146681466914670146711467214673146741467514676146771467814679146801468114682146831468414685146861468714688146891469014691146921469314694146951469614697146981469914700147011470214703147041470514706147071470814709147101471114712147131471414715147161471714718147191472014721147221472314724147251472614727147281472914730147311473214733147341473514736147371473814739147401474114742147431474414745147461474714748147491475014751147521475314754147551475614757147581475914760147611476214763147641476514766147671476814769147701477114772147731477414775147761477714778147791478014781147821478314784147851478614787147881478914790147911479214793147941479514796147971479814799148001480114802148031480414805148061480714808148091481014811148121481314814148151481614817148181481914820148211482214823148241482514826148271482814829148301483114832148331483414835148361483714838148391484014841148421484314844148451484614847148481484914850148511485214853148541485514856148571485814859148601486114862148631486414865148661486714868148691487014871148721487314874148751487614877148781487914880148811488214883148841488514886148871488814889148901489114892148931489414895148961489714898148991490014901149021490314904149051490614907149081490914910149111491214913149141491514916149171491814919149201492114922149231492414925149261492714928149291493014931149321493314934149351493614937149381493914940149411494214943149441494514946149471494814949149501495114952149531495414955149561495714958149591496014961149621496314964149651496614967149681496914970149711497214973149741497514976149771497814979149801498114982149831498414985149861498714988149891499014991149921499314994149951499614997149981499915000150011500215003150041500515006150071500815009150101501115012150131501415015150161501715018150191502015021150221502315024150251502615027150281502915030150311503215033150341503515036150371503815039150401504115042150431504415045150461504715048150491505015051150521505315054150551505615057150581505915060150611506215063150641506515066150671506815069150701507115072150731507415075150761507715078150791508015081150821508315084150851508615087150881508915090150911509215093150941509515096150971509815099151001510115102151031510415105151061510715108151091511015111151121511315114151151511615117151181511915120151211512215123151241512515126151271512815129151301513115132151331513415135151361513715138151391514015141151421514315144151451514615147151481514915150151511515215153151541515515156151571515815159151601516115162151631516415165151661516715168151691517015171151721517315174151751517615177151781517915180151811518215183151841518515186151871518815189151901519115192151931519415195151961519715198151991520015201152021520315204152051520615207152081520915210152111521215213152141521515216152171521815219152201522115222152231522415225152261522715228152291523015231152321523315234152351523615237152381523915240152411524215243152441524515246152471524815249152501525115252152531525415255152561525715258152591526015261152621526315264152651526615267152681526915270152711527215273152741527515276152771527815279152801528115282152831528415285152861528715288152891529015291152921529315294152951529615297152981529915300153011530215303153041530515306153071530815309153101531115312153131531415315153161531715318153191532015321153221532315324153251532615327153281532915330153311533215333153341533515336153371533815339153401534115342153431534415345153461534715348153491535015351153521535315354153551535615357153581535915360153611536215363153641536515366153671536815369153701537115372153731537415375153761537715378153791538015381153821538315384153851538615387153881538915390153911539215393153941539515396153971539815399154001540115402154031540415405154061540715408154091541015411154121541315414154151541615417154181541915420154211542215423154241542515426154271542815429154301543115432154331543415435154361543715438154391544015441154421544315444154451544615447154481544915450154511545215453154541545515456154571545815459154601546115462154631546415465154661546715468154691547015471154721547315474154751547615477154781547915480154811548215483154841548515486154871548815489154901549115492154931549415495154961549715498154991550015501155021550315504155051550615507155081550915510155111551215513155141551515516155171551815519155201552115522155231552415525155261552715528155291553015531155321553315534155351553615537155381553915540155411554215543155441554515546155471554815549155501555115552155531555415555155561555715558155591556015561155621556315564155651556615567155681556915570155711557215573155741557515576155771557815579155801558115582155831558415585155861558715588155891559015591155921559315594155951559615597155981559915600156011560215603156041560515606156071560815609156101561115612156131561415615156161561715618156191562015621156221562315624156251562615627156281562915630156311563215633156341563515636156371563815639156401564115642156431564415645156461564715648156491565015651156521565315654156551565615657156581565915660156611566215663156641566515666156671566815669156701567115672156731567415675156761567715678156791568015681156821568315684156851568615687156881568915690156911569215693156941569515696156971569815699157001570115702157031570415705157061570715708157091571015711157121571315714157151571615717157181571915720157211572215723157241572515726157271572815729157301573115732157331573415735157361573715738157391574015741157421574315744157451574615747157481574915750157511575215753157541575515756157571575815759157601576115762157631576415765157661576715768157691577015771157721577315774157751577615777157781577915780157811578215783157841578515786157871578815789157901579115792157931579415795157961579715798157991580015801158021580315804158051580615807158081580915810158111581215813158141581515816158171581815819158201582115822158231582415825158261582715828158291583015831158321583315834158351583615837158381583915840158411584215843158441584515846158471584815849158501585115852158531585415855158561585715858158591586015861158621586315864158651586615867158681586915870158711587215873158741587515876158771587815879158801588115882158831588415885158861588715888158891589015891158921589315894158951589615897158981589915900159011590215903159041590515906159071590815909159101591115912159131591415915159161591715918159191592015921159221592315924159251592615927159281592915930159311593215933159341593515936159371593815939159401594115942159431594415945159461594715948159491595015951159521595315954159551595615957159581595915960159611596215963159641596515966159671596815969159701597115972159731597415975159761597715978159791598015981159821598315984159851598615987159881598915990159911599215993159941599515996159971599815999160001600116002160031600416005160061600716008160091601016011160121601316014160151601616017160181601916020160211602216023160241602516026160271602816029160301603116032160331603416035160361603716038160391604016041160421604316044160451604616047160481604916050160511605216053160541605516056160571605816059160601606116062160631606416065160661606716068160691607016071160721607316074160751607616077160781607916080160811608216083160841608516086160871608816089160901609116092160931609416095160961609716098160991610016101161021610316104161051610616107161081610916110161111611216113161141611516116161171611816119161201612116122161231612416125161261612716128161291613016131161321613316134161351613616137161381613916140161411614216143161441614516146161471614816149161501615116152161531615416155161561615716158161591616016161161621616316164161651616616167161681616916170161711617216173161741617516176161771617816179161801618116182161831618416185161861618716188161891619016191161921619316194161951619616197161981619916200162011620216203162041620516206162071620816209162101621116212162131621416215162161621716218162191622016221162221622316224162251622616227162281622916230162311623216233162341623516236162371623816239162401624116242162431624416245162461624716248162491625016251162521625316254162551625616257162581625916260162611626216263162641626516266162671626816269162701627116272162731627416275162761627716278162791628016281162821628316284162851628616287162881628916290162911629216293162941629516296162971629816299163001630116302163031630416305163061630716308163091631016311163121631316314163151631616317163181631916320163211632216323163241632516326163271632816329163301633116332163331633416335163361633716338163391634016341163421634316344163451634616347163481634916350163511635216353163541635516356163571635816359163601636116362163631636416365163661636716368163691637016371163721637316374163751637616377163781637916380163811638216383163841638516386163871638816389163901639116392163931639416395163961639716398163991640016401164021640316404164051640616407164081640916410164111641216413164141641516416164171641816419164201642116422164231642416425164261642716428164291643016431164321643316434164351643616437164381643916440164411644216443164441644516446164471644816449164501645116452164531645416455164561645716458164591646016461164621646316464164651646616467164681646916470164711647216473164741647516476164771647816479164801648116482164831648416485164861648716488164891649016491164921649316494164951649616497164981649916500165011650216503165041650516506165071650816509165101651116512165131651416515165161651716518165191652016521165221652316524165251652616527165281652916530165311653216533165341653516536165371653816539165401654116542165431654416545165461654716548165491655016551165521655316554165551655616557165581655916560165611656216563165641656516566165671656816569165701657116572165731657416575165761657716578165791658016581165821658316584165851658616587165881658916590165911659216593165941659516596165971659816599166001660116602166031660416605166061660716608166091661016611166121661316614166151661616617166181661916620166211662216623166241662516626166271662816629166301663116632166331663416635166361663716638166391664016641166421664316644166451664616647166481664916650166511665216653166541665516656166571665816659166601666116662166631666416665166661666716668166691667016671166721667316674166751667616677166781667916680166811668216683166841668516686166871668816689166901669116692166931669416695166961669716698166991670016701167021670316704167051670616707167081670916710167111671216713167141671516716167171671816719167201672116722167231672416725167261672716728167291673016731167321673316734167351673616737167381673916740167411674216743167441674516746167471674816749167501675116752167531675416755167561675716758167591676016761167621676316764167651676616767167681676916770167711677216773167741677516776167771677816779167801678116782167831678416785167861678716788167891679016791167921679316794167951679616797167981679916800168011680216803168041680516806168071680816809168101681116812168131681416815168161681716818168191682016821168221682316824168251682616827168281682916830168311683216833168341683516836168371683816839168401684116842168431684416845168461684716848168491685016851168521685316854168551685616857168581685916860168611686216863168641686516866168671686816869168701687116872168731687416875168761687716878168791688016881168821688316884168851688616887168881688916890168911689216893168941689516896168971689816899169001690116902169031690416905169061690716908169091691016911169121691316914169151691616917169181691916920169211692216923169241692516926169271692816929169301693116932169331693416935169361693716938169391694016941169421694316944169451694616947169481694916950169511695216953169541695516956169571695816959169601696116962169631696416965169661696716968169691697016971169721697316974169751697616977169781697916980169811698216983169841698516986169871698816989169901699116992169931699416995169961699716998169991700017001170021700317004170051700617007170081700917010170111701217013170141701517016170171701817019170201702117022170231702417025170261702717028170291703017031170321703317034170351703617037170381703917040170411704217043170441704517046170471704817049170501705117052170531705417055170561705717058170591706017061170621706317064170651706617067170681706917070170711707217073170741707517076170771707817079170801708117082170831708417085170861708717088170891709017091170921709317094170951709617097170981709917100171011710217103171041710517106171071710817109171101711117112171131711417115171161711717118171191712017121171221712317124171251712617127171281712917130171311713217133171341713517136171371713817139171401714117142171431714417145171461714717148171491715017151171521715317154171551715617157171581715917160171611716217163171641716517166171671716817169171701717117172171731717417175171761717717178171791718017181171821718317184171851718617187171881718917190171911719217193171941719517196171971719817199172001720117202172031720417205172061720717208172091721017211172121721317214172151721617217172181721917220172211722217223172241722517226172271722817229172301723117232172331723417235172361723717238172391724017241172421724317244172451724617247172481724917250172511725217253172541725517256172571725817259172601726117262172631726417265172661726717268172691727017271172721727317274172751727617277172781727917280172811728217283172841728517286172871728817289172901729117292172931729417295172961729717298172991730017301173021730317304173051730617307173081730917310173111731217313173141731517316173171731817319173201732117322173231732417325173261732717328173291733017331173321733317334173351733617337173381733917340173411734217343173441734517346173471734817349173501735117352173531735417355173561735717358173591736017361173621736317364173651736617367173681736917370173711737217373173741737517376173771737817379173801738117382173831738417385173861738717388173891739017391173921739317394173951739617397173981739917400174011740217403174041740517406174071740817409174101741117412174131741417415174161741717418174191742017421174221742317424174251742617427174281742917430174311743217433174341743517436174371743817439174401744117442174431744417445174461744717448174491745017451174521745317454174551745617457174581745917460174611746217463174641746517466174671746817469174701747117472174731747417475174761747717478174791748017481174821748317484174851748617487174881748917490174911749217493174941749517496174971749817499175001750117502175031750417505175061750717508175091751017511175121751317514175151751617517175181751917520175211752217523175241752517526175271752817529175301753117532175331753417535175361753717538175391754017541175421754317544175451754617547175481754917550175511755217553175541755517556175571755817559175601756117562175631756417565175661756717568175691757017571175721757317574175751757617577175781757917580175811758217583175841758517586175871758817589175901759117592175931759417595175961759717598175991760017601176021760317604176051760617607176081760917610176111761217613176141761517616176171761817619176201762117622176231762417625176261762717628176291763017631176321763317634176351763617637176381763917640176411764217643176441764517646176471764817649176501765117652176531765417655176561765717658176591766017661176621766317664176651766617667176681766917670176711767217673176741767517676176771767817679176801768117682176831768417685176861768717688176891769017691176921769317694176951769617697176981769917700177011770217703177041770517706177071770817709177101771117712177131771417715177161771717718177191772017721177221772317724177251772617727177281772917730177311773217733177341773517736177371773817739177401774117742177431774417745177461774717748177491775017751177521775317754177551775617757177581775917760177611776217763177641776517766177671776817769177701777117772177731777417775177761777717778177791778017781177821778317784177851778617787177881778917790177911779217793177941779517796177971779817799178001780117802178031780417805178061780717808178091781017811178121781317814178151781617817178181781917820178211782217823178241782517826178271782817829178301783117832178331783417835178361783717838178391784017841178421784317844178451784617847178481784917850178511785217853178541785517856178571785817859178601786117862178631786417865178661786717868178691787017871178721787317874178751787617877178781787917880178811788217883178841788517886178871788817889178901789117892178931789417895178961789717898178991790017901179021790317904179051790617907179081790917910179111791217913179141791517916179171791817919179201792117922179231792417925179261792717928179291793017931179321793317934179351793617937179381793917940179411794217943179441794517946179471794817949179501795117952179531795417955179561795717958179591796017961179621796317964179651796617967179681796917970179711797217973179741797517976179771797817979179801798117982179831798417985179861798717988179891799017991179921799317994179951799617997179981799918000180011800218003180041800518006180071800818009180101801118012180131801418015180161801718018180191802018021180221802318024180251802618027180281802918030180311803218033180341803518036180371803818039180401804118042180431804418045180461804718048180491805018051180521805318054180551805618057180581805918060180611806218063180641806518066180671806818069180701807118072180731807418075180761807718078180791808018081180821808318084180851808618087180881808918090180911809218093180941809518096180971809818099181001810118102181031810418105181061810718108181091811018111181121811318114181151811618117181181811918120181211812218123181241812518126181271812818129181301813118132181331813418135181361813718138181391814018141181421814318144181451814618147181481814918150181511815218153181541815518156181571815818159181601816118162181631816418165181661816718168181691817018171181721817318174181751817618177181781817918180181811818218183181841818518186181871818818189181901819118192181931819418195181961819718198181991820018201182021820318204182051820618207182081820918210182111821218213182141821518216182171821818219182201822118222182231822418225182261822718228182291823018231182321823318234182351823618237182381823918240182411824218243182441824518246182471824818249182501825118252182531825418255182561825718258182591826018261182621826318264182651826618267182681826918270182711827218273182741827518276182771827818279182801828118282182831828418285182861828718288182891829018291182921829318294182951829618297182981829918300183011830218303183041830518306183071830818309183101831118312183131831418315183161831718318183191832018321183221832318324183251832618327183281832918330183311833218333183341833518336183371833818339183401834118342183431834418345183461834718348183491835018351183521835318354183551835618357183581835918360183611836218363183641836518366183671836818369183701837118372183731837418375183761837718378183791838018381183821838318384183851838618387183881838918390183911839218393183941839518396183971839818399184001840118402184031840418405184061840718408184091841018411184121841318414184151841618417184181841918420184211842218423184241842518426184271842818429184301843118432184331843418435184361843718438184391844018441184421844318444184451844618447184481844918450184511845218453184541845518456184571845818459184601846118462184631846418465184661846718468184691847018471184721847318474184751847618477184781847918480184811848218483184841848518486184871848818489184901849118492184931849418495184961849718498184991850018501185021850318504185051850618507185081850918510185111851218513185141851518516185171851818519185201852118522185231852418525185261852718528185291853018531185321853318534185351853618537185381853918540185411854218543185441854518546185471854818549185501855118552185531855418555185561855718558185591856018561185621856318564185651856618567185681856918570185711857218573185741857518576185771857818579185801858118582185831858418585185861858718588185891859018591185921859318594185951859618597185981859918600186011860218603186041860518606186071860818609186101861118612186131861418615186161861718618186191862018621186221862318624186251862618627186281862918630186311863218633186341863518636186371863818639186401864118642186431864418645186461864718648186491865018651186521865318654186551865618657186581865918660186611866218663186641866518666186671866818669186701867118672186731867418675186761867718678186791868018681186821868318684186851868618687186881868918690186911869218693186941869518696186971869818699187001870118702187031870418705187061870718708187091871018711187121871318714187151871618717187181871918720187211872218723187241872518726187271872818729187301873118732187331873418735187361873718738187391874018741187421874318744187451874618747187481874918750187511875218753187541875518756187571875818759187601876118762187631876418765187661876718768187691877018771187721877318774187751877618777187781877918780187811878218783187841878518786187871878818789187901879118792187931879418795187961879718798187991880018801188021880318804188051880618807188081880918810188111881218813188141881518816188171881818819188201882118822188231882418825188261882718828188291883018831188321883318834188351883618837188381883918840188411884218843188441884518846188471884818849188501885118852188531885418855188561885718858188591886018861188621886318864188651886618867188681886918870188711887218873188741887518876188771887818879188801888118882188831888418885188861888718888188891889018891188921889318894188951889618897188981889918900189011890218903189041890518906189071890818909189101891118912189131891418915189161891718918189191892018921189221892318924189251892618927189281892918930189311893218933189341893518936189371893818939189401894118942189431894418945189461894718948189491895018951189521895318954189551895618957189581895918960189611896218963189641896518966189671896818969189701897118972189731897418975189761897718978189791898018981189821898318984189851898618987189881898918990189911899218993189941899518996189971899818999190001900119002190031900419005190061900719008190091901019011190121901319014190151901619017190181901919020190211902219023190241902519026190271902819029190301903119032190331903419035190361903719038190391904019041190421904319044190451904619047190481904919050190511905219053190541905519056190571905819059190601906119062190631906419065190661906719068190691907019071190721907319074190751907619077190781907919080190811908219083190841908519086190871908819089190901909119092190931909419095190961909719098190991910019101191021910319104191051910619107191081910919110191111911219113191141911519116191171911819119191201912119122191231912419125191261912719128191291913019131191321913319134191351913619137191381913919140191411914219143191441914519146191471914819149191501915119152191531915419155191561915719158191591916019161191621916319164191651916619167191681916919170191711917219173191741917519176191771917819179191801918119182191831918419185191861918719188191891919019191191921919319194191951919619197191981919919200192011920219203192041920519206192071920819209192101921119212192131921419215192161921719218192191922019221192221922319224192251922619227192281922919230192311923219233192341923519236192371923819239192401924119242192431924419245192461924719248192491925019251192521925319254192551925619257192581925919260192611926219263192641926519266192671926819269192701927119272192731927419275192761927719278192791928019281192821928319284192851928619287192881928919290192911929219293192941929519296192971929819299193001930119302193031930419305193061930719308193091931019311193121931319314193151931619317193181931919320193211932219323193241932519326193271932819329193301933119332193331933419335193361933719338193391934019341193421934319344193451934619347193481934919350193511935219353193541935519356193571935819359193601936119362193631936419365193661936719368193691937019371193721937319374193751937619377193781937919380193811938219383193841938519386193871938819389193901939119392193931939419395193961939719398193991940019401194021940319404194051940619407194081940919410194111941219413194141941519416194171941819419194201942119422194231942419425194261942719428194291943019431194321943319434194351943619437194381943919440194411944219443194441944519446194471944819449194501945119452194531945419455194561945719458194591946019461194621946319464194651946619467194681946919470194711947219473194741947519476194771947819479194801948119482194831948419485194861948719488194891949019491194921949319494194951949619497194981949919500195011950219503195041950519506195071950819509195101951119512195131951419515195161951719518195191952019521195221952319524195251952619527195281952919530195311953219533195341953519536195371953819539195401954119542195431954419545195461954719548195491955019551195521955319554195551955619557195581955919560195611956219563195641956519566195671956819569195701957119572195731957419575195761957719578195791958019581195821958319584195851958619587195881958919590195911959219593195941959519596195971959819599196001960119602196031960419605196061960719608196091961019611196121961319614196151961619617196181961919620196211962219623196241962519626196271962819629196301963119632196331963419635196361963719638196391964019641196421964319644196451964619647196481964919650196511965219653196541965519656196571965819659196601966119662196631966419665196661966719668196691967019671196721967319674196751967619677196781967919680196811968219683196841968519686196871968819689196901969119692196931969419695196961969719698196991970019701197021970319704197051970619707197081970919710197111971219713197141971519716197171971819719197201972119722197231972419725197261972719728197291973019731197321973319734197351973619737197381973919740197411974219743197441974519746197471974819749197501975119752197531975419755197561975719758197591976019761197621976319764197651976619767197681976919770197711977219773197741977519776197771977819779197801978119782197831978419785197861978719788197891979019791197921979319794197951979619797197981979919800198011980219803198041980519806198071980819809198101981119812198131981419815198161981719818198191982019821198221982319824198251982619827198281982919830198311983219833198341983519836198371983819839198401984119842198431984419845198461984719848198491985019851198521985319854198551985619857198581985919860198611986219863198641986519866198671986819869198701987119872198731987419875198761987719878198791988019881198821988319884198851988619887198881988919890198911989219893198941989519896198971989819899199001990119902199031990419905199061990719908199091991019911199121991319914199151991619917199181991919920199211992219923199241992519926199271992819929199301993119932199331993419935199361993719938199391994019941199421994319944199451994619947199481994919950199511995219953199541995519956199571995819959199601996119962199631996419965199661996719968199691997019971199721997319974199751997619977199781997919980199811998219983199841998519986199871998819989199901999119992199931999419995199961999719998199992000020001200022000320004200052000620007200082000920010200112001220013200142001520016200172001820019200202002120022200232002420025200262002720028200292003020031200322003320034200352003620037200382003920040200412004220043200442004520046200472004820049200502005120052200532005420055200562005720058200592006020061200622006320064200652006620067200682006920070200712007220073200742007520076200772007820079200802008120082200832008420085200862008720088200892009020091200922009320094200952009620097200982009920100201012010220103201042010520106201072010820109201102011120112201132011420115201162011720118201192012020121201222012320124201252012620127201282012920130201312013220133201342013520136201372013820139201402014120142201432014420145201462014720148201492015020151201522015320154201552015620157201582015920160201612016220163201642016520166201672016820169201702017120172201732017420175201762017720178201792018020181201822018320184201852018620187201882018920190201912019220193201942019520196201972019820199202002020120202202032020420205202062020720208202092021020211202122021320214202152021620217202182021920220202212022220223202242022520226202272022820229202302023120232202332023420235202362023720238202392024020241202422024320244202452024620247202482024920250202512025220253202542025520256202572025820259202602026120262202632026420265202662026720268202692027020271202722027320274202752027620277202782027920280202812028220283202842028520286202872028820289202902029120292202932029420295202962029720298202992030020301203022030320304203052030620307203082030920310203112031220313203142031520316203172031820319203202032120322203232032420325203262032720328203292033020331203322033320334203352033620337203382033920340203412034220343203442034520346203472034820349203502035120352203532035420355203562035720358203592036020361203622036320364203652036620367203682036920370203712037220373203742037520376203772037820379203802038120382203832038420385203862038720388203892039020391203922039320394203952039620397203982039920400204012040220403204042040520406204072040820409204102041120412204132041420415204162041720418204192042020421204222042320424204252042620427204282042920430204312043220433204342043520436204372043820439204402044120442204432044420445204462044720448204492045020451204522045320454204552045620457204582045920460204612046220463204642046520466204672046820469204702047120472204732047420475204762047720478204792048020481204822048320484204852048620487204882048920490204912049220493204942049520496204972049820499205002050120502205032050420505205062050720508205092051020511205122051320514205152051620517205182051920520205212052220523205242052520526205272052820529205302053120532205332053420535205362053720538205392054020541205422054320544205452054620547205482054920550205512055220553205542055520556205572055820559205602056120562205632056420565205662056720568205692057020571205722057320574205752057620577205782057920580205812058220583205842058520586205872058820589205902059120592205932059420595205962059720598205992060020601206022060320604206052060620607206082060920610206112061220613206142061520616206172061820619206202062120622206232062420625206262062720628206292063020631206322063320634206352063620637206382063920640206412064220643206442064520646206472064820649206502065120652206532065420655206562065720658206592066020661206622066320664206652066620667206682066920670206712067220673206742067520676206772067820679206802068120682206832068420685206862068720688206892069020691206922069320694206952069620697206982069920700207012070220703207042070520706207072070820709207102071120712207132071420715207162071720718207192072020721207222072320724207252072620727207282072920730207312073220733207342073520736207372073820739207402074120742207432074420745207462074720748207492075020751207522075320754207552075620757207582075920760207612076220763207642076520766207672076820769207702077120772207732077420775207762077720778207792078020781207822078320784207852078620787207882078920790207912079220793207942079520796207972079820799208002080120802208032080420805208062080720808208092081020811208122081320814208152081620817208182081920820208212082220823208242082520826208272082820829208302083120832208332083420835208362083720838208392084020841208422084320844208452084620847208482084920850208512085220853208542085520856208572085820859208602086120862208632086420865208662086720868208692087020871208722087320874208752087620877208782087920880208812088220883208842088520886208872088820889208902089120892208932089420895208962089720898208992090020901209022090320904209052090620907209082090920910209112091220913209142091520916209172091820919209202092120922209232092420925209262092720928209292093020931209322093320934209352093620937209382093920940209412094220943209442094520946209472094820949209502095120952209532095420955209562095720958209592096020961209622096320964209652096620967209682096920970209712097220973209742097520976209772097820979209802098120982209832098420985209862098720988209892099020991209922099320994209952099620997209982099921000210012100221003210042100521006210072100821009210102101121012210132101421015210162101721018210192102021021210222102321024210252102621027210282102921030210312103221033210342103521036210372103821039210402104121042210432104421045210462104721048210492105021051210522105321054210552105621057210582105921060210612106221063210642106521066210672106821069210702107121072210732107421075210762107721078210792108021081210822108321084210852108621087210882108921090210912109221093210942109521096210972109821099211002110121102211032110421105211062110721108211092111021111211122111321114211152111621117211182111921120211212112221123211242112521126211272112821129211302113121132211332113421135211362113721138211392114021141211422114321144211452114621147211482114921150211512115221153211542115521156211572115821159211602116121162211632116421165211662116721168211692117021171211722117321174211752117621177211782117921180211812118221183211842118521186211872118821189211902119121192211932119421195211962119721198211992120021201212022120321204212052120621207212082120921210212112121221213212142121521216212172121821219212202122121222212232122421225212262122721228212292123021231212322123321234212352123621237212382123921240212412124221243212442124521246212472124821249212502125121252212532125421255212562125721258212592126021261212622126321264212652126621267212682126921270212712127221273212742127521276212772127821279212802128121282212832128421285212862128721288212892129021291212922129321294212952129621297212982129921300213012130221303213042130521306213072130821309213102131121312213132131421315213162131721318213192132021321213222132321324213252132621327213282132921330213312133221333213342133521336213372133821339213402134121342213432134421345213462134721348213492135021351213522135321354213552135621357213582135921360213612136221363213642136521366213672136821369213702137121372213732137421375213762137721378213792138021381213822138321384213852138621387213882138921390213912139221393213942139521396213972139821399214002140121402214032140421405214062140721408214092141021411214122141321414214152141621417214182141921420214212142221423214242142521426214272142821429214302143121432214332143421435214362143721438214392144021441214422144321444214452144621447214482144921450214512145221453214542145521456214572145821459214602146121462214632146421465214662146721468214692147021471214722147321474214752147621477214782147921480214812148221483214842148521486214872148821489214902149121492214932149421495214962149721498214992150021501215022150321504215052150621507215082150921510215112151221513215142151521516215172151821519215202152121522215232152421525215262152721528215292153021531215322153321534215352153621537215382153921540215412154221543215442154521546215472154821549215502155121552215532155421555215562155721558215592156021561215622156321564215652156621567215682156921570215712157221573215742157521576215772157821579215802158121582215832158421585215862158721588215892159021591215922159321594215952159621597215982159921600216012160221603216042160521606216072160821609216102161121612216132161421615216162161721618216192162021621216222162321624216252162621627216282162921630216312163221633216342163521636216372163821639216402164121642216432164421645216462164721648216492165021651216522165321654216552165621657216582165921660216612166221663216642166521666216672166821669216702167121672216732167421675216762167721678216792168021681216822168321684216852168621687216882168921690216912169221693216942169521696216972169821699217002170121702217032170421705217062170721708217092171021711217122171321714217152171621717217182171921720217212172221723217242172521726217272172821729217302173121732217332173421735217362173721738217392174021741217422174321744217452174621747217482174921750217512175221753217542175521756217572175821759217602176121762217632176421765217662176721768217692177021771
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2. <html>
  3. <!-- Created by GNU Texinfo 5.2, http://www.gnu.org/software/texinfo/ -->
  4. <head>
  5. <meta charset="utf-8">
  6. <title>
  7. ffplay Documentation
  8. </title>
  9. <meta name="viewport" content="width=device-width,initial-scale=1.0">
  10. <link rel="stylesheet" type="text/css" href="bootstrap.min.css">
  11. <link rel="stylesheet" type="text/css" href="style.min.css">
  12. </head>
  13. <body>
  14. <div style="width: 95%; margin: auto">
  15. <h1>
  16. ffplay Documentation
  17. </h1>
  18. <div align="center">
  19. </div>
  20. <a name="SEC_Top"></a>
  21. <a name="SEC_Contents"></a>
  22. <h2 class="contents-heading">Table of Contents</h2>
  23. <div class="contents">
  24. <ul class="no-bullet">
  25. <li><a name="toc-Synopsis" href="#Synopsis">1 Synopsis</a></li>
  26. <li><a name="toc-Description" href="#Description">2 Description</a></li>
  27. <li><a name="toc-Options" href="#Options">3 Options</a>
  28. <ul class="no-bullet">
  29. <li><a name="toc-Stream-specifiers-1" href="#Stream-specifiers-1">3.1 Stream specifiers</a></li>
  30. <li><a name="toc-Generic-options" href="#Generic-options">3.2 Generic options</a></li>
  31. <li><a name="toc-AVOptions" href="#AVOptions">3.3 AVOptions</a></li>
  32. <li><a name="toc-Main-options" href="#Main-options">3.4 Main options</a></li>
  33. <li><a name="toc-Advanced-options" href="#Advanced-options">3.5 Advanced options</a></li>
  34. <li><a name="toc-While-playing" href="#While-playing">3.6 While playing</a></li>
  35. </ul></li>
  36. <li><a name="toc-Syntax" href="#Syntax">4 Syntax</a>
  37. <ul class="no-bullet">
  38. <li><a name="toc-Quoting-and-escaping" href="#Quoting-and-escaping">4.1 Quoting and escaping</a>
  39. <ul class="no-bullet">
  40. <li><a name="toc-Examples" href="#Examples">4.1.1 Examples</a></li>
  41. </ul></li>
  42. <li><a name="toc-Date" href="#Date">4.2 Date</a></li>
  43. <li><a name="toc-Time-duration" href="#Time-duration">4.3 Time duration</a>
  44. <ul class="no-bullet">
  45. <li><a name="toc-Examples-1" href="#Examples-1">4.3.1 Examples</a></li>
  46. </ul></li>
  47. <li><a name="toc-Video-size" href="#Video-size">4.4 Video size</a></li>
  48. <li><a name="toc-Video-rate" href="#Video-rate">4.5 Video rate</a></li>
  49. <li><a name="toc-Ratio" href="#Ratio">4.6 Ratio</a></li>
  50. <li><a name="toc-Color" href="#Color">4.7 Color</a></li>
  51. <li><a name="toc-Channel-Layout" href="#Channel-Layout">4.8 Channel Layout</a></li>
  52. </ul></li>
  53. <li><a name="toc-Expression-Evaluation" href="#Expression-Evaluation">5 Expression Evaluation</a></li>
  54. <li><a name="toc-OpenCL-Options" href="#OpenCL-Options">6 OpenCL Options</a></li>
  55. <li><a name="toc-Codec-Options" href="#Codec-Options">7 Codec Options</a></li>
  56. <li><a name="toc-Decoders" href="#Decoders">8 Decoders</a></li>
  57. <li><a name="toc-Video-Decoders" href="#Video-Decoders">9 Video Decoders</a>
  58. <ul class="no-bullet">
  59. <li><a name="toc-rawvideo" href="#rawvideo">9.1 rawvideo</a>
  60. <ul class="no-bullet">
  61. <li><a name="toc-Options-1" href="#Options-1">9.1.1 Options</a></li>
  62. </ul></li>
  63. </ul></li>
  64. <li><a name="toc-Audio-Decoders" href="#Audio-Decoders">10 Audio Decoders</a>
  65. <ul class="no-bullet">
  66. <li><a name="toc-ac3" href="#ac3">10.1 ac3</a>
  67. <ul class="no-bullet">
  68. <li><a name="toc-AC_002d3-Decoder-Options" href="#AC_002d3-Decoder-Options">10.1.1 AC-3 Decoder Options</a></li>
  69. </ul></li>
  70. <li><a name="toc-ffwavesynth" href="#ffwavesynth">10.2 ffwavesynth</a></li>
  71. <li><a name="toc-libcelt" href="#libcelt">10.3 libcelt</a></li>
  72. <li><a name="toc-libgsm" href="#libgsm">10.4 libgsm</a></li>
  73. <li><a name="toc-libilbc" href="#libilbc">10.5 libilbc</a>
  74. <ul class="no-bullet">
  75. <li><a name="toc-Options-2" href="#Options-2">10.5.1 Options</a></li>
  76. </ul></li>
  77. <li><a name="toc-libopencore_002damrnb" href="#libopencore_002damrnb">10.6 libopencore-amrnb</a></li>
  78. <li><a name="toc-libopencore_002damrwb" href="#libopencore_002damrwb">10.7 libopencore-amrwb</a></li>
  79. <li><a name="toc-libopus" href="#libopus">10.8 libopus</a></li>
  80. </ul></li>
  81. <li><a name="toc-Subtitles-Decoders" href="#Subtitles-Decoders">11 Subtitles Decoders</a>
  82. <ul class="no-bullet">
  83. <li><a name="toc-dvdsub" href="#dvdsub">11.1 dvdsub</a>
  84. <ul class="no-bullet">
  85. <li><a name="toc-Options-3" href="#Options-3">11.1.1 Options</a></li>
  86. </ul></li>
  87. <li><a name="toc-libzvbi_002dteletext" href="#libzvbi_002dteletext">11.2 libzvbi-teletext</a>
  88. <ul class="no-bullet">
  89. <li><a name="toc-Options-4" href="#Options-4">11.2.1 Options</a></li>
  90. </ul></li>
  91. </ul></li>
  92. <li><a name="toc-Bitstream-Filters" href="#Bitstream-Filters">12 Bitstream Filters</a>
  93. <ul class="no-bullet">
  94. <li><a name="toc-aac_005fadtstoasc" href="#aac_005fadtstoasc">12.1 aac_adtstoasc</a></li>
  95. <li><a name="toc-chomp" href="#chomp">12.2 chomp</a></li>
  96. <li><a name="toc-dump_005fextra" href="#dump_005fextra">12.3 dump_extra</a></li>
  97. <li><a name="toc-h264_005fmp4toannexb" href="#h264_005fmp4toannexb">12.4 h264_mp4toannexb</a></li>
  98. <li><a name="toc-imxdump" href="#imxdump">12.5 imxdump</a></li>
  99. <li><a name="toc-mjpeg2jpeg" href="#mjpeg2jpeg">12.6 mjpeg2jpeg</a></li>
  100. <li><a name="toc-mjpega_005fdump_005fheader" href="#mjpega_005fdump_005fheader">12.7 mjpega_dump_header</a></li>
  101. <li><a name="toc-movsub" href="#movsub">12.8 movsub</a></li>
  102. <li><a name="toc-mp3_005fheader_005fdecompress" href="#mp3_005fheader_005fdecompress">12.9 mp3_header_decompress</a></li>
  103. <li><a name="toc-noise" href="#noise">12.10 noise</a></li>
  104. <li><a name="toc-remove_005fextra" href="#remove_005fextra">12.11 remove_extra</a></li>
  105. </ul></li>
  106. <li><a name="toc-Format-Options" href="#Format-Options">13 Format Options</a>
  107. <ul class="no-bullet">
  108. <li><a name="toc-Format-stream-specifiers-1" href="#Format-stream-specifiers-1">13.1 Format stream specifiers</a></li>
  109. </ul></li>
  110. <li><a name="toc-Demuxers" href="#Demuxers">14 Demuxers</a>
  111. <ul class="no-bullet">
  112. <li><a name="toc-applehttp" href="#applehttp">14.1 applehttp</a></li>
  113. <li><a name="toc-apng" href="#apng">14.2 apng</a></li>
  114. <li><a name="toc-asf" href="#asf">14.3 asf</a></li>
  115. <li><a name="toc-concat-1" href="#concat-1">14.4 concat</a>
  116. <ul class="no-bullet">
  117. <li><a name="toc-Syntax-1" href="#Syntax-1">14.4.1 Syntax</a></li>
  118. <li><a name="toc-Options-5" href="#Options-5">14.4.2 Options</a></li>
  119. </ul></li>
  120. <li><a name="toc-flv" href="#flv">14.5 flv</a></li>
  121. <li><a name="toc-libgme" href="#libgme">14.6 libgme</a></li>
  122. <li><a name="toc-libquvi" href="#libquvi">14.7 libquvi</a></li>
  123. <li><a name="toc-gif" href="#gif">14.8 gif</a></li>
  124. <li><a name="toc-image2" href="#image2">14.9 image2</a>
  125. <ul class="no-bullet">
  126. <li><a name="toc-Examples-2" href="#Examples-2">14.9.1 Examples</a></li>
  127. </ul></li>
  128. <li><a name="toc-mpegts" href="#mpegts">14.10 mpegts</a></li>
  129. <li><a name="toc-rawvideo-1" href="#rawvideo-1">14.11 rawvideo</a></li>
  130. <li><a name="toc-sbg" href="#sbg">14.12 sbg</a></li>
  131. <li><a name="toc-tedcaptions" href="#tedcaptions">14.13 tedcaptions</a></li>
  132. </ul></li>
  133. <li><a name="toc-Metadata" href="#Metadata">15 Metadata</a></li>
  134. <li><a name="toc-Protocols" href="#Protocols">16 Protocols</a>
  135. <ul class="no-bullet">
  136. <li><a name="toc-bluray" href="#bluray">16.1 bluray</a></li>
  137. <li><a name="toc-cache" href="#cache">16.2 cache</a></li>
  138. <li><a name="toc-concat-2" href="#concat-2">16.3 concat</a></li>
  139. <li><a name="toc-crypto" href="#crypto">16.4 crypto</a></li>
  140. <li><a name="toc-data" href="#data">16.5 data</a></li>
  141. <li><a name="toc-file" href="#file">16.6 file</a></li>
  142. <li><a name="toc-ftp" href="#ftp">16.7 ftp</a></li>
  143. <li><a name="toc-gopher" href="#gopher">16.8 gopher</a></li>
  144. <li><a name="toc-hls" href="#hls">16.9 hls</a></li>
  145. <li><a name="toc-http" href="#http">16.10 http</a>
  146. <ul class="no-bullet">
  147. <li><a name="toc-HTTP-Cookies" href="#HTTP-Cookies">16.10.1 HTTP Cookies</a></li>
  148. </ul></li>
  149. <li><a name="toc-Icecast" href="#Icecast">16.11 Icecast</a></li>
  150. <li><a name="toc-mmst" href="#mmst">16.12 mmst</a></li>
  151. <li><a name="toc-mmsh" href="#mmsh">16.13 mmsh</a></li>
  152. <li><a name="toc-md5" href="#md5">16.14 md5</a></li>
  153. <li><a name="toc-pipe" href="#pipe">16.15 pipe</a></li>
  154. <li><a name="toc-rtmp" href="#rtmp">16.16 rtmp</a></li>
  155. <li><a name="toc-rtmpe" href="#rtmpe">16.17 rtmpe</a></li>
  156. <li><a name="toc-rtmps" href="#rtmps">16.18 rtmps</a></li>
  157. <li><a name="toc-rtmpt" href="#rtmpt">16.19 rtmpt</a></li>
  158. <li><a name="toc-rtmpte" href="#rtmpte">16.20 rtmpte</a></li>
  159. <li><a name="toc-rtmpts" href="#rtmpts">16.21 rtmpts</a></li>
  160. <li><a name="toc-libsmbclient" href="#libsmbclient">16.22 libsmbclient</a></li>
  161. <li><a name="toc-libssh" href="#libssh">16.23 libssh</a></li>
  162. <li><a name="toc-librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte" href="#librtmp-rtmp_002c-rtmpe_002c-rtmps_002c-rtmpt_002c-rtmpte">16.24 librtmp rtmp, rtmpe, rtmps, rtmpt, rtmpte</a></li>
  163. <li><a name="toc-rtp" href="#rtp">16.25 rtp</a></li>
  164. <li><a name="toc-rtsp" href="#rtsp">16.26 rtsp</a>
  165. <ul class="no-bullet">
  166. <li><a name="toc-Examples-3" href="#Examples-3">16.26.1 Examples</a></li>
  167. </ul></li>
  168. <li><a name="toc-sap" href="#sap">16.27 sap</a>
  169. <ul class="no-bullet">
  170. <li><a name="toc-Muxer" href="#Muxer">16.27.1 Muxer</a></li>
  171. <li><a name="toc-Demuxer" href="#Demuxer">16.27.2 Demuxer</a></li>
  172. </ul></li>
  173. <li><a name="toc-sctp" href="#sctp">16.28 sctp</a></li>
  174. <li><a name="toc-srtp" href="#srtp">16.29 srtp</a></li>
  175. <li><a name="toc-subfile" href="#subfile">16.30 subfile</a></li>
  176. <li><a name="toc-tcp" href="#tcp">16.31 tcp</a></li>
  177. <li><a name="toc-tls" href="#tls">16.32 tls</a></li>
  178. <li><a name="toc-udp" href="#udp">16.33 udp</a>
  179. <ul class="no-bullet">
  180. <li><a name="toc-Examples-4" href="#Examples-4">16.33.1 Examples</a></li>
  181. </ul></li>
  182. <li><a name="toc-unix" href="#unix">16.34 unix</a></li>
  183. </ul></li>
  184. <li><a name="toc-Device-Options" href="#Device-Options">17 Device Options</a></li>
  185. <li><a name="toc-Input-Devices" href="#Input-Devices">18 Input Devices</a>
  186. <ul class="no-bullet">
  187. <li><a name="toc-alsa" href="#alsa">18.1 alsa</a></li>
  188. <li><a name="toc-avfoundation" href="#avfoundation">18.2 avfoundation</a>
  189. <ul class="no-bullet">
  190. <li><a name="toc-Options-6" href="#Options-6">18.2.1 Options</a></li>
  191. <li><a name="toc-Examples-5" href="#Examples-5">18.2.2 Examples</a></li>
  192. </ul></li>
  193. <li><a name="toc-bktr" href="#bktr">18.3 bktr</a></li>
  194. <li><a name="toc-decklink" href="#decklink">18.4 decklink</a>
  195. <ul class="no-bullet">
  196. <li><a name="toc-Options-7" href="#Options-7">18.4.1 Options</a></li>
  197. <li><a name="toc-Examples-6" href="#Examples-6">18.4.2 Examples</a></li>
  198. </ul></li>
  199. <li><a name="toc-dshow" href="#dshow">18.5 dshow</a>
  200. <ul class="no-bullet">
  201. <li><a name="toc-Options-8" href="#Options-8">18.5.1 Options</a></li>
  202. <li><a name="toc-Examples-7" href="#Examples-7">18.5.2 Examples</a></li>
  203. </ul></li>
  204. <li><a name="toc-dv1394" href="#dv1394">18.6 dv1394</a></li>
  205. <li><a name="toc-fbdev" href="#fbdev">18.7 fbdev</a></li>
  206. <li><a name="toc-gdigrab" href="#gdigrab">18.8 gdigrab</a>
  207. <ul class="no-bullet">
  208. <li><a name="toc-Options-9" href="#Options-9">18.8.1 Options</a></li>
  209. </ul></li>
  210. <li><a name="toc-iec61883" href="#iec61883">18.9 iec61883</a>
  211. <ul class="no-bullet">
  212. <li><a name="toc-Options-10" href="#Options-10">18.9.1 Options</a></li>
  213. <li><a name="toc-Examples-8" href="#Examples-8">18.9.2 Examples</a></li>
  214. </ul></li>
  215. <li><a name="toc-jack" href="#jack">18.10 jack</a></li>
  216. <li><a name="toc-lavfi" href="#lavfi">18.11 lavfi</a>
  217. <ul class="no-bullet">
  218. <li><a name="toc-Options-11" href="#Options-11">18.11.1 Options</a></li>
  219. <li><a name="toc-Examples-9" href="#Examples-9">18.11.2 Examples</a></li>
  220. </ul></li>
  221. <li><a name="toc-libcdio" href="#libcdio">18.12 libcdio</a>
  222. <ul class="no-bullet">
  223. <li><a name="toc-Options-12" href="#Options-12">18.12.1 Options</a></li>
  224. </ul></li>
  225. <li><a name="toc-libdc1394" href="#libdc1394">18.13 libdc1394</a></li>
  226. <li><a name="toc-openal" href="#openal">18.14 openal</a>
  227. <ul class="no-bullet">
  228. <li><a name="toc-Options-13" href="#Options-13">18.14.1 Options</a></li>
  229. <li><a name="toc-Examples-10" href="#Examples-10">18.14.2 Examples</a></li>
  230. </ul></li>
  231. <li><a name="toc-oss" href="#oss">18.15 oss</a></li>
  232. <li><a name="toc-pulse" href="#pulse">18.16 pulse</a>
  233. <ul class="no-bullet">
  234. <li><a name="toc-Options-14" href="#Options-14">18.16.1 Options</a></li>
  235. <li><a name="toc-Examples-11" href="#Examples-11">18.16.2 Examples</a></li>
  236. </ul></li>
  237. <li><a name="toc-qtkit" href="#qtkit">18.17 qtkit</a></li>
  238. <li><a name="toc-sndio" href="#sndio">18.18 sndio</a></li>
  239. <li><a name="toc-video4linux2_002c-v4l2" href="#video4linux2_002c-v4l2">18.19 video4linux2, v4l2</a>
  240. <ul class="no-bullet">
  241. <li><a name="toc-Options-15" href="#Options-15">18.19.1 Options</a></li>
  242. </ul></li>
  243. <li><a name="toc-vfwcap" href="#vfwcap">18.20 vfwcap</a></li>
  244. <li><a name="toc-x11grab" href="#x11grab">18.21 x11grab</a>
  245. <ul class="no-bullet">
  246. <li><a name="toc-Options-16" href="#Options-16">18.21.1 Options</a></li>
  247. <li><a name="toc-grab_005fx-grab_005fy-AVOption" href="#grab_005fx-grab_005fy-AVOption">18.21.2 <var>grab_x</var> <var>grab_y</var> AVOption</a></li>
  248. </ul></li>
  249. </ul></li>
  250. <li><a name="toc-Resampler-Options" href="#Resampler-Options">19 Resampler Options</a></li>
  251. <li><a name="toc-Scaler-Options" href="#Scaler-Options">20 Scaler Options</a></li>
  252. <li><a name="toc-Filtering-Introduction" href="#Filtering-Introduction">21 Filtering Introduction</a></li>
  253. <li><a name="toc-graph2dot" href="#graph2dot">22 graph2dot</a></li>
  254. <li><a name="toc-Filtergraph-description" href="#Filtergraph-description">23 Filtergraph description</a>
  255. <ul class="no-bullet">
  256. <li><a name="toc-Filtergraph-syntax-1" href="#Filtergraph-syntax-1">23.1 Filtergraph syntax</a></li>
  257. <li><a name="toc-Notes-on-filtergraph-escaping" href="#Notes-on-filtergraph-escaping">23.2 Notes on filtergraph escaping</a></li>
  258. </ul></li>
  259. <li><a name="toc-Timeline-editing" href="#Timeline-editing">24 Timeline editing</a></li>
  260. <li><a name="toc-Audio-Filters" href="#Audio-Filters">25 Audio Filters</a>
  261. <ul class="no-bullet">
  262. <li><a name="toc-adelay" href="#adelay">25.1 adelay</a>
  263. <ul class="no-bullet">
  264. <li><a name="toc-Examples-12" href="#Examples-12">25.1.1 Examples</a></li>
  265. </ul></li>
  266. <li><a name="toc-aecho" href="#aecho">25.2 aecho</a>
  267. <ul class="no-bullet">
  268. <li><a name="toc-Examples-13" href="#Examples-13">25.2.1 Examples</a></li>
  269. </ul></li>
  270. <li><a name="toc-aeval" href="#aeval">25.3 aeval</a>
  271. <ul class="no-bullet">
  272. <li><a name="toc-Examples-14" href="#Examples-14">25.3.1 Examples</a></li>
  273. </ul></li>
  274. <li><a name="toc-afade" href="#afade">25.4 afade</a>
  275. <ul class="no-bullet">
  276. <li><a name="toc-Examples-15" href="#Examples-15">25.4.1 Examples</a></li>
  277. </ul></li>
  278. <li><a name="toc-aformat-1" href="#aformat-1">25.5 aformat</a></li>
  279. <li><a name="toc-allpass" href="#allpass">25.6 allpass</a></li>
  280. <li><a name="toc-amerge" href="#amerge">25.7 amerge</a>
  281. <ul class="no-bullet">
  282. <li><a name="toc-Examples-16" href="#Examples-16">25.7.1 Examples</a></li>
  283. </ul></li>
  284. <li><a name="toc-amix" href="#amix">25.8 amix</a></li>
  285. <li><a name="toc-anull" href="#anull">25.9 anull</a></li>
  286. <li><a name="toc-apad" href="#apad">25.10 apad</a>
  287. <ul class="no-bullet">
  288. <li><a name="toc-Examples-17" href="#Examples-17">25.10.1 Examples</a></li>
  289. </ul></li>
  290. <li><a name="toc-aphaser" href="#aphaser">25.11 aphaser</a></li>
  291. <li><a name="toc-aresample-1" href="#aresample-1">25.12 aresample</a>
  292. <ul class="no-bullet">
  293. <li><a name="toc-Examples-18" href="#Examples-18">25.12.1 Examples</a></li>
  294. </ul></li>
  295. <li><a name="toc-asetnsamples" href="#asetnsamples">25.13 asetnsamples</a></li>
  296. <li><a name="toc-asetrate" href="#asetrate">25.14 asetrate</a></li>
  297. <li><a name="toc-ashowinfo" href="#ashowinfo">25.15 ashowinfo</a></li>
  298. <li><a name="toc-astats-1" href="#astats-1">25.16 astats</a></li>
  299. <li><a name="toc-astreamsync" href="#astreamsync">25.17 astreamsync</a>
  300. <ul class="no-bullet">
  301. <li><a name="toc-Examples-19" href="#Examples-19">25.17.1 Examples</a></li>
  302. </ul></li>
  303. <li><a name="toc-asyncts" href="#asyncts">25.18 asyncts</a></li>
  304. <li><a name="toc-atempo" href="#atempo">25.19 atempo</a>
  305. <ul class="no-bullet">
  306. <li><a name="toc-Examples-20" href="#Examples-20">25.19.1 Examples</a></li>
  307. </ul></li>
  308. <li><a name="toc-atrim" href="#atrim">25.20 atrim</a></li>
  309. <li><a name="toc-bandpass" href="#bandpass">25.21 bandpass</a></li>
  310. <li><a name="toc-bandreject" href="#bandreject">25.22 bandreject</a></li>
  311. <li><a name="toc-bass" href="#bass">25.23 bass</a></li>
  312. <li><a name="toc-biquad" href="#biquad">25.24 biquad</a></li>
  313. <li><a name="toc-bs2b" href="#bs2b">25.25 bs2b</a></li>
  314. <li><a name="toc-channelmap" href="#channelmap">25.26 channelmap</a></li>
  315. <li><a name="toc-channelsplit" href="#channelsplit">25.27 channelsplit</a></li>
  316. <li><a name="toc-compand" href="#compand">25.28 compand</a>
  317. <ul class="no-bullet">
  318. <li><a name="toc-Examples-21" href="#Examples-21">25.28.1 Examples</a></li>
  319. </ul></li>
  320. <li><a name="toc-dcshift" href="#dcshift">25.29 dcshift</a></li>
  321. <li><a name="toc-earwax" href="#earwax">25.30 earwax</a></li>
  322. <li><a name="toc-equalizer" href="#equalizer">25.31 equalizer</a>
  323. <ul class="no-bullet">
  324. <li><a name="toc-Examples-22" href="#Examples-22">25.31.1 Examples</a></li>
  325. </ul></li>
  326. <li><a name="toc-flanger" href="#flanger">25.32 flanger</a></li>
  327. <li><a name="toc-highpass" href="#highpass">25.33 highpass</a></li>
  328. <li><a name="toc-join" href="#join">25.34 join</a></li>
  329. <li><a name="toc-ladspa" href="#ladspa">25.35 ladspa</a>
  330. <ul class="no-bullet">
  331. <li><a name="toc-Examples-23" href="#Examples-23">25.35.1 Examples</a></li>
  332. <li><a name="toc-Commands" href="#Commands">25.35.2 Commands</a></li>
  333. </ul></li>
  334. <li><a name="toc-lowpass" href="#lowpass">25.36 lowpass</a></li>
  335. <li><a name="toc-pan" href="#pan">25.37 pan</a>
  336. <ul class="no-bullet">
  337. <li><a name="toc-Mixing-examples" href="#Mixing-examples">25.37.1 Mixing examples</a></li>
  338. <li><a name="toc-Remapping-examples" href="#Remapping-examples">25.37.2 Remapping examples</a></li>
  339. </ul></li>
  340. <li><a name="toc-replaygain" href="#replaygain">25.38 replaygain</a></li>
  341. <li><a name="toc-resample" href="#resample">25.39 resample</a></li>
  342. <li><a name="toc-silencedetect" href="#silencedetect">25.40 silencedetect</a>
  343. <ul class="no-bullet">
  344. <li><a name="toc-Examples-24" href="#Examples-24">25.40.1 Examples</a></li>
  345. </ul></li>
  346. <li><a name="toc-silenceremove" href="#silenceremove">25.41 silenceremove</a>
  347. <ul class="no-bullet">
  348. <li><a name="toc-Examples-25" href="#Examples-25">25.41.1 Examples</a></li>
  349. </ul></li>
  350. <li><a name="toc-treble" href="#treble">25.42 treble</a></li>
  351. <li><a name="toc-volume" href="#volume">25.43 volume</a>
  352. <ul class="no-bullet">
  353. <li><a name="toc-Commands-1" href="#Commands-1">25.43.1 Commands</a></li>
  354. <li><a name="toc-Examples-26" href="#Examples-26">25.43.2 Examples</a></li>
  355. </ul></li>
  356. <li><a name="toc-volumedetect" href="#volumedetect">25.44 volumedetect</a>
  357. <ul class="no-bullet">
  358. <li><a name="toc-Examples-27" href="#Examples-27">25.44.1 Examples</a></li>
  359. </ul></li>
  360. </ul></li>
  361. <li><a name="toc-Audio-Sources" href="#Audio-Sources">26 Audio Sources</a>
  362. <ul class="no-bullet">
  363. <li><a name="toc-abuffer" href="#abuffer">26.1 abuffer</a>
  364. <ul class="no-bullet">
  365. <li><a name="toc-Examples-28" href="#Examples-28">26.1.1 Examples</a></li>
  366. </ul></li>
  367. <li><a name="toc-aevalsrc" href="#aevalsrc">26.2 aevalsrc</a>
  368. <ul class="no-bullet">
  369. <li><a name="toc-Examples-29" href="#Examples-29">26.2.1 Examples</a></li>
  370. </ul></li>
  371. <li><a name="toc-anullsrc" href="#anullsrc">26.3 anullsrc</a>
  372. <ul class="no-bullet">
  373. <li><a name="toc-Examples-30" href="#Examples-30">26.3.1 Examples</a></li>
  374. </ul></li>
  375. <li><a name="toc-flite" href="#flite">26.4 flite</a>
  376. <ul class="no-bullet">
  377. <li><a name="toc-Examples-31" href="#Examples-31">26.4.1 Examples</a></li>
  378. </ul></li>
  379. <li><a name="toc-sine" href="#sine">26.5 sine</a>
  380. <ul class="no-bullet">
  381. <li><a name="toc-Examples-32" href="#Examples-32">26.5.1 Examples</a></li>
  382. </ul></li>
  383. </ul></li>
  384. <li><a name="toc-Audio-Sinks" href="#Audio-Sinks">27 Audio Sinks</a>
  385. <ul class="no-bullet">
  386. <li><a name="toc-abuffersink" href="#abuffersink">27.1 abuffersink</a></li>
  387. <li><a name="toc-anullsink" href="#anullsink">27.2 anullsink</a></li>
  388. </ul></li>
  389. <li><a name="toc-Video-Filters" href="#Video-Filters">28 Video Filters</a>
  390. <ul class="no-bullet">
  391. <li><a name="toc-alphaextract" href="#alphaextract">28.1 alphaextract</a></li>
  392. <li><a name="toc-alphamerge" href="#alphamerge">28.2 alphamerge</a></li>
  393. <li><a name="toc-ass" href="#ass">28.3 ass</a></li>
  394. <li><a name="toc-bbox" href="#bbox">28.4 bbox</a></li>
  395. <li><a name="toc-blackdetect" href="#blackdetect">28.5 blackdetect</a></li>
  396. <li><a name="toc-blackframe" href="#blackframe">28.6 blackframe</a></li>
  397. <li><a name="toc-blend_002c-tblend" href="#blend_002c-tblend">28.7 blend, tblend</a>
  398. <ul class="no-bullet">
  399. <li><a name="toc-Examples-33" href="#Examples-33">28.7.1 Examples</a></li>
  400. </ul></li>
  401. <li><a name="toc-boxblur" href="#boxblur">28.8 boxblur</a>
  402. <ul class="no-bullet">
  403. <li><a name="toc-Examples-34" href="#Examples-34">28.8.1 Examples</a></li>
  404. </ul></li>
  405. <li><a name="toc-codecview" href="#codecview">28.9 codecview</a>
  406. <ul class="no-bullet">
  407. <li><a name="toc-Examples-35" href="#Examples-35">28.9.1 Examples</a></li>
  408. </ul></li>
  409. <li><a name="toc-colorbalance" href="#colorbalance">28.10 colorbalance</a>
  410. <ul class="no-bullet">
  411. <li><a name="toc-Examples-36" href="#Examples-36">28.10.1 Examples</a></li>
  412. </ul></li>
  413. <li><a name="toc-colorlevels" href="#colorlevels">28.11 colorlevels</a>
  414. <ul class="no-bullet">
  415. <li><a name="toc-Examples-37" href="#Examples-37">28.11.1 Examples</a></li>
  416. </ul></li>
  417. <li><a name="toc-colorchannelmixer" href="#colorchannelmixer">28.12 colorchannelmixer</a>
  418. <ul class="no-bullet">
  419. <li><a name="toc-Examples-38" href="#Examples-38">28.12.1 Examples</a></li>
  420. </ul></li>
  421. <li><a name="toc-colormatrix" href="#colormatrix">28.13 colormatrix</a></li>
  422. <li><a name="toc-copy" href="#copy">28.14 copy</a></li>
  423. <li><a name="toc-crop" href="#crop">28.15 crop</a>
  424. <ul class="no-bullet">
  425. <li><a name="toc-Examples-39" href="#Examples-39">28.15.1 Examples</a></li>
  426. </ul></li>
  427. <li><a name="toc-cropdetect" href="#cropdetect">28.16 cropdetect</a></li>
  428. <li><a name="toc-curves-1" href="#curves-1">28.17 curves</a>
  429. <ul class="no-bullet">
  430. <li><a name="toc-Examples-40" href="#Examples-40">28.17.1 Examples</a></li>
  431. </ul></li>
  432. <li><a name="toc-dctdnoiz" href="#dctdnoiz">28.18 dctdnoiz</a>
  433. <ul class="no-bullet">
  434. <li><a name="toc-Examples-41" href="#Examples-41">28.18.1 Examples</a></li>
  435. </ul></li>
  436. <li><a name="toc-decimate-1" href="#decimate-1">28.19 decimate</a></li>
  437. <li><a name="toc-dejudder" href="#dejudder">28.20 dejudder</a></li>
  438. <li><a name="toc-delogo" href="#delogo">28.21 delogo</a>
  439. <ul class="no-bullet">
  440. <li><a name="toc-Examples-42" href="#Examples-42">28.21.1 Examples</a></li>
  441. </ul></li>
  442. <li><a name="toc-deshake" href="#deshake">28.22 deshake</a></li>
  443. <li><a name="toc-drawbox" href="#drawbox">28.23 drawbox</a>
  444. <ul class="no-bullet">
  445. <li><a name="toc-Examples-43" href="#Examples-43">28.23.1 Examples</a></li>
  446. </ul></li>
  447. <li><a name="toc-drawgrid" href="#drawgrid">28.24 drawgrid</a>
  448. <ul class="no-bullet">
  449. <li><a name="toc-Examples-44" href="#Examples-44">28.24.1 Examples</a></li>
  450. </ul></li>
  451. <li><a name="toc-drawtext-1" href="#drawtext-1">28.25 drawtext</a>
  452. <ul class="no-bullet">
  453. <li><a name="toc-Syntax-2" href="#Syntax-2">28.25.1 Syntax</a></li>
  454. <li><a name="toc-Text-expansion" href="#Text-expansion">28.25.2 Text expansion</a></li>
  455. <li><a name="toc-Examples-45" href="#Examples-45">28.25.3 Examples</a></li>
  456. </ul></li>
  457. <li><a name="toc-edgedetect" href="#edgedetect">28.26 edgedetect</a>
  458. <ul class="no-bullet">
  459. <li><a name="toc-Examples-46" href="#Examples-46">28.26.1 Examples</a></li>
  460. </ul></li>
  461. <li><a name="toc-eq" href="#eq">28.27 eq</a>
  462. <ul class="no-bullet">
  463. <li><a name="toc-Commands-2" href="#Commands-2">28.27.1 Commands</a></li>
  464. </ul></li>
  465. <li><a name="toc-extractplanes" href="#extractplanes">28.28 extractplanes</a>
  466. <ul class="no-bullet">
  467. <li><a name="toc-Examples-47" href="#Examples-47">28.28.1 Examples</a></li>
  468. </ul></li>
  469. <li><a name="toc-elbg" href="#elbg">28.29 elbg</a></li>
  470. <li><a name="toc-fade" href="#fade">28.30 fade</a>
  471. <ul class="no-bullet">
  472. <li><a name="toc-Examples-48" href="#Examples-48">28.30.1 Examples</a></li>
  473. </ul></li>
  474. <li><a name="toc-field" href="#field">28.31 field</a></li>
  475. <li><a name="toc-fieldmatch" href="#fieldmatch">28.32 fieldmatch</a>
  476. <ul class="no-bullet">
  477. <li><a name="toc-p_002fc_002fn_002fu_002fb-meaning-1" href="#p_002fc_002fn_002fu_002fb-meaning-1">28.32.1 p/c/n/u/b meaning</a>
  478. <ul class="no-bullet">
  479. <li><a name="toc-p_002fc_002fn" href="#p_002fc_002fn">28.32.1.1 p/c/n</a></li>
  480. <li><a name="toc-u_002fb" href="#u_002fb">28.32.1.2 u/b</a></li>
  481. </ul></li>
  482. <li><a name="toc-Examples-49" href="#Examples-49">28.32.2 Examples</a></li>
  483. </ul></li>
  484. <li><a name="toc-fieldorder" href="#fieldorder">28.33 fieldorder</a></li>
  485. <li><a name="toc-fifo" href="#fifo">28.34 fifo</a></li>
  486. <li><a name="toc-format-1" href="#format-1">28.35 format</a>
  487. <ul class="no-bullet">
  488. <li><a name="toc-Examples-50" href="#Examples-50">28.35.1 Examples</a></li>
  489. </ul></li>
  490. <li><a name="toc-fps-1" href="#fps-1">28.36 fps</a>
  491. <ul class="no-bullet">
  492. <li><a name="toc-Examples-51" href="#Examples-51">28.36.1 Examples</a></li>
  493. </ul></li>
  494. <li><a name="toc-framepack" href="#framepack">28.37 framepack</a></li>
  495. <li><a name="toc-framestep" href="#framestep">28.38 framestep</a></li>
  496. <li><a name="toc-frei0r-1" href="#frei0r-1">28.39 frei0r</a>
  497. <ul class="no-bullet">
  498. <li><a name="toc-Examples-52" href="#Examples-52">28.39.1 Examples</a></li>
  499. </ul></li>
  500. <li><a name="toc-fspp" href="#fspp">28.40 fspp</a></li>
  501. <li><a name="toc-geq" href="#geq">28.41 geq</a>
  502. <ul class="no-bullet">
  503. <li><a name="toc-Examples-53" href="#Examples-53">28.41.1 Examples</a></li>
  504. </ul></li>
  505. <li><a name="toc-gradfun" href="#gradfun">28.42 gradfun</a>
  506. <ul class="no-bullet">
  507. <li><a name="toc-Examples-54" href="#Examples-54">28.42.1 Examples</a></li>
  508. </ul></li>
  509. <li><a name="toc-haldclut-1" href="#haldclut-1">28.43 haldclut</a>
  510. <ul class="no-bullet">
  511. <li><a name="toc-Workflow-examples" href="#Workflow-examples">28.43.1 Workflow examples</a>
  512. <ul class="no-bullet">
  513. <li><a name="toc-Hald-CLUT-video-stream" href="#Hald-CLUT-video-stream">28.43.1.1 Hald CLUT video stream</a></li>
  514. <li><a name="toc-Hald-CLUT-with-preview" href="#Hald-CLUT-with-preview">28.43.1.2 Hald CLUT with preview</a></li>
  515. </ul></li>
  516. </ul></li>
  517. <li><a name="toc-hflip" href="#hflip">28.44 hflip</a></li>
  518. <li><a name="toc-histeq" href="#histeq">28.45 histeq</a></li>
  519. <li><a name="toc-histogram" href="#histogram">28.46 histogram</a>
  520. <ul class="no-bullet">
  521. <li><a name="toc-Examples-55" href="#Examples-55">28.46.1 Examples</a></li>
  522. </ul></li>
  523. <li><a name="toc-hqdn3d-1" href="#hqdn3d-1">28.47 hqdn3d</a></li>
  524. <li><a name="toc-hqx" href="#hqx">28.48 hqx</a></li>
  525. <li><a name="toc-hue" href="#hue">28.49 hue</a>
  526. <ul class="no-bullet">
  527. <li><a name="toc-Examples-56" href="#Examples-56">28.49.1 Examples</a></li>
  528. <li><a name="toc-Commands-3" href="#Commands-3">28.49.2 Commands</a></li>
  529. </ul></li>
  530. <li><a name="toc-idet" href="#idet">28.50 idet</a></li>
  531. <li><a name="toc-il" href="#il">28.51 il</a></li>
  532. <li><a name="toc-interlace" href="#interlace">28.52 interlace</a></li>
  533. <li><a name="toc-kerndeint" href="#kerndeint">28.53 kerndeint</a>
  534. <ul class="no-bullet">
  535. <li><a name="toc-Examples-57" href="#Examples-57">28.53.1 Examples</a></li>
  536. </ul></li>
  537. <li><a name="toc-lenscorrection" href="#lenscorrection">28.54 lenscorrection</a>
  538. <ul class="no-bullet">
  539. <li><a name="toc-Options-17" href="#Options-17">28.54.1 Options</a></li>
  540. </ul></li>
  541. <li><a name="toc-lut3d-1" href="#lut3d-1">28.55 lut3d</a></li>
  542. <li><a name="toc-lut_002c-lutrgb_002c-lutyuv" href="#lut_002c-lutrgb_002c-lutyuv">28.56 lut, lutrgb, lutyuv</a>
  543. <ul class="no-bullet">
  544. <li><a name="toc-Examples-58" href="#Examples-58">28.56.1 Examples</a></li>
  545. </ul></li>
  546. <li><a name="toc-mergeplanes" href="#mergeplanes">28.57 mergeplanes</a>
  547. <ul class="no-bullet">
  548. <li><a name="toc-Examples-59" href="#Examples-59">28.57.1 Examples</a></li>
  549. </ul></li>
  550. <li><a name="toc-mcdeint" href="#mcdeint">28.58 mcdeint</a></li>
  551. <li><a name="toc-mpdecimate" href="#mpdecimate">28.59 mpdecimate</a></li>
  552. <li><a name="toc-negate" href="#negate">28.60 negate</a></li>
  553. <li><a name="toc-noformat" href="#noformat">28.61 noformat</a>
  554. <ul class="no-bullet">
  555. <li><a name="toc-Examples-60" href="#Examples-60">28.61.1 Examples</a></li>
  556. </ul></li>
  557. <li><a name="toc-noise-1" href="#noise-1">28.62 noise</a>
  558. <ul class="no-bullet">
  559. <li><a name="toc-Examples-61" href="#Examples-61">28.62.1 Examples</a></li>
  560. </ul></li>
  561. <li><a name="toc-null" href="#null">28.63 null</a></li>
  562. <li><a name="toc-ocv" href="#ocv">28.64 ocv</a>
  563. <ul class="no-bullet">
  564. <li><a name="toc-dilate-1" href="#dilate-1">28.64.1 dilate</a></li>
  565. <li><a name="toc-erode" href="#erode">28.64.2 erode</a></li>
  566. <li><a name="toc-smooth" href="#smooth">28.64.3 smooth</a></li>
  567. </ul></li>
  568. <li><a name="toc-overlay-1" href="#overlay-1">28.65 overlay</a>
  569. <ul class="no-bullet">
  570. <li><a name="toc-Commands-4" href="#Commands-4">28.65.1 Commands</a></li>
  571. <li><a name="toc-Examples-62" href="#Examples-62">28.65.2 Examples</a></li>
  572. </ul></li>
  573. <li><a name="toc-owdenoise" href="#owdenoise">28.66 owdenoise</a></li>
  574. <li><a name="toc-pad" href="#pad">28.67 pad</a>
  575. <ul class="no-bullet">
  576. <li><a name="toc-Examples-63" href="#Examples-63">28.67.1 Examples</a></li>
  577. </ul></li>
  578. <li><a name="toc-palettegen-1" href="#palettegen-1">28.68 palettegen</a>
  579. <ul class="no-bullet">
  580. <li><a name="toc-Examples-64" href="#Examples-64">28.68.1 Examples</a></li>
  581. </ul></li>
  582. <li><a name="toc-paletteuse" href="#paletteuse">28.69 paletteuse</a>
  583. <ul class="no-bullet">
  584. <li><a name="toc-Examples-65" href="#Examples-65">28.69.1 Examples</a></li>
  585. </ul></li>
  586. <li><a name="toc-perspective" href="#perspective">28.70 perspective</a></li>
  587. <li><a name="toc-phase" href="#phase">28.71 phase</a></li>
  588. <li><a name="toc-pixdesctest" href="#pixdesctest">28.72 pixdesctest</a></li>
  589. <li><a name="toc-pp" href="#pp">28.73 pp</a>
  590. <ul class="no-bullet">
  591. <li><a name="toc-Examples-66" href="#Examples-66">28.73.1 Examples</a></li>
  592. </ul></li>
  593. <li><a name="toc-pp7" href="#pp7">28.74 pp7</a></li>
  594. <li><a name="toc-psnr" href="#psnr">28.75 psnr</a></li>
  595. <li><a name="toc-pullup-1" href="#pullup-1">28.76 pullup</a></li>
  596. <li><a name="toc-qp" href="#qp">28.77 qp</a>
  597. <ul class="no-bullet">
  598. <li><a name="toc-Examples-67" href="#Examples-67">28.77.1 Examples</a></li>
  599. </ul></li>
  600. <li><a name="toc-removelogo" href="#removelogo">28.78 removelogo</a></li>
  601. <li><a name="toc-repeatfields" href="#repeatfields">28.79 repeatfields</a></li>
  602. <li><a name="toc-rotate" href="#rotate">28.80 rotate</a>
  603. <ul class="no-bullet">
  604. <li><a name="toc-Examples-68" href="#Examples-68">28.80.1 Examples</a></li>
  605. <li><a name="toc-Commands-5" href="#Commands-5">28.80.2 Commands</a></li>
  606. </ul></li>
  607. <li><a name="toc-sab" href="#sab">28.81 sab</a></li>
  608. <li><a name="toc-scale-1" href="#scale-1">28.82 scale</a>
  609. <ul class="no-bullet">
  610. <li><a name="toc-Options-18" href="#Options-18">28.82.1 Options</a></li>
  611. <li><a name="toc-Examples-69" href="#Examples-69">28.82.2 Examples</a></li>
  612. </ul></li>
  613. <li><a name="toc-separatefields" href="#separatefields">28.83 separatefields</a></li>
  614. <li><a name="toc-setdar_002c-setsar" href="#setdar_002c-setsar">28.84 setdar, setsar</a>
  615. <ul class="no-bullet">
  616. <li><a name="toc-Examples-70" href="#Examples-70">28.84.1 Examples</a></li>
  617. </ul></li>
  618. <li><a name="toc-setfield-1" href="#setfield-1">28.85 setfield</a></li>
  619. <li><a name="toc-showinfo" href="#showinfo">28.86 showinfo</a></li>
  620. <li><a name="toc-showpalette" href="#showpalette">28.87 showpalette</a></li>
  621. <li><a name="toc-shuffleplanes" href="#shuffleplanes">28.88 shuffleplanes</a></li>
  622. <li><a name="toc-signalstats" href="#signalstats">28.89 signalstats</a>
  623. <ul class="no-bullet">
  624. <li><a name="toc-Examples-71" href="#Examples-71">28.89.1 Examples</a></li>
  625. </ul></li>
  626. <li><a name="toc-smartblur-1" href="#smartblur-1">28.90 smartblur</a></li>
  627. <li><a name="toc-stereo3d" href="#stereo3d">28.91 stereo3d</a>
  628. <ul class="no-bullet">
  629. <li><a name="toc-Examples-72" href="#Examples-72">28.91.1 Examples</a></li>
  630. </ul></li>
  631. <li><a name="toc-spp-1" href="#spp-1">28.92 spp</a></li>
  632. <li><a name="toc-subtitles-1" href="#subtitles-1">28.93 subtitles</a></li>
  633. <li><a name="toc-super2xsai" href="#super2xsai">28.94 super2xsai</a></li>
  634. <li><a name="toc-swapuv" href="#swapuv">28.95 swapuv</a></li>
  635. <li><a name="toc-telecine" href="#telecine">28.96 telecine</a></li>
  636. <li><a name="toc-thumbnail" href="#thumbnail">28.97 thumbnail</a>
  637. <ul class="no-bullet">
  638. <li><a name="toc-Examples-73" href="#Examples-73">28.97.1 Examples</a></li>
  639. </ul></li>
  640. <li><a name="toc-tile" href="#tile">28.98 tile</a>
  641. <ul class="no-bullet">
  642. <li><a name="toc-Examples-74" href="#Examples-74">28.98.1 Examples</a></li>
  643. </ul></li>
  644. <li><a name="toc-tinterlace" href="#tinterlace">28.99 tinterlace</a></li>
  645. <li><a name="toc-transpose" href="#transpose">28.100 transpose</a></li>
  646. <li><a name="toc-trim" href="#trim">28.101 trim</a></li>
  647. <li><a name="toc-unsharp-1" href="#unsharp-1">28.102 unsharp</a>
  648. <ul class="no-bullet">
  649. <li><a name="toc-Examples-75" href="#Examples-75">28.102.1 Examples</a></li>
  650. </ul></li>
  651. <li><a name="toc-uspp" href="#uspp">28.103 uspp</a></li>
  652. <li><a name="toc-vidstabdetect-1" href="#vidstabdetect-1">28.104 vidstabdetect</a>
  653. <ul class="no-bullet">
  654. <li><a name="toc-Examples-76" href="#Examples-76">28.104.1 Examples</a></li>
  655. </ul></li>
  656. <li><a name="toc-vidstabtransform-1" href="#vidstabtransform-1">28.105 vidstabtransform</a>
  657. <ul class="no-bullet">
  658. <li><a name="toc-Options-19" href="#Options-19">28.105.1 Options</a></li>
  659. <li><a name="toc-Examples-77" href="#Examples-77">28.105.2 Examples</a></li>
  660. </ul></li>
  661. <li><a name="toc-vflip" href="#vflip">28.106 vflip</a></li>
  662. <li><a name="toc-vignette-1" href="#vignette-1">28.107 vignette</a>
  663. <ul class="no-bullet">
  664. <li><a name="toc-Expressions" href="#Expressions">28.107.1 Expressions</a></li>
  665. <li><a name="toc-Examples-78" href="#Examples-78">28.107.2 Examples</a></li>
  666. </ul></li>
  667. <li><a name="toc-w3fdif" href="#w3fdif">28.108 w3fdif</a></li>
  668. <li><a name="toc-xbr" href="#xbr">28.109 xbr</a></li>
  669. <li><a name="toc-yadif-1" href="#yadif-1">28.110 yadif</a></li>
  670. <li><a name="toc-zoompan" href="#zoompan">28.111 zoompan</a>
  671. <ul class="no-bullet">
  672. <li><a name="toc-Examples-79" href="#Examples-79">28.111.1 Examples</a></li>
  673. </ul></li>
  674. </ul></li>
  675. <li><a name="toc-Video-Sources" href="#Video-Sources">29 Video Sources</a>
  676. <ul class="no-bullet">
  677. <li><a name="toc-buffer" href="#buffer">29.1 buffer</a></li>
  678. <li><a name="toc-cellauto" href="#cellauto">29.2 cellauto</a>
  679. <ul class="no-bullet">
  680. <li><a name="toc-Examples-80" href="#Examples-80">29.2.1 Examples</a></li>
  681. </ul></li>
  682. <li><a name="toc-mandelbrot" href="#mandelbrot">29.3 mandelbrot</a></li>
  683. <li><a name="toc-mptestsrc" href="#mptestsrc">29.4 mptestsrc</a></li>
  684. <li><a name="toc-frei0r_005fsrc" href="#frei0r_005fsrc">29.5 frei0r_src</a></li>
  685. <li><a name="toc-life" href="#life">29.6 life</a>
  686. <ul class="no-bullet">
  687. <li><a name="toc-Examples-81" href="#Examples-81">29.6.1 Examples</a></li>
  688. </ul></li>
  689. <li><a name="toc-color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc" href="#color_002c-haldclutsrc_002c-nullsrc_002c-rgbtestsrc_002c-smptebars_002c-smptehdbars_002c-testsrc">29.7 color, haldclutsrc, nullsrc, rgbtestsrc, smptebars, smptehdbars, testsrc</a>
  690. <ul class="no-bullet">
  691. <li><a name="toc-Commands-6" href="#Commands-6">29.7.1 Commands</a></li>
  692. </ul></li>
  693. </ul></li>
  694. <li><a name="toc-Video-Sinks" href="#Video-Sinks">30 Video Sinks</a>
  695. <ul class="no-bullet">
  696. <li><a name="toc-buffersink" href="#buffersink">30.1 buffersink</a></li>
  697. <li><a name="toc-nullsink" href="#nullsink">30.2 nullsink</a></li>
  698. </ul></li>
  699. <li><a name="toc-Multimedia-Filters" href="#Multimedia-Filters">31 Multimedia Filters</a>
  700. <ul class="no-bullet">
  701. <li><a name="toc-avectorscope" href="#avectorscope">31.1 avectorscope</a>
  702. <ul class="no-bullet">
  703. <li><a name="toc-Examples-82" href="#Examples-82">31.1.1 Examples</a></li>
  704. </ul></li>
  705. <li><a name="toc-concat-3" href="#concat-3">31.2 concat</a>
  706. <ul class="no-bullet">
  707. <li><a name="toc-Examples-83" href="#Examples-83">31.2.1 Examples</a></li>
  708. </ul></li>
  709. <li><a name="toc-ebur128" href="#ebur128">31.3 ebur128</a>
  710. <ul class="no-bullet">
  711. <li><a name="toc-Examples-84" href="#Examples-84">31.3.1 Examples</a></li>
  712. </ul></li>
  713. <li><a name="toc-interleave_002c-ainterleave" href="#interleave_002c-ainterleave">31.4 interleave, ainterleave</a>
  714. <ul class="no-bullet">
  715. <li><a name="toc-Examples-85" href="#Examples-85">31.4.1 Examples</a></li>
  716. </ul></li>
  717. <li><a name="toc-perms_002c-aperms" href="#perms_002c-aperms">31.5 perms, aperms</a></li>
  718. <li><a name="toc-select_002c-aselect" href="#select_002c-aselect">31.6 select, aselect</a>
  719. <ul class="no-bullet">
  720. <li><a name="toc-Examples-86" href="#Examples-86">31.6.1 Examples</a></li>
  721. </ul></li>
  722. <li><a name="toc-sendcmd_002c-asendcmd" href="#sendcmd_002c-asendcmd">31.7 sendcmd, asendcmd</a>
  723. <ul class="no-bullet">
  724. <li><a name="toc-Commands-syntax" href="#Commands-syntax">31.7.1 Commands syntax</a></li>
  725. <li><a name="toc-Examples-87" href="#Examples-87">31.7.2 Examples</a></li>
  726. </ul></li>
  727. <li><a name="toc-setpts_002c-asetpts" href="#setpts_002c-asetpts">31.8 setpts, asetpts</a>
  728. <ul class="no-bullet">
  729. <li><a name="toc-Examples-88" href="#Examples-88">31.8.1 Examples</a></li>
  730. </ul></li>
  731. <li><a name="toc-settb_002c-asettb" href="#settb_002c-asettb">31.9 settb, asettb</a>
  732. <ul class="no-bullet">
  733. <li><a name="toc-Examples-89" href="#Examples-89">31.9.1 Examples</a></li>
  734. </ul></li>
  735. <li><a name="toc-showcqt" href="#showcqt">31.10 showcqt</a>
  736. <ul class="no-bullet">
  737. <li><a name="toc-Examples-90" href="#Examples-90">31.10.1 Examples</a></li>
  738. </ul></li>
  739. <li><a name="toc-showspectrum" href="#showspectrum">31.11 showspectrum</a>
  740. <ul class="no-bullet">
  741. <li><a name="toc-Examples-91" href="#Examples-91">31.11.1 Examples</a></li>
  742. </ul></li>
  743. <li><a name="toc-showwaves" href="#showwaves">31.12 showwaves</a>
  744. <ul class="no-bullet">
  745. <li><a name="toc-Examples-92" href="#Examples-92">31.12.1 Examples</a></li>
  746. </ul></li>
  747. <li><a name="toc-split_002c-asplit" href="#split_002c-asplit">31.13 split, asplit</a>
  748. <ul class="no-bullet">
  749. <li><a name="toc-Examples-93" href="#Examples-93">31.13.1 Examples</a></li>
  750. </ul></li>
  751. <li><a name="toc-zmq_002c-azmq" href="#zmq_002c-azmq">31.14 zmq, azmq</a>
  752. <ul class="no-bullet">
  753. <li><a name="toc-Examples-94" href="#Examples-94">31.14.1 Examples</a></li>
  754. </ul></li>
  755. </ul></li>
  756. <li><a name="toc-Multimedia-Sources" href="#Multimedia-Sources">32 Multimedia Sources</a>
  757. <ul class="no-bullet">
  758. <li><a name="toc-amovie" href="#amovie">32.1 amovie</a></li>
  759. <li><a name="toc-movie-1" href="#movie-1">32.2 movie</a>
  760. <ul class="no-bullet">
  761. <li><a name="toc-Examples-95" href="#Examples-95">32.2.1 Examples</a></li>
  762. </ul></li>
  763. </ul></li>
  764. <li><a name="toc-See-Also" href="#See-Also">33 See Also</a></li>
  765. <li><a name="toc-Authors" href="#Authors">34 Authors</a></li>
  766. </ul>
  767. </div>
  768. <a name="Synopsis"></a>
  769. <h2 class="chapter">1 Synopsis<span class="pull-right"><a class="anchor hidden-xs" href="#Synopsis" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Synopsis" aria-hidden="true">TOC</a></span></h2>
  770. <p>ffplay [<var>options</var>] [<samp>input_file</samp>]
  771. </p>
  772. <a name="Description"></a>
  773. <h2 class="chapter">2 Description<span class="pull-right"><a class="anchor hidden-xs" href="#Description" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Description" aria-hidden="true">TOC</a></span></h2>
  774. <p>FFplay is a very simple and portable media player using the FFmpeg
  775. libraries and the SDL library. It is mostly used as a testbed for the
  776. various FFmpeg APIs.
  777. </p>
  778. <a name="Options"></a>
  779. <h2 class="chapter">3 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options" aria-hidden="true">TOC</a></span></h2>
  780. <p>All the numerical options, if not specified otherwise, accept a string
  781. representing a number as input, which may be followed by one of the SI
  782. unit prefixes, for example: &rsquo;K&rsquo;, &rsquo;M&rsquo;, or &rsquo;G&rsquo;.
  783. </p>
  784. <p>If &rsquo;i&rsquo; is appended to the SI unit prefix, the complete prefix will be
  785. interpreted as a unit prefix for binary multiples, which are based on
  786. powers of 1024 instead of powers of 1000. Appending &rsquo;B&rsquo; to the SI unit
  787. prefix multiplies the value by 8. This allows using, for example:
  788. &rsquo;KB&rsquo;, &rsquo;MiB&rsquo;, &rsquo;G&rsquo; and &rsquo;B&rsquo; as number suffixes.
  789. </p>
  790. <p>Options which do not take arguments are boolean options, and set the
  791. corresponding value to true. They can be set to false by prefixing
  792. the option name with &quot;no&quot;. For example using &quot;-nofoo&quot;
  793. will set the boolean option with name &quot;foo&quot; to false.
  794. </p>
  795. <a name="Stream-specifiers"></a><a name="Stream-specifiers-1"></a>
  796. <h3 class="section">3.1 Stream specifiers<span class="pull-right"><a class="anchor hidden-xs" href="#Stream-specifiers-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Stream-specifiers-1" aria-hidden="true">TOC</a></span></h3>
  797. <p>Some options are applied per-stream, e.g. bitrate or codec. Stream specifiers
  798. are used to precisely specify which stream(s) a given option belongs to.
  799. </p>
  800. <p>A stream specifier is a string generally appended to the option name and
  801. separated from it by a colon. E.g. <code>-codec:a:1 ac3</code> contains the
  802. <code>a:1</code> stream specifier, which matches the second audio stream. Therefore, it
  803. would select the ac3 codec for the second audio stream.
  804. </p>
  805. <p>A stream specifier can match several streams, so that the option is applied to all
  806. of them. E.g. the stream specifier in <code>-b:a 128k</code> matches all audio
  807. streams.
  808. </p>
  809. <p>An empty stream specifier matches all streams. For example, <code>-codec copy</code>
  810. or <code>-codec: copy</code> would copy all the streams without reencoding.
  811. </p>
  812. <p>Possible forms of stream specifiers are:
  813. </p><dl compact="compact">
  814. <dt><samp><var>stream_index</var></samp></dt>
  815. <dd><p>Matches the stream with this index. E.g. <code>-threads:1 4</code> would set the
  816. thread count for the second stream to 4.
  817. </p></dd>
  818. <dt><samp><var>stream_type</var>[:<var>stream_index</var>]</samp></dt>
  819. <dd><p><var>stream_type</var> is one of following: &rsquo;v&rsquo; for video, &rsquo;a&rsquo; for audio, &rsquo;s&rsquo; for subtitle,
  820. &rsquo;d&rsquo; for data, and &rsquo;t&rsquo; for attachments. If <var>stream_index</var> is given, then it matches
  821. stream number <var>stream_index</var> of this type. Otherwise, it matches all
  822. streams of this type.
  823. </p></dd>
  824. <dt><samp>p:<var>program_id</var>[:<var>stream_index</var>]</samp></dt>
  825. <dd><p>If <var>stream_index</var> is given, then it matches the stream with number <var>stream_index</var>
  826. in the program with the id <var>program_id</var>. Otherwise, it matches all streams in the
  827. program.
  828. </p></dd>
  829. <dt><samp>#<var>stream_id</var> or i:<var>stream_id</var></samp></dt>
  830. <dd><p>Match the stream by stream id (e.g. PID in MPEG-TS container).
  831. </p></dd>
  832. <dt><samp>m:<var>key</var>[:<var>value</var>]</samp></dt>
  833. <dd><p>Matches streams with the metadata tag <var>key</var> having the specified value. If
  834. <var>value</var> is not given, matches streams that contain the given tag with any
  835. value.
  836. </p>
  837. <p>Note that in <code>ffmpeg</code>, matching by metadata will only work properly for
  838. input files.
  839. </p></dd>
  840. </dl>
  841. <a name="Generic-options"></a>
  842. <h3 class="section">3.2 Generic options<span class="pull-right"><a class="anchor hidden-xs" href="#Generic-options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Generic-options" aria-hidden="true">TOC</a></span></h3>
  843. <p>These options are shared amongst the ff* tools.
  844. </p>
  845. <dl compact="compact">
  846. <dt><samp>-L</samp></dt>
  847. <dd><p>Show license.
  848. </p>
  849. </dd>
  850. <dt><samp>-h, -?, -help, --help [<var>arg</var>]</samp></dt>
  851. <dd><p>Show help. An optional parameter may be specified to print help about a specific
  852. item. If no argument is specified, only basic (non advanced) tool
  853. options are shown.
  854. </p>
  855. <p>Possible values of <var>arg</var> are:
  856. </p><dl compact="compact">
  857. <dt><samp>long</samp></dt>
  858. <dd><p>Print advanced tool options in addition to the basic tool options.
  859. </p>
  860. </dd>
  861. <dt><samp>full</samp></dt>
  862. <dd><p>Print complete list of options, including shared and private options
  863. for encoders, decoders, demuxers, muxers, filters, etc.
  864. </p>
  865. </dd>
  866. <dt><samp>decoder=<var>decoder_name</var></samp></dt>
  867. <dd><p>Print detailed information about the decoder named <var>decoder_name</var>. Use the
  868. <samp>-decoders</samp> option to get a list of all decoders.
  869. </p>
  870. </dd>
  871. <dt><samp>encoder=<var>encoder_name</var></samp></dt>
  872. <dd><p>Print detailed information about the encoder named <var>encoder_name</var>. Use the
  873. <samp>-encoders</samp> option to get a list of all encoders.
  874. </p>
  875. </dd>
  876. <dt><samp>demuxer=<var>demuxer_name</var></samp></dt>
  877. <dd><p>Print detailed information about the demuxer named <var>demuxer_name</var>. Use the
  878. <samp>-formats</samp> option to get a list of all demuxers and muxers.
  879. </p>
  880. </dd>
  881. <dt><samp>muxer=<var>muxer_name</var></samp></dt>
  882. <dd><p>Print detailed information about the muxer named <var>muxer_name</var>. Use the
  883. <samp>-formats</samp> option to get a list of all muxers and demuxers.
  884. </p>
  885. </dd>
  886. <dt><samp>filter=<var>filter_name</var></samp></dt>
  887. <dd><p>Print detailed information about the filter name <var>filter_name</var>. Use the
  888. <samp>-filters</samp> option to get a list of all filters.
  889. </p></dd>
  890. </dl>
  891. </dd>
  892. <dt><samp>-version</samp></dt>
  893. <dd><p>Show version.
  894. </p>
  895. </dd>
  896. <dt><samp>-formats</samp></dt>
  897. <dd><p>Show available formats (including devices).
  898. </p>
  899. </dd>
  900. <dt><samp>-devices</samp></dt>
  901. <dd><p>Show available devices.
  902. </p>
  903. </dd>
  904. <dt><samp>-codecs</samp></dt>
  905. <dd><p>Show all codecs known to libavcodec.
  906. </p>
  907. <p>Note that the term &rsquo;codec&rsquo; is used throughout this documentation as a shortcut
  908. for what is more correctly called a media bitstream format.
  909. </p>
  910. </dd>
  911. <dt><samp>-decoders</samp></dt>
  912. <dd><p>Show available decoders.
  913. </p>
  914. </dd>
  915. <dt><samp>-encoders</samp></dt>
  916. <dd><p>Show all available encoders.
  917. </p>
  918. </dd>
  919. <dt><samp>-bsfs</samp></dt>
  920. <dd><p>Show available bitstream filters.
  921. </p>
  922. </dd>
  923. <dt><samp>-protocols</samp></dt>
  924. <dd><p>Show available protocols.
  925. </p>
  926. </dd>
  927. <dt><samp>-filters</samp></dt>
  928. <dd><p>Show available libavfilter filters.
  929. </p>
  930. </dd>
  931. <dt><samp>-pix_fmts</samp></dt>
  932. <dd><p>Show available pixel formats.
  933. </p>
  934. </dd>
  935. <dt><samp>-sample_fmts</samp></dt>
  936. <dd><p>Show available sample formats.
  937. </p>
  938. </dd>
  939. <dt><samp>-layouts</samp></dt>
  940. <dd><p>Show channel names and standard channel layouts.
  941. </p>
  942. </dd>
  943. <dt><samp>-colors</samp></dt>
  944. <dd><p>Show recognized color names.
  945. </p>
  946. </dd>
  947. <dt><samp>-sources <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp></dt>
  948. <dd><p>Show autodetected sources of the intput device.
  949. Some devices may provide system-dependent source names that cannot be autodetected.
  950. The returned list cannot be assumed to be always complete.
  951. </p><div class="example">
  952. <pre class="example">ffmpeg -sources pulse,server=192.168.0.4
  953. </pre></div>
  954. </dd>
  955. <dt><samp>-sinks <var>device</var>[,<var>opt1</var>=<var>val1</var>[,<var>opt2</var>=<var>val2</var>]...]</samp></dt>
  956. <dd><p>Show autodetected sinks of the output device.
  957. Some devices may provide system-dependent sink names that cannot be autodetected.
  958. The returned list cannot be assumed to be always complete.
  959. </p><div class="example">
  960. <pre class="example">ffmpeg -sinks pulse,server=192.168.0.4
  961. </pre></div>
  962. </dd>
  963. <dt><samp>-loglevel [repeat+]<var>loglevel</var> | -v [repeat+]<var>loglevel</var></samp></dt>
  964. <dd><p>Set the logging level used by the library.
  965. Adding &quot;repeat+&quot; indicates that repeated log output should not be compressed
  966. to the first line and the &quot;Last message repeated n times&quot; line will be
  967. omitted. &quot;repeat&quot; can also be used alone.
  968. If &quot;repeat&quot; is used alone, and with no prior loglevel set, the default
  969. loglevel will be used. If multiple loglevel parameters are given, using
  970. &rsquo;repeat&rsquo; will not change the loglevel.
  971. <var>loglevel</var> is a string or a number containing one of the following values:
  972. </p><dl compact="compact">
  973. <dt>&lsquo;<samp>quiet, -8</samp>&rsquo;</dt>
  974. <dd><p>Show nothing at all; be silent.
  975. </p></dd>
  976. <dt>&lsquo;<samp>panic, 0</samp>&rsquo;</dt>
  977. <dd><p>Only show fatal errors which could lead the process to crash, such as
  978. and assert failure. This is not currently used for anything.
  979. </p></dd>
  980. <dt>&lsquo;<samp>fatal, 8</samp>&rsquo;</dt>
  981. <dd><p>Only show fatal errors. These are errors after which the process absolutely
  982. cannot continue after.
  983. </p></dd>
  984. <dt>&lsquo;<samp>error, 16</samp>&rsquo;</dt>
  985. <dd><p>Show all errors, including ones which can be recovered from.
  986. </p></dd>
  987. <dt>&lsquo;<samp>warning, 24</samp>&rsquo;</dt>
  988. <dd><p>Show all warnings and errors. Any message related to possibly
  989. incorrect or unexpected events will be shown.
  990. </p></dd>
  991. <dt>&lsquo;<samp>info, 32</samp>&rsquo;</dt>
  992. <dd><p>Show informative messages during processing. This is in addition to
  993. warnings and errors. This is the default value.
  994. </p></dd>
  995. <dt>&lsquo;<samp>verbose, 40</samp>&rsquo;</dt>
  996. <dd><p>Same as <code>info</code>, except more verbose.
  997. </p></dd>
  998. <dt>&lsquo;<samp>debug, 48</samp>&rsquo;</dt>
  999. <dd><p>Show everything, including debugging information.
  1000. </p></dd>
  1001. </dl>
  1002. <p>By default the program logs to stderr, if coloring is supported by the
  1003. terminal, colors are used to mark errors and warnings. Log coloring
  1004. can be disabled setting the environment variable
  1005. <code>AV_LOG_FORCE_NOCOLOR</code> or <code>NO_COLOR</code>, or can be forced setting
  1006. the environment variable <code>AV_LOG_FORCE_COLOR</code>.
  1007. The use of the environment variable <code>NO_COLOR</code> is deprecated and
  1008. will be dropped in a following FFmpeg version.
  1009. </p>
  1010. </dd>
  1011. <dt><samp>-report</samp></dt>
  1012. <dd><p>Dump full command line and console output to a file named
  1013. <code><var>program</var>-<var>YYYYMMDD</var>-<var>HHMMSS</var>.log</code> in the current
  1014. directory.
  1015. This file can be useful for bug reports.
  1016. It also implies <code>-loglevel verbose</code>.
  1017. </p>
  1018. <p>Setting the environment variable <code>FFREPORT</code> to any value has the
  1019. same effect. If the value is a &rsquo;:&rsquo;-separated key=value sequence, these
  1020. options will affect the report; option values must be escaped if they
  1021. contain special characters or the options delimiter &rsquo;:&rsquo; (see the
  1022. &ldquo;Quoting and escaping&rdquo; section in the ffmpeg-utils manual).
  1023. </p>
  1024. <p>The following options are recognized:
  1025. </p><dl compact="compact">
  1026. <dt><samp>file</samp></dt>
  1027. <dd><p>set the file name to use for the report; <code>%p</code> is expanded to the name
  1028. of the program, <code>%t</code> is expanded to a timestamp, <code>%%</code> is expanded
  1029. to a plain <code>%</code>
  1030. </p></dd>
  1031. <dt><samp>level</samp></dt>
  1032. <dd><p>set the log verbosity level using a numerical value (see <code>-loglevel</code>).
  1033. </p></dd>
  1034. </dl>
  1035. <p>For example, to output a report to a file named <samp>ffreport.log</samp>
  1036. using a log level of <code>32</code> (alias for log level <code>info</code>):
  1037. </p>
  1038. <div class="example">
  1039. <pre class="example">FFREPORT=file=ffreport.log:level=32 ffmpeg -i input output
  1040. </pre></div>
  1041. <p>Errors in parsing the environment variable are not fatal, and will not
  1042. appear in the report.
  1043. </p>
  1044. </dd>
  1045. <dt><samp>-hide_banner</samp></dt>
  1046. <dd><p>Suppress printing banner.
  1047. </p>
  1048. <p>All FFmpeg tools will normally show a copyright notice, build options
  1049. and library versions. This option can be used to suppress printing
  1050. this information.
  1051. </p>
  1052. </dd>
  1053. <dt><samp>-cpuflags flags (<em>global</em>)</samp></dt>
  1054. <dd><p>Allows setting and clearing cpu flags. This option is intended
  1055. for testing. Do not use it unless you know what you&rsquo;re doing.
  1056. </p><div class="example">
  1057. <pre class="example">ffmpeg -cpuflags -sse+mmx ...
  1058. ffmpeg -cpuflags mmx ...
  1059. ffmpeg -cpuflags 0 ...
  1060. </pre></div>
  1061. <p>Possible flags for this option are:
  1062. </p><dl compact="compact">
  1063. <dt>&lsquo;<samp>x86</samp>&rsquo;</dt>
  1064. <dd><dl compact="compact">
  1065. <dt>&lsquo;<samp>mmx</samp>&rsquo;</dt>
  1066. <dt>&lsquo;<samp>mmxext</samp>&rsquo;</dt>
  1067. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  1068. <dt>&lsquo;<samp>sse2</samp>&rsquo;</dt>
  1069. <dt>&lsquo;<samp>sse2slow</samp>&rsquo;</dt>
  1070. <dt>&lsquo;<samp>sse3</samp>&rsquo;</dt>
  1071. <dt>&lsquo;<samp>sse3slow</samp>&rsquo;</dt>
  1072. <dt>&lsquo;<samp>ssse3</samp>&rsquo;</dt>
  1073. <dt>&lsquo;<samp>atom</samp>&rsquo;</dt>
  1074. <dt>&lsquo;<samp>sse4.1</samp>&rsquo;</dt>
  1075. <dt>&lsquo;<samp>sse4.2</samp>&rsquo;</dt>
  1076. <dt>&lsquo;<samp>avx</samp>&rsquo;</dt>
  1077. <dt>&lsquo;<samp>avx2</samp>&rsquo;</dt>
  1078. <dt>&lsquo;<samp>xop</samp>&rsquo;</dt>
  1079. <dt>&lsquo;<samp>fma3</samp>&rsquo;</dt>
  1080. <dt>&lsquo;<samp>fma4</samp>&rsquo;</dt>
  1081. <dt>&lsquo;<samp>3dnow</samp>&rsquo;</dt>
  1082. <dt>&lsquo;<samp>3dnowext</samp>&rsquo;</dt>
  1083. <dt>&lsquo;<samp>bmi1</samp>&rsquo;</dt>
  1084. <dt>&lsquo;<samp>bmi2</samp>&rsquo;</dt>
  1085. <dt>&lsquo;<samp>cmov</samp>&rsquo;</dt>
  1086. </dl>
  1087. </dd>
  1088. <dt>&lsquo;<samp>ARM</samp>&rsquo;</dt>
  1089. <dd><dl compact="compact">
  1090. <dt>&lsquo;<samp>armv5te</samp>&rsquo;</dt>
  1091. <dt>&lsquo;<samp>armv6</samp>&rsquo;</dt>
  1092. <dt>&lsquo;<samp>armv6t2</samp>&rsquo;</dt>
  1093. <dt>&lsquo;<samp>vfp</samp>&rsquo;</dt>
  1094. <dt>&lsquo;<samp>vfpv3</samp>&rsquo;</dt>
  1095. <dt>&lsquo;<samp>neon</samp>&rsquo;</dt>
  1096. <dt>&lsquo;<samp>setend</samp>&rsquo;</dt>
  1097. </dl>
  1098. </dd>
  1099. <dt>&lsquo;<samp>AArch64</samp>&rsquo;</dt>
  1100. <dd><dl compact="compact">
  1101. <dt>&lsquo;<samp>armv8</samp>&rsquo;</dt>
  1102. <dt>&lsquo;<samp>vfp</samp>&rsquo;</dt>
  1103. <dt>&lsquo;<samp>neon</samp>&rsquo;</dt>
  1104. </dl>
  1105. </dd>
  1106. <dt>&lsquo;<samp>PowerPC</samp>&rsquo;</dt>
  1107. <dd><dl compact="compact">
  1108. <dt>&lsquo;<samp>altivec</samp>&rsquo;</dt>
  1109. </dl>
  1110. </dd>
  1111. <dt>&lsquo;<samp>Specific Processors</samp>&rsquo;</dt>
  1112. <dd><dl compact="compact">
  1113. <dt>&lsquo;<samp>pentium2</samp>&rsquo;</dt>
  1114. <dt>&lsquo;<samp>pentium3</samp>&rsquo;</dt>
  1115. <dt>&lsquo;<samp>pentium4</samp>&rsquo;</dt>
  1116. <dt>&lsquo;<samp>k6</samp>&rsquo;</dt>
  1117. <dt>&lsquo;<samp>k62</samp>&rsquo;</dt>
  1118. <dt>&lsquo;<samp>athlon</samp>&rsquo;</dt>
  1119. <dt>&lsquo;<samp>athlonxp</samp>&rsquo;</dt>
  1120. <dt>&lsquo;<samp>k8</samp>&rsquo;</dt>
  1121. </dl>
  1122. </dd>
  1123. </dl>
  1124. </dd>
  1125. <dt><samp>-opencl_bench</samp></dt>
  1126. <dd><p>This option is used to benchmark all available OpenCL devices and print the
  1127. results. This option is only available when FFmpeg has been compiled with
  1128. <code>--enable-opencl</code>.
  1129. </p>
  1130. <p>When FFmpeg is configured with <code>--enable-opencl</code>, the options for the
  1131. global OpenCL context are set via <samp>-opencl_options</samp>. See the
  1132. &quot;OpenCL Options&quot; section in the ffmpeg-utils manual for the complete list of
  1133. supported options. Amongst others, these options include the ability to select
  1134. a specific platform and device to run the OpenCL code on. By default, FFmpeg
  1135. will run on the first device of the first platform. While the options for the
  1136. global OpenCL context provide flexibility to the user in selecting the OpenCL
  1137. device of their choice, most users would probably want to select the fastest
  1138. OpenCL device for their system.
  1139. </p>
  1140. <p>This option assists the selection of the most efficient configuration by
  1141. identifying the appropriate device for the user&rsquo;s system. The built-in
  1142. benchmark is run on all the OpenCL devices and the performance is measured for
  1143. each device. The devices in the results list are sorted based on their
  1144. performance with the fastest device listed first. The user can subsequently
  1145. invoke <code>ffmpeg</code> using the device deemed most appropriate via
  1146. <samp>-opencl_options</samp> to obtain the best performance for the OpenCL
  1147. accelerated code.
  1148. </p>
  1149. <p>Typical usage to use the fastest OpenCL device involve the following steps.
  1150. </p>
  1151. <p>Run the command:
  1152. </p><div class="example">
  1153. <pre class="example">ffmpeg -opencl_bench
  1154. </pre></div>
  1155. <p>Note down the platform ID (<var>pidx</var>) and device ID (<var>didx</var>) of the first
  1156. i.e. fastest device in the list.
  1157. Select the platform and device using the command:
  1158. </p><div class="example">
  1159. <pre class="example">ffmpeg -opencl_options platform_idx=<var>pidx</var>:device_idx=<var>didx</var> ...
  1160. </pre></div>
  1161. </dd>
  1162. <dt><samp>-opencl_options options (<em>global</em>)</samp></dt>
  1163. <dd><p>Set OpenCL environment options. This option is only available when
  1164. FFmpeg has been compiled with <code>--enable-opencl</code>.
  1165. </p>
  1166. <p><var>options</var> must be a list of <var>key</var>=<var>value</var> option pairs
  1167. separated by &rsquo;:&rsquo;. See the &ldquo;OpenCL Options&rdquo; section in the
  1168. ffmpeg-utils manual for the list of supported options.
  1169. </p></dd>
  1170. </dl>
  1171. <a name="AVOptions"></a>
  1172. <h3 class="section">3.3 AVOptions<span class="pull-right"><a class="anchor hidden-xs" href="#AVOptions" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-AVOptions" aria-hidden="true">TOC</a></span></h3>
  1173. <p>These options are provided directly by the libavformat, libavdevice and
  1174. libavcodec libraries. To see the list of available AVOptions, use the
  1175. <samp>-help</samp> option. They are separated into two categories:
  1176. </p><dl compact="compact">
  1177. <dt><samp>generic</samp></dt>
  1178. <dd><p>These options can be set for any container, codec or device. Generic options
  1179. are listed under AVFormatContext options for containers/devices and under
  1180. AVCodecContext options for codecs.
  1181. </p></dd>
  1182. <dt><samp>private</samp></dt>
  1183. <dd><p>These options are specific to the given container, device or codec. Private
  1184. options are listed under their corresponding containers/devices/codecs.
  1185. </p></dd>
  1186. </dl>
  1187. <p>For example to write an ID3v2.3 header instead of a default ID3v2.4 to
  1188. an MP3 file, use the <samp>id3v2_version</samp> private option of the MP3
  1189. muxer:
  1190. </p><div class="example">
  1191. <pre class="example">ffmpeg -i input.flac -id3v2_version 3 out.mp3
  1192. </pre></div>
  1193. <p>All codec AVOptions are per-stream, and thus a stream specifier
  1194. should be attached to them.
  1195. </p>
  1196. <p>Note: the <samp>-nooption</samp> syntax cannot be used for boolean
  1197. AVOptions, use <samp>-option 0</samp>/<samp>-option 1</samp>.
  1198. </p>
  1199. <p>Note: the old undocumented way of specifying per-stream AVOptions by
  1200. prepending v/a/s to the options name is now obsolete and will be
  1201. removed soon.
  1202. </p>
  1203. <a name="Main-options"></a>
  1204. <h3 class="section">3.4 Main options<span class="pull-right"><a class="anchor hidden-xs" href="#Main-options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Main-options" aria-hidden="true">TOC</a></span></h3>
  1205. <dl compact="compact">
  1206. <dt><samp>-x <var>width</var></samp></dt>
  1207. <dd><p>Force displayed width.
  1208. </p></dd>
  1209. <dt><samp>-y <var>height</var></samp></dt>
  1210. <dd><p>Force displayed height.
  1211. </p></dd>
  1212. <dt><samp>-s <var>size</var></samp></dt>
  1213. <dd><p>Set frame size (WxH or abbreviation), needed for videos which do
  1214. not contain a header with the frame size like raw YUV. This option
  1215. has been deprecated in favor of private options, try -video_size.
  1216. </p></dd>
  1217. <dt><samp>-fs</samp></dt>
  1218. <dd><p>Start in fullscreen mode.
  1219. </p></dd>
  1220. <dt><samp>-an</samp></dt>
  1221. <dd><p>Disable audio.
  1222. </p></dd>
  1223. <dt><samp>-vn</samp></dt>
  1224. <dd><p>Disable video.
  1225. </p></dd>
  1226. <dt><samp>-sn</samp></dt>
  1227. <dd><p>Disable subtitles.
  1228. </p></dd>
  1229. <dt><samp>-ss <var>pos</var></samp></dt>
  1230. <dd><p>Seek to a given position in seconds.
  1231. </p></dd>
  1232. <dt><samp>-t <var>duration</var></samp></dt>
  1233. <dd><p>play &lt;duration&gt; seconds of audio/video
  1234. </p></dd>
  1235. <dt><samp>-bytes</samp></dt>
  1236. <dd><p>Seek by bytes.
  1237. </p></dd>
  1238. <dt><samp>-nodisp</samp></dt>
  1239. <dd><p>Disable graphical display.
  1240. </p></dd>
  1241. <dt><samp>-f <var>fmt</var></samp></dt>
  1242. <dd><p>Force format.
  1243. </p></dd>
  1244. <dt><samp>-window_title <var>title</var></samp></dt>
  1245. <dd><p>Set window title (default is the input filename).
  1246. </p></dd>
  1247. <dt><samp>-loop <var>number</var></samp></dt>
  1248. <dd><p>Loops movie playback &lt;number&gt; times. 0 means forever.
  1249. </p></dd>
  1250. <dt><samp>-showmode <var>mode</var></samp></dt>
  1251. <dd><p>Set the show mode to use.
  1252. Available values for <var>mode</var> are:
  1253. </p><dl compact="compact">
  1254. <dt>&lsquo;<samp>0, video</samp>&rsquo;</dt>
  1255. <dd><p>show video
  1256. </p></dd>
  1257. <dt>&lsquo;<samp>1, waves</samp>&rsquo;</dt>
  1258. <dd><p>show audio waves
  1259. </p></dd>
  1260. <dt>&lsquo;<samp>2, rdft</samp>&rsquo;</dt>
  1261. <dd><p>show audio frequency band using RDFT ((Inverse) Real Discrete Fourier Transform)
  1262. </p></dd>
  1263. </dl>
  1264. <p>Default value is &quot;video&quot;, if video is not present or cannot be played
  1265. &quot;rdft&quot; is automatically selected.
  1266. </p>
  1267. <p>You can interactively cycle through the available show modes by
  1268. pressing the key <tt class="key">w</tt>.
  1269. </p>
  1270. </dd>
  1271. <dt><samp>-vf <var>filtergraph</var></samp></dt>
  1272. <dd><p>Create the filtergraph specified by <var>filtergraph</var> and use it to
  1273. filter the video stream.
  1274. </p>
  1275. <p><var>filtergraph</var> is a description of the filtergraph to apply to
  1276. the stream, and must have a single video input and a single video
  1277. output. In the filtergraph, the input is associated to the label
  1278. <code>in</code>, and the output to the label <code>out</code>. See the
  1279. ffmpeg-filters manual for more information about the filtergraph
  1280. syntax.
  1281. </p>
  1282. <p>You can specify this parameter multiple times and cycle through the specified
  1283. filtergraphs along with the show modes by pressing the key <tt class="key">w</tt>.
  1284. </p>
  1285. </dd>
  1286. <dt><samp>-af <var>filtergraph</var></samp></dt>
  1287. <dd><p><var>filtergraph</var> is a description of the filtergraph to apply to
  1288. the input audio.
  1289. Use the option &quot;-filters&quot; to show all the available filters (including
  1290. sources and sinks).
  1291. </p>
  1292. </dd>
  1293. <dt><samp>-i <var>input_file</var></samp></dt>
  1294. <dd><p>Read <var>input_file</var>.
  1295. </p></dd>
  1296. </dl>
  1297. <a name="Advanced-options"></a>
  1298. <h3 class="section">3.5 Advanced options<span class="pull-right"><a class="anchor hidden-xs" href="#Advanced-options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Advanced-options" aria-hidden="true">TOC</a></span></h3>
  1299. <dl compact="compact">
  1300. <dt><samp>-pix_fmt <var>format</var></samp></dt>
  1301. <dd><p>Set pixel format.
  1302. This option has been deprecated in favor of private options, try -pixel_format.
  1303. </p>
  1304. </dd>
  1305. <dt><samp>-stats</samp></dt>
  1306. <dd><p>Print several playback statistics, in particular show the stream
  1307. duration, the codec parameters, the current position in the stream and
  1308. the audio/video synchronisation drift. It is on by default, to
  1309. explicitly disable it you need to specify <code>-nostats</code>.
  1310. </p>
  1311. </dd>
  1312. <dt><samp>-fast</samp></dt>
  1313. <dd><p>Non-spec-compliant optimizations.
  1314. </p></dd>
  1315. <dt><samp>-genpts</samp></dt>
  1316. <dd><p>Generate pts.
  1317. </p></dd>
  1318. <dt><samp>-sync <var>type</var></samp></dt>
  1319. <dd><p>Set the master clock to audio (<code>type=audio</code>), video
  1320. (<code>type=video</code>) or external (<code>type=ext</code>). Default is audio. The
  1321. master clock is used to control audio-video synchronization. Most media
  1322. players use audio as master clock, but in some cases (streaming or high
  1323. quality broadcast) it is necessary to change that. This option is mainly
  1324. used for debugging purposes.
  1325. </p></dd>
  1326. <dt><samp>-ast <var>audio_stream_specifier</var></samp></dt>
  1327. <dd><p>Select the desired audio stream using the given stream specifier. The stream
  1328. specifiers are described in the <a href="#Stream-specifiers">Stream specifiers</a> chapter. If this option
  1329. is not specified, the &quot;best&quot; audio stream is selected in the program of the
  1330. already selected video stream.
  1331. </p></dd>
  1332. <dt><samp>-vst <var>video_stream_specifier</var></samp></dt>
  1333. <dd><p>Select the desired video stream using the given stream specifier. The stream
  1334. specifiers are described in the <a href="#Stream-specifiers">Stream specifiers</a> chapter. If this option
  1335. is not specified, the &quot;best&quot; video stream is selected.
  1336. </p></dd>
  1337. <dt><samp>-sst <var>subtitle_stream_specifier</var></samp></dt>
  1338. <dd><p>Select the desired subtitle stream using the given stream specifier. The stream
  1339. specifiers are described in the <a href="#Stream-specifiers">Stream specifiers</a> chapter. If this option
  1340. is not specified, the &quot;best&quot; subtitle stream is selected in the program of the
  1341. already selected video or audio stream.
  1342. </p></dd>
  1343. <dt><samp>-autoexit</samp></dt>
  1344. <dd><p>Exit when video is done playing.
  1345. </p></dd>
  1346. <dt><samp>-exitonkeydown</samp></dt>
  1347. <dd><p>Exit if any key is pressed.
  1348. </p></dd>
  1349. <dt><samp>-exitonmousedown</samp></dt>
  1350. <dd><p>Exit if any mouse button is pressed.
  1351. </p>
  1352. </dd>
  1353. <dt><samp>-codec:<var>media_specifier</var> <var>codec_name</var></samp></dt>
  1354. <dd><p>Force a specific decoder implementation for the stream identified by
  1355. <var>media_specifier</var>, which can assume the values <code>a</code> (audio),
  1356. <code>v</code> (video), and <code>s</code> subtitle.
  1357. </p>
  1358. </dd>
  1359. <dt><samp>-acodec <var>codec_name</var></samp></dt>
  1360. <dd><p>Force a specific audio decoder.
  1361. </p>
  1362. </dd>
  1363. <dt><samp>-vcodec <var>codec_name</var></samp></dt>
  1364. <dd><p>Force a specific video decoder.
  1365. </p>
  1366. </dd>
  1367. <dt><samp>-scodec <var>codec_name</var></samp></dt>
  1368. <dd><p>Force a specific subtitle decoder.
  1369. </p>
  1370. </dd>
  1371. <dt><samp>-autorotate</samp></dt>
  1372. <dd><p>Automatically rotate the video according to presentation metadata. Enabled by
  1373. default, use <samp>-noautorotate</samp> to disable it.
  1374. </p>
  1375. </dd>
  1376. <dt><samp>-framedrop</samp></dt>
  1377. <dd><p>Drop video frames if video is out of sync. Enabled by default if the master
  1378. clock is not set to video. Use this option to enable frame dropping for all
  1379. master clock sources, use <samp>-noframedrop</samp> to disable it.
  1380. </p>
  1381. </dd>
  1382. <dt><samp>-infbuf</samp></dt>
  1383. <dd><p>Do not limit the input buffer size, read as much data as possible from the
  1384. input as soon as possible. Enabled by default for realtime streams, where data
  1385. may be dropped if not read in time. Use this option to enable infinite buffers
  1386. for all inputs, use <samp>-noinfbuf</samp> to disable it.
  1387. </p>
  1388. </dd>
  1389. </dl>
  1390. <a name="While-playing"></a>
  1391. <h3 class="section">3.6 While playing<span class="pull-right"><a class="anchor hidden-xs" href="#While-playing" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-While-playing" aria-hidden="true">TOC</a></span></h3>
  1392. <dl compact="compact">
  1393. <dt><tt class="key">q, ESC</tt></dt>
  1394. <dd><p>Quit.
  1395. </p>
  1396. </dd>
  1397. <dt><tt class="key">f</tt></dt>
  1398. <dd><p>Toggle full screen.
  1399. </p>
  1400. </dd>
  1401. <dt><tt class="key">p, SPC</tt></dt>
  1402. <dd><p>Pause.
  1403. </p>
  1404. </dd>
  1405. <dt><tt class="key">a</tt></dt>
  1406. <dd><p>Cycle audio channel in the current program.
  1407. </p>
  1408. </dd>
  1409. <dt><tt class="key">v</tt></dt>
  1410. <dd><p>Cycle video channel.
  1411. </p>
  1412. </dd>
  1413. <dt><tt class="key">t</tt></dt>
  1414. <dd><p>Cycle subtitle channel in the current program.
  1415. </p>
  1416. </dd>
  1417. <dt><tt class="key">c</tt></dt>
  1418. <dd><p>Cycle program.
  1419. </p>
  1420. </dd>
  1421. <dt><tt class="key">w</tt></dt>
  1422. <dd><p>Cycle video filters or show modes.
  1423. </p>
  1424. </dd>
  1425. <dt><tt class="key">s</tt></dt>
  1426. <dd><p>Step to the next frame.
  1427. </p>
  1428. <p>Pause if the stream is not already paused, step to the next video
  1429. frame, and pause.
  1430. </p>
  1431. </dd>
  1432. <dt><tt class="key">left/right</tt></dt>
  1433. <dd><p>Seek backward/forward 10 seconds.
  1434. </p>
  1435. </dd>
  1436. <dt><tt class="key">down/up</tt></dt>
  1437. <dd><p>Seek backward/forward 1 minute.
  1438. </p>
  1439. </dd>
  1440. <dt><tt class="key">page down/page up</tt></dt>
  1441. <dd><p>Seek to the previous/next chapter.
  1442. or if there are no chapters
  1443. Seek backward/forward 10 minutes.
  1444. </p>
  1445. </dd>
  1446. <dt><tt class="key">mouse click</tt></dt>
  1447. <dd><p>Seek to percentage in file corresponding to fraction of width.
  1448. </p>
  1449. </dd>
  1450. </dl>
  1451. <a name="Syntax"></a>
  1452. <h2 class="chapter">4 Syntax<span class="pull-right"><a class="anchor hidden-xs" href="#Syntax" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Syntax" aria-hidden="true">TOC</a></span></h2>
  1453. <p>This section documents the syntax and formats employed by the FFmpeg
  1454. libraries and tools.
  1455. </p>
  1456. <a name="quoting_005fand_005fescaping"></a><a name="Quoting-and-escaping"></a>
  1457. <h3 class="section">4.1 Quoting and escaping<span class="pull-right"><a class="anchor hidden-xs" href="#Quoting-and-escaping" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Quoting-and-escaping" aria-hidden="true">TOC</a></span></h3>
  1458. <p>FFmpeg adopts the following quoting and escaping mechanism, unless
  1459. explicitly specified. The following rules are applied:
  1460. </p>
  1461. <ul>
  1462. <li> <code>'</code> and <code>\</code> are special characters (respectively used for
  1463. quoting and escaping). In addition to them, there might be other
  1464. special characters depending on the specific syntax where the escaping
  1465. and quoting are employed.
  1466. </li><li> A special character is escaped by prefixing it with a &rsquo;\&rsquo;.
  1467. </li><li> All characters enclosed between &rdquo; are included literally in the
  1468. parsed string. The quote character <code>'</code> itself cannot be quoted,
  1469. so you may need to close the quote and escape it.
  1470. </li><li> Leading and trailing whitespaces, unless escaped or quoted, are
  1471. removed from the parsed string.
  1472. </li></ul>
  1473. <p>Note that you may need to add a second level of escaping when using
  1474. the command line or a script, which depends on the syntax of the
  1475. adopted shell language.
  1476. </p>
  1477. <p>The function <code>av_get_token</code> defined in
  1478. <samp>libavutil/avstring.h</samp> can be used to parse a token quoted or
  1479. escaped according to the rules defined above.
  1480. </p>
  1481. <p>The tool <samp>tools/ffescape</samp> in the FFmpeg source tree can be used
  1482. to automatically quote or escape a string in a script.
  1483. </p>
  1484. <a name="Examples"></a>
  1485. <h4 class="subsection">4.1.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples" aria-hidden="true">TOC</a></span></h4>
  1486. <ul>
  1487. <li> Escape the string <code>Crime d'Amour</code> containing the <code>'</code> special
  1488. character:
  1489. <div class="example">
  1490. <pre class="example">Crime d\'Amour
  1491. </pre></div>
  1492. </li><li> The string above contains a quote, so the <code>'</code> needs to be escaped
  1493. when quoting it:
  1494. <div class="example">
  1495. <pre class="example">'Crime d'\''Amour'
  1496. </pre></div>
  1497. </li><li> Include leading or trailing whitespaces using quoting:
  1498. <div class="example">
  1499. <pre class="example">' this string starts and ends with whitespaces '
  1500. </pre></div>
  1501. </li><li> Escaping and quoting can be mixed together:
  1502. <div class="example">
  1503. <pre class="example">' The string '\'string\'' is a string '
  1504. </pre></div>
  1505. </li><li> To include a literal <code>\</code> you can use either escaping or quoting:
  1506. <div class="example">
  1507. <pre class="example">'c:\foo' can be written as c:\\foo
  1508. </pre></div>
  1509. </li></ul>
  1510. <a name="date-syntax"></a><a name="Date"></a>
  1511. <h3 class="section">4.2 Date<span class="pull-right"><a class="anchor hidden-xs" href="#Date" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Date" aria-hidden="true">TOC</a></span></h3>
  1512. <p>The accepted syntax is:
  1513. </p><div class="example">
  1514. <pre class="example">[(YYYY-MM-DD|YYYYMMDD)[T|t| ]]((HH:MM:SS[.m...]]])|(HHMMSS[.m...]]]))[Z]
  1515. now
  1516. </pre></div>
  1517. <p>If the value is &quot;now&quot; it takes the current time.
  1518. </p>
  1519. <p>Time is local time unless Z is appended, in which case it is
  1520. interpreted as UTC.
  1521. If the year-month-day part is not specified it takes the current
  1522. year-month-day.
  1523. </p>
  1524. <a name="time-duration-syntax"></a><a name="Time-duration"></a>
  1525. <h3 class="section">4.3 Time duration<span class="pull-right"><a class="anchor hidden-xs" href="#Time-duration" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Time-duration" aria-hidden="true">TOC</a></span></h3>
  1526. <p>There are two accepted syntaxes for expressing time duration.
  1527. </p>
  1528. <div class="example">
  1529. <pre class="example">[-][<var>HH</var>:]<var>MM</var>:<var>SS</var>[.<var>m</var>...]
  1530. </pre></div>
  1531. <p><var>HH</var> expresses the number of hours, <var>MM</var> the number of minutes
  1532. for a maximum of 2 digits, and <var>SS</var> the number of seconds for a
  1533. maximum of 2 digits. The <var>m</var> at the end expresses decimal value for
  1534. <var>SS</var>.
  1535. </p>
  1536. <p><em>or</em>
  1537. </p>
  1538. <div class="example">
  1539. <pre class="example">[-]<var>S</var>+[.<var>m</var>...]
  1540. </pre></div>
  1541. <p><var>S</var> expresses the number of seconds, with the optional decimal part
  1542. <var>m</var>.
  1543. </p>
  1544. <p>In both expressions, the optional &lsquo;<samp>-</samp>&rsquo; indicates negative duration.
  1545. </p>
  1546. <a name="Examples-1"></a>
  1547. <h4 class="subsection">4.3.1 Examples<span class="pull-right"><a class="anchor hidden-xs" href="#Examples-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Examples-1" aria-hidden="true">TOC</a></span></h4>
  1548. <p>The following examples are all valid time duration:
  1549. </p>
  1550. <dl compact="compact">
  1551. <dt>&lsquo;<samp>55</samp>&rsquo;</dt>
  1552. <dd><p>55 seconds
  1553. </p>
  1554. </dd>
  1555. <dt>&lsquo;<samp>12:03:45</samp>&rsquo;</dt>
  1556. <dd><p>12 hours, 03 minutes and 45 seconds
  1557. </p>
  1558. </dd>
  1559. <dt>&lsquo;<samp>23.189</samp>&rsquo;</dt>
  1560. <dd><p>23.189 seconds
  1561. </p></dd>
  1562. </dl>
  1563. <a name="video-size-syntax"></a><a name="Video-size"></a>
  1564. <h3 class="section">4.4 Video size<span class="pull-right"><a class="anchor hidden-xs" href="#Video-size" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Video-size" aria-hidden="true">TOC</a></span></h3>
  1565. <p>Specify the size of the sourced video, it may be a string of the form
  1566. <var>width</var>x<var>height</var>, or the name of a size abbreviation.
  1567. </p>
  1568. <p>The following abbreviations are recognized:
  1569. </p><dl compact="compact">
  1570. <dt>&lsquo;<samp>ntsc</samp>&rsquo;</dt>
  1571. <dd><p>720x480
  1572. </p></dd>
  1573. <dt>&lsquo;<samp>pal</samp>&rsquo;</dt>
  1574. <dd><p>720x576
  1575. </p></dd>
  1576. <dt>&lsquo;<samp>qntsc</samp>&rsquo;</dt>
  1577. <dd><p>352x240
  1578. </p></dd>
  1579. <dt>&lsquo;<samp>qpal</samp>&rsquo;</dt>
  1580. <dd><p>352x288
  1581. </p></dd>
  1582. <dt>&lsquo;<samp>sntsc</samp>&rsquo;</dt>
  1583. <dd><p>640x480
  1584. </p></dd>
  1585. <dt>&lsquo;<samp>spal</samp>&rsquo;</dt>
  1586. <dd><p>768x576
  1587. </p></dd>
  1588. <dt>&lsquo;<samp>film</samp>&rsquo;</dt>
  1589. <dd><p>352x240
  1590. </p></dd>
  1591. <dt>&lsquo;<samp>ntsc-film</samp>&rsquo;</dt>
  1592. <dd><p>352x240
  1593. </p></dd>
  1594. <dt>&lsquo;<samp>sqcif</samp>&rsquo;</dt>
  1595. <dd><p>128x96
  1596. </p></dd>
  1597. <dt>&lsquo;<samp>qcif</samp>&rsquo;</dt>
  1598. <dd><p>176x144
  1599. </p></dd>
  1600. <dt>&lsquo;<samp>cif</samp>&rsquo;</dt>
  1601. <dd><p>352x288
  1602. </p></dd>
  1603. <dt>&lsquo;<samp>4cif</samp>&rsquo;</dt>
  1604. <dd><p>704x576
  1605. </p></dd>
  1606. <dt>&lsquo;<samp>16cif</samp>&rsquo;</dt>
  1607. <dd><p>1408x1152
  1608. </p></dd>
  1609. <dt>&lsquo;<samp>qqvga</samp>&rsquo;</dt>
  1610. <dd><p>160x120
  1611. </p></dd>
  1612. <dt>&lsquo;<samp>qvga</samp>&rsquo;</dt>
  1613. <dd><p>320x240
  1614. </p></dd>
  1615. <dt>&lsquo;<samp>vga</samp>&rsquo;</dt>
  1616. <dd><p>640x480
  1617. </p></dd>
  1618. <dt>&lsquo;<samp>svga</samp>&rsquo;</dt>
  1619. <dd><p>800x600
  1620. </p></dd>
  1621. <dt>&lsquo;<samp>xga</samp>&rsquo;</dt>
  1622. <dd><p>1024x768
  1623. </p></dd>
  1624. <dt>&lsquo;<samp>uxga</samp>&rsquo;</dt>
  1625. <dd><p>1600x1200
  1626. </p></dd>
  1627. <dt>&lsquo;<samp>qxga</samp>&rsquo;</dt>
  1628. <dd><p>2048x1536
  1629. </p></dd>
  1630. <dt>&lsquo;<samp>sxga</samp>&rsquo;</dt>
  1631. <dd><p>1280x1024
  1632. </p></dd>
  1633. <dt>&lsquo;<samp>qsxga</samp>&rsquo;</dt>
  1634. <dd><p>2560x2048
  1635. </p></dd>
  1636. <dt>&lsquo;<samp>hsxga</samp>&rsquo;</dt>
  1637. <dd><p>5120x4096
  1638. </p></dd>
  1639. <dt>&lsquo;<samp>wvga</samp>&rsquo;</dt>
  1640. <dd><p>852x480
  1641. </p></dd>
  1642. <dt>&lsquo;<samp>wxga</samp>&rsquo;</dt>
  1643. <dd><p>1366x768
  1644. </p></dd>
  1645. <dt>&lsquo;<samp>wsxga</samp>&rsquo;</dt>
  1646. <dd><p>1600x1024
  1647. </p></dd>
  1648. <dt>&lsquo;<samp>wuxga</samp>&rsquo;</dt>
  1649. <dd><p>1920x1200
  1650. </p></dd>
  1651. <dt>&lsquo;<samp>woxga</samp>&rsquo;</dt>
  1652. <dd><p>2560x1600
  1653. </p></dd>
  1654. <dt>&lsquo;<samp>wqsxga</samp>&rsquo;</dt>
  1655. <dd><p>3200x2048
  1656. </p></dd>
  1657. <dt>&lsquo;<samp>wquxga</samp>&rsquo;</dt>
  1658. <dd><p>3840x2400
  1659. </p></dd>
  1660. <dt>&lsquo;<samp>whsxga</samp>&rsquo;</dt>
  1661. <dd><p>6400x4096
  1662. </p></dd>
  1663. <dt>&lsquo;<samp>whuxga</samp>&rsquo;</dt>
  1664. <dd><p>7680x4800
  1665. </p></dd>
  1666. <dt>&lsquo;<samp>cga</samp>&rsquo;</dt>
  1667. <dd><p>320x200
  1668. </p></dd>
  1669. <dt>&lsquo;<samp>ega</samp>&rsquo;</dt>
  1670. <dd><p>640x350
  1671. </p></dd>
  1672. <dt>&lsquo;<samp>hd480</samp>&rsquo;</dt>
  1673. <dd><p>852x480
  1674. </p></dd>
  1675. <dt>&lsquo;<samp>hd720</samp>&rsquo;</dt>
  1676. <dd><p>1280x720
  1677. </p></dd>
  1678. <dt>&lsquo;<samp>hd1080</samp>&rsquo;</dt>
  1679. <dd><p>1920x1080
  1680. </p></dd>
  1681. <dt>&lsquo;<samp>2k</samp>&rsquo;</dt>
  1682. <dd><p>2048x1080
  1683. </p></dd>
  1684. <dt>&lsquo;<samp>2kflat</samp>&rsquo;</dt>
  1685. <dd><p>1998x1080
  1686. </p></dd>
  1687. <dt>&lsquo;<samp>2kscope</samp>&rsquo;</dt>
  1688. <dd><p>2048x858
  1689. </p></dd>
  1690. <dt>&lsquo;<samp>4k</samp>&rsquo;</dt>
  1691. <dd><p>4096x2160
  1692. </p></dd>
  1693. <dt>&lsquo;<samp>4kflat</samp>&rsquo;</dt>
  1694. <dd><p>3996x2160
  1695. </p></dd>
  1696. <dt>&lsquo;<samp>4kscope</samp>&rsquo;</dt>
  1697. <dd><p>4096x1716
  1698. </p></dd>
  1699. <dt>&lsquo;<samp>nhd</samp>&rsquo;</dt>
  1700. <dd><p>640x360
  1701. </p></dd>
  1702. <dt>&lsquo;<samp>hqvga</samp>&rsquo;</dt>
  1703. <dd><p>240x160
  1704. </p></dd>
  1705. <dt>&lsquo;<samp>wqvga</samp>&rsquo;</dt>
  1706. <dd><p>400x240
  1707. </p></dd>
  1708. <dt>&lsquo;<samp>fwqvga</samp>&rsquo;</dt>
  1709. <dd><p>432x240
  1710. </p></dd>
  1711. <dt>&lsquo;<samp>hvga</samp>&rsquo;</dt>
  1712. <dd><p>480x320
  1713. </p></dd>
  1714. <dt>&lsquo;<samp>qhd</samp>&rsquo;</dt>
  1715. <dd><p>960x540
  1716. </p></dd>
  1717. </dl>
  1718. <a name="video-rate-syntax"></a><a name="Video-rate"></a>
  1719. <h3 class="section">4.5 Video rate<span class="pull-right"><a class="anchor hidden-xs" href="#Video-rate" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Video-rate" aria-hidden="true">TOC</a></span></h3>
  1720. <p>Specify the frame rate of a video, expressed as the number of frames
  1721. generated per second. It has to be a string in the format
  1722. <var>frame_rate_num</var>/<var>frame_rate_den</var>, an integer number, a float
  1723. number or a valid video frame rate abbreviation.
  1724. </p>
  1725. <p>The following abbreviations are recognized:
  1726. </p><dl compact="compact">
  1727. <dt>&lsquo;<samp>ntsc</samp>&rsquo;</dt>
  1728. <dd><p>30000/1001
  1729. </p></dd>
  1730. <dt>&lsquo;<samp>pal</samp>&rsquo;</dt>
  1731. <dd><p>25/1
  1732. </p></dd>
  1733. <dt>&lsquo;<samp>qntsc</samp>&rsquo;</dt>
  1734. <dd><p>30000/1001
  1735. </p></dd>
  1736. <dt>&lsquo;<samp>qpal</samp>&rsquo;</dt>
  1737. <dd><p>25/1
  1738. </p></dd>
  1739. <dt>&lsquo;<samp>sntsc</samp>&rsquo;</dt>
  1740. <dd><p>30000/1001
  1741. </p></dd>
  1742. <dt>&lsquo;<samp>spal</samp>&rsquo;</dt>
  1743. <dd><p>25/1
  1744. </p></dd>
  1745. <dt>&lsquo;<samp>film</samp>&rsquo;</dt>
  1746. <dd><p>24/1
  1747. </p></dd>
  1748. <dt>&lsquo;<samp>ntsc-film</samp>&rsquo;</dt>
  1749. <dd><p>24000/1001
  1750. </p></dd>
  1751. </dl>
  1752. <a name="ratio-syntax"></a><a name="Ratio"></a>
  1753. <h3 class="section">4.6 Ratio<span class="pull-right"><a class="anchor hidden-xs" href="#Ratio" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Ratio" aria-hidden="true">TOC</a></span></h3>
  1754. <p>A ratio can be expressed as an expression, or in the form
  1755. <var>numerator</var>:<var>denominator</var>.
  1756. </p>
  1757. <p>Note that a ratio with infinite (1/0) or negative value is
  1758. considered valid, so you should check on the returned value if you
  1759. want to exclude those values.
  1760. </p>
  1761. <p>The undefined value can be expressed using the &quot;0:0&quot; string.
  1762. </p>
  1763. <a name="color-syntax"></a><a name="Color"></a>
  1764. <h3 class="section">4.7 Color<span class="pull-right"><a class="anchor hidden-xs" href="#Color" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Color" aria-hidden="true">TOC</a></span></h3>
  1765. <p>It can be the name of a color as defined below (case insensitive match) or a
  1766. <code>[0x|#]RRGGBB[AA]</code> sequence, possibly followed by @ and a string
  1767. representing the alpha component.
  1768. </p>
  1769. <p>The alpha component may be a string composed by &quot;0x&quot; followed by an
  1770. hexadecimal number or a decimal number between 0.0 and 1.0, which
  1771. represents the opacity value (&lsquo;<samp>0x00</samp>&rsquo; or &lsquo;<samp>0.0</samp>&rsquo; means completely
  1772. transparent, &lsquo;<samp>0xff</samp>&rsquo; or &lsquo;<samp>1.0</samp>&rsquo; completely opaque). If the alpha
  1773. component is not specified then &lsquo;<samp>0xff</samp>&rsquo; is assumed.
  1774. </p>
  1775. <p>The string &lsquo;<samp>random</samp>&rsquo; will result in a random color.
  1776. </p>
  1777. <p>The following names of colors are recognized:
  1778. </p><dl compact="compact">
  1779. <dt>&lsquo;<samp>AliceBlue</samp>&rsquo;</dt>
  1780. <dd><p>0xF0F8FF
  1781. </p></dd>
  1782. <dt>&lsquo;<samp>AntiqueWhite</samp>&rsquo;</dt>
  1783. <dd><p>0xFAEBD7
  1784. </p></dd>
  1785. <dt>&lsquo;<samp>Aqua</samp>&rsquo;</dt>
  1786. <dd><p>0x00FFFF
  1787. </p></dd>
  1788. <dt>&lsquo;<samp>Aquamarine</samp>&rsquo;</dt>
  1789. <dd><p>0x7FFFD4
  1790. </p></dd>
  1791. <dt>&lsquo;<samp>Azure</samp>&rsquo;</dt>
  1792. <dd><p>0xF0FFFF
  1793. </p></dd>
  1794. <dt>&lsquo;<samp>Beige</samp>&rsquo;</dt>
  1795. <dd><p>0xF5F5DC
  1796. </p></dd>
  1797. <dt>&lsquo;<samp>Bisque</samp>&rsquo;</dt>
  1798. <dd><p>0xFFE4C4
  1799. </p></dd>
  1800. <dt>&lsquo;<samp>Black</samp>&rsquo;</dt>
  1801. <dd><p>0x000000
  1802. </p></dd>
  1803. <dt>&lsquo;<samp>BlanchedAlmond</samp>&rsquo;</dt>
  1804. <dd><p>0xFFEBCD
  1805. </p></dd>
  1806. <dt>&lsquo;<samp>Blue</samp>&rsquo;</dt>
  1807. <dd><p>0x0000FF
  1808. </p></dd>
  1809. <dt>&lsquo;<samp>BlueViolet</samp>&rsquo;</dt>
  1810. <dd><p>0x8A2BE2
  1811. </p></dd>
  1812. <dt>&lsquo;<samp>Brown</samp>&rsquo;</dt>
  1813. <dd><p>0xA52A2A
  1814. </p></dd>
  1815. <dt>&lsquo;<samp>BurlyWood</samp>&rsquo;</dt>
  1816. <dd><p>0xDEB887
  1817. </p></dd>
  1818. <dt>&lsquo;<samp>CadetBlue</samp>&rsquo;</dt>
  1819. <dd><p>0x5F9EA0
  1820. </p></dd>
  1821. <dt>&lsquo;<samp>Chartreuse</samp>&rsquo;</dt>
  1822. <dd><p>0x7FFF00
  1823. </p></dd>
  1824. <dt>&lsquo;<samp>Chocolate</samp>&rsquo;</dt>
  1825. <dd><p>0xD2691E
  1826. </p></dd>
  1827. <dt>&lsquo;<samp>Coral</samp>&rsquo;</dt>
  1828. <dd><p>0xFF7F50
  1829. </p></dd>
  1830. <dt>&lsquo;<samp>CornflowerBlue</samp>&rsquo;</dt>
  1831. <dd><p>0x6495ED
  1832. </p></dd>
  1833. <dt>&lsquo;<samp>Cornsilk</samp>&rsquo;</dt>
  1834. <dd><p>0xFFF8DC
  1835. </p></dd>
  1836. <dt>&lsquo;<samp>Crimson</samp>&rsquo;</dt>
  1837. <dd><p>0xDC143C
  1838. </p></dd>
  1839. <dt>&lsquo;<samp>Cyan</samp>&rsquo;</dt>
  1840. <dd><p>0x00FFFF
  1841. </p></dd>
  1842. <dt>&lsquo;<samp>DarkBlue</samp>&rsquo;</dt>
  1843. <dd><p>0x00008B
  1844. </p></dd>
  1845. <dt>&lsquo;<samp>DarkCyan</samp>&rsquo;</dt>
  1846. <dd><p>0x008B8B
  1847. </p></dd>
  1848. <dt>&lsquo;<samp>DarkGoldenRod</samp>&rsquo;</dt>
  1849. <dd><p>0xB8860B
  1850. </p></dd>
  1851. <dt>&lsquo;<samp>DarkGray</samp>&rsquo;</dt>
  1852. <dd><p>0xA9A9A9
  1853. </p></dd>
  1854. <dt>&lsquo;<samp>DarkGreen</samp>&rsquo;</dt>
  1855. <dd><p>0x006400
  1856. </p></dd>
  1857. <dt>&lsquo;<samp>DarkKhaki</samp>&rsquo;</dt>
  1858. <dd><p>0xBDB76B
  1859. </p></dd>
  1860. <dt>&lsquo;<samp>DarkMagenta</samp>&rsquo;</dt>
  1861. <dd><p>0x8B008B
  1862. </p></dd>
  1863. <dt>&lsquo;<samp>DarkOliveGreen</samp>&rsquo;</dt>
  1864. <dd><p>0x556B2F
  1865. </p></dd>
  1866. <dt>&lsquo;<samp>Darkorange</samp>&rsquo;</dt>
  1867. <dd><p>0xFF8C00
  1868. </p></dd>
  1869. <dt>&lsquo;<samp>DarkOrchid</samp>&rsquo;</dt>
  1870. <dd><p>0x9932CC
  1871. </p></dd>
  1872. <dt>&lsquo;<samp>DarkRed</samp>&rsquo;</dt>
  1873. <dd><p>0x8B0000
  1874. </p></dd>
  1875. <dt>&lsquo;<samp>DarkSalmon</samp>&rsquo;</dt>
  1876. <dd><p>0xE9967A
  1877. </p></dd>
  1878. <dt>&lsquo;<samp>DarkSeaGreen</samp>&rsquo;</dt>
  1879. <dd><p>0x8FBC8F
  1880. </p></dd>
  1881. <dt>&lsquo;<samp>DarkSlateBlue</samp>&rsquo;</dt>
  1882. <dd><p>0x483D8B
  1883. </p></dd>
  1884. <dt>&lsquo;<samp>DarkSlateGray</samp>&rsquo;</dt>
  1885. <dd><p>0x2F4F4F
  1886. </p></dd>
  1887. <dt>&lsquo;<samp>DarkTurquoise</samp>&rsquo;</dt>
  1888. <dd><p>0x00CED1
  1889. </p></dd>
  1890. <dt>&lsquo;<samp>DarkViolet</samp>&rsquo;</dt>
  1891. <dd><p>0x9400D3
  1892. </p></dd>
  1893. <dt>&lsquo;<samp>DeepPink</samp>&rsquo;</dt>
  1894. <dd><p>0xFF1493
  1895. </p></dd>
  1896. <dt>&lsquo;<samp>DeepSkyBlue</samp>&rsquo;</dt>
  1897. <dd><p>0x00BFFF
  1898. </p></dd>
  1899. <dt>&lsquo;<samp>DimGray</samp>&rsquo;</dt>
  1900. <dd><p>0x696969
  1901. </p></dd>
  1902. <dt>&lsquo;<samp>DodgerBlue</samp>&rsquo;</dt>
  1903. <dd><p>0x1E90FF
  1904. </p></dd>
  1905. <dt>&lsquo;<samp>FireBrick</samp>&rsquo;</dt>
  1906. <dd><p>0xB22222
  1907. </p></dd>
  1908. <dt>&lsquo;<samp>FloralWhite</samp>&rsquo;</dt>
  1909. <dd><p>0xFFFAF0
  1910. </p></dd>
  1911. <dt>&lsquo;<samp>ForestGreen</samp>&rsquo;</dt>
  1912. <dd><p>0x228B22
  1913. </p></dd>
  1914. <dt>&lsquo;<samp>Fuchsia</samp>&rsquo;</dt>
  1915. <dd><p>0xFF00FF
  1916. </p></dd>
  1917. <dt>&lsquo;<samp>Gainsboro</samp>&rsquo;</dt>
  1918. <dd><p>0xDCDCDC
  1919. </p></dd>
  1920. <dt>&lsquo;<samp>GhostWhite</samp>&rsquo;</dt>
  1921. <dd><p>0xF8F8FF
  1922. </p></dd>
  1923. <dt>&lsquo;<samp>Gold</samp>&rsquo;</dt>
  1924. <dd><p>0xFFD700
  1925. </p></dd>
  1926. <dt>&lsquo;<samp>GoldenRod</samp>&rsquo;</dt>
  1927. <dd><p>0xDAA520
  1928. </p></dd>
  1929. <dt>&lsquo;<samp>Gray</samp>&rsquo;</dt>
  1930. <dd><p>0x808080
  1931. </p></dd>
  1932. <dt>&lsquo;<samp>Green</samp>&rsquo;</dt>
  1933. <dd><p>0x008000
  1934. </p></dd>
  1935. <dt>&lsquo;<samp>GreenYellow</samp>&rsquo;</dt>
  1936. <dd><p>0xADFF2F
  1937. </p></dd>
  1938. <dt>&lsquo;<samp>HoneyDew</samp>&rsquo;</dt>
  1939. <dd><p>0xF0FFF0
  1940. </p></dd>
  1941. <dt>&lsquo;<samp>HotPink</samp>&rsquo;</dt>
  1942. <dd><p>0xFF69B4
  1943. </p></dd>
  1944. <dt>&lsquo;<samp>IndianRed</samp>&rsquo;</dt>
  1945. <dd><p>0xCD5C5C
  1946. </p></dd>
  1947. <dt>&lsquo;<samp>Indigo</samp>&rsquo;</dt>
  1948. <dd><p>0x4B0082
  1949. </p></dd>
  1950. <dt>&lsquo;<samp>Ivory</samp>&rsquo;</dt>
  1951. <dd><p>0xFFFFF0
  1952. </p></dd>
  1953. <dt>&lsquo;<samp>Khaki</samp>&rsquo;</dt>
  1954. <dd><p>0xF0E68C
  1955. </p></dd>
  1956. <dt>&lsquo;<samp>Lavender</samp>&rsquo;</dt>
  1957. <dd><p>0xE6E6FA
  1958. </p></dd>
  1959. <dt>&lsquo;<samp>LavenderBlush</samp>&rsquo;</dt>
  1960. <dd><p>0xFFF0F5
  1961. </p></dd>
  1962. <dt>&lsquo;<samp>LawnGreen</samp>&rsquo;</dt>
  1963. <dd><p>0x7CFC00
  1964. </p></dd>
  1965. <dt>&lsquo;<samp>LemonChiffon</samp>&rsquo;</dt>
  1966. <dd><p>0xFFFACD
  1967. </p></dd>
  1968. <dt>&lsquo;<samp>LightBlue</samp>&rsquo;</dt>
  1969. <dd><p>0xADD8E6
  1970. </p></dd>
  1971. <dt>&lsquo;<samp>LightCoral</samp>&rsquo;</dt>
  1972. <dd><p>0xF08080
  1973. </p></dd>
  1974. <dt>&lsquo;<samp>LightCyan</samp>&rsquo;</dt>
  1975. <dd><p>0xE0FFFF
  1976. </p></dd>
  1977. <dt>&lsquo;<samp>LightGoldenRodYellow</samp>&rsquo;</dt>
  1978. <dd><p>0xFAFAD2
  1979. </p></dd>
  1980. <dt>&lsquo;<samp>LightGreen</samp>&rsquo;</dt>
  1981. <dd><p>0x90EE90
  1982. </p></dd>
  1983. <dt>&lsquo;<samp>LightGrey</samp>&rsquo;</dt>
  1984. <dd><p>0xD3D3D3
  1985. </p></dd>
  1986. <dt>&lsquo;<samp>LightPink</samp>&rsquo;</dt>
  1987. <dd><p>0xFFB6C1
  1988. </p></dd>
  1989. <dt>&lsquo;<samp>LightSalmon</samp>&rsquo;</dt>
  1990. <dd><p>0xFFA07A
  1991. </p></dd>
  1992. <dt>&lsquo;<samp>LightSeaGreen</samp>&rsquo;</dt>
  1993. <dd><p>0x20B2AA
  1994. </p></dd>
  1995. <dt>&lsquo;<samp>LightSkyBlue</samp>&rsquo;</dt>
  1996. <dd><p>0x87CEFA
  1997. </p></dd>
  1998. <dt>&lsquo;<samp>LightSlateGray</samp>&rsquo;</dt>
  1999. <dd><p>0x778899
  2000. </p></dd>
  2001. <dt>&lsquo;<samp>LightSteelBlue</samp>&rsquo;</dt>
  2002. <dd><p>0xB0C4DE
  2003. </p></dd>
  2004. <dt>&lsquo;<samp>LightYellow</samp>&rsquo;</dt>
  2005. <dd><p>0xFFFFE0
  2006. </p></dd>
  2007. <dt>&lsquo;<samp>Lime</samp>&rsquo;</dt>
  2008. <dd><p>0x00FF00
  2009. </p></dd>
  2010. <dt>&lsquo;<samp>LimeGreen</samp>&rsquo;</dt>
  2011. <dd><p>0x32CD32
  2012. </p></dd>
  2013. <dt>&lsquo;<samp>Linen</samp>&rsquo;</dt>
  2014. <dd><p>0xFAF0E6
  2015. </p></dd>
  2016. <dt>&lsquo;<samp>Magenta</samp>&rsquo;</dt>
  2017. <dd><p>0xFF00FF
  2018. </p></dd>
  2019. <dt>&lsquo;<samp>Maroon</samp>&rsquo;</dt>
  2020. <dd><p>0x800000
  2021. </p></dd>
  2022. <dt>&lsquo;<samp>MediumAquaMarine</samp>&rsquo;</dt>
  2023. <dd><p>0x66CDAA
  2024. </p></dd>
  2025. <dt>&lsquo;<samp>MediumBlue</samp>&rsquo;</dt>
  2026. <dd><p>0x0000CD
  2027. </p></dd>
  2028. <dt>&lsquo;<samp>MediumOrchid</samp>&rsquo;</dt>
  2029. <dd><p>0xBA55D3
  2030. </p></dd>
  2031. <dt>&lsquo;<samp>MediumPurple</samp>&rsquo;</dt>
  2032. <dd><p>0x9370D8
  2033. </p></dd>
  2034. <dt>&lsquo;<samp>MediumSeaGreen</samp>&rsquo;</dt>
  2035. <dd><p>0x3CB371
  2036. </p></dd>
  2037. <dt>&lsquo;<samp>MediumSlateBlue</samp>&rsquo;</dt>
  2038. <dd><p>0x7B68EE
  2039. </p></dd>
  2040. <dt>&lsquo;<samp>MediumSpringGreen</samp>&rsquo;</dt>
  2041. <dd><p>0x00FA9A
  2042. </p></dd>
  2043. <dt>&lsquo;<samp>MediumTurquoise</samp>&rsquo;</dt>
  2044. <dd><p>0x48D1CC
  2045. </p></dd>
  2046. <dt>&lsquo;<samp>MediumVioletRed</samp>&rsquo;</dt>
  2047. <dd><p>0xC71585
  2048. </p></dd>
  2049. <dt>&lsquo;<samp>MidnightBlue</samp>&rsquo;</dt>
  2050. <dd><p>0x191970
  2051. </p></dd>
  2052. <dt>&lsquo;<samp>MintCream</samp>&rsquo;</dt>
  2053. <dd><p>0xF5FFFA
  2054. </p></dd>
  2055. <dt>&lsquo;<samp>MistyRose</samp>&rsquo;</dt>
  2056. <dd><p>0xFFE4E1
  2057. </p></dd>
  2058. <dt>&lsquo;<samp>Moccasin</samp>&rsquo;</dt>
  2059. <dd><p>0xFFE4B5
  2060. </p></dd>
  2061. <dt>&lsquo;<samp>NavajoWhite</samp>&rsquo;</dt>
  2062. <dd><p>0xFFDEAD
  2063. </p></dd>
  2064. <dt>&lsquo;<samp>Navy</samp>&rsquo;</dt>
  2065. <dd><p>0x000080
  2066. </p></dd>
  2067. <dt>&lsquo;<samp>OldLace</samp>&rsquo;</dt>
  2068. <dd><p>0xFDF5E6
  2069. </p></dd>
  2070. <dt>&lsquo;<samp>Olive</samp>&rsquo;</dt>
  2071. <dd><p>0x808000
  2072. </p></dd>
  2073. <dt>&lsquo;<samp>OliveDrab</samp>&rsquo;</dt>
  2074. <dd><p>0x6B8E23
  2075. </p></dd>
  2076. <dt>&lsquo;<samp>Orange</samp>&rsquo;</dt>
  2077. <dd><p>0xFFA500
  2078. </p></dd>
  2079. <dt>&lsquo;<samp>OrangeRed</samp>&rsquo;</dt>
  2080. <dd><p>0xFF4500
  2081. </p></dd>
  2082. <dt>&lsquo;<samp>Orchid</samp>&rsquo;</dt>
  2083. <dd><p>0xDA70D6
  2084. </p></dd>
  2085. <dt>&lsquo;<samp>PaleGoldenRod</samp>&rsquo;</dt>
  2086. <dd><p>0xEEE8AA
  2087. </p></dd>
  2088. <dt>&lsquo;<samp>PaleGreen</samp>&rsquo;</dt>
  2089. <dd><p>0x98FB98
  2090. </p></dd>
  2091. <dt>&lsquo;<samp>PaleTurquoise</samp>&rsquo;</dt>
  2092. <dd><p>0xAFEEEE
  2093. </p></dd>
  2094. <dt>&lsquo;<samp>PaleVioletRed</samp>&rsquo;</dt>
  2095. <dd><p>0xD87093
  2096. </p></dd>
  2097. <dt>&lsquo;<samp>PapayaWhip</samp>&rsquo;</dt>
  2098. <dd><p>0xFFEFD5
  2099. </p></dd>
  2100. <dt>&lsquo;<samp>PeachPuff</samp>&rsquo;</dt>
  2101. <dd><p>0xFFDAB9
  2102. </p></dd>
  2103. <dt>&lsquo;<samp>Peru</samp>&rsquo;</dt>
  2104. <dd><p>0xCD853F
  2105. </p></dd>
  2106. <dt>&lsquo;<samp>Pink</samp>&rsquo;</dt>
  2107. <dd><p>0xFFC0CB
  2108. </p></dd>
  2109. <dt>&lsquo;<samp>Plum</samp>&rsquo;</dt>
  2110. <dd><p>0xDDA0DD
  2111. </p></dd>
  2112. <dt>&lsquo;<samp>PowderBlue</samp>&rsquo;</dt>
  2113. <dd><p>0xB0E0E6
  2114. </p></dd>
  2115. <dt>&lsquo;<samp>Purple</samp>&rsquo;</dt>
  2116. <dd><p>0x800080
  2117. </p></dd>
  2118. <dt>&lsquo;<samp>Red</samp>&rsquo;</dt>
  2119. <dd><p>0xFF0000
  2120. </p></dd>
  2121. <dt>&lsquo;<samp>RosyBrown</samp>&rsquo;</dt>
  2122. <dd><p>0xBC8F8F
  2123. </p></dd>
  2124. <dt>&lsquo;<samp>RoyalBlue</samp>&rsquo;</dt>
  2125. <dd><p>0x4169E1
  2126. </p></dd>
  2127. <dt>&lsquo;<samp>SaddleBrown</samp>&rsquo;</dt>
  2128. <dd><p>0x8B4513
  2129. </p></dd>
  2130. <dt>&lsquo;<samp>Salmon</samp>&rsquo;</dt>
  2131. <dd><p>0xFA8072
  2132. </p></dd>
  2133. <dt>&lsquo;<samp>SandyBrown</samp>&rsquo;</dt>
  2134. <dd><p>0xF4A460
  2135. </p></dd>
  2136. <dt>&lsquo;<samp>SeaGreen</samp>&rsquo;</dt>
  2137. <dd><p>0x2E8B57
  2138. </p></dd>
  2139. <dt>&lsquo;<samp>SeaShell</samp>&rsquo;</dt>
  2140. <dd><p>0xFFF5EE
  2141. </p></dd>
  2142. <dt>&lsquo;<samp>Sienna</samp>&rsquo;</dt>
  2143. <dd><p>0xA0522D
  2144. </p></dd>
  2145. <dt>&lsquo;<samp>Silver</samp>&rsquo;</dt>
  2146. <dd><p>0xC0C0C0
  2147. </p></dd>
  2148. <dt>&lsquo;<samp>SkyBlue</samp>&rsquo;</dt>
  2149. <dd><p>0x87CEEB
  2150. </p></dd>
  2151. <dt>&lsquo;<samp>SlateBlue</samp>&rsquo;</dt>
  2152. <dd><p>0x6A5ACD
  2153. </p></dd>
  2154. <dt>&lsquo;<samp>SlateGray</samp>&rsquo;</dt>
  2155. <dd><p>0x708090
  2156. </p></dd>
  2157. <dt>&lsquo;<samp>Snow</samp>&rsquo;</dt>
  2158. <dd><p>0xFFFAFA
  2159. </p></dd>
  2160. <dt>&lsquo;<samp>SpringGreen</samp>&rsquo;</dt>
  2161. <dd><p>0x00FF7F
  2162. </p></dd>
  2163. <dt>&lsquo;<samp>SteelBlue</samp>&rsquo;</dt>
  2164. <dd><p>0x4682B4
  2165. </p></dd>
  2166. <dt>&lsquo;<samp>Tan</samp>&rsquo;</dt>
  2167. <dd><p>0xD2B48C
  2168. </p></dd>
  2169. <dt>&lsquo;<samp>Teal</samp>&rsquo;</dt>
  2170. <dd><p>0x008080
  2171. </p></dd>
  2172. <dt>&lsquo;<samp>Thistle</samp>&rsquo;</dt>
  2173. <dd><p>0xD8BFD8
  2174. </p></dd>
  2175. <dt>&lsquo;<samp>Tomato</samp>&rsquo;</dt>
  2176. <dd><p>0xFF6347
  2177. </p></dd>
  2178. <dt>&lsquo;<samp>Turquoise</samp>&rsquo;</dt>
  2179. <dd><p>0x40E0D0
  2180. </p></dd>
  2181. <dt>&lsquo;<samp>Violet</samp>&rsquo;</dt>
  2182. <dd><p>0xEE82EE
  2183. </p></dd>
  2184. <dt>&lsquo;<samp>Wheat</samp>&rsquo;</dt>
  2185. <dd><p>0xF5DEB3
  2186. </p></dd>
  2187. <dt>&lsquo;<samp>White</samp>&rsquo;</dt>
  2188. <dd><p>0xFFFFFF
  2189. </p></dd>
  2190. <dt>&lsquo;<samp>WhiteSmoke</samp>&rsquo;</dt>
  2191. <dd><p>0xF5F5F5
  2192. </p></dd>
  2193. <dt>&lsquo;<samp>Yellow</samp>&rsquo;</dt>
  2194. <dd><p>0xFFFF00
  2195. </p></dd>
  2196. <dt>&lsquo;<samp>YellowGreen</samp>&rsquo;</dt>
  2197. <dd><p>0x9ACD32
  2198. </p></dd>
  2199. </dl>
  2200. <a name="channel-layout-syntax"></a><a name="Channel-Layout"></a>
  2201. <h3 class="section">4.8 Channel Layout<span class="pull-right"><a class="anchor hidden-xs" href="#Channel-Layout" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Channel-Layout" aria-hidden="true">TOC</a></span></h3>
  2202. <p>A channel layout specifies the spatial disposition of the channels in
  2203. a multi-channel audio stream. To specify a channel layout, FFmpeg
  2204. makes use of a special syntax.
  2205. </p>
  2206. <p>Individual channels are identified by an id, as given by the table
  2207. below:
  2208. </p><dl compact="compact">
  2209. <dt>&lsquo;<samp>FL</samp>&rsquo;</dt>
  2210. <dd><p>front left
  2211. </p></dd>
  2212. <dt>&lsquo;<samp>FR</samp>&rsquo;</dt>
  2213. <dd><p>front right
  2214. </p></dd>
  2215. <dt>&lsquo;<samp>FC</samp>&rsquo;</dt>
  2216. <dd><p>front center
  2217. </p></dd>
  2218. <dt>&lsquo;<samp>LFE</samp>&rsquo;</dt>
  2219. <dd><p>low frequency
  2220. </p></dd>
  2221. <dt>&lsquo;<samp>BL</samp>&rsquo;</dt>
  2222. <dd><p>back left
  2223. </p></dd>
  2224. <dt>&lsquo;<samp>BR</samp>&rsquo;</dt>
  2225. <dd><p>back right
  2226. </p></dd>
  2227. <dt>&lsquo;<samp>FLC</samp>&rsquo;</dt>
  2228. <dd><p>front left-of-center
  2229. </p></dd>
  2230. <dt>&lsquo;<samp>FRC</samp>&rsquo;</dt>
  2231. <dd><p>front right-of-center
  2232. </p></dd>
  2233. <dt>&lsquo;<samp>BC</samp>&rsquo;</dt>
  2234. <dd><p>back center
  2235. </p></dd>
  2236. <dt>&lsquo;<samp>SL</samp>&rsquo;</dt>
  2237. <dd><p>side left
  2238. </p></dd>
  2239. <dt>&lsquo;<samp>SR</samp>&rsquo;</dt>
  2240. <dd><p>side right
  2241. </p></dd>
  2242. <dt>&lsquo;<samp>TC</samp>&rsquo;</dt>
  2243. <dd><p>top center
  2244. </p></dd>
  2245. <dt>&lsquo;<samp>TFL</samp>&rsquo;</dt>
  2246. <dd><p>top front left
  2247. </p></dd>
  2248. <dt>&lsquo;<samp>TFC</samp>&rsquo;</dt>
  2249. <dd><p>top front center
  2250. </p></dd>
  2251. <dt>&lsquo;<samp>TFR</samp>&rsquo;</dt>
  2252. <dd><p>top front right
  2253. </p></dd>
  2254. <dt>&lsquo;<samp>TBL</samp>&rsquo;</dt>
  2255. <dd><p>top back left
  2256. </p></dd>
  2257. <dt>&lsquo;<samp>TBC</samp>&rsquo;</dt>
  2258. <dd><p>top back center
  2259. </p></dd>
  2260. <dt>&lsquo;<samp>TBR</samp>&rsquo;</dt>
  2261. <dd><p>top back right
  2262. </p></dd>
  2263. <dt>&lsquo;<samp>DL</samp>&rsquo;</dt>
  2264. <dd><p>downmix left
  2265. </p></dd>
  2266. <dt>&lsquo;<samp>DR</samp>&rsquo;</dt>
  2267. <dd><p>downmix right
  2268. </p></dd>
  2269. <dt>&lsquo;<samp>WL</samp>&rsquo;</dt>
  2270. <dd><p>wide left
  2271. </p></dd>
  2272. <dt>&lsquo;<samp>WR</samp>&rsquo;</dt>
  2273. <dd><p>wide right
  2274. </p></dd>
  2275. <dt>&lsquo;<samp>SDL</samp>&rsquo;</dt>
  2276. <dd><p>surround direct left
  2277. </p></dd>
  2278. <dt>&lsquo;<samp>SDR</samp>&rsquo;</dt>
  2279. <dd><p>surround direct right
  2280. </p></dd>
  2281. <dt>&lsquo;<samp>LFE2</samp>&rsquo;</dt>
  2282. <dd><p>low frequency 2
  2283. </p></dd>
  2284. </dl>
  2285. <p>Standard channel layout compositions can be specified by using the
  2286. following identifiers:
  2287. </p><dl compact="compact">
  2288. <dt>&lsquo;<samp>mono</samp>&rsquo;</dt>
  2289. <dd><p>FC
  2290. </p></dd>
  2291. <dt>&lsquo;<samp>stereo</samp>&rsquo;</dt>
  2292. <dd><p>FL+FR
  2293. </p></dd>
  2294. <dt>&lsquo;<samp>2.1</samp>&rsquo;</dt>
  2295. <dd><p>FL+FR+LFE
  2296. </p></dd>
  2297. <dt>&lsquo;<samp>3.0</samp>&rsquo;</dt>
  2298. <dd><p>FL+FR+FC
  2299. </p></dd>
  2300. <dt>&lsquo;<samp>3.0(back)</samp>&rsquo;</dt>
  2301. <dd><p>FL+FR+BC
  2302. </p></dd>
  2303. <dt>&lsquo;<samp>4.0</samp>&rsquo;</dt>
  2304. <dd><p>FL+FR+FC+BC
  2305. </p></dd>
  2306. <dt>&lsquo;<samp>quad</samp>&rsquo;</dt>
  2307. <dd><p>FL+FR+BL+BR
  2308. </p></dd>
  2309. <dt>&lsquo;<samp>quad(side)</samp>&rsquo;</dt>
  2310. <dd><p>FL+FR+SL+SR
  2311. </p></dd>
  2312. <dt>&lsquo;<samp>3.1</samp>&rsquo;</dt>
  2313. <dd><p>FL+FR+FC+LFE
  2314. </p></dd>
  2315. <dt>&lsquo;<samp>5.0</samp>&rsquo;</dt>
  2316. <dd><p>FL+FR+FC+BL+BR
  2317. </p></dd>
  2318. <dt>&lsquo;<samp>5.0(side)</samp>&rsquo;</dt>
  2319. <dd><p>FL+FR+FC+SL+SR
  2320. </p></dd>
  2321. <dt>&lsquo;<samp>4.1</samp>&rsquo;</dt>
  2322. <dd><p>FL+FR+FC+LFE+BC
  2323. </p></dd>
  2324. <dt>&lsquo;<samp>5.1</samp>&rsquo;</dt>
  2325. <dd><p>FL+FR+FC+LFE+BL+BR
  2326. </p></dd>
  2327. <dt>&lsquo;<samp>5.1(side)</samp>&rsquo;</dt>
  2328. <dd><p>FL+FR+FC+LFE+SL+SR
  2329. </p></dd>
  2330. <dt>&lsquo;<samp>6.0</samp>&rsquo;</dt>
  2331. <dd><p>FL+FR+FC+BC+SL+SR
  2332. </p></dd>
  2333. <dt>&lsquo;<samp>6.0(front)</samp>&rsquo;</dt>
  2334. <dd><p>FL+FR+FLC+FRC+SL+SR
  2335. </p></dd>
  2336. <dt>&lsquo;<samp>hexagonal</samp>&rsquo;</dt>
  2337. <dd><p>FL+FR+FC+BL+BR+BC
  2338. </p></dd>
  2339. <dt>&lsquo;<samp>6.1</samp>&rsquo;</dt>
  2340. <dd><p>FL+FR+FC+LFE+BC+SL+SR
  2341. </p></dd>
  2342. <dt>&lsquo;<samp>6.1</samp>&rsquo;</dt>
  2343. <dd><p>FL+FR+FC+LFE+BL+BR+BC
  2344. </p></dd>
  2345. <dt>&lsquo;<samp>6.1(front)</samp>&rsquo;</dt>
  2346. <dd><p>FL+FR+LFE+FLC+FRC+SL+SR
  2347. </p></dd>
  2348. <dt>&lsquo;<samp>7.0</samp>&rsquo;</dt>
  2349. <dd><p>FL+FR+FC+BL+BR+SL+SR
  2350. </p></dd>
  2351. <dt>&lsquo;<samp>7.0(front)</samp>&rsquo;</dt>
  2352. <dd><p>FL+FR+FC+FLC+FRC+SL+SR
  2353. </p></dd>
  2354. <dt>&lsquo;<samp>7.1</samp>&rsquo;</dt>
  2355. <dd><p>FL+FR+FC+LFE+BL+BR+SL+SR
  2356. </p></dd>
  2357. <dt>&lsquo;<samp>7.1(wide)</samp>&rsquo;</dt>
  2358. <dd><p>FL+FR+FC+LFE+BL+BR+FLC+FRC
  2359. </p></dd>
  2360. <dt>&lsquo;<samp>7.1(wide-side)</samp>&rsquo;</dt>
  2361. <dd><p>FL+FR+FC+LFE+FLC+FRC+SL+SR
  2362. </p></dd>
  2363. <dt>&lsquo;<samp>octagonal</samp>&rsquo;</dt>
  2364. <dd><p>FL+FR+FC+BL+BR+BC+SL+SR
  2365. </p></dd>
  2366. <dt>&lsquo;<samp>downmix</samp>&rsquo;</dt>
  2367. <dd><p>DL+DR
  2368. </p></dd>
  2369. </dl>
  2370. <p>A custom channel layout can be specified as a sequence of terms, separated by
  2371. &rsquo;+&rsquo; or &rsquo;|&rsquo;. Each term can be:
  2372. </p><ul>
  2373. <li> the name of a standard channel layout (e.g. &lsquo;<samp>mono</samp>&rsquo;,
  2374. &lsquo;<samp>stereo</samp>&rsquo;, &lsquo;<samp>4.0</samp>&rsquo;, &lsquo;<samp>quad</samp>&rsquo;, &lsquo;<samp>5.0</samp>&rsquo;, etc.)
  2375. </li><li> the name of a single channel (e.g. &lsquo;<samp>FL</samp>&rsquo;, &lsquo;<samp>FR</samp>&rsquo;, &lsquo;<samp>FC</samp>&rsquo;, &lsquo;<samp>LFE</samp>&rsquo;, etc.)
  2376. </li><li> a number of channels, in decimal, optionally followed by &rsquo;c&rsquo;, yielding
  2377. the default channel layout for that number of channels (see the
  2378. function <code>av_get_default_channel_layout</code>)
  2379. </li><li> a channel layout mask, in hexadecimal starting with &quot;0x&quot; (see the
  2380. <code>AV_CH_*</code> macros in <samp>libavutil/channel_layout.h</samp>.
  2381. </li></ul>
  2382. <p>Starting from libavutil version 53 the trailing character &quot;c&quot; to
  2383. specify a number of channels will be required, while a channel layout
  2384. mask could also be specified as a decimal number (if and only if not
  2385. followed by &quot;c&quot;).
  2386. </p>
  2387. <p>See also the function <code>av_get_channel_layout</code> defined in
  2388. <samp>libavutil/channel_layout.h</samp>.
  2389. </p>
  2390. <a name="Expression-Evaluation"></a>
  2391. <h2 class="chapter">5 Expression Evaluation<span class="pull-right"><a class="anchor hidden-xs" href="#Expression-Evaluation" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Expression-Evaluation" aria-hidden="true">TOC</a></span></h2>
  2392. <p>When evaluating an arithmetic expression, FFmpeg uses an internal
  2393. formula evaluator, implemented through the <samp>libavutil/eval.h</samp>
  2394. interface.
  2395. </p>
  2396. <p>An expression may contain unary, binary operators, constants, and
  2397. functions.
  2398. </p>
  2399. <p>Two expressions <var>expr1</var> and <var>expr2</var> can be combined to form
  2400. another expression &quot;<var>expr1</var>;<var>expr2</var>&quot;.
  2401. <var>expr1</var> and <var>expr2</var> are evaluated in turn, and the new
  2402. expression evaluates to the value of <var>expr2</var>.
  2403. </p>
  2404. <p>The following binary operators are available: <code>+</code>, <code>-</code>,
  2405. <code>*</code>, <code>/</code>, <code>^</code>.
  2406. </p>
  2407. <p>The following unary operators are available: <code>+</code>, <code>-</code>.
  2408. </p>
  2409. <p>The following functions are available:
  2410. </p><dl compact="compact">
  2411. <dt><samp>abs(x)</samp></dt>
  2412. <dd><p>Compute absolute value of <var>x</var>.
  2413. </p>
  2414. </dd>
  2415. <dt><samp>acos(x)</samp></dt>
  2416. <dd><p>Compute arccosine of <var>x</var>.
  2417. </p>
  2418. </dd>
  2419. <dt><samp>asin(x)</samp></dt>
  2420. <dd><p>Compute arcsine of <var>x</var>.
  2421. </p>
  2422. </dd>
  2423. <dt><samp>atan(x)</samp></dt>
  2424. <dd><p>Compute arctangent of <var>x</var>.
  2425. </p>
  2426. </dd>
  2427. <dt><samp>between(x, min, max)</samp></dt>
  2428. <dd><p>Return 1 if <var>x</var> is greater than or equal to <var>min</var> and lesser than or
  2429. equal to <var>max</var>, 0 otherwise.
  2430. </p>
  2431. </dd>
  2432. <dt><samp>bitand(x, y)</samp></dt>
  2433. <dt><samp>bitor(x, y)</samp></dt>
  2434. <dd><p>Compute bitwise and/or operation on <var>x</var> and <var>y</var>.
  2435. </p>
  2436. <p>The results of the evaluation of <var>x</var> and <var>y</var> are converted to
  2437. integers before executing the bitwise operation.
  2438. </p>
  2439. <p>Note that both the conversion to integer and the conversion back to
  2440. floating point can lose precision. Beware of unexpected results for
  2441. large numbers (usually 2^53 and larger).
  2442. </p>
  2443. </dd>
  2444. <dt><samp>ceil(expr)</samp></dt>
  2445. <dd><p>Round the value of expression <var>expr</var> upwards to the nearest
  2446. integer. For example, &quot;ceil(1.5)&quot; is &quot;2.0&quot;.
  2447. </p>
  2448. </dd>
  2449. <dt><samp>clip(x, min, max)</samp></dt>
  2450. <dd><p>Return the value of <var>x</var> clipped between <var>min</var> and <var>max</var>.
  2451. </p>
  2452. </dd>
  2453. <dt><samp>cos(x)</samp></dt>
  2454. <dd><p>Compute cosine of <var>x</var>.
  2455. </p>
  2456. </dd>
  2457. <dt><samp>cosh(x)</samp></dt>
  2458. <dd><p>Compute hyperbolic cosine of <var>x</var>.
  2459. </p>
  2460. </dd>
  2461. <dt><samp>eq(x, y)</samp></dt>
  2462. <dd><p>Return 1 if <var>x</var> and <var>y</var> are equivalent, 0 otherwise.
  2463. </p>
  2464. </dd>
  2465. <dt><samp>exp(x)</samp></dt>
  2466. <dd><p>Compute exponential of <var>x</var> (with base <code>e</code>, the Euler&rsquo;s number).
  2467. </p>
  2468. </dd>
  2469. <dt><samp>floor(expr)</samp></dt>
  2470. <dd><p>Round the value of expression <var>expr</var> downwards to the nearest
  2471. integer. For example, &quot;floor(-1.5)&quot; is &quot;-2.0&quot;.
  2472. </p>
  2473. </dd>
  2474. <dt><samp>gauss(x)</samp></dt>
  2475. <dd><p>Compute Gauss function of <var>x</var>, corresponding to
  2476. <code>exp(-x*x/2) / sqrt(2*PI)</code>.
  2477. </p>
  2478. </dd>
  2479. <dt><samp>gcd(x, y)</samp></dt>
  2480. <dd><p>Return the greatest common divisor of <var>x</var> and <var>y</var>. If both <var>x</var> and
  2481. <var>y</var> are 0 or either or both are less than zero then behavior is undefined.
  2482. </p>
  2483. </dd>
  2484. <dt><samp>gt(x, y)</samp></dt>
  2485. <dd><p>Return 1 if <var>x</var> is greater than <var>y</var>, 0 otherwise.
  2486. </p>
  2487. </dd>
  2488. <dt><samp>gte(x, y)</samp></dt>
  2489. <dd><p>Return 1 if <var>x</var> is greater than or equal to <var>y</var>, 0 otherwise.
  2490. </p>
  2491. </dd>
  2492. <dt><samp>hypot(x, y)</samp></dt>
  2493. <dd><p>This function is similar to the C function with the same name; it returns
  2494. &quot;sqrt(<var>x</var>*<var>x</var> + <var>y</var>*<var>y</var>)&quot;, the length of the hypotenuse of a
  2495. right triangle with sides of length <var>x</var> and <var>y</var>, or the distance of the
  2496. point (<var>x</var>, <var>y</var>) from the origin.
  2497. </p>
  2498. </dd>
  2499. <dt><samp>if(x, y)</samp></dt>
  2500. <dd><p>Evaluate <var>x</var>, and if the result is non-zero return the result of
  2501. the evaluation of <var>y</var>, return 0 otherwise.
  2502. </p>
  2503. </dd>
  2504. <dt><samp>if(x, y, z)</samp></dt>
  2505. <dd><p>Evaluate <var>x</var>, and if the result is non-zero return the evaluation
  2506. result of <var>y</var>, otherwise the evaluation result of <var>z</var>.
  2507. </p>
  2508. </dd>
  2509. <dt><samp>ifnot(x, y)</samp></dt>
  2510. <dd><p>Evaluate <var>x</var>, and if the result is zero return the result of the
  2511. evaluation of <var>y</var>, return 0 otherwise.
  2512. </p>
  2513. </dd>
  2514. <dt><samp>ifnot(x, y, z)</samp></dt>
  2515. <dd><p>Evaluate <var>x</var>, and if the result is zero return the evaluation
  2516. result of <var>y</var>, otherwise the evaluation result of <var>z</var>.
  2517. </p>
  2518. </dd>
  2519. <dt><samp>isinf(x)</samp></dt>
  2520. <dd><p>Return 1.0 if <var>x</var> is +/-INFINITY, 0.0 otherwise.
  2521. </p>
  2522. </dd>
  2523. <dt><samp>isnan(x)</samp></dt>
  2524. <dd><p>Return 1.0 if <var>x</var> is NAN, 0.0 otherwise.
  2525. </p>
  2526. </dd>
  2527. <dt><samp>ld(var)</samp></dt>
  2528. <dd><p>Load the value of the internal variable with number
  2529. <var>var</var>, which was previously stored with st(<var>var</var>, <var>expr</var>).
  2530. The function returns the loaded value.
  2531. </p>
  2532. </dd>
  2533. <dt><samp>log(x)</samp></dt>
  2534. <dd><p>Compute natural logarithm of <var>x</var>.
  2535. </p>
  2536. </dd>
  2537. <dt><samp>lt(x, y)</samp></dt>
  2538. <dd><p>Return 1 if <var>x</var> is lesser than <var>y</var>, 0 otherwise.
  2539. </p>
  2540. </dd>
  2541. <dt><samp>lte(x, y)</samp></dt>
  2542. <dd><p>Return 1 if <var>x</var> is lesser than or equal to <var>y</var>, 0 otherwise.
  2543. </p>
  2544. </dd>
  2545. <dt><samp>max(x, y)</samp></dt>
  2546. <dd><p>Return the maximum between <var>x</var> and <var>y</var>.
  2547. </p>
  2548. </dd>
  2549. <dt><samp>min(x, y)</samp></dt>
  2550. <dd><p>Return the maximum between <var>x</var> and <var>y</var>.
  2551. </p>
  2552. </dd>
  2553. <dt><samp>mod(x, y)</samp></dt>
  2554. <dd><p>Compute the remainder of division of <var>x</var> by <var>y</var>.
  2555. </p>
  2556. </dd>
  2557. <dt><samp>not(expr)</samp></dt>
  2558. <dd><p>Return 1.0 if <var>expr</var> is zero, 0.0 otherwise.
  2559. </p>
  2560. </dd>
  2561. <dt><samp>pow(x, y)</samp></dt>
  2562. <dd><p>Compute the power of <var>x</var> elevated <var>y</var>, it is equivalent to
  2563. &quot;(<var>x</var>)^(<var>y</var>)&quot;.
  2564. </p>
  2565. </dd>
  2566. <dt><samp>print(t)</samp></dt>
  2567. <dt><samp>print(t, l)</samp></dt>
  2568. <dd><p>Print the value of expression <var>t</var> with loglevel <var>l</var>. If
  2569. <var>l</var> is not specified then a default log level is used.
  2570. Returns the value of the expression printed.
  2571. </p>
  2572. <p>Prints t with loglevel l
  2573. </p>
  2574. </dd>
  2575. <dt><samp>random(x)</samp></dt>
  2576. <dd><p>Return a pseudo random value between 0.0 and 1.0. <var>x</var> is the index of the
  2577. internal variable which will be used to save the seed/state.
  2578. </p>
  2579. </dd>
  2580. <dt><samp>root(expr, max)</samp></dt>
  2581. <dd><p>Find an input value for which the function represented by <var>expr</var>
  2582. with argument <var>ld(0)</var> is 0 in the interval 0..<var>max</var>.
  2583. </p>
  2584. <p>The expression in <var>expr</var> must denote a continuous function or the
  2585. result is undefined.
  2586. </p>
  2587. <p><var>ld(0)</var> is used to represent the function input value, which means
  2588. that the given expression will be evaluated multiple times with
  2589. various input values that the expression can access through
  2590. <code>ld(0)</code>. When the expression evaluates to 0 then the
  2591. corresponding input value will be returned.
  2592. </p>
  2593. </dd>
  2594. <dt><samp>sin(x)</samp></dt>
  2595. <dd><p>Compute sine of <var>x</var>.
  2596. </p>
  2597. </dd>
  2598. <dt><samp>sinh(x)</samp></dt>
  2599. <dd><p>Compute hyperbolic sine of <var>x</var>.
  2600. </p>
  2601. </dd>
  2602. <dt><samp>sqrt(expr)</samp></dt>
  2603. <dd><p>Compute the square root of <var>expr</var>. This is equivalent to
  2604. &quot;(<var>expr</var>)^.5&quot;.
  2605. </p>
  2606. </dd>
  2607. <dt><samp>squish(x)</samp></dt>
  2608. <dd><p>Compute expression <code>1/(1 + exp(4*x))</code>.
  2609. </p>
  2610. </dd>
  2611. <dt><samp>st(var, expr)</samp></dt>
  2612. <dd><p>Store the value of the expression <var>expr</var> in an internal
  2613. variable. <var>var</var> specifies the number of the variable where to
  2614. store the value, and it is a value ranging from 0 to 9. The function
  2615. returns the value stored in the internal variable.
  2616. Note, Variables are currently not shared between expressions.
  2617. </p>
  2618. </dd>
  2619. <dt><samp>tan(x)</samp></dt>
  2620. <dd><p>Compute tangent of <var>x</var>.
  2621. </p>
  2622. </dd>
  2623. <dt><samp>tanh(x)</samp></dt>
  2624. <dd><p>Compute hyperbolic tangent of <var>x</var>.
  2625. </p>
  2626. </dd>
  2627. <dt><samp>taylor(expr, x)</samp></dt>
  2628. <dt><samp>taylor(expr, x, id)</samp></dt>
  2629. <dd><p>Evaluate a Taylor series at <var>x</var>, given an expression representing
  2630. the <code>ld(id)</code>-th derivative of a function at 0.
  2631. </p>
  2632. <p>When the series does not converge the result is undefined.
  2633. </p>
  2634. <p><var>ld(id)</var> is used to represent the derivative order in <var>expr</var>,
  2635. which means that the given expression will be evaluated multiple times
  2636. with various input values that the expression can access through
  2637. <code>ld(id)</code>. If <var>id</var> is not specified then 0 is assumed.
  2638. </p>
  2639. <p>Note, when you have the derivatives at y instead of 0,
  2640. <code>taylor(expr, x-y)</code> can be used.
  2641. </p>
  2642. </dd>
  2643. <dt><samp>time(0)</samp></dt>
  2644. <dd><p>Return the current (wallclock) time in seconds.
  2645. </p>
  2646. </dd>
  2647. <dt><samp>trunc(expr)</samp></dt>
  2648. <dd><p>Round the value of expression <var>expr</var> towards zero to the nearest
  2649. integer. For example, &quot;trunc(-1.5)&quot; is &quot;-1.0&quot;.
  2650. </p>
  2651. </dd>
  2652. <dt><samp>while(cond, expr)</samp></dt>
  2653. <dd><p>Evaluate expression <var>expr</var> while the expression <var>cond</var> is
  2654. non-zero, and returns the value of the last <var>expr</var> evaluation, or
  2655. NAN if <var>cond</var> was always false.
  2656. </p></dd>
  2657. </dl>
  2658. <p>The following constants are available:
  2659. </p><dl compact="compact">
  2660. <dt><samp>PI</samp></dt>
  2661. <dd><p>area of the unit disc, approximately 3.14
  2662. </p></dd>
  2663. <dt><samp>E</samp></dt>
  2664. <dd><p>exp(1) (Euler&rsquo;s number), approximately 2.718
  2665. </p></dd>
  2666. <dt><samp>PHI</samp></dt>
  2667. <dd><p>golden ratio (1+sqrt(5))/2, approximately 1.618
  2668. </p></dd>
  2669. </dl>
  2670. <p>Assuming that an expression is considered &quot;true&quot; if it has a non-zero
  2671. value, note that:
  2672. </p>
  2673. <p><code>*</code> works like AND
  2674. </p>
  2675. <p><code>+</code> works like OR
  2676. </p>
  2677. <p>For example the construct:
  2678. </p><div class="example">
  2679. <pre class="example">if (A AND B) then C
  2680. </pre></div>
  2681. <p>is equivalent to:
  2682. </p><div class="example">
  2683. <pre class="example">if(A*B, C)
  2684. </pre></div>
  2685. <p>In your C code, you can extend the list of unary and binary functions,
  2686. and define recognized constants, so that they are available for your
  2687. expressions.
  2688. </p>
  2689. <p>The evaluator also recognizes the International System unit prefixes.
  2690. If &rsquo;i&rsquo; is appended after the prefix, binary prefixes are used, which
  2691. are based on powers of 1024 instead of powers of 1000.
  2692. The &rsquo;B&rsquo; postfix multiplies the value by 8, and can be appended after a
  2693. unit prefix or used alone. This allows using for example &rsquo;KB&rsquo;, &rsquo;MiB&rsquo;,
  2694. &rsquo;G&rsquo; and &rsquo;B&rsquo; as number postfix.
  2695. </p>
  2696. <p>The list of available International System prefixes follows, with
  2697. indication of the corresponding powers of 10 and of 2.
  2698. </p><dl compact="compact">
  2699. <dt><samp>y</samp></dt>
  2700. <dd><p>10^-24 / 2^-80
  2701. </p></dd>
  2702. <dt><samp>z</samp></dt>
  2703. <dd><p>10^-21 / 2^-70
  2704. </p></dd>
  2705. <dt><samp>a</samp></dt>
  2706. <dd><p>10^-18 / 2^-60
  2707. </p></dd>
  2708. <dt><samp>f</samp></dt>
  2709. <dd><p>10^-15 / 2^-50
  2710. </p></dd>
  2711. <dt><samp>p</samp></dt>
  2712. <dd><p>10^-12 / 2^-40
  2713. </p></dd>
  2714. <dt><samp>n</samp></dt>
  2715. <dd><p>10^-9 / 2^-30
  2716. </p></dd>
  2717. <dt><samp>u</samp></dt>
  2718. <dd><p>10^-6 / 2^-20
  2719. </p></dd>
  2720. <dt><samp>m</samp></dt>
  2721. <dd><p>10^-3 / 2^-10
  2722. </p></dd>
  2723. <dt><samp>c</samp></dt>
  2724. <dd><p>10^-2
  2725. </p></dd>
  2726. <dt><samp>d</samp></dt>
  2727. <dd><p>10^-1
  2728. </p></dd>
  2729. <dt><samp>h</samp></dt>
  2730. <dd><p>10^2
  2731. </p></dd>
  2732. <dt><samp>k</samp></dt>
  2733. <dd><p>10^3 / 2^10
  2734. </p></dd>
  2735. <dt><samp>K</samp></dt>
  2736. <dd><p>10^3 / 2^10
  2737. </p></dd>
  2738. <dt><samp>M</samp></dt>
  2739. <dd><p>10^6 / 2^20
  2740. </p></dd>
  2741. <dt><samp>G</samp></dt>
  2742. <dd><p>10^9 / 2^30
  2743. </p></dd>
  2744. <dt><samp>T</samp></dt>
  2745. <dd><p>10^12 / 2^40
  2746. </p></dd>
  2747. <dt><samp>P</samp></dt>
  2748. <dd><p>10^15 / 2^40
  2749. </p></dd>
  2750. <dt><samp>E</samp></dt>
  2751. <dd><p>10^18 / 2^50
  2752. </p></dd>
  2753. <dt><samp>Z</samp></dt>
  2754. <dd><p>10^21 / 2^60
  2755. </p></dd>
  2756. <dt><samp>Y</samp></dt>
  2757. <dd><p>10^24 / 2^70
  2758. </p></dd>
  2759. </dl>
  2760. <a name="OpenCL-Options"></a>
  2761. <h2 class="chapter">6 OpenCL Options<span class="pull-right"><a class="anchor hidden-xs" href="#OpenCL-Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-OpenCL-Options" aria-hidden="true">TOC</a></span></h2>
  2762. <p>When FFmpeg is configured with <code>--enable-opencl</code>, it is possible
  2763. to set the options for the global OpenCL context.
  2764. </p>
  2765. <p>The list of supported options follows:
  2766. </p>
  2767. <dl compact="compact">
  2768. <dt><samp>build_options</samp></dt>
  2769. <dd><p>Set build options used to compile the registered kernels.
  2770. </p>
  2771. <p>See reference &quot;OpenCL Specification Version: 1.2 chapter 5.6.4&quot;.
  2772. </p>
  2773. </dd>
  2774. <dt><samp>platform_idx</samp></dt>
  2775. <dd><p>Select the index of the platform to run OpenCL code.
  2776. </p>
  2777. <p>The specified index must be one of the indexes in the device list
  2778. which can be obtained with <code>ffmpeg -opencl_bench</code> or <code>av_opencl_get_device_list()</code>.
  2779. </p>
  2780. </dd>
  2781. <dt><samp>device_idx</samp></dt>
  2782. <dd><p>Select the index of the device used to run OpenCL code.
  2783. </p>
  2784. <p>The specified index must be one of the indexes in the device list which
  2785. can be obtained with <code>ffmpeg -opencl_bench</code> or <code>av_opencl_get_device_list()</code>.
  2786. </p>
  2787. </dd>
  2788. </dl>
  2789. <a name="codec_002doptions"></a><a name="Codec-Options"></a>
  2790. <h2 class="chapter">7 Codec Options<span class="pull-right"><a class="anchor hidden-xs" href="#Codec-Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Codec-Options" aria-hidden="true">TOC</a></span></h2>
  2791. <p>libavcodec provides some generic global options, which can be set on
  2792. all the encoders and decoders. In addition each codec may support
  2793. so-called private options, which are specific for a given codec.
  2794. </p>
  2795. <p>Sometimes, a global option may only affect a specific kind of codec,
  2796. and may be nonsensical or ignored by another, so you need to be aware
  2797. of the meaning of the specified options. Also some options are
  2798. meant only for decoding or encoding.
  2799. </p>
  2800. <p>Options may be set by specifying -<var>option</var> <var>value</var> in the
  2801. FFmpeg tools, or by setting the value explicitly in the
  2802. <code>AVCodecContext</code> options or using the <samp>libavutil/opt.h</samp> API
  2803. for programmatic use.
  2804. </p>
  2805. <p>The list of supported options follow:
  2806. </p>
  2807. <dl compact="compact">
  2808. <dt><samp>b <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  2809. <dd><p>Set bitrate in bits/s. Default value is 200K.
  2810. </p>
  2811. </dd>
  2812. <dt><samp>ab <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  2813. <dd><p>Set audio bitrate (in bits/s). Default value is 128K.
  2814. </p>
  2815. </dd>
  2816. <dt><samp>bt <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  2817. <dd><p>Set video bitrate tolerance (in bits/s). In 1-pass mode, bitrate
  2818. tolerance specifies how far ratecontrol is willing to deviate from the
  2819. target average bitrate value. This is not related to min/max
  2820. bitrate. Lowering tolerance too much has an adverse effect on quality.
  2821. </p>
  2822. </dd>
  2823. <dt><samp>flags <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp></dt>
  2824. <dd><p>Set generic flags.
  2825. </p>
  2826. <p>Possible values:
  2827. </p><dl compact="compact">
  2828. <dt>&lsquo;<samp>mv4</samp>&rsquo;</dt>
  2829. <dd><p>Use four motion vector by macroblock (mpeg4).
  2830. </p></dd>
  2831. <dt>&lsquo;<samp>qpel</samp>&rsquo;</dt>
  2832. <dd><p>Use 1/4 pel motion compensation.
  2833. </p></dd>
  2834. <dt>&lsquo;<samp>loop</samp>&rsquo;</dt>
  2835. <dd><p>Use loop filter.
  2836. </p></dd>
  2837. <dt>&lsquo;<samp>qscale</samp>&rsquo;</dt>
  2838. <dd><p>Use fixed qscale.
  2839. </p></dd>
  2840. <dt>&lsquo;<samp>gmc</samp>&rsquo;</dt>
  2841. <dd><p>Use gmc.
  2842. </p></dd>
  2843. <dt>&lsquo;<samp>mv0</samp>&rsquo;</dt>
  2844. <dd><p>Always try a mb with mv=&lt;0,0&gt;.
  2845. </p></dd>
  2846. <dt>&lsquo;<samp>input_preserved</samp>&rsquo;</dt>
  2847. <dt>&lsquo;<samp>pass1</samp>&rsquo;</dt>
  2848. <dd><p>Use internal 2pass ratecontrol in first pass mode.
  2849. </p></dd>
  2850. <dt>&lsquo;<samp>pass2</samp>&rsquo;</dt>
  2851. <dd><p>Use internal 2pass ratecontrol in second pass mode.
  2852. </p></dd>
  2853. <dt>&lsquo;<samp>gray</samp>&rsquo;</dt>
  2854. <dd><p>Only decode/encode grayscale.
  2855. </p></dd>
  2856. <dt>&lsquo;<samp>emu_edge</samp>&rsquo;</dt>
  2857. <dd><p>Do not draw edges.
  2858. </p></dd>
  2859. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  2860. <dd><p>Set error[?] variables during encoding.
  2861. </p></dd>
  2862. <dt>&lsquo;<samp>truncated</samp>&rsquo;</dt>
  2863. <dt>&lsquo;<samp>naq</samp>&rsquo;</dt>
  2864. <dd><p>Normalize adaptive quantization.
  2865. </p></dd>
  2866. <dt>&lsquo;<samp>ildct</samp>&rsquo;</dt>
  2867. <dd><p>Use interlaced DCT.
  2868. </p></dd>
  2869. <dt>&lsquo;<samp>low_delay</samp>&rsquo;</dt>
  2870. <dd><p>Force low delay.
  2871. </p></dd>
  2872. <dt>&lsquo;<samp>global_header</samp>&rsquo;</dt>
  2873. <dd><p>Place global headers in extradata instead of every keyframe.
  2874. </p></dd>
  2875. <dt>&lsquo;<samp>bitexact</samp>&rsquo;</dt>
  2876. <dd><p>Only write platform-, build- and time-independent data. (except (I)DCT).
  2877. This ensures that file and data checksums are reproducible and match between
  2878. platforms. Its primary use is for regression testing.
  2879. </p></dd>
  2880. <dt>&lsquo;<samp>aic</samp>&rsquo;</dt>
  2881. <dd><p>Apply H263 advanced intra coding / mpeg4 ac prediction.
  2882. </p></dd>
  2883. <dt>&lsquo;<samp>cbp</samp>&rsquo;</dt>
  2884. <dd><p>Deprecated, use mpegvideo private options instead.
  2885. </p></dd>
  2886. <dt>&lsquo;<samp>qprd</samp>&rsquo;</dt>
  2887. <dd><p>Deprecated, use mpegvideo private options instead.
  2888. </p></dd>
  2889. <dt>&lsquo;<samp>ilme</samp>&rsquo;</dt>
  2890. <dd><p>Apply interlaced motion estimation.
  2891. </p></dd>
  2892. <dt>&lsquo;<samp>cgop</samp>&rsquo;</dt>
  2893. <dd><p>Use closed gop.
  2894. </p></dd>
  2895. </dl>
  2896. </dd>
  2897. <dt><samp>me_method <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  2898. <dd><p>Set motion estimation method.
  2899. </p>
  2900. <p>Possible values:
  2901. </p><dl compact="compact">
  2902. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  2903. <dd><p>zero motion estimation (fastest)
  2904. </p></dd>
  2905. <dt>&lsquo;<samp>full</samp>&rsquo;</dt>
  2906. <dd><p>full motion estimation (slowest)
  2907. </p></dd>
  2908. <dt>&lsquo;<samp>epzs</samp>&rsquo;</dt>
  2909. <dd><p>EPZS motion estimation (default)
  2910. </p></dd>
  2911. <dt>&lsquo;<samp>esa</samp>&rsquo;</dt>
  2912. <dd><p>esa motion estimation (alias for full)
  2913. </p></dd>
  2914. <dt>&lsquo;<samp>tesa</samp>&rsquo;</dt>
  2915. <dd><p>tesa motion estimation
  2916. </p></dd>
  2917. <dt>&lsquo;<samp>dia</samp>&rsquo;</dt>
  2918. <dd><p>dia motion estimation (alias for epzs)
  2919. </p></dd>
  2920. <dt>&lsquo;<samp>log</samp>&rsquo;</dt>
  2921. <dd><p>log motion estimation
  2922. </p></dd>
  2923. <dt>&lsquo;<samp>phods</samp>&rsquo;</dt>
  2924. <dd><p>phods motion estimation
  2925. </p></dd>
  2926. <dt>&lsquo;<samp>x1</samp>&rsquo;</dt>
  2927. <dd><p>X1 motion estimation
  2928. </p></dd>
  2929. <dt>&lsquo;<samp>hex</samp>&rsquo;</dt>
  2930. <dd><p>hex motion estimation
  2931. </p></dd>
  2932. <dt>&lsquo;<samp>umh</samp>&rsquo;</dt>
  2933. <dd><p>umh motion estimation
  2934. </p></dd>
  2935. <dt>&lsquo;<samp>iter</samp>&rsquo;</dt>
  2936. <dd><p>iter motion estimation
  2937. </p></dd>
  2938. </dl>
  2939. </dd>
  2940. <dt><samp>extradata_size <var>integer</var></samp></dt>
  2941. <dd><p>Set extradata size.
  2942. </p>
  2943. </dd>
  2944. <dt><samp>time_base <var>rational number</var></samp></dt>
  2945. <dd><p>Set codec time base.
  2946. </p>
  2947. <p>It is the fundamental unit of time (in seconds) in terms of which
  2948. frame timestamps are represented. For fixed-fps content, timebase
  2949. should be <code>1 / frame_rate</code> and timestamp increments should be
  2950. identically 1.
  2951. </p>
  2952. </dd>
  2953. <dt><samp>g <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  2954. <dd><p>Set the group of picture size. Default value is 12.
  2955. </p>
  2956. </dd>
  2957. <dt><samp>ar <var>integer</var> (<em>decoding/encoding,audio</em>)</samp></dt>
  2958. <dd><p>Set audio sampling rate (in Hz).
  2959. </p>
  2960. </dd>
  2961. <dt><samp>ac <var>integer</var> (<em>decoding/encoding,audio</em>)</samp></dt>
  2962. <dd><p>Set number of audio channels.
  2963. </p>
  2964. </dd>
  2965. <dt><samp>cutoff <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  2966. <dd><p>Set cutoff bandwidth.
  2967. </p>
  2968. </dd>
  2969. <dt><samp>frame_size <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  2970. <dd><p>Set audio frame size.
  2971. </p>
  2972. <p>Each submitted frame except the last must contain exactly frame_size
  2973. samples per channel. May be 0 when the codec has
  2974. CODEC_CAP_VARIABLE_FRAME_SIZE set, in that case the frame size is not
  2975. restricted. It is set by some decoders to indicate constant frame
  2976. size.
  2977. </p>
  2978. </dd>
  2979. <dt><samp>frame_number <var>integer</var></samp></dt>
  2980. <dd><p>Set the frame number.
  2981. </p>
  2982. </dd>
  2983. <dt><samp>delay <var>integer</var></samp></dt>
  2984. <dt><samp>qcomp <var>float</var> (<em>encoding,video</em>)</samp></dt>
  2985. <dd><p>Set video quantizer scale compression (VBR). It is used as a constant
  2986. in the ratecontrol equation. Recommended range for default rc_eq:
  2987. 0.0-1.0.
  2988. </p>
  2989. </dd>
  2990. <dt><samp>qblur <var>float</var> (<em>encoding,video</em>)</samp></dt>
  2991. <dd><p>Set video quantizer scale blur (VBR).
  2992. </p>
  2993. </dd>
  2994. <dt><samp>qmin <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  2995. <dd><p>Set min video quantizer scale (VBR). Must be included between -1 and
  2996. 69, default value is 2.
  2997. </p>
  2998. </dd>
  2999. <dt><samp>qmax <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3000. <dd><p>Set max video quantizer scale (VBR). Must be included between -1 and
  3001. 1024, default value is 31.
  3002. </p>
  3003. </dd>
  3004. <dt><samp>qdiff <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3005. <dd><p>Set max difference between the quantizer scale (VBR).
  3006. </p>
  3007. </dd>
  3008. <dt><samp>bf <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3009. <dd><p>Set max number of B frames between non-B-frames.
  3010. </p>
  3011. <p>Must be an integer between -1 and 16. 0 means that B-frames are
  3012. disabled. If a value of -1 is used, it will choose an automatic value
  3013. depending on the encoder.
  3014. </p>
  3015. <p>Default value is 0.
  3016. </p>
  3017. </dd>
  3018. <dt><samp>b_qfactor <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3019. <dd><p>Set qp factor between P and B frames.
  3020. </p>
  3021. </dd>
  3022. <dt><samp>rc_strategy <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3023. <dd><p>Set ratecontrol method.
  3024. </p>
  3025. </dd>
  3026. <dt><samp>b_strategy <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3027. <dd><p>Set strategy to choose between I/P/B-frames.
  3028. </p>
  3029. </dd>
  3030. <dt><samp>ps <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3031. <dd><p>Set RTP payload size in bytes.
  3032. </p>
  3033. </dd>
  3034. <dt><samp>mv_bits <var>integer</var></samp></dt>
  3035. <dt><samp>header_bits <var>integer</var></samp></dt>
  3036. <dt><samp>i_tex_bits <var>integer</var></samp></dt>
  3037. <dt><samp>p_tex_bits <var>integer</var></samp></dt>
  3038. <dt><samp>i_count <var>integer</var></samp></dt>
  3039. <dt><samp>p_count <var>integer</var></samp></dt>
  3040. <dt><samp>skip_count <var>integer</var></samp></dt>
  3041. <dt><samp>misc_bits <var>integer</var></samp></dt>
  3042. <dt><samp>frame_bits <var>integer</var></samp></dt>
  3043. <dt><samp>codec_tag <var>integer</var></samp></dt>
  3044. <dt><samp>bug <var>flags</var> (<em>decoding,video</em>)</samp></dt>
  3045. <dd><p>Workaround not auto detected encoder bugs.
  3046. </p>
  3047. <p>Possible values:
  3048. </p><dl compact="compact">
  3049. <dt>&lsquo;<samp>autodetect</samp>&rsquo;</dt>
  3050. <dt>&lsquo;<samp>old_msmpeg4</samp>&rsquo;</dt>
  3051. <dd><p>some old lavc generated msmpeg4v3 files (no autodetection)
  3052. </p></dd>
  3053. <dt>&lsquo;<samp>xvid_ilace</samp>&rsquo;</dt>
  3054. <dd><p>Xvid interlacing bug (autodetected if fourcc==XVIX)
  3055. </p></dd>
  3056. <dt>&lsquo;<samp>ump4</samp>&rsquo;</dt>
  3057. <dd><p>(autodetected if fourcc==UMP4)
  3058. </p></dd>
  3059. <dt>&lsquo;<samp>no_padding</samp>&rsquo;</dt>
  3060. <dd><p>padding bug (autodetected)
  3061. </p></dd>
  3062. <dt>&lsquo;<samp>amv</samp>&rsquo;</dt>
  3063. <dt>&lsquo;<samp>ac_vlc</samp>&rsquo;</dt>
  3064. <dd><p>illegal vlc bug (autodetected per fourcc)
  3065. </p></dd>
  3066. <dt>&lsquo;<samp>qpel_chroma</samp>&rsquo;</dt>
  3067. <dt>&lsquo;<samp>std_qpel</samp>&rsquo;</dt>
  3068. <dd><p>old standard qpel (autodetected per fourcc/version)
  3069. </p></dd>
  3070. <dt>&lsquo;<samp>qpel_chroma2</samp>&rsquo;</dt>
  3071. <dt>&lsquo;<samp>direct_blocksize</samp>&rsquo;</dt>
  3072. <dd><p>direct-qpel-blocksize bug (autodetected per fourcc/version)
  3073. </p></dd>
  3074. <dt>&lsquo;<samp>edge</samp>&rsquo;</dt>
  3075. <dd><p>edge padding bug (autodetected per fourcc/version)
  3076. </p></dd>
  3077. <dt>&lsquo;<samp>hpel_chroma</samp>&rsquo;</dt>
  3078. <dt>&lsquo;<samp>dc_clip</samp>&rsquo;</dt>
  3079. <dt>&lsquo;<samp>ms</samp>&rsquo;</dt>
  3080. <dd><p>Workaround various bugs in microsoft broken decoders.
  3081. </p></dd>
  3082. <dt>&lsquo;<samp>trunc</samp>&rsquo;</dt>
  3083. <dd><p>trancated frames
  3084. </p></dd>
  3085. </dl>
  3086. </dd>
  3087. <dt><samp>lelim <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3088. <dd><p>Set single coefficient elimination threshold for luminance (negative
  3089. values also consider DC coefficient).
  3090. </p>
  3091. </dd>
  3092. <dt><samp>celim <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3093. <dd><p>Set single coefficient elimination threshold for chrominance (negative
  3094. values also consider dc coefficient)
  3095. </p>
  3096. </dd>
  3097. <dt><samp>strict <var>integer</var> (<em>decoding/encoding,audio,video</em>)</samp></dt>
  3098. <dd><p>Specify how strictly to follow the standards.
  3099. </p>
  3100. <p>Possible values:
  3101. </p><dl compact="compact">
  3102. <dt>&lsquo;<samp>very</samp>&rsquo;</dt>
  3103. <dd><p>strictly conform to a older more strict version of the spec or reference software
  3104. </p></dd>
  3105. <dt>&lsquo;<samp>strict</samp>&rsquo;</dt>
  3106. <dd><p>strictly conform to all the things in the spec no matter what consequences
  3107. </p></dd>
  3108. <dt>&lsquo;<samp>normal</samp>&rsquo;</dt>
  3109. <dt>&lsquo;<samp>unofficial</samp>&rsquo;</dt>
  3110. <dd><p>allow unofficial extensions
  3111. </p></dd>
  3112. <dt>&lsquo;<samp>experimental</samp>&rsquo;</dt>
  3113. <dd><p>allow non standardized experimental things, experimental
  3114. (unfinished/work in progress/not well tested) decoders and encoders.
  3115. Note: experimental decoders can pose a security risk, do not use this for
  3116. decoding untrusted input.
  3117. </p></dd>
  3118. </dl>
  3119. </dd>
  3120. <dt><samp>b_qoffset <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3121. <dd><p>Set QP offset between P and B frames.
  3122. </p>
  3123. </dd>
  3124. <dt><samp>err_detect <var>flags</var> (<em>decoding,audio,video</em>)</samp></dt>
  3125. <dd><p>Set error detection flags.
  3126. </p>
  3127. <p>Possible values:
  3128. </p><dl compact="compact">
  3129. <dt>&lsquo;<samp>crccheck</samp>&rsquo;</dt>
  3130. <dd><p>verify embedded CRCs
  3131. </p></dd>
  3132. <dt>&lsquo;<samp>bitstream</samp>&rsquo;</dt>
  3133. <dd><p>detect bitstream specification deviations
  3134. </p></dd>
  3135. <dt>&lsquo;<samp>buffer</samp>&rsquo;</dt>
  3136. <dd><p>detect improper bitstream length
  3137. </p></dd>
  3138. <dt>&lsquo;<samp>explode</samp>&rsquo;</dt>
  3139. <dd><p>abort decoding on minor error detection
  3140. </p></dd>
  3141. <dt>&lsquo;<samp>ignore_err</samp>&rsquo;</dt>
  3142. <dd><p>ignore decoding errors, and continue decoding.
  3143. This is useful if you want to analyze the content of a video and thus want
  3144. everything to be decoded no matter what. This option will not result in a video
  3145. that is pleasing to watch in case of errors.
  3146. </p></dd>
  3147. <dt>&lsquo;<samp>careful</samp>&rsquo;</dt>
  3148. <dd><p>consider things that violate the spec and have not been seen in the wild as errors
  3149. </p></dd>
  3150. <dt>&lsquo;<samp>compliant</samp>&rsquo;</dt>
  3151. <dd><p>consider all spec non compliancies as errors
  3152. </p></dd>
  3153. <dt>&lsquo;<samp>aggressive</samp>&rsquo;</dt>
  3154. <dd><p>consider things that a sane encoder should not do as an error
  3155. </p></dd>
  3156. </dl>
  3157. </dd>
  3158. <dt><samp>has_b_frames <var>integer</var></samp></dt>
  3159. <dt><samp>block_align <var>integer</var></samp></dt>
  3160. <dt><samp>mpeg_quant <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3161. <dd><p>Use MPEG quantizers instead of H.263.
  3162. </p>
  3163. </dd>
  3164. <dt><samp>qsquish <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3165. <dd><p>How to keep quantizer between qmin and qmax (0 = clip, 1 = use
  3166. differentiable function).
  3167. </p>
  3168. </dd>
  3169. <dt><samp>rc_qmod_amp <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3170. <dd><p>Set experimental quantizer modulation.
  3171. </p>
  3172. </dd>
  3173. <dt><samp>rc_qmod_freq <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3174. <dd><p>Set experimental quantizer modulation.
  3175. </p>
  3176. </dd>
  3177. <dt><samp>rc_override_count <var>integer</var></samp></dt>
  3178. <dt><samp>rc_eq <var>string</var> (<em>encoding,video</em>)</samp></dt>
  3179. <dd><p>Set rate control equation. When computing the expression, besides the
  3180. standard functions defined in the section &rsquo;Expression Evaluation&rsquo;, the
  3181. following functions are available: bits2qp(bits), qp2bits(qp). Also
  3182. the following constants are available: iTex pTex tex mv fCode iCount
  3183. mcVar var isI isP isB avgQP qComp avgIITex avgPITex avgPPTex avgBPTex
  3184. avgTex.
  3185. </p>
  3186. </dd>
  3187. <dt><samp>maxrate <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3188. <dd><p>Set max bitrate tolerance (in bits/s). Requires bufsize to be set.
  3189. </p>
  3190. </dd>
  3191. <dt><samp>minrate <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3192. <dd><p>Set min bitrate tolerance (in bits/s). Most useful in setting up a CBR
  3193. encode. It is of little use elsewise.
  3194. </p>
  3195. </dd>
  3196. <dt><samp>bufsize <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3197. <dd><p>Set ratecontrol buffer size (in bits).
  3198. </p>
  3199. </dd>
  3200. <dt><samp>rc_buf_aggressivity <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3201. <dd><p>Currently useless.
  3202. </p>
  3203. </dd>
  3204. <dt><samp>i_qfactor <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3205. <dd><p>Set QP factor between P and I frames.
  3206. </p>
  3207. </dd>
  3208. <dt><samp>i_qoffset <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3209. <dd><p>Set QP offset between P and I frames.
  3210. </p>
  3211. </dd>
  3212. <dt><samp>rc_init_cplx <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3213. <dd><p>Set initial complexity for 1-pass encoding.
  3214. </p>
  3215. </dd>
  3216. <dt><samp>dct <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3217. <dd><p>Set DCT algorithm.
  3218. </p>
  3219. <p>Possible values:
  3220. </p><dl compact="compact">
  3221. <dt>&lsquo;<samp>auto</samp>&rsquo;</dt>
  3222. <dd><p>autoselect a good one (default)
  3223. </p></dd>
  3224. <dt>&lsquo;<samp>fastint</samp>&rsquo;</dt>
  3225. <dd><p>fast integer
  3226. </p></dd>
  3227. <dt>&lsquo;<samp>int</samp>&rsquo;</dt>
  3228. <dd><p>accurate integer
  3229. </p></dd>
  3230. <dt>&lsquo;<samp>mmx</samp>&rsquo;</dt>
  3231. <dt>&lsquo;<samp>altivec</samp>&rsquo;</dt>
  3232. <dt>&lsquo;<samp>faan</samp>&rsquo;</dt>
  3233. <dd><p>floating point AAN DCT
  3234. </p></dd>
  3235. </dl>
  3236. </dd>
  3237. <dt><samp>lumi_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3238. <dd><p>Compress bright areas stronger than medium ones.
  3239. </p>
  3240. </dd>
  3241. <dt><samp>tcplx_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3242. <dd><p>Set temporal complexity masking.
  3243. </p>
  3244. </dd>
  3245. <dt><samp>scplx_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3246. <dd><p>Set spatial complexity masking.
  3247. </p>
  3248. </dd>
  3249. <dt><samp>p_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3250. <dd><p>Set inter masking.
  3251. </p>
  3252. </dd>
  3253. <dt><samp>dark_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3254. <dd><p>Compress dark areas stronger than medium ones.
  3255. </p>
  3256. </dd>
  3257. <dt><samp>idct <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  3258. <dd><p>Select IDCT implementation.
  3259. </p>
  3260. <p>Possible values:
  3261. </p><dl compact="compact">
  3262. <dt>&lsquo;<samp>auto</samp>&rsquo;</dt>
  3263. <dt>&lsquo;<samp>int</samp>&rsquo;</dt>
  3264. <dt>&lsquo;<samp>simple</samp>&rsquo;</dt>
  3265. <dt>&lsquo;<samp>simplemmx</samp>&rsquo;</dt>
  3266. <dt>&lsquo;<samp>simpleauto</samp>&rsquo;</dt>
  3267. <dd><p>Automatically pick a IDCT compatible with the simple one
  3268. </p>
  3269. </dd>
  3270. <dt>&lsquo;<samp>arm</samp>&rsquo;</dt>
  3271. <dt>&lsquo;<samp>altivec</samp>&rsquo;</dt>
  3272. <dt>&lsquo;<samp>sh4</samp>&rsquo;</dt>
  3273. <dt>&lsquo;<samp>simplearm</samp>&rsquo;</dt>
  3274. <dt>&lsquo;<samp>simplearmv5te</samp>&rsquo;</dt>
  3275. <dt>&lsquo;<samp>simplearmv6</samp>&rsquo;</dt>
  3276. <dt>&lsquo;<samp>simpleneon</samp>&rsquo;</dt>
  3277. <dt>&lsquo;<samp>simplealpha</samp>&rsquo;</dt>
  3278. <dt>&lsquo;<samp>ipp</samp>&rsquo;</dt>
  3279. <dt>&lsquo;<samp>xvidmmx</samp>&rsquo;</dt>
  3280. <dt>&lsquo;<samp>faani</samp>&rsquo;</dt>
  3281. <dd><p>floating point AAN IDCT
  3282. </p></dd>
  3283. </dl>
  3284. </dd>
  3285. <dt><samp>slice_count <var>integer</var></samp></dt>
  3286. <dt><samp>ec <var>flags</var> (<em>decoding,video</em>)</samp></dt>
  3287. <dd><p>Set error concealment strategy.
  3288. </p>
  3289. <p>Possible values:
  3290. </p><dl compact="compact">
  3291. <dt>&lsquo;<samp>guess_mvs</samp>&rsquo;</dt>
  3292. <dd><p>iterative motion vector (MV) search (slow)
  3293. </p></dd>
  3294. <dt>&lsquo;<samp>deblock</samp>&rsquo;</dt>
  3295. <dd><p>use strong deblock filter for damaged MBs
  3296. </p></dd>
  3297. <dt>&lsquo;<samp>favor_inter</samp>&rsquo;</dt>
  3298. <dd><p>favor predicting from the previous frame instead of the current
  3299. </p></dd>
  3300. </dl>
  3301. </dd>
  3302. <dt><samp>bits_per_coded_sample <var>integer</var></samp></dt>
  3303. <dt><samp>pred <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3304. <dd><p>Set prediction method.
  3305. </p>
  3306. <p>Possible values:
  3307. </p><dl compact="compact">
  3308. <dt>&lsquo;<samp>left</samp>&rsquo;</dt>
  3309. <dt>&lsquo;<samp>plane</samp>&rsquo;</dt>
  3310. <dt>&lsquo;<samp>median</samp>&rsquo;</dt>
  3311. </dl>
  3312. </dd>
  3313. <dt><samp>aspect <var>rational number</var> (<em>encoding,video</em>)</samp></dt>
  3314. <dd><p>Set sample aspect ratio.
  3315. </p>
  3316. </dd>
  3317. <dt><samp>debug <var>flags</var> (<em>decoding/encoding,audio,video,subtitles</em>)</samp></dt>
  3318. <dd><p>Print specific debug info.
  3319. </p>
  3320. <p>Possible values:
  3321. </p><dl compact="compact">
  3322. <dt>&lsquo;<samp>pict</samp>&rsquo;</dt>
  3323. <dd><p>picture info
  3324. </p></dd>
  3325. <dt>&lsquo;<samp>rc</samp>&rsquo;</dt>
  3326. <dd><p>rate control
  3327. </p></dd>
  3328. <dt>&lsquo;<samp>bitstream</samp>&rsquo;</dt>
  3329. <dt>&lsquo;<samp>mb_type</samp>&rsquo;</dt>
  3330. <dd><p>macroblock (MB) type
  3331. </p></dd>
  3332. <dt>&lsquo;<samp>qp</samp>&rsquo;</dt>
  3333. <dd><p>per-block quantization parameter (QP)
  3334. </p></dd>
  3335. <dt>&lsquo;<samp>mv</samp>&rsquo;</dt>
  3336. <dd><p>motion vector
  3337. </p></dd>
  3338. <dt>&lsquo;<samp>dct_coeff</samp>&rsquo;</dt>
  3339. <dt>&lsquo;<samp>skip</samp>&rsquo;</dt>
  3340. <dt>&lsquo;<samp>startcode</samp>&rsquo;</dt>
  3341. <dt>&lsquo;<samp>pts</samp>&rsquo;</dt>
  3342. <dt>&lsquo;<samp>er</samp>&rsquo;</dt>
  3343. <dd><p>error recognition
  3344. </p></dd>
  3345. <dt>&lsquo;<samp>mmco</samp>&rsquo;</dt>
  3346. <dd><p>memory management control operations (H.264)
  3347. </p></dd>
  3348. <dt>&lsquo;<samp>bugs</samp>&rsquo;</dt>
  3349. <dt>&lsquo;<samp>vis_qp</samp>&rsquo;</dt>
  3350. <dd><p>visualize quantization parameter (QP), lower QP are tinted greener
  3351. </p></dd>
  3352. <dt>&lsquo;<samp>vis_mb_type</samp>&rsquo;</dt>
  3353. <dd><p>visualize block types
  3354. </p></dd>
  3355. <dt>&lsquo;<samp>buffers</samp>&rsquo;</dt>
  3356. <dd><p>picture buffer allocations
  3357. </p></dd>
  3358. <dt>&lsquo;<samp>thread_ops</samp>&rsquo;</dt>
  3359. <dd><p>threading operations
  3360. </p></dd>
  3361. <dt>&lsquo;<samp>nomc</samp>&rsquo;</dt>
  3362. <dd><p>skip motion compensation
  3363. </p></dd>
  3364. </dl>
  3365. </dd>
  3366. <dt><samp>vismv <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3367. <dd><p>Visualize motion vectors (MVs).
  3368. </p>
  3369. <p>This option is deprecated, see the codecview filter instead.
  3370. </p>
  3371. <p>Possible values:
  3372. </p><dl compact="compact">
  3373. <dt>&lsquo;<samp>pf</samp>&rsquo;</dt>
  3374. <dd><p>forward predicted MVs of P-frames
  3375. </p></dd>
  3376. <dt>&lsquo;<samp>bf</samp>&rsquo;</dt>
  3377. <dd><p>forward predicted MVs of B-frames
  3378. </p></dd>
  3379. <dt>&lsquo;<samp>bb</samp>&rsquo;</dt>
  3380. <dd><p>backward predicted MVs of B-frames
  3381. </p></dd>
  3382. </dl>
  3383. </dd>
  3384. <dt><samp>cmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3385. <dd><p>Set full pel me compare function.
  3386. </p>
  3387. <p>Possible values:
  3388. </p><dl compact="compact">
  3389. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3390. <dd><p>sum of absolute differences, fast (default)
  3391. </p></dd>
  3392. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3393. <dd><p>sum of squared errors
  3394. </p></dd>
  3395. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3396. <dd><p>sum of absolute Hadamard transformed differences
  3397. </p></dd>
  3398. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3399. <dd><p>sum of absolute DCT transformed differences
  3400. </p></dd>
  3401. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3402. <dd><p>sum of squared quantization errors (avoid, low quality)
  3403. </p></dd>
  3404. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3405. <dd><p>number of bits needed for the block
  3406. </p></dd>
  3407. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3408. <dd><p>rate distortion optimal, slow
  3409. </p></dd>
  3410. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3411. <dd><p>0
  3412. </p></dd>
  3413. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3414. <dd><p>sum of absolute vertical differences
  3415. </p></dd>
  3416. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3417. <dd><p>sum of squared vertical differences
  3418. </p></dd>
  3419. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3420. <dd><p>noise preserving sum of squared differences
  3421. </p></dd>
  3422. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3423. <dd><p>5/3 wavelet, only used in snow
  3424. </p></dd>
  3425. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3426. <dd><p>9/7 wavelet, only used in snow
  3427. </p></dd>
  3428. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3429. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3430. </dl>
  3431. </dd>
  3432. <dt><samp>subcmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3433. <dd><p>Set sub pel me compare function.
  3434. </p>
  3435. <p>Possible values:
  3436. </p><dl compact="compact">
  3437. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3438. <dd><p>sum of absolute differences, fast (default)
  3439. </p></dd>
  3440. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3441. <dd><p>sum of squared errors
  3442. </p></dd>
  3443. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3444. <dd><p>sum of absolute Hadamard transformed differences
  3445. </p></dd>
  3446. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3447. <dd><p>sum of absolute DCT transformed differences
  3448. </p></dd>
  3449. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3450. <dd><p>sum of squared quantization errors (avoid, low quality)
  3451. </p></dd>
  3452. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3453. <dd><p>number of bits needed for the block
  3454. </p></dd>
  3455. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3456. <dd><p>rate distortion optimal, slow
  3457. </p></dd>
  3458. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3459. <dd><p>0
  3460. </p></dd>
  3461. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3462. <dd><p>sum of absolute vertical differences
  3463. </p></dd>
  3464. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3465. <dd><p>sum of squared vertical differences
  3466. </p></dd>
  3467. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3468. <dd><p>noise preserving sum of squared differences
  3469. </p></dd>
  3470. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3471. <dd><p>5/3 wavelet, only used in snow
  3472. </p></dd>
  3473. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3474. <dd><p>9/7 wavelet, only used in snow
  3475. </p></dd>
  3476. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3477. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3478. </dl>
  3479. </dd>
  3480. <dt><samp>mbcmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3481. <dd><p>Set macroblock compare function.
  3482. </p>
  3483. <p>Possible values:
  3484. </p><dl compact="compact">
  3485. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3486. <dd><p>sum of absolute differences, fast (default)
  3487. </p></dd>
  3488. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3489. <dd><p>sum of squared errors
  3490. </p></dd>
  3491. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3492. <dd><p>sum of absolute Hadamard transformed differences
  3493. </p></dd>
  3494. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3495. <dd><p>sum of absolute DCT transformed differences
  3496. </p></dd>
  3497. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3498. <dd><p>sum of squared quantization errors (avoid, low quality)
  3499. </p></dd>
  3500. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3501. <dd><p>number of bits needed for the block
  3502. </p></dd>
  3503. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3504. <dd><p>rate distortion optimal, slow
  3505. </p></dd>
  3506. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3507. <dd><p>0
  3508. </p></dd>
  3509. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3510. <dd><p>sum of absolute vertical differences
  3511. </p></dd>
  3512. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3513. <dd><p>sum of squared vertical differences
  3514. </p></dd>
  3515. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3516. <dd><p>noise preserving sum of squared differences
  3517. </p></dd>
  3518. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3519. <dd><p>5/3 wavelet, only used in snow
  3520. </p></dd>
  3521. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3522. <dd><p>9/7 wavelet, only used in snow
  3523. </p></dd>
  3524. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3525. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3526. </dl>
  3527. </dd>
  3528. <dt><samp>ildctcmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3529. <dd><p>Set interlaced dct compare function.
  3530. </p>
  3531. <p>Possible values:
  3532. </p><dl compact="compact">
  3533. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3534. <dd><p>sum of absolute differences, fast (default)
  3535. </p></dd>
  3536. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3537. <dd><p>sum of squared errors
  3538. </p></dd>
  3539. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3540. <dd><p>sum of absolute Hadamard transformed differences
  3541. </p></dd>
  3542. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3543. <dd><p>sum of absolute DCT transformed differences
  3544. </p></dd>
  3545. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3546. <dd><p>sum of squared quantization errors (avoid, low quality)
  3547. </p></dd>
  3548. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3549. <dd><p>number of bits needed for the block
  3550. </p></dd>
  3551. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3552. <dd><p>rate distortion optimal, slow
  3553. </p></dd>
  3554. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3555. <dd><p>0
  3556. </p></dd>
  3557. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3558. <dd><p>sum of absolute vertical differences
  3559. </p></dd>
  3560. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3561. <dd><p>sum of squared vertical differences
  3562. </p></dd>
  3563. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3564. <dd><p>noise preserving sum of squared differences
  3565. </p></dd>
  3566. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3567. <dd><p>5/3 wavelet, only used in snow
  3568. </p></dd>
  3569. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3570. <dd><p>9/7 wavelet, only used in snow
  3571. </p></dd>
  3572. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3573. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3574. </dl>
  3575. </dd>
  3576. <dt><samp>dia_size <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3577. <dd><p>Set diamond type &amp; size for motion estimation.
  3578. </p>
  3579. </dd>
  3580. <dt><samp>last_pred <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3581. <dd><p>Set amount of motion predictors from the previous frame.
  3582. </p>
  3583. </dd>
  3584. <dt><samp>preme <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3585. <dd><p>Set pre motion estimation.
  3586. </p>
  3587. </dd>
  3588. <dt><samp>precmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3589. <dd><p>Set pre motion estimation compare function.
  3590. </p>
  3591. <p>Possible values:
  3592. </p><dl compact="compact">
  3593. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3594. <dd><p>sum of absolute differences, fast (default)
  3595. </p></dd>
  3596. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3597. <dd><p>sum of squared errors
  3598. </p></dd>
  3599. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3600. <dd><p>sum of absolute Hadamard transformed differences
  3601. </p></dd>
  3602. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3603. <dd><p>sum of absolute DCT transformed differences
  3604. </p></dd>
  3605. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3606. <dd><p>sum of squared quantization errors (avoid, low quality)
  3607. </p></dd>
  3608. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3609. <dd><p>number of bits needed for the block
  3610. </p></dd>
  3611. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3612. <dd><p>rate distortion optimal, slow
  3613. </p></dd>
  3614. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3615. <dd><p>0
  3616. </p></dd>
  3617. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3618. <dd><p>sum of absolute vertical differences
  3619. </p></dd>
  3620. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3621. <dd><p>sum of squared vertical differences
  3622. </p></dd>
  3623. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3624. <dd><p>noise preserving sum of squared differences
  3625. </p></dd>
  3626. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3627. <dd><p>5/3 wavelet, only used in snow
  3628. </p></dd>
  3629. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3630. <dd><p>9/7 wavelet, only used in snow
  3631. </p></dd>
  3632. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3633. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3634. </dl>
  3635. </dd>
  3636. <dt><samp>pre_dia_size <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3637. <dd><p>Set diamond type &amp; size for motion estimation pre-pass.
  3638. </p>
  3639. </dd>
  3640. <dt><samp>subq <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3641. <dd><p>Set sub pel motion estimation quality.
  3642. </p>
  3643. </dd>
  3644. <dt><samp>dtg_active_format <var>integer</var></samp></dt>
  3645. <dt><samp>me_range <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3646. <dd><p>Set limit motion vectors range (1023 for DivX player).
  3647. </p>
  3648. </dd>
  3649. <dt><samp>ibias <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3650. <dd><p>Set intra quant bias.
  3651. </p>
  3652. </dd>
  3653. <dt><samp>pbias <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3654. <dd><p>Set inter quant bias.
  3655. </p>
  3656. </dd>
  3657. <dt><samp>color_table_id <var>integer</var></samp></dt>
  3658. <dt><samp>global_quality <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3659. <dt><samp>coder <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3660. <dd>
  3661. <p>Possible values:
  3662. </p><dl compact="compact">
  3663. <dt>&lsquo;<samp>vlc</samp>&rsquo;</dt>
  3664. <dd><p>variable length coder / huffman coder
  3665. </p></dd>
  3666. <dt>&lsquo;<samp>ac</samp>&rsquo;</dt>
  3667. <dd><p>arithmetic coder
  3668. </p></dd>
  3669. <dt>&lsquo;<samp>raw</samp>&rsquo;</dt>
  3670. <dd><p>raw (no encoding)
  3671. </p></dd>
  3672. <dt>&lsquo;<samp>rle</samp>&rsquo;</dt>
  3673. <dd><p>run-length coder
  3674. </p></dd>
  3675. <dt>&lsquo;<samp>deflate</samp>&rsquo;</dt>
  3676. <dd><p>deflate-based coder
  3677. </p></dd>
  3678. </dl>
  3679. </dd>
  3680. <dt><samp>context <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3681. <dd><p>Set context model.
  3682. </p>
  3683. </dd>
  3684. <dt><samp>slice_flags <var>integer</var></samp></dt>
  3685. <dt><samp>xvmc_acceleration <var>integer</var></samp></dt>
  3686. <dt><samp>mbd <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3687. <dd><p>Set macroblock decision algorithm (high quality mode).
  3688. </p>
  3689. <p>Possible values:
  3690. </p><dl compact="compact">
  3691. <dt>&lsquo;<samp>simple</samp>&rsquo;</dt>
  3692. <dd><p>use mbcmp (default)
  3693. </p></dd>
  3694. <dt>&lsquo;<samp>bits</samp>&rsquo;</dt>
  3695. <dd><p>use fewest bits
  3696. </p></dd>
  3697. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3698. <dd><p>use best rate distortion
  3699. </p></dd>
  3700. </dl>
  3701. </dd>
  3702. <dt><samp>stream_codec_tag <var>integer</var></samp></dt>
  3703. <dt><samp>sc_threshold <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3704. <dd><p>Set scene change threshold.
  3705. </p>
  3706. </dd>
  3707. <dt><samp>lmin <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3708. <dd><p>Set min lagrange factor (VBR).
  3709. </p>
  3710. </dd>
  3711. <dt><samp>lmax <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3712. <dd><p>Set max lagrange factor (VBR).
  3713. </p>
  3714. </dd>
  3715. <dt><samp>nr <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3716. <dd><p>Set noise reduction.
  3717. </p>
  3718. </dd>
  3719. <dt><samp>rc_init_occupancy <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3720. <dd><p>Set number of bits which should be loaded into the rc buffer before
  3721. decoding starts.
  3722. </p>
  3723. </dd>
  3724. <dt><samp>flags2 <var>flags</var> (<em>decoding/encoding,audio,video</em>)</samp></dt>
  3725. <dd>
  3726. <p>Possible values:
  3727. </p><dl compact="compact">
  3728. <dt>&lsquo;<samp>fast</samp>&rsquo;</dt>
  3729. <dd><p>Allow non spec compliant speedup tricks.
  3730. </p></dd>
  3731. <dt>&lsquo;<samp>sgop</samp>&rsquo;</dt>
  3732. <dd><p>Deprecated, use mpegvideo private options instead.
  3733. </p></dd>
  3734. <dt>&lsquo;<samp>noout</samp>&rsquo;</dt>
  3735. <dd><p>Skip bitstream encoding.
  3736. </p></dd>
  3737. <dt>&lsquo;<samp>ignorecrop</samp>&rsquo;</dt>
  3738. <dd><p>Ignore cropping information from sps.
  3739. </p></dd>
  3740. <dt>&lsquo;<samp>local_header</samp>&rsquo;</dt>
  3741. <dd><p>Place global headers at every keyframe instead of in extradata.
  3742. </p></dd>
  3743. <dt>&lsquo;<samp>chunks</samp>&rsquo;</dt>
  3744. <dd><p>Frame data might be split into multiple chunks.
  3745. </p></dd>
  3746. <dt>&lsquo;<samp>showall</samp>&rsquo;</dt>
  3747. <dd><p>Show all frames before the first keyframe.
  3748. </p></dd>
  3749. <dt>&lsquo;<samp>skiprd</samp>&rsquo;</dt>
  3750. <dd><p>Deprecated, use mpegvideo private options instead.
  3751. </p></dd>
  3752. <dt>&lsquo;<samp>export_mvs</samp>&rsquo;</dt>
  3753. <dd><p>Export motion vectors into frame side-data (see <code>AV_FRAME_DATA_MOTION_VECTORS</code>)
  3754. for codecs that support it. See also <samp>doc/examples/export_mvs.c</samp>.
  3755. </p></dd>
  3756. </dl>
  3757. </dd>
  3758. <dt><samp>error <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3759. <dt><samp>qns <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3760. <dd><p>Deprecated, use mpegvideo private options instead.
  3761. </p>
  3762. </dd>
  3763. <dt><samp>threads <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  3764. <dd>
  3765. <p>Possible values:
  3766. </p><dl compact="compact">
  3767. <dt>&lsquo;<samp>auto</samp>&rsquo;</dt>
  3768. <dd><p>detect a good number of threads
  3769. </p></dd>
  3770. </dl>
  3771. </dd>
  3772. <dt><samp>me_threshold <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3773. <dd><p>Set motion estimation threshold.
  3774. </p>
  3775. </dd>
  3776. <dt><samp>mb_threshold <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3777. <dd><p>Set macroblock threshold.
  3778. </p>
  3779. </dd>
  3780. <dt><samp>dc <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3781. <dd><p>Set intra_dc_precision.
  3782. </p>
  3783. </dd>
  3784. <dt><samp>nssew <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3785. <dd><p>Set nsse weight.
  3786. </p>
  3787. </dd>
  3788. <dt><samp>skip_top <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3789. <dd><p>Set number of macroblock rows at the top which are skipped.
  3790. </p>
  3791. </dd>
  3792. <dt><samp>skip_bottom <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3793. <dd><p>Set number of macroblock rows at the bottom which are skipped.
  3794. </p>
  3795. </dd>
  3796. <dt><samp>profile <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3797. <dd>
  3798. <p>Possible values:
  3799. </p><dl compact="compact">
  3800. <dt>&lsquo;<samp>unknown</samp>&rsquo;</dt>
  3801. <dt>&lsquo;<samp>aac_main</samp>&rsquo;</dt>
  3802. <dt>&lsquo;<samp>aac_low</samp>&rsquo;</dt>
  3803. <dt>&lsquo;<samp>aac_ssr</samp>&rsquo;</dt>
  3804. <dt>&lsquo;<samp>aac_ltp</samp>&rsquo;</dt>
  3805. <dt>&lsquo;<samp>aac_he</samp>&rsquo;</dt>
  3806. <dt>&lsquo;<samp>aac_he_v2</samp>&rsquo;</dt>
  3807. <dt>&lsquo;<samp>aac_ld</samp>&rsquo;</dt>
  3808. <dt>&lsquo;<samp>aac_eld</samp>&rsquo;</dt>
  3809. <dt>&lsquo;<samp>mpeg2_aac_low</samp>&rsquo;</dt>
  3810. <dt>&lsquo;<samp>mpeg2_aac_he</samp>&rsquo;</dt>
  3811. <dt>&lsquo;<samp>mpeg4_sp</samp>&rsquo;</dt>
  3812. <dt>&lsquo;<samp>mpeg4_core</samp>&rsquo;</dt>
  3813. <dt>&lsquo;<samp>mpeg4_main</samp>&rsquo;</dt>
  3814. <dt>&lsquo;<samp>mpeg4_asp</samp>&rsquo;</dt>
  3815. <dt>&lsquo;<samp>dts</samp>&rsquo;</dt>
  3816. <dt>&lsquo;<samp>dts_es</samp>&rsquo;</dt>
  3817. <dt>&lsquo;<samp>dts_96_24</samp>&rsquo;</dt>
  3818. <dt>&lsquo;<samp>dts_hd_hra</samp>&rsquo;</dt>
  3819. <dt>&lsquo;<samp>dts_hd_ma</samp>&rsquo;</dt>
  3820. </dl>
  3821. </dd>
  3822. <dt><samp>level <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3823. <dd>
  3824. <p>Possible values:
  3825. </p><dl compact="compact">
  3826. <dt>&lsquo;<samp>unknown</samp>&rsquo;</dt>
  3827. </dl>
  3828. </dd>
  3829. <dt><samp>lowres <var>integer</var> (<em>decoding,audio,video</em>)</samp></dt>
  3830. <dd><p>Decode at 1= 1/2, 2=1/4, 3=1/8 resolutions.
  3831. </p>
  3832. </dd>
  3833. <dt><samp>skip_threshold <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3834. <dd><p>Set frame skip threshold.
  3835. </p>
  3836. </dd>
  3837. <dt><samp>skip_factor <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3838. <dd><p>Set frame skip factor.
  3839. </p>
  3840. </dd>
  3841. <dt><samp>skip_exp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3842. <dd><p>Set frame skip exponent.
  3843. Negative values behave identical to the corresponding positive ones, except
  3844. that the score is normalized.
  3845. Positive values exist primarily for compatibility reasons and are not so useful.
  3846. </p>
  3847. </dd>
  3848. <dt><samp>skipcmp <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3849. <dd><p>Set frame skip compare function.
  3850. </p>
  3851. <p>Possible values:
  3852. </p><dl compact="compact">
  3853. <dt>&lsquo;<samp>sad</samp>&rsquo;</dt>
  3854. <dd><p>sum of absolute differences, fast (default)
  3855. </p></dd>
  3856. <dt>&lsquo;<samp>sse</samp>&rsquo;</dt>
  3857. <dd><p>sum of squared errors
  3858. </p></dd>
  3859. <dt>&lsquo;<samp>satd</samp>&rsquo;</dt>
  3860. <dd><p>sum of absolute Hadamard transformed differences
  3861. </p></dd>
  3862. <dt>&lsquo;<samp>dct</samp>&rsquo;</dt>
  3863. <dd><p>sum of absolute DCT transformed differences
  3864. </p></dd>
  3865. <dt>&lsquo;<samp>psnr</samp>&rsquo;</dt>
  3866. <dd><p>sum of squared quantization errors (avoid, low quality)
  3867. </p></dd>
  3868. <dt>&lsquo;<samp>bit</samp>&rsquo;</dt>
  3869. <dd><p>number of bits needed for the block
  3870. </p></dd>
  3871. <dt>&lsquo;<samp>rd</samp>&rsquo;</dt>
  3872. <dd><p>rate distortion optimal, slow
  3873. </p></dd>
  3874. <dt>&lsquo;<samp>zero</samp>&rsquo;</dt>
  3875. <dd><p>0
  3876. </p></dd>
  3877. <dt>&lsquo;<samp>vsad</samp>&rsquo;</dt>
  3878. <dd><p>sum of absolute vertical differences
  3879. </p></dd>
  3880. <dt>&lsquo;<samp>vsse</samp>&rsquo;</dt>
  3881. <dd><p>sum of squared vertical differences
  3882. </p></dd>
  3883. <dt>&lsquo;<samp>nsse</samp>&rsquo;</dt>
  3884. <dd><p>noise preserving sum of squared differences
  3885. </p></dd>
  3886. <dt>&lsquo;<samp>w53</samp>&rsquo;</dt>
  3887. <dd><p>5/3 wavelet, only used in snow
  3888. </p></dd>
  3889. <dt>&lsquo;<samp>w97</samp>&rsquo;</dt>
  3890. <dd><p>9/7 wavelet, only used in snow
  3891. </p></dd>
  3892. <dt>&lsquo;<samp>dctmax</samp>&rsquo;</dt>
  3893. <dt>&lsquo;<samp>chroma</samp>&rsquo;</dt>
  3894. </dl>
  3895. </dd>
  3896. <dt><samp>border_mask <var>float</var> (<em>encoding,video</em>)</samp></dt>
  3897. <dd><p>Increase the quantizer for macroblocks close to borders.
  3898. </p>
  3899. </dd>
  3900. <dt><samp>mblmin <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3901. <dd><p>Set min macroblock lagrange factor (VBR).
  3902. </p>
  3903. </dd>
  3904. <dt><samp>mblmax <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3905. <dd><p>Set max macroblock lagrange factor (VBR).
  3906. </p>
  3907. </dd>
  3908. <dt><samp>mepc <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3909. <dd><p>Set motion estimation bitrate penalty compensation (1.0 = 256).
  3910. </p>
  3911. </dd>
  3912. <dt><samp>skip_loop_filter <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3913. <dt><samp>skip_idct <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3914. <dt><samp>skip_frame <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  3915. <dd>
  3916. <p>Make decoder discard processing depending on the frame type selected
  3917. by the option value.
  3918. </p>
  3919. <p><samp>skip_loop_filter</samp> skips frame loop filtering, <samp>skip_idct</samp>
  3920. skips frame IDCT/dequantization, <samp>skip_frame</samp> skips decoding.
  3921. </p>
  3922. <p>Possible values:
  3923. </p><dl compact="compact">
  3924. <dt>&lsquo;<samp>none</samp>&rsquo;</dt>
  3925. <dd><p>Discard no frame.
  3926. </p>
  3927. </dd>
  3928. <dt>&lsquo;<samp>default</samp>&rsquo;</dt>
  3929. <dd><p>Discard useless frames like 0-sized frames.
  3930. </p>
  3931. </dd>
  3932. <dt>&lsquo;<samp>noref</samp>&rsquo;</dt>
  3933. <dd><p>Discard all non-reference frames.
  3934. </p>
  3935. </dd>
  3936. <dt>&lsquo;<samp>bidir</samp>&rsquo;</dt>
  3937. <dd><p>Discard all bidirectional frames.
  3938. </p>
  3939. </dd>
  3940. <dt>&lsquo;<samp>nokey</samp>&rsquo;</dt>
  3941. <dd><p>Discard all frames excepts keyframes.
  3942. </p>
  3943. </dd>
  3944. <dt>&lsquo;<samp>all</samp>&rsquo;</dt>
  3945. <dd><p>Discard all frames.
  3946. </p></dd>
  3947. </dl>
  3948. <p>Default value is &lsquo;<samp>default</samp>&rsquo;.
  3949. </p>
  3950. </dd>
  3951. <dt><samp>bidir_refine <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3952. <dd><p>Refine the two motion vectors used in bidirectional macroblocks.
  3953. </p>
  3954. </dd>
  3955. <dt><samp>brd_scale <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3956. <dd><p>Downscale frames for dynamic B-frame decision.
  3957. </p>
  3958. </dd>
  3959. <dt><samp>keyint_min <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3960. <dd><p>Set minimum interval between IDR-frames.
  3961. </p>
  3962. </dd>
  3963. <dt><samp>refs <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3964. <dd><p>Set reference frames to consider for motion compensation.
  3965. </p>
  3966. </dd>
  3967. <dt><samp>chromaoffset <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3968. <dd><p>Set chroma qp offset from luma.
  3969. </p>
  3970. </dd>
  3971. <dt><samp>trellis <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3972. <dd><p>Set rate-distortion optimal quantization.
  3973. </p>
  3974. </dd>
  3975. <dt><samp>sc_factor <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3976. <dd><p>Set value multiplied by qscale for each frame and added to
  3977. scene_change_score.
  3978. </p>
  3979. </dd>
  3980. <dt><samp>mv0_threshold <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3981. <dt><samp>b_sensitivity <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3982. <dd><p>Adjust sensitivity of b_frame_strategy 1.
  3983. </p>
  3984. </dd>
  3985. <dt><samp>compression_level <var>integer</var> (<em>encoding,audio,video</em>)</samp></dt>
  3986. <dt><samp>min_prediction_order <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  3987. <dt><samp>max_prediction_order <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  3988. <dt><samp>timecode_frame_start <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  3989. <dd><p>Set GOP timecode frame start number, in non drop frame format.
  3990. </p>
  3991. </dd>
  3992. <dt><samp>request_channels <var>integer</var> (<em>decoding,audio</em>)</samp></dt>
  3993. <dd><p>Set desired number of audio channels.
  3994. </p>
  3995. </dd>
  3996. <dt><samp>bits_per_raw_sample <var>integer</var></samp></dt>
  3997. <dt><samp>channel_layout <var>integer</var> (<em>decoding/encoding,audio</em>)</samp></dt>
  3998. <dd>
  3999. <p>Possible values:
  4000. </p></dd>
  4001. <dt><samp>request_channel_layout <var>integer</var> (<em>decoding,audio</em>)</samp></dt>
  4002. <dd>
  4003. <p>Possible values:
  4004. </p></dd>
  4005. <dt><samp>rc_max_vbv_use <var>float</var> (<em>encoding,video</em>)</samp></dt>
  4006. <dt><samp>rc_min_vbv_use <var>float</var> (<em>encoding,video</em>)</samp></dt>
  4007. <dt><samp>ticks_per_frame <var>integer</var> (<em>decoding/encoding,audio,video</em>)</samp></dt>
  4008. <dt><samp>color_primaries <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4009. <dt><samp>color_trc <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4010. <dt><samp>colorspace <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4011. <dt><samp>color_range <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4012. <dt><samp>chroma_sample_location <var>integer</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4013. <dt><samp>log_level_offset <var>integer</var></samp></dt>
  4014. <dd><p>Set the log level offset.
  4015. </p>
  4016. </dd>
  4017. <dt><samp>slices <var>integer</var> (<em>encoding,video</em>)</samp></dt>
  4018. <dd><p>Number of slices, used in parallelized encoding.
  4019. </p>
  4020. </dd>
  4021. <dt><samp>thread_type <var>flags</var> (<em>decoding/encoding,video</em>)</samp></dt>
  4022. <dd><p>Select which multithreading methods to use.
  4023. </p>
  4024. <p>Use of &lsquo;<samp>frame</samp>&rsquo; will increase decoding delay by one frame per
  4025. thread, so clients which cannot provide future frames should not use
  4026. it.
  4027. </p>
  4028. <p>Possible values:
  4029. </p><dl compact="compact">
  4030. <dt>&lsquo;<samp>slice</samp>&rsquo;</dt>
  4031. <dd><p>Decode more than one part of a single frame at once.
  4032. </p>
  4033. <p>Multithreading using slices works only when the video was encoded with
  4034. slices.
  4035. </p>
  4036. </dd>
  4037. <dt>&lsquo;<samp>frame</samp>&rsquo;</dt>
  4038. <dd><p>Decode more than one frame at once.
  4039. </p></dd>
  4040. </dl>
  4041. <p>Default value is &lsquo;<samp>slice+frame</samp>&rsquo;.
  4042. </p>
  4043. </dd>
  4044. <dt><samp>audio_service_type <var>integer</var> (<em>encoding,audio</em>)</samp></dt>
  4045. <dd><p>Set audio service type.
  4046. </p>
  4047. <p>Possible values:
  4048. </p><dl compact="compact">
  4049. <dt>&lsquo;<samp>ma</samp>&rsquo;</dt>
  4050. <dd><p>Main Audio Service
  4051. </p></dd>
  4052. <dt>&lsquo;<samp>ef</samp>&rsquo;</dt>
  4053. <dd><p>Effects
  4054. </p></dd>
  4055. <dt>&lsquo;<samp>vi</samp>&rsquo;</dt>
  4056. <dd><p>Visually Impaired
  4057. </p></dd>
  4058. <dt>&lsquo;<samp>hi</samp>&rsquo;</dt>
  4059. <dd><p>Hearing Impaired
  4060. </p></dd>
  4061. <dt>&lsquo;<samp>di</samp>&rsquo;</dt>
  4062. <dd><p>Dialogue
  4063. </p></dd>
  4064. <dt>&lsquo;<samp>co</samp>&rsquo;</dt>
  4065. <dd><p>Commentary
  4066. </p></dd>
  4067. <dt>&lsquo;<samp>em</samp>&rsquo;</dt>
  4068. <dd><p>Emergency
  4069. </p></dd>
  4070. <dt>&lsquo;<samp>vo</samp>&rsquo;</dt>
  4071. <dd><p>Voice Over
  4072. </p></dd>
  4073. <dt>&lsquo;<samp>ka</samp>&rsquo;</dt>
  4074. <dd><p>Karaoke
  4075. </p></dd>
  4076. </dl>
  4077. </dd>
  4078. <dt><samp>request_sample_fmt <var>sample_fmt</var> (<em>decoding,audio</em>)</samp></dt>
  4079. <dd><p>Set sample format audio decoders should prefer. Default value is
  4080. <code>none</code>.
  4081. </p>
  4082. </dd>
  4083. <dt><samp>pkt_timebase <var>rational number</var></samp></dt>
  4084. <dt><samp>sub_charenc <var>encoding</var> (<em>decoding,subtitles</em>)</samp></dt>
  4085. <dd><p>Set the input subtitles character encoding.
  4086. </p>
  4087. </dd>
  4088. <dt><samp>field_order <var>field_order</var> (<em>video</em>)</samp></dt>
  4089. <dd><p>Set/override the field order of the video.
  4090. Possible values:
  4091. </p><dl compact="compact">
  4092. <dt>&lsquo;<samp>progressive</samp>&rsquo;</dt>
  4093. <dd><p>Progressive video
  4094. </p></dd>
  4095. <dt>&lsquo;<samp>tt</samp>&rsquo;</dt>
  4096. <dd><p>Interlaced video, top field coded and displayed first
  4097. </p></dd>
  4098. <dt>&lsquo;<samp>bb</samp>&rsquo;</dt>
  4099. <dd><p>Interlaced video, bottom field coded and displayed first
  4100. </p></dd>
  4101. <dt>&lsquo;<samp>tb</samp>&rsquo;</dt>
  4102. <dd><p>Interlaced video, top coded first, bottom displayed first
  4103. </p></dd>
  4104. <dt>&lsquo;<samp>bt</samp>&rsquo;</dt>
  4105. <dd><p>Interlaced video, bottom coded first, top displayed first
  4106. </p></dd>
  4107. </dl>
  4108. </dd>
  4109. <dt><samp>skip_alpha <var>integer</var> (<em>decoding,video</em>)</samp></dt>
  4110. <dd><p>Set to 1 to disable processing alpha (transparency). This works like the
  4111. &lsquo;<samp>gray</samp>&rsquo; flag in the <samp>flags</samp> option which skips chroma information
  4112. instead of alpha. Default is 0.
  4113. </p>
  4114. </dd>
  4115. <dt><samp>codec_whitelist <var>list</var> (<em>input</em>)</samp></dt>
  4116. <dd><p>&quot;,&quot; separated List of allowed decoders. By default all are allowed.
  4117. </p>
  4118. </dd>
  4119. <dt><samp>dump_separator <var>string</var> (<em>input</em>)</samp></dt>
  4120. <dd><p>Separator used to separate the fields printed on the command line about the
  4121. Stream parameters.
  4122. For example to separate the fields with newlines and indention:
  4123. </p><div class="example">
  4124. <pre class="example">ffprobe -dump_separator &quot;
  4125. &quot; -i ~/videos/matrixbench_mpeg2.mpg
  4126. </pre></div>
  4127. </dd>
  4128. </dl>
  4129. <a name="Decoders"></a>
  4130. <h2 class="chapter">8 Decoders<span class="pull-right"><a class="anchor hidden-xs" href="#Decoders" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Decoders" aria-hidden="true">TOC</a></span></h2>
  4131. <p>Decoders are configured elements in FFmpeg which allow the decoding of
  4132. multimedia streams.
  4133. </p>
  4134. <p>When you configure your FFmpeg build, all the supported native decoders
  4135. are enabled by default. Decoders requiring an external library must be enabled
  4136. manually via the corresponding <code>--enable-lib</code> option. You can list all
  4137. available decoders using the configure option <code>--list-decoders</code>.
  4138. </p>
  4139. <p>You can disable all the decoders with the configure option
  4140. <code>--disable-decoders</code> and selectively enable / disable single decoders
  4141. with the options <code>--enable-decoder=<var>DECODER</var></code> /
  4142. <code>--disable-decoder=<var>DECODER</var></code>.
  4143. </p>
  4144. <p>The option <code>-decoders</code> of the ff* tools will display the list of
  4145. enabled decoders.
  4146. </p>
  4147. <a name="Video-Decoders"></a>
  4148. <h2 class="chapter">9 Video Decoders<span class="pull-right"><a class="anchor hidden-xs" href="#Video-Decoders" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Video-Decoders" aria-hidden="true">TOC</a></span></h2>
  4149. <p>A description of some of the currently available video decoders
  4150. follows.
  4151. </p>
  4152. <a name="rawvideo"></a>
  4153. <h3 class="section">9.1 rawvideo<span class="pull-right"><a class="anchor hidden-xs" href="#rawvideo" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-rawvideo" aria-hidden="true">TOC</a></span></h3>
  4154. <p>Raw video decoder.
  4155. </p>
  4156. <p>This decoder decodes rawvideo streams.
  4157. </p>
  4158. <a name="Options-1"></a>
  4159. <h4 class="subsection">9.1.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-1" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-1" aria-hidden="true">TOC</a></span></h4>
  4160. <dl compact="compact">
  4161. <dt><samp>top <var>top_field_first</var></samp></dt>
  4162. <dd><p>Specify the assumed field type of the input video.
  4163. </p><dl compact="compact">
  4164. <dt><samp>-1</samp></dt>
  4165. <dd><p>the video is assumed to be progressive (default)
  4166. </p></dd>
  4167. <dt><samp>0</samp></dt>
  4168. <dd><p>bottom-field-first is assumed
  4169. </p></dd>
  4170. <dt><samp>1</samp></dt>
  4171. <dd><p>top-field-first is assumed
  4172. </p></dd>
  4173. </dl>
  4174. </dd>
  4175. </dl>
  4176. <a name="Audio-Decoders"></a>
  4177. <h2 class="chapter">10 Audio Decoders<span class="pull-right"><a class="anchor hidden-xs" href="#Audio-Decoders" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Audio-Decoders" aria-hidden="true">TOC</a></span></h2>
  4178. <p>A description of some of the currently available audio decoders
  4179. follows.
  4180. </p>
  4181. <a name="ac3"></a>
  4182. <h3 class="section">10.1 ac3<span class="pull-right"><a class="anchor hidden-xs" href="#ac3" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-ac3" aria-hidden="true">TOC</a></span></h3>
  4183. <p>AC-3 audio decoder.
  4184. </p>
  4185. <p>This decoder implements part of ATSC A/52:2010 and ETSI TS 102 366, as well as
  4186. the undocumented RealAudio 3 (a.k.a. dnet).
  4187. </p>
  4188. <a name="AC_002d3-Decoder-Options"></a>
  4189. <h4 class="subsection">10.1.1 AC-3 Decoder Options<span class="pull-right"><a class="anchor hidden-xs" href="#AC_002d3-Decoder-Options" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-AC_002d3-Decoder-Options" aria-hidden="true">TOC</a></span></h4>
  4190. <dl compact="compact">
  4191. <dt><samp>-drc_scale <var>value</var></samp></dt>
  4192. <dd><p>Dynamic Range Scale Factor. The factor to apply to dynamic range values
  4193. from the AC-3 stream. This factor is applied exponentially.
  4194. There are 3 notable scale factor ranges:
  4195. </p><dl compact="compact">
  4196. <dt><samp>drc_scale == 0</samp></dt>
  4197. <dd><p>DRC disabled. Produces full range audio.
  4198. </p></dd>
  4199. <dt><samp>0 &lt; drc_scale &lt;= 1</samp></dt>
  4200. <dd><p>DRC enabled. Applies a fraction of the stream DRC value.
  4201. Audio reproduction is between full range and full compression.
  4202. </p></dd>
  4203. <dt><samp>drc_scale &gt; 1</samp></dt>
  4204. <dd><p>DRC enabled. Applies drc_scale asymmetrically.
  4205. Loud sounds are fully compressed. Soft sounds are enhanced.
  4206. </p></dd>
  4207. </dl>
  4208. </dd>
  4209. </dl>
  4210. <a name="ffwavesynth"></a>
  4211. <h3 class="section">10.2 ffwavesynth<span class="pull-right"><a class="anchor hidden-xs" href="#ffwavesynth" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-ffwavesynth" aria-hidden="true">TOC</a></span></h3>
  4212. <p>Internal wave synthetizer.
  4213. </p>
  4214. <p>This decoder generates wave patterns according to predefined sequences. Its
  4215. use is purely internal and the format of the data it accepts is not publicly
  4216. documented.
  4217. </p>
  4218. <a name="libcelt"></a>
  4219. <h3 class="section">10.3 libcelt<span class="pull-right"><a class="anchor hidden-xs" href="#libcelt" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libcelt" aria-hidden="true">TOC</a></span></h3>
  4220. <p>libcelt decoder wrapper.
  4221. </p>
  4222. <p>libcelt allows libavcodec to decode the Xiph CELT ultra-low delay audio codec.
  4223. Requires the presence of the libcelt headers and library during configuration.
  4224. You need to explicitly configure the build with <code>--enable-libcelt</code>.
  4225. </p>
  4226. <a name="libgsm"></a>
  4227. <h3 class="section">10.4 libgsm<span class="pull-right"><a class="anchor hidden-xs" href="#libgsm" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libgsm" aria-hidden="true">TOC</a></span></h3>
  4228. <p>libgsm decoder wrapper.
  4229. </p>
  4230. <p>libgsm allows libavcodec to decode the GSM full rate audio codec. Requires
  4231. the presence of the libgsm headers and library during configuration. You need
  4232. to explicitly configure the build with <code>--enable-libgsm</code>.
  4233. </p>
  4234. <p>This decoder supports both the ordinary GSM and the Microsoft variant.
  4235. </p>
  4236. <a name="libilbc"></a>
  4237. <h3 class="section">10.5 libilbc<span class="pull-right"><a class="anchor hidden-xs" href="#libilbc" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libilbc" aria-hidden="true">TOC</a></span></h3>
  4238. <p>libilbc decoder wrapper.
  4239. </p>
  4240. <p>libilbc allows libavcodec to decode the Internet Low Bitrate Codec (iLBC)
  4241. audio codec. Requires the presence of the libilbc headers and library during
  4242. configuration. You need to explicitly configure the build with
  4243. <code>--enable-libilbc</code>.
  4244. </p>
  4245. <a name="Options-2"></a>
  4246. <h4 class="subsection">10.5.1 Options<span class="pull-right"><a class="anchor hidden-xs" href="#Options-2" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-Options-2" aria-hidden="true">TOC</a></span></h4>
  4247. <p>The following option is supported by the libilbc wrapper.
  4248. </p>
  4249. <dl compact="compact">
  4250. <dt><samp>enhance</samp></dt>
  4251. <dd>
  4252. <p>Enable the enhancement of the decoded audio when set to 1. The default
  4253. value is 0 (disabled).
  4254. </p>
  4255. </dd>
  4256. </dl>
  4257. <a name="libopencore_002damrnb"></a>
  4258. <h3 class="section">10.6 libopencore-amrnb<span class="pull-right"><a class="anchor hidden-xs" href="#libopencore_002damrnb" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libopencore_002damrnb" aria-hidden="true">TOC</a></span></h3>
  4259. <p>libopencore-amrnb decoder wrapper.
  4260. </p>
  4261. <p>libopencore-amrnb allows libavcodec to decode the Adaptive Multi-Rate
  4262. Narrowband audio codec. Using it requires the presence of the
  4263. libopencore-amrnb headers and library during configuration. You need to
  4264. explicitly configure the build with <code>--enable-libopencore-amrnb</code>.
  4265. </p>
  4266. <p>An FFmpeg native decoder for AMR-NB exists, so users can decode AMR-NB
  4267. without this library.
  4268. </p>
  4269. <a name="libopencore_002damrwb"></a>
  4270. <h3 class="section">10.7 libopencore-amrwb<span class="pull-right"><a class="anchor hidden-xs" href="#libopencore_002damrwb" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libopencore_002damrwb" aria-hidden="true">TOC</a></span></h3>
  4271. <p>libopencore-amrwb decoder wrapper.
  4272. </p>
  4273. <p>libopencore-amrwb allows libavcodec to decode the Adaptive Multi-Rate
  4274. Wideband audio codec. Using it requires the presence of the
  4275. libopencore-amrwb headers and library during configuration. You need to
  4276. explicitly configure the build with <code>--enable-libopencore-amrwb</code>.
  4277. </p>
  4278. <p>An FFmpeg native decoder for AMR-WB exists, so users can decode AMR-WB
  4279. without this library.
  4280. </p>
  4281. <a name="libopus"></a>
  4282. <h3 class="section">10.8 libopus<span class="pull-right"><a class="anchor hidden-xs" href="#libopus" aria-hidden="true">#</a> <a class="anchor hidden-xs"href="#toc-libopus" aria-hidden="true">TOC</a></span></h3>
  4283. <p>libopus decoder wrapper.
  4284. </p>
  4285. <p>libopus allows libavcodec to decode the Opus Interactive Audio Codec.
  4286. Requires the presence of the libopus headers and library during
  4287. configuration. You need to explicitly configure the build with
  4288. <code>--enable-libopus</code>.
  4289. </p>
  4290. <p>An FFmpeg native decoder for Opus exists, so users can decode Opus
  4291. without this library.
  4292. </p>
  4293. <a name="Subtitles-Decoders"></a>
  4294. <h2 class="chapter">11 Subtitles Decoders<span class="pull-right"><a class="anchor hidden-xs" href="#Subtitles-Decoders" aria-hidden=&