Змест
- 1 Description
- 2 Filtering Introduction
- 3 graph2dot
- 4 Filtergraph description
- 5 Timeline editing
- 6 Changing options at runtime with a command
- 7 Options for filters with several inputs (framesync)
- 8 Audio Filters
- 8.1 acompressor
- 8.2 acontrast
- 8.3 acopy
- 8.4 acrossfade
- 8.5 acrossover
- 8.6 acrusher
- 8.7 acue
- 8.8 adeclick
- 8.9 adeclip
- 8.10 adecorrelate
- 8.11 adelay
- 8.12 adenorm
- 8.13 aderivative, aintegral
- 8.14 adynamicequalizer
- 8.15 adynamicsmooth
- 8.16 aecho
- 8.17 aemphasis
- 8.18 aeval
- 8.19 aexciter
- 8.20 afade
- 8.21 afftdn
- 8.22 afftfilt
- 8.23 afir
- 8.24 aformat
- 8.25 afreqshift
- 8.26 afwtdn
- 8.27 agate
- 8.28 aiir
- 8.29 alimiter
- 8.30 allpass
- 8.31 aloop
- 8.32 amerge
- 8.33 amix
- 8.34 amultiply
- 8.35 anequalizer
- 8.36 anlmdn
- 8.37 anlmf, anlms
- 8.38 anull
- 8.39 apad
- 8.40 aphaser
- 8.41 aphaseshift
- 8.42 apsyclip
- 8.43 apulsator
- 8.44 aresample
- 8.45 areverse
- 8.46 arnndn
- 8.47 asdr
- 8.48 asetnsamples
- 8.49 asetrate
- 8.50 ashowinfo
- 8.51 asoftclip
- 8.52 aspectralstats
- 8.53 asr
- 8.54 astats
- 8.55 asubboost
- 8.56 asubcut
- 8.57 asupercut
- 8.58 asuperpass
- 8.59 asuperstop
- 8.60 atempo
- 8.61 atilt
- 8.62 atrim
- 8.63 axcorrelate
- 8.64 bandpass
- 8.65 bandreject
- 8.66 bass, lowshelf
- 8.67 biquad
- 8.68 bs2b
- 8.69 channelmap
- 8.70 channelsplit
- 8.71 chorus
- 8.72 compand
- 8.73 compensationdelay
- 8.74 crossfeed
- 8.75 crystalizer
- 8.76 dcshift
- 8.77 deesser
- 8.78 dialoguenhance
- 8.79 drmeter
- 8.80 dynaudnorm
- 8.81 earwax
- 8.82 equalizer
- 8.83 extrastereo
- 8.84 firequalizer
- 8.85 flanger
- 8.86 haas
- 8.87 hdcd
- 8.88 headphone
- 8.89 highpass
- 8.90 join
- 8.91 ladspa
- 8.92 loudnorm
- 8.93 lowpass
- 8.94 lv2
- 8.95 mcompand
- 8.96 pan
- 8.97 replaygain
- 8.98 resample
- 8.99 rubberband
- 8.100 sidechaincompress
- 8.101 sidechaingate
- 8.102 silencedetect
- 8.103 silenceremove
- 8.104 sofalizer
- 8.105 speechnorm
- 8.106 stereotools
- 8.107 stereowiden
- 8.108 superequalizer
- 8.109 surround
- 8.110 tiltshelf
- 8.111 treble, highshelf
- 8.112 tremolo
- 8.113 vibrato
- 8.114 virtualbass
- 8.115 volume
- 8.116 volumedetect
- 9 Audio Sources
- 10 Audio Sinks
- 11 Video Filters
- 11.1 addroi
- 11.2 alphaextract
- 11.3 alphamerge
- 11.4 amplify
- 11.5 ass
- 11.6 atadenoise
- 11.7 avgblur
- 11.8 bbox
- 11.9 bilateral
- 11.10 bitplanenoise
- 11.11 blackdetect
- 11.12 blackframe
- 11.13 blend
- 11.14 blockdetect
- 11.15 blurdetect
- 11.16 bm3d
- 11.17 boxblur
- 11.18 bwdif
- 11.19 cas
- 11.20 chromahold
- 11.21 chromakey
- 11.22 chromakey_cuda
- 11.23 chromanr
- 11.24 chromashift
- 11.25 ciescope
- 11.26 codecview
- 11.27 colorbalance
- 11.28 colorcontrast
- 11.29 colorcorrect
- 11.30 colorchannelmixer
- 11.31 colorize
- 11.32 colorkey
- 11.33 colorhold
- 11.34 colorlevels
- 11.35 colormap
- 11.36 colormatrix
- 11.37 colorspace
- 11.38 colortemperature
- 11.39 convolution
- 11.40 convolve
- 11.41 copy
- 11.42 coreimage
- 11.43 cover_rect
- 11.44 crop
- 11.45 cropdetect
- 11.46 cue
- 11.47 curves
- 11.48 datascope
- 11.49 dblur
- 11.50 dctdnoiz
- 11.51 deband
- 11.52 deblock
- 11.53 decimate
- 11.54 deconvolve
- 11.55 dedot
- 11.56 deflate
- 11.57 deflicker
- 11.58 dejudder
- 11.59 delogo
- 11.60 derain
- 11.61 deshake
- 11.62 despill
- 11.63 detelecine
- 11.64 dilation
- 11.65 displace
- 11.66 dnn_classify
- 11.67 dnn_detect
- 11.68 dnn_processing
- 11.69 drawbox
- 11.70 drawgraph
- 11.71 drawgrid
- 11.72 drawtext
- 11.73 edgedetect
- 11.74 elbg
- 11.75 entropy
- 11.76 epx
- 11.77 eq
- 11.78 erosion
- 11.79 estdif
- 11.80 exposure
- 11.81 extractplanes
- 11.82 fade
- 11.83 feedback
- 11.84 fftdnoiz
- 11.85 fftfilt
- 11.86 field
- 11.87 fieldhint
- 11.88 fieldmatch
- 11.89 fieldorder
- 11.90 fifo, afifo
- 11.91 fillborders
- 11.92 find_rect
- 11.93 floodfill
- 11.94 format
- 11.95 fps
- 11.96 framepack
- 11.97 framerate
- 11.98 framestep
- 11.99 freezedetect
- 11.100 freezeframes
- 11.101 frei0r
- 11.102 fspp
- 11.103 gblur
- 11.104 geq
- 11.105 gradfun
- 11.106 graphmonitor
- 11.107 grayworld
- 11.108 greyedge
- 11.109 guided
- 11.110 haldclut
- 11.111 hflip
- 11.112 histeq
- 11.113 histogram
- 11.114 hqdn3d
- 11.115 hwdownload
- 11.116 hwmap
- 11.117 hwupload
- 11.118 hwupload_cuda
- 11.119 hqx
- 11.120 hstack
- 11.121 hsvhold
- 11.122 hsvkey
- 11.123 hue
- 11.124 huesaturation
- 11.125 hysteresis
- 11.126 iccdetect
- 11.127 iccgen
- 11.128 identity
- 11.129 idet
- 11.130 il
- 11.131 inflate
- 11.132 interlace
- 11.133 kerndeint
- 11.134 kirsch
- 11.135 lagfun
- 11.136 lenscorrection
- 11.137 lensfun
- 11.138 libplacebo
- 11.139 libvmaf
- 11.140 limitdiff
- 11.141 limiter
- 11.142 loop
- 11.143 lut1d
- 11.144 lut3d
- 11.145 lumakey
- 11.146 lut, lutrgb, lutyuv
- 11.147 lut2, tlut2
- 11.148 maskedclamp
- 11.149 maskedmax
- 11.150 maskedmerge
- 11.151 maskedmin
- 11.152 maskedthreshold
- 11.153 maskfun
- 11.154 mcdeint
- 11.155 median
- 11.156 mergeplanes
- 11.157 mestimate
- 11.158 midequalizer
- 11.159 minterpolate
- 11.160 mix
- 11.161 monochrome
- 11.162 morpho
- 11.163 mpdecimate
- 11.164 msad
- 11.165 multiply
- 11.166 negate
- 11.167 nlmeans
- 11.168 nnedi
- 11.169 noformat
- 11.170 noise
- 11.171 normalize
- 11.172 null
- 11.173 ocr
- 11.174 ocv
- 11.175 oscilloscope
- 11.176 overlay
- 11.177 overlay_cuda
- 11.178 owdenoise
- 11.179 pad
- 11.180 palettegen
- 11.181 paletteuse
- 11.182 perspective
- 11.183 phase
- 11.184 photosensitivity
- 11.185 pixdesctest
- 11.186 pixelize
- 11.187 pixscope
- 11.188 pp
- 11.189 pp7
- 11.190 premultiply
- 11.191 prewitt
- 11.192 pseudocolor
- 11.193 psnr
- 11.194 pullup
- 11.195 qp
- 11.196 random
- 11.197 readeia608
- 11.198 readvitc
- 11.199 remap
- 11.200 removegrain
- 11.201 removelogo
- 11.202 repeatfields
- 11.203 reverse
- 11.204 rgbashift
- 11.205 roberts
- 11.206 rotate
- 11.207 sab
- 11.208 scale
- 11.209 scale_cuda
- 11.210 scale_npp
- 11.211 scale2ref
- 11.212 scale2ref_npp
- 11.213 scharr
- 11.214 scroll
- 11.215 scdet
- 11.216 selectivecolor
- 11.217 separatefields
- 11.218 setdar, setsar
- 11.219 setfield
- 11.220 setparams
- 11.221 sharpen_npp
- 11.222 shear
- 11.223 showinfo
- 11.224 showpalette
- 11.225 shuffleframes
- 11.226 shufflepixels
- 11.227 shuffleplanes
- 11.228 signalstats
- 11.229 signature
- 11.230 siti
- 11.231 smartblur
- 11.232 sobel
- 11.233 spp
- 11.234 sr
- 11.235 ssim
- 11.236 stereo3d
- 11.237 streamselect, astreamselect
- 11.238 subtitles
- 11.239 super2xsai
- 11.240 swaprect
- 11.241 swapuv
- 11.242 tblend
- 11.243 telecine
- 11.244 thistogram
- 11.245 threshold
- 11.246 thumbnail
- 11.247 tile
- 11.248 tinterlace
- 11.249 tmedian
- 11.250 tmidequalizer
- 11.251 tmix
- 11.252 tonemap
- 11.253 tpad
- 11.254 transpose
- 11.255 transpose_npp
- 11.256 trim
- 11.257 unpremultiply
- 11.258 unsharp
- 11.259 untile
- 11.260 uspp
- 11.261 v360
- 11.262 vaguedenoiser
- 11.263 varblur
- 11.264 vectorscope
- 11.265 vidstabdetect
- 11.266 vidstabtransform
- 11.267 vflip
- 11.268 vfrdet
- 11.269 vibrance
- 11.270 vif
- 11.271 vignette
- 11.272 vmafmotion
- 11.273 vstack
- 11.274 w3fdif
- 11.275 waveform
- 11.276 weave, doubleweave
- 11.277 xbr
- 11.278 xcorrelate
- 11.279 xfade
- 11.280 xmedian
- 11.281 xstack
- 11.282 yadif
- 11.283 yadif_cuda
- 11.284 yaepblur
- 11.285 zoompan
- 11.286 zscale
- 12 OpenCL Video Filters
- 12.1 avgblur_opencl
- 12.2 boxblur_opencl
- 12.3 colorkey_opencl
- 12.4 convolution_opencl
- 12.5 erosion_opencl
- 12.6 deshake_opencl
- 12.7 dilation_opencl
- 12.8 nlmeans_opencl
- 12.9 overlay_opencl
- 12.10 pad_opencl
- 12.11 prewitt_opencl
- 12.12 program_opencl
- 12.13 remap_opencl
- 12.14 roberts_opencl
- 12.15 sobel_opencl
- 12.16 tonemap_opencl
- 12.17 unsharp_opencl
- 12.18 xfade_opencl
- 13 VAAPI Video Filters
- 14 Video Sources
- 14.1 buffer
- 14.2 cellauto
- 14.3 coreimagesrc
- 14.4 gradients
- 14.5 mandelbrot
- 14.6 mptestsrc
- 14.7 frei0r_src
- 14.8 life
- 14.9 allrgb, allyuv, color, colorchart, colorspectrum, haldclutsrc, nullsrc, pal75bars, pal100bars, rgbtestsrc, smptebars, smptehdbars, testsrc, testsrc2, yuvtestsrc
- 14.10 openclsrc
- 14.11 sierpinski
- 15 Video Sinks
- 16 Multimedia Filters
- 16.1 abitscope
- 16.2 adrawgraph
- 16.3 agraphmonitor
- 16.4 ahistogram
- 16.5 aphasemeter
- 16.6 avectorscope
- 16.7 bench, abench
- 16.8 concat
- 16.9 ebur128
- 16.10 interleave, ainterleave
- 16.11 latency, alatency
- 16.12 metadata, ametadata
- 16.13 perms, aperms
- 16.14 realtime, arealtime
- 16.15 segment, asegment
- 16.16 select, aselect
- 16.17 sendcmd, asendcmd
- 16.18 setpts, asetpts
- 16.19 setrange
- 16.20 settb, asettb
- 16.21 showcqt
- 16.22 showfreqs
- 16.23 showspatial
- 16.24 showspectrum
- 16.25 showspectrumpic
- 16.26 showvolume
- 16.27 showwaves
- 16.28 showwavespic
- 16.29 sidedata, asidedata
- 16.30 spectrumsynth
- 16.31 split, asplit
- 16.32 zmq, azmq
- 17 Multimedia Sources
- 18 See Also
- 19 Authors
1 Description
У гэтым дакуменце апісваюцца фільтры, крыніцы і прыёмнікі, прадстаўленыя бібліятэкай libavfilter.
2 Filtering Introduction
Фільтраванне ў FFmpeg уключана праз бібліятэку libavfilter.
У libavfilter фільтр можа мець некалькі ўваходаў і некалькі выхадаў. Каб праілюстраваць усё, што магчыма, мы разгледзім наступны фільтр.
[галоўная] увод --> раздзяленне ---------------------> накладанне --> вывад | ^ |[tmp] [перавярнуць]| +-----> абрэзка --> vflip -------+
Гэты фільтраграм раздзяляе ўваходны паток на два патокі, затым адпраўляе адзін паток праз фільтр абрэзкі і фільтр vflip, перш чым аб'яднаць яго з іншым патокам, наклаўшы яго зверху. Вы можаце выкарыстоўваць наступную каманду, каб дасягнуць гэтага:
ffmpeg -i INPUT -vf "split [main][tmp]; [tmp] crop=iw:ih/2:0:0, vflip [flip]; [main][flip] overlay=0:H/2" OUTPUT
У выніку верхняя палова відэа адлюстроўваецца ў ніжняй палове выхаднога відэа.
Фільтры ў адной лінейнай ланцужку падзяляюцца коскамі, а розныя лінейныя ланцужкі фільтраў - кропкай з коскай. У нашым прыкладзе
crop,vflip
знаходзяцца ў адной лінейнай ланцугу, split
а
overlay
паасобку ў другой. Пункты злучэння лінейных ланцужкоў пазначаны назвамі ў квадратных дужках. У прыкладзе раздзяляльны фільтр стварае два выхады, звязаныя з цэтлікамі [main]
і [tmp]
.
Паток, які адпраўляецца на другі выхад split
, пазначаны як
[tmp]
, апрацоўваецца праз crop
фільтр, які абразае ніжнюю палову відэа, а затым вертыкальна перагортваецца. Фільтр
overlay
прымае на ўваход першы нязменны выхад раздзяленага фільтра (які быў пазначаны як [main]
), і накладвае на яго ніжнюю палову выхад, створаны crop,vflip
ланцугом фільтраў.
Некаторыя фільтры прымаюць на ўваходзе спіс параметраў: яны ўказваюцца пасля назвы фільтра і знака роўнасці і аддзяляюцца адзін ад аднаго двукроп'ем.
Існуюць так званыя source filters
, якія не маюць аўдыё/відэа ўваходу і sink filters
не маюць аўдыё/відэа выхаду.
3 graph2dot
Thegraph2dot
Праграма, якая ўваходзіць у FFmpegtools
можа быць выкарыстаны для аналізу апісання фільтра і выдачы адпаведнага тэкставага прадстаўлення на мове кропак.
Выклік каманды:
graph2dot -h
каб убачыць, як выкарыстоўвацьgraph2dot
.
Затым вы можаце перадаць апісанне кропкі ўdot
праграму (з набору праграм graphviz) і атрымаць графічнае прадстаўленне фільтра.
Напрыклад, паслядоўнасць каманд:
echo GRAPH_DESCRIPTION
| \
tools/graph2dot -o graph.tmp && \
dot -Tpng graph.tmp -o graph.png && \
display graph.png
можа выкарыстоўвацца для стварэння і адлюстравання выявы, якая прадстаўляе граф, апісаны GRAPH_DESCRIPTION
радком. Звярніце ўвагу, што гэты радок павінен быць поўным самадастатковым графам з выразна вызначанымі ўваходамі і выхадамі. Напрыклад, калі ваш камандны радок мае выгляд:
ffmpeg -i infile -vf scale=640:360 outfile
ваш GRAPH_DESCRIPTION
радок павінен мець выгляд:
nullsrc,scale=640:360,nullsink
вам таксама можа спатрэбіцца ўсталяваць nullsrc
параметры і дадаць format
фільтр, каб імітаваць пэўны ўваходны файл.
4 Filtergraph description
Фільтрграф - гэта арыентаваны граф звязаных фільтраў. Ён можа ўтрымліваць цыклы, і можа быць некалькі сувязяў паміж парай фільтраў. Кожнае звяно мае адну ўваходную пляцоўку з аднаго боку, якая злучае яе з адным фільтрам, ад якога яна прымае ўваход, і адну выходную пляцоўку з другога боку, якая злучае яе з адным фільтрам, які прымае яго выхад.
Кожны фільтр у графе фільтра з'яўляецца асобнікам класа фільтра, зарэгістраванага ў дадатку, які вызначае функцыі і колькасць уваходных і выходных пляцовак фільтра.
Фільтр без уваходных пляцовак называецца "крыніцай", а фільтр без выходных пляцовак - "прыёмнікам".
4.1 Filtergraph syntax
Граф фільтра мае тэкставае прадстаўленне, якое распазнаецца
-filter
/-vf
/-af
і
-filter_complex
варыянты ў ffmpeg
і
-vf
/-af
у ffplay
, і з дапамогай
avfilter_graph_parse_ptr()
функцыі, вызначанай у
libavfilter/avfilter.h
.
Ланцужок фільтраў складаецца з паслядоўнасці злучаных фільтраў, кожны з якіх звязаны з папярэднім у паслядоўнасці. Ланцужок фільтраў прадстаўлены спісам апісанняў фільтраў, падзеленых ",".
Фільтрграф складаецца з паслядоўнасці ланцугоў фільтраў. Паслядоўнасць ланцугоў фільтраў прадстаўлена спісам апісанняў ланцугоў фільтраў, падзеленых знакам ";".
Фільтр прадстаўлены радком выгляду: [ in_link_1
]...[ in_link_N
] filter_name
@ id
= arguments
[ out_link_1
]...[ out_link_M
]
filter_name
гэта імя класа фільтраў, экзэмплярам якога з'яўляецца апісаны фільтр, і павінна быць імем аднаго з класаў фільтраў, зарэгістраваных у праграме, за якім, магчыма, варта "@ id
". Імя класа фільтра неабавязкова суправаджаецца радком "= arguments
".
arguments
гэта радок, які змяшчае параметры, якія выкарыстоўваюцца для ініцыялізацыі асобніка фільтра. Ён можа мець адну з двух формаў:
- Спіс
key=value
пар, падзелены ':'. - Спіс, падзелены ':'
value
. У гэтым выпадку мяркуецца, што ключы з'яўляюцца імёнамі опцый у парадку іх аб'яўлення. Напрыклад,fade
фільтр дэкларуе тры варыянты ў такім парадку -type
,start_frame
іnb_frames
. Тады спіс параметраўin:0:30
азначае, штоin
опцыі прысвоена значэннеtype
,0
кабstart_frame
і30
даnb_frames
. - Спіс змешаных прамых
value
і доўгіхkey=value
пар, падзелены ':'. Прамыvalue
павінен папярэднічацьkey=value
парам і прытрымлівацца таго ж парадку абмежаванняў, што і ў папярэднім пункце. Наступныяkey=value
пары можна ўсталяваць у любым патрэбным парадку.
Калі само значэнне опцыі ўяўляе сабой спіс элементаў (напрыклад, format
фільтр прымае спіс фарматаў пікселяў), элементы ў спісе звычайна падзяляюцца знакам '|
'.
Спіс аргументаў можа быць заключаны ў цытаты з дапамогай сімвала ''
' як пачатковы і канчатковы знак, а таксама сімвал '\
' для экраніравання сімвалаў у цытаваным тэксце; у адваротным выпадку радок аргументу лічыцца завершаным, калі наступны спецыяльны сімвал (належыць да набору '[]=;,
') сустракаецца.
Назва і аргументы фільтра неабавязкова папярэднічаюць і суправаджаюцца спісам метак спасылак. Метка спасылкі дазваляе назваць спасылку і звязаць яе з выхадам фільтра або ўводам. Папярэднія этыкеткі in_link_1
... in_link_N
, звязаныя з уваходнымі пляцоўкамі фільтра, наступныя этыкеткі out_link_1
... out_link_M
, звязаныя з выходнымі пляцоўкамі.
Калі дзве цэтлікі спасылак з аднолькавым імем знойдзены ў фільтравальнай графе, ствараецца сувязь паміж адпаведнай пляцоўкай уводу і вываду.
Калі выхадная пляцоўка не пазначана, яна па змаўчанні звязана з першай непазначанай уваходнай пляцоўкай наступнага фільтра ў ланцужку фільтраў. Напрыклад, у ланцужку фільтраў
nullsrc, split[L1], [L2]overlay, nullsink
экзэмпляр раздзеленага фільтра мае дзве выходныя пляцоўкі, а асобнік накладнога фільтра - дзве ўваходныя пляцоўкі. Першая выхадная пляцоўка падзелу пазначана "L1", першая ўваходная пляцоўка накладання пазначана "L2", а другая выходная пляцоўка падзелу звязана з другой уваходнай пляцоўкай накладання, абедзве не пазначаныя.
У апісанні фільтра, калі ўваходны ярлык першага фільтра не ўказаны, мяркуецца "ў"; калі метка вываду апошняга фільтра не ўказана, мяркуецца "out".
У поўнай ланцужку фільтраў усе ўваходныя і выходныя пляцоўкі фільтра без маркіроўкі павінны быць падлучаны. Граф фільтра лічыцца сапраўдным, калі ўсе ўваходныя і выходныя пляцоўкі фільтраў усіх ланцужкоў фільтраў злучаны.
Libavfilter аўтаматычна ўставіць маштабныя фільтры там, дзе патрабуецца пераўтварэнне фармату. Можна пазначыць сцягі swscale для аўтаматычна ўстаўленых маштабавальнікаў, дадаўшы
іх да апісання фільтра.
sws_flags=
flags
;
Вось апісанне BNF сінтаксісу filtergraph:
NAME
::= sequence of alphanumeric characters and '_'
FILTER_NAME
::= NAME
["@"NAME
]
LINKLABEL
::= "[" NAME
"]"
LINKLABELS
::= LINKLABEL
[LINKLABELS
]
FILTER_ARGUMENTS
::= sequence of chars (possibly quoted)
FILTER
::= [LINKLABELS
] FILTER_NAME
["=" FILTER_ARGUMENTS
] [LINKLABELS
]
FILTERCHAIN
::= FILTER
[,FILTERCHAIN
]
FILTERGRAPH
::= [sws_flags=flags
;] FILTERCHAIN
[;FILTERGRAPH
]
4.2 Notes on filtergraph escaping
Кампазіцыя апісання фільтра прадугледжвае некалькі ўзроўняў экраніравання. Глядзіце (ffmpeg-utils) раздзел «Цытаванне і экранаванне» ў кіраўніцтве ffmpeg-utils(1) для атрымання дадатковай інфармацыі аб выкарыстоўванай працэдуры экраніравання.
Экранаванне першага ўзроўню ўплывае на змест кожнага значэння опцыі фільтра, якое можа ўтрымліваць спецыяльны сімвал, :
які выкарыстоўваецца для падзелу значэнняў, або адзін з экраніраваных сімвалаў \'
.
Экранаванне другога ўзроўню ўплывае на ўсё апісанне фільтра, якое можа ўтрымліваць экраніраваныя сімвалы \'
або спецыяльныя сімвалы [],;
, якія выкарыстоўваюцца ў апісанні фільтра.
Нарэшце, калі вы задаеце графік фільтра ў камандным радку абалонкі, вам трэба выканаць экраніраванне трэцяга ўзроўню для спецыяльных сімвалаў абалонкі, якія змяшчаюцца ў ім.
Напрыклад, разгледзім наступны радок, які будзе ўбудаваны ў апісанне фільтра drawtexttext
значэнне:
this is a 'string': may contain one, or more, special characters
Гэты радок змяшчае '
спецыяльны сімвал экраніравання і
:
спецыяльны сімвал, таму яго трэба экранаваць наступным чынам:
text=this is a \'string\'\: may contain one, or more, special characters
Другі ўзровень экраніравання патрабуецца пры ўбудаванні апісання фільтра ў апісанне filtergraph, каб экранаваць усе спецыяльныя сімвалы filtergraph. Такім чынам, прыклад вышэй становіцца:
drawtext=text=this is a \\\'string\\\'\\: may contain one\, or more\, special characters
(звярніце ўвагу, што ў дадатак да \'
экраніраваных спецыяльных сімвалаў таксама ,
трэба экранаваць).
Нарэшце, пры напісанні апісання фільтраграфа ў камандзе абалонкі неабходны дадатковы ўзровень экраніравання, які залежыць ад правілаў экраніравання прынятай абалонкі. Напрыклад, калі выказаць здагадку, што
\
з'яўляецца асаблівым і яго трэба экранаваць з дапамогай another \
, папярэдні радок нарэшце прывядзе да:
-vf "drawtext=text=this is a \\\\\\'string\\\\\\'\\\\: may contain one\\, or more\\, special characters"
5 Timeline editing
Некаторыя фільтры падтрымліваюць агульныяenable
варыянт. Для фільтраў, якія падтрымліваюць рэдагаванне часовай шкалы, гэты параметр можа быць усталяваны ў выраз, які вылічваецца перад адпраўкай кадра ў фільтр. Калі ацэнка не роўная нулю, фільтр будзе ўключаны, у адваротным выпадку кадр будзе адпраўлены без змен да наступнага фільтра ў графе фільтраў.
Выраз прымае наступныя значэнні:
- '
t
' пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая
- '
n
' парадкавы нумар уваходнага кадра, пачынаючы з 0
- '
pos
' пазіцыя ў файле ўваходнага кадра, NAN, калі невядома
- '
w
' - '
h
' шырыня і вышыня ўваходнага кадра, калі відэа
Акрамя таго, гэтыя фільтры падтрымліваюць anenable
каманда, якую можна выкарыстоўваць для перавызначэння выразу.
Як і любы іншы варыянт фільтрацыі,enable
варыянт прытрымліваецца тых жа правілаў.
Напрыклад, каб уключыць фільтр размыцця ( smartblur ) ад 10 секунд да 3 хвілін і фільтр крывых , пачынаючы з 3 секунд:
smartblur = enable='between(t,10,3*60)',
curves = enable='gte(t,3)' : preset=cross_process
Глядзіце ffmpeg -filters
, якія фільтры падтрымліваюць шкалу часу.
6 Changing options at runtime with a command
Некаторыя параметры можна змяніць падчас працы фільтра з дапамогай каманды. Гэтыя параметры пазначаны 'T' на выхадзе
ffmpeg
-h filter=<name of filter>
. Імя каманды - гэта імя опцыі, а аргумент - новае значэнне.
7 Options for filters with several inputs (framesync)
Некаторыя фільтры з некалькімі ўваходамі падтрымліваюць агульны набор параметраў. Гэтыя параметры можна задаць толькі па назве, а не з дапамогай кароткага запісу.
eof_action
Дзеянне, якое неабходна выканаць, калі EOF сустракаецца на другасным уводзе; ён прымае адно з наступных значэнняў:
repeat
Паўтарыць апошні кадр (па змаўчанні).
endall
Скончыце абодва патокі.
pass
Прапусціце асноўны ўваход.
shortest
Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.
repeatlast
Калі ўстаноўлена значэнне 1, фільтр прымушае пашыраць апошні кадр другасных патокаў да канца асноўнага патоку. Значэнне 0 адключае гэтыя паводзіны. Значэнне па змаўчанні - 1.
8 Audio Filters
Калі вы наладжваеце зборку FFmpeg, вы можаце адключыць любы з існуючых фільтраў з дапамогай --disable-filters
. Выхад канфігурацыі пакажа гукавыя фільтры, уключаныя ў вашу зборку.
Ніжэй прыводзіцца апісанне даступных у цяперашні час аўдыяфільтраў.
8.1 acompressor
Кампрэсар у асноўным выкарыстоўваецца для памяншэння дынамічнага дыяпазону сігналу. Асабліва сучасная музыка ў асноўным сціскаецца з высокім каэфіцыентам для паляпшэння агульнай гучнасці. Гэта робіцца для таго, каб прыцягнуць максімальную ўвагу слухача, «накарміць» гук і надаць трэку большай «моцы». Калі сігнал сціскаецца занадта моцна, пасля гэтага ён можа гучаць глуха ці «мёртвым» або можа пачаць «пампавацца» (што можа быць моцным эфектам, але можа цалкам разбурыць трэк). Правільнае сцісканне з'яўляецца ключом да дасягнення прафесійнага гуку і з'яўляецца высокім мастацтвам звядзення і мастэрынгу. З-за яго складаных налад можа спатрэбіцца шмат часу, каб атрымаць правільнае адчуванне такога эфекту.
Сцісканне ажыццяўляецца шляхам вызначэння гучнасці вышэй за абраны ўзровень
threshold
і дзялення яго на каэфіцыент, зададзены з дапамогай ratio
. Такім чынам, калі вы ўсталюеце парог -12 дБ і ваш сігнал дасягае -6 дБ, стаўленне 2:1 прывядзе да сігналу на -9 дБ. Паколькі дакладная маніпуляцыя сігналам прывядзе да скажэння формы сігналу, зніжэнне можа быць выраўнавана з часам. Гэта робіцца шляхам налады «Атака» і «Адпусканне».
attack
вызначае, як доўга сігнал павінен падымацца вышэй парогавага значэння, перш чым адбудзецца любое зніжэнне, і release
задае час, на працягу якога сігнал павінен апусціцца ніжэй парогавага значэння, каб зноў паменшыць зніжэнне. Больш кароткія сігналы, чым выбраны час атакі, застануцца некранутымі. Агульнае зніжэнне сігналу можна кампенсаваць пасля з дапамогай
makeup
ўстаноўка. Такім чынам, сціскаючы пікі сігналу прыкладна на 6 дБ і падымаючы макіяж да гэтага ўзроўню, сігнал атрымліваецца ў два разы гучней, чым крыніца. Для атрымання больш мяккага запісу ў сціску knee
цвёрды край згладжваецца на парозе ў дыяпазоне абраных дэцыбел.
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.
mode
Ўсталяваць рэжым працы кампрэсара. Можа быць
upward
абоdownward
. Па змаўчанніdownward
.threshold
Калі сігнал патоку падымаецца вышэй за гэты ўзровень, гэта паўплывае на зніжэнне ўзмацнення. Па змаўчанні гэта 0,125. Дыяпазон ад 0,00097563 да 1.
ratio
Усталюйце каэфіцыент паніжэння сігналу. 1:2 азначае, што калі ўзровень падняўся на 4 дБ вышэй парога, то пасля зніжэння ён будзе вышэй толькі на 2 дБ. Па змаўчанні - 2. Дыяпазон - ад 1 да 20.
attack
Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым пачнецца зніжэнне ўзмацнення. Па змаўчанні - 20. Дыяпазон - ад 0,01 да 2000.
release
Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў паменшыцца. Па змаўчанні - 250. Дыяпазон - ад 0,01 да 9000.
makeup
Усталюйце колькасць, наколькі сігнал будзе ўзмоцнены пасля апрацоўкі. Па змаўчанні 1. Дыяпазон ад 1 да 64.
knee
Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,82843. Дыяпазон ад 1 да 8.
link
Выберыце, калі
average
ўзровень паміж усімі каналамі ўваходнага патоку ці больш гучны (maximum
) канал уваходнага патоку ўплывае на зніжэнне. Па змаўчанніaverage
.detection
Калі браць дакладны сігнал у выпадку
peak
або RMS ў выпадкуrms
. Па змаўчанні - гэта тоеrms
, што больш гладка.mix
Колькі выкарыстоўваць сціснуты сігнал у вывадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
8.1.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.2 acontrast
Просты фільтр сціску/пашырэння дынамічнага дыяпазону гуку.
Фільтр прымае наступныя параметры:
contrast
Усталюйце кантраст. Па змаўчанні - 33. Дазволены дыяпазон ад 0 да 100.
8.3 acopy
Скапіруйце крыніцу ўваходнага гуку без зменаў на выхад. Гэта ў асноўным карысна для тэставання.
8.4 acrossfade
Прымяненне крыжаванага знікнення ад аднаго ўваходнага аўдыяпатоку да іншага ўваходнага аўдыяпатоку. Перакрыжаванае знікненне прымяняецца на вызначаны час у канцы першага патоку.
Фільтр прымае наступныя параметры:
nb_samples, ns
Укажыце колькасць узораў, для якіх павінен працягвацца эфект перакрыжаванага знікнення. У канцы эфекту перакрыжаванага знікнення першы ўваходны гук будзе цалкам бясшумным. Па змаўчанні 44100.
duration, d
Укажыце працягласць эфекту перакрыжаванага знікнення. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Па змаўчанні працягласць вызначаецца
nb_samples
. Калі ўсталяваны, гэты параметр выкарыстоўваецца заместnb_samples
.overlap, o
Калі канец першага патоку перакрываецца з пачаткам другога патоку. Па змаўчанні ўключана.
curve1
Усталюйце крывую для пераходу з знікненнем для першага патоку.
curve2
Усталюйце крывую для пераходу з знікненнем для другога патоку.
Для апісання даступных тыпаў крывых глядзіце апісанне фільтра afade .
8.4.1 Examples
- Перакрыжаванае знікненне ад аднаго ўваходу да іншага:
ffmpeg -i first.flac -i second.flac -filter_complex acrossfade=d=10:c1=exp:c2=exp output.flac
- Перакрыжаванае знікненне ад аднаго ўваходу да іншага, але без накладання:
ffmpeg -i first.flac -i second.flac -filter_complex acrossfade=d=10:o=0:c1=exp:c2=exp output.flac
8.5 acrossover
Падзяліць аўдыяструмень на некалькі палос.
Гэты фільтр падзяляе аўдыяпаток на два ці больш дыяпазонаў частот. Сумаванне ўсіх патокаў назад дасць роўны вынік.
Фільтр прымае наступныя параметры:
split
Усталюйце раздзяляльныя частоты. Яны павінны быць пазітыўнымі і расці.
order
Усталюйце парадак фільтра для кожнага падзелу дыяпазону. Гэта кантралюе спад фільтра або крутасць функцыі перадачы фільтра. Даступныя значэнні:
- '
2nd
' 12 дБ на актаву.
- '
4th
' 24 дБ на актаву.
- '
6th
' 36 дБ на актаву.
- '
8th
' 48 дБ на актаву.
- '
10th
' 60 дБ на актаву.
- '
12th
' 72 дБ на актаву.
- '
14th
' 84 дБ на актаву.
- '
16th
' 96 дБ на актаву.
- '
18th
' 108 дБ на актаву.
- '
20th
' 120 дБ на актаву.
Па змаўчанні
4th
.- '
level
Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
gains
Усталюйце ўзмацненне выхаду для кожнай паласы. Значэнне па змаўчанні - 1 для ўсіх дыяпазонаў.
precision
Усталюйце, якую дакладнасць выкарыстоўваць пры апрацоўцы ўзораў.
auto
Аўтаматычны выбар унутранага фармату выбаркі ў залежнасці ад іншых фільтраў.
float
Заўсёды выкарыстоўвайце фармат выбаркі з адной плаваючай кропкай.
double
Заўсёды выкарыстоўвайце фармат выбаркі з падвойнай плаваючай кропкай.
Значэнне па змаўчанні -
auto
.
8.5.1 Examples
- Падзяліць уваходны аўдыяпаток на два дыяпазоны (нізкі і высокі) з частатой падзелу 1500 Гц, кожны дыяпазон будзе ў асобным патоку:
ffmpeg -i in.flac -filter_complex 'acrossover=split=1500[LOW][HIGH]' -map '[LOW]' low.wav -map '[HIGH]' high.wav
- Тое самае, што і вышэй, але з больш высокім парадкам фільтра:
ffmpeg -i in.flac -filter_complex 'acrossover=split=1500:order=8th[LOW][HIGH]' -map '[LOW]' low.wav -map '[HIGH]' high.wav
- Тое самае, што і вышэй, але таксама з дадатковым сярэднім дыяпазонам (частоты паміж 1500 і 8000):
ffmpeg -i in.flac -filter_complex 'acrossover=split=1500 8000:order=8th[LOW][MID][HIGH]' -map '[LOW]' low.wav -map '[MID]' mid.wav -map '[HIGH]' high.wav
8.6 acrusher
Паменшыць бітнае раздзяленне гуку.
Гэты фільтр з'яўляецца драбнілкай біт з пашыранай функцыянальнасцю. Драбнільнік бітаў выкарыстоўваецца для слыхавога памяншэння колькасці біт, з дапамогай якіх адбываецца выбарка гукавога сігналу. Гэта зусім не змяняе бітавай глыбіні, а проста стварае эфект. Паменшаны ў разраднасці матэрыял гучыць больш жорстка і «лічбава». Гэты фільтр здольны нават акругляць да бесперапынных значэнняў замест дыскрэтнай глыбіні бітаў. Акрамя таго, ён мае D/C зрушэнне, якое прыводзіць да рознага драбнення ніжняй і верхняй паловы сігналу. Параметр Anti-Aliasing можа ствараць больш «мяккія» рэзкія гукі.
Яшчэ адна асаблівасць гэтага фільтра - лагарыфмічны рэжым. Гэты параметр пераключае лінейныя адлегласці паміж бітамі на лагарыфмічныя. У выніку атрымліваецца значна больш "натуральнае" гучанне драбнілкі, якая, напрыклад, не перакрывае нізкія сігналы. Чалавечае вуха валодае лагарыфмічным ўспрыманнем, таму такое драбненне нашмат прыемней. Лагарыфмічнае драбненне таксама можа атрымаць згладжванне.
Фільтр прымае наступныя параметры:
level_in
Усталюйце ўзровень.
level_out
Усталюйце ўзровень.
bits
Усталяваць памяншэнне бітаў.
mix
Усталюйце колькасць змешвання.
mode
Можа быць лінейным:
lin
або лагарыфмічным:log
.dc
Усталюйце DC.
aa
Усталюйце згладжванне.
samples
Усталяваць скарачэнне ўзору.
lfo
Уключыць LFO. Па змаўчанні адключана.
lforange
Усталюйце дыяпазон LFO.
lforate
Усталюйце хуткасць LFO.
8.6.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.7 acue
Затрымка фільтрацыі гуку да дадзенай меткі часу насценнага гадзінніка. Глядзіце фільтр рэплікі.
8.8 adeclick
Выдаліць імпульсіўны шум з уваходнага аўдыя.
Узоры, выяўленыя як імпульсіўны шум, замяняюцца інтэрпаляванымі ўзорамі з выкарыстаннем аўтарэгрэсіўнага мадэлявання.
window, w
Задаць памер акна ў мілісекундах. Дазволены дыяпазон ад
10
да100
. Значэнне па змаўчанні -55
мілісекунды. Гэта задае памер акна, якое будзе апрацоўвацца адначасова.overlap, o
Задаць перакрыцце вокнаў у працэнтах ад памеру акна. Дазволены дыяпазон ад
50
да95
. Значэнне па змаўчанні -75
працэнт. Усталяванне вельмі высокага значэння павялічвае выдаленне імпульснага шуму, але значна запавольвае ўвесь працэс.arorder, a
Усталюйце парадак аўтарэгрэсіі ў працэнтах ад памеру акна. Дазволены дыяпазон ад
0
да25
. Значэнне па змаўчанні -2
працэнт. Гэты параметр таксама кантралюе якасць інтэрпаляваных узораў з выкарыстаннем суседніх добрых узораў.threshold, t
Усталюйце парогавае значэнне. Дазволены дыяпазон ад
1
да100
. Значэнне па змаўчанні -2
. Гэта кантралюе сілу імпульснага шуму, які будзе выдалены. Чым меншае значэнне, тым больш узораў будзе вызначана як імпульсны шум.burst, b
Задаць пакетнае аб'яднанне ў працэнтах ад памеру акна. Дазволены дыяпазон
0
да10
. Значэнне па змаўчанні -2
. Калі любыя дзве выбаркі, выяўленыя як шум, размешчаны менш, чым гэта значэнне, любая выбарка паміж гэтымі двума выбаркамі таксама будзе вызначана як шум.method, m
Усталюйце метад перакрыцця.
Ён прымае наступныя значэнні:
add, a
Выберыце спосаб дадання перакрыцця. Нават неинтерполированные выбаркі нязначна змяняюцца з дапамогай гэтага метаду.
save, s
Выберыце метад захавання перакрыцця. Неінтэрпаляваныя выбаркі застаюцца нязменнымі.
Значэнне па змаўчанні -
a
.
8.9 adeclip
Выдаліць абрэзаныя ўзоры з уваходнага аўдыя.
Узоры, выяўленыя як абрэзаныя, замяняюцца інтэрпаляванымі ўзорамі з выкарыстаннем аўтарэгрэсіўнага мадэлявання.
window, w
Задаць памер акна ў мілісекундах. Дазволены дыяпазон ад
10
да100
. Значэнне па змаўчанні -55
мілісекунды. Гэта задае памер акна, якое будзе апрацоўвацца адначасова.overlap, o
Задаць перакрыцце вокнаў у працэнтах ад памеру акна. Дазволены дыяпазон ад
50
да95
. Значэнне па змаўчанні -75
працэнт.arorder, a
Усталюйце парадак аўтарэгрэсіі ў працэнтах ад памеру акна. Дазволены дыяпазон ад
0
да25
. Значэнне па змаўчанні -8
працэнт. Гэты параметр таксама кантралюе якасць інтэрпаляваных узораў з выкарыстаннем суседніх добрых узораў.threshold, t
Усталюйце парогавае значэнне. Дазволены дыяпазон ад
1
да100
. Значэнне па змаўчанні -10
. Больш высокія значэнні робяць выяўленне кліпаў менш агрэсіўным.hsize, n
Задаць памер гістаграмы, якая выкарыстоўваецца для выяўлення кліпаў. Дазволены дыяпазон ад
100
да9999
. Значэнне па змаўчанні -1000
. Больш высокія значэнні робяць выяўленне кліпаў менш агрэсіўным.method, m
Усталюйце метад перакрыцця.
Ён прымае наступныя значэнні:
add, a
Выберыце спосаб дадання перакрыцця. Нават неинтерполированные выбаркі нязначна змяняюцца з дапамогай гэтага метаду.
save, s
Выберыце метад захавання перакрыцця. Неінтэрпаляваныя выбаркі застаюцца нязменнымі.
Значэнне па змаўчанні -
a
.
8.10 adecorrelate
Прымяніць дэкарэляцыю да ўваходнага аўдыяпатоку.
Фільтр прымае наступныя параметры:
stages
Задаць дэкарэляцыйныя этапы фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 6.
seed
Устанавіць выпадковае пачатковае значэнне, якое выкарыстоўваецца для ўстанаўлення затрымкі ў выбарках па каналах.
8.11 adelay
Затрымка аднаго або некалькіх аўдыяканалаў.
Сэмплы ў канале з затрымкай напоўнены цішынёй.
Фільтр прымае наступныя параметры:
delays
Усталяваць спіс затрымак у мілісекундах для кожнага канала, раздзеленых знакам '|'. Нявыкарыстаныя затрымкі будуць моўчкі ігнаравацца. Калі колькасць дадзеных затрымак меншая за колькасць каналаў, усе астатнія каналы не будуць затрымлівацца. Калі вы хочаце адкласці дакладную колькасць узораў, дадайце 'S' да ліку. Калі замест гэтага вы хочаце зрабіць затрымку ў секундах, дадайце 's' да ліку.
all
Выкарыстоўвайце апошнюю зададзеную затрымку для ўсіх астатніх каналаў. Па змаўчанні адключана. Калі гэтая опцыя ўключана, змяняецца
delays
яе інтэрпрэтацыя.
8.11.1 Examples
- Затрымайце першы канал на 1,5 секунды, трэці канал - на 0,5 секунды і пакіньце другі канал (і любыя іншыя каналы, якія могуць прысутнічаць) без зменаў.
adelay=1500|0|500
- Затрымка другога канала на 500 выбарак, трэцяга канала на 700 выбарак і пакіньце першы канал (і любыя іншыя каналы, якія могуць прысутнічаць) без зменаў.
adelay=0|500S|700S
- Затрымка ўсіх каналаў на аднолькавую колькасць выбарак:
adelay=delays=64S:all=1
8.12 adenorm
Выпраўце дэнармалізацыю аўдыя, дадаўшы вельмі нізкі ўзровень шуму.
Гэты фільтр павінен быць размешчаны перад любым фільтрам, які можа выклікаць дэнармалізацыю.
Далей апісваюцца прынятыя параметры.
level
Усталюйце ўзровень дадатковага шуму ў дБ. Па змаўчанні
-351
. Дазволены дыяпазон ад -451 да -90.type
Усталюйце тып дадатковага шуму.
dc
Дадайце сігнал пастаяннага току.
ac
Дадайце сігнал пераменнага току.
square
Дадайце квадратны сігнал.
pulse
Дадаць імпульсны сігнал.
Па змаўчанні
dc
.
8.12.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.13 aderivative, aintegral
Вылічыць вытворную/інтэграл аўдыяплыні.
Прымяненне абодвух фільтраў адзін за адным стварае арыгінальны гук.
8.14 adynamicequalizer
Прымяніць дынамічнае выраўноўванне да ўваходнага аўдыёпатоку.
Далей апісваюцца прынятыя варыянты.
threshold
Усталюйце парог выяўлення, які выкарыстоўваецца для запуску эквалайзера. Парог выяўлення з дапамогай паласавога фільтра. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад 0 да 100.
dfrequency
Усталюйце частату выяўлення ў Гц, якая выкарыстоўваецца для паласавога фільтра, які выкарыстоўваецца для запуску эквалайзера. Значэнне па змаўчанні - 1000 Гц. Дазволены дыяпазон ад 2 да 1000000 Гц.
dqfactor
Усталюйце каэфіцыент рэзанансу выяўлення для паласавога фільтра, які выкарыстоўваецца для запуску эквалайзера. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,001 да 1000.
tfrequency
Усталюйце мэтавую частату фільтра выраўноўвання. Значэнне па змаўчанні - 1000 Гц. Дазволены дыяпазон ад 2 да 1000000 Гц.
tqfactor
Усталюйце мэтавы каэфіцыент рэзанансу для мэтавага эквалайзернага фільтра. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,001 да 1000.
attack
Усталюйце колькасць мілісекунд, за якое сігнал ад выяўлення павінен падняцца вышэй парога выяўлення, перш чым пачнецца выраўноўванне. Па змаўчанні - 20. Дазволены дыяпазон ад 1 да 2000.
release
Усталюйце колькасць мілісекунд, на працягу якіх сігнал ад выяўлення павінен апусціцца ніжэй парога выяўлення, перш чым выраўноўванне скончыцца. Па змаўчанні - 200. Дазволены дыяпазон ад 1 да 2000.
knee
Выгніце вострае калена вакол парога выяўлення, каб разлічыць узмацненне эквалайзера больш мякка. Па змаўчанні 1. Дазволены дыяпазон ад 0 да 8.
ratio
Усталюйце каэфіцыент, на які павялічваецца ўзмацненне эквалайзера. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 20.
makeup
Усталюйце зрушэнне макіяжу ў дБ, на якое павялічваецца ўзмацненне эквалайзера. Па змаўчанні - 0. Дазволены дыяпазон ад 0 да 30.
range
Усталюйце максімальна дазволеную колькасць зніжэння/ўзмацнення ў дБ. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 200.
slew
Усталюйце каэфіцыент павароту. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 200.
mode
Задаць рэжым працы фільтра можна адным з наступных варыянтаў:
- '
listen
' Выводзіць толькі ізаляваны паласавы сігнал.
- '
cut
' Выразаць частоты вышэй парога выяўлення.
- '
boost
' Павышэнне частоты ніжэй парога выяўлення.
Рэжым па змаўчанні '
cut
'.- '
tftype
Усталюйце тып мэтавага фільтра, можа быць адным з наступнага:
- '
bell
' - '
lowshelf
' - '
highshelf
'
Тып па змаўчанні '
bell
'.- '
8.14.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.15 adynamicsmooth
Прымяніць дынамічнае згладжванне да ўваходнага аўдыёпатоку.
Далей апісваюцца прынятыя варыянты.
sensitivity
Усталюйце ўзровень адчувальнасці да ваганняў частоты. Па змаўчанні 2. Дазволены дыяпазон ад 0 да 1e+06.
basefreq
Усталюйце базавую частату для згладжвання. Значэнне па змаўчанні - 22050. Дазволены дыяпазон ад 2 да 1e+06.
8.15.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.16 aecho
Прымяніць рэха да ўваходнага гуку.
Рэха - гэта адлюстраваны гук і можа ўзнікаць натуральным чынам сярод гор (а часам і вялікіх будынкаў) падчас размовы ці крыку; эфекты лічбавага рэха імітуюць такія паводзіны і часта выкарыстоўваюцца, каб дапамагчы напоўніць гук асобнага інструмента або вакалу. Розніца ў часе паміж зыходным сігналам і адлюстраваннем роўная delay
, а гучнасць адлюстраванага сігналу роўная decay
. Некалькі рэха можа мець розныя затрымкі і спады.
Далей апісваюцца прынятыя параметры.
in_gain
Задаць уваходнае ўзмацненне адлюстраванага сігналу. Па змаўчанні
0.6
.out_gain
Усталюйце выхадны каэфіцыент узмацнення адлюстраванага сігналу. Па змаўчанні
0.3
.delays
Задаць спіс інтэрвалаў часу ў мілісекундах паміж зыходным сігналам і адлюстраваннямі, падзеленых знакам '|'. Дазволены дыяпазон для кожнага
delay
з'яўляецца(0 - 90000.0]
. Па змаўчанні1000
.decays
Усталяваць спіс гучнасці адлюстраваных сігналаў, падзеленыя знакам '|'. Дазволены дыяпазон для кожнага
decay
з'яўляецца(0 - 1.0]
. Па змаўчанні0.5
.
8.16.1 Examples
- Зрабіце так, быццам інструментаў удвая больш, чым грае насамрэч:
aecho=0.8:0.88:60:0.4
- Калі затрымка вельмі кароткая, гэта гучыць як (металічны) робат, які грае музыку:
aecho=0.8:0.88:6:0.4
- Большая затрымка будзе гучаць як канцэрт пад адкрытым небам у гарах:
aecho=0.8:0.9:1000:0.3
- Тое самае, што і вышэй, але з яшчэ адной гарой:
aecho=0.8:0.9:1000|1800:0.3|0.25
8.17 aemphasis
Фільтр акцэнтавання гуку стварае або аднаўляе матэрыял, узяты непасрэдна з пласцінак або кампакт-дыскаў з акцэнтам, з рознымі крывымі фільтра. Напрыклад, для захавання музыкі на вініле сігнал павінен быць спачатку зменены фільтрам, каб ліквідаваць недахопы гэтага носьбіта запісу. Пасля прайгравання матэрыялу неабходна ўжыць зваротны фільтр, каб аднавіць скажэнне частотнай характарыстыкі.
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне.
level_out
Усталюйце ўзмацненне выхаду.
mode
Усталюйце рэжым фільтра. Для аднаўлення матэрыялу выкарыстоўвайце
reproduction
рэжым, інакш выкарыстоўвайцеproduction
рэжым. Па змаўчанні -reproduction
рэжым.type
Усталюйце тып фільтра. Выбірае сярэдні. Можа быць адно з наступнага:
col
абярыце Columbia.
emi
абярыце EMI.
bsi
абярыце BSI (78RPM).
riaa
абярыце RIAA.
cd
абярыце кампакт-дыск (CD).
50fm
выберыце 50 мкс (FM).
75fm
выберыце 75 мкс (FM).
50kf
выбраць 50 мкс (FM-KF).
75kf
выбраць 75 мкс (FM-KF).
8.17.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.18 aeval
Змяніце гукавы сігнал у адпаведнасці з указанымі выразамі.
Гэты фільтр прымае адзін або некалькі выразаў (па адным для кожнага канала), якія ацэньваюцца і выкарыстоўваюцца для змены адпаведнага гукавога сігналу.
Ён прымае наступныя параметры:
exprs
Усталяваць спіс выразаў, падзеленых '|', для кожнага асобнага канала. Калі колькасць уваходных каналаў большая за колькасць выразаў, для астатніх выходных каналаў выкарыстоўваецца апошні ўказаны выраз.
channel_layout, c
Усталюйце схему выходнага канала. Калі не вызначана, макет канала вызначаецца колькасцю выразаў. Калі ўстаноўлена "
same
', ён будзе выкарыстоўваць па змаўчанні тую ж схему ўваходнага канала.
Кожны выраз у exprs
можа ўтрымліваць наступныя канстанты і функцыі:
ch
нумар канала бягучага выразу
n
нумар ацэненай пробы, пачынаючы з 0
s
частата выбаркі
t
час ацэненага ўзору, выражаны ў секундах
nb_in_channels
nb_out_channels
колькасць уваходных і выходных каналаў
val(CH)
значэнне ўваходнага канала з нумарам
CH
Заўвага: гэты фільтр павольны. Для больш хуткай апрацоўкі вы павінны выкарыстоўваць спецыяльны фільтр.
8.18.1 Examples
- Палова аб'ёму:
aeval=val(ch)/2:c=same
- Інверсія фазы другога канала:
aeval=val(0)|-val(1)
8.19 aexciter
Узбуджальнік выкарыстоўваецца для атрымання высокага гуку, якога няма ў зыходным сігнале. Гэта робіцца шляхам стварэння гарманічных скажэнняў сігналу, якія абмежаваныя ў дыяпазоне і дадаюцца да зыходнага сігналу. Узбуджальнік павышае верхнюю частку гукавога сігналу без простага павышэння высокіх частот, як гэта зрабіў бы эквалайзер, каб стварыць больш «чысты» або «бліскучы» гук.
Фільтр прымае наступныя параметры:
level_in
Устанавіць уваходны ўзровень перад апрацоўкай сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.
level_out
Устанавіць выхадны ўзровень пасля апрацоўкі сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.
amount
Усталюйце колькасць гармонік, дададзеных да зыходнага сігналу. Дазволены дыяпазон ад 0 да 64. Значэнне па змаўчанні - 1.
drive
Усталюйце колькасць зноў створаных гармонік. Дазволены дыяпазон ад 0,1 да 10. Значэнне па змаўчанні - 8,5.
blend
Усталюйце актаву зноў створаных гармонік. Дазволены дыяпазон ад -10 да 10. Значэнне па змаўчанні - 0.
freq
Усталюйце ніжнюю мяжу частаты выпрацоўкі гармонік у Гц. Дазволены дыяпазон ад 2000 да 12000 Гц. Па змаўчанні - 7500 Гц.
ceil
Усталюйце верхнюю мяжу частаты выпрацоўкі гармонік. Дазволены дыяпазон ад 9999 да 20000 Гц. Калі значэнне ніжэй за 10000 Гц, абмежаванне не прымяняецца.
listen
Прыглушыць зыходны сігнал і выводзіць толькі дададзеныя гармонікі. Па змаўчанні адключана.
8.19.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.20 afade
Прымяненне эфекту знікнення/зніжэння да ўваходнага гуку.
Далей апісваюцца прынятыя параметры.
type, t
Укажыце тып эфекту, можа быць альбо
in
для эфекту знікнення, альбоout
для эфекту знікнення. Па змаўчанніin
.start_sample, ss
Укажыце нумар пачатковага ўзору для пачатку прымянення эфекту знікнення. Па змаўчанні 0.
nb_samples, ns
Укажыце колькасць узораў, для якіх павінен працягвацца эфект знікнення. У канцы эфекту знікнення гучнасць выхаднога гуку будзе такой жа гучнасці, як і уваходнага аўдыё, у канцы пераходу знікнення гук будзе маўчаць. Па змаўчанні 44100.
start_time, st
Укажыце час пачатку эфекту знікнення. Па змаўчанні 0. Значэнне павінна быць указана як працягласць часу; гл. (ffmpeg-utils) раздзел Працягласць часу ў кіраўніцтве ffmpeg-utils(1) , каб даведацца пра прыняты сінтаксіс. Калі ўсталяваны, гэты параметр выкарыстоўваецца замест
start_sample
.duration, d
Укажыце працягласць эфекту знікнення. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . У канцы эфекту знікнення гучнасць выхаднога гуку будзе такой жа гучнасці, як і уваходнага аўдыё, у канцы пераходу знікнення гук будзе маўчаць. Па змаўчанні працягласць вызначаецца
nb_samples
. Калі ўсталяваны, гэты параметр выкарыстоўваецца заместnb_samples
.curve
Усталюйце крывую для знікнення.
Ён прымае наступныя значэнні:
tri
выбраць трохкутны, лінейны нахіл (па змаўчанні)
qsin
выбраць чвэрць сінусоіды
hsin
выбраць палову сінусоіды
esin
выбраць экспанентную сінусоіду
log
выбраць лагарыфмічны
ipar
выбраць перавернутую парабалу
qua
выбраць квадратычны
cub
выбраць куб
squ
выбраць квадратны корань
cbr
выбраць кубічны корань
par
выбраць парабалу
exp
выбраць экспанентны
iqsin
выбраць перавернутую чвэрць сінусоіды
ihsin
выбраць інвертаваную палову сінусоіды
dese
выберыце двухэкспанентнае месца
desi
выбраць двухэкспанентны сігмаід
losi
выбраць лагістычную сігмаід
sinc
выбраць кардынальную сінусную функцыю
isinc
выбраць функцыю перавернутага сінуса
nofade
знікненне не прымяняецца
8.20.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.20.2 Examples
- Затуханне ў першыя 15 секунд аўдыя:
afade=t=in:ss=0:d=15
- Згасанне апошніх 25 секунд з 900 секунд аўдыя:
afade=t=out:st=875:d=25
8.21 afftdn
Знішчэнне гуку ўзораў з БПФ.
Далей апісваюцца прынятыя параметры.
noise_reduction, nr
Усталюйце зніжэнне шуму ў дБ, дазволены дыяпазон ад 0,01 да 97. Значэнне па змаўчанні - 12 дБ.
noise_floor, nf
Усталюйце ўзровень шуму ў дБ, дазволены дыяпазон ад -80 да -20. Значэнне па змаўчанні -50 дБ.
noise_type, nt
Усталюйце тып шуму.
Ён прымае наступныя значэнні:
white, w
Выберыце белы шум.
vinyl, v
Выберыце вінілавы шум.
shellac, s
Выберыце шум шеллака.
custom, c
Выберыце карыстальніцкі шум, вызначаны ў
bn
опцыі.Значэнне па змаўчанні - белы шум.
band_noise, bn
Усталюйце карыстальніцкі шумавы профіль дыяпазону для кожнага з 15 дыяпазонаў. Паласы падзяляюцца знакамі « » або «|».
residual_floor, rf
Усталюйце рэшткавы падлогу ў дБ, дазволены дыяпазон ад -80 да -20. Значэнне па змаўчанні -38 дБ.
track_noise, tn
Уключыць адсочванне ўзроўню шуму. Па змаўчанні адключана. Калі гэта ўключана, мінімальны ўзровень шуму рэгулюецца аўтаматычна.
track_residual, tr
Уключыць рэшткавае адсочванне. Па змаўчанні адключана.
output_mode, om
Усталюйце рэжым вываду.
Ён прымае наступныя значэнні:
input, i
Увод пропуску без зменаў.
output, o
Прахадны шум адфільтраваны.
noise, n
Прапускаюць толькі шум.
Значэнне па змаўчанні -
output
.
adaptivity, ad
Усталюйце каэфіцыент адаптацыі, які выкарыстоўваецца для адаптацыі карэкціровак узмацнення для кожнага дыяпазону частот. Значэнне
0
забяспечвае імгненную адаптацыю, у той час як больш высокія значэнні рэагуюць значна павольней. Дазволены дыяпазон ад0
да1
. Значэнне па змаўчанні -0.5
.floor_offset, fo
Усталюйце каэфіцыент зрушэння ўзроўню шуму. Гэты параметр выкарыстоўваецца для рэгулявання зрушэння, прымененага да вымеранага ўзроўню шуму. Ён эфектыўны, толькі калі ўключана адсочванне ўзроўню шуму. Дазволены дыяпазон ад
-2.0
да2.0
. Значэнне па змаўчанні -1.0
.noise_link, nl
Усталюйце шумавую сувязь, якая выкарыстоўваецца для шматканальнага гуку.
Ён прымае наступныя значэнні:
none
Выкарыстоўвайце нязменны ўзровень шуму канала.
min
Выкарыстоўвайце вымераны мінімальны ўзровень шуму ўсіх каналаў.
max
Выкарыстоўвайце вымераны максімальны ўзровень шуму ўсіх каналаў.
average
Выкарыстоўвайце вымераны сярэдні ўзровень шуму ўсіх каналаў.
Значэнне па змаўчанні -
min
.
band_multiplier, bm
Устанавіць каэфіцыент множання дыяпазону, які выкарыстоўваецца для размеркавання дыяпазонаў па дыяпазонах частот. Дазволены дыяпазон ад
0.2
да5
. Значэнне па змаўчанні -1.25
.sample_noise, sn
Пераключыць захоп і вымярэнне профілю шуму ад уваходнага аўдыя.
Ён прымае наступныя значэнні:
start, begin
Пачаць захоп узору шуму.
stop, end
Спыніць захоп узору шуму і вымераць новы профіль паласы шуму.
Значэнне па змаўчанні -
none
.
gain_smooth, gs
Задаць плыўны прасторавы радыус каэфіцыента ўзмацнення, які выкарыстоўваецца для згладжвання каэфіцыента ўзмацнення, прымененага да кожнага дыяпазону частот. Карысна для памяншэння выпадковых музычных шумавых артэфактаў. Больш высокія значэнні павялічваюць згладжванне прыбытку. Дазволены дыяпазон ад
0
да50
. Значэнне па змаўчанні -0
.
8.21.1 Commands
Гэты фільтр падтрымлівае некаторыя вышэйзгаданыя параметры ў якасці каманд .
8.21.2 Examples
- Паменшыце белы шум на 10 дБ і выкарыстоўвайце раней вымераны ўзровень шуму -40 дБ:
afftdn=nr=10:nf=-40
- Паменшыце ўзровень белага шуму на 10 дБ, таксама ўсталюйце пачатковы ўзровень шуму на -80 дБ і ўключыце аўтаматычнае адсочванне ўзроўню шуму, так што ўзровень шуму будзе паступова змяняцца падчас апрацоўкі:
afftdn=nr=10:nf=-80:tn=1
- Паменшыце ўзровень шуму на 20 дБ, выкарыстоўваючы ўзровень шуму -40 дБ і выкарыстоўваючы каманды для атрымання шумавога профілю першых 0,4 секунды ўваходнага гуку:
asendcmd=0.0 afftdn sn start,asendcmd=0.4 afftdn sn stop,afftdn=nr=20:nf=-40
8.22 afftfilt
Прымяненне адвольных выразаў да ўзораў у частотнай вобласці.
real
Усталюйце рэальны выраз у частотнай вобласці для кожнага асобнага канала, падзелены знакам '|'. Па змаўчанні - "re". Калі колькасць уваходных каналаў большая за колькасць выразаў, для астатніх выходных каналаў выкарыстоўваецца апошні ўказаны выраз.
imag
Усталюйце ўяўны выраз у частотнай вобласці для кожнага асобнага канала, падзелены знакам '|'. Па змаўчанні "im".
Кожны выраз у
real
іimag
можа ўтрымліваць наступныя канстанты і функцыі:sr
частата выбаркі
b
нумар бягучай частаты
nb
колькасць даступных бункераў
ch
нумар канала бягучага выразу
chs
колькасць каналаў
pts
бягучы кадр ач
re
бягучая сапраўдная частка частаты бягучага канала
im
бягучая ўяўная частка дыяпазону частот бягучага канала
real(b, ch)
Вяртае значэнне рэальнай часткі дыяпазону частот у месцы (
bin
,channel
)imag(b, ch)
Вярнуць значэнне ўяўнай часткі дыяпазону частот у месцы (
bin
,channel
)
win_size
Усталюйце памер акна. Дазволены дыяпазон ад 16 да 131072. Значэнне па змаўчанні
4096
win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann, hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Па змаўчанні
hann
.- '
overlap
Усталюйце перакрыцце вокнаў. Калі ўстаноўлена значэнне 1, будзе выбрана рэкамендаванае перакрыцце для выбранай функцыі акна. Па змаўчанні
0.75
.
8.22.1 Examples
- Пакіньце ў гуку амаль толькі нізкія частоты:
afftfilt="'real=re * (1-clip((b/nb)*b,0,1))':imag='im * (1-clip((b/nb)*b,0,1))'"
- Прымяніць эфект рабатызацыі:
afftfilt="real='hypot(re,im)*sin(0)':imag='hypot(re,im)*cos(0)':win_size=512:overlap=0.75"
- Прымяніць эфект шэпту:
afftfilt="real='hypot(re,im)*cos((random(0)*2-1)*2*3.14)':imag='hypot(re,im)*sin((random(1)*2-1)*2*3.14)':win_size=128:overlap=0.8"
8.23 afir
Прымяніць адвольны фільтр канчатковай імпульснай характарыстыкі.
Гэты фільтр прызначаны для прымянення доўгіх FIR-фільтраў, працягласцю да 60 секунд.
Ён можа быць выкарыстаны ў якасці кампанента для лічбавых кросоверных фільтраў, эквалайзера пакоя, адмены перакрыжаваных перамоў, сінтэзу хвалевага поля, аўралізацыі, амбіяфонікі, амбіафонікі і прасторавасці.
Гэты фільтр выкарыстоўвае патокі, вышэйшыя за першы, у якасці каэфіцыентаў FIR. Калі не першы паток змяшчае адзін канал, ён будзе выкарыстоўвацца для ўсіх уваходных каналаў у першым патоку, інакш колькасць каналаў у не першым патоку павінна быць такой жа, як колькасць каналаў у першым патоку.
Ён прымае наступныя параметры:
dry
Усталюйце сухое ўзмацненне. Гэта задае ўзмацненне ўваходнага сігналу.
wet
Усталюйце мокры ўзмацненне. Гэта задае канчатковае ўзмацненне выхаду.
length
Усталюйце даўжыню фільтра імпульснай характарыстыкі. Па змаўчанні 1, што азначае, што апрацоўваецца ўвесь ВК.
gtype
Уключыць прымяненне ўзмацнення, вымеранага ад магутнасці ВК.
Вызначце, які падыход выкарыстоўваць для аўтаматычнага вымярэння ўзмацнення.
none
Не ўжывайце ніякага ўзмацнення.
peak
выбраць пікавы ўзмацненне, вельмі кансерватыўны падыход. Гэта значэнне па змаўчанні.
dc
выбраць узмацненне пастаяннага току, абмежаванае прымяненне.
gn
абярыце падыход узмацнення да шуму, гэта самы папулярны.
irgain
Усталюйце ўзмацненне, якое будзе прымяняцца да ВК-каэфіцыентаў перад фільтраваннем. Дазволены дыяпазон ад 0 да 1. Гэты ўзмацненне прымяняецца пасля любога ўзмацнення, прымененага з
gtype
опцыяй.irfmt
Задаць фармат ВК-струменю. Можа быць
mono
абоinput
. Па змаўчанніinput
.maxir
Усталюйце максімальна дазволеную працягласць фільтра імпульснай характарыстыкі ў секундах. Па змаўчанні 30 секунд. Дазволены дыяпазон ад 0,1 да 60 секунд.
response
Паказваць ІЧ-частотную характарыстыку, велічыню (пурпурны), фазу (зялёны) і групавую затрымку (жоўты) у дадатковым відэапатоку. Па змаўчанні ён адключаны.
channel
Усталюйце, для якога ІЧ-канала адлюстроўваць АЧХ. Па змаўчанні адлюстроўваецца першы канал. Гэты параметр выкарыстоўваецца, толькі калі
response
ён уключаны.size
Усталюйце памер відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі
response
ён уключаны.rate
Задаць частату кадраў відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі
response
ён уключаны.minp
Усталюйце мінімальны памер падзелу для згортвання. Па змаўчанні
8192
. Дазволены дыяпазон ад1
да32768
. Больш нізкія значэнні памяншаюць затрымку за кошт большага выкарыстання працэсара.maxp
Устанавіць максімальны памер падзелу для згортвання. Па змаўчанні
8192
. Дазволены дыяпазон ад8
да32768
. Больш нізкія значэнні могуць павялічыць загрузку працэсара.nbirs
Задайце колькасць патокаў уваходных імпульсных адказаў, якія можна будзе пераключаць падчас выканання. Дазволены дыяпазон ад
1
да32
. Па змаўчанні1
.ir
Усталяваны ВК-паток, які будзе выкарыстоўвацца для згортвання, пачынаючы з
0
, заўсёды павінен быць ніжэйшым за пастаўленае значэнне паnbirs
опцыі. Па змаўчанні0
. Гэты параметр можна змяніць падчас выканання з дапамогай каманд .precision
Усталюйце, якую дакладнасць выкарыстоўваць пры апрацоўцы ўзораў.
auto
Аўтаматычны выбар унутранага фармату выбаркі ў залежнасці ад іншых фільтраў.
float
Заўсёды выкарыстоўвайце фармат выбаркі з адной плаваючай кропкай.
double
Заўсёды выкарыстоўвайце фармат выбаркі з падвойнай плаваючай кропкай.
Значэнне па змаўчанні - аўтаматычна.
8.23.1 Examples
- Прымяніць рэверберацыю да патоку з выкарыстаннем мона-ВК-файла ў якасці другога ўводу, завяршыць каманду з дапамогай ffmpeg:
ffmpeg -i input.wav -i middle_tunnel_1way_mono.wav -lavfi afir output.wav
8.24 aformat
Усталюйце абмежаванні фармату вываду для ўваходнага гуку. Структура будзе ўзгадняць найбольш прыдатны фармат для мінімізацыі пераўтварэнняў.
Ён прымае наступныя параметры:
sample_fmts, f
Спіс запытаных узораў фарматаў, падзелены '|'.
sample_rates, r
Спіс запытаных частот дыскрэтызацыі, падзелены '|'.
channel_layouts, cl
Спіс запытаных макетаў каналаў, падзелены '|'.
Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .
Калі параметр апушчаны, дазволены ўсе значэнні.
Прымусіць на вывадзе або беззнакавы 8-бітны, або са знакам 16-бітны стэрэа
aformat=sample_fmts=u8|s16:channel_layouts=stereo
8.25 afreqshift
Прымяніць частотны зрух да ўваходных аўдыясэмплаў.
Фільтр прымае наступныя параметры:
shift
Укажыце зрух частоты. Дазволены дыяпазон ад -INT_MAX да INT_MAX. Значэнне па змаўчанні 0,0.
level
Задаць узмацненне выхаду, прымененае да канчатковага выхаду. Дазволены дыяпазон ад 0,0 да 1,0. Значэнне па змаўчанні 1,0.
order
Устанавіць парадак фільтрацыі, які выкарыстоўваецца для фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 8.
8.25.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.26 afwtdn
Паменшыце шырокапалосны шум ад уваходных выбарак з дапамогай Wavelets.
Далей апісваюцца прынятыя варыянты.
sigma
Усталюйце сігму шуму, дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні роўна 0. Гэты параметр кантралюе інтэнсіўнасць шумашумлення, прымененага да ўваходных выбарак. Самы карысны спосаб усталяваць гэтую опцыю праз дэцыбелы, напрыклад. -45 дБ.
levels
Усталюйце колькасць вейвлет-узроўняў разлажэння. Дазволены дыяпазон ад 1 да 12. Значэнне па змаўчанні - 10. Усталяванне занадта нізкага значэння робіць прадукцыйнасць шумашумлення вельмі нізкай.
wavet
Усталюйце тып вейвлета для дэкампазіцыі ўваходнага кадра. Яны адсартаваны па колькасці каэфіцыентаў, ад самага нізкага да высокага. Больш каэфіцыентаў азначае горшую хуткасць фільтрацыі, але ў цэлым лепшую якасць. Даступныя вэйвлеты:
- '
sym2
' - '
sym4
' - '
rbior68
' - '
deb10
' - '
sym10
' - '
coif5
' - '
bl3
'
- '
percent
Усталюйце працэнт поўнага выдалення шумоў. Дазволены дыяпазон ад 0 да 100 працэнтаў. Значэнне па змаўчанні - 85 працэнтаў або частковае выдаленне шуму.
profile
Калі ўключана, першы ўваходны кадр будзе выкарыстоўвацца як профіль шуму. Калі першыя ўзоры кадраў утрымліваюць бясшумныя паказчыкі, прадукцыйнасць будзе вельмі нізкай.
adaptive
Калі ўключана, уваходныя кадры аналізуюцца на наяўнасць шуму. Калі шум выяўлены з высокай верагоднасцю, то профіль уваходнага кадра будзе выкарыстоўвацца для апрацоўкі наступных кадраў, пакуль не будзе выяўлены новы шумавы кадр.
samples
Задайце памер аднаго кадра ў колькасці выбарак. Дазволены дыяпазон ад 512 да 65536. Памер кадра па змаўчанні - 8192 выбаркі.
softness
Усталяваць мяккасць унутры функцыі парогаў. Дазволены дыяпазон ад 0 да 10. Мяккасць па змаўчанні - 1.
8.26.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.27 agate
Гейт у асноўным выкарыстоўваецца для памяншэння ніжніх частак сігналу. Такая апрацоўка сігналу памяншае трывожны шум паміж карыснымі сігналамі.
Стробаванне ажыццяўляецца шляхам выяўлення гучнасці ніжэй за абраны ўзровень threshold
і дзялення яго на каэфіцыент, зададзены з дапамогай ratio
. Ніжняя частка ўзроўню шуму задаецца праз range
. Паколькі дакладная маніпуляцыя сігналам прывядзе да скажэння формы сігналу, памяншэнне можа быць выраўнавана з часам. Гэта робіцца шляхам усталявання attack
і release
.
attack
вызначае, як доўга сігнал павінен апусціцца ніжэй парогавага значэння, перш чым адбудзецца якое-небудзь зніжэнне, і release
задае час, на працягу якога сігнал павінен падняцца вышэй парогавага значэння, каб зноў паменшыць зніжэнне. Больш кароткія сігналы, чым выбраны час атакі, застануцца некранутымі.
level_in
Усталюйце ўваходны ўзровень перад фільтрацыяй. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.
mode
Усталюйце рэжым працы. Можа быць
upward
абоdownward
. Па змаўчанніdownward
. Калі ўсталяваныupward
рэжым, больш высокія часткі сігналу будуць узмацняцца, пашыраючы дынамічны дыяпазон уверх. У адваротным выпадку ў выпадкуdownward
ніжніх частак сігнал будзе зніжаны.range
Усталюйце ўзровень зніжэння ўзмацнення, калі сігнал ніжэйшы за парог. Па змаўчанні 0,06125. Дазволены дыяпазон ад 0 да 1. Усталёўка гэтага значэння ў 0 адключае скарачэнне, а затым фільтр паводзіць сябе як пашыральнік.
threshold
Калі сігнал падымаецца вышэй за гэты ўзровень, зніжэнне ўзмацнення адключаецца. Па змаўчанні 0,125. Дазволены дыяпазон ад 0 да 1.
ratio
Усталюйце каэфіцыент паніжэння сігналу. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 9000.
attack
Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым зніжэнне ўзмацнення спыніцца. Па змаўчанні 20 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.
release
Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў павялічыцца. Па змаўчанні 250 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.
makeup
Задаць велічыню ўзмацнення сігналу пасля апрацоўкі. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64.
knee
Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,828427125. Дазволены дыяпазон ад 1 да 8.
detection
Выберыце, ці трэба браць для выяўлення дакладны сігнал ці падобны да RMS. Па змаўчанні
rms
. Можа быцьpeak
абоrms
.link
Выберыце, калі сярэдні ўзровень паміж усімі каналамі ці больш гучны канал уплывае на зніжэнне. Па змаўчанні
average
. Можа быцьaverage
абоmaximum
.
8.27.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.28 aiir
Прымяніць адвольны фільтр бясконцай імпульснай характарыстыкі.
Ён прымае наступныя параметры:
zeros, z
Усталюйце B/лічнік/нулі/каэфіцыенты адлюстравання.
poles, p
Усталюйце каэфіцыенты A/назоўнік/полюсы/лесвіцы.
gains, k
Усталюйце ўзмацненне каналаў.
dry_gain
Задаць уваходнае ўзмацненне.
wet_gain
Усталюйце ўзмацненне выхаду.
format, f
Задаць фармат каэфіцыентаў.
- '
ll
' рашотка-лесвічная функцыя
- '
sf
' аналагавая перадаткавая функцыя
- '
tf
' функцыя лічбавай перадачы
- '
zp
' Нулі/полюсы Z-плоскасці, дэкартавы (па змаўчанні)
- '
pr
' Нулі/полюсы плоскасці Z, палярныя радыяны
- '
pd
' Нулі/полюсы Z-плоскасці, палярныя градусы
- '
sp
' Нулі/полюсы S-плоскасці
- '
process, r
Задаць тып апрацоўкі.
- '
d
' прамая апрацоўка
- '
s
' серыйная апрацоўка
- '
p
' паралельная апрацоўка
- '
precision, e
Усталюйце дакладнасць фільтрацыі.
- '
dbl
' з плаваючай кропкай падвойнай дакладнасці (па змаўчанні)
- '
flt
' з плаваючай кропкай адзінарнай дакладнасці
- '
i32
' 32-бітныя цэлыя лікі
- '
i16
' 16-бітныя цэлыя лікі
- '
normalize, n
Нармалізацыя каэфіцыентаў фільтра, па змаўчанні ўключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
mix
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
response
Паказваць ІЧ-частотную характарыстыку, велічыню (пурпурны), фазу (зялёны) і групавую затрымку (жоўты) у дадатковым відэапатоку. Па змаўчанні ён адключаны.
channel
Усталюйце, для якога ІЧ-канала адлюстроўваць АЧХ. Па змаўчанні адлюстроўваецца першы канал. Гэты параметр выкарыстоўваецца, толькі калі
response
ён уключаны.size
Усталюйце памер відэаструменю. Гэты параметр выкарыстоўваецца, толькі калі
response
ён уключаны.
Каэфіцыенты ў tf
і sf
фармат падзеленыя прабеламі і размешчаны ў парадку ўзрастання.
Каэфіцыенты ў zp
фармаце падзяляюцца прабеламі, і парадак каэфіцыентаў не мае значэння. Каэфіцыенты ў zp
фармаце ўяўляюць сабой камплексныя лікі з i
уяўнай адзінкай.
Для кожнага канала можна задаць розныя каэфіцыенты і ўзмацненні, у такім выпадку выкарыстоўвайце '|' каб падзяліць каэфіцыенты або выгады. Апошнія прадстаўленыя каэфіцыенты будуць выкарыстоўвацца для ўсіх астатніх каналаў.
8.28.1 Examples
- Прымяніце 2-полюсную эліптычную выемку каля 5000 Гц для частаты дыскрэтызацыі 48000 Гц:
aiir=k=1:z=7.957584807809675810E-1 -2.575128568908332300 3.674839853930788710 -2.57512875289799137 7.957586296317130880E-1:p=1 -2.86950072432325953 3.63022088054647218 -2.28075678147272232 6.361362326477423500E-1:f=tf:r=d
- Тое самае, што і вышэй, але ў
zp
фармаце:aiir=k=0.79575848078096756:z=0.80918701+0.58773007i 0.80918701-0.58773007i 0.80884700+0.58784055i 0.80884700-0.58784055i:p=0.63892345+0.59951235i 0.63892345-0.59951235i 0.79582691+0.44198673i 0.79582691-0.44198673i:f=zp:r=s
- Прымяніць аналагавы нармалізаваны фільтр нізкіх частот Батэрворта 3-га парадку з выкарыстаннем аналагавага фармату функцыі перадачы:
aiir=z=1.3057 0 0 0:p=1.3057 2.3892 2.1860 1:f=sf:r=d
8.29 alimiter
Абмежавальнік прадухіляе перавышэнне патрэбнага парога ўваходнага сігналу. Гэты абмежавальнік выкарыстоўвае тэхналогію прагляду наперад, каб прадухіліць скажэнне вашага сігналу. Гэта азначае, што ёсць невялікая затрымка пасля апрацоўкі сігналу. Майце на ўвазе, што затрымка, якую ён стварае, - гэта ўсталяваны вамі час атакі.
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні 1.
level_out
Усталюйце ўзмацненне выхаду. Па змаўчанні 1.
limit
Не дазваляйце сігналам вышэй за гэты ўзровень праходзіць праз абмежавальнік. Па змаўчанні 1.
attack
Абмежавальнік дасягне свайго ўзроўню згасання за гэты прамежак часу ў мілісекундах. Па змаўчанні 5 мілісекунд.
release
Вярніцеся ад абмежавання да аслаблення 1,0 за гэтую колькасць мілісекунд. Па змаўчанні 50 мілісекунд.
asc
Калі памяншэнне ўзмацнення заўсёды неабходна, ASC клапоціцца аб выпуску да сярэдняга ўзроўню зніжэння, а не аб дасягненні памяншэння 0 падчас вызвалення.
asc_level
Выберыце, наколькі на час выпуску ўплывае ASC, 0 азначае амаль адсутнасць змен у часе выпуску, а 1 забяспечвае большы час выпуску.
level
Аўтаматычны ўзровень выхаднога сігналу. Па змаўчанні ўключана. Гэта нармалізуе гук да 0 дБ, калі ўключана.
latency
Кампенсуйце ўнесеную затрымку з дапамогай буфера прагляду, набору з параметрам атакі. Таксама ачысціце сапраўдныя аўдыядадзеныя ў буферы прагляду, калі паток трапляе ў EOF.
У залежнасці ад выбранай налады, перад прымяненнем гэтага фільтра рэкамендуецца павялічваць уваход у 2 ці 4 разы з дапамогай aresample .
8.30 allpass
Прымяненне двухполюснага ўсепраходнага фільтра з цэнтральнай частатой (у Гц)
frequency
і шырынёй фільтра width
. Усепраходны фільтр змяняе суадносіны частоты і фазы гуку, не змяняючы суадносін частоты і амплітуды.
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце частату ў Гц.
width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
order, o
Усталюйце парадак фільтраў, можа быць 1 або 2. Па змаўчанні 2.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
8.30.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць частату ўсіх пасоў. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць allpass width_type. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню ўсіх праходаў. Сінтаксіс каманды: "
width
"mix, m
Змяніць мікс allpass. Сінтаксіс каманды: "
mix
"
8.31 aloop
Зацыкленыя аўдыё ўзоры.
Фільтр прымае наступныя параметры:
loop
Усталюйце колькасць завес. Усталяванне гэтага значэння ў -1 прывядзе да бясконцых цыклаў. Па змаўчанні 0.
size
Усталюйце максімальную колькасць узораў. Па змаўчанні 0.
start
Усталюйце першы ўзор цыкла. Па змаўчанні 0.
8.32 amerge
Аб'яднайце два ці больш аўдыяпатокаў у адзін шматканальны паток.
Фільтр прымае наступныя параметры:
inputs
Усталюйце колькасць уваходаў. Па змаўчанні 2.
Калі размяшчэнне каналаў уваходаў не перасякаецца і, такім чынам, сумяшчальна, размяшчэнне каналаў выхаду будзе ўстаноўлена адпаведным чынам, і парадак каналаў будзе зменены па меры неабходнасці. Калі размяшчэнне каналаў уваходаў не перасякаецца, на выхадзе будуць усе каналы першага ўваходу, затым усе каналы другога ўваходу ў такім парадку, а размяшчэнне каналаў на выхадзе будзе значэннем па змаўчанні, якое адпавядае агульная колькасць каналаў.
Напрыклад, калі першы ўваход знаходзіцца ў 2.1 (FL+FR+LF), а другі ўваход FC+BL+BR, то выхад будзе ў 5.1 з каналамі ў наступным парадку: a1, a2, b1, a3, b2, b3 (a1 - першы канал першага ўваходу, b1 - першы канал другога ўваходу).
З іншага боку, калі абодва ўваходныя сігналы знаходзяцца ў стэрэа, выходныя каналы будуць у парадку па змаўчанні: a1, a2, b1, b2, а размяшчэнне каналаў будзе адвольна ўстаноўлена на 4.0, што можа быць ці не быць чаканым значэннем .
Усе ўваходныя дадзеныя павінны мець аднолькавую частату дыскрэтызацыі і фармат.
Калі ўваходы не маюць аднолькавай працягласці, выхад спыніцца на самым кароткім.
8.32.1 Examples
- Аб'яднаць два монафайла ў стэрэаструмень:
amovie=left.wav [l] ; amovie=right.mp3 [r] ; [l] [r] amerge
- Некалькі аб'яднанняў пры ўмове ўваходжання 1 відэапатоку і 6 аўдыяпатокаў
input.mkv
:ffmpeg -i input.mkv -filter_complex "[0:1][0:2][0:3][0:4][0:5][0:6] amerge=inputs=6" -c:a pcm_s16le output.mkv
8.33 amix
Змешвае некалькі аўдыяўваходаў у адзін выхад.
Звярніце ўвагу, што гэты фільтр падтрымлівае толькі плаваючыя сэмплы ( фільтры amerge
і pan
аўдыяфільтры падтрымліваюць шмат фарматаў). Калі amix
ўвод змяшчае цэлыя выбаркі, aresample будзе аўтаматычна ўстаўлены для выканання пераўтварэння ў выбаркі з плаваючай колькасцю.
Напрыклад
ffmpeg -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex amix=inputs=3:duration=first:dropout_transition=3 OUTPUT
будзе змешваць 3 ўваходныя аўдыёпатокі ў адзін выхад з той жа працягласцю, што і першы ўваход, і час пераходу адключэння 3 секунды.
Ён прымае наступныя параметры:
inputs
Колькасць уваходаў. Калі не пазначана, па змаўчанні 2.
duration
Як вызначыць канец патоку.
longest
Працягласць самага доўгага ўводу. (па змаўчанні)
shortest
Працягласць самага кароткага ўводу.
first
Працягласць першага ўваходу.
dropout_transition
Час пераходу ў секундах для перанармалізацыі гучнасці, калі заканчваецца ўваходны паток. Значэнне па змаўчанні - 2 секунды.
weights
Укажыце вагу кожнага ўваходнага аўдыёпатоку як паслядоўнасць. Кожная вага аддзяляецца прабелам. Па змаўчанні ўсе ўваходы маюць аднолькавую вагу.
normalize
Заўсёды маштабуйце ўваходныя дадзеныя, а не толькі падсумоўвайце выбаркі. Сцеражыцеся моцнага адсячэння, калі ўваходныя дадзеныя не нармалізуюцца да або пасля фільтрацыі гэтым фільтрам, калі гэты параметр адключаны. Па змаўчанні ўключана.
8.33.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
weights
normalize
Сінтаксіс той жа, што і варыянт з такой жа назвай.
8.34 amultiply
Памножце першы аўдыяпаток на другі і захавайце вынік у выхадным аўдыяпатоку. Памнажэнне ажыццяўляецца шляхам памнажэння кожнага ўзору з першага патоку на ўзор у той жа пазіцыі з другога патоку.
З дапамогай гэтага паэлементнага множання можна ствараць замірання амплітуды і мадуляцыі амплітуды.
8.35 anequalizer
Параметрычны шматпалосны эквалайзер высокага парадку для кожнага канала.
Ён прымае наступныя параметры:
params
-
Гэты радок параметраў мае фармат: "c
chn
f=cf
w=w
g=g
t=f
| ..." Кожная паласа эквалайзера аддзяляецца знакам '|'.chn
Усталюйце нумар канала, да якога будзе прымяняцца эквалайзер. Калі ўваход не мае гэтага канала, запіс ігнаруецца.
f
Усталюйце цэнтральную частату для дыяпазону. Калі ўвод не мае такой частаты, запіс ігнаруецца.
w
Задаць шырыню дыяпазону ў герцах.
g
Усталюйце ўзмацненне дыяпазону ў дБ.
t
Задаць тып фільтра для дыяпазону, неабавязкова, можа быць:
- '
0
' Батэрворт, гэта стандартна.
- '
1
' Чэбышава тып 1.
- '
2
' Чэбышава тып 2.
- '
curves
Пры гэтай опцыі актываваная АЧХ анэквалайзера адлюстроўваецца ў відэаструмені.
size
Усталюйце памер відэаструменю. Карысна толькі ў тым выпадку, калі ўключана опцыя крывых.
mgain
Усталюйце максімальнае ўзмацненне, якое будзе адлюстроўвацца. Карысна толькі ў тым выпадку, калі ўключана опцыя крывых. Усталяванне разумнага значэння дазваляе адлюстраваць узмацненне, якое атрымліваецца ад суседніх дыяпазонаў, якія знаходзяцца занадта блізка адзін да аднаго, і, такім чынам, стварае большы ўзмацненне, калі абодва актываваны.
fscale
Задаць частотную шкалу, якая выкарыстоўваецца для малявання частотнай характарыстыкі ў відэавывадзе. Можа быць лінейным або лагарыфмічным. Па змаўчанні - лагарыфмічны.
colors
Усталюйце колер для кожнай крывой канала, якая будзе адлюстроўвацца ў відэаструмені. Гэта спіс назваў колераў, падзеленых прабелам або знакам '|'. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.
8.35.1 Examples
- Знізіце ўзмацненне на 10 цэнтральнай частаты 200 Гц і шырыні 100 Гц для першых 2 каналаў з выкарыстаннем фільтра Чэбышава тыпу 1:
anequalizer=c0 f=200 w=100 g=-10 t=1|c1 f=200 w=100 g=-10 t=1
8.35.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
change
Змяніць існуючыя параметры фільтра. Сінтаксіс для каманд: "
fN
|f=freq
|w=width
|g=gain
"fN
нумар існуючага фільтра, пачынаючы з 0, калі такі фільтр недаступны, вяртаецца памылка.freq
ўсталяваць новы параметр частоты.width
ўсталяваць новы параметр шырыні ў Герцах.gain
ўсталяваць новы параметр узмацнення ў дБ.Поўны выклік фільтра з asendcmd можа выглядаць так: asendcmd=c='4.0 anequalizer change 0|f=200|w=50|g=1',anequalizer=...
8.36 anlmdn
Паменшыце шырокапалосны шум у аўдыясэмплах з дапамогай алгарытму нелакальных сродкаў.
Кожны ўзор карэктуецца шляхам пошуку іншых узораў з аналагічным кантэкстам. Гэта падабенства кантэксту вызначаецца шляхам параўнання навакольных іх участкаў памеру
p
. Латы шукаюць у раёне вr
вакол ўзору.
Фільтр прымае наступныя параметры:
strength, s
Усталюйце сілу шумашумлення. Дазволены дыяпазон ад 0,00001 да 10000. Значэнне па змаўчанні - 0,00001.
patch, p
Задаць працягласць радыусу патча. Дазволены дыяпазон ад 1 да 100 мілісекунд. Значэнне па змаўчанні - 2 мілісекунды.
research, r
Задаць працягласць радыусу даследавання. Дазволены дыяпазон ад 2 да 300 мілісекунд. Значэнне па змаўчанні - 6 мілісекунд.
output, o
Усталюйце рэжым вываду.
Ён прымае наступныя значэнні:
i
Увод пропуску без зменаў.
o
Прахадны шум адфільтраваны.
n
Прапускаюць толькі шум.
Значэнне па змаўчанні -
o
.
smooth, m
Усталюйце каэфіцыент згладжвання. Значэнне па змаўчанні -
11
. Дазволены дыяпазон ад1
да1000
.
8.36.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.37 anlmf, anlms
Прымяніць алгарытм нармалізаванага найменшага сярэдняга-(квадраты|чацвёрты) да першага аўдыяпатоку з выкарыстаннем другога аўдыяпатоку.
Гэты адаптыўны фільтр выкарыстоўваецца для імітацыі жаданага фільтра шляхам вызначэння каэфіцыентаў фільтра, якія адносяцца да атрымання найменшага сярэдняга квадрата сігналу памылкі (розніца паміж жаданым, 2-м уваходным аўдыяпатокам, і фактычным сігналам, 1-м уваходным аўдыяпатокам).
Далей апісваюцца прынятыя варыянты.
order
Усталяваць парадак фільтраў.
mu
Усталюйце фільтр mu.
eps
Ўсталяваць фільтр eps.
leakage
Усталюйце ўцечку фільтра.
out_mode
Ён прымае наступныя значэнні:
i
Прайсці 1-ы ўваход.
d
Прайдзіце 2-і ўваход.
o
Перадайце адфільтраваныя ўзоры.
n
Розніца ў перадачы жаданых і адфільтраваных узораў.
Значэнне па змаўчанні -
o
.
8.37.1 Examples
- Адным з многіх варыянтаў выкарыстання гэтага фільтра з'яўляецца памяншэнне шуму, уваходны аўдыё фільтруецца з аднолькавымі выбаркамі, якія затрымліваюцца на фіксаваную велічыню, адзін з такіх прыкладаў для стэрэааўдыя:
asplit[a][b],[a]adelay=32S|32S[a],[b][a]anlms=order=128:leakage=0.0005:mu=.5:out_mode=o
8.37.2 Commands
Гэты фільтр падтрымлівае тыя ж каманды, што і параметры, за выключэннем параметра order
.
8.38 anull
Перадайце крыніцу гуку без змен на выхад.
8.39 apad
Запоўніце канец аўдыяплыні цішынёй.
Гэта можна выкарыстоўваць разам зffmpeg
-shortest
каб пашырыць аўдыяпатокі да той жа даўжыні, што і відэапаток.
Далей апісваюцца прынятыя варыянты.
packet_size
Задаць памер пакета цішыні. Значэнне па змаўчанні - 4096.
pad_len
Усталюйце колькасць узораў маўчання, якія трэба дадаць у канец. Пасля дасягнення значэння паток спыняецца. Гэты варыянт ўзаемавыключальны з
whole_len
.whole_len
Усталюйце мінімальную агульную колькасць сэмплоў у выходным аўдыяструмені. Калі значэнне перавышае працягласць уваходнага гуку, у канцы дадаецца цішыня, пакуль не будзе дасягнута значэнне. Гэты варыянт ўзаемавыключальны з
pad_len
.pad_dur
Укажыце працягласць узораў маўчання, якія трэба дадаць. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Выкарыстоўваецца, толькі калі зададзена неадмоўнае значэнне.
whole_dur
Укажыце мінімальную агульную працягласць выхаднога гукавога патоку. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Выкарыстоўваецца, толькі калі зададзена неадмоўнае значэнне. Калі значэнне перавышае працягласць уваходнага гуку, у канцы дадаецца цішыня, пакуль не будзе дасягнута значэнне. Гэты варыянт ўзаемавыключальны з
pad_dur
Калі ніpad_len
ніwhole_len
ніpad_dur
ніwhole_dur
усталяваны параметр, фільтр дадасць цішыню ў канцы ўваходнага патоку на нявызначаны час.
Звярніце ўвагу, што для ffmpeg 4.4 і раней нульpad_dur
або
whole_dur
таксама прымусіў фільтр дадаць цішыню на нявызначаны час.
8.39.1 Examples
- Дадайце 1024 сэмплы цішыні ў канец уводу:
apad=pad_len=1024
- Пераканайцеся, што аўдыявыхад будзе ўтрымліваць не менш за 10000 сэмплоў, пры неабходнасці запоўніце ўваход цішынёй:
apad=whole_len=10000
- Выкарыстоўвайце
ffmpeg
для запаўнення гукавога ўваходу цішынёй, каб відэаплынь заўсёды была самай кароткай і пераўтваралася да канца ў выходны файл пры выкарыстанніshortest
варыянт:ffmpeg -i VIDEO -i AUDIO -filter_complex "[1:0]apad" -shortest OUTPUT
8.40 aphaser
Дадайце эфект фазіроўкі да ўваходнага гуку.
Фазерны фільтр стварае серыі пікаў і спадаў у частотным спектры. Палажэнне пікаў і спадаў мадулюецца такім чынам, што яны змяняюцца з цягам часу, ствараючы размашысты эфект.
Далей апісваюцца прынятыя параметры.
in_gain
Задаць уваходнае ўзмацненне. Па змаўчанні 0,4.
out_gain
Усталюйце ўзмацненне выхаду. Па змаўчанні 0,74
delay
Усталюйце затрымку ў мілісекундах. Па змаўчанні 3.0.
decay
Набор распаду. Па змаўчанні 0,4.
speed
Усталюйце хуткасць мадуляцыі ў Гц. Па змаўчанні 0,5.
type
Усталюйце тып мадуляцыі. Па змаўчанні трохкутны.
Ён прымае наступныя значэнні:
- '
triangular, t
' - '
sinusoidal, s
'
- '
8.41 aphaseshift
Прымяненне фазавага зруху да ўваходных аўдыясэмплаў.
Фільтр прымае наступныя параметры:
shift
Укажыце фазавы зрух. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0,0.
level
Задаць узмацненне выхаду, прымененае да канчатковага выхаду. Дазволены дыяпазон ад 0,0 да 1,0. Значэнне па змаўчанні 1,0.
order
Устанавіць парадак фільтрацыі, які выкарыстоўваецца для фільтрацыі. Дазволены дыяпазон ад 1 да 16. Значэнне па змаўчанні - 8.
8.41.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.42 apsyclip
Ужывайце псіхаакустычны кліпер для ўваходнага аўдыёпатоку.
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].
level_out
Усталюйце ўзмацненне выхаду. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].
clip
Усталюйце значэнне пачатку абразання. Значэнне па змаўчанні - 0dBFS або 1.
diff
Выводзіць толькі адрозныя сэмплы, карысныя для праслухоўвання ўнесеных скажэнняў. Па змаўчанні адключана.
adaptive
Зададзеная сіла прымененага адаптыўнага скажэння. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.
iterations
Задайце колькасць ітэрацый псіхаакустычнага кліпера. Дазволены дыяпазон ад 1 да 20. Значэнне па змаўчанні - 10.
level
Аўтаматычны ўзровень выхаднога сігналу. Па змаўчанні адключана. Гэта нармалізуе гук назад да 0dBFS, калі ўключана.
8.42.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.43 apulsator
Аудио пульсатор - гэта нешта сярэдняе паміж автопаннером і трэмала. Але ён таксама можа ствараць пацешныя стэрээфекты. Pulsator змяняе гучнасць левага і правага каналаў на аснове LFO (нізкачашчыннага генератара) з рознымі формамі сігналаў і зрухам фаз. Гэты фільтр мае магчымасць вызначыць зрушэнне паміж левым і правым каналам. Зрушэнне 0 азначае, што абедзве формы LFO супадаюць адна з адной. Левы і правы канал зменены аднолькава - звычайнае трэмала. Зрушэнне ў 50% азначае, што форма правага канала дакладна зрушана па фазе (або ссунутая назад прыкладна на палову частаты) - пульсатар дзейнічае як аўтапаннер. Пры 1 абедзве крывыя зноў супадаюць. Кожная налада паміж імі перамяшчае фазавы зрух без зазору паміж усімі этапамі і стварае некаторыя "абыходныя" гукі з сінусоіднай і трохкутнай формамі хваль.
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].
level_out
Усталюйце ўзмацненне выхаду. Па змаўчанні гэта 1. Дыяпазон [0,015625 - 64].
mode
Усталюйце форму хвалі, якую будзе выкарыстоўваць LFO. Можа быць адным з: сінус, трохвугольнік, квадрат, распілоўка або распілоўка. Па змаўчанні - сінус.
amount
Усталюйце мадуляцыю. Вызначце, на якую частку зыходнага сігналу ўплывае LFO.
offset_l
Усталюйце зрушэнне левага канала. Па змаўчанні 0. Дазволены дыяпазон [0 - 1].
offset_r
Усталюйце зрушэнне правага канала. Па змаўчанні 0,5. Дазволены дыяпазон [0 - 1].
width
Усталюйце шырыню імпульсу. Па змаўчанні 1. Дазволены дыяпазон [0 - 2].
timing
Усталюйце магчымы рэжым часу. Можа быць адным з: bpm, ms або Hz. Па змаўчанні - hz.
bpm
Задаць удары ў хвіліну. Па змаўчанні 120. Дазволены дыяпазон [30 - 300]. Выкарыстоўваецца, толькі калі час усталяваны на уд/хв.
ms
Усталяваць мс. Па змаўчанні 500. Дазволены дыяпазон [10 - 2000]. Выкарыстоўваецца, толькі калі час усталяваны ў мс.
hz
Усталюйце частату ў Гц. Па змаўчанні 2. Дазволены дыяпазон [0,01 - 100]. Выкарыстоўваецца, толькі калі час усталяваны ў Гц.
8.44 aresample
Паўтарыце выбарку ўваходнага аўдыя да зададзеных параметраў з дапамогай бібліятэкі libswresample. Калі ні адзін з іх не пазначаны, то фільтр будзе аўтаматычна пераўтварацца паміж уваходам і выхадам.
Гэты фільтр таксама здольны расцягваць/сціскаць аўдыядадзеныя, каб яны адпавядалі пазнакам часу, або ўводзіць цішыню/выключаць аўдыя, каб яны адпавядалі пазнакам часу, камбінаваць абодва або не рабіць ні тое, ні другое.
Фільтр прымае сінтаксіс [ sample_rate
:] resampler_options
, дзе sample_rate
выражае частату выбаркі і resampler_options
ўяўляе сабой спіс
пар key
= value
, падзеленых знакам ":".
Поўны спіс падтрымоўваных параметраў
глядзіце ў раздзеле
(ffmpeg-resampler) «Параметры Resampler» у кіраўніцтве ffmpeg-resampler(1) .
8.44.1 Examples
- Паўтарыце выбарку ўваходнага гуку да 44100 Гц:
aresample=44100
- Расцягнуць/сціснуць выбаркі да зададзеных часовых пазнак з кампенсацыяй максімум 1000 выбарак у секунду:
aresample=async=1000
8.45 areverse
Перавярнуць аўдыёкліп.
Папярэджанне: гэтаму фільтру патрабуецца памяць для буферызацыі ўсяго кліпа, таму рэкамендуецца абрэзаць.
8.45.1 Examples
- Вазьміце першыя 5 секунд кліпа і перавярніце яго назад.
atrim=end=5,areverse
8.46 arnndn
Паменшыце шум ад прамовы з дапамогай перыядычных нейронавых сетак.
Гэты фільтр прымае наступныя параметры:
model, m
Задаць файл мадэлі цягніка для загрузкі. Гэтая опцыя заўсёды патрабуецца.
mix
Устанавіць, колькі змешваць адфільтраваныя ўзоры ў канчатковы вынік. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 1. Адмоўныя значэнні з'яўляюцца асаблівымі, яны ўсталёўваюць, колькі ўтрымліваць адфільтраваны шум у канчатковым вывадзе фільтра. Усталюйце гэты параметр на -1, каб пачуць фактычны шум, выдалены з уваходнага сігналу.
8.46.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.47 asdr
Вымерайце стаўленне гукавога сігналу да скажэнняў.
Гэты фільтр прымае два аўдыяпатокі для ўваходу і выводзіць першы аўдыяпаток. Вынікі ў дБ на канал у канцы любога ўваходу.
8.48 asetnsamples
Усталюйце колькасць выбарак на кожны выхадны гукавы кадр.
Апошні выходны пакет можа змяшчаць іншую колькасць выбарак, паколькі фільтр ачысціць усе астатнія выбаркі, калі ўваходны аўдыё сігналізуе аб яго заканчэнні.
Фільтр прымае наступныя параметры:
nb_out_samples, n
Усталюйце колькасць кадраў на кожны выхадны гукавы кадр. Колькасць прызначана як колькасць выбарак на кожны канал . Значэнне па змаўчанні - 1024.
pad, p
Калі ўстаноўлена ў 1, фільтр будзе дапаўняць апошні аўдыёкадр нулямі, так што апошні кадр будзе ўтрымліваць такую ​​ж колькасць выбарак, як і папярэднія. Значэнне па змаўчанні - 1.
Напрыклад, каб усталяваць колькасць узораў на кадр 1234 і адключыць запаўненне для апошняга кадра, выкарыстоўвайце:
asetnsamples=n=1234:p=0
8.49 asetrate
Усталюйце частату дыскрэтызацыі без змены даных PCM. Гэта прывядзе да змены хуткасці і вышыні.
Фільтр прымае наступныя параметры:
sample_rate, r
Усталюйце частату выбаркі вываду. Па змаўчанні 44100 Гц.
8.50 ashowinfo
Паказаць радок, які змяшчае розную інфармацыю для кожнага ўваходнага аўдыякадра. Уваходны аўдыё не зменены.
Паказаны радок змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе
key
: value
.
У вывадзе паказаны наступныя значэнні:
n
(Парадкавы) нумар уваходнага кадра, пачынаючы з 0.
pts
Пазнака часу прадстаўлення ўваходнага кадра ў адзінках асноўнага часу; развага часу залежыць ад уваходнай пляцоўкі фільтра і звычайна складае 1/
sample_rate
.pts_time
Метка часу прэзентацыі ўваходнага кадра ў секундах.
pos
пазіцыя кадра ва ўваходным патоку, -1, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага аўдыя)
fmt
Фармат ўзору.
chlayout
Макет канала.
rate
Частата дыскрэтызацыі для аўдыякадра.
nb_samples
Колькасць выбарак (на канал) у кадры.
checksum
Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) аўдыядадзеных. Для планарнага аўдыя даныя апрацоўваюцца так, як калі б усе плоскасці былі злучаныя.
plane_checksums
Спіс кантрольных сум Adler-32 для кожнай плоскасці дадзеных.
8.51 asoftclip
Прымяненне мяккай выразкі гуку.
Мяккае адсячэнне - гэта тып эфекту скажэння, пры якім амплітуда сігналу насычаецца ўздоўж гладкай крывой, а не рэзкай формы жорсткага адсячэння.
Гэты фільтр прымае наступныя параметры:
type
Усталюйце тып мяккага кліпінгу.
Ён прымае наступныя значэнні:
hard
tanh
atan
cubic
exp
alg
quintic
sin
erf
threshold
Усталюйце парог, з якога трэба пачынаць абразанне. Значэнне па змаўчанні - 0 дБ або 1.
output
Задаць узмацненне, якое прымяняецца да выхаду. Значэнне па змаўчанні - 0 дБ або 1.
param
Усталюйце дадатковы параметр, які кіруе сігмападобнай функцыяй.
oversample
Задаць каэфіцыент перадвыбаркі.
8.51.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.52 aspectralstats
Адлюстраванне статыстычнай інфармацыі аб аўдыёканалах у частотнай вобласці. Статыстыка разлічваецца і захоўваецца ў выглядзе метададзеных для кожнага аўдыяканала і для кожнага аўдыякадра.
Ён прымае наступны варыянт:
win_size
Задайце даўжыню акна ва ўзорах. Значэнне па змаўчанні - 2048. Дазволены дыяпазон ад 32 да 65536.
win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann, hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Па змаўчанні
hann
.- '
overlap
Усталюйце перакрыцце вокнаў. Дазволены дыяпазон ад
0
да1
. Значэнне па змаўчанні -0.5
.
Спіс кожнага ключа метаданых ніжэй:
mean
variance
centroid
spread
skewness
kurtosis
entropy
flatness
crest
flux
slope
decrease
rolloff
8.53 asr
Аўтаматычнае распазнаванне гаворкі
Гэты фільтр выкарыстоўвае PocketSphinx для распазнання маўлення. Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай
--enable-pocketsphinx
.
Ён прымае наступныя варыянты:
rate
Задаць частату дыскрэтызацыі ўваходнага гуку. Па змаўчанні гэта
16000
. Гэта павінна адпавядаць маўленчым мадэлям, інакш вы атрымаеце дрэнныя вынікі.hmm
Усталяваць слоўнік, які змяшчае файлы акустычнай мадэлі.
dict
Усталяваць слоўнік вымаўлення.
lm
Усталяваць файл моўнай мадэлі.
lmctl
Набор моўных мадэляў.
lmname
Усталюйце, якую моўную мадэль выкарыстоўваць.
logfn
Задаць вывад для паведамленняў журнала.
Фільтр экспартуе распазнанае маўленне як метаданыя фрэйма lavfi.asr.text
.
8.54 astats
Адлюстраванне статыстычнай інфармацыі пра аўдыяканалы ў часовай вобласці. Статыстычныя дадзеныя разлічваюцца і адлюстроўваюцца для кожнага аўдыяканала, і, дзе гэта дастасавальна, таксама даецца агульная лічба.
Ён прымае наступны варыянт:
length
Кароткая даўжыня акна ў секундах, якая выкарыстоўваецца для вымярэння піка і мінімуму RMS. Па змаўчанні
0.05
(50 мілісекунд). Дазволены дыяпазон[0 - 10]
.metadata
-
Усталяваць увядзенне метададзеных. Усе ключы метададзеных маюць прэфікс
lavfi.astats.X
, дзеX
нумар канала, пачынаючы з 1, або радокOverall
. Па змаўчанні адключана.Даступныя ключы для кожнага канала: DC_offset Min_level Max_level Min_difference Max_difference Mean_difference RMS_difference Peak_level RMS_peak RMS_trough Crest_factor Flat_factor Peak_count Noise_floor Noise_floor_count Entropy Bit_depth Dynamic_range Zero_crossings Zero_crossings_rate Number_of_Nafnormals Number_of_
і для Overall: DC_offset Min_level Max_level Min_difference Max_difference Mean_difference RMS_difference Peak_level RMS_level RMS_peak RMS_trough Flat_factor Peak_count Noise_floor Noise_floor_count Entropy Bit_depth Number_of_samples Number_of_naNs Number_of_Infs Number_of_denormals
Напрыклад, поўны ключ выглядае так
lavfi.astats.1.DC_offset
ці такlavfi.astats.Overall.Peak_count
.Для апісання значэнняў кожнай клавішы чытайце ніжэй.
reset
Усталюйце колькасць кадраў, для якіх разлічваецца сукупная статыстыка перад скідам. Па змаўчанні адключана.
measure_perchannel
Выберыце параметры, якія вымяраюцца для кожнага канала. Ключы метададзеных могуць выкарыстоўвацца як сцягі, па змаўчанні
all
які вымярае ўсё.none
адключае вымярэнне ўсіх каналаў.measure_overall
Выберыце параметры, якія вымяраюцца ў цэлым. Ключы метададзеных могуць выкарыстоўвацца як сцягі, па змаўчанні
all
які вымярае ўсё.none
адключае ўсе агульныя вымярэнні.
Далей апісваецца кожны паказаны параметр:
DC offset
Зрушэнне сярэдняй амплітуды ад нуля.
Min level
Мінімальны ўзровень выбаркі.
Max level
Максімальны ўзровень выбаркі.
Min difference
Мінімальная розніца паміж двума паслядоўнымі ўзорамі.
Max difference
Максімальная розніца паміж двума паслядоўнымі выбаркамі.
Mean difference
Сярэдняя розніца паміж двума паслядоўнымі ўзорамі. Сярэдняе значэнне кожнай розніцы паміж двума паслядоўнымі выбаркамі.
RMS difference
Сярэднеквадратычная розніца паміж двума паслядоўнымі выбаркамі.
Peak level dB
RMS level dB
Стандартны пікавы і сярэднеквадратычны ўзровень, вымераны ў dBFS.
RMS peak dB
RMS trough dB
Пікавыя і мінімальныя значэнні для ўзроўню RMS, вымераныя на працягу кароткага акна.
Crest factor
Стандартнае стаўленне піка да сярэднеквадратычнага ўзроўню (заўвага: не ў дБ).
Flat factor
Раўнамернасць (г.зн. паслядоўныя выбаркі з аднолькавым значэннем) сігналу на яго пікавых узроўнях (г.зн. альбо
Min level
абоMax level
).Peak count
Колькасць выпадкаў (а не колькасць выбарак), калі сігнал дасягаў альбо
Min level
абоMax level
.Noise floor dB
Мінімальны лакальны пік, вымераны ў dBFS за кароткае акно.
Noise floor count
Колькасць выпадкаў (а не колькасць выбарак), калі сігнал быў дасягнуты
Noise floor
.Entropy
Энтрапія, вымераная ва ўсім аўдыя. Энтрапія са значэннем каля 1,0 звычайна вымяраецца для белага шуму.
Bit depth
Агульная разраднасць гуку. Колькасць бітаў, якія выкарыстоўваюцца для кожнай выбаркі.
Dynamic range
Вымераны дынамічны дыяпазон гуку ў дБ.
Zero crossings
Колькасць кропак, дзе сігнал перасякае вось нулявога ўзроўню.
Zero crossings rate
Хуткасць перасячэнняў нуля і колькасць аўдыясэмплоў.
8.55 asubboost
Павялічце частоты сабвуфера.
Фільтр прымае наступныя параметры:
dry
Усталюйце сухое ўзмацненне, колькі зыходнага сігналу захоўваецца. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1,0.
wet
Усталюйце вільготнае ўзмацненне, колькасць адфільтраванага сігналу захоўваецца. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1,0.
boost
Усталюйце максімальны каэфіцыент павышэння. Дазволены дыяпазон ад 1 да 12. Значэнне па змаўчанні - 2.
decay
Усталюйце значэнне ўзмацнення затухання лініі затрымкі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,0.
feedback
Задайце значэнне зваротнай сувязі лініі затрымкі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,9.
cutoff
Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 50 да 900. Значэнне па змаўчанні - 100.
slope
Усталюйце велічыню нахілу для частаты зрэзу. Дазволены дыяпазон ад 0,0001 да 1. Значэнне па змаўчанні - 0,5.
delay
Усталюйце затрымку. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 20.
channels
Усталюйце каналы для апрацоўкі. Значэнне па змаўчанні даступна для ўсіх.
8.55.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.56 asubcut
Абрэзаць частоты сабвуфера.
Гэты фільтр дазваляе ўсталёўваць карыстацкі, больш круты спад, чым фільтр высокіх частот, і, такім чынам, здольны больш аслабляць частотны змест у паласе спынення.
Фільтр прымае наступныя параметры:
cutoff
Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 2 да 200. Значэнне па змаўчанні - 20.
order
Усталяваць парадак фільтраў. Даступныя значэнні ад 3 да 20. Значэнне па змаўчанні - 10.
level
Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
8.56.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.57 asupercut
Выразаць суперчастоты.
Фільтр прымае наступныя параметры:
cutoff
Усталюйце частату зрэзу ў герцах. Дазволены дыяпазон ад 20000 да 192000. Значэнне па змаўчанні - 20000.
order
Усталяваць парадак фільтраў. Даступныя значэнні ад 3 да 20. Значэнне па змаўчанні - 10.
level
Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
8.57.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.58 asuperpass
Прымяніць паласавы фільтр Батэрворта высокага парадку.
Фільтр прымае наступныя параметры:
centerf
Усталюйце цэнтральную частату ў герцах. Дазволены дыяпазон ад 2 да 999999. Значэнне па змаўчанні - 1000.
order
Усталяваць парадак фільтраў. Даступныя значэнні ад 4 да 20. Значэнне па змаўчанні - 4.
qfactor
Усталюйце Q-каэфіцыент. Дазволены дыяпазон ад 0,01 да 100. Значэнне па змаўчанні - 1.
level
Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 2. Значэнне па змаўчанні - 1.
8.58.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.59 asuperstop
Прымяніце палосны фільтр Батэрворта высокага парадку.
Фільтр прымае наступныя параметры:
centerf
Усталюйце цэнтральную частату ў герцах. Дазволены дыяпазон ад 2 да 999999. Значэнне па змаўчанні - 1000.
order
Усталяваць парадак фільтраў. Даступныя значэнні ад 4 да 20. Значэнне па змаўчанні - 4.
qfactor
Усталюйце Q-каэфіцыент. Дазволены дыяпазон ад 0,01 да 100. Значэнне па змаўчанні - 1.
level
Усталюйце ўзровень узмацнення ўваходнага сігналу. Дазволены дыяпазон ад 0 да 2. Значэнне па змаўчанні - 1.
8.59.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.60 atempo
Адрэгулюйце тэмп гуку.
Фільтр прымае толькі адзін параметр, тэмп гуку. Калі не пазначана, фільтр будзе прымаць намінальны тэмп 1,0. Тэмп павінен быць у дыяпазоне [0,5, 100,0].
Звярніце ўвагу, што тэмп, большы за 2, будзе прапускаць некаторыя сэмплы, а не змешваць іх. Калі па якой-небудзь прычыне гэта выклікае занепакоенасць, заўсёды можна злучыць некалькі асобнікаў тэмпу для дасягнення жаданага тэмпу прадукту.
8.60.1 Examples
- Запавольце гук да 80% тэмпу:
atempo=0.8
- Каб паскорыць гук да 300% тэмпу:
atempo=3
- Каб паскорыць аўдыё да 300% тэмпу шляхам паслядоўнага злучэння двух асобнікаў тэмпу:
atempo=sqrt(3),atempo=sqrt(3)
8.60.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
tempo
Змяніць каэфіцыент маштабу тэмпу фільтра. Сінтаксіс каманды: "
tempo
"
8.61 atilt
Прымяніць спектральны фільтр нахілу да аўдыёпатоку.
Гэты фільтр прымяняе любы нахіл спаду спектру ў любой вызначанай паласе частот.
Фільтр прымае наступныя параметры:
freq
Усталюйце цэнтральную частату нахілу ў Гц. Па змаўчанні 10000 Гц.
slope
Усталюйце кірунак нахілу схілу. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
width
Задайце шырыню нахілу. Па змаўчанні 1000. Дазволены дыяпазон ад 100 да 10000.
order
Усталюйце парадак нахільнага фільтра.
level
Усталюйце ўзровень гучнасці ўводу. Дазволены дыяпазон ад 0 да 4. Значэнне па змаўчанні - 1.
8.61.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.62 atrim
Абрэжце ўваход так, каб выхад утрымліваў адну суцэльную падчастку ўваходу.
Ён прымае наступныя параметры:
start
Метка часу (у секундах) пачатку раздзела, які трэба захаваць. Гэта значыць, узор аўдыё з пазнакай часу
start
будзе першым у вывадзе.end
Укажыце час першага ўзору аўдыя, які будзе выдалены, г.зн. узор аўдыё, які непасрэдна папярэднічае таму з пазнакай часу
end
, будзе апошнім у вывадзе.start_pts
Тое самае, што і
start
, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу пачатку ў выбарках, а не ў секундах.end_pts
Тое самае, што і
end
, за выключэннем таго, што гэты параметр усталёўвае канечную метку часу ў выбарках, а не ў секундах.duration
Максімальная працягласць вываду ў секундах.
start_sample
Нумар першага ўзору, які трэба вывесці.
end_sample
Нумар першай пробы, якую трэба адкінуць.
start
,end
, іduration
выражаюцца як характарыстыкі працягласці часу; глядзіце
(ffmpeg-utils) раздзел «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1). .
Звярніце ўвагу, што першыя два наборы параметраў пачатку/канца іduration
параметр глядзіць на пазнаку часу кадра, а параметры _sample проста падлічваюць выбаркі, якія праходзяць праз фільтр. Такім чынам, start/end_pts і start/end_sample дадуць розныя вынікі, калі пазнакі часу няправільныя, недакладныя або не пачынаюцца з нуля. Таксама звярніце ўвагу, што гэты фільтр не змяняе часовыя пазнакі. Калі вы хочаце, каб пазнакі часу вываду пачыналіся з нуля, устаўце фільтр asetpts пасля фільтра atrim.
Калі ўстаноўлена некалькі параметраў пачатку або канца, гэты фільтр спрабуе быць прагным і захаваць усе выбаркі, якія адпавядаюць хаця б аднаму з указаных абмежаванняў. Каб захаваць толькі тую частку, якая адначасова адпавядае ўсім абмежаванням, звяжыце некалькі фільтраў атрымлівання.
Значэнні па змаўчанні такія, што ўвесь увод захоўваецца. Такім чынам, можна ўсталяваць, напрыклад, толькі канчатковыя значэнні, каб захаваць усё да вызначанага часу.
Прыклады:
- Адкіньце ўсё, акрамя другой хвіліны ўводу:
ffmpeg -i INPUT -af atrim=60:120
- Захаваць толькі першыя 1000 узораў:
ffmpeg -i INPUT -af atrim=end_sample=1000
8.63 axcorrelate
Разлік нармалізаванай узаемнай карэляцыі паміж двума ўваходнымі аўдыёпатокамі.
Выніковыя выбаркі заўсёды знаходзяцца ў межах ад -1 да 1 уключна. Калі вынік 1, гэта азначае, што дзве ўваходныя выбаркі моцна карэлююць у выбраным сегменце. Вынік 0 азначае, што яны зусім не карэлююць. Калі вынік роўны -1, гэта азначае, што дзве ўваходныя выбаркі не па фазе, што азначае, што яны адмяняюць адна адну.
Фільтр прымае наступныя параметры:
size
Задайце памер сегмента, для якога разлічваецца ўзаемакарэляцыя. Па змаўчанні - 256. Дазволены дыяпазон ад 2 да 131072.
algo
Задаць алгарытм узаемнай карэляцыі. Можа быць
slow
абоfast
. Па змаўчанніslow
. Хуткі алгарытм мяркуе, што сярэднія значэнні для любога зададзенага сегмента заўсёды роўныя нулю, і, такім чынам, патрабуецца значна менш вылічэнняў. Як правіла, гэта не так, але справядліва для тыповых аўдыяпатокаў.
8.63.1 Examples
- Вылічыць карэляцыю паміж каналамі ў стэрэааўдыяпатоку:
ffmpeg -i stereo.wav -af channelsplit,axcorrelate=size=1024:algo=fast correlation.wav
8.64 bandpass
Прымяненне двухполюснага паласавога фільтра Батэрворта з цэнтральнай частатой frequency
і (3 дБ) шырынёй паласы. Thecsg
выбірае пастаяннае ўзмацненне спадніцы (пікавае ўзмацненне = Q) замест стандартнага: пастаяннае пікавае ўзмацненне 0 дБ. Фільтр зніжаецца на 6 дБ на актаву (20 дБ на дэкаду).
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце цэнтральную частату фільтра. Па змаўчанні
3000
.csg
Пастаяннае ўзмацненне спадніцы, калі ўстаноўлена 1. Па змаўчанні 0.
width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.64.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць паласавую частату. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні паласы пропуску. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню паласы пропуску. Сінтаксіс каманды: "
width
"mix, m
Змяніць палосны мікс. Сінтаксіс каманды: "
mix
"
8.65 bandreject
Прымяніце двухполюсны палосны фільтр frequency
Батэрворта з цэнтральнай частатой і шырынёй паласы (3 дБ).width
. Фільтр зніжаецца на 6 дБ на актаву (20 дБ на дэкаду).
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце цэнтральную частату фільтра. Па змаўчанні
3000
.width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.65.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць частату адхілення дыяпазону. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць bandreject width_type. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню адхілення паласы. Сінтаксіс каманды: "
width
"mix, m
Змяніць мікс bandreject. Сінтаксіс каманды: "
mix
"
8.66 bass, lowshelf
Узмацняйце або зніжайце нізкія (ніжнія) частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятара тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).
Фільтр прымае наступныя параметры:
gain, g
Дайце ўзмацненне на 0 Гц. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.
frequency, f
Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні -
100
Гц.width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Вызначце, наколькі круты пераход паліцы фільтра.
poles, p
Усталюйце колькасць палюсоў. Па змаўчанні 2.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.66.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць басовую частату. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні баса. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню баса. Сінтаксіс каманды: "
width
"gain, g
Змяніць узмацненне басу. Сінтаксіс каманды: "
gain
"mix, m
Змяніць мікс басоў. Сінтаксіс каманды: "
mix
"
8.67 biquad
Прымяніце біквадратны БІХ-фільтр з дадзенымі каэфіцыентамі. Дзе b0
, b1
, b2
і a0
, a1
, a2
- каэфіцыенты лічніка і назоўніка адпаведна. і channels
, c
пакажыце, якія каналы фільтраваць, па змаўчанні ўсе даступныя фільтруюцца.
8.67.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
a0
a1
a2
b0
b1
b2
Змяніць параметр biquad. Сінтаксіс каманды: "
value
"mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.68 bs2b
Пераўтварэнне стэрэа ў бінаўральнае Bauer, якое паляпшае праслухоўванне стэрэааўдыязапісаў у навушніках.
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-libbs2b
.
Ён прымае наступныя параметры:
profile
Папярэдне зададзены ўзровень перакрыжаванай падачы.
default
Узровень па змаўчанні (fcut=700, feed=50).
cmoy
Схема Chu Moy (fcut=700, feed=60).
jmeier
Схема Яна Майера (fcut=650, feed=95).
fcut
Частата зрэзу (у Гц).
feed
Узровень падачы (у Гц).
8.69 channelmap
Пераназначце ўваходныя каналы на новыя месцы.
Ён прымае наступныя параметры:
map
Карта каналаў ад уваходу да выхаду. Аргумент уяўляе сабой падзелены '|' спіс супастаўленняў, кожнае ў форме або . можа быць альбо назвай уваходнага канала (напрыклад, FL для пярэдніх левых), альбо яго індэксам у макеце уваходнага канала. гэта назва выхаднога канала або яго індэкс у макеце выхаднога канала. Калі не зададзены, то гэта няяўна індэкс, які пачынаецца з нуля і павялічваецца на адзінку для кожнага адлюстравання.
in_channel
-out_channel
in_channel
in_channel
out_channel
out_channel
channel_layout
Схема канала выхаднога патоку.
Калі супастаўлення няма, фільтр няяўна супастаўляе ўваходныя каналы з выходнымі, захоўваючы індэксы.
8.69.1 Examples
- Напрыклад, калі выказаць здагадку, што ўваходны файл MOV 5.1+зведзены ўніз,
ffmpeg -i in.mov -filter 'channelmap=map=DL-FL|DR-FR' out.wav
створыць выхадны файл WAV, пазначаны як стэрэа, з каналаў паніжальнага мікшавання ўваходу.
- Каб выправіць 5.1 WAV, няправільна закадаваны ў уласным парадку каналаў AAC
ffmpeg -i in.wav -filter 'channelmap=1|2|0|5|3|4:5.1' out.wav
8.70 channelsplit
Разбіце кожны канал з уваходнага аўдыёпатоку ў асобны выходны паток.
Ён прымае наступныя параметры:
channel_layout
Схема канала ўваходнага патоку. Па змаўчанні - "стэрэа".
channels
Макет канала, які апісвае каналы, якія будуць здабывацца як асобныя выхадныя патокі, або "ўсе", каб выдзяляць кожны ўваходны канал як асобны паток. Па змаўчанні - "усе".
Выбар каналаў, якіх няма ў макеце каналаў ва ўваходных дадзеных, прывядзе да памылкі.
8.70.1 Examples
- Напрыклад, калі выказаць здагадку, што ўваходны стэрэафайл MP3,
ffmpeg -i in.mp3 -filter_complex channelsplit out.mkv
створыць выхадны файл Matroska з двума аўдыяпатокамі, адзін з якіх змяшчае толькі левы канал, а другі - правы канал.
- Разбіць файл 5.1 WAV на файлы для кожнага канала:
ffmpeg -i in.wav -filter_complex 'channelsplit=channel_layout=5.1[FL][FR][FC][LFE][SL][SR]' -map '[FL]' front_left.wav -map '[FR]' front_right.wav -map '[FC]' front_center.wav -map '[LFE]' lfe.wav -map '[SL]' side_left.wav -map '[SR]' side_right.wav
- Выняць толькі LFE з файла 5.1 WAV:
ffmpeg -i in.wav -filter_complex 'channelsplit=channel_layout=5.1:channels=LFE[LFE]' -map '[LFE]' lfe.wav
8.71 chorus
Дадайце эфект хору да аўдыя.
Можа выдаваць адзіны вакальны гук, як хор, але таксама можа прымяняцца да інструментаў.
Хор нагадвае эфект рэха з кароткай затрымкай, але ў той час як у рэха затрымка пастаянная, у хору яна вар'іруецца з дапамогай сінусоіднай або трохкутнай мадуляцыі. Глыбіня мадуляцыі вызначае дыяпазон прайгравання мадуляванай затрымкі да або пасля затрымкі. Такім чынам, адкладзены гук будзе гучаць павольней або хутчэй, гэта значыць адкладзены гук, настроены вакол арыгінальнага, напрыклад, у прыпеве, дзе некаторыя вакалы крыху зрушаныя.
Ён прымае наступныя параметры:
in_gain
Задаць уваходнае ўзмацненне. Па змаўчанні 0,4.
out_gain
Усталюйце ўзмацненне выхаду. Па змаўчанні 0,4.
delays
Усталюйце затрымкі. Звычайная затрымка складае ад 40 да 60 мс.
decays
Набор распадаецца.
speeds
Усталюйце хуткасці.
depths
Усталюйце глыбіню.
8.71.1 Examples
- Адзіная затрымка:
chorus=0.7:0.9:55:0.4:0.25:2
- Дзве затрымкі:
chorus=0.6:0.9:50|60:0.4|0.32:0.25|0.4:2|1.3
- Больш поўны гук хору з трыма затрымкамі:
chorus=0.5:0.9:50|60|40:0.4|0.32|0.3:0.25|0.4|0.3:2|2.3|1.3
8.72 compand
Сцісніце або пашырыце дынамічны дыяпазон аўдыя.
Ён прымае наступныя параметры:
attacks
decays
Спіс часу ў секундах для кожнага канала, па якім усярэдніваецца імгненны ўзровень уваходнага сігналу для вызначэння яго гучнасці.
attacks
адносіцца да павелічэння гучнасці іdecays
да памяншэння гучнасці. У большасці сітуацый час атакі (адказ на гук, які становіцца гучней) павінен быць карацей, чым час затухання, таму што чалавечае вуха больш адчувальна да раптоўнага гучнага гуку, чым да раптоўнага ціхага. Тыповае значэнне атакі складае 0,3 секунды, а тыповае значэнне распаду - 0,8 секунды. Калі зададзеная колькасць атак і спадаў меншая за колькасць каналаў, для ўсіх астатніх каналаў будзе выкарыстоўвацца апошняя ўстаноўленая атака/распад.points
Спіс кропак для перадаткавай функцыі, указаных у дБ адносна максімальна магчымай амплітуды сігналу. Кожны спіс ключавых пунктаў павінен быць вызначаны з дапамогай наступнага сінтаксісу:
x0/y0|x1/y1|x2/y2|....
абоx0/y0 x1/y1 x2/y2 ....
Уваходныя значэнні павінны быць у парадку строга ўзрастання, але перадаткавая функцыя не павінна манатонна ўзрастаць. Кропка
0/0
мяркуецца, але можа быць перавызначана (па0/out-dBn
). Тыповыя значэнні перадаткавай функцыі:-70/-70|-60/-20|1/0
.soft-knee
Усталюйце радыус крывой у дБ для ўсіх стыкаў. Па змаўчанні 0,01.
gain
Усталюйце дадатковае ўзмацненне ў дБ, якое будзе прымяняцца ва ўсіх кропках перадаткавай функцыі. Гэта дазваляе лёгка рэгуляваць агульнае ўзмацненне. Па змаўчанні гэта 0.
volume
Усталюйце пачатковую гучнасць у дБ, якая будзе прымацца для кожнага канала пры пачатку фільтрацыі. Гэта дазваляе карыстальніку першапачаткова задаць намінальны ўзровень, каб, напрыклад, вельмі вялікае ўзмацненне не прымянялася да пачатковых узроўняў сігналу да таго, як пачне дзейнічаць кампандаванне. Тыповае значэнне для гуку, які першапачаткова ціхі, складае -90 дБ. Па змаўчанні гэта 0.
delay
Усталюйце затрымку ў секундах. Уваходны аўдыё аналізуецца неадкладна, але аўдыё затрымліваецца перад тым, як паступіць на рэгулятар гучнасці. Вызначэнне затрымкі, прыблізна роўнай часу атакі/спаду, дазваляе фільтру эфектыўна працаваць у рэжыме прагназавання, а не ў рэактыўным рэжыме. Па змаўчанні гэта 0.
8.72.1 Examples
- Стварыце музыку як з ціхімі, так і з гучнымі фрагментамі, прыдатнай для праслухоўвання ў шумнай абстаноўцы:
compand=.3|.3:1|1:-90/-60|-60/-40|-40/-30|-20/-20:6:0:-90:0.2
Іншы прыклад аўдыя з часткамі шэпту і выбуху:
compand=0|0:1|1:-90/-900|-70/-70|-30/-9|0/-3:6:0:0:0
- Шумавы гейт, калі ўзровень шуму ніжэйшы за ўзровень сігналу:
compand=.1|.1:.2|.2:-900/-900|-50.1/-900|-50/-50:.01:0:-90:.1
- Вось яшчэ адзін шумавы гейт, на гэты раз для тых выпадкаў, калі ўзровень шуму перавышае ўзровень сігналу (шмат у чымсьці падобны на шумоподавитель):
compand=.1|.1:.1|.1:-45.1/-45.1|-45/-900|0/-900:.01:45:-90:.1
- Сціск 2:1, пачынаючы з -6 дБ:
compand=points=-80/-80|-6/-6|0/-3.8|20/3.5
- Сціск 2:1, пачынаючы з -9 дБ:
compand=points=-80/-80|-9/-9|0/-5.3|20/2.9
- Сціск 2:1, пачынаючы з -12 дБ:
compand=points=-80/-80|-12/-12|0/-6.8|20/1.9
- Сціск 2:1, пачынаючы з -18 дБ:
compand=points=-80/-80|-18/-18|0/-9.8|20/0.7
- Сціск 3:1, пачынаючы з -15 дБ:
compand=points=-80/-80|-15/-15|0/-10.8|20/-5.2
- Кампрэсар/Гейт:
compand=points=-80/-105|-62/-80|-15.4/-15.4|0/-12|20/-7.6
- пашыральнік:
compand=attacks=0:points=-80/-169|-54/-80|-49.5/-64.6|-41.1/-41.1|-25.8/-15|-10.8/-4.5|0/0|20/8.3
- Жорсткі абмежавальнік на -6 дБ:
compand=attacks=0:points=-80/-80|-6/-6|20/-6
- Жорсткі абмежавальнік пры -12 дБ:
compand=attacks=0:points=-80/-80|-12/-12|20/-12
- Жорсткі шумавы гейт пры -35 дБ:
compand=attacks=0:points=-80/-115|-35.1/-80|-35/-35|20/20
- Мяккі абмежавальнік:
compand=attacks=0:points=-80/-80|-12.4/-12.4|-6/-8|0/-6.8|20/-2.8
8.73 compensationdelay
Лінія затрымкі кампенсацыі - гэта заснаваная на метрыцы затрымка для кампенсацыі рознага становішча мікрафонаў або дынамікаў.
Напрыклад, вы запісалі гітару з дапамогай двух мікрафонаў, размешчаных у розных месцах. Паколькі ў нармальных умовах фронт гукавой хвалі мае фіксаваную хуткасць, фаза мікрафонаў можа адрознівацца і залежыць ад іх месцазнаходжання і ўзаемаразмяшчэння. Найлепшы гукавы мікс можа быць дасягнуты, калі гэтыя мікрафоны знаходзяцца ў фазе (сінхранізаваны). Звярніце ўвагу, што адлегласць ~30 см паміж мікрафонамі прымушае адзін мікрафон захопліваць сігнал у супрацьфазе з іншым мікрафонам. Гэта робіць канчатковы мікс капрызным. Гэты фільтр дапамагае вырашыць праблемы фазіроўкі, дадаючы розныя затрымкі да кожнай дарожкі мікрафона і робячы іх сінхранізаванымі.
Найлепшага выніку можна дасягнуць, калі ўзяць за аснову адзін трэк і сінхранізаваць з ім па чарзе іншыя трэкі. Памятайце, што допуск сінхранізацыі/затрымкі таксама залежыць ад частаты дыскрэтызацыі. Больш высокая частата выбаркі дасць большую талерантнасць.
Фільтр прымае наступныя параметры:
mm
Задайце адлегласць у міліметрах. Гэта адлегласць кампенсацыі для тонкай налады. Па змаўчанні 0.
cm
Усталюйце адлегласць у см. Гэта кампенсацыйная адлегласць для ўстаноўкі адлегласці зацягвання. Па змаўчанні 0.
m
Усталюйце метры адлегласці. Гэта адлегласць кампенсацыі для жорсткай налады адлегласці. Па змаўчанні 0.
dry
Усталюйце сухое колькасць. Колькасць неапрацаванага (сухога) сігналу. Па змаўчанні 0.
wet
Усталюйце вільготнае колькасць. Колькасць апрацаванага (мокрага) сігналу. Па змаўчанні 1.
temp
Усталюйце тэмпературу ў градусах Цэльсія. Гэта тэмпература навакольнага асяроддзя. Па змаўчанні 20.
8.73.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.74 crossfeed
Прымяніць фільтр для навушнікаў.
Crossfeed - гэта працэс змешвання левага і правага каналаў запісу стэрэааўдыё. Ён у асноўным выкарыстоўваецца для памяншэння экстрэмальнага стэрэападзелу нізкіх частот.
Мэта складаецца ў тым, каб стварыць для слухача гук, больш падобны да дынаміка.
Фільтр прымае наступныя параметры:
strength
Усталюйце сілу папярочнай падачы. Па змаўчанні 0,2. Дазволены дыяпазон ад 0 да 1. Гэта ўстанаўлівае ўзмацненне фільтра нізкай паліцы для бакавой часткі стэрэа выявы. Па змаўчанні - -6 дБ. Максімальна дазволена -30 дБ, калі сіла ўстаноўлена на 1.
range
Задаць шырыню гукавой сцэны. Па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1. Гэта задае частату зрэзу фільтра нізкай паліцы. Па змаўчанні адсечана каля 1550 Гц. З дыяпазонам, усталяваным на 1, частата зрэзу ўстаноўлена на 2100 Гц.
slope
Задаць нахіл крывой фільтра нізкай паліцы. Па змаўчанні 0,5. Дапушчальны дыяпазон ад 0,01 да 1.
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні 0,9.
level_out
Усталюйце ўзмацненне выхаду. Па змаўчанні 1.
block_size
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.74.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.75 crystalizer
Просты алгарытм для павышэння рэзкасці гуку.
Гэты фільтр лінейна павялічвае адрозненні паміж кожным узорам аўдыя.
Фільтр прымае наступныя параметры:
i
Задае інтэнсіўнасць эфекту (па змаўчанні: 2.0). Павінна быць у дыяпазоне ад -10,0 да 0 (нязменны гук) да 10,0 (максімальны эфект). Для зваротнай фільтрацыі выкарыстоўвайце адмоўнае значэнне.
c
Уключыць выразку. Па змаўчанні ўключана.
8.75.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.76 dcshift
Прымяніць зрух пастаяннага току да аўдыя.
Гэта можа быць карысна для выдалення зрушэння пастаяннага току (выкліканага, магчыма, апаратнай праблемай у ланцужку запісу) з аўдыя. Эфект зрушэння пастаяннага току - гэта памяншэнне запасу і, такім чынам, аб'ёму. Фільтр astats можна выкарыстоўваць, каб вызначыць, ці мае сігнал зрушэнне пастаяннага току.
shift
Усталюйце зрух пастаяннага току, дазволены дыяпазон [-1, 1]. Ён паказвае колькасць зруху гуку.
limitergain
Дадаткова. Ён павінен мець значэнне значна меншае за 1 (напрыклад, 0,05 або 0,02) і выкарыстоўваецца для прадухілення абразання.
8.77 deesser
Прымяніце дээсінг да аўдыёўзораў.
i
Усталюйце інтэнсіўнасць для запуску дээсэсу. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0.
m
Усталюйце колькасць прыглушэння на высокіх частотах гуку. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0,5.
f
Колькі змесціва арыгінальнай частоты захаваць пры дээсінгу. Дазволены дыяпазон ад 0 да 1. Па змаўчанні 0,5.
s
Усталюйце рэжым вываду.
Ён прымае наступныя значэнні:
i
Увод пропуску без зменаў.
o
Pass ess адфільтраваны.
e
Перадайце толькі эс.
Значэнне па змаўчанні -
o
.
8.78 dialoguenhance
Паляпшэнне дыялогу ў стэрэааўдыё.
Гэты фільтр прымае ўваход стэрэа і стварае выходныя каналы аб'ёмнага гуку (3.0). Нядаўна выраблены пярэдні цэнтральны канал мае пашыраны маўленчы дыялог, першапачаткова даступны ў абодвух стэрэаканалах. Гэты фільтр выдае пярэдні левы і пярэдні правы каналы, такія ж, як і ў стэрэа ўваходзе.
Фільтр прымае наступныя параметры:
original
Усталюйце зыходны цэнтральны каэфіцыент, каб захаваць выхад на пярэдні цэнтральны канал. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
enhance
Усталюйце каэфіцыент узмацнення дыялогу для вываду пярэдняга цэнтральнага канала. Дазволены дыяпазон ад 0 да 3. Значэнне па змаўчанні - 1.
voice
Усталюйце каэфіцыент выяўлення голасу. Дазволены дыяпазон ад 2 да 32. Значэнне па змаўчанні - 2.
8.78.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.79 drmeter
Вымерайце дынамічны дыяпазон гуку.
Значэнні DR 14 і вышэй сустракаюцца ў вельмі дынамічным матэрыяле. DR ад 8 да 13 знаходзіцца ў пераходным матэрыяле. І ўсё, што менш за 8, мае вельмі дрэнную дынаміку і моцна сціскаецца.
Фільтр прымае наступныя параметры:
length
Задаць працягласць акна ў секундах, якое выкарыстоўваецца для падзелу аўдыя на сегменты аднолькавай даўжыні. Па змаўчанні 3 секунды.
8.80 dynaudnorm
Дынамічны нармалізатар гуку.
Гэты фільтр прымяняе пэўную колькасць узмацнення да ўваходнага гуку, каб давесці яго пікавую велічыню да мэтавага ўзроўню (напрыклад, 0 dBFS). Аднак, у адрозненне ад больш "простых" алгарытмаў нармалізацыі, Dynamic Audio Normalizer *дынамічна* рэгулюе каэфіцыент узмацнення для ўваходнага гуку. Гэта дазваляе прымяніць дадатковае ўзмацненне да "ціхіх" участкаў аўдыя, пазбягаючы пры гэтым скажэнняў або абразання "гучных" участкаў. Іншымі словамі: Dynamic Audio Normalizer будзе "выраўноўваць" гучнасць ціхіх і гучных секцый, у тым сэнсе, што гучнасць кожнай секцыі будзе даведзена да аднаго мэтавага ўзроўню. Звярніце ўвагу, аднак, што Dynamic Audio Normalizer дасягае гэтай мэты *без* прымянення «сціску дынамічнага дыяпазону». Ён захавае 100% дынамічнага дыяпазону *ўнутры* кожнага раздзела аўдыяфайла.
framelen, f
Усталюйце працягласць кадра ў мілісекундах. У дыяпазоне ад 10 да 8000 мілісекунд. Па змаўчанні 500 мілісекунд. Dynamic Audio Normalizer апрацоўвае ўваходны аўдыё невялікімі кавалкамі, якія называюцца кадрамі. Гэта неабходна, таму што пікавая велічыня не мае значэння толькі для аднаго значэння выбаркі. Замест гэтага нам трэба вызначыць пікавую велічыню для бесперапыннай паслядоўнасці выбарачных значэнняў. У той час як "стандартны" нармалізатар будзе проста выкарыстоўваць пікавую велічыню поўнага файла, Dynamic Audio Normalizer вызначае пікавую велічыню індывідуальна для кожнага кадра. Даўжыня кадра задаецца ў мілісекундах. Па змаўчанні Dynamic Audio Normalizer выкарыстоўвае даўжыню кадра 500 мілісекунд, што дае добрыя вынікі для большасці файлаў. Звярніце ўвагу, што дакладная даўжыня кадра ў колькасці выбарак будзе вызначацца аўтаматычна,
gausssize, g
Усталюйце памер акна фільтра Гаўса. У дыяпазоне ад 3 да 301 нумар павінен быць няцотным. Па змаўчанні - 31. Напэўна, самым важным параметрам Dynamic Audio Normalizer з'яўляецца
window size
фільтра згладжвання Гаўса. Памер акна фільтра вызначаецца ў фрэймах з цэнтрам вакол бягучага фрэйма. Дзеля прастаты гэта павінна быць няцотная лічба. Такім чынам, значэнне па змаўчанні 31 улічвае бягучы кадр, а таксама 15 папярэдніх кадраў і 15 наступных кадраў. Выкарыстанне большага акна прыводзіць да больш моцнага эфекту згладжвання і, такім чынам, да меншай варыяцыі ўзмацнення, г.зн. больш павольнай адаптацыі ўзмацнення. І наадварот, выкарыстанне меншага акна прыводзіць да слабейшага эфекту згладжвання і, такім чынам, да большай варыяцыі ўзмацнення, г.зн. да больш хуткай адаптацыі ўзмацнення. Іншымі словамі, чым больш вы павялічваеце гэта значэнне, тым больш Dynamic Audio Normalizer будзе паводзіць сябе як «традыцыйны» фільтр нармалізацыі. Наадварот, чым больш вы памяншаеце гэта значэнне, тым больш Dynamic Audio Normalizer будзе паводзіць сябе як кампрэсар дынамічнага дыяпазону.peak, p
Усталюйце мэтавае пікавае значэнне. Гэта вызначае самы высокі дапушчальны ўзровень велічыні для нармалізаванага ўваходнага гуку. Гэты фільтр будзе спрабаваць наблізіцца да мэтавай пікавай велічыні як мага бліжэй, але ў той жа час ён таксама гарантуе, што нармалізаваны сігнал ніколі не будзе перавышаць пікавую велічыню. Максімальны лакальны каэфіцыент узмацнення кадра залежыць непасрэдна ад зададзенай пікавай велічыні. Значэнне па змаўчанні складае 0,95 і, такім чынам, пакідае запас у 5%*. Вышэй гэтага значэння не рэкамендуецца.
maxgain, m
Усталюйце максімальны каэфіцыент узмацнення. У дыяпазоне ад 1,0 да 100,0. Па змаўчанні 10.0. Dynamic Audio Normalizer вызначае максімальна магчымы (лакальны) каэфіцыент узмацнення для кожнага ўваходнага кадра, г.зн. максімальны каэфіцыент узмацнення, які не прыводзіць да адсячэння або скажэння. Максімальны каэфіцыент узмацнення вызначаецца выбаркай найбольшай велічыні кадра. Аднак Dynamic Audio Normalizer дадаткова абмяжоўвае максімальны каэфіцыент узмацнення кадра загадзя вызначаным (глабальным) максімальным каэфіцыентам узмацнення. Гэта робіцца для таго, каб пазбегнуць празмерных каэфіцыентаў узмацнення ў «ціхіх» або амаль бясшумных кадрах. Па змаўчанні максімальны каэфіцыент узмацнення складае 10,0. Для большасці уваходаў значэння па змаўчанні павінна быць дастаткова, і звычайна не рэкамендуецца павялічваць гэта значэнне. Аднак для ўводу з вельмі нізкім агульным узроўнем гучнасці можа спатрэбіцца дазволіць нават больш высокія каэфіцыенты ўзмацнення. Нататка, аднак, што Dynamic Audio Normalizer не проста прымяняе "жорсткі" парог (г.зн. адсякае значэнні вышэй парога). Замест гэтага будзе прымяняцца "сігмападобная" парогавая функцыя. Такім чынам, каэфіцыенты ўзмацнення плаўна набліжаюцца да парогавага значэння, але ніколі не перавышаюць яго.
targetrms, r
Усталюйце мэтавую RMS. У дыяпазоне ад 0,0 да 1,0. Па змаўчанні 0.0 - адключана. Па змаўчанні Dynamic Audio Normalizer выконвае «пікавую» нармалізацыю. Гэта азначае, што максімальны лакальны каэфіцыент узмацнення для кожнага кадра вызначаецца (толькі) выбаркай найбольшай велічыні кадра. Такім чынам, выбаркі могуць быць узмоцнены, наколькі гэта магчыма, без перавышэння максімальнага ўзроўню сігналу, гэта значыць без адсячэння. Аднак па жаданні Dynamic Audio Normalizer можа таксама ўлічваць сярэдняквадратычнае значэнне кадра, скарочана RMS. У электратэхніцы RMS звычайна выкарыстоўваецца для вызначэння магутнасці сігналу, які змяняецца ў часе. Таму лічыцца, што RMS з'яўляецца лепшым набліжэннем "успрыманай гучнасці", чым проста гледзячы на ​​​​пікавую велічыню сігналу. Такім чынам, наладжваючы ўсе кадры на пастаяннае сярэдняквадратычнае значэнне, аднастайны "
coupling, n
Уключыць спалучэнне каналаў. Па змаўчанні ўключана. Па змаўчанні Dynamic Audio Normalizer будзе ўзмацняць усе каналы на аднолькавую колькасць. Гэта азначае, што аднолькавы каэфіцыент узмацнення будзе прымяняцца да ўсіх каналаў, г.зн. максімальна магчымы каэфіцыент узмацнення вызначаецца самым "гучным" каналам. Аднак у некаторых запісах можа здарыцца так, што гучнасць розных каналаў нераўнамерная, напрыклад, адзін канал можа быць "цішэйшым", чым другі(-ыя). У гэтым выпадку гэтую опцыю можна выкарыстоўваць для адключэння сувязі канала. Такім чынам, каэфіцыент узмацнення будзе вызначацца незалежна для кожнага канала, у залежнасці толькі ад выбаркі найбольшай велічыні асобнага канала. Гэта дазваляе гарманізаваць гучнасць розных каналаў.
correctdc, c
Уключыць карэкцыю зрушэння пастаяннага току. Па змаўчанні адключана. Гукавы сігнал (у часовай вобласці) - гэта паслядоўнасць значэнняў выбаркі. У дынамічным нармалізатары гуку гэтыя выбарачныя значэнні прадстаўлены ў дыяпазоне ад -1,0 да 1,0, незалежна ад зыходнага фармату ўводу. Звычайна гукавы сігнал, або "форма хвалі", павінен быць сканцэнтраваны вакол нулявой кропкі. Гэта азначае, што калі мы вылічым сярэдняе значэнне ўсіх выбарак у файле або ў адным кадры, то вынік павінен быць 0,0 або, па меншай меры, вельмі блізкі да гэтага значэння. Калі, аднак, існуе значнае адхіленне сярэдняга значэння ад 0,0 у станоўчым або адмоўным кірунку, гэта называецца зрушэннем пастаяннага току або зрушэннем пастаяннага току. Паколькі зрушэнне пастаяннага току відавочна непажадана, Dynamic Audio Normalizer забяспечвае дадатковую карэкцыю зрушэння пастаяннага току. З уключанай карэкцыяй зрушэння пастаяннага току, дынамічны нармалізатар гуку вызначыць сярэдняе значэнне або зрушэнне "карэкцыі пастаяннага току" кожнага ўваходнага кадра і адніме гэта значэнне з усіх значэнняў выбаркі кадра, што гарантуе, што гэтыя выбаркі зноў будуць сканцэнтраваны вакол 0,0. Акрамя таго, каб пазбегнуць "разрываў" на межах кадра, значэнні зрушэння карэкцыі пастаяннага току будуць плаўна інтэрпалявацца паміж суседнімі кадрамі.
altboundary, b
Уключыць альтэрнатыўны рэжым межаў. Па змаўчанні адключана. Dynamic Audio Normalizer ўлічвае пэўнае суседства вакол кожнага кадра. Гэта ўключае ў сябе папярэднія кадры, а таксама наступныя кадры. Аднак для «памежных» кадраў, размешчаных у самым пачатку і ў самым канцы аўдыёфайла, даступныя не ўсе суседнія кадры. У прыватнасці, для першых некалькіх кадраў у аўдыяфайле папярэднія кадры невядомыя. І, гэтак жа, для некалькіх апошніх кадраў у аўдыяфайле наступныя кадры невядомыя. Такім чынам, узнікае пытанне, якія каэфіцыенты ўзмацнення варта лічыць для адсутных кадраў у "памежнай" вобласці. Dynamic Audio Normalizer рэалізуе два рэжымы для вырашэння гэтай сітуацыі. Гранічны рэжым па змаўчанні прадугледжвае каэфіцыент узмацнення роўна 1,0 для адсутных кадраў,
compress, s
Усталюйце каэфіцыент сціску. У дыяпазоне ад 0,0 да 30,0. Па змаўчанні 0,0. Па змаўчанні Dynamic Audio Normalizer не прымяняе «традыцыйнае» сціск. Гэта азначае, што пікі сігналу не будуць абрэзаны і, такім чынам, поўны дынамічны дыяпазон будзе захаваны ў кожным лакальным раёне. Аднак у некаторых выпадках можа быць пажадана аб'яднаць алгарытм нармалізацыі Dynamic Audio Normalizer з больш "традыцыйным" сцісканнем. Для гэтай мэты Dynamic Audio Normalizer забяспечвае дадатковую функцыю сціску (парог). Калі (і толькі калі) функцыя сціску ўключана, усе ўваходныя кадры будуць апрацаваны функцыяй мяккага парогавага значэння перад фактычным працэсам нармалізацыі. Прасцей кажучы, функцыя парогавага значэння збіраецца абрэзаць усе выбаркі, велічыня якіх перавышае пэўнае парогавае значэнне. аднак, Dynamic Audio Normalizer не проста прымяняе фіксаванае парогавае значэнне. Замест гэтага парогавае значэнне будзе карэкціравацца для кожнага асобнага кадра. Як правіла, меншыя параметры прыводзяць да больш моцнага сціску, і наадварот. Значэнні ніжэй за 3,0 не рэкамендуюцца, таму што могуць з'явіцца гукавыя скажэнні.
threshold, t
Усталюйце мэтавае парогавае значэнне. Гэта вызначае найменшую дапушчальную велічыню для ўваходнага гуку, які будзе нармалізаваны. Калі аб'ём уваходнага кадра перавышае гэты фрэйм ​​значэння, ён будзе нармалізаваны. У адваротным выпадку кадр можа наогул не нармалізавацца. Па змаўчанні ўстаноўлена значэнне 0, што азначае, што ўсе ўваходныя кадры будуць нармалізаваны. Гэтая опцыя ў асноўным карысная, калі лічбавы шум не хочацца ўзмацняць.
channels, h
Укажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя каналы.
overlap, o
Укажыце перакрыцце для кадраў. Калі ўстаноўлена 0 (па змаўчанні), перакрыцце кадраў не адбываецца. Выкарыстанне значэнняў >0 і <1 прывядзе да менш кансерватыўных карэкціровак узмацнення, напрыклад, калі параметр Framelen усталяваны на меншае значэнне, калі значэнне параметра Framelen кампенсуецца за ненулявое перакрыцце, тады карэкціроўкі ўзмацнення будуць больш плыўнымі з цягам часу ў параўнанні з нулявым перакрыццем.
8.80.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.81 earwax
Зрабіце аўдыё лягчэй слухаць у навушніках.
Гэты фільтр дадае «падказкі» да стэрэа 44,1 кГц (г.зн. у фармаце аўдыё CD) аўдыя, так што пры праслухоўванні ў навушніках стэрэамалюнак перамяшчаецца з галавы (стандарт для навушнікаў) звонку і перад слухачом (стандарт для дынамікаў ).
Партаваны з SoX.
8.82 equalizer
Прымяніць двухполюсны пікавы эквалайзерны фільтр (EQ). З дапамогай гэтага фільтра ўзровень сігналу на абранай частаце і вакол яе можа быць павялічаны або паменшаны, у той час як (у адрозненне ад паласавых фільтраў і фільтраў палоснага адхілення) ён на ўсіх іншых частотах не змяняецца.
Каб атрымаць складаныя крывыя выраўноўвання, гэты фільтр можна выкарыстоўваць некалькі разоў, кожны з рознай цэнтральнай частатой.
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце цэнтральную частату фільтра ў Гц.
width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type.
gain, g
Усталюйце неабходнае ўзмацненне або паслабленне ў дБ. Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.82.1 Examples
- Аслабіць 10 дБ пры 1000 Гц з паласой прапускання 200 Гц:
equalizer=f=1000:t=h:width=200:g=-10
- Прымяніць узмацненне 2 дБ на 1000 Гц з Q 1 і аслабіць 5 дБ на 100 Гц з Q 2:
equalizer=f=1000:t=q:w=1:g=2,equalizer=f=100:t=q:w=2:g=-5
8.82.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць частату эквалайзера. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні эквалайзера. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню эквалайзера. Сінтаксіс каманды: "
width
"gain, g
Змяніць узмацненне эквалайзера. Сінтаксіс каманды: "
gain
"mix, m
Змяніць мікс эквалайзера. Сінтаксіс каманды: "
mix
"
8.83 extrastereo
Лінейна павялічвае розніцу паміж левым і правым каналамі, што дадае нейкі "жывы" эфект прайграванню.
Фільтр прымае наступныя параметры:
m
Задае каэфіцыент розніцы (па змаўчанні: 2,5). 0,0 азначае монагук (сярэдняе для абодвух каналаў), пры 1,0 гук не зменіцца, пры -1,0 левы і правы каналы будуць памяняцца месцамі.
c
Уключыць выразку. Па змаўчанні ўключана.
8.83.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.84 firequalizer
Прымяніць выраўноўванне FIR з выкарыстаннем адвольнай частотнай характарыстыкі.
Фільтр прымае наступныя параметры:
gain
Задайце ўраўненне крывой узмацнення (у дБ). Выраз можа ўтрымліваць зменныя:
f
ацэненая частата
sr
частата выбаркі
ch
нумар канала, усталяваны ў 0, калі шматканальная ацэнка адключана
chid
ідэнтыфікатар канала, гл. libavutil/channel_layout.h, усталяваны ў ідэнтыфікатар першага канала, калі шматканальная ацэнка адключана
chs
колькасць каналаў
chlayout
channel_layout, гл. libavutil/channel_layout.h
і функцыі:
gain_interpolate(f)
інтэрпаляваць узмацненне на частаце f на аснове ўводу_ўзмацнення
cubic_interpolate(f)
тое ж самае, што і інтэрпаляцыя_ўзмацнення, але больш гладкая
Гэтая опцыя таксама даступная як каманда. Па змаўчанні
gain_interpolate(f)
.gain_entry
Задаць запіс узмацнення для функцыі gain_interpolate. Выраз можа ўтрымліваць функцыі:
entry(f, g)
запіс узмацнення захоўвання на частаце f са значэннем g
Гэтая опцыя таксама даступная як каманда.
delay
Усталюйце затрымку фільтра ў секундах. Больш высокае значэнне азначае больш дакладныя. Па змаўчанні
0.01
.accuracy
Усталюйце дакладнасць фільтра ў Гц. Меншае значэнне азначае больш дакладнае. Па змаўчанні
5
.wfunc
Усталяваць функцыю акна. Дапушчальныя значэнні:
rectangular
прамавугольнае акно, карысна, калі крывая ўзмацнення ўжо гладкая
hann
акно Hann (па змаўчанні)
hamming
забіванне акна
blackman
акно Блэкмана
nuttall3
3-тэрміновае бесперапыннае акно першай вытворнай
mnuttall3
мінімальна 3-тэрміновае разрывістае акно
nuttall
4-тэрміновае бесперапыннае акно першай вытворнай
bnuttall
мінімальна 4 члены разрывістае акно nuttall (Blackman-nuttall).
bharris
акно Блэкмэна-Харыса
tukey
акно цюкі
fixed
Калі ўключана, выкарыстоўваць фіксаваную колькасць узораў аўдыя. Гэта павышае хуткасць пры фільтрацыі з вялікай затрымкай. Па змаўчанні адключана.
multi
Уключыць шматканальную ацэнку ўзмацнення. Па змаўчанні адключана.
zero_phase
Уключыце рэжым нулявой фазы, адняўшы метку часу, каб кампенсаваць затрымку. Па змаўчанні адключана.
scale
Задаць маштаб, які выкарыстоўваецца ўзмацненнем. Дапушчальныя значэнні:
linlin
лінейная частата, лінейнае ўзмацненне
linlog
лінейная частата, лагарыфмічны (у дБ) узмацненне (па змаўчанні)
loglin
лагарыфмічная (у актавай шкале, дзе 20 Гц роўна 0) частата, лінейнае ўзмацненне
loglog
лагарыфмічная частата, лагарыфмічнае ўзмацненне
dumpfile
Усталяваць файл для дампа, прыдатны для gnuplot.
dumpscale
Задаць маштаб для файла дампа. Дапушчальныя значэнні супадаюць з варыянтам маштабу. Па змаўчанні - linlog.
fft2
Уключыць 2-канальную згортку з выкарыстаннем комплекснага БПФ. Гэта значна павышае хуткасць. Па змаўчанні адключана.
min_phase
Уключыць мінімальную фазавую імпульсную характарыстыку. Па змаўчанні адключана.
8.84.1 Examples
- НЧ на 1000 Гц:
firequalizer=gain='if(lt(f,1000), 0, -INF)'
- нізкія частоты на 1000 Гц з узмацненнем:
firequalizer=gain_entry='entry(1000,0); entry(1001, -INF)'
- карыстацкі эквалайзер:
firequalizer=gain_entry='entry(100,0); entry(400, -4); entry(1000, -6); entry(2000, 0)'
- больш высокая затрымка з нулявой фазай для кампенсацыі затрымкі:
firequalizer=delay=0.1:fixed=on:zero_phase=on
- НЧ на левым канале, ВЧ на правым канале:
firequalizer=gain='if(eq(chid,1), gain_interpolate(f), if(eq(chid,2), gain_interpolate(1e6+f), 0))' :gain_entry='entry(1000, 0); entry(1001,-INF); entry(1e6+1000,0)':multi=on
8.85 flanger
Прымяніць эфект флэнджэр да аўдыя.
Фільтр прымае наступныя параметры:
delay
Задаць базавую затрымку ў мілісекундах. Дыяпазон ад 0 да 30. Значэнне па змаўчанні - 0.
depth
Усталюйце дадатковую затрымку разгорткі ў мілісекундах. Дыяпазон ад 0 да 10. Значэнне па змаўчанні - 2.
regen
Усталюйце працэнт рэгенерацыі (зваротная сувязь з затрымкай сігналу). Дыяпазон ад -95 да 95. Значэнне па змаўчанні - 0.
width
Усталюйце працэнт затрымкі сігналу, змешанага з арыгінальным. Дыяпазон ад 0 да 100. Значэнне па змаўчанні - 71.
speed
Усталюйце разгорткі ў секунду (Гц). Дыяпазон ад 0,1 да 10. Значэнне па змаўчанні 0,5.
shape
Усталюйце форму хвалі, можа быць
triangular
абоsinusoidal
. Значэнне па змаўчанні -sinusoidal
.phase
Усталюйце працэнтны зрух хвалі для некалькіх каналаў. Дыяпазон ад 0 да 100. Значэнне па змаўчанні - 25.
interp
Усталюйце інтэрпаляцыю лініі затрымкі,
linear
абоquadratic
. Па змаўчанніlinear
.
8.86 haas
Прымяніць эфект Хааса да аўдыя.
Звярніце ўвагу, што гэта найбольш разумна прымяняць да монасігналаў. З дапамогай гэтага фільтра, прымененага да монасігналаў, ён дае некаторую накіраванасць і расцягвае стэрэамалюнак.
Фільтр прымае наступныя параметры:
level_in
Задаць узровень уваходнага сігналу. Па змаўчанні гэта
1
, або 0 дБlevel_out
Усталюйце ўзровень выхаду. Па змаўчанні гэта
1
, або 0 дБ.side_gain
Задаць узмацненне, якое прымяняецца да бакавой часткі сігналу. Па змаўчанні гэта
1
.middle_source
Усталюйце выгляд сярэдняй крыніцы. Можа быць адно з наступнага:
- '
left
' Выберыце левы канал.
- '
right
' Выберыце правільны канал.
- '
mid
' Абярыце сярэднюю частку сігналу стэрэа выявы.
- '
side
' Выберыце бакавую частку сігналу стэрэа выявы.
- '
middle_phase
Змена сярэдняй фазы. Па змаўчанні адключана.
left_delay
Усталюйце затрымку левага канала. Па змаўчанні гэта
2.05
мілісекунды.left_balance
Усталюйце баланс левага канала. Па змаўчанні гэта
-1
.left_gain
Усталюйце ўзмацненне левага канала. Па змаўчанні гэта
1
.left_phase
Змена левай фазы. Па змаўчанні адключана.
right_delay
Усталюйце затрымку правага канала. Па змаўчанні гэта
2.12
мілісекунды.right_balance
Усталюйце правільны баланс канала. Па змаўчанні гэта
1
.right_gain
Усталюйце правае ўзмацненне канала. Па змаўчанні гэта
1
.right_phase
Змяніць правую фазу. Па змаўчанні ўключана.
8.87 hdcd
Дэкадуе дадзеныя, сумяшчальныя з высокай выразнасцю (HDCD). 16-бітны струмень PCM з убудаванымі кодамі HDCD пашыраецца ў 20-бітны струмень PCM.
Фільтр падтрымлівае функцыі Peak Extend і Low-level Gain Adjustment для HDCD і вызначае сцяжок Transient Filter.
ffmpeg -i HDCD16.flac -af hdcd OUT24.flac
Пры выкарыстанні фільтра з wav звярніце ўвагу, што кадоўка па змаўчанні для wav - 16-бітная, таму атрыманы 20-бітны паток будзе абрэзаны назад да 16-бітнай. Выкарыстоўвайце нешта накшталт -acodec pcm_s24le
пасля фільтра, каб атрымаць 24-бітны выхад PCM.
ffmpeg -i HDCD16.wav -af hdcd OUT16.wav
ffmpeg -i HDCD16.wav -af hdcd -c:a pcm_s24le OUT24.wav
Фільтр прымае наступныя параметры:
disable_autoconvert
Адключыце аўтаматычнае пераўтварэнне фармату або паўторную выбарку ў графіцы фільтра.
process_stereo
Апрацуйце стэрэаканалы разам. Калі target_gain не супадае паміж каналамі, лічыце яго несапраўдным і выкарыстоўвайце апошні сапраўдны target_gain.
cdt_ms
Усталюйце перыяд таймера выяўлення кода ў мс.
force_pe
Заўсёды пашырайце пікі вышэй -3dBFS, нават калі сігнал PE не падаецца.
analyze_mode
Заменіце гук суцэльным тонам і адрэгулюйце амплітуду, каб сігналізаваць аб пэўным аспекте працэсу дэкадавання. Выхадны файл можа быць загружаны ў аўдыярэдактар ​​разам з арыгіналам, каб дапамагчы аналізу.
analyze_mode=pe:force_pe=true
можна выкарыстоўваць для прагляду ўсіх узораў вышэй за ўзровень PE.Рэжымы:
- '
0, off
' Інваліды
- '
1, lle
' Узровень рэгулявання ўзмацнення для кожнага ўзору
- '
2, pe
' Узоры, дзе адбываецца пашырэнне піку
- '
3, cdt
' Прыклады, у якіх актыўны таймер выяўлення кода
- '
4, tgm
' Узоры, дзе мэтавае ўзмацненне не супадае паміж каналамі
- '
8.88 headphone
Ужывайце функцыі перадачы, звязаныя з галавой (HRTF), каб стварыць вакол карыстальніка віртуальныя гучнагаварыцелі для бінауральнага праслухоўвання праз навушнікі. HRIR забяспечваюцца праз дадатковыя патокі, для кожнага канала неабходны адзін ўваходны паток стэрэа.
Фільтр прымае наступныя параметры:
map
Задаць адлюстраванне ўваходных патокаў для згорткі. Аргумент уяўляе сабой раздзелены '|' спіс назваў каналаў у парадку, калі яны даюцца ў якасці дадатковых уваходных патокаў для фільтра. Гэта таксама вызначае колькасць уваходных патокаў. Колькасць уваходных патокаў павінна быць не менш за колькасць каналаў у першым патоку плюс адзін.
gain
Задаць узмацненне, прымененае да аўдыя. Значэнне ў дБ. Па змаўчанні 0.
type
Усталюйце тып апрацоўкі. Можа быць
time
абоfreq
.time
павольна апрацоўвае гук у часовай вобласці.freq
хутка апрацоўвае гук у частотнай вобласці. Па змаўчанніfreq
.lfe
Усталюйце карыстацкае ўзмацненне для каналаў LFE. Значэнне ў дБ. Па змаўчанні 0.
size
Задайце памер кадра ў колькасці выбарак, якія будуць апрацоўвацца адначасова. Значэнне па змаўчанні -
1024
. Дазволены дыяпазон ад 1024 да 96000.hrir
Ўсталяваць фармат патоку hrir. Значэнне па змаўчанні -
stereo
. Альтэрнатыўнае значэнне -multich
. Калі значэнне ўстаноўлена ўstereo
, колькасць дадатковых патокаў павінна быць большай або роўнай колькасці ўваходных каналаў у першым уваходным патоку. Таксама кожны дадатковы паток павінен мець стэрэа колькасць каналаў. Калі значэнне ўстаноўлена ўmultich
, колькасць дадатковых патокаў павінна быць дакладна адной. Таксама колькасць уваходных каналаў дадатковага патоку павінна быць роўным або перавышаць у два разы колькасць каналаў першага ўваходнага патоку.
8.88.1 Examples
- Поўны прыклад выкарыстання файлаў wav у якасці каэфіцыентаў з фільтрамі amovie для паніжальнага мікшавання 7.1, кожны фільтр amovie выкарыстоўвае стэрэафайл з каэфіцыентамі IR у якасці ўваходных дадзеных. У файлах прыведзены каэфіцыенты для кожнай пазіцыі віртуальнага дынаміка:
ffmpeg -i input.wav -filter_complex "amovie=azi_270_ele_0_DFC.wav[sr];amovie=azi_90_ele_0_DFC.wav[sl];amovie=azi_225_ele_0_DFC.wav[br];amovie=azi_135_ele_0_DFC.wav[bl];amovie=azi_0_ele_0_DFC.wav,asplit[fc][lfe];amovie=azi_35_ele_0_DFC.wav[fl];amovie=azi_325_ele_0_DFC.wav[fr];[0:a][fl][fr][fc][lfe][bl][br][sl][sr]headphone=FL|FR|FC|LFE|BL|BR|SL|SR" output.wav
- Поўны прыклад выкарыстання файлаў wav у якасці каэфіцыентаў з фільтрамі amovie для паніжальнага мікшавання 7.1, але цяпер у фармаце.
multich
hrir
ffmpeg -i input.wav -filter_complex "amovie=minp.wav[hrirs];[0:a][hrirs]headphone=map=FL|FR|FC|LFE|BL|BR|SL|SR:hrir=multich" output.wav
8.89 highpass
Прымяніце фільтр высокіх частот з кропкавай частатой 3 дБ. Фільтр можа быць як аднаполюсным, так і двухполюсным (па змаўчанні). Фільтр зніжаецца на 6 дБ на полюс на актаву (20 дБ на полюс за дзесяцігоддзе).
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце частату ў Гц. Па змаўчанні 3000.
poles, p
Усталюйце колькасць палюсоў. Па змаўчанні 2.
width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type. Ужываецца толькі для двухполюсных фільтраў. Значэнне па змаўчанні роўна 0,707q і дае адказ Батэрворта.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.89.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць частату высокіх частот. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні высокіх частот. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню высокіх частот. Сінтаксіс каманды: "
width
"mix, m
Змяніць мікс высокіх частот. Сінтаксіс каманды: "
mix
"
8.90 join
Аб'яднайце некалькі ўваходных патокаў у адзін шматканальны паток.
Ён прымае наступныя параметры:
inputs
Колькасць уваходных патокаў. Па змаўчанні гэта 2.
channel_layout
Пажаданая схема выхаднога канала. Па змаўчанні стэрэа.
map
Карта каналаў ад уваходаў да выхаду. Аргумент уяўляе сабой падзелены '|' спіс супастаўленняў, кожнае ў форме. з'яўляецца індэксам ўваходнага патоку ад нуля. можа быць альбо назвай уваходнага канала (напрыклад, FL для пярэдніх левых), альбо яго індэксам у паказаным уваходным патоку. гэта назва выхаднога канала.
input_idx
.in_channel
-out_channel
input_idx
in_channel
out_channel
Фільтр паспрабуе адгадаць супастаўленні, калі яны не пазначаны яўна. Ён робіць гэта, спачатку спрабуючы знайсці нявыкарыстаны адпаведны ўваходны канал, і калі гэта не атрымліваецца, выбірае першы нявыкарыстаны ўваходны канал.
Аб'яднанне 3 уваходаў (з правільна наладжанымі раскладкамі каналаў):
ffmpeg -i INPUT1 -i INPUT2 -i INPUT3 -filter_complex join=inputs=3 OUTPUT
Стварыце выхад 5.1 з 6 аднаканальных патокаў:
ffmpeg -i fl -i fr -i fc -i sl -i sr -i lfe -filter_complex
'join=inputs=6:channel_layout=5.1:map=0.0-FL|1.0-FR|2.0-FC|3.0-SL|4.0-SR|5.0-LFE'
out
8.91 ladspa
Загрузіце плагін LADSPA (Linux Audio Developer's Simple Plugin API).
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-ladspa
.
file, f
Вызначае назву бібліятэкі плагінаў LADSPA для загрузкі. Калі
LADSPA_PATH
вызначана зменная асяроддзя, убудова LADSPA шукаецца ў кожным з каталогаў, вызначаных спісам, падзеленым двукроп'ем уLADSPA_PATH
, у адваротным выпадку ў стандартных шляхах LADSPA, якія знаходзяцца ў наступным парадку:HOME/.ladspa/lib/
,/usr/local/lib/ladspa/
,/usr/lib/ladspa/
.plugin, p
Вызначае плагін у бібліятэцы. Некаторыя бібліятэкі ўтрымліваюць толькі адзін убудова, але іншыя ўтрымліваюць іх шмат. Калі гэта не ўстаноўлена, у фільтры будуць пералічаны ўсе даступныя плагіны ў названай бібліятэцы.
controls, c
Усталюйце '|' асобны спіс элементаў кіравання, якія ўяўляюць сабой нуль або больш значэнняў з плаваючай кропкай, якія вызначаюць паводзіны загружанага плагіна (напрыклад, затрымка, парог або ўзмацненне). Элементы кіравання неабходна вызначыць з дапамогай наступнага сінтаксісу: c0=
value0
|c1=value1
|c2=value2
|..., дзеvaluei
значэнне, зададзенае дляi
-га элемента кіравання. У якасці альтэрнатывы яны таксама могуць быць вызначаны з дапамогай наступнага сінтаксісу:value0
|value1
|value2
|..., дзеvaluei
значэнне, устаноўленае дляi
-га элемента кіравання. Каліcontrols
усталявана ў значэннеhelp
, друкуюцца ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны.sample_rate, s
Укажыце частату дыскрэтызацыі, па змаўчанні 44100. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.
nb_samples, n
Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.
duration, d
Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра. Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна. Выкарыстоўваецца, толькі калі плагін не мае нулявых уводаў.
latency, l
Уключыць кампенсацыю затрымкі, па змаўчанні адключана. Выкарыстоўваецца, толькі калі плагін мае ўваходы.
8.91.1 Examples
- Пералічыце ўсе даступныя ўбудовы ў бібліятэцы amp (прыклад убудовы LADSPA):
ladspa=file=amp
- Пералічыце ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны для
vcf_notch
плагіна зVCF
бібліятэкі:ladspa=f=vcf:p=vcf_notch:c=help
- Імітацыя аўдыяабсталявання нізкай якасці з дапамогай
Computer Music Toolkit
бібліятэкі плагінаў (CMT):ladspa=file=cmt:plugin=lofi:controls=c0=22|c1=12|c2=12
- Дадайце рэверберацыю да аўдыя з дапамогай TAP-убудоў (убудовы Tom's Audio Processing):
ladspa=file=tap_reverb:tap_reverb
- Генераваць белы шум з амплітудай 0,2:
ladspa=file=cmt:noise_source_white:c=c0=.2
- Стварыце 20 удараў у хвіліну з дапамогай плагіна
C* Click - Metronome
зC* Audio Plugin Suite
бібліятэкі (CAPS):ladspa=file=caps:Click:c=c1=20'
- Ужыць
C* Eq10X2 - Stereo 10-band equaliser
эфект:ladspa=caps:Eq10X2:c=c0=-48|c9=-24|c3=12|c4=2
SWH Plugins
Павялічце гучнасць на 20 дБ з дапамогай абмежавальніка хуткага прагляду з калекцыі Стыва Харыса :ladspa=fast_lookahead_limiter_1913:fastLookaheadLimiter:20|0|2
- Знізьце нізкія частоты з дапамогай шматпалоснага эквалайзера з
SWH Plugins
калекцыі Стыва Харыса:ladspa=mbeq_1197:mbeq:-24|-24|-24|0|0|0|0|0|0|0|0|0|0|0|0
- Паменшыць стэрэамалюнак з дапамогай
Narrower
бібліятэкіC* Audio Plugin Suite
(CAPS):ladspa=caps:Narrower
- Яшчэ адзін белы шум, цяпер выкарыстоўваецца
C* Audio Plugin Suite
бібліятэка (CAPS):ladspa=caps:White:.2
- Трохі фрактальнага шуму з выкарыстаннем
C* Audio Plugin Suite
бібліятэкі (CAPS):ladspa=caps:Fractal:c=c1=1
- Дынамічная нармалізацыя гучнасці з дапамогай
VLevel
плагіна:ladspa=vlevel-ladspa:vlevel_mono
8.91.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
cN
Змяніць
N
-е кантрольнае значэнне.Калі ўказанае значэнне несапраўднае, яно ігнаруецца і захоўваецца папярэдняе.
8.92 loudnorm
Нармалізацыя гучнасці EBU R128. Уключае як дынамічны, так і лінейны рэжымы нармалізацыі. Падтрымка рэжымаў аднаразовага праходу (жывыя трансляцыі, файлы) і двайнога праходу (файлы). Гэты алгарытм можа арыентавацца на IL, LRA і максімальны сапраўдны пік. У дынамічным рэжыме для дакладнага вызначэння сапраўдных пікаў гукавы паток будзе павялічвацца да 192 кГц. Скарыстайцеся -ar
опцыяй або aresample
фільтрам, каб відавочна задаць частату выбаркі вываду.
Фільтр прымае наступныя параметры:
I, i
Усталюйце інтэграваную мэтавую гучнасць. Дыяпазон -70,0 - -5,0. Значэнне па змаўчанні -24,0.
LRA, lra
Усталюйце мэтавы дыяпазон гучнасці. Дыяпазон 1,0 - 50,0. Значэнне па змаўчанні 7,0.
TP, tp
Усталюйце максімальны сапраўдны пік. Дыяпазон -9,0 - +0,0. Значэнне па змаўчанні -2,0.
measured_I, measured_i
Вымераны IL ўваходнага файла. Дыяпазон -99,0 - +0,0.
measured_LRA, measured_lra
Вымераная LRA ўваходнага файла. Дыяпазон 0,0 - 99,0.
measured_TP, measured_tp
Вымераны сапраўдны пік уваходнага файла. Дыяпазон -99,0 - +99,0.
measured_thresh
Вымераны парог уваходнага файла. Дыяпазон -99,0 - +0,0.
offset
Задаць узмацненне зрушэння. Узмацненне прымяняецца перад абмежавальнікам сапраўднага піку. Дыяпазон -99,0 - +99,0. Па змаўчанні +0,0.
linear
Нармалізацыя шляхам лінейнага маштабавання зыходнага гуку.
measured_I
,measured_LRA
,measured_TP
, іmeasured_thresh
ўсе павінны быць указаны. Мэтавая LRA не павінна быць ніжэйшай за LRA крыніцы, а змяненне інтэграванай гучнасці не павінна прыводзіць да сапраўднага піка, які перавышае мэтавую TP. Калі якое-небудзь з гэтых умоў не выканана, рэжым нармалізацыі вернецца даdynamic
. Варыянтыtrue
абоfalse
. Па змаўчанніtrue
.dual_mono
Разглядайце ўваходныя файлы мона як "двайны мона". Калі монафайл прызначаны для прайгравання на стэрэасістэме, яго вымярэнне EBU R128 будзе няправільным для ўспрымання. Калі ўсталявана
true
, гэты параметр будзе кампенсаваць гэты эфект. Гэтая опцыя не ўплывае на шматканальныя ўваходныя файлы. Варыянты ісціна і ілжыва. Па змаўчанні - false.print_format
Задаць фармат друку для статыстыкі. Варыянты: зводка, json або ніводнага. Значэнне па змаўчанні - няма.
8.93 lowpass
Прымяненне фільтра нізкіх частот з кропкавай частатой 3 дБ. Фільтр можа быць як аднаполюсным, так і двухполюсным (па змаўчанні). Фільтр зніжаецца на 6 дБ на полюс на актаву (20 дБ на полюс за дзесяцігоддзе).
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце частату ў Гц. Па змаўчанні 500.
poles, p
Усталюйце колькасць палюсоў. Па змаўчанні 2.
width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Укажыце прапускную здольнасць фільтра ў адзінках width_type. Ужываецца толькі для двухполюсных фільтраў. Значэнне па змаўчанні роўна 0,707q і дае адказ Батэрворта.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.93.1 Examples
- Нізкачастотны толькі канал LFE, яго LFE няма, ён нічога не робіць:
lowpass=c=LFE
8.93.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змяніць частату нізкіх частот. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні нізкіх частот. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню нізкіх частот. Сінтаксіс каманды: "
width
"mix, m
Змяніць мікс нізкіх частот. Сінтаксіс каманды: "
mix
"
8.94 lv2
Загрузіце плагін LV2 (LADSPA версія 2).
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-lv2
.
plugin, p
Вызначае URI плагіна. Магчыма, вам спатрэбіцца экранаваць ':'.
controls, c
Усталюйце '|' асобны спіс элементаў кіравання, якія ўяўляюць сабой нуль або больш значэнняў з плаваючай кропкай, якія вызначаюць паводзіны загружанага плагіна (напрыклад, затрымка, парог або ўзмацненне). Калі
controls
усталявана ў значэннеhelp
, друкуюцца ўсе даступныя элементы кіравання і іх дапушчальныя дыяпазоны.sample_rate, s
Укажыце частату дыскрэтызацыі, па змаўчанні 44100. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.
nb_samples, n
Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024. Выкарыстоўваецца, толькі калі плагін не мае ўваходных дадзеных.
duration, d
Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра. Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна. Выкарыстоўваецца, толькі калі плагін не мае нулявых уводаў.
8.94.1 Examples
- Прымяніць плагін для ўзмацнення басу ад Calf:
lv2=p=http\\\\://calf.sourceforge.net/plugins/BassEnhancer:c=amount=2
- Прымяніць вінілавы плагін ад Calf:
lv2=p=http\\\\://calf.sourceforge.net/plugins/Vinyl:c=drone=0.2|aging=0.5
- Прымяніць убудова драбнілку біт ад ArtyFX:
lv2=p=http\\\\://www.openavproductions.com/artyfx#bitta:c=crush=0.3
8.94.2 Commands
Гэты фільтр падтрымлівае ўсе параметры, якія экспартуюцца ўбудовай у выглядзе каманд.
8.95 mcompand
Шматпалосны Сціск або пашырэнне дынамічнага дыяпазону гуку.
Уваходны гук падзелены на дыяпазоны з дапамогай IIR Лінквіца-Райлі 4-га парадку. Гэта падобна на кросовер гучнагаварыцеля і прыводзіць да роўнай частотнай характарыстыкі пры адсутнасці дзеяння кампанера.
Ён прымае наступныя параметры:
args
Сінтаксіс гэтага параметра: атака, заняпад, [атака, заняпад..] кропкі мяккага калена перакрыжаваная_частата [затрымка [пачатковы_аб'ём [узмацненне]]] | атака, распад ... Для тлумачэнняў кожнага элемента звярніцеся да кампазіцыйнай дакументацыі па фільтрах.
8.96 pan
Змешвайце каналы з пэўнымі ўзроўнямі ўзмацнення. Фільтр прымае макет выхаднога канала, за якім ідзе набор азначэнняў каналаў.
Гэты фільтр таксама прызначаны для эфектыўнага пераназначэння каналаў аўдыёпатоку.
Фільтр прымае параметры выгляду: " l
| outdef
| outdef
|..."
l
размяшчэнне выхаднога канала або колькасць каналаў
outdef
спецыфікацыя выхаднога канала ў выглядзе: "
out_name
=[gain
*]in_name
[(+-)[gain
*]in_name
...]"out_name
выхадны канал для вызначэння альбо назвы канала (FL, FR і г.д.), альбо нумара канала (c0, c1 і г.д.)
gain
мультыплікатыўны каэфіцыент для канала, 1 пакідаючы аб'ём нязменным
in_name
уваходны канал для выкарыстання, падрабязнасці гл. out_name; немагчыма змяшаць названыя і пранумараваныя ўваходныя каналы
Калі '=' у спецыфікацыі канала замяняецца на '<', то каэфіцыент узмацнення для гэтай спецыфікацыі будзе перанармалізаваны так, каб агульная сума была роўная 1, што дазваляе пазбегнуць шуму адсячэння.
8.96.1 Mixing examples
Напрыклад, калі вы хочаце панізіць мікшаванне са стэрэа ў мона, але з большым каэфіцыентам для левага канала:
pan=1c|c0=0.9*c0+0.1*c1
Індывідуальнае звядзенне да стэрэа, якое працуе аўтаматычна для 3-, 4-, 5- і 7-канальнага аб'ёмнага гуку:
pan=stereo| FL < FL + 0.5*FC + 0.6*BL + 0.6*SL | FR < FR + 0.5*FC + 0.6*BR + 0.6*SR
Звярніце ўвагу, што ffmpeg
інтэгруецца стандартная сістэма паніжаючага (і павышаючага) мікшавання, якой варта аддаць перавагу (гл. опцыю "-ac"), калі толькі ў вас няма асаблівых патрэб.
8.96.2 Remapping examples
Пераназначэнне канала будзе эфектыўным тады і толькі тады, калі:
- каэфіцыенты ўзмацнення - нулі або адзінкі,
- толькі адзін уваход на кожны выхад канала,
Калі ўсе гэтыя ўмовы выкананы, фільтр паведаміць карыстальніку ("Выяўлена чыстае адлюстраванне канала") і выкарыстае аптымізаваны метад без страт для выканання перапрызначэння.
Напрыклад, калі ў вас ёсць крыніца 5.1 і вы хочаце атрымаць стэрэааўдыяструмень, адмяніўшы дадатковыя каналы:
pan="stereo| c0=FL | c1=FR"
Улічваючы адну і тую ж крыніцу, вы таксама можаце пераключыць пярэдні левы і пярэдні правы каналы і захаваць размяшчэнне ўваходных каналаў:
pan="5.1| c0=c1 | c1=c0 | c2=c2 | c3=c3 | c4=c4 | c5=c5"
Калі ўваходны сігнал з'яўляецца стэрэааўдыяпатокам, вы можаце адключыць гук пярэдняга левага канала (і пры гэтым захаваць макет стэрэаканалаў) з дапамогай:
pan="stereo|c1=c1"
Тым не менш з уваходам стэрэааўдыёпатоку, вы можаце скапіяваць правы канал як у пярэдні левы, так і ў правы бок:
pan="stereo| c0=FR | c1=FR"
8.97 replaygain
Фільтр сканэра ReplayGain. Гэты фільтр прымае аўдыёпаток у якасці ўваходных дадзеных і выводзіць яго без зменаў. У канцы фільтрацыі адлюстроўваецца track_gain
і track_peak
.
8.98 resample
Пераўтварэнне фармату выбаркі аўдыя, частаты дыскрэтызацыі і макета канала. Ён не прызначаны для непасрэднага выкарыстання.
8.99 rubberband
Ужывайце расцяжку часу і вышыню тону з дапамогай librubberband.
Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай
--enable-librubberband
.
Фільтр прымае наступныя параметры:
tempo
Задаць маштабны каэфіцыент тэмпу.
pitch
Задаць маштабны каэфіцыент кроку.
transients
Усталяваць дэтэктар пераходных працэсаў. Магчымыя значэнні:
crisp
mixed
smooth
detector
Усталяваць дэтэктар. Магчымыя значэнні:
compound
percussive
soft
phase
Задаць фазу. Магчымыя значэнні:
laminar
independent
window
Задаць памер акна апрацоўкі. Магчымыя значэнні:
standard
short
long
smoothing
Ўсталяваць згладжванне. Магчымыя значэнні:
off
on
formant
Уключыць захаванне фарманты пры зруху. Магчымыя значэнні:
shifted
preserved
pitchq
Задаць якасць тону. Магчымыя значэнні:
quality
speed
consistency
channels
Наладзіць каналы. Магчымыя значэнні:
apart
together
8.99.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
tempo
Змяніць каэфіцыент маштабу тэмпу фільтра. Сінтаксіс каманды: "
tempo
"pitch
Змяніць маштабны каэфіцыент кроку фільтра. Сінтаксіс каманды: "
pitch
"
8.100 sidechaincompress
Гэты фільтр дзейнічае як звычайны кампрэсар, але мае магчымасць сціскаць выяўлены сігнал з дапамогай другога ўваходнага сігналу. Ён мае патрэбу ў двух уваходных патоках і вяртае адзін выходны паток. Першы ўваходны паток будзе апрацоўвацца ў залежнасці ад сігналу другога патоку. Затым адфільтраваны сігнал можа быць адфільтраваны іншымі фільтрамі на наступных этапах апрацоўкі. Глядзіце фільтр для патэльні і амерыджа .
Фільтр прымае наступныя параметры:
level_in
Задаць уваходнае ўзмацненне. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.
mode
Ўсталяваць рэжым працы кампрэсара. Можа быць
upward
абоdownward
. Па змаўчанніdownward
.threshold
Калі сігнал другога патоку падымаецца вышэй за гэты ўзровень, гэта паўплывае на зніжэнне ўзмацнення першага патоку. Па змаўчанні 0,125. Дыяпазон ад 0,00097563 да 1.
ratio
Усталюйце каэфіцыент, пры якім паніжаецца сігнал. 1:2 азначае, што калі ўзровень падняўся на 4 дБ вышэй парога, то пасля зніжэння ён будзе вышэй толькі на 2 дБ. Па змаўчанні - 2. Дыяпазон - ад 1 да 20.
attack
Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым пачнецца зніжэнне ўзмацнення. Па змаўчанні - 20. Дыяпазон - ад 0,01 да 2000.
release
Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў паменшыцца. Па змаўчанні - 250. Дыяпазон - ад 0,01 да 9000.
makeup
Усталюйце колькасць, наколькі сігнал будзе ўзмоцнены пасля апрацоўкі. Па змаўчанні 1. Дыяпазон ад 1 да 64.
knee
Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,82843. Дыяпазон ад 1 да 8.
link
Выберыце, калі
average
ўзровень паміж усімі каналамі патоку бакавога ланцуга ці больш гучны (maximum
) канал патоку бакавога ланцуга ўплывае на зніжэнне. Па змаўчанніaverage
.detection
Калі браць дакладны сігнал у выпадку
peak
або RMS ў выпадкуrms
. Па змаўчанні - гэта тое,rms
што ў асноўным больш гладкае.level_sc
Усталюйце ўзмацненне сайдчэйна. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.
mix
Колькі выкарыстоўваць сціснуты сігнал у вывадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
8.100.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.100.2 Examples
- Поўны прыклад ffmpeg з 2 аўдыяўваходамі, 1-ы ўваход сціскаецца ў залежнасці ад сігналу 2-га ўваходу, а пазней сціснуты сігнал аб'ядноўваецца з 2-м уваходам:
ffmpeg -i main.flac -i sidechain.flac -filter_complex "[1:a]asplit=2[sc][mix];[0:a][sc]sidechaincompress[compr];[compr][mix]amerge"
8.101 sidechaingate
Гейт бакавой ланцуга дзейнічае як звычайны (шырокапалосны) гейт, але мае магчымасць фільтраваць выяўлены сігнал перад адпраўкай яго на этап памяншэння ўзмацнення. Звычайна гейт выкарыстоўвае сігнал поўнага дыяпазону, каб выявіць узровень вышэй парога. Напрыклад: калі вы выразаеце ўсе нізкія частоты са свайго сайдчэйн-сігналу, гейт зменшыць гучнасць вашага трэка толькі ў тым выпадку, калі з'явіцца недастаткова высокіх частот. З дапамогай гэтай тэхнікі вы можаце паменшыць рэзананс натуральнага барабана або прыбраць "грукатанне" прыглушаных удараў моцна скажонай гітары. Ён мае патрэбу ў двух уваходных патоках і вяртае адзін выходны паток. Першы ўваходны паток будзе апрацоўвацца ў залежнасці ад сігналу другога патоку.
Фільтр прымае наступныя параметры:
level_in
Усталюйце ўваходны ўзровень перад фільтрацыяй. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.
mode
Усталюйце рэжым працы. Можа быць
upward
абоdownward
. Па змаўчанніdownward
. Калі ўсталяваныupward
рэжым, больш высокія часткі сігналу будуць узмацняцца, пашыраючы дынамічны дыяпазон уверх. У адваротным выпадку ў выпадкуdownward
ніжніх частак сігнал будзе зніжаны.range
Усталюйце ўзровень зніжэння ўзмацнення, калі сігнал ніжэйшы за парог. Па змаўчанні 0,06125. Дазволены дыяпазон ад 0 да 1. Усталёўка гэтага значэння ў 0 адключае скарачэнне, а затым фільтр паводзіць сябе як пашыральнік.
threshold
Калі сігнал падымаецца вышэй за гэты ўзровень, зніжэнне ўзмацнення адключаецца. Па змаўчанні 0,125. Дазволены дыяпазон ад 0 да 1.
ratio
Усталюйце каэфіцыент, пры якім паніжаецца сігнал. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 9000.
attack
Колькасць мілісекунд, за якое сігнал павінен падняцца вышэй парогавага значэння, перш чым зніжэнне ўзмацнення спыніцца. Па змаўчанні 20 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.
release
Колькасць мілісекунд, на працягу якіх сігнал павінен апусціцца ніжэй за парогавае значэнне, перш чым зніжэнне зноў павялічыцца. Па змаўчанні 250 мілісекунд. Дазволены дыяпазон ад 0,01 да 9000.
makeup
Задаць велічыню ўзмацнення сігналу пасля апрацоўкі. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64.
knee
Абагніце вострае калена вакол парога, каб увесці зніжэнне ўзмацнення больш мякка. Па змаўчанні 2,828427125. Дазволены дыяпазон ад 1 да 8.
detection
Выберыце, ці трэба браць для выяўлення дакладны сігнал або падобны да RMS. Па змаўчанні - сярэдняя квадратура. Можа быць пікавым або сярэднеквадратычным.
link
Выберыце, калі сярэдні ўзровень паміж усімі каналамі ці больш гучны канал уплывае на зніжэнне. Па змаўчанні сярэдні. Можа быць сярэднім або максімальным.
level_sc
Усталюйце ўзмацненне сайдчэйна. Па змаўчанні 1. Дыяпазон ад 0,015625 да 64.
8.101.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.102 silencedetect
Выяўленне цішыні ў аўдыяплыні.
Гэты фільтр рэгіструе паведамленне, калі выяўляе, што гучнасць уваходнага гуку меншая або роўная значэнню дапушчальнага шуму на працягу часу, большага або роўнага мінімальнай выяўленай працягласці шуму.
Надрукаваны час і працягласць выражаны ў секундах. Ключ метаданых
lavfi.silence_start
or lavfi.silence_start.X
усталёўваецца на першым кадры, часовая пазнака якога роўная або перавышае працягласць выяўлення, і змяшчае пазнаку часу першага кадра маўчання.
lavfi.silence_duration
Ключы метададзеных або і lavfi.silence_duration.X
або ўсталёўваюцца на першым кадры пасля маўчання lavfi.silence_end
. lavfi.silence_end.X
Каліmono
уключана, і кожны канал ацэньваецца асобна, выкарыстоўваюцца .X
ключы з суфіксам і X
адпавядае нумару канала.
Фільтр прымае наступныя параметры:
noise, n
Усталюйце шумацярпімасць. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Па змаўчанні - -60 дБ, або 0,001.
duration, d
Усталюйце працягласць цішыні да паведамлення (па змаўчанні 2 секунды). Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
mono, m
Апрацоўвайце кожны канал асобна, а не аб'ядноўвайце. Па змаўчанні адключана.
8.102.1 Examples
- Вызначце 5 секунд цішыні з устойлівасцю да шуму -50 дБ:
silencedetect=n=-50dB:d=5
- Поўны прыклад з
ffmpeg
выяўленнем цішыні з 0,0001 шумацярпімасціsilence.mp3
:ffmpeg -i silence.mp3 -af silencedetect=noise=0.0001 -f null -
8.103 silenceremove
Выдаліць цішыню ў пачатку, сярэдзіне або канцы аўдыя.
Фільтр прымае наступныя параметры:
start_periods
Гэта значэнне выкарыстоўваецца, каб паказаць, ці трэба абрэзаць аўдыя ў пачатку аўдыя. Нулявое значэнне азначае, што маўчанне не павінна быць абрэзана з самага пачатку. Пры ўказанні адрознага ад нуля значэння гук абразаецца, пакуль не будзе выяўлена адсутнасць цішыні. Звычайна пры абрэзцы цішыні ад пачатку аўдыя
start_periods
будзе,1
але яе можна павялічыць да больш высокіх значэнняў, каб скараціць усе аўдыя да пэўнай колькасці перыядаў без цішыні. Значэнне па змаўчанні -0
.start_duration
Укажыце прамежак часу, на працягу якога павінна быць выяўлена адсутнасць цішыні, перш чым яно спыніць абразанне гуку. Павялічваючы працягласць, серыі шумоў можна разглядаць як цішыню і адключаць. Значэнне па змаўчанні -
0
.start_threshold
Гэта паказвае, якое значэнне выбаркі трэба разглядаць як маўчанне. Для лічбавага аўдыя значэнне
0
можа падысці, але для аўдыя, запісанага з аналагавага, вы можаце павялічыць значэнне для ўліку фонавага шуму. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Значэнне па змаўчанні -0
.start_silence
Укажыце максімальную працягласць цішыні ў пачатку, якая будзе захоўвацца пасля абрэзкі. Па змаўчанні значэнне 0, што роўна абразанню ўсіх узораў, выяўленых як цішыня.
start_mode
Укажыце рэжым вызначэння канца цішыні ў пачатку шматканальнага гуку. Можа быць
any
абоall
. Па змаўчанніany
. Зany
любым узорам, які выяўлены як нецішыня, будзе спынена абразанне цішыні. Зall
, толькі калі ўсе каналы выяўлены як нецішыня, гэта прывядзе да спынення абрэзкі цішыні.stop_periods
Усталюйце лік для абрэзкі цішыні з канца аўдыя. Каб выдаліць маўчанне з сярэдзіны файла, укажыце
stop_periods
адмоўны. Затым гэтае значэнне разглядаецца як станоўчае і выкарыстоўваецца для ўказання, што эфект павінен перазапусціць апрацоўку, як вызначанаstart_periods
, што робіць яго прыдатным для выдалення перыядаў цішыні ў сярэдзіне аўдыя. Значэнне па змаўчанні -0
.stop_duration
Укажыце працягласць цішыні, якая павінна існаваць, перш чым аўдыя больш не будзе капіравацца. Пры ўказанні большай працягласці ў аўдыя можна пакінуць жаданую цішыню. Значэнне па змаўчанні -
0
.stop_threshold
Гэта тое самае, што
start_threshold
але для абрэзкі цішыні ў канцы аўдыё. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў суадносінах амплітуд. Значэнне па змаўчанні -0
.stop_silence
Укажыце максімальную працягласць цішыні ў канцы, якая будзе захоўвацца пасля абрэзкі. Па змаўчанні значэнне 0, што роўна абразанню ўсіх узораў, выяўленых як цішыня.
stop_mode
Укажыце рэжым вызначэння пачатку цішыні ў канцы шматканальнага гуку. Можа быць
any
абоall
. Па змаўчанніany
. Зany
любым узорам, які выяўлены як нецішыня, будзе спынена абразанне цішыні. Зall
, толькі калі ўсе каналы выяўлены як нецішыня, гэта прывядзе да спынення абрэзкі цішыні.detection
Усталюйце спосаб выяўлення цішыні. Можа быць
rms
абоpeak
. Другі хутчэй і лепш працуе з лічбавай цішынёй, роўнай 0. Значэнне па змаўчанні роўнаrms
.window
Задаць працягласць у колькасці секунд, якая выкарыстоўваецца для разліку памеру акна ў колькасці выбарак для выяўлення цішыні. Значэнне па змаўчанні -
0.02
. Дазволены дыяпазон ад0
да10
.
8.103.1 Examples
- Наступны прыклад паказвае, як можна выкарыстоўваць гэты фільтр для пачатку запісу, які не ўтрымлівае затрымкі ў пачатку, якая звычайна ўзнікае паміж націскам кнопкі запісу і пачаткам выканання:
silenceremove=start_periods=1:start_duration=5:start_threshold=0.02
- Абрэжце ўсю цішыню ад пачатку да канца, дзе маўчанне больш за 1 секунду ў аўдыя:
silenceremove=stop_periods=-1:stop_duration=1:stop_threshold=-90dB
- Абрэжце ўсе лічбавыя выбаркі цішыні, выкарыстоўваючы выяўленне пікаў, ад пачатку да канца, калі ёсць больш за 0 выбарак лічбавай цішыні ў аўдыя і лічбавая цішыня выяўляецца ва ўсіх каналах у аднолькавых месцах у патоку:
silenceremove=window=0:detection=peak:stop_mode=all:start_mode=all:stop_periods=-1:stop_threshold=0
8.104 sofalizer
SOFAlizer выкарыстоўвае функцыі перадачы, звязаныя з галавой (HRTF), каб стварыць вакол карыстальніка віртуальныя гучнагаварыцелі для бінауральнага праслухоўвання праз навушнікі (падтрымліваюцца аўдыяфарматы да 9 каналаў). HRTF захоўваюцца ў файлах SOFA (гл . базу дадзеных http://www.sofacoustics.org/ ). SOFAlizer распрацаваны Інстытутам даследаванняў акустыкі (ARI) Аўстрыйскай акадэміі навук.
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-libmysofa
.
Фільтр прымае наступныя параметры:
sofa
Усталюйце файл SOFA, які выкарыстоўваецца для візуалізацыі.
gain
Задаць узмацненне, прымененае да аўдыя. Значэнне ў дБ. Па змаўчанні 0.
rotation
Задаць паварот віртуальных дынамікаў у градусах. Па змаўчанні 0.
elevation
Задаць вышыню віртуальных дынамікаў у градусах. Па змаўчанні 0.
radius
Усталюйце адлегласць у метрах паміж дынамікамі і слухачом з HRTF блізкага поля. Па змаўчанні 1.
type
Усталюйце тып апрацоўкі. Можа быць
time
абоfreq
.time
павольна апрацоўвае гук у часовай вобласці.freq
хутка апрацоўвае гук у частотнай вобласці. Па змаўчанніfreq
.speakers
Усталюйце ўласныя пазіцыі віртуальных дынамікаў. Сінтаксіс гэтай опцыі: <CH> <AZIM> <ELEV>[|<CH> <AZIM> <ELEV>|...]. Кожны віртуальны гучнагаварыцель апісваецца кароткай назвай канала з указаннем азімута і кута ў градусах. Кожнае апісанне віртуальнага гучнагаварыцеля аддзяляецца знакам '|'. Напрыклад, каб перавызначыць пазіцыі пярэдняга левага і пярэдняга правага каналаў, выкарыстоўвайце: «дынамікі=FL 45 15|FR 345 15». Апісанні з нераспазнанымі назвамі каналаў ігнаруюцца.
lfegain
Усталюйце карыстацкае ўзмацненне для каналаў LFE. Значэнне ў дБ. Па змаўчанні 0.
framesize
Усталюйце нестандартны памер кадра ў колькасці ўзораў. Па змаўчанні 1024. Дазволены дыяпазон ад 1024 да 96000. Выкарыстоўваецца, толькі калі параметр '
type
' усталяваны ўfreq
.normalize
Ці варта нармалізаваць усе IR пасля імпарту файла SOFA. Па змаўчанні ўключана.
interpolate
Ці варта інтэрпаляваць бліжэйшыя IR з суседнімі IR, калі дакладная пазіцыя не супадае. Па змаўчанні адключана.
minphase
Мінфаза ўсіх IR пры загрузцы файла SOFA. Па змаўчанні адключана.
anglestep
Усталюйце крок суседняга вугла пошуку. Выкарыстоўваецца, толькі калі опцыя
interpolate
ўключана.radstep
Задаць крок радыуса пошуку суседзяў. Выкарыстоўваецца, толькі калі опцыя
interpolate
ўключана.
8.104.1 Examples
- Выкарыстанне файла канапы ClubFritz6:
sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=1
- Выкарыстанне файла для канапы ClubFritz12 і большага радыусу з невялікім паваротам:
sofalizer=sofa=/path/to/ClubFritz12.sofa:type=freq:radius=2:rotation=5
- Падобна вышэйзгаданаму, але з нестандартным размяшчэннем дынамікаў для пярэдняга левага, пярэдняга правага, задняга левага і задняга правага, а таксама з нестандартным узмацненнем:
"sofalizer=sofa=/path/to/ClubFritz6.sofa:type=freq:radius=2:speakers=FL 45|FR 315|BL 135|BR 225:gain=28"
8.105 speechnorm
Нармалізатар прамовы.
Гэты фільтр пашырае або сціскае кожны паўцыкл аўдыясэмплоў (лакальны набор сэмплоў, усе вышэй або ніжэй за нуль і паміж двума бліжэйшымі перасячэннямі нуля) у залежнасці ад парогавага значэння, так што гук дасягае мэтавага пікавага значэння ва ўмовах, якія кантралююцца прыведзенымі ніжэй параметрамі.
Фільтр прымае наступныя параметры:
peak, p
Усталюйце мэтавае пікавае значэнне пашырэння. Гэта вызначае самы высокі дазволены абсалютны ўзровень амплітуды для нармалізаванага ўваходнага гуку. Значэнне па змаўчанні 0,95. Дазволены дыяпазон ад 0,0 да 1,0.
expansion, e
Усталюйце максімальны каэфіцыент пашырэння. Дапушчальны дыяпазон ад 1,0 да 50,0. Значэнне па змаўчанні 2.0. Гэты параметр кантралюе максімальны лакальны паўцыкл пашырэння выбарак. Максімальнае пашырэнне будзе такім, каб лакальнае пікавае значэнне дасягала мэтавага пікавага значэння, але ніколі не перавышала яго, і каб суадносіны паміж новым і папярэднім пікавым значэннем не перавышалі гэтае значэнне опцыі.
compression, c
Усталюйце максімальны каэфіцыент сціску. Дапушчальны дыяпазон ад 1,0 да 50,0. Значэнне па змаўчанні 2.0. Гэты параметр кантралюе максімальны лакальны паўцыкл сціску ўзораў. Гэты параметр выкарыстоўваецца толькі ў тым выпадку, калі
threshold
параметр усталяваны на значэнне большае за 0,0, тады ў такіх выпадках, калі лакальны пік ніжэйшы або такі ж, як значэнне, зададзенаеthreshold
усе ўзоры, якія адносяцца да паўцыкла гэтага піка, будуць сціснуты бягучым каэфіцыентам сціску.threshold, t
Усталюйце парогавае значэнне. Значэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0. Гэты параметр вызначае, якія паўцыклы ўзораў будуць сціснуты, а якія разгорнуты. Любыя ўзоры паўцыкла з лакальным пікавым значэннем ніжэй або такім жа, як значэнне гэтага параметра, будуць сціснуты бягучым каэфіцыентам сціску, у адваротным выпадку, калі больш парогавага значэння, яны будуць пашыраны каэфіцыентам пашырэння, каб ён мог дасягнуць пікавага мэтавага значэння, але ніколі не перавышаць гэта.
raise, r
Усталюйце колькасць павышэння пашырэння на кожны паўцыкл узораў. Значэнне па змаўчанні 0,001. Дазволены дыяпазон ад 0,0 да 1,0. Гэта кантралюе хуткасць павышэння каэфіцыента пашырэння за кожны новы паўцыкл, пакуль ён не дасягне
expansion
значэнне. Занадта высокія параметры могуць прывесці да скажэнняў.fall, f
Усталюйце ступень павышэння сціску на кожны паўцыкл выбарак. Значэнне па змаўчанні 0,001. Дазволены дыяпазон ад 0,0 да 1,0. Гэта кантралюе хуткасць павышэння каэфіцыента сціску за кожны новы паўцыкл, пакуль ён не дасягне
compression
значэнне.channels, h
Укажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя каналы.
invert, i
Уключыць інвертаваную фільтрацыю, па змаўчанні адключана. Гэта пераварочвае інтэрпрэтацыю
threshold
варыянт. Калі ўключаны любы паўцыкл узораў з лакальным пікавым значэннем ніжэйшым або такім жа, якthreshold
опцыя будзе пашырана, інакш яна будзе сціснута.link, l
Звязваць каналы пры разліку ўзмацнення, якое прымяняецца да кожнай адфільтраванай выбаркі канала, па змаўчанні адключана. Калі гэты параметр адключаны, разлік узмацнення кожнага адфільтраванага канала незалежны, у адваротным выпадку, калі гэты параметр уключаны, выкарыстоўваецца мінімум з усіх магчымых узмацненняў для кожнага адфільтраванага канала.
8.105.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.106 stereotools
Гэты фільтр мае некаторыя зручныя ўтыліты для кіравання стэрэасігналамі, для пераўтварэння стэрэазапісаў M/S у сігнал L/R, адначасова маючы кантроль над параметрамі або распаўсюджванне стэрэа выявы майстар-трэка.
Фільтр прымае наступныя параметры:
level_in
Усталюйце ўваходны ўзровень перад фільтрацыяй для абодвух каналаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,015625 да 64.
level_out
Усталюйце выхадны ўзровень пасля фільтрацыі для абодвух каналаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0,015625 да 64.
balance_in
Усталюйце ўваходны баланс паміж абодвума каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
balance_out
Усталюйце выхадны баланс паміж абодвума каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
softclip
Уключыць softclipping. Вынікі аналагавых скажэнняў замест рэзкага лічбавага адсячэння 0 дБ. Па змаўчанні адключана.
mutel
Адключыць левы канал. Па змаўчанні адключана.
muter
Адключыць правы канал. Па змаўчанні адключана.
phasel
Змяніць фазу левага канала. Па змаўчанні адключана.
phaser
Змяніць фазу правага канала. Па змаўчанні адключана.
mode
Усталюйце стэрэарэжым. Даступныя значэнні:
- '
lr>lr
' Злева/справа налева/направа, гэта па змаўчанні.
- '
lr>ms
' Злева/справа ў сярэдзіну/збоку.
- '
ms>lr
' Пасярэдзіне/збоку налева/направа.
- '
lr>ll
' Злева/справа налева/налева.
- '
lr>rr
' Злева/справа направа/направа.
- '
lr>l+r
' Злева/справа налева + направа.
- '
lr>rl
' Злева/справа направа/налева.
- '
ms>ll
' З сярэдзіны/збоку налева/налева.
- '
ms>rr
' Пасярэдзіне/збоку направа/направа.
- '
ms>rl
' Пасярэдзіне/збоку направа/налева.
- '
lr>l-r
' Злева/справа налева - направа.
- '
slev
Усталюйце ўзровень бакавога сігналу. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.
sbal
Усталюйце баланс бакавога сігналу. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
mlev
Усталюйце ўзровень сярэдняга сігналу. Па змаўчанні 1. Дазволены дыяпазон ад 0,015625 да 64.
mpan
Усталюйце сярэднюю сігнальную панараму. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
base
Усталюйце базу стэрэа паміж мона і інверснымі каналамі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
delay
Усталюйце затрымку ў мілісекундах, колькі затрымкі злева ад правага канала і наадварот. Па змаўчанні 0. Дазволены дыяпазон ад -20 да 20.
sclevel
Усталюйце ўзровень S/C. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 100.
phase
Усталюйце фазу стэрэа ў градусах. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 360.
bmode_in, bmode_out
Усталюйце рэжым балансу для параметра balance_in/balance_out.
Можа быць адно з наступнага:
- '
balance
' Класічны рэжым балансу. Аслабляйце па адным канале. Выйгрыш павялічваецца да 1.
- '
amplitude
' Падобны да класічнага рэжыму вышэй, але ўзмацненне павышана да 2.
- '
power
' Раўнамернае размеркаванне магутнасці, дыяпазон ад -6 дБ да +6 дБ.
- '
8.106.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
8.106.2 Examples
- Прымяніць эфект караоке:
stereotools=mlev=0.015625
- Пераўтварэнне сігналу M/S у L/R:
"stereotools=mode=ms>lr"
8.107 stereowiden
Гэты фільтр узмацняе стэрэаэфект, падаўляючы сігнал, агульны для абодвух каналаў, і затрымліваючы сігнал з левага на правы і наадварот, тым самым пашыраючы стэрээфект.
Фільтр прымае наступныя параметры:
delay
Час у мілісекундах затрымкі левага сігналу ў правы і наадварот. Па змаўчанні 20 мілісекунд.
feedback
Велічыня ўзмацнення затрыманага сігналу ў правы і наадварот. Дае эфект затрымкі левага сігналу ў правым выхадзе і наадварот, што дае эфект пашырэння. Па змаўчанні 0,3.
crossfeed
Перакрыжаваная падача злева направа з перавернутай фазай. Гэта дапамагае ў падаўленні мона. Калі значэнне роўна 1, гэта адменіць увесь сігнал, агульны для абодвух каналаў. Па змаўчанні 0,3.
drymix
Усталюйце ўзровень уваходнага сігналу зыходнага канала. Па змаўчанні 0,8.
8.107.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры, за delay
выключэннем каманд .
8.108 superequalizer
Прымяніць 18-палосны эквалайзер.
Фільтр прымае наступныя параметры:
1b
Усталюйце ўзмацненне дыяпазону 65 Гц.
2b
Усталюйце ўзмацненне дыяпазону 92 Гц.
3b
Усталюйце ўзмацненне дыяпазону 131 Гц.
4b
Усталюйце ўзмацненне дыяпазону 185 Гц.
5b
Усталюйце ўзмацненне дыяпазону 262 Гц.
6b
Усталюйце ўзмацненне дыяпазону 370 Гц.
7b
Усталюйце ўзмацненне дыяпазону 523 Гц.
8b
Усталюйце ўзмацненне дыяпазону 740 Гц.
9b
Усталюйце ўзмацненне дыяпазону 1047 Гц.
10b
Усталюйце ўзмацненне дыяпазону 1480 Гц.
11b
Усталюйце ўзмацненне дыяпазону 2093 Гц.
12b
Усталюйце ўзмацненне дыяпазону 2960 Гц.
13b
Усталюйце ўзмацненне дыяпазону 4186 Гц.
14b
Усталюйце ўзмацненне дыяпазону 5920 Гц.
15b
Усталюйце ўзмацненне дыяпазону 8372 Гц.
16b
Усталюйце ўзмацненне дыяпазону 11840 Гц.
17b
Усталюйце ўзмацненне дыяпазону 16744 Гц.
18b
Усталюйце ўзмацненне дыяпазону 20000 Гц.
8.109 surround
Прымяніць фільтр павышаючага мікшавання аб'ёмнага гуку.
Гэты фільтр дазваляе вырабляць шматканальны вывад з аўдыяструменю.
Фільтр прымае наступныя параметры:
chl_out
Усталюйце схему выходнага канала. Па змаўчанні гэта
5.1
.Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .
chl_in
Задаць схему ўваходнага канала. Па змаўчанні гэта
stereo
.Патрэбны сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) Разметка канала ў кіраўніцтве ffmpeg-utils(1) .
level_in
Усталюйце ўзровень гучнасці ўводу. Па змаўчанні гэта
1
.level_out
Усталюйце ўзровень гучнасці выхаду. Па змаўчанні гэта
1
.lfe
Уключыць выхад канала LFE, калі ён ёсць у кампаноўцы выхаднога канала. Па змаўчанні гэта ўключана.
lfe_low
Усталюйце нізкую частату зрэзу LFE. Па змаўчанні гэта
128
Гц.lfe_high
Усталюйце высокую частату зрэзу LFE. Па змаўчанні гэта
256
Гц.lfe_mode
Усталюйце рэжым LFE, можна
add
ціsub
. Па змаўчанніadd
. Уadd
рэжыме LFE канал ствараецца з уваходнага гуку і дадаецца да выхаду. Уsub
рэжыме канал LFE ствараецца з уваходнага аўдыя і дадаецца да выхаду, але таксама ўсе выходныя каналы без LFE адымаюцца з выхаднога канала LFE.angle
Задайце вугал стэрэааб'ёмнага пераўтварэння, дазволены дыяпазон ад
0
да360
. Па змаўчанні90
.fc_in
Усталюйце гучнасць уводу ў цэнтры спераду. Па змаўчанні гэта
1
.fc_out
Усталюйце гучнасць пярэдняга цэнтральнага выхаду. Па змаўчанні гэта
1
.fl_in
Усталюйце гучнасць пярэдняга левага ўваходу. Па змаўчанні гэта
1
.fl_out
Усталюйце гучнасць пярэдняга левага выхаду. Па змаўчанні гэта
1
.fr_in
Усталюйце гучнасць уводу спераду справа. Па змаўчанні гэта
1
.fr_out
Усталюйце гучнасць пярэдняга правага выхаду. Па змаўчанні гэта
1
.sl_in
Усталюйце гучнасць уводу з левага боку. Па змаўчанні гэта
1
.sl_out
Усталюйце гучнасць бакавога левага выхаду. Па змаўчанні гэта
1
.sr_in
Усталюйце гучнасць уводу справа. Па змаўчанні гэта
1
.sr_out
Усталюйце гук бакавога правага выхаду. Па змаўчанні гэта
1
.bl_in
Вярніце гучнасць левага ўваходу. Па змаўчанні гэта
1
.bl_out
Усталюйце гучнасць левага выхаду. Па змаўчанні гэта
1
.br_in
Усталюйце гучнасць правага ўваходу. Па змаўчанні гэта
1
.br_out
Вярніце гучнасць правага выхаду. Па змаўчанні гэта
1
.bc_in
Вярнуць цэнтральную гучнасць уводу. Па змаўчанні гэта
1
.bc_out
Усталюйце цэнтральную гучнасць выхаду. Па змаўчанні гэта
1
.lfe_in
Устанавіць уваходную гучнасць LFE. Па змаўчанні гэта
1
.lfe_out
Усталюйце гучнасць выхаду LFE. Па змаўчанні гэта
1
.allx
Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі X для ўсіх каналаў. Дазволены дыяпазон ад
-1
да15
. Па змаўчанні гэта значэнне адмоўнае-1
і, такім чынам, не выкарыстоўваецца.ally
Усталюйце размеркаванае выкарыстанне стэрэамалюнка па восі Y для ўсіх каналаў. Дазволены дыяпазон ад
-1
да15
. Па змаўчанні гэта значэнне адмоўнае-1
і, такім чынам, не выкарыстоўваецца.fcx, flx, frx, blx, brx, slx, srx, bcx
Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі X для кожнага канала. Дазволены дыяпазон ад
0.06
да15
. Па змаўчанні гэта значэнне роўна0.5
.fcy, fly, fry, bly, bry, sly, sry, bcy
Усталюйце распаўсюджванне выкарыстання стэрэамалюнка па восі Y для кожнага канала. Дазволены дыяпазон ад
0.06
да15
. Па змаўчанні гэта значэнне роўна0.5
.win_size
Усталюйце памер акна. Дазволены дыяпазон ад
1024
да65536
. Памер па змаўчанні4096
.win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann, hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Па змаўчанні
hann
.- '
overlap
Усталюйце перакрыцце вокнаў. Калі ўстаноўлена значэнне 1, будзе выбрана рэкамендаванае перакрыцце для выбранай функцыі акна. Па змаўчанні
0.5
.
8.110 tiltshelf
Узмацняйце або зніжайце нізкія частоты і зніжайце або павышайце высокія частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятара тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).
Фільтр прымае наступныя параметры:
gain, g
Дайце ўзмацненне на 0 Гц. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.
frequency, f
Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні -
3000
Гц.width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Вызначце, наколькі круты пераход паліцы фільтра.
poles, p
Усталюйце колькасць палюсоў. Па змаўчанні 2.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.110.1 Commands
Гэты фільтр падтрымлівае некаторыя параметры ў якасці каманд .
8.111 treble, highshelf
Павялічвайце або зніжайце высокія (верхнія) частоты гуку з дапамогай двухполюснага палічнага фільтра з рэакцыяй, падобнай да рэгулятараў тэмбру стандартнага Hi-Fi. Гэта таксама вядома як выраўноўванне паліц (EQ).
Фільтр прымае наступныя параметры:
gain, g
Укажыце каэфіцыент узмацнення пры меншым з ~22 кГц і частаце Найквіста. Яго карысны дыяпазон складае ад -20 (для вялікага разрэзу) да +20 (для вялікага ўзмацнення). Сцеражыцеся абразання пры выкарыстанні станоўчага ўзмацнення.
frequency, f
Усталюйце цэнтральную частату фільтра, і таму яе можна выкарыстоўваць для пашырэння або памяншэння дыяпазону частот, які трэба павялічыць або скараціць. Значэнне па змаўчанні -
3000
Гц.width_type, t
Усталяваць метад для ўказання прапускной здольнасці фільтра.
h
Гц
q
Q-фактар
o
актава
s
схіл
k
кГц
width, w
Вызначце, наколькі круты пераход паліцы фільтра.
poles, p
Усталюйце колькасць палюсоў. Па змаўчанні 2.
mix, m
Колькі выкарыстоўваць адфільтраваны сігнал на выхадзе. Па змаўчанні 1. Дыяпазон ад 0 да 1.
channels, c
Пакажыце, якія каналы фільтраваць, па змаўчанні фільтруюцца ўсе даступныя.
normalize, n
Нармалізаваць біквадратныя каэфіцыенты, па змаўчанні адключана. Уключэнне яго нармалізуе амплітудную характарыстыку пры пастаянным току да 0 дБ.
transform, a
Усталюйце тып пераўтварэння фільтра IIR.
di
dii
tdi
tdii
latt
svf
zdf
precision, r
Усталюйце дакладнасць фільтрацыі.
auto
Выберыце аўтаматычны фармат выбаркі ў залежнасці ад фільтраў аб'ёмнага гуку.
s16
Заўсёды выкарыстоўвайце 16-біт са знакам.
s32
Заўсёды выкарыстоўвайце 32-бітны знак.
f32
Заўсёды выкарыстоўвайце 32-бітнае значэнне з плаваючай часткай.
f64
Заўсёды выкарыстоўвайце float 64-bit.
block_size, b
Задаць памер блока, які выкарыстоўваецца для зваротнай апрацоўкі IIR. Калі для гэтага значэння ўстаноўлена дастаткова высокае значэнне (большае, чым даўжыня імпульснай рэакцыі, скарочаная, калі яна дасягае значэнняў, блізкіх да нуля), фільтраванне стане лінейнай фазай, у адваротным выпадку, калі яно недастаткова вялікае, яно будзе ствараць непрыемныя артэфакты.
Звярніце ўвагу, што затрымка фільтра будзе роўна такой колькасці выбарак, калі зададзена ненулявое значэнне.
8.111.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
frequency, f
Змена высокіх частот. Сінтаксіс каманды: "
frequency
"width_type, t
Змяніць тып шырыні высокіх частот. Сінтаксіс каманды: "
width_type
"width, w
Змяніць шырыню высокіх частот. Сінтаксіс каманды: "
width
"gain, g
Змяніць узмацненне высокіх частот. Сінтаксіс каманды: "
gain
"mix, m
Змяніць мікс высокіх частот. Сінтаксіс каманды: "
mix
"
8.112 tremolo
Сінусоідная амплітудная мадуляцыя.
Фільтр прымае наступныя параметры:
f
Частата мадуляцыі ў герцах. Частоты мадуляцыі ў субгарманічных дыяпазоне (20 Гц або ніжэй) прывядуць да эфекту трэмала. Гэты фільтр можа таксама выкарыстоўвацца ў якасці кальцавога мадулятара, задаўшы частату мадуляцыі вышэй за 20 Гц. Дыяпазон 0,1 - 20000,0. Значэнне па змаўчанні - 5,0 Гц.
d
Глыбіня мадуляцыі ў працэнтах. Дыяпазон 0,0 - 1,0. Значэнне па змаўчанні 0,5.
8.113 vibrato
Сінусоідная фазавая мадуляцыя.
Фільтр прымае наступныя параметры:
f
Частата мадуляцыі ў герцах. Дыяпазон 0,1 - 20000,0. Значэнне па змаўчанні - 5,0 Гц.
d
Глыбіня мадуляцыі ў працэнтах. Дыяпазон 0,0 - 1,0. Значэнне па змаўчанні 0,5.
8.114 virtualbass
Прымяніць аўдыяфільтр Virtual Bass.
Гэты фільтр прымае стэрэа ўваход і стварае стэрэа з выхаднымі каналамі LFE (2.1). Нядаўна выраблены канал LFE мае палепшаныя віртуальныя басы, першапачаткова атрыманыя з абодвух стэрэаканалаў. Гэты фільтр выводзіць пярэдні левы і пярэдні правы каналы без зменаў, даступныя ў стэрэа ўваходзе.
Фільтр прымае наступныя параметры:
cutoff
Усталюйце віртуальную частату зрэзу нізкіх частот. Значэнне па змаўчанні - 250 Гц. Дазволены дыяпазон ад 100 да 500 Гц.
strength
Усталюйце сілу віртуальнага басу. Дазволены дыяпазон ад 0,5 да 3. Значэнне па змаўчанні - 3.
8.115 volume
Адрэгулюйце гучнасць уваходнага гуку.
Ён прымае наступныя параметры:
volume
Задаць выраз гучнасці гуку.
Выхадныя значэнні абразаюцца да максімальнага значэння.
Гучнасць выхаднога гуку вызначаецца суадносінамі:
output_volume
=volume
*input_volume
Значэнне па змаўчанні
volume
- "1.0".precision
Гэты параметр уяўляе сабой матэматычную дакладнасць.
Ён вызначае, якія фарматы ўваходных выбарак будуць дазволеныя, што ўплывае на дакладнасць маштабавання гучнасці.
fixed
8-бітны з фіксаванай кропкай; гэта абмяжоўвае ўваходны фармат выбаркі да U8, S16 і S32.
float
32-разрадны з плаваючай кропкай; гэта абмяжоўвае фармат уводу выбаркі FLT. (па змаўчанні)
double
64-разрадная з плаваючай кропкай; гэта абмяжоўвае ўваходны фармат выбаркі DBL.
replaygain
Выберыце паводзіны пры выяўленні пабочных даных ReplayGain ва ўваходных кадрах.
drop
Выдаліць пабочныя дадзеныя ReplayGain, ігнаруючы іх змесціва (па змаўчанні).
ignore
Ігнараваць бакавыя даныя ReplayGain, але пакінуць іх у кадры.
track
Аддаць перавагу ўзмацненню трэка, калі яно ёсць.
album
Аддайце перавагу ўзмацненню альбома, калі яно ёсць.
replaygain_preamp
Узмацненне папярэдняга ўзмацнення ў дБ для прымянення да абранага ўзмацнення прайгравання.
Значэнне па змаўчанні роўна
replaygain_preamp
0,0.replaygain_noclip
Прадухіліце адсячэнне, абмежаваўшы ўзмацненне.
Значэнне па змаўчанні роўна
replaygain_noclip
1.eval
Устанавіце, калі вылічваецца выраз аб'ёму.
Ён прымае наступныя значэнні:
- '
once
' вылічваць выраз толькі адзін раз падчас ініцыялізацыі фільтра або калі '
volume
' каманда адпраўлена- '
frame
' ацэньваць выраз для кожнага ўваходнага кадра
Значэнне па змаўчанні '
once
'.- '
Выраз аб'ёму можа ўтрымліваць наступныя параметры.
n
нумар кадра (пачынаючы з нуля)
nb_channels
колькасць каналаў
nb_consumed_samples
колькасць узораў, спажываных фільтрам
nb_samples
колькасць узораў у бягучым кадры
pos
зыходная пазіцыя кадра ў файле
pts
каркас ПТС
sample_rate
частата выбаркі
startpts
PTS у пачатку трансляцыі
startt
час у пачатку трансляцыі
t
час кадра
tb
пазнака часу базы
volume
апошняе зададзенае значэнне гучнасці
Звярніце ўвагу, каліeval
усталяваны ў 'once
'
даступныя толькі зменныя і , усе астатнія зменныя будуць ацэньвацца як NAN
sample_rate
.tb
8.115.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
volume
Змяніце выраз гучнасці. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
8.115.2 Examples
- Паменшыць гучнасць уваходнага гуку ўдвая:
volume=volume=0.5 volume=volume=1/2 volume=volume=-6.0206dB
Ва ўсіх прыведзеных вышэй прыкладах названы ключ для
volume
можа быць апушчаны, напрыклад, як у:volume=0.5
- Павялічце магутнасць уваходнага гуку на 6 дэцыбел з дапамогай дакладнасці з фіксаванай кропкай:
volume=volume=6dB:precision=fixed
- Аб'ём згасання пасля часу 10 з перыядам анігіляцыі 5 секунд:
volume='if(lt(t,10),1,max(1-(t-10)/5,0))':eval=frame
8.116 volumedetect
Вызначыць гучнасць уваходнага відэа.
У фільтра няма параметраў. Ён падтрымлівае толькі 16-бітныя знакавыя цэлыя ўзоры, таму ўвод будзе пераўтвораны пры неабходнасці. Статыстыка аб'ёму будзе надрукавана ў журнале, калі будзе дасягнуты канец уваходнага патоку.
У прыватнасці, ён будзе паказваць сярэдні аб'ём (сярэднеквадратычны), максімальны аб'ём (на аснове кожнага ўзору) і пачатак гістаграмы зарэгістраваных значэнняў аб'ёму (ад максімальнага значэння да сукупнай 1/1000 узораў). ).
Усе аб'ёмы ў дэцыбелах адносна максімальнага значэння PCM.
8.116.1 Examples
Вось урывак з выхаду:
[Parsed_volumedetect_0 0xa23120] mean_volume: -27 dB
[Parsed_volumedetect_0 0xa23120] max_volume: -4 dB
[Parsed_volumedetect_0 0xa23120] histogram_4db: 6
[Parsed_volumedetect_0 0xa23120] histogram_5db: 62
[Parsed_volumedetect_0 0xa23120] histogram_6db: 286
[Parsed_volumedetect_0 0xa23120] histogram_7db: 1042
[Parsed_volumedetect_0 0xa23120] histogram_8db: 2551
[Parsed_volumedetect_0 0xa23120] histogram_9db: 4609
[Parsed_volumedetect_0 0xa23120] histogram_10db: 8409
Гэта азначае, што:
- Сярэдняя квадратычная энергія складае прыблізна -27 дБ, або 10^-2,7.
- Самая вялікая выбарка знаходзіцца пры -4 дБ, а дакладней, паміж -4 дБ і -5 дБ.
- Ёсць 6 выбарак пры -4 дБ, 62 пры -5 дБ, 286 пры -6 дБ і г.д.
Іншымі словамі, павышэнне гучнасці на +4 дБ не выклікае адсячэння, павелічэнне на +5 дБ выклікае адсячэнне для 6 узораў і г.д.
9 Audio Sources
Ніжэй прыводзіцца апісанне даступных на дадзены момант крыніц гуку.
9.1 abuffer
Буферызаваць аўдыякадры і зрабіць іх даступнымі для ланцужка фільтраў.
Гэтая крыніца ў асноўным прызначана для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersrc.h
.
Ён прымае наступныя параметры:
time_base
База часу, якая будзе выкарыстоўвацца для метак часу прадстаўленых кадраў. Ён павінен быць альбо лікам з плаваючай коскай, альбо ў форме
numerator
/denominator
.sample_rate
Частата дыскрэтызацыі ўваходных гукавых буфераў.
sample_fmt
Прыклад фармату ўваходных аўдыябуфераў. Альбо ўзор імя фармату, альбо яго адпаведнае цэлае прадстаўленне з пераліку AVSampleFormat у
libavutil/samplefmt.h
channel_layout
Схема канала ўваходных аўдыябуфераў. Альбо імя макета канала з channel_layout_map in
libavutil/channel_layout.c
або яго адпаведнае цэлае прадстаўленне з макрасаў AV_CH_LAYOUT_* уlibavutil/channel_layout.h
channels
Колькасць каналаў буфераў уваходнага гуку. Калі абодва
channels
пазначаныchannel_layout
, то яны павінны быць узгодненымі.
9.1.1 Examples
abuffer=sample_rate=44100:sample_fmt=s16p:channel_layout=stereo
будзе інструктаваць крыніцу прымаць планарнае 16-бітнае стэрэа са знакам на 44100 Гц. Паколькі ўзорны фармат з імем "s16p" адпавядае лічбе 6, а разметка "стэрэа" канала адпавядае значэнню 0x3, гэта эквівалентна:
abuffer=sample_rate=44100:sample_fmt=6:channel_layout=0x3
9.2 aevalsrc
Сфармаваць гукавы сігнал, вызначаны выразам.
Гэтая крыніца прымае на ўваход адзін або некалькі выразаў (па адным для кожнага канала), якія вылічваюцца і выкарыстоўваюцца для генерацыі адпаведнага гукавога сігналу.
Гэтая крыніца прымае наступныя параметры:
exprs
Усталяваць спіс выразаў, падзеленых '|', для кожнага асобнага канала. У выпадку, калі
channel_layout
параметр не пазначаны, выбраны макет канала залежыць ад колькасці прадстаўленых выразаў. У адваротным выпадку апошні ўказаны выраз прымяняецца да астатніх выходных каналаў.channel_layout, c
Усталюйце раскладку канала. Колькасць каналаў у зададзеным макеце павінна быць роўная колькасці зададзеных выразаў.
duration, d
Усталюйце мінімальную працягласць гуку з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Звярніце ўвагу, што выніковая працягласць можа быць большай за зададзеную, паколькі згенераваны аўдыя заўсёды абразаецца ў канцы поўнага кадра.
Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна.
nb_samples, n
Усталюйце колькасць выбарак на канал для кожнага выхаднога кадра, па змаўчанні 1024.
sample_rate, s
Укажыце частату выбаркі, па змаўчанні 44100.
Кожны выраз у exprs
можа ўтрымліваць наступныя канстанты:
n
нумар ацэненай пробы, пачынаючы з 0
t
час ацэненага ўзору, выражаны ў секундах, пачынаючы з 0
s
частата выбаркі
9.2.1 Examples
- Стварыць цішыню:
aevalsrc=0
- Сфармуйце сігнал sin з частатой 440 Гц, усталюйце частату дыскрэтызацыі 8000 Гц:
aevalsrc="sin(440*2*PI*t):s=8000"
- Сфармуйце двухканальны сігнал, відавочна ўкажыце размяшчэнне каналаў (пярэдні цэнтр + задні цэнтр):
aevalsrc="sin(420*2*PI*t)|cos(430*2*PI*t):c=FC|BC"
- Стварыць белы шум:
aevalsrc="-2+random(0)"
- Сфармуйце амплітудна-мадуляваны сігнал:
aevalsrc="sin(10*2*PI*t)*sin(880*2*PI*t)"
- Стварайце бінауральныя рытмы 2,5 Гц на носьбіце 360 Гц:
aevalsrc="0.1*sin(2*PI*(360-2.5/2)*t) | 0.1*sin(2*PI*(360+2.5/2)*t)"
9.3 afirsrc
Стварыце каэфіцыенты FIR з дапамогай метаду выбаркі частоты.
Атрыманы паток можна выкарыстоўваць з afir фільтрам для фільтрацыі гукавога сігналу.
Фільтр прымае наступныя параметры:
taps, t
Усталюйце колькасць каэфіцыентаў фільтра ў выходным аўдыяструмені. Значэнне па змаўчанні - 1025.
frequency, f
Усталюйце кропкі частаты, адкуль задаюцца велічыня і фаза. Гэта павінна быць у парадку не змяншэння, і першы элемент павінен быць 0, а апошні элемент павінен быць 1. Элементы падзяляюцца прабеламі.
magnitude, m
Усталюйце значэнне велічыні для кожнай частаты, зададзенай
frequency
. Колькасць значэнняў павінна супадаць з колькасцю кропак частаты. Значэнні аддзяляюцца прабеламі.phase, p
Усталюйце значэнне фазы для кожнай частаты, зададзенай
frequency
. Колькасць значэнняў павінна супадаць з колькасцю кропак частаты. Значэнні аддзяляюцца прабеламі.sample_rate, r
Задаць частату выбаркі, па змаўчанні 44100.
nb_samples, n
Усталюйце колькасць выбарак на кожны кадр. Па змаўчанні 1024.
win_func, w
Усталяваць функцыю акна. Па змаўчанні - blackman.
9.4 anullsrc
Нулявая крыніца аўдыя, вяртае неапрацаваныя аўдыякадры. Ён галоўным чынам карысны ў якасці шаблону і для выкарыстання ў інструментах аналізу/адладкі або ў якасці крыніцы для фільтраў, якія ігнаруюць ўваходныя даныя (напрыклад, фільтр sox synth).
Гэтая крыніца прымае наступныя параметры:
channel_layout, cl
-
Вызначае макет канала і можа быць як цэлым лікам, так і радком, які прадстаўляе макет канала. Значэнне па змаўчанні
channel_layout
- "стэрэа".Праверце вызначэнне channel_layout_map у
libavutil/channel_layout.c
для супастаўлення паміж радкамі і значэннямі макета канала. sample_rate, r
Вызначае частату выбаркі і па змаўчанні 44100.
nb_samples, n
Усталюйце колькасць выбарак на запытаныя кадры.
duration, d
Усталюйце працягласць аўдыя з крыніцы. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
Калі не вызначана або выказаная працягласць адмоўная, мяркуецца, што аўдыя будзе генеравацца вечна.
9.4.1 Examples
- Усталюйце частату дыскрэтызацыі на 48000 Гц і кампаноўку канала на AV_CH_LAYOUT_MONO.
anullsrc=r=48000:cl=4
- Выканайце тую ж аперацыю з больш відавочным сінтаксісам:
anullsrc=r=48000:cl=mono
Усе параметры павінны быць дакладна вызначаны.
9.5 flite
Сінтэзуйце галасавое выказванне з дапамогай бібліятэкі libflite.
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-libflite
.
Звярніце ўвагу, што версіі бібліятэкі flite да 2.0 не з'яўляюцца паточна-бяспечнымі.
Фільтр прымае наступныя параметры:
list_voices
Калі ўстаноўлена значэнне 1, пералічыць назвы даступных галасоў і неадкладна выйсці. Значэнне па змаўчанні 0.
nb_samples, n
Усталюйце максімальную колькасць выбарак на кадр. Значэнне па змаўчанні - 512.
textfile
Усталюйце імя файла, які змяшчае тэкст для прагаворвання.
text
Усталюйце тэкст для прамаўлення.
voice, v
Усталюйце голас для сінтэзу маўлення. Значэнне па змаўчанні -
kal
. Глядзіце таксамаlist_voices
варыянт.
9.5.1 Examples
- Чытаць з файла
speech.txt
, і сінтэзаваць тэкст з дапамогай стандартнага голасу flite:flite=textfile=speech.txt
- Прачытайце ўказаны тэкст, выбіраючы
slt
голас:flite=text='So fare thee well, poor devil of a Sub-Sub, whose commentator I am':voice=slt
- Увядзіце тэкст у ffmpeg:
ffmpeg -f lavfi -i flite=text='So fare thee well, poor devil of a Sub-Sub, whose commentator I am':voice=slt
- зрабіць
ffplay
прамаўляйце ўказаны тэкст, выкарыстоўваючыflite
іlavfi
прыладу:ffplay -f lavfi flite=text='No more be grieved for which that thou hast done.'
Для атрымання дадатковай інфармацыі пра libflite праверце: http://www.festvox.org/flite/
9.6 anoisesrc
Стварыце шумавы гукавы сігнал.
Фільтр прымае наступныя параметры:
sample_rate, r
Укажыце частату выбаркі. Значэнне па змаўчанні - 48000 Гц.
amplitude, a
Задайце амплітуду (0,0 - 1,0) згенераванага аўдыяструменю. Значэнне па змаўчанні 1,0.
duration, d
Пакажыце працягласць згенераванага аўдыёпатоку. Невызначэнне гэтага параметра прыводзіць да шуму бясконцай даўжыні.
color, colour, c
Укажыце колер шуму. Даступныя колеры шуму - белы, ружовы, карычневы, сіні, фіялетавы і аксамітны. Колер па змаўчанні - белы.
seed, s
Укажыце значэнне, якое выкарыстоўваецца для запаўнення PRNG.
nb_samples, n
Усталюйце колькасць выбарак на кожны выходны кадр, па змаўчанні 1024.
9.6.1 Examples
- Згенеруйце 60 секунд ружовага шуму з частатой дыскрэтызацыі 44,1 кГц і амплітудай 0,5:
anoisesrc=d=60:c=pink:r=44100:a=0.5
9.7 hilbert
Стварэнне няцотных каэфіцыентаў пераўтварэння Гільберта.
Атрыманы паток можа быць выкарыстаны з фільтрам afir для фазавага зруху сігналу на 90 градусаў.
Гэта выкарыстоўваецца ў многіх схемах матрычнага кадавання і для генерацыі аналітычнага сігналу. Працэс часта запісваюць як множанне на i (або j), уяўную адзінку.
Фільтр прымае наступныя параметры:
sample_rate, s
Задаць частату выбаркі, па змаўчанні 44100.
taps, t
Задаць даўжыню FIR-фільтра, па змаўчанні 22051.
nb_samples, n
Усталюйце колькасць выбарак на кожны кадр.
win_func, w
Задаць функцыю акна, якая будзе выкарыстоўвацца пры генерацыі каэфіцыентаў FIR.
9.8 sinc
Стварэнне каэфіцыентаў КІХ нізкіх частот, высокіх частот, паласы прапускання або паласы адхілення кіхтавых каэфіцыентаў sinc kaiser-window.
Атрыманы паток можна выкарыстоўваць з afir фільтрам для фільтрацыі гукавога сігналу.
Фільтр прымае наступныя параметры:
sample_rate, r
Задаць частату выбаркі, па змаўчанні 44100.
nb_samples, n
Усталюйце колькасць выбарак на кожны кадр. Па змаўчанні 1024.
hp
Усталюйце частату высокіх частот. Па змаўчанні 0.
lp
Усталюйце частату нізкіх частот. Па змаўчанні 0. Калі частата высокіх частот ніжэйшая за частату нізкіх частот, а частата нізкіх частот вышэй за 0, тады фільтр створыць каэфіцыенты паласавога фільтра, у адваротным выпадку каэфіцыенты паласавога фільтра.
phase
Усталюйце фазавую характарыстыку фільтра. Па змаўчанні - 50. Дазволены дыяпазон ад 0 да 100.
beta
Усталяваць бэта-версію акна Kaiser.
att
Усталюйце згасанне ў дыяпазоне прыпынку. Па змаўчанні 120 дБ, дазволены дыяпазон ад 40 да 180 дБ.
round
Уключыць акругленне, па змаўчанні адключана.
hptaps
Усталюйце колькасць кранаў для фільтра высокіх частот.
lptaps
Усталюйце колькасць кранаў для фільтра нізкіх частот.
9.9 sine
Сфармуйце гукавы сігнал з сінусоіды з амплітудай 1/8.
Гукавы сігнал з'яўляецца бітавым.
Фільтр прымае наступныя параметры:
frequency, f
Усталюйце нясучую частату. Стандартная частата - 440 Гц.
beep_factor, b
Уключыце перыядычны гукавы сігнал кожную секунду з частатой
beep_factor
, памножанай на нясучую. Па змаўчанні значэнне 0, што азначае, што гукавы сігнал адключаны.sample_rate, r
Укажыце частату выбаркі, па змаўчанні 44100.
duration, d
Пакажыце працягласць згенераванага аўдыёпатоку.
samples_per_frame
Усталюйце колькасць выбарак на выхадны кадр.
Выраз можа ўтрымліваць наступныя канстанты:
n
(Парадкавы) нумар выхаднога аўдыякадра, пачынаючы з 0.
pts
PTS (TimeStamp прэзентацыі) выхаднога аўдыякадра, выражаны ў
TB
адзінках.t
PTS выхаднога аўдыякадра, выражаны ў секундах.
TB
Часовая база выхадных аўдыякадраў.
Па змаўчанні
1024
.
9.9.1 Examples
- Згенераваць простую сінусоіду 440 Гц:
sine
- Стварыце сінусоід 220 Гц з гукавым сігналам 880 Гц кожную секунду на працягу 5 секунд:
sine=220:4:d=5 sine=f=220:b=4:d=5 sine=frequency=220:beep_factor=4:duration=5
- Стварыце сінусоіду 1 кГц па
1602,1601,1602,1601,1602
схеме NTSC:sine=1000:samples_per_frame='st(0,mod(n,5)); 1602-not(not(eq(ld(0),1)+eq(ld(0),3)))'
10 Audio Sinks
Ніжэй прыводзіцца апісанне даступных у цяперашні час аўдыёпрыёмнікаў.
10.1 abuffersink
Буферызаваць аўдыякадры і зрабіць іх даступнымі для канца ланцужка фільтраў.
Гэты прыёмнік у асноўным прызначаны для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersink.h
або сістэма опцый.
Ён прымае паказальнік на структуру AVABufferSinkContext, якая вызначае фарматы ўваходных буфераў, які будзе перададзены ў якасці непразрыстага параметра avfilter_init_filter
для ініцыялізацыі.
10.2 anullsink
Null аўдыё ракавіна; не рабіць абсалютна нічога з уваходным гукам. Ён галоўным чынам карысны як шаблон і для выкарыстання ў інструментах аналізу/адладкі.
11 Video Filters
Калі вы наладжваеце зборку FFmpeg, вы можаце адключыць любы з існуючых фільтраў з дапамогай --disable-filters
. Выхад канфігурацыі пакажа відэафільтры, уключаныя ў вашу зборку.
Ніжэй прыводзіцца апісанне даступных на дадзены момант відэафільтраў.
11.1 addroi
Адзначце вобласць цікавасці ў кадры відэа.
Даныя кадра перадаюцца ў нязменным выглядзе, але метаданыя далучаюцца да кадра з указаннем цікавых рэгіёнаў, якія могуць паўплываць на паводзіны наступнага кадавання. Некалькі рэгіёнаў можна пазначыць, ужываючы фільтр некалькі разоў.
x
Адлегласць вобласці ў пікселях ад левага краю кадра.
y
Адлегласць вобласці ў пікселях ад верхняга краю кадра.
w
Шырыня вобласці ў пікселях.
h
Вышыня вобласці ў пікселях.
Параметры
x
,y
,w
іh
з'яўляюцца выразамі і могуць утрымліваць наступныя зменныя:iw
Шырыня ўваходнага кадра.
ih
Вышыня ўваходнага кадра.
qoffset
Зрушэнне квантавання для прымянення ў рэгіёне.
Гэта павінна быць рэальнае значэнне ў дыяпазоне ад -1 да +1. Нулявое значэнне азначае адсутнасць змены якасці. Адмоўнае значэнне патрабуе лепшай якасці (меншае квантаванне), а станоўчае значэнне патрабуе горшай якасці (большае квантаванне).
Дыяпазон адкалібраваны такім чынам, што крайнія значэнні паказваюць максімальна магчымае зрушэнне - калі астатняя частка кадра закадзіравана з найгоршай магчымай якасцю, зрушэнне -1 паказвае, што гэтая вобласць у любым выпадку павінна быць закадзіравана з найлепшай магчымай якасцю. Затым прамежкавыя значэнні інтэрпалююцца нейкім залежным ад кодэка спосабам.
Напрыклад, у 10-бітным H.264 параметр квантавання вар'іруецца ад -12 да 51. Такім чынам, тыповае значэнне qoffset, роўнае -1/10, паказвае, што гэтая вобласць павінна быць закадзіравана з QP прыкладна на адну дзесятую поўнага дыяпазону лепш, чым астатняя частка кадра. Такім чынам, калі большая частка кадра павінна быць закадзіравана з QP каля 30, гэты рэгіён атрымае QP каля 24 (зрушэнне прыблізна -1/10 * (51 - -12) = -6,3). Крайняе значэнне -1 будзе азначаць, што гэтая вобласць павінна быць закадзіравана з найлепшай магчымай якасцю, незалежна ад апрацоўкі астатняй часткі кадра - гэта значыць павінна быць закадзіравана з QP -12.
clear
Калі зададзена значэнне "true", выдаліце ​​ўсе існуючыя рэгіёны цікавасці, пазначаныя на фрэйме, перш чым дадаваць новы.
11.1.1 Examples
- Адзначце цэнтральную чвэрць кадра як цікавую.
addroi=iw/4:ih/4:iw/2:ih/2:-1/10
- Пазначце вобласць шырынёй 100 пікселяў на левым краі кадра як вельмі нецікавую (якая павінна быць закадавана значна ніжэй, чым астатняя частка кадра).
addroi=0:0:100:ih:+1/5
11.2 alphaextract
Выняць альфа-кампанент з уводу як відэа ў адценнях шэрага. Гэта асабліва карысна з alphamerge
фільтрам.
11.3 alphamerge
Дадайце або заменіце альфа-кампанент першаснага ўваходу на значэнне адценняў шэрага другога ўваходу. Гэта прызначана для выкарыстання з
alphaextract
тым, каб дазволіць перадачу або захоўванне паслядоўнасцей кадраў, якія маюць альфа-версію ў фармаце, які не падтрымлівае альфа-канал.
Напрыклад, каб аднавіць поўныя кадры з звычайнага відэа, закадзіраванага YUV, і асобнага відэа, створанага з дапамогай alphaextract
, вы можаце выкарыстоўваць:
movie=in_alpha.mkv [alpha]; [in][alpha] alphamerge [out]
11.4 amplify
Узмацніць адрозненні паміж бягучым пікселем і пікселямі суседніх кадраў у тым самым месцы пікселя.
Гэты фільтр прымае наступныя параметры:
radius
Усталюйце радыус рамкі. Па змаўчанні - 2. Дазволены дыяпазон ад 1 да 63. Напрыклад, радыус 3 загадае фільтру вылічыць сярэдняе значэнне з 7 кадраў.
factor
Усталюйце каэфіцыент для ўзмацнення розніцы. Па змаўчанні - 2. Дазволены дыяпазон ад 0 да 65535.
threshold
Усталюйце парог для ўзмацнення розніцы. Любая розніца, большая або роўная гэтаму значэнню, не зменіць зыходны піксель. Па змаўчанні 10. Дазволены дыяпазон ад 0 да 65535.
tolerance
Усталюйце допуск для ўзмацнення розніцы. Любая розніца ніжэй гэтага значэння не зменіць зыходны піксель. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 65535.
low
Усталюйце ніжнюю мяжу для змены зыходнага пікселя. Па змаўчанні - 65535. Дазволены дыяпазон ад 0 да 65535. Гэты параметр кантралюе максімальна магчымае значэнне, якое паменшыць значэнне зыходнага пікселя.
high
Усталюйце верхнюю мяжу для змены зыходнага пікселя. Па змаўчанні - 65535. Дазволены дыяпазон ад 0 да 65535. Гэты параметр кантралюе максімальна магчымае значэнне, якое павялічыць значэнне зыходнага пікселя.
planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.
11.4.1 Commands
Гэты фільтр падтрымлівае наступныя каманды , якія адпавядаюць аднаіменнай опцыі:
factor
threshold
tolerance
low
high
planes
11.5 ass
Тое самае, што і фільтр субтытраў , за выключэннем таго, што для яго працы не патрабуецца libavcodec і libavformat. З іншага боку, ён абмежаваны файламі субтытраў ASS (Advanced Substation Alpha).
Гэты фільтр прымае наступныя параметры ў дадатак да агульных параметраў з фільтра субтытраў :
shaping
Усталюйце механізм фармавання
Даступныя значэнні:
- '
auto
' Механізм фармавання libass па змаўчанні, які з'яўляецца лепшым даступным.
- '
simple
' Хуткая праграма для фарміравання шрыфтоў, якая можа рабіць толькі замены
- '
complex
' Больш павольны фармавальнік з выкарыстаннем OpenType для замен і пазіцыянавання
Па змаўчанні -
auto
.- '
11.6 atadenoise
Прымяніць адаптыўнае часовае асерадненне шуму да відэаўваходу.
Фільтр прымае наступныя параметры:
0a
Усталюйце парог A для 1-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.
0b
Усталюйце парог B для 1-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.
1a
Усталюйце парог A для 2-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.
1b
Усталюйце парог B для 2-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.
2a
Усталюйце парог A для 3-й плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0 да 0,3.
2b
Усталюйце парог B для 3-й плоскасці. Па змаўчанні 0,04. Дапушчальны дыяпазон ад 0 да 5.
Парог A прызначаны для рэагавання на рэзкія змены ўваходнага сігналу, а парог B прызначаны для рэагавання на бесперапынныя змены ўваходнага сігналу.
s
Зададзеная колькасць кадраў, якія фільтр будзе выкарыстоўваць для асераднення. Па змаўчанні 9. Павінен быць няцотны лік у дыяпазоне [5, 129].
p
Усталюйце, якія плоскасці кадравага фільтра будуць выкарыстоўвацца для асераднення. Па змаўчанні ўсё.
a
Усталюйце, які варыянт алгарытму фільтра будзе выкарыстоўваць для асераднення. Па змаўчанні -
p
паралельна. Альтэрнатыўна можа быць усталяваныs
паслядоўны.Паралельны можа быць хутчэй, чым паслядоўны, у той час як наадварот ніколі не бывае. Паралельны перарываецца рана, калі першае змяненне будзе большым за парогавыя значэнні, у той час як паслядоўны працягне апрацоўваць іншы бок кадраў, калі яны роўныя або ніжэйшыя за парогавыя значэнні.
0s
1s
2s
Усталюйце сігму для 1-й плоскасці, 2-й плоскасці або 3-й плоскасці. Па змаўчанні 32767. Дапушчальны дыяпазон ад 0 да 32767. Гэты параметр кантралюе вагу для кожнага пікселя ў радыусе, вызначаным памерам. Значэнне па змаўчанні азначае, што кожны піксель мае аднолькавую вагу. Вызначэнне гэтай опцыі на 0 эфектыўна адключае фільтрацыю.
11.6.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры, акрамя параметра s
. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
11.7 avgblur
Прымяніць фільтр сярэдняй размытасці.
Фільтр прымае наступныя параметры:
sizeX
Усталюйце памер гарызантальнага радыусу.
planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.
sizeY
Усталюйце памер вертыкальнага радыуса, калі роўны нулю, ён будзе такім жа, як
sizeX
. Па змаўчанні0
.
11.7.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.8 bbox
Вылічыце абмежавальную рамку для нячорных пікселяў у плоскасці яркасці ўваходнага кадра.
Гэты фільтр вылічвае абмежавальную рамку, якая змяшчае ўсе пікселі са значэннем яркасці большым за мінімальна дазволенае значэнне. Параметры, якія апісваюць абмежавальную рамку, друкуюцца ў журнале фільтра.
Фільтр прымае наступныя параметры:
min_val
Усталюйце мінімальнае значэнне яркасці. Па змаўчанні
16
.
11.8.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.9 bilateral
Прымяніць двухбаковы фільтр, прасторавае згладжванне з захаваннем краёў.
Фільтр прымае наступныя параметры:
sigmaS
Усталюйце сігму функцыі Гаўса для разліку прасторавай вагі. Дазволены дыяпазон ад 0 да 512. Па змаўчанні 0,1.
sigmaR
Усталюйце сігму функцыі Гаўса для разліку вагі дыяпазону. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,1.
planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.
11.9.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.10 bitplanenoise
Паказваць і вымяраць шум разраднай плоскасці.
Фільтр прымае наступныя параметры:
bitplane
Усталюйце, якую плоскасць аналізаваць. Па змаўчанні
1
.filter
Адфільтраваць шумныя пікселі з
bitplane
набору вышэй. Па змаўчанні адключана.
11.11 blackdetect
Выяўленне інтэрвалаў відэа, якія (амаль) цалкам чорныя. Можа быць карысным для выяўлення пераходаў раздзелаў, рэкламных ролікаў або несапраўдных запісаў.
Фільтр выводзіць свой аналіз выяўлення як у журнал, так і ў метаданыя кадра. Калі знойдзены чорны сегмент прынамсі зададзенай мінімальнай працягласці, радок з пазнакамі часу пачатку і канца, а таксама працягласцю друкуецца ў журнале з узроўнем info
. Акрамя таго, для кожнага кадра друкуецца радок часопіса з узроўнем debug
, які паказвае колькасць чорнага, выяўленага для гэтага кадра.
Фільтр таксама далучае метададзеныя да першага кадра чорнага сегмента з ключом lavfi.black_start
і да першага кадра пасля таго, як чорны сегмент заканчваецца ключом lavfi.black_end
. Значэннем з'яўляецца метка часу кадра. Гэтыя метаданыя дадаюцца незалежна ад указанай мінімальнай працягласці.
Фільтр прымае наступныя параметры:
black_min_duration, d
Усталюйце мінімальную працягласць выяўленага чорнага, выражаную ў секундах. Гэта павінен быць неадмоўны лік з плаваючай коскай.
Значэнне па змаўчанні 2.0.
picture_black_ratio_th, pic_th
Усталюйце парог для таго, каб лічыць карціну «чорнай». Выразіце мінімальнае значэнне адносіны:
nb_black_pixels
/nb_pixels
для якіх малюнак лічыцца чорным. Значэнне па змаўчанні 0,98.
pixel_black_th, pix_th
Усталюйце парог для таго, каб піксель лічыўся "чорным".
Парог выражае максімальнае значэнне яркасці пікселя, для якога піксель лічыцца "чорным". Дадзенае значэнне маштабуецца ў адпаведнасці з наступным ураўненнем:
absolute_threshold
=luminance_minimum_value
+pixel_black_th
*luminance_range_size
luminance_range_size
іluminance_minimum_value
залежыць ад уваходнага фармату відэа, дыяпазон [0-255] для фарматаў поўнага дыяпазону YUV і [16-235] для фарматаў не поўнага дыяпазону YUV.Значэнне па змаўчанні 0,10.
У наступным прыкладзе задаецца мінімальнае значэнне для максімальнага пікселя і выяўляюцца толькі чорныя інтэрвалы даўжынёй 2 і больш секунд:
blackdetect=d=2:pix_th=0.00
11.12 blackframe
Выяўляць кадры, якія (амаль) цалкам чорныя. Можа быць карысным для выяўлення пераходаў раздзелаў або рэкламных ролікаў. Выхадныя радкі складаюцца з нумара выяўленага кадра, працэнта чорнасці, пазіцыі ў файле, калі вядома, або -1, і меткі часу ў секундах.
Для таго, каб адлюстраваць выходныя радкі, вам трэба ўсталяваць узровень часопіса як мінімум да значэння AV_LOG_INFO.
Гэты фільтр экспартуе метаданыя фрэйма lavfi.blackframe.pblack
. Значэнне ўяўляе працэнт пікселяў на малюнку, якія ніжэйшыя за парогавае значэнне.
Ён прымае наступныя параметры:
amount
Працэнт пікселяў, якія павінны быць ніжэй за парог; па змаўчанні
98
.threshold, thresh
Парог, ніжэй за які значэнне пікселя лічыцца чорным; па змаўчанні
32
.
11.13 blend
Змяшайце два відэакадра адзін у аднаго.
Фільтр blend
прымае два ўваходныя патокі і выводзіць адзін паток, першы ўваход - гэта "верхні" ўзровень, а другі - "ніжні". Па змаўчанні вывад завяршаецца, калі завяршаецца самы доўгі ўвод.
Фільтр tblend
(змешванне часу) бярэ два паслядоўныя кадры з аднаго патоку і выдае вынік, атрыманы шляхам змешвання новага кадра паверх старога кадра.
Далей апісваюцца прынятыя варыянты.
c0_mode
c1_mode
c2_mode
c3_mode
all_mode
Усталюйце рэжым змешвання для пэўнага піксельнага кампанента або для ўсіх піксельных кампанентаў у выпадку
all_mode
. Значэнне па змаўчанні -normal
.Даступныя значэнні для рэжымаў кампанентаў:
- '
addition
' - '
and
' - '
average
' - '
bleach
' - '
burn
' - '
darken
' - '
difference
' - '
divide
' - '
dodge
' - '
exclusion
' - '
extremity
' - '
freeze
' - '
geometric
' - '
glow
' - '
grainextract
' - '
grainmerge
' - '
hardlight
' - '
hardmix
' - '
hardoverlay
' - '
harmonic
' - '
heat
' - '
interpolate
' - '
lighten
' - '
linearlight
' - '
multiply
' - '
multiply128
' - '
negation
' - '
normal
' - '
or
' - '
overlay
' - '
phoenix
' - '
pinlight
' - '
reflect
' - '
screen
' - '
softdifference
' - '
softlight
' - '
stain
' - '
subtract
' - '
vividlight
' - '
xor
'
- '
c0_opacity
c1_opacity
c2_opacity
c3_opacity
all_opacity
Устанавіць непразрыстасць сумесі для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку
all_opacity
. Выкарыстоўваецца толькі ў спалучэнні з рэжымамі змешвання піксельных кампанентаў.c0_expr
c1_expr
c2_expr
c3_expr
all_expr
Устанавіць выраз змешвання для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку
all_expr
. Звярніце ўвагу, што звязаныя параметры рэжыму будуць ігнаравацца, калі яны ўстаноўлены.Выразы могуць выкарыстоўваць наступныя зменныя:
N
Парадкавы нумар адфільтраванага кадра, пачынаючы з
0
.X
Y
каардынаты бягучага ўзору
W
H
шырыня і вышыня бягучай фільтраванай плоскасці
SW
SH
Шкала шырыні і вышыні для плоскасці, якая фільтруецца. Гэта стаўленне паміж памерамі бягучай плоскасці і плоскасці яркасці, напрыклад, для
yuv420p
кадра значэнні адносяцца1,1
да плоскасці яркасці і плоскасцей0.5,0.5
каляровасці.T
Час бягучага кадра, выражаны ў секундах.
TOP, A
Значэнне піксельнага кампанента ў бягучым месцы для першага відэакадра (верхні ўзровень).
BOTTOM, B
Значэнне піксельнага кампанента ў бягучым месцы для другога кадра відэа (ніжні ўзровень).
Фільтр blend
таксама падтрымлівае параметры framesync .
11.13.1 Examples
- Прымяніць пераход ад ніжняга пласта да верхняга ў першыя 10 секунд:
blend=all_expr='A*(if(gte(T,10),1,T/10))+B*(1-(if(gte(T,10),1,T/10)))'
- Прымяніце лінейны гарызантальны пераход ад верхняга пласта да ніжняга:
blend=all_expr='A*(X/W)+B*(1-X/W)'
- Прымяніць эфект шахматнай дошкі 1x1:
blend=all_expr='if(eq(mod(X,2),mod(Y,2)),A,B)'
- Прымяніць левы эфект раскрыцця:
blend=all_expr='if(gte(N*SW+X,W),A,B)'
- Прымяніць эфект раскрыцця пуху:
blend=all_expr='if(gte(Y-N*SH,0),A,B)'
- Прымяніць эфект раскрыцця ўверх і ўлева:
blend=all_expr='if(gte(T*SH*40+Y,H)*gte((T*40*SW+X)*W/H,W),A,B)'
- Падзяліць відэа па дыяганалі і паказаць верхні і ніжні пласт з кожнага боку:
blend=all_expr='if(gt(X,Y*(W/H)),A,B)'
- Адлюстраванне адрозненняў паміж бягучым і папярэднім кадрам:
tblend=all_mode=grainextract
11.13.2 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.14 blockdetect
Вызначае блокавасць кадраў без змены ўваходных кадраў.
На аснове Рэмка Муіджа і Ігара Кірэнкі: «Мера артэфактаў блакіроўкі без спасылак для адаптыўнай апрацоўкі відэа». 2005 13-я Еўрапейская канферэнцыя па апрацоўцы сігналаў.
Фільтр прымае наступныя параметры:
period_min
period_max
Усталюйце мінімальныя і максімальныя значэнні для вызначэння піксельных сетак (перыядаў). Значэнні па змаўчанні: [3,24].
planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.
11.14.1 Examples
- Вызначце блокавасць для першай плоскасці і знайдзіце перыяды ў [8,32]:
blockdetect=period_min=8:period_max=32:planes=1
11.15 blurdetect
Вызначае размытасць кадраў без змены ўваходных кадраў.
На аснове Marziliano, Pina і інш. «Метрыка перцэпцыйнага размыцця без спасылак». Дазваляе абрэвіятуру на аснове блокаў.
Фільтр прымае наступныя параметры:
low
high
Усталюйце нізкія і высокія парогавыя значэнні, якія выкарыстоўваюцца парогавым алгарытмам Canny.
Высокі парог выбірае "моцныя" краявыя пікселі, якія затым злучаюцца праз 8-сувязь са "слабымі" краявымі пікселямі, выбранымі нізкім парогам.
low
іhigh
парогавыя значэнні павінны быць выбраны ў дыяпазоне [0,1] іlow
павінны быць меншымі або роўныміhigh
.Значэнне па змаўчанні для
low
,20/255
а значэнне па змаўчанніhigh
для50/255
.radius
Вызначце радыус для пошуку лакальных максімумаў вакол краёвага пікселя.
block_pct
Вызначце размытасць толькі для найбольш значных блокаў, у працэнтах.
block_width
Вызначце размытасць для блокаў шырынёй
block_width
. Калі ўсталявана любое значэнне меншае за 1, блокі не выкарыстоўваюцца, і ўвесь відарыс апрацоўваецца як адно, незалежна адblock_height
.block_height
Вызначце размытасць для блокаў вышыні
block_height
. Калі ўсталявана любое значэнне меншае за 1, блокі не выкарыстоўваюцца, і ўвесь відарыс апрацоўваецца як адно, незалежна адblock_width
.planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.
11.15.1 Examples
- Вызначце размытасць для 80% найбольш значных блокаў 32x32:
blurdetect=block_width=32:block_height=32:block_pct=80
11.16 bm3d
Знішчэнне шуму ў кадрах з дапамогай 3D-алгарытму Block-Matching.
Фільтр прымае наступныя параметры.
sigma
Усталюйце сілу шумашумлення. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 0 да 999,9. Алгарытм знішчэння шуму вельмі адчувальны да сігма, таму наладзьце яго ў адпаведнасці з крыніцай.
block
Усталюйце лакальны памер патча. Гэта задае памеры ў 2D.
bstep
Задаць крок слізгацення для апрацоўкі блокаў. Значэнне па змаўчанні - 4. Дазволены дыяпазон ад 1 да 64. Меншыя значэнні дазваляюць апрацоўваць больш блокаў спасылак і павольней.
group
Усталюйце максімальную колькасць падобных блокаў для 3-га вымярэння. Значэнне па змаўчанні - 1. Калі ўсталявана 1, супастаўленне блокаў не праводзіцца. Большыя значэнні дазваляюць больш блокаў у адной групе. Дазволены дыяпазон ад 1 да 256.
range
Усталюйце радыус для супастаўлення пошукавых блокаў. Па змаўчанні 9. Дазволены дыяпазон ад 1 да INT32_MAX.
mstep
Усталюйце крок паміж двума месцамі пошуку для супастаўлення блокаў. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 64. Меншы - павольней.
thmse
Устанавіць парог сярэднеквадратычнай памылкі для супастаўлення блокаў. Дапушчальны дыяпазон ад 0 да INT32_MAX.
hdthr
Усталюйце парогавы параметр для жорсткага парогавага значэння ў 3D-пераўтвораным дамене. Большыя значэнні прыводзяць да больш жорсткай парогавай фільтрацыі ў частотнай вобласці.
estim
Усталюйце рэжым ацэнкі фільтрацыі. Можа быць
basic
абоfinal
. Па змаўчанніbasic
.ref
Калі ўключаны, фільтр будзе выкарыстоўваць 2-і паток для супастаўлення блокаў. Па змаўчанні адключана для
basic
значэнняestim
параметра і заўсёды ўключана, калі значэннеestim
роўнаfinal
.planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні даступныя ўсе, акрамя альфа-версіі.
11.16.1 Examples
- Базавая фільтрацыя з bm3d:
bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic
- Тое самае, што і вышэй, але фільтруецца толькі яркасць:
bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic:planes=1
- Тое самае, што і вышэй, але з абодвума рэжымамі ацэнкі:
split[a][b],[a]bm3d=sigma=3:block=4:bstep=2:group=1:estim=basic[a],[b][a]bm3d=sigma=3:block=4:bstep=2:group=16:estim=final:ref=1
- Тое самае, што і вышэй, але замест папярэдняга фільтра выкарыстоўваецца фільтр nlmeans :
split[a][b],[a]nlmeans=s=3:r=7:p=3[a],[b][a]bm3d=sigma=3:block=4:bstep=2:group=16:estim=final:ref=1
11.17 boxblur
Прымяніць алгарытм размыцця скрынкі да ўваходнага відэа.
Ён прымае наступныя параметры:
luma_radius, lr
luma_power, lp
chroma_radius, cr
chroma_power, cp
alpha_radius, ar
alpha_power, ap
Далей апісваюцца прынятыя варыянты.
luma_radius, lr
chroma_radius, cr
alpha_radius, ar
Усталюйце выраз для радыуса поля ў пікселях, які выкарыстоўваецца для размыцця адпаведнай плоскасці ўводу.
Значэнне радыуса павінна быць неадмоўным лікам і не павінна перавышаць значэнне выразу
min(w,h)/2
для плоскасцей яркасці і альфа, а таксамаmin(cw,ch)/2
для плоскасцей каляровасці.Значэнне па змаўчанні для
luma_radius
роўна "2". Калі не ўказана,chroma_radius
іalpha_radius
па змаўчанні адпаведнае значэнне, усталяванае дляluma_radius
.Выразы могуць утрымліваць наступныя канстанты:
w
h
Шырыня і вышыня ўводу ў пікселях.
cw
ch
Шырыня і вышыня уваходнага каляровага малюнка ў пікселях.
hsub
vsub
Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.
luma_power, lp
chroma_power, cp
alpha_power, ap
Укажыце, колькі разоў фільтр boxblur прымяняецца да адпаведнай плоскасці.
Значэнне па змаўчанні для
luma_power
роўна 2. Калі не пазначана,chroma_power
іalpha_power
па змаўчанні адпаведнае значэнне, усталяванае дляluma_power
.Значэнне 0 адключыць эфект.
11.17.1 Examples
- Прымяніце фільтр BoxBlur з радыусамі яркасці, каляровасці і альфа-канала, усталяванымі на 2:
boxblur=luma_radius=2:luma_power=1 boxblur=2:1
- Усталюйце радыус яркасці на 2, а радыус альфа- і каляровасці на 0:
boxblur=2:1:cr=0:ar=0
- Усталюйце радыусы яркасці і каляровасці на частку памеру відэа:
boxblur=luma_radius=min(h\,w)/10:luma_power=1:chroma_radius=min(cw\,ch)/10:chroma_power=1
11.18 bwdif
Дэінтэрлейсаванне ўваходнага відэа ("bwdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу Боба Уівера").
Адаптыўны дэінтэрлейсінг да руху на аснове yadif з выкарыстаннем алгарытмаў w3fdif і кубічнай інтэрпаляцыі. Ён прымае наступныя параметры:
mode
Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:
0, send_frame
Вывесці па адным кадры для кожнага кадра.
1, send_field
Вывесці па адным кадры для кожнага поля.
Значэнне па змаўчанні -
send_field
.parity
Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:
0, tff
Выкажам здагадку, што верхняе поле - першае.
1, bff
Выкажам здагадку, што ніжняе поле з'яўляецца першым.
-1, auto
Уключыць аўтаматычнае вызначэнне парытэту поля.
Значэнне па змаўчанні -
auto
. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.deint
Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:
0, all
Дэінтэрлейс усіх кадраў.
1, interlaced
Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.
Значэнне па змаўчанні -
all
.
11.19 cas
Ужыць фільтр Adaptive Sharpen Contrast да відэаструменю.
Фільтр прымае наступныя параметры:
strength
Усталюйце сілу завострывання. Значэнне па змаўчанні 0.
planes
Усталюйце плоскасці для фільтрацыі. Значэнне па змаўчанні - фільтраваць усе плоскасці, акрамя альфа-плоскасці.
11.19.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.20 chromahold
Выдаліць усю інфармацыю аб колерах для ўсіх колераў, акрамя пэўнага.
Фільтр прымае наступныя параметры:
color
Колер, які не будзе заменены нейтральнай каляровасцю.
similarity
Працэнт падабенства з вышэйзгаданым колерам. 0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.
blend
Працэнт сумесі. 0.0 робіць пікселі альбо цалкам шэрымі, альбо зусім не шэрымі. Больш высокія значэнні забяспечваюць больш захаваны колер.
yuv
Сігналізуе, што пройдзены колер ужо ў YUV замест RGB.
Літаральныя колеры, такія як "зялёны" ці "чырвоны", больш не маюць сэнсу, калі гэта ўключана. Гэта можна выкарыстоўваць для перадачы дакладных значэнняў YUV у выглядзе шаснаццатковых лікаў.
11.20.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.21 chromakey
Каляровая прастора YUV.
Фільтр прымае наступныя параметры:
color
Колер, які будзе заменены на празрыстасць.
similarity
Працэнт падабенства з колерам ключа.
0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.
blend
Працэнт сумесі.
0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.
Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.
yuv
Сігналізуе, што пройдзены колер ужо ў YUV замест RGB.
Літаральныя колеры, такія як "зялёны" ці "чырвоны", больш не маюць сэнсу, калі гэта ўключана. Гэта можна выкарыстоўваць для перадачы дакладных значэнняў YUV у выглядзе шаснаццатковых лікаў.
11.21.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.21.2 Examples
- Зрабіце кожны зялёны піксель на ўваходным малюнку празрыстым:
ffmpeg -i input.png -vf chromakey=green out.png
- Накласці зялёнае відэа на статычны чорны фон.
ffmpeg -f lavfi -i color=c=black:s=1280x720 -i video.mp4 -shortest -filter_complex "[1:v]chromakey=0x70de77:0.1:0.2[ckout];[0:v][ckout]overlay[out]" -map "[out]" output.mkv
11.22 chromakey_cuda
CUDA паскорыла каляровую/каляровую маніпуляцыю каляровай прасторы YUV.
Гэты фільтр працуе як звычайны каляровы фільтр, але працуе з кадрамі CUDA. для больш падрабязнай інфармацыі і параметраў глядзіце chromakey .
11.22.1 Examples
- Зрабіце ўсе зялёныя пікселі ва ўваходным відэа празрыстымі і выкарыстоўвайце іх у якасці накладання для іншага відэа:
./ffmpeg \ -hwaccel cuda -hwaccel_output_format cuda -i input_green.mp4 \ -hwaccel cuda -hwaccel_output_format cuda -i base_video.mp4 \ -init_hw_device cuda \ -filter_complex \ " \ [0:v]chromakey_cuda=0x25302D:0.1:0.12:1[overlay_video]; \ [1:v]scale_cuda=format=yuv420p[base]; \ [base][overlay_video]overlay_cuda" \ -an -sn -c:v h264_nvenc -cq 20 output.mp4
- Апрацуйце дзве крыніцы праграмнага забеспячэння, відавочна загрузіўшы кадры:
./ffmpeg -init_hw_device cuda=cuda -filter_hw_device cuda \ -f lavfi -i color=size=800x600:color=white,format=yuv420p \ -f lavfi -i yuvtestsrc=size=200x200,format=yuv420p \ -filter_complex \ " \ [0]hwupload[under]; \ [1]hwupload,chromakey_cuda=green:0.1:0.12[over]; \ [under][over]overlay_cuda" \ -c:v hevc_nvenc -cq 18 -preset slow output.mp4
11.23 chromanr
Паменшыць каляровы шум.
Фільтр прымае наступныя параметры:
thres
Усталюйце парог для асераднення значэнняў каляровасці. Сума абсалютнай рознасці піксельных кампанентаў Y, U і V бягучага пікселя і суседніх пікселяў, ніжэйшых за гэты парог, будзе выкарыстоўвацца пры вылічэнні сярэдняга значэння. Кампанент Luma застаецца без зменаў і капіюецца на выхад. Значэнне па змаўчанні - 30. Дазволены дыяпазон - ад 1 да 200.
sizew
Задайце гарызантальны радыус прамавугольніка, які выкарыстоўваецца для асераднення. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 5.
sizeh
Задайце вертыкальны радыус прамавугольніка, які выкарыстоўваецца для асераднення. Дазволены дыяпазон ад 1 да 100. Значэнне па змаўчанні - 5.
stepw
Усталюйце гарызантальны крок пры асерадненні. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 50. У асноўным карысна для паскарэння фільтрацыі.
steph
Усталюйце крок па вертыкалі пры асерадненні. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 50. У асноўным карысна для паскарэння фільтрацыі.
threy
Усталюйце парог Y для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі Y бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.
threu
Усталюйце парог U для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі U бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.
threv
Усталюйце парог V для асераднення значэнняў каляровасці. Усталюйце больш дакладны кантроль для максімальна дазволенай розніцы паміж кампанентамі V бягучага пікселя і суседніх пікселяў. Значэнне па змаўчанні - 200. Дазволены дыяпазон ад 1 да 200.
distance
Усталюйце тып адлегласці, які выкарыстоўваецца ў разліках.
- '
manhattan
' Абсалютная розніца.
- '
euclidean
' Розніца ў квадраце.
Тып адлегласці па змаўчанні - Manhattan.
- '
11.23.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
11.24 chromashift
Зрух пікселяў каляровасці па гарызанталі і/або вертыкалі.
Фільтр прымае наступныя параметры:
cbh
Усталюйце велічыню зрушэння сіняга колеру па гарызанталі.
cbv
Усталюйце велічыню зрушэння сіняга колеру па вертыкалі.
crh
Усталюйце велічыню зрушэння колерна-чырвонага па гарызанталі.
crv
Усталюйце велічыню зруху колерна-чырвонага па вертыкалі.
edge
Усталяваць рэжым краю, можа быць
smear
, стандартны абоwarp
.
11.24.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.25 ciescope
Адлюстраванне каляровай дыяграмы CIE з накладзенымі на яе пікселямі.
Фільтр прымае наступныя параметры:
system
Усталяваць каляровую сістэму.
- '
ntsc, 470m
' - '
ebu, 470bg
' - '
smpte
' - '
240m
' - '
apple
' - '
widergb
' - '
cie1931
' - '
rec709, hdtv
' - '
uhdtv, rec2020
' - '
dcip3
'
- '
cie
Усталяваць сістэму CIE.
- '
xyy
' - '
ucs
' - '
luv
'
- '
gamuts
Усталюйце, якія гамы маляваць.
Глядзіце
system
варыянт для даступных значэнняў.size, s
Усталюйце памер ciescope, па змаўчанні 512.
intensity, i
Задайце інтэнсіўнасць, якая выкарыстоўваецца для адлюстравання значэнняў уваходных пікселяў у дыяграме CIE.
contrast
Задаць кантраст, які выкарыстоўваецца для малявання колераў мовы, якія выходзяць за межы актыўнай каляровай гамы.
corrgamma
Правільная гама адлюстроўваецца на прыцэле, па змаўчанні ўключана.
showwhite
Паказаць белую кропку на дыяграме CIE, па змаўчанні адключана.
gamma
Задаць гаму ўводу. Выкарыстоўваецца толькі з уваходнай каляровай прасторай XYZ.
fill
Запоўніце колерамі CIE. Па змаўчанні ўключана.
11.26 codecview
Візуалізуйце інфармацыю, экспартаваную некаторымі кодэкамі.
Некаторыя кодэкі могуць экспартаваць інфармацыю праз кадры з выкарыстаннем пабочных дадзеных або іншымі сродкамі. Напрыклад, некаторыя кодэкі на аснове MPEG экспартуюць вектары руху праз
export_mvs
сцяг у кодэкуflags2
варыянт.
Фільтр прымае наступныя параметры:
block
Адлюстраванне блочнай структуры раздзелаў з дапамогай плоскасці яркасці.
mv
Задайце вектары руху для візуалізацыі.
Даступныя сцягі для
mv
:- '
pf
' наперад прагназаваныя MV P-кадраў
- '
bf
' наперад прагназаваныя MV B-кадраў
- '
bb
' назад прагназаваныя MV B-кадраў
- '
qp
Адлюстраванне параметраў квантавання з дапамогай плоскасцей каляровасці.
mv_type, mvt
Усталюйце тып вектараў руху для візуалізацыі. Уключае MV з усіх кадраў, калі не вызначана
frame_type
параметрам.Даступныя сцягі для
mv_type
:- '
fp
' наперад прагназаваныя МВ
- '
bp
' назад прагназаваныя МВ
- '
frame_type, ft
Усталюйце тып кадра для візуалізацыі вектараў руху.
Даступныя сцягі для
frame_type
:- '
if
' унутрыкадаваныя кадры (I-кадры)
- '
pf
' прагназаваныя кадры (P-кадры)
- '
bf
' кадры з двунакіраваным прагназаваннем (B-кадры)
- '
11.26.1 Examples
- Візуалізуйце прагназаваныя MV усіх кадраў з дапамогай
ffplay
:ffplay -flags2 +export_mvs input.mp4 -vf codecview=mv_type=fp
- Візуалізуйце шматнакіраваныя MV P і B-кадраў з дапамогай
ffplay
:ffplay -flags2 +export_mvs input.mp4 -vf codecview=mv=pf+bf+bb
11.27 colorbalance
Змяніць інтэнсіўнасць асноўных колераў (чырвонага, зялёнага і сіняга) уваходных кадраў.
Фільтр дазваляе наладжваць уваходны кадр у ценявых, паўтонавых або светлых абласцях для балансу чырвона-блакітнага, зялёна-пурпурнога або сіне-жоўтага.
Станоўчае значэнне рэгулявання ссоўвае баланс у бок асноўнага колеру, адмоўнае значэнне - у бок дадатковага колеру.
Фільтр прымае наступныя параметры:
rs
gs
bs
Адрэгулюйце чырвоныя, зялёныя і сінія цені (самыя цёмныя пікселі).
rm
gm
bm
Адрэгулюйце чырвоны, зялёны і сіні паўтоны (сярэднія пікселі).
rh
gh
bh
Адрэгулюйце чырвоныя, зялёныя і сінія блікі (самыя яркія пікселі).
Дазволеныя дыяпазоны для параметраў:
[-1.0, 1.0]
. Па змаўчанні0
.pl
Захоўвайце лёгкасць пры змене каляровага балансу. Па змаўчанні адключана.
11.27.1 Examples
- Дадайце ценям чырвоны колер:
colorbalance=rs=.3
11.27.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.28 colorcontrast
Адрэгулюйце каляровы кантраст паміж кампанентамі RGB.
Фільтр прымае наступныя параметры:
rc
Усталюйце чырвона-блакітны кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.
gm
Усталюйце зялёна-пурпурны кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.
by
Усталюйце сіне-жоўты кантраст. Па змаўчанні 0,0. Дазволены дыяпазон ад -1,0 да 1,0.
rcw
gmw
byw
Усталюйце вагу кожнага значэння опцыі
rc
,gm
, .by
Значэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0. Калі ўсе вагі роўныя 0,0, фільтраванне адключана.pl
Усталюйце колькасць захавання лёгкасці. Значэнне па змаўчанні 0,0. Дазволены дыяпазон ад 0,0 да 1,0.
11.28.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.29 colorcorrect
Адрэгулюйце каляровы баланс белага выбарачна для чорнага і белага. Гэты фільтр працуе ў каляровай прасторы YUV.
Фільтр прымае наступныя параметры:
rl
Усталюйце чырвоную ценявую пляму. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.
bl
Усталюйце сінюю ценявую пляму. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.
rh
Усталюйце чырвонае вылучэнне. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.
bh
Усталюйце чырвонае вылучэнне. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.
saturation
Усталюйце велічыню насычэння. Дазволены дыяпазон ад -3,0 да 3,0. Значэнне па змаўчанні - 1.
analyze
Калі ўсталявана што-небудзь іншае,
manual
яно будзе аналізаваць кожны кадр і выкарыстоўваць вытворныя параметры для фільтрацыі выходнага кадра.Магчымыя значэнні:
- '
manual
' - '
average
' - '
minmax
' - '
median
'
Значэнне па змаўчанні -
manual
.- '
11.29.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.30 colorchannelmixer
Адрэгулюйце ўваходныя кадры відэа шляхам паўторнага змешвання каляровых каналаў.
Гэты фільтр змяняе каляровы канал, дадаючы значэнні, звязаныя з іншымі каналамі тых жа пікселяў. Напрыклад, калі значэнне, якое трэба змяніць, чырвонае, выхадное значэнне будзе:
red
=red
*rr
+ blue
*rb
+ green
*rg
+ alpha
*ra
Фільтр прымае наступныя параметры:
rr
rg
rb
ra
Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога чырвонага канала. Па змаўчанні
1
дляrr
, і0
дляrg
,rb
іra
.gr
gg
gb
ga
Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выходнага зялёнага канала. Па змаўчанні
1
дляgg
, і0
дляgr
,gb
іga
.br
bg
bb
ba
Адрэгулюйце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога сіняга канала. Па змаўчанні
1
дляbb
, і0
дляbr
,bg
іba
.ar
ag
ab
aa
Наладзьце ўклад уваходнага чырвонага, зялёнага, сіняга і альфа-каналаў для выхаднога альфа-канала. Па змаўчанні
1
дляaa
, і0
дляar
,ag
іab
.Дазволеныя дыяпазоны для параметраў:
[-2.0, 2.0]
.pc
Усталяваць рэжым захавання колеру. Дапушчальныя значэнні:
- '
none
' Адключыць захаванне колеру, гэта па змаўчанні.
- '
lum
' Захаваць яркасць.
- '
max
' Захаваць максімальнае значэнне трыплета RGB.
- '
avg
' Захаваць сярэдняе значэнне трыплета RGB.
- '
sum
' Захаваць сумарнае значэнне трыплета RGB.
- '
nrm
' Захаваць нармалізаванае значэнне трыплета RGB.
- '
pwr
' Захаваць значэнне магутнасці трыплета RGB.
- '
pa
Усталюйце колькасць захавання колеру пры змене колеру. Дазволены дыяпазон ад
[0.0, 1.0]
. Па змаўчанні0.0
, таму адключана.
11.30.1 Examples
- Пераўтварыць крыніцу ў адценні шэрага:
colorchannelmixer=.3:.4:.3:0:.3:.4:.3:0:.3:.4:.3
- Імітацыя тонаў сэпіі:
colorchannelmixer=.393:.769:.189:0:.349:.686:.168:0:.272:.534:.131
11.30.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.31 colorize
Накласці суцэльны колер на відэаструмень.
Фільтр прымае наступныя параметры:
hue
Усталюйце адценне колеру. Дазволены дыяпазон ад 0 да 360. Значэнне па змаўчанні - 0.
saturation
Усталюйце насычанасць колеру. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,5.
lightness
Усталюйце светлату колеру. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,5.
mix
Усталюйце спалучэнне крыніцы лёгкасці. Па змаўчанні ўстаноўлена 1.0. Дазволены дыяпазон ад 0,0 да 1,0.
11.31.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.32 colorkey
Каляровая маніпуляцыя каляровай прасторы RGB. Гэты фільтр працуе з кадрамі 8-бітнага фармату RGB, усталёўваючы альфа-кампанент кожнага пікселя, які трапляе ў радыус падабенства ключавога колеру, на 0. Значэнне альфа для пікселяў па-за радыусам падабенства залежыць ад значэння опцыі змешвання.
Фільтр прымае наступныя параметры:
color
Усталюйце колер, для якога альфа будзе ўсталяваны ў 0 (поўная празрыстасць). Глядзіце (ffmpeg-utils) раздзел «Колер» у кіраўніцтве ffmpeg-utils . Па змаўчанні
black
.similarity
Усталюйце радыус ад ключавога колеру, у межах якога іншыя колеры таксама маюць поўную празрыстасць. Вылічаная адлегласць звязана з доляй адзінкі адлегласці ў 3D-прасторы паміж значэннямі RGB ключавога колеру і колерам пікселя. Дыяпазон ад 0,01 да 1,0. 0,01 адпавядае ў вельмі малым радыусе вакол дакладнага колеру ключа, а 1,0 адпавядае ўсім. Па змаўчанні
0.01
.blend
Устанавіце, як вылічваецца альфа-значэнне для пікселяў, якія знаходзяцца за межамі радыусу падабенства. 0.0 робіць пікселі альбо цалкам празрыстымі, альбо цалкам непразрыстымі. Больш высокія значэнні атрымліваюць напаўпразрыстыя пікселі, пры большай празрыстасці колер пікселя больш падобны да ключавога колеру. Дыяпазон ад 0,0 да 1,0. Па змаўчанні
0.0
.
11.32.1 Examples
- Зрабіце кожны зялёны піксель на ўваходным малюнку празрыстым:
ffmpeg -i input.png -vf colorkey=green out.png
- Накласці зялёнае відэа на статычны фонавы малюнак.
ffmpeg -i background.png -i video.mp4 -filter_complex "[1:v]colorkey=0x3BBD1E:0.3:0.2[ckout];[0:v][ckout]overlay[out]" -map "[out]" output.flv
11.32.2 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.33 colorhold
Выдаліць усю інфармацыю аб колерах для ўсіх колераў RGB, акрамя пэўнага.
Фільтр прымае наступныя параметры:
color
Колер, які нельга замяніць на нейтральны шэры.
similarity
Працэнт падабенства з вышэйзгаданым колерам. 0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.
blend
Працэнт сумесі. 0.0 робіць пікселі цалкам шэрымі. Больш высокія значэнні забяспечваюць больш захаваны колер.
11.33.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.34 colorlevels
Адрэгулюйце ўваходныя відэакадры з дапамогай узроўняў.
Фільтр прымае наступныя параметры:
rimin
gimin
bimin
aimin
Адрэгулюйце чырвоную, зялёную, сінюю і альфа-чорную кропку ўводу. Дазволеныя дыяпазоны для параметраў:
[-1.0, 1.0]
. Па змаўчанні0
.rimax
gimax
bimax
aimax
Адрэгулюйце чырвоную, зялёную, сінюю і альфа-кропку ўваходнага белага. Дазволеныя дыяпазоны для параметраў:
[-1.0, 1.0]
. Па змаўчанні1
.Ўзроўні ўваходу выкарыстоўваюцца для асвятлення блікаў (яркія тоны), пацямнення ценяў (цёмныя тоны), змены балансу яркіх і цёмных тонаў.
romin
gomin
bomin
aomin
Адрэгулюйце чырвоную, зялёную, сінюю і альфа-кропку чорнага выхаду. Дазволеныя дыяпазоны для параметраў:
[0, 1.0]
. Па змаўчанні0
.romax
gomax
bomax
aomax
Наладзьце чырвоную, зялёную, сінюю і альфа-кропку белага. Дазволеныя дыяпазоны для параметраў:
[0, 1.0]
. Па змаўчанні1
.Выхадныя ўзроўні дазваляюць уручную выбраць абмежаваны дыяпазон выхаднога ўзроўню.
preserve
Усталяваць рэжым захавання колеру. Дапушчальныя значэнні:
- '
none
' Адключыць захаванне колеру, гэта па змаўчанні.
- '
lum
' Захаваць яркасць.
- '
max
' Захаваць максімальнае значэнне трыплета RGB.
- '
avg
' Захаваць сярэдняе значэнне трыплета RGB.
- '
sum
' Захаваць сумарнае значэнне трыплета RGB.
- '
nrm
' Захаваць нармалізаванае значэнне трыплета RGB.
- '
pwr
' Захаваць значэнне магутнасці трыплета RGB.
- '
11.34.1 Examples
- Зрабіць выхад відэа цямней:
colorlevels=rimin=0.058:gimin=0.058:bimin=0.058
- Павялічыць кантраснасць:
colorlevels=rimin=0.039:gimin=0.039:bimin=0.039:rimax=0.96:gimax=0.96:bimax=0.96
- Зрабіць выхад відэа больш светлым:
colorlevels=rimax=0.902:gimax=0.902:bimax=0.902
- Павялічыць яркасць:
colorlevels=romin=0.5:gomin=0.5:bomin=0.5
11.34.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.35 colormap
Прымяніць карыстальніцкія каляровыя карты да відэаструменю.
Гэтаму фільтру патрэбны тры ўваходныя відэапатокі. Першы паток - гэта відэапаток, які будзе адфільтраваны. Другі і трэці відэапаток вызначаюць каляровыя плямы для зыходнага колеру і мэтавага адлюстравання колераў.
Фільтр прымае наступныя параметры:
patch_size
Усталюйце памер патча крыніцы і мэтавага відэапатоку ў пікселях.
nb_patches
Усталюйце максімальную колькасць выкарыстоўваных патчаў з зыходнага і мэтавага відэаструменю. Значэнне па змаўчанні - колькасць патчаў, даступных у дадатковых відэапатоках. Максімальна дазволеная колькасць патчаў складае
64
.type
Усталюйце налады, якія выкарыстоўваюцца для мэтавых колераў. Можа быць
relative
абоabsolute
. Па змаўчанні гэтаabsolute
.kernel
Усталюйце ядро, якое выкарыстоўваецца для вымярэння каляровых адрозненняў паміж адлюстраванымі колерамі.
Дапушчальныя значэнні:
- '
euclidean
' - '
weuclidean
'
Па змаўчанні
euclidean
.- '
11.36 colormatrix
Пераўтварэнне каляровай матрыцы.
Фільтр прымае наступныя параметры:
src
dst
Укажыце зыходную і мэтавую каляровую матрыцу. Абодва значэння павінны быць указаны.
Дапушчальныя значэнні:
- '
bt709
' BT.709
- '
fcc
' FCC
- '
bt601
' BT.601
- '
bt470
' BT.470
- '
bt470bg
' BT.470BG
- '
smpte170m
' СМПТЭ-170М
- '
smpte240m
' СМПТЭ-240М
- '
bt2020
' БТ.2020
- '
Напрыклад, каб пераўтварыць з BT.601 у SMPTE-240M, выкарыстоўвайце каманду:
colormatrix=bt601:smpte240m
11.37 colorspace
Пераўтварэнне каляровай прасторы, характарыстык перадачы або асноўных колераў. Уваходнае відэа павінна мець роўны памер.
Фільтр прымае наступныя параметры:
all
Укажыце адразу ўсе ўласцівасці колеру.
Дапушчальныя значэнні:
- '
bt470m
' BT.470M
- '
bt470bg
' BT.470BG
- '
bt601-6-525
' БТ.601-6 525
- '
bt601-6-625
' БТ.601-6 625
- '
bt709
' BT.709
- '
smpte170m
' СМПТЭ-170М
- '
smpte240m
' СМПТЭ-240М
- '
bt2020
' БТ.2020
- '
space
Укажыце каляровую прастору выхаду.
Дапушчальныя значэнні:
- '
bt709
' BT.709
- '
fcc
' FCC
- '
bt470bg
' BT.470BG або BT.601-6 625
- '
smpte170m
' SMPTE-170M або BT.601-6 525
- '
smpte240m
' СМПТЭ-240М
- '
ycgco
' YCgCo
- '
bt2020ncl
' BT.2020 з непастаяннай яркасцю
- '
trc
Укажыце характарыстыкі перадачы выхаду.
Дапушчальныя значэнні:
- '
bt709
' BT.709
- '
bt470m
' BT.470M
- '
bt470bg
' BT.470BG
- '
gamma22
' Пастаянная гама 2,2
- '
gamma28
' Сталая гама 2,8
- '
smpte170m
' SMPTE-170M, BT.601-6 625 або BT.601-6 525
- '
smpte240m
' СМПТЭ-240М
- '
srgb
' СРГБ
- '
iec61966-2-1
' iec61966-2-1
- '
iec61966-2-4
' iec61966-2-4
- '
xvycc
' xvycc
- '
bt2020-10
' BT.2020 для 10-бітнага кантэнту
- '
bt2020-12
' BT.2020 для 12-бітнага кантэнту
- '
primaries
Укажыце асноўныя колеры вываду.
Дапушчальныя значэнні:
- '
bt709
' BT.709
- '
bt470m
' BT.470M
- '
bt470bg
' BT.470BG або BT.601-6 625
- '
smpte170m
' SMPTE-170M або BT.601-6 525
- '
smpte240m
' СМПТЭ-240М
- '
film
' фільм
- '
smpte431
' SMPTE-431
- '
smpte432
' СМПТЭ-432
- '
bt2020
' БТ.2020
- '
jedec-p22
' Люмінафор JEDEC P22
- '
range
Укажыце дыяпазон колераў вываду.
Дапушчальныя значэнні:
- '
tv
' ТБ (абмежаваны) дыяпазон
- '
mpeg
' MPEG (абмежаваны) дыяпазон
- '
pc
' ПК (поўны) дыяпазон
- '
jpeg
' JPEG (поўны) дыяпазон
- '
format
Укажыце фармат выхаднога колеру.
Дапушчальныя значэнні:
- '
yuv420p
' YUV 4:2:0 плоскі 8-біт
- '
yuv420p10
' YUV 4:2:0 плоскі 10 біт
- '
yuv420p12
' YUV 4:2:0 плоскі 12-біт
- '
yuv422p
' YUV 4:2:2 плоскі 8-біт
- '
yuv422p10
' YUV 4:2:2 плоскі 10-біт
- '
yuv422p12
' YUV 4:2:2 плоскі 12-біт
- '
yuv444p
' YUV 4:4:4 плоскі 8-біт
- '
yuv444p10
' YUV 4:4:4 плоскі 10-біт
- '
yuv444p12
' YUV 4:4:4 плоскі 12-біт
- '
fast
Выканайце хуткае пераўтварэнне, якое прапускае гама/асноўную карэкцыю. Гэта зойме значна менш працэсара, але будзе матэматычна няправільным. Каб атрымаць вывад, сумяшчальны з вынікам фільтра colormatrix, выкарыстоўвайце fast=1.
dither
Укажыце рэжым дызерінга.
Дапушчальныя значэнні:
- '
none
' Ніякага вагання
- '
fsb
' Дызерінг Флойда-Стэйнберга
- '
wpadapt
Рэжым адаптацыі Whitepoint.
Дапушчальныя значэнні:
- '
bradford
' Брэдфардская адаптацыя белай кропкі
- '
vonkries
' адаптацыя фон Крыса
- '
identity
' адаптацыя белай кропкі ідэнтычнасці (г.зн. без адаптацыі белай кропкі)
- '
iall
Перавызначыць усе ўласцівасці ўводу адначасова. Тыя ж прынятыя значэнні, што і ўсе .
ispace
Перавызначыць каляровую прастору ўводу. Такія ж прынятыя значэнні, што і прабел .
iprimaries
Перавызначэнне асноўных колераў уводу. Тыя ж прынятыя значэнні, што і праймерыз .
itrc
Перавызначэнне ўваходных характарыстык перадачы. Такія ж прынятыя значэнні, што і trc .
irange
Перавызначыць дыяпазон колераў уводу. Такія ж прынятыя значэнні, што і дыяпазон .
Фільтр пераўтворыць характарыстыкі перадачы, каляровую прастору і асноўныя колеры ў зададзеныя карыстальніцкімі значэннямі. Выходнае значэнне, калі яно не вызначана, усталёўваецца ў значэнне па змаўчанні на аснове ўласцівасці "ўсе". Калі гэта ўласцівасць таксама не вызначана, фільтр запісвае памылку. Дыяпазон і фармат выхадных колераў па змаўчанні маюць тое ж значэнне, што і дыяпазон і фармат уваходных колераў. Уваходныя характарыстыкі перадачы, каляровая прастора, асноўныя колеры і дыяпазон колераў павінны быць устаноўлены на ўваходных дадзеных. Калі што-небудзь з гэтага адсутнічае, фільтр запісвае памылку і пераўтварэнне не адбудзецца.
Напрыклад, каб пераўтварыць уваход у SMPTE-240M, выкарыстоўвайце каманду:
colorspace=smpte240m
11.38 colortemperature
Адрэгулюйце каляровую тэмпературу ў відэа, каб імітаваць змены каляровай тэмпературы навакольнага асяроддзя.
Фільтр прымае наступныя параметры:
temperature
Усталюйце тэмпературу ў Кельвінах. Дазволены дыяпазон ад 1000 да 40000. Значэнне па змаўчанні - 6500 К.
mix
Усталюйце змешванне з адфільтраваным выхадам. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
pl
Усталюйце колькасць захавання лёгкасці. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.
11.38.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.39 convolution
Ужывайце згортванне 3x3, 5x5, 7x7 або гарызантальнае/вертыкальнае да 49 элементаў.
Фільтр прымае наступныя параметры:
0m
1m
2m
3m
Усталюйце матрыцу для кожнай плоскасці. Матрыца - гэта паслядоўнасць з 9, 25 або 49 цэлых лікаў са знакам у
square
рэжыме і ад 1 да 49 няцотных лікаў са знакам уrow
рэжыме.0rdiv
1rdiv
2rdiv
3rdiv
Усталюйце множнік для разліковага значэння для кожнай плоскасці. Калі не ўстаноўлена або 0, гэта будзе сума ўсіх элементаў матрыцы.
0bias
1bias
2bias
3bias
Усталюйце ўхіл для кожнай плоскасці. Гэта значэнне дадаецца да выніку множання. Карысна, каб зрабіць агульны малюнак ярчэй або цямней. Па змаўчанні 0,0.
0mode
1mode
2mode
3mode
Усталюйце рэжым матрыцы для кожнай плоскасці. Можа быць
square
,row
абоcolumn
. Па змаўчанніsquare
.
11.39.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.39.2 Examples
- Ужыць рэзкасць:
convolution="0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0"
- Прымяніць размыццё:
convolution="1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1/9:1/9:1/9:1/9"
- Прымяніць паляпшэнне краёў:
convolution="0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:5:1:1:1:0:128:128:128"
- Прымяніць вызначэнне краю:
convolution="0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:5:5:5:1:0:128:128:128"
- Ужывайце дэтэктар краёў Лапласа, які ўключае дыяганалі:
convolution="1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:5:5:5:1:0:128:128:0"
- Нанесці рэльеф:
convolution="-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2"
11.40 convolve
Прымяніць двухмерную згортку відэаструменю ў частотнай вобласці з выкарыстаннем другога патоку ў якасці імпульсу.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці апрацоўваць.
impulse
Усталяваць, якія імпульсныя відэакадры будуць апрацоўвацца, можна
first
абоall
. Па змаўчанніall
.
Фільтр convolve
таксама падтрымлівае параметры framesync .
11.41 copy
Скапіруйце крыніцу ўваходнага відэа без змен на выхад. Гэта ў асноўным карысна для тэставання.
11.42 coreimage
Фільтраванне відэа на графічным працэсары з выкарыстаннем Apple CoreImage API на OSX.
Апаратнае паскарэнне заснавана на кантэксце OpenGL. Звычайна гэта азначае, што яно апрацоўваецца відэаабсталяваннем. Тым не менш, існуюць праграмныя рэалізацыі OpenGL, што азначае, што няма гарантыі для апаратнай апрацоўкі. Гэта залежыць ад адпаведнай OSX.
Ёсць шмат фільтраў і генератараў малюнкаў ад Apple, якія пастаўляюцца з вялікім выбарам опцый. Спасылка на фільтр павінна быць названа разам з параметрамі.
Фільтр coreimage прымае наступныя параметры:
list_filters
Пералічыце ўсе даступныя фільтры і генератары разам з усімі іх адпаведнымі параметрамі, а таксама магчымыя мінімальныя і максімальныя значэнні разам са значэннямі па змаўчанні.
list_filters=true
filter
Укажыце ўсе фільтры па іх адпаведных назвах і параметрах. Выкарыстоўвайце
list_filters
для вызначэння ўсіх сапраўдных назваў фільтраў і параметраў. Лікавыя параметры задаюцца значэннем з плаваючай часткай і аўтаматычна прывязваюцца да адпаведнага дыяпазону значэнняў. Варыянты вектара і колеру павінны быць вызначаны спісам значэнняў з плаваючай часткай, падзеленых прабеламі. Уцёкі персанажа павінны быць зроблены.default
Для выкарыстання параметраў па змаўчанні для фільтра даступна спецыяльная назва опцыі .Неабходна ўказаць
default
адзін з варыянтаў фільтра або хаця б адзін. Усе прапушчаныя параметры выкарыстоўваюцца са значэннямі па змаўчанні. Сінтаксіс радка фільтра наступны:filter=<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...][#<NAME>@<OPTION>=<VALUE>[@<OPTION>=<VALUE>][@...]][#...]
output_rect
Укажыце прастакутнік, у якім вывад ланцужка фільтра капіюецца ва ўваходны малюнак. Яно задаецца спісам значэнняў float, падзеленых прабеламі:
output_rect=x\ y\ width\ height
Калі не зададзены, то выхадны прамавугольнік роўны памерам уваходнага малюнка. Выхадны прамавугольнік аўтаматычна абразаецца па межах уваходнага малюнка. Адмоўныя значэнні сапраўдныя для кожнага кампанента.
output_rect=25\ 25\ 100\ 100
Некалькі фільтраў можна злучыць для паслядоўнай апрацоўкі без перадачы GPU-HOST, што дазваляе хутка апрацоўваць складаныя ланцужкі фільтраў. У цяперашні час падтрымліваюцца толькі фільтры з нулявым (генератары) або дакладна адным (фільтры) уваходным відарысам і адным выходным відарысам. Акрамя таго, пераходныя фільтры пакуль непрыдатныя для выкарыстання па прызначэнні.
Некаторыя фільтры генеруюць выходныя выявы з дадатковым запаўненнем у залежнасці ад адпаведнага ядра фільтра. Пракладка аўтаматычна выдаляецца, каб гарантаваць, што вынік фільтра мае той жа памер, што і ўваходны малюнак.
Для генератараў малюнкаў памер выходнага відарыса вызначаецца адпаведна папярэднім выходным відарысам ланцужка фільтраў або ўваходным відарысам усяго ланцужка фільтраў. Генератары не выкарыстоўваюць інфармацыю аб пікселях гэтага відарыса для стварэння сваіх выходных дадзеных. Тым не менш, згенераваны вынік змешваецца з гэтым відарысам, што прыводзіць да частковага або поўнага пакрыцця выходнага відарыса.
Крыніца відэа coreimagesrc можа быць выкарыстана для генерацыі ўваходных відарысаў, якія непасрэдна падаюцца ў ланцуг фільтра. Пры яго выкарыстанні не патрабуецца прадастаўленне ўваходных малюнкаў з іншай крыніцы відэа ці ўваходнага відэа.
11.42.1 Examples
- Спіс усіх даступных фільтраў:
coreimage=list_filters=true
- Выкарыстоўвайце фільтр CIBoxBlur з параметрамі па змаўчанні, каб размыць малюнак:
coreimage=filter=CIBoxBlur@default
- Выкарыстоўвайце ланцужок фільтраў са значэннямі па змаўчанні CISepiaTone і CIVignetteEffect з цэнтрам 100x100 і радыусам 50 пікселяў:
coreimage=filter=CIBoxBlur@default#CIVignetteEffect@inputCenter=100\ 100@inputRadius=50
- Выкарыстоўвайце nullsrc і CIQRCodeGenerator, каб стварыць QR-код для галоўнай старонкі FFmpeg, зададзены ў выглядзе поўнага і экранаванага каманднага радка для стандартнай абалонкі bash ад Apple:
ffmpeg -f lavfi -i nullsrc=s=100x100,coreimage=filter=CIQRCodeGenerator@inputMessage=https\\\\\://FFmpeg.org/@inputCorrectionLevel=H -frames:v 1 QRCode.png
11.43 cover_rect
Накрыйце прамавугольны прадмет
Ён прымае наступныя варыянты:
cover
Шлях да файла неабавязковай выявы вокладкі павінен быць у yuv420.
mode
Усталюйце рэжым пакрыцця.
Ён прымае наступныя значэнні:
- '
cover
' накрыйце яго пастаўленым малюнкам
- '
blur
' пакрыць яго шляхам інтэрпаляцыі навакольных пікселяў
Значэнне па змаўчанні -
blur
.- '
11.43.1 Examples
- Накрыйце прамавугольны аб'ект прадастаўленай выявай дадзенага відэа, выкарыстоўваючы
ffmpeg
:ffmpeg -i file.ts -vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
11.44 crop
Абрэзаць уваходнае відэа да зададзеных памераў.
Ён прымае наступныя параметры:
w, out_w
Шырыня выхаднога відэа. Па змаўчанні гэта
iw
. Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі фільтра або калі 'w
'ці'out_w
' каманда адпраўлена.h, out_h
Вышыня выхаднога відэа. Па змаўчанні гэта
ih
. Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі фільтра або калі 'h
'ці'out_h
' каманда адпраўлена.x
Гарызантальнае становішча левага краю выхаднога відэа ва ўваходным відэа. Па змаўчанні гэта
(in_w-out_w)/2
. Гэты выраз вылічваецца пакадрава.y
Вертыкальнае становішча верхняга краю выхаднога відэа ва ўваходным відэа. Па змаўчанні гэта
(in_h-out_h)/2
. Гэты выраз вылічваецца пакадрава.keep_aspect
Калі ўстаноўлена значэнне 1, фармат выходнага дысплея будзе такім жа, як і ўваходны, шляхам змены суадносін бакоў выхаднога ўзору. Па змаўчанні гэта 0.
exact
Уключыць дакладнае кадраванне. Калі ўключана, відэа з субвыбаркай будуць абрэзаны па дакладнай шырыні/вышыні/x/y, як паказана, і не будуць акругляцца да бліжэйшага меншага значэння. Па змаўчанні гэта 0.
Параметры out_w
, out_h
, x
, y
- гэта выразы, якія змяшчаюць наступныя канстанты:
x
y
Вылічаныя значэнні для
x
іy
. Яны ацэньваюцца для кожнага новага кадра.in_w
in_h
Шырыня і вышыня ўводу.
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Выхадныя (абрэзаныя) шырыня і вышыня.
ow
oh
Гэта тое самае, што
out_w
іout_h
.a
тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
суадносіны бакоў уваходнага дысплея, яно такое ж, як (
iw
/ih
) *sar
hsub
vsub
гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.n
Нумар уваходнага кадра, пачынаючы з 0.
pos
пазіцыя ў файле ўваходнага кадра, NAN, калі невядома
t
Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.
Выраз для out_w
можа залежаць ад значэння out_h
, а выраз для out_h
можа залежаць ад out_w
, але яны не могуць залежаць ад x
і y
, паколькі x
і y
вылічваюцца пасля out_w
і out_h
.
Параметры x
і y
задаюць выразы для пазіцыі левага верхняга кута вывадной (неабрэзанай) вобласці. Яны ацэньваюцца для кожнага кадра. Калі ацэненае значэнне несапраўднае, яно набліжаецца да бліжэйшага сапраўднага значэння.
Выраз для x
можа залежаць ад y
, а выраз для y
можа залежаць ад x
.
11.44.1 Examples
- Плошча абрэзкі памерам 100x100 у пазіцыі (12,34).
crop=100:100:12:34
Выкарыстоўваючы названыя параметры, прыклад вышэй становіцца:
crop=w=100:h=100:x=12:y=34
- Абрэжце цэнтральную вобласць уводу памерам 100x100:
crop=100:100
- Абрэжце цэнтральную вобласць уводу памерам 2/3 уваходнага відэа:
crop=2/3*in_w:2/3*in_h
- Абрэжце цэнтральны квадрат ўваходнага відэа:
crop=out_w=in_h crop=in_h
- Аддзяліце прастакутнік левым верхнім вуглом у становішчы 100:100 і правым ніжнім вуглом, які адпавядае праваму ніжняму вуглу ўваходнага відарыса.
crop=in_w-100:in_h-100:100:100
- Абрэжце 10 пікселяў ад левай і правай межаў і 20 пікселяў ад верхняй і ніжняй межаў
crop=in_w-2*10:in_h-2*20
- Захоўвайце толькі ніжнюю правую чвэрць уваходнага малюнка:
crop=in_w/2:in_h/2:in_w/2:in_h/2
- Вышыня абрэзкі для атрымання грэцкай гармоніі:
crop=in_w:1/PHI*in_w
- Прымяніць эфект дрыгацення:
crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(n/10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(n/7)
- Прымяніць эфект няўстойлівай камеры ў залежнасці ад пазнакі часу:
crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(t*10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(t*13)"
- Усталюйце x у залежнасці ад значэння y:
crop=in_w/2:in_h/2:y:10+10*sin(n/10)
11.44.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
w, out_w
h, out_h
x
y
Усталюйце шырыню/вышыню выхаднога відэа і гарызантальнае/вертыкальнае становішча ва ўваходным відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.45 cropdetect
Аўтаматычнае вызначэнне памеру кадравання.
Ён разлічвае неабходныя параметры абрэзкі і друкуе рэкамендаваныя параметры праз сістэму рэгістрацыі. Выяўленыя памеры адпавядаюць нечорнай вобласці ўваходнага відэа.
Ён прымае наступныя параметры:
limit
Усталюйце больш высокі парог значэння чорнага, які можна па жаданні задаць ад нічога (0) да ўсяго (255 для 8-бітных фарматаў). Значэнне інтэнсіўнасці, якое перавышае зададзенае значэнне, лічыцца не чорным. Па змаўчанні значэнне складае 24. Вы таксама можаце задаць значэнне ад 0,0 да 1,0, якое будзе маштабавацца ў залежнасці ад бітавай глыбіні піксельнага фармату.
round
Значэнне, на якое павінна дзяліцца шырыня/вышыня. Па змаўчанні гэта 16. Зрушэнне аўтаматычна рэгулюецца для цэнтравання відэа. Выкарыстоўвайце 2, каб атрымаць толькі цотныя памеры (неабходна для відэа 4:2:2). 16 лепш за ўсё падыходзіць для кадавання ў большасці відэакодэкаў.
skip
Усталюйце колькасць пачатковых кадраў, для якіх ацэнка прапускаецца. Па змаўчанні 2. Дыяпазон ад 0 да INT_MAX.
reset_count, reset
Усталюйце лічыльнік, які вызначае, праз колькі кадраў cropdetect скіне раней выяўленую вялікую вобласць відэа і пачне спачатку, каб вызначыць бягучую аптымальную вобласць абрэзкі. Значэнне па змаўчанні 0.
Гэта можа быць карысна, калі лагатыпы каналаў скажаюць вобласць відэа. 0 азначае "ніколі не скідаць" і вяртае найбольшую плошчу, сустрэтую падчас прайгравання.
11.46 cue
Затрымка фільтрацыі відэа да дадзенай меткі часу насценнага гадзінніка. Фільтр спачатку праходзіць далейpreroll
колькасць кадраў, то буферызуецца максімум
buffer
колькасць кадраў і чакае рэплікі. Пасля дасягнення рэплікі ён перасылае буферызаваныя кадры, а таксама любыя наступныя кадры, якія паступаюць на яго ўваход.
Фільтр можна выкарыстоўваць для сінхранізацыі вываду некалькіх працэсаў ffmpeg для прылад вываду ў рэальным часе, такіх як decklink. Дзякуючы затрымцы ў ланцужку фільтрацыі і папярэдняй буферызацыі кадраў працэс можа перадаваць даныя на выхад амаль адразу пасля дасягнення мэтавай меткі часу насценнага гадзінніка.
Ідэальную дакладнасць кадра нельга гарантаваць, але вынік дастаткова добры для некаторых выпадкаў выкарыстання.
cue
Пазнака часу, выражаная ў пазнацы часу UNIX у мікрасекундах. Па змаўчанні 0.
preroll
Працягласць змесціва для перадачы ў якасці прэролу, выражаная ў секундах. Па змаўчанні 0.
buffer
Максімальная працягласць змесціва для буферызацыі перад чаканнем сігналу, выражаная ў секундах. Па змаўчанні 0.
11.47 curves
Прымяніць карэкціроўкі колеру з дапамогай крывых.
Гэты фільтр падобны на інструменты крывых Adobe Photoshop і GIMP. Кожны кампанент (чырвоны, зялёны і сіні) мае свае значэнні, вызначаныя N
ключавымі кропкамі, звязанымі адна з адной з дапамогай плаўнай крывой. Па восі х адкладзены значэнні пікселяў з уваходнага кадра, а па восі ординат — новыя значэнні пікселяў, якія будуць устаноўлены для выхаднога кадра.
Па змаўчанні крывая кампанента вызначаецца дзвюма кропкамі (0;0)
і
(1;1)
. Гэта стварае прамую лінію, на якой кожнае першапачатковае значэнне пікселя "прыстасоўваецца" да ўласнага значэння, што азначае адсутнасць змяненняў у малюнку.
Фільтр дазваляе перавызначыць гэтыя два моманты і дадаць яшчэ. Будзе вызначана новая крывая (з выкарыстаннем натуральнай кубічнай сплайн-інтэрпаляцыі), якая плаўна праходзіць праз усе гэтыя новыя каардынаты. Новыя вызначаныя кропкі павінны быць строга ўзрастаючымі па восі х, а іх x
значэнні y
павінны знаходзіцца ў [0;1]
інтэрвале. Калі вылічаныя крывыя апынуліся за межамі вектарных прастораў, значэнні будуць абрэзаны адпаведна.
Фільтр прымае наступныя параметры:
preset
Выберыце адзін з даступных налад колеру. Гэтую опцыю можна выкарыстоўваць у дадатак да
r
,g
,b
параметры; у гэтым выпадку больш познія параметры маюць прыярытэт перад зададзенымі значэннямі. Даступныя перадусталёўкі:- '
none
' - '
color_negative
' - '
cross_process
' - '
darker
' - '
increase_contrast
' - '
lighter
' - '
linear_contrast
' - '
medium_contrast
' - '
negative
' - '
strong_contrast
' - '
vintage
'
Па змаўчанні
none
.- '
master, m
Усталюйце асноўныя ключавыя кропкі. Гэтыя кропкі будуць вызначаць адлюстраванне другога праходу. Часам яго называюць адлюстраваннем "яркасці" або "значэння". Яго можна выкарыстоўваць з
r
,g
,b
абоall
так як ён дзейнічае як LUT пасля апрацоўкі.red, r
Усталюйце ключавыя кропкі для чырвонага кампанента.
green, g
Усталюйце ключавыя моманты для зялёнага кампанента.
blue, b
Усталюйце ключавыя кропкі для сіняга кампанента.
all
Усталюйце ключавыя кропкі для ўсіх кампанентаў (за выключэннем галоўнага). Можа выкарыстоўвацца ў дадатак да іншых варыянтаў кампанентаў ключавых кропак. У гэтым выпадку неўсталяваны кампанент(ы) будзе выкарыстоўваць гэта
all
ўстаноўка.psfile
Укажыце файл крывых Photoshop (
.acv
), з якога трэба імпартаваць налады.plot
Захаваць скрыпт Gnuplot крывых у паказаны файл.
Каб пазбегнуць канфліктаў сінтаксісу графіка фільтраў, кожны спіс ключавых пунктаў павінен быць вызначаны з дапамогай наступнага сінтаксісу: x0/y0 x1/y1 x2/y2 ...
.
11.47.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.47.2 Examples
- Злёгку павялічце сярэдні ўзровень сіняга:
curves=blue='0/0 0.5/0.58 1/1'
- Вінтажны эфект:
curves=r='0/0.11 .42/.51 1/0.95':g='0/0 0.50/0.48 1/1':b='0/0.22 .49/.44 1/0.8'
Тут мы атрымліваем наступныя каардынаты для кожнага кампанента:
red
(0;0.11) (0.42;0.51) (1;0.95)
green
(0;0) (0.50;0.48) (1;1)
blue
(0;0.22) (0.49;0.44) (1;0.80)
- Папярэдні прыклад таксама можа быць дасягнуты з дапамогай адпаведнай убудаванай перадусталёўкі:
curves=preset=vintage
- Ці проста:
curves=vintage
- Выкарыстоўвайце перадустаноўку Photoshop і перавызначце кропкі зялёнага кампанента:
curves=psfile='MyCurvesPresets/purple.acv':green='0/0 0.45/0.53 1/1'
- Праверце крывыя
cross_process
профілю з дапамогайffmpeg
іgnuplot
:ffmpeg -f lavfi -i color -vf curves=cross_process:plot=/tmp/curves.plt -frames:v 1 -f null - gnuplot -p /tmp/curves.plt
11.48 datascope
Фільтр аналізу відэа дадзеных.
Гэты фільтр паказвае шаснаццатковае значэнне пікселяў часткі відэа.
Фільтр прымае наступныя параметры:
size, s
Задаць памер выхаднога відэа.
x
Усталюйце зрушэнне па х ад месца выбару пікселяў.
y
Усталюйце зрушэнне y ад месца выбару пікселяў.
mode
Усталяваць рэжым прыцэла можа быць адзін з наступнага:
- '
mono
' Намалюйце шаснаццатковыя значэнні пікселяў белым колерам на чорным фоне.
- '
color
' Намалюйце шаснаццатковыя значэнні пікселяў колерам пікселяў уваходнага відэа на чорным фоне.
- '
color2
' Намалюйце шаснаццатковыя значэнні пікселяў на каляровым фоне, абраным з уваходнага відэа, колер тэксту выбіраецца такім чынам, што ён заўсёды бачны.
- '
axis
Намалюйце нумары ў радках і слупках злева і ўверсе відэа.
opacity
Задаць непразрыстасць фону.
format
Устанавіць фармат нумара для адлюстравання. Можа быць
hex
, абоdec
. Па змаўчанніhex
.components
Задаць піксельныя кампаненты для адлюстравання. Па змаўчанні адлюстроўваюцца ўсе піксельныя кампаненты.
11.48.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі без size
опцыі.
11.49 dblur
Ужыць фільтр накіраванага размыцця.
Фільтр прымае наступныя параметры:
angle
Задаць вугал накіраванага размыцця. Па змаўчанні
45
.radius
Задаць радыус накіраванага размыцця. Па змаўчанні
5
.planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.
11.49.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.50 dctdnoiz
Знішчэнне шуму кадраў з дапамогай 2D DCT (фільтрацыя ў частотнай вобласці).
Гэты фільтр не прызначаны для рэальнага часу.
Фільтр прымае наступныя параметры:
sigma, s
Усталюйце сігма-канстанту шуму.
Гэта
sigma
вызначае жорсткі парог3 * sigma
; кожны каэфіцыент DCT (абсалютная велічыня) ніжэй за гэты парог будзе адменены.Калі вам патрэбна больш пашыраная фільтрацыя, гл
expr
.Па змаўчанні
0
.overlap
Усталюйце колькасць пікселяў, якія перакрываюцца, для кожнага блока. Паколькі фільтр можа працаваць павольна, вы можаце паменшыць гэта значэнне за кошт менш эфектыўнага фільтра і рызыкі розных артэфактаў.
Калі значэнне, якое перакрываецца, не дазваляе апрацаваць усю шырыню або вышыню ўводу, будзе адлюстравана папярэджанне, і адпаведныя межы не будуць прыглушаны.
Значэнне па змаўчанні
blocksize
-1, што з'яўляецца найлепшым магчымым параметрам.expr, e
Усталюйце каэфіцыент выразу множніка.
Для кожнага каэфіцыента блока DCT гэты выраз будзе ацэнены як значэнне множніка для каэфіцыента.
Калі гэты параметр усталяваны, то
sigma
варыянт будзе праігнараваны.Абсалютнае значэнне каэфіцыента можна атрымаць праз
c
зменную.n
Усталюйце
blocksize
выкарыстоўваючы колькасць бітаў. вызначае , які з'яўляецца шырынёй і вышынёй апрацаваных блокаў.1<<
n
blocksize
Значэнне па змаўчанні
3
(8x8) і можа быць павялічана да4
16x16blocksize
. Майце на ўвазе, што змяненне гэтага параметра моцна ўплывае на хуткасць апрацоўкі. Акрамя таго, большы памер блока не абавязкова азначае лепшае паніжэнне шуму.
11.50.1 Examples
Прымяніць шум з дапамогай asigma
з 4.5
:
dctdnoiz=4.5
Тая ж аперацыя можа быць выканана з дапамогай сістэмы выразаў:
dctdnoiz=e='gte(c, 4.5*3)'
Гвалтоўнае выдаленне шуму з выкарыстаннем блока памерам 16x16
:
dctdnoiz=15:n=4
11.51 deband
Выдаліць артэфакты палос з уваходнага відэа. Ён працуе шляхам замены палосных пікселяў сярэднім значэннем спасылачных пікселяў.
Фільтр прымае наступныя параметры:
1thr
2thr
3thr
4thr
Усталюйце парог выяўлення палос для кожнай плоскасці. Па змаўчанні 0,02. Дапушчальны дыяпазон ад 0,00003 да 0,5. Калі розніца паміж бягучым пікселем і эталонным пікселем меншая за парогавае значэнне, яна будзе разглядацца як палосная.
range, r
Дыяпазон выяўлення палос у пікселях. Значэнне па змаўчанні - 16. Калі станоўчае, для задання значэння будзе выкарыстоўвацца выпадковы лік у дыяпазоне 0. Калі адмоўнае, будзе выкарыстоўвацца дакладнае абсалютнае значэнне. Дыяпазон вызначае квадрат з чатырох пікселяў вакол бягучага пікселя.
direction, d
Усталюйце кірунак у радыянах, з якога будуць параўноўвацца чатыры пікселі. Калі станоўчы, будзе абраны выпадковы кірунак ад 0 да зададзенага кірунку. Калі адмоўны, будзе выбрана дакладнае абсалютнае значэнне. Напрыклад, кірунак 0, -PI або -2*PI у радыянах будзе выбіраць толькі пікселі ў адным радку, а -PI/2 - толькі пікселі ў тым жа слупку.
blur, b
Калі ўключана, бягучы піксель параўноўваецца з сярэднім значэннем усіх чатырох навакольных пікселяў. Па змаўчанні ўключана. Калі адключана, бягучы піксель параўноўваецца з усімі чатырма навакольнымі пікселямі. Піксель лічыцца палосным, калі толькі ўсе чатыры адрозненні з навакольнымі пікселямі менш парогавага значэння.
coupling, c
Калі ўключана, бягучы піксель змяняецца тады і толькі тады, калі ўсе кампаненты пікселя маюць паласы, напрыклад, парог выяўлення палос спрацоўвае для ўсіх кампанентаў колеру. Па змаўчанні адключана.
11.51.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.52 deblock
Выдаліць блакіруючыя артэфакты з уваходнага відэа.
Фільтр прымае наступныя параметры:
filter
Усталюйце тып фільтра, можа быць
weak
абоstrong
. Па змаўчанніstrong
. Гэта кантралюе, які тып дэблакіроўкі прымяняецца.block
Усталюйце памер блока, дазволены дыяпазон ад 4 да 512. Па змаўчанні -
8
.alpha
beta
gamma
delta
Усталюйце парогі выяўлення блакіроўкі. Дазволены дыяпазон ад 0 да 1. Значэнні па змаўчанні:
0.098
дляalpha
і0.05
для астатніх. Выкарыстанне больш высокага парога дае большую сілу дэблакіроўкі. Наладаalpha
кіруе выяўленнем парога на дакладным краі блока. Астатнія параметры кантралююць выяўленне парога каля краю. Кожны з іх унізе/уверсе або злева/справа. Вызначэнне любога з іх на0
адключае дэблакіроўку.planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні фільтруюць усе даступныя самалёты.
11.52.1 Examples
- Дэблакіроўка з дапамогай слабога фільтра і памеру блока 4 пікселя.
deblock=filter=weak:block=4
- Дэблакіраванне з дапамогай моцнага фільтра, памеру блока 4 пікселя і карыстальніцкіх парогаў для дэблакіравання большай колькасці краёў.
deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05
- Падобна вышэйзгаданаму, але адфільтраваць толькі першую плоскасць.
deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=1
- Падобна вышэйзгаданаму, але адфільтраваць толькі другі і трэці план.
deblock=filter=strong:block=4:alpha=0.12:beta=0.07:gamma=0.06:delta=0.05:planes=6
11.52.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.53 decimate
Адкідвайце дубляваныя кадры праз рэгулярныя прамежкі часу.
Фільтр прымае наступныя параметры:
cycle
Усталюйце колькасць кадраў, з якіх адзін будзе выдалены. Усталяванне гэтага
N
значэння азначае, што адзін кадр з кожнай партыіN
кадраў будзе выдалены. Па змаўчанні5
.dupthresh
Усталюйце парог для выяўлення дублікатаў. Калі метрыка розніцы для кадра меншая або роўная гэтаму значэнню, яна аб'яўляецца дублікатам. Па змаўчанні
1.1
scthresh
Усталюйце парог змены сцэны. Па змаўчанні
15
.blockx
blocky
Усталюйце памер блокаў па восі X і Y, якія выкарыстоўваюцца падчас метрычных разлікаў. Вялікія блокі забяспечваюць лепшае падаўленне шуму, але таксама горш выяўляюць невялікія рухі. Павінна быць ступень двойкі. Па змаўчанні
32
.ppsrc
Пазначыць асноўны ўвод як папярэдне апрацаваны ўвод і актываваць чысты ўваходны паток крыніцы. Гэта дазваляе папярэдне апрацаваць увод з дапамогай розных фільтраў, каб дапамагчы ў разліку паказчыкаў, захоўваючы выбар кадра без страт. Калі ўстаноўлена
1
, першы паток прызначаны для папярэдне апрацаванага ўваходу, а другі паток з'яўляецца чыстай крыніцай, з якой выбіраюцца захаваныя кадры. Па змаўчанні0
.chroma
Устанавіце, ці ўлічваецца каляровасць у метрычных разліках. Па змаўчанні
1
.
11.54 deconvolve
Прымяніць двухмерную дэканвалюцыю відэаструменю ў частотнай вобласці з выкарыстаннем другога патоку ў якасці імпульсу.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці апрацоўваць.
impulse
Усталяваць, якія імпульсныя відэакадры будуць апрацоўвацца, можна
first
абоall
. Па змаўчанніall
.noise
Усталюйце шум пры выкананні дзяленняў. Па змаўчанні
0.0000001
. Карысна, калі шырыня і вышыня не аднолькавыя і не ў ступені 2, або калі паток да згортвання меў шум.
Фільтр deconvolve
таксама падтрымлівае параметры framesync .
11.55 dedot
Паменшыце перакрыжаваную яркасць (поўзанне кропак) і перакрыжаваныя колеры (вясёлкі) з відэа.
Ён прымае наступныя варыянты:
m
Задаць рэжым працы. Можа быць камбінацыяй
dotcrawl
для памяншэння перакрыжаванай яркасці і/абоrainbows
памяншэння перакрыжаванай каляровасці.lt
Усталюйце прасторавы парог яркасці. Больш нізкія значэнні павялічваюць памяншэнне перакрыжаванай яркасці.
tl
Усталюйце допуск для скроневай яркасці. Больш высокія значэнні павялічваюць памяншэнне перакрыжаванай яркасці.
tc
Усталюйце допуск для часовай змены каляровасці. Больш высокія значэнні павялічваюць памяншэнне перакрыжаванага колеру.
ct
Усталюйце часовы парог каляровасці. Больш нізкія значэнні павялічваюць памяншэнне перакрыжаванага колеру.
11.56 deflate
Прымяненне эфекту здуцця да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) сярэднім, прымаючы пад увагу толькі значэнні, ніжэйшыя за піксель.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.
11.56.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.57 deflicker
Выдаліць змены яркасці часовай рамкі.
Ён прымае наступныя варыянты:
size, s
Задаць памер фільтра слізгальнага сярэдняга ў кадрах. Па змаўчанні 5. Дазволены дыяпазон 2 - 129.
mode, m
Усталюйце рэжым асераднення для згладжвання часавых змяненняў яркасці.
Даступныя значэнні:
- '
am
' Сярэдняе арыфметычнае
- '
gm
' Сярэдняе геаметрычнае
- '
hm
' Гарманічнае сярэдні
- '
qm
' Сярэдняе квадратычнае
- '
cm
' Кубічнае сярэдняе
- '
pm
' Улада значыць
- '
median
' Медыяна
- '
bypass
Фактычна не змяняйце кадр. Карысна, калі патрэбныя толькі метададзеныя.
11.58 dejudder
Выдаліць дрыгаценне, выкліканае часткова празрадковым тэлекіназмесцівам.
Дрыгаценне можа быць уведзена, напрыклад, з дапамогай падцягвальнага фільтра. Калі зыходная крыніца была часткова тэлекіназмесцівам, то вывад pullup,dejudder
будзе мець зменную частату кадраў. Можа змяняць частату кадраў кантэйнера. Акрамя гэтай змены, гэты фільтр не паўплывае на відэа з пастаяннай частатой кадраў.
Параметр, даступны ў гэтым фільтры:
cycle
Укажыце даўжыню акна, у якім паўтараецца дрыгаценне.
Прымае любое цэлае лік, большае за 1. Карысныя значэнні:
- '
4
' Калі арыгінал быў тэлекіно з 24 да 30 кадраў у секунду (фільм у NTSC).
- '
5
' Калі арыгінал быў тэлекіно з 25 да 30 кадраў у секунду (PAL да NTSC).
- '
20
' Калі сумесь двух.
Па змаўчанні "
4
'.- '
11.59 delogo
Здушыць лагатып тэлевізійнай станцыі простай інтэрпаляцыяй навакольных пікселяў. Проста ўсталюйце прастакутнік, які закрывае лагатып, і назірайце, як ён знікае (і часам з'яўляецца нешта яшчэ больш пачварнае - ваш прабег можа адрознівацца).
Ён прымае наступныя параметры:
x
y
Укажыце каардынаты верхняга левага вугла лагатыпа. Іх трэба ўдакладніць.
w
h
Укажыце шырыню і вышыню лагатыпа, які трэба ачысціць. Іх трэба ўдакладніць.
show
Пры значэнні 1 на экране малюецца зялёны прамавугольнік, каб спрасціць пошук патрэбных параметраў
x
,y
,w
іh
. Значэнне па змаўчанні - 0.Прастакутнік намаляваны на крайніх пікселях, якія будуць (часткова) заменены інтэрпаляванымі значэннямі. Значэнні наступных пікселяў непасрэдна за межамі гэтага прамавугольніка ў кожным кірунку будуць выкарыстоўвацца для вылічэння інтэрпаляваных значэнняў пікселяў унутры прамавугольніка.
11.59.1 Examples
- Усталюйце прамавугольнік, які ахоплівае вобласць з каардынатамі верхняга левага кута 0,0 і памерам 100x77:
delogo=x=0:y=0:w=100:h=77
11.60 derain
Выдаліце ​​​​дождж з уваходнага відарыса/відэа, прымяніўшы метады зняцця кадраў на аснове згортачных нейронавых сетак. Падтрымліваюцца мадэлі:
- Сетка агрэгацыі кантэксту перыядычнага сціску і ўзбуджэння (RESCAN). Глядзіце http://openaccess.thecvf.com/content_ECCV_2018/papers/Xia_Li_Recurrent_Squeeze-and-Excitation_Context_ECCV_2018_paper.pdf .
Навучанне, а таксама сцэнарыі стварэння мадэляў прадстаўлены ў сховішчы па адрасе https://github.com/XueweiMeng/derain_filter.git .
Файлы ўласнай мадэлі (.model) могуць быць створаны з файлаў мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py
Фільтр прымае наступныя параметры:
filter_type
Укажыце, які фільтр выкарыстоўваць. Гэты параметр прымае наступныя значэнні:
- '
derain
' Асушальны фільтр. Каб правесці дрэнажны фільтр, вам трэба выкарыстоўваць дрэнажную мадэль.
- '
dehaze
' Ачышчальны фільтр. Каб правесці дэтальны фільтр, неабходна выкарыстоўваць дэтальную мадэль.
Значэнне па змаўчанні '
derain
'.- '
dnn_backend
Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:
- '
native
' Уласная рэалізацыя загрузкі і выканання DNN.
- '
tensorflow
' Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з
--enable-libtensorflow
Значэнне па змаўчанні '
native
'.- '
model
Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. TensorFlow і ўласны бэкэнд могуць загружаць файлы толькі для свайго фармату.
Каб атрымаць поўную функцыянальнасць (напрыклад, асінхроннае выкананне), выкарыстоўвайце фільтр dnn_processing .
11.61 deshake
Паспрабуйце выправіць невялікія змены гарызантальнага і/або вертыкальнага зруху. Гэты фільтр дапамагае ліквідаваць дрыгаценне камеры ад трымання камеры ў руках, сутыкнення са штатывам, перамяшчэння на аўтамабілі і г.д.
Фільтр прымае наступныя параметры:
x
y
w
h
Укажыце прастакутную вобласць, дзе трэба абмежаваць пошук вектараў руху. Пры жаданні пошук вектараў руху можа быць абмежаваны прамавугольнай вобласцю кадра, вызначанай левым верхнім вуглом, шырынёй і вышынёй. Гэтыя параметры маюць тое ж значэнне, што і фільтр Drawbox, які можна выкарыстоўваць для візуалізацыі становішча абмежавальнай рамкі.
Гэта карысна, калі пошук вектара руху можа пераблытаць адначасовы рух аб'ектаў у кадры з рухам камеры.
Калі для любога або для ўсіх з
x
,y
,w
іh
ўстаноўлена -1, выкарыстоўваецца поўны кадр. Гэта дазваляе ўсталёўваць пазнейшыя параметры без указання абмежавальнай рамкі для пошуку вектара руху.Па змаўчанні - пошук па ўсім кадры.
rx
ry
Укажыце максімальную ступень перамяшчэння ў напрамках x і y у дыяпазоне 0-64 пікселяў. Па змаўчанні 16.
edge
Укажыце, як ствараць пікселі для запаўнення прабелаў па краях кадра. Даступныя значэнні:
- '
blank, 0
' Запоўніце пустыя месцы нулямі
- '
original, 1
' Арыгінальная выява ў пустых месцах
- '
clamp, 2
' Значэнне экструдаванага краю ў пустых месцах
- '
mirror, 3
' Люстраны край у пустых месцах
Значэнне па змаўчанні '
mirror
'.- '
blocksize
Укажыце памер блока для пошуку па руху. Дыяпазон 4-128 пікселяў, па змаўчанні 8.
contrast
Укажыце парог кантраснасці для блокаў. Будуць разглядацца толькі блокі з кантраснасцю, якая перавышае зададзены (розніца паміж самымі цёмнымі і самымі светлымі пікселямі). Дыяпазон 1-255, па змаўчанні 125.
search
Укажыце стратэгію пошуку. Даступныя значэнні:
- '
exhaustive, 0
' Усталюйце вычарпальны пошук
- '
less, 1
' Усталюйце менш поўны пошук.
Значэнне па змаўчанні '
exhaustive
'.- '
filename
Калі ўстаноўлена, то падрабязны журнал пошуку руху запісваецца ў паказаны файл.
11.62 despill
Выдаліце ​​непажаданае забруджванне колераў пярэдняга плана, выкліканае адлюстраваннем колеру зялёнага або сіняга экрана.
Гэты фільтр прымае наступныя параметры:
type
Усталюйце тып сцёку для выкарыстання.
mix
Усталюйце, як будзе стварацца карта разліву.
expand
Усталюйце, колькі трэба пазбавіцца ад рэшткаў разліву.
red
Кантралюе колькасць чырвонага ў вобласці разліву.
green
Кантралюе колькасць зеляніны ў зоне разліву. Павінен быць -1 для зялёнага экрана.
blue
Кантралюе колькасць сіняга ў вобласці разліву. Павінен быць -1 для сіняга экрана.
brightness
Кантралюе яркасць вобласці разліву, захоўваючы колеры.
alpha
Змяніць альфа-версію са згенераванай карты разліву.
11.62.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.63 detelecine
Прымяніце аперацыю, адваротную тэлекіно. Для гэтага патрабуецца загадзя вызначаны шаблон, вызначаны з дапамогай параметра шаблона, які павінен быць такім жа, як той, які перадаецца ў фільтр тэлекіно.
Гэты фільтр прымае наступныя параметры:
first_field
- '
top, t
' спачатку верхняе поле
- '
bottom, b
' ніжняе поле спачатку Значэнне па змаўчанні -
top
.
- '
pattern
Лічбавы радок, які прадстаўляе шаблон выпадальнага меню, які вы хочаце прымяніць. Значэнне па змаўчанні -
23
.start_frame
Лік, які ўяўляе становішча першага кадра адносна тэлекіно. Гэта трэба выкарыстоўваць, калі ручай перарэзаны. Значэнне па змаўчанні -
0
.
11.64 dilation
Прымяніць эфект пашырэння да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) максімумам.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.
coordinates
Сцяг, які вызначае піксель, на які трэба спасылацца. Па змаўчанні 255, гэта значыць выкарыстоўваюцца ўсе восем пікселяў.
Сцягі на мясцовых картах з каардынатамі 3x3, як гэта:
1 2 3 4 5 6 7 8
11.64.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.65 displace
Зрушыць пікселі, як паказвае другі і трэці ўваходны паток.
Ён прымае тры ўваходныя патокі і выводзіць адзін паток, першы ўваход з'яўляецца крыніцай, а другі і трэці ўваход з'яўляюцца картамі зрушэння.
Другі ўваход вызначае, наколькі зрушыць пікселі ўздоўж восі х, у той час як трэці ўвод вызначае, наколькі зрушыць пікселі ўздоўж восі у. Калі адзін з патокаў карты зрушэння завяршаецца, будзе выкарыстоўвацца апошні кадр з гэтай карты зрушэння.
Звярніце ўвагу, што пасля стварэння карты зрушэнняў можна выкарыстоўваць зноў і зноў.
Далей апісваюцца прынятыя варыянты.
edge
Усталюйце паводзіны зрушэння для пікселяў, якія знаходзяцца па-за дыяпазонам.
Даступныя значэнні:
- '
blank
' Адсутныя пікселі замяняюцца чорнымі пікселямі.
- '
smear
' Суседнія пікселі будуць разыходзіцца, каб замяніць адсутныя пікселі.
- '
wrap
' Пікселі па-за дыяпазонам абгортваюцца, каб яны паказвалі на пікселі з іншага боку.
- '
mirror
' Пікселі па-за дыяпазонам будуць заменены на люстраныя пікселі.
Па змаўчанні '
smear
'.- '
11.65.1 Examples
- Дадайце эфект рабізны да ўваходу rgb памеру відэа hd720:
ffmpeg -i INPUT -f lavfi -i nullsrc=s=hd720,lutrgb=128:128:128 -f lavfi -i nullsrc=s=hd720,geq='r=128+30*sin(2*PI*X/400+T):g=128+30*sin(2*PI*X/400+T):b=128+30*sin(2*PI*X/400+T)' -lavfi '[0][1][2]displace' OUTPUT
- Дадайце эфект хвалі да ўводу rgb відэа памеру hd720:
ffmpeg -i INPUT -f lavfi -i nullsrc=hd720,geq='r=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T)):g=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T)):b=128+80*(sin(sqrt((X-W/2)*(X-W/2)+(Y-H/2)*(Y-H/2))/220*2*PI+T))' -lavfi '[1]split[x][y],[0][x][y]displace' OUTPUT
11.66 dnn_classify
Выканайце класіфікацыю з дапамогай глыбокіх нейронных сетак на аснове абмежавальных рамак.
Фільтр прымае наступныя параметры:
dnn_backend
Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Цяпер гэтая опцыя прымае толькі openvino, будуць дададзены бэкэнды tensorflow.
model
Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў.
input
Усталюйце імя ўваходу сеткі dnn.
output
Усталюйце імя вываду сеткі dnn.
confidence
Усталюйце парог даверу (па змаўчанні: 0,5).
labels
Усталюйце шлях да файла цэтліка з указаннем супастаўлення паміж ідэнтыфікатарам цэтліка і імем. Імя кожнай этыкеткі пішацца ў адзін радок, прабелы і пустыя радкі прапускаюцца. Першы радок - гэта назва этыкеткі з ідэнтыфікатарам 0, а другі радок - назва этыкеткі з ідэнтыфікатарам 1 і г. д. Ідэнтыфікатар этыкеткі лічыцца імем, калі файл этыкеткі не пазначаны.
backend_configs
Усталюйце канфігурацыі для перадачы ў бэкэнд
Для бэкэнда tensorflow вы можаце ўсталяваць яго канфігурацыі з дапамогай
sess_config
параметры, калі ласка, выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі для вашай сістэмы.
11.67 dnn_detect
Рабіце выяўленне аб'ектаў з дапамогай глыбокіх нейронных сетак.
Фільтр прымае наступныя параметры:
dnn_backend
Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Цяпер гэтая опцыя прымае толькі openvino, будуць дададзены бэкэнды tensorflow.
model
Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў.
input
Усталюйце імя ўваходу сеткі dnn.
output
Усталюйце імя вываду сеткі dnn.
confidence
Усталюйце парог даверу (па змаўчанні: 0,5).
labels
Усталюйце шлях да файла цэтліка з указаннем супастаўлення паміж ідэнтыфікатарам цэтліка і імем. Імя кожнай этыкеткі пішацца ў адзін радок, прабелы і пустыя радкі прапускаюцца. Першы радок - гэта назва этыкеткі з ідэнтыфікатарам 0 (звычайна гэта "фон"), а другі радок - назва этыкеткі з ідэнтыфікатарам 1 і г. д. Ідэнтыфікатар этыкеткі лічыцца імем, калі файл этыкеткі не пазначаны.
backend_configs
Усталюйце канфігурацыі для перадачы ў бэкэнд. Каб выкарыстоўваць асінхроннае выкананне, усталюйце async (па змаўчанні: усталявана). Адкат да выканання сінхранізацыі, калі бэкэнд не падтрымлівае асінхранізацыю.
11.68 dnn_processing
Апрацоўвайце выявы з дапамогай глыбокіх нейронных сетак. Ён працуе разам з іншым фільтрам, які пераўтворыць піксельны фармат Frame у тое, што патрабуецца сетцы dnn.
Фільтр прымае наступныя параметры:
dnn_backend
Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:
- '
native
' Уласная рэалізацыя загрузкі і выканання DNN.
- '
tensorflow
' Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з
--enable-libtensorflow
- '
openvino
' Бэкэнд OpenVINO. Каб уключыць гэты бэкэнд, вам трэба стварыць і ўсталяваць бібліятэку OpenVINO для C (гл. https://github.com/openvinotoolkit/openvino/blob/master/build-instruction.md ) і наладзіць FFmpeg з
--enable-libopenvino
(–extra-cflags=- I... –extra-ldflags=-L... можа спатрэбіцца, калі файлы загалоўкаў і бібліятэкі не ўсталяваны ў сістэмны шлях)
Значэнне па змаўчанні '
native
'.- '
model
Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. TensorFlow, OpenVINO і ўласны бэкэнд могуць загружаць файлы толькі для свайго фармату.
Файл уласнай мадэлі (.model) можа быць створаны з файла мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py
input
Усталюйце імя ўваходу сеткі dnn.
output
Усталюйце імя вываду сеткі dnn.
backend_configs
Усталюйце канфігурацыі для перадачы ў бэкэнд. Каб выкарыстоўваць асінхроннае выкананне, усталюйце async (па змаўчанні: усталявана). Адкат да выканання сінхранізацыі, калі бэкэнд не падтрымлівае асінхранізацыю.
Для бэкэнда tensorflow вы можаце ўсталяваць яго канфігурацыі з дапамогай
sess_config
параметры, калі ласка, выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі бэкэнда TensorFlow для вашай сістэмы.
11.68.1 Examples
- Выдаліць дождж у фрэйме rgb24 з дапамогай can.pb (гл . фільтр выдалення дрэнажу ):
./ffmpeg -i rain.jpg -vf format=rgb24,dnn_processing=dnn_backend=tensorflow:model=can.pb:input=x:output=y derain.jpg
- Паменшыце ўдвая піксельнае значэнне кадра з фарматам gray32f:
ffmpeg -i input.jpg -vf format=grayf32,dnn_processing=model=halve_gray_float.model:input=dnn_in:output=dnn_out:dnn_backend=native -y out.native.png
- Апрацоўвайце канал Y з дапамогай srcnn.pb (гл. фільтр sr ) для кадра з yuv420p (падтрымліваюцца планарныя фарматы YUV):
./ffmpeg -i 480p.jpg -vf format=yuv420p,scale=w=iw*2:h=ih*2,dnn_processing=dnn_backend=tensorflow:model=srcnn.pb:input=x:output=y -y srcnn.jpg
- Апрацоўвайце канал Y з дапамогай espcn.pb (гл. фільтр sr ), які змяняе памер кадра, для фармату yuv420p (падтрымліваюцца планарныя фарматы YUV), выкарыстоўвайце tools/python/tf_sess_config.py, каб атрымаць канфігурацыі бэкэнда TensorFlow для вашай сістэмы.
./ffmpeg -i 480p.jpg -vf format=yuv420p,dnn_processing=dnn_backend=tensorflow:model=espcn.pb:input=x:output=y:backend_configs=sess_config=0x10022805320e09cdccccccccccec3f20012a01303801 -y tmp.espcn.jpg
11.69 drawbox
Намалюйце каляровае поле на ўваходным малюнку.
Ён прымае наступныя параметры:
x
y
Выразы, якія задаюць каардынаты верхняга левага вугла скрынкі. Па змаўчанні гэта 0.
width, w
height, h
Выразы, якія вызначаюць шырыню і вышыню скрынкі; калі 0, яны інтэрпрэтуюцца як шырыня і вышыня ўводу. Па змаўчанні гэта 0.
color, c
Укажыце колер поля для запісу. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выкарыстоўваецца спецыяльнае значэнне
invert
, колер краю поля будзе такім жа, як у відэа з перавернутай яркасцю.thickness, t
Выраз, які задае таўшчыню краю поля. Значэнне
fill
створыць запоўненае поле. Значэнне па змаўчанні -3
.Спіс прымальных канстант глядзіце ніжэй.
replace
Дастасавальна, калі ўвод мае альфа. Пры значэнні
1
пікселі афарбаванага поля перазапішуць колер і альфа-пікселі відэа. Па змаўчанні гэта0
, якое аб'ядноўвае поле на ўваход, пакідаючы альфа-версію відэа некранутай.
Параметры для x
, y
, w
і h
з'яўляюцца t
выразамі, якія змяшчаюць наступныя канстанты:
dar
Суадносіны бакоў уваходнага дысплея такія ж, як (
w
/h
) *sar
.hsub
vsub
гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.in_h, ih
in_w, iw
Шырыня і вышыня ўводу.
sar
Суадносіны бакоў уводнага ўзору.
x
y
Каардынаты зрушэння x і y у месцы, дзе намалявана рамка.
w
h
Шырыня і вышыня намаляванай скрынкі.
box_source
Крыніца скрыні можа быць зададзена як side_data_detection_bboxes, калі вы хочаце выкарыстоўваць даныя скрыні ў скрынках выяўлення пабочных дадзеных.
Калі
box_source
ўстаноўлена,x
,y
,width
іheight
будуць ігнаравацца і па-ранейшаму будуць выкарыстоўвацца даныя скрыні ў скрынках выяўлення пабочных даных. Таму, калі ласка, не выкарыстоўвайце гэты параметр, калі вы не ўпэўнены ў крыніцы скрыні.t
Таўшчыня намаляванай скрынкі.
Гэтыя канстанты дазваляюць выразам
x
,y
,w
,h
іt
спасылацца адзін на аднаго, так што вы можаце, напрыклад, пазначыцьy=x/dar
абоh=w/dar
.
11.69.1 Examples
- Намалюйце чорную рамку вакол краю ўваходнага малюнка:
drawbox
- Намалюйце поле чырвоным колерам і непразрыстасцю 50%:
drawbox=10:20:200:60:red@0.5
Папярэдні прыклад можна задаць так:
drawbox=x=10:y=20:w=200:h=60:color=red@0.5
- Запоўніце поле ружовым колерам:
drawbox=x=10:y=10:w=100:h=100:color=pink@0.5:t=fill
- Намалюйце 2-піксельную чырвоную маску 2,40:1:
drawbox=x=-t:y=0.5*(ih-iw/2.4)-t:w=iw+t*2:h=iw/2.4+t*2:t=2:c=red
11.69.2 Commands
Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.70 drawgraph
Намалюйце графік, выкарыстоўваючы ўваходныя метаданыя відэа.
Ён прымае наступныя параметры:
m1
Усталюйце ключ метаданых 1-га кадра, значэнні метададзеных якога будуць выкарыстоўвацца для малявання графіка.
fg1
Усталюйце 1-ы выраз колеру пярэдняга плана.
m2
Усталюйце ключ метададзеных 2-га кадра, значэнні метададзеных якіх будуць выкарыстоўвацца для малявання графіка.
fg2
Устанавіць 2-е выраз колеру пярэдняга плана.
m3
Усталюйце ключ метаданых 3-га кадра, значэнні метаданых якога будуць выкарыстоўвацца для малявання графіка.
fg3
Усталюйце выраз 3-га колеру пярэдняга плана.
m4
Усталюйце ключ метададзеных 4-га кадра, значэнні метададзеных якіх будуць выкарыстоўвацца для малявання графіка.
fg4
Усталюйце 4-ы колер пярэдняга плана.
min
Усталюйце мінімальнае значэнне значэння метададзеных.
max
Усталюйце максімальнае значэнне значэння метададзеных.
bg
Задаць колер фону графіка. Па змаўчанні белы.
mode
Усталяваць рэжым графіка.
Даступныя значэнні для рэжыму:
- '
bar
' - '
dot
' - '
line
'
Па змаўчанні
line
.- '
slide
Усталяваць рэжым слайдаў.
Даступныя значэнні для слайда:
- '
frame
' Намалюйце новую рамку, калі будзе дасягнута правая мяжа.
- '
replace
' Замяніць старыя слупкі на новыя.
- '
scroll
' Пракрутка справа налева.
- '
rscroll
' Пракруціць злева направа.
- '
picture
' Намалюйце адну карцінку.
Па змаўчанні
frame
.- '
size
Задаць памер графічнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
900x256
.rate, r
Усталюйце выходную частату кадраў. Значэнне па змаўчанні -
25
.Выразы колеру пярэдняга плана могуць выкарыстоўваць наступныя зменныя:
MIN
Мінімальнае значэнне значэння метададзеных.
MAX
Максімальнае значэнне значэння метададзеных.
VAL
Бягучае значэнне ключа метаданых.
Колер вызначаецца як 0xAABBGGRR.
Прыклад выкарыстання метаданых з фільтра signalstats :
signalstats,drawgraph=lavfi.signalstats.YAVG:min=0:max=255
Прыклад выкарыстання метададзеных з фільтра ebur128 :
ebur128=metadata=1,adrawgraph=lavfi.r128.M:min=-120:max=5
11.71 drawgrid
Намалюйце сетку на ўваходным малюнку.
Ён прымае наступныя параметры:
x
y
Выразы, якія задаюць каардынаты некаторай кропкі перасячэння сеткі (прызначаныя для наладжвання зрушэння). Абодва па змаўчанні 0.
width, w
height, h
Выразы, якія вызначаюць шырыню і вышыню ячэйкі сеткі, калі 0, яны інтэрпрэтуюцца як шырыня і вышыня ўваходных дадзеных, адпаведна, мінус
thickness
, таму выява атрымлівае рамку. Па змаўчанні 0.color, c
Пакажыце колер сеткі. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выкарыстоўваецца спецыяльнае значэнне
invert
, колер сеткі такі ж, як у відэа з перавернутай яркасцю.thickness, t
Выраз, які задае таўшчыню лініі сеткі. Значэнне па змаўчанні -
1
.Спіс прымальных канстант глядзіце ніжэй.
replace
Дастасавальна, калі ўвод мае альфа. Пікселі
1
афарбаванай сеткі перазапішуць каляровыя і альфа-пікселі відэа. Па змаўчанні гэта0
, якое аб'ядноўвае сетку ва ўваход, пакідаючы альфа-версію відэа некранутай.
Параметры для x
, y
, w
і h
з'яўляюцца t
выразамі, якія змяшчаюць наступныя канстанты:
dar
Суадносіны бакоў уваходнага дысплея такія ж, як (
w
/h
) *sar
.hsub
vsub
гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.in_h, ih
in_w, iw
Шырыня і вышыня ячэйкі ўваходнай сеткі.
sar
Суадносіны бакоў уводнага ўзору.
x
y
Каардынаты x і y некаторай кропкі перасячэння сеткі (прызначаныя для канфігурацыі зрушэння).
w
h
Шырыня і вышыня намаляванай клеткі.
t
Таўшчыня намаляванай клеткі.
Гэтыя канстанты дазваляюць выразам
x
,y
,w
,h
іt
спасылацца адзін на аднаго, так што вы можаце, напрыклад, пазначыцьy=x/dar
абоh=w/dar
.
11.71.1 Examples
- Намалюйце сетку з ячэйкай 100x100 пікселяў, таўшчынёй 2 пікселя, чырвоным колерам і непразрыстасцю 50%:
drawgrid=width=100:height=100:thickness=2:color=red@0.5
- Намалюйце белую сетку 3x3 з непразрыстасцю 50%:
drawgrid=w=iw/3:h=ih/3:t=2:c=white@0.5
11.71.2 Commands
Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.72 drawtext
Намалюйце тэкставы радок або тэкст з вызначанага файла паверх відэа, выкарыстоўваючы бібліятэку libfreetype.
Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай
--enable-libfreetype
. Каб уключыць рэзервовы шрыфт па змаўчанні і font
опцыю, неабходна наладзіць FFmpeg з дапамогай --enable-libfontconfig
. Каб уключыць гэтую text_shaping
опцыю, неабходна наладзіць FFmpeg з дапамогай
--enable-libfribidi
.
11.72.1 Syntax
Ён прымае наступныя параметры:
box
Выкарыстоўваецца для малявання рамкі вакол тэксту з выкарыстаннем колеру фону. Значэнне павінна быць альбо 1 (уключыць), альбо 0 (выключыць). Значэнне па змаўчанні роўна
box
0.boxborderw
Усталюйце шырыню рамкі, якую трэба правесці вакол поля, выкарыстоўваючы
boxcolor
. Значэнне па змаўчанні роўнаboxborderw
0.boxcolor
Колер, які будзе выкарыстоўвацца для малявання поля вакол тэксту. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
boxcolor
- "белы".line_spacing
Усталюйце міжрадковы інтэрвал у пікселях мяжы, якая будзе намалявана вакол поля, выкарыстоўваючы
box
. Значэнне па змаўчанні роўнаline_spacing
0.borderw
Усталюйце шырыню рамкі вакол тэксту з дапамогай
bordercolor
. Значэнне па змаўчанні роўнаborderw
0.bordercolor
Усталюйце колер, які будзе выкарыстоўвацца для малявання рамкі вакол тэксту. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
bordercolor
- "чорны".expansion
Выберыце спосаб
text
разгортвання. Можа быцьnone
,strftime
(састарэла) абоnormal
(па змаўчанні). Падрабязнасці глядзіце ў раздзеле пашырэння тэксту ніжэй.basetime
Усталюйце час пачатку падліку. Значэнне ў мікрасекундах. Прымяняецца толькі ў састарэлым рэжыме пашырэння strftime. Для эмуляцыі ў звычайным рэжыме разгортвання выкарыстоўвайце
pts
функцыю, указваючы час пачатку (у секундах) у якасці другога аргумента.fix_bounds
Калі ісціна, праверце і выпраўце тэкставыя каардынаты, каб пазбегнуць выразання.
fontcolor
Колер, які будзе выкарыстоўвацца для малявання шрыфтоў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
fontcolor
- "чорны".fontcolor_expr
Радок, які пашыраецца гэтак жа, як
text
для атрымання дынамічнагаfontcolor
значэння. Па змаўчанні гэты параметр мае пустое значэнне і не апрацоўваецца. Калі гэты параметр усталяваны, ён перавызначаеfontcolor
параметр.font
Сямейства шрыфтоў для малявання тэксту. Па змаўчанні Sans.
fontfile
Файл шрыфта, які будзе выкарыстоўвацца для малявання тэксту. Шлях павінен быць уключаны. Гэты параметр абавязковы, калі падтрымка fontconfig адключана.
alpha
Намалюйце тэкст, ужываючы альфа-змешванне. Значэнне можа быць лікам ад 0,0 да 1,0. Выраз таксама прымае тыя ж зменныя
x, y
. Значэнне па змаўчанні - 1. Калі ласка, глfontcolor_expr
.fontsize
Памер шрыфта, які будзе выкарыстоўвацца для малявання тэксту. Значэнне па змаўчанні роўна
fontsize
16.text_shaping
Калі ўстаноўлена значэнне 1, паспрабуйце сфармаваць тэкст (напрыклад, змяніць парадак тэксту справа налева і злучыць арабскія сімвалы), перш чым маляваць яго. У адваротным выпадку проста намалюйце тэкст дакладна так, як пададзена. Па змаўчанні 1 (калі падтрымліваецца).
ft_load_flags
Сцяжкі, якія будуць выкарыстоўвацца для загрузкі шрыфтоў.
Сцягі адлюстроўваюць адпаведныя сцягі, якія падтрымліваюцца libfreetype, і з'яўляюцца камбінацыяй наступных значэнняў:
default
no_scale
no_hinting
render
no_bitmap
vertical_layout
force_autohint
crop_bitmap
pedantic
ignore_global_advance_width
no_recurse
ignore_transform
monochrome
linear_design
no_autohint
Значэнне па змаўчанні - "default".
Для атрымання дадатковай інфармацыі звярніцеся да дакументацыі для сцягоў FT_LOAD_* libfreetype.
shadowcolor
Колер, які будзе выкарыстоўвацца для малявання цені за намаляваным тэкстам. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
shadowcolor
- "чорны".shadowx
shadowy
Зрухі X і Y для пазіцыі цені тэксту адносна пазіцыі тэксту. Яны могуць быць як станоўчымі, так і адмоўнымі значэннямі. Значэнне па змаўчанні для абодвух - "0".
start_number
Пачатковы нумар кадра для зменнай n/frame_num. Значэнне па змаўчанні - "0".
tabsize
Памер у колькасці прабелаў для візуалізацыі ўкладкі. Значэнне па змаўчанні - 4.
timecode
Усталюйце пачатковае прадстаўленне часовага кода ў фармаце "чч:хм:сс[:;.]фф". Яго можна выкарыстоўваць з тэкставым параметрам або без яго.
timecode_rate
опцыя павінна быць указана.timecode_rate, rate, r
Усталюйце частату кадраў таймкода (толькі таймкод). Значэнне будзе акруглена да бліжэйшага цэлага ліку. Мінімальнае значэнне - "1". Часовы код з адключаным кадрам падтрымліваецца для частаты кадраў 30 і 60.
tc24hmax
Калі ўсталявана значэнне 1, вывад параметра тайм-кода будзе пераходзіць на 24 гадзіны. Па змаўчанні 0 (адключана).
text
Тэкставы радок, які трэба намаляваць. Тэкст павінен быць паслядоўнасцю знакаў у кадзіроўцы UTF-8. Гэты параметр абавязковы, калі з параметрам не вызначаны файл
textfile
.textfile
Тэкставы файл, які змяшчае тэкст для малявання. Тэкст павінен быць паслядоўнасцю знакаў у кадзіроўцы UTF-8.
Гэты параметр з'яўляецца абавязковым, калі з параметрам не зададзены тэкставы радок
text
.Калі ўказаны абодва
text
іtextfile
, выдаецца памылка.text_source
Крыніца тэксту павінна быць зададзена як side_data_detection_bboxes, калі вы хочаце выкарыстоўваць тэкставыя даныя ў bboxes выяўлення пабочных даных.
Калі ўсталявана крыніца тэксту,
text
ёнtextfile
будзе ігнаравацца і па-ранейшаму выкарыстоўваць тэкставыя даныя ў палях выяўлення пабочных даных. Таму, калі ласка, не выкарыстоўвайце гэты параметр, калі вы не ўпэўненыя ў крыніцы тэксту.reload
Будзе
textfile
перазагружацца праз зададзены інтэрвал кадраў. Не забудзьцеся абнавіцьtextfile
атамарна, інакш яно можа быць прачытана часткова або нават не атрымаецца. Дыяпазон ад 0 да INT_MAX. Па змаўчанні 0.x
y
Выразы, якія вызначаюць зрухі, дзе тэкст будзе намаляваны ў відэакадры. Яны адносна верхняй/левай мяжы выходнага малюнка.
Значэнне па змаўчанні
x
іy
роўна "0".Глядзіце ніжэй спіс прынятых канстант і функцый.
Параметры для x
і y
- гэта выразы, якія змяшчаюць наступныя канстанты і функцыі:
dar
суадносіны бакоў уваходнага дысплея, яно такое ж, як (
w
/h
) *sar
hsub
vsub
гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.line_h, lh
вышыня кожнага радка тэксту
main_h, h, H
вышыня ўваходу
main_w, w, W
шырыня ўваходу
max_glyph_a, ascent
максімальная адлегласць ад базавай лініі да самай высокай/верхняй каардынаты сеткі, якая выкарыстоўваецца для размяшчэння кропкі контуру гліфа, для ўсіх візуалізаваных гліфаў. Гэта станоўчае значэнне з-за арыентацыі сеткі воссю Y уверх.
max_glyph_d, descent
максімальная адлегласць ад базавай лініі да самай нізкай каардынаты сеткі, якая выкарыстоўваецца для размяшчэння кропкі контуру гліфа, для ўсіх адлюстраваных гліфаў. Гэта адмоўнае значэнне з-за арыентацыі сеткі з воссю Y уверх.
max_glyph_h
максімальная вышыня гліфа, гэта значыць максімальная вышыня для ўсіх гліфаў, якія змяшчаюцца ў адлюстраваным тэксце, яна эквівалентная
ascent
-descent
.max_glyph_w
максімальная шырыня гліфа, гэта значыць максімальная шырыня ўсіх гліфаў, якія змяшчаюцца ў адлюстраваным тэксце
n
нумар уваходнага кадра, пачынаючы з 0
rand(min, max)
вяртае выпадковы лік паміж
min
іmax
sar
Суадносіны бакоў уводнага ўзору.
t
пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая
text_h, th
вышыня адлюстраванага тэксту
text_w, tw
шырыня адлюстраванага тэксту
x
y
каардынаты зрушэння x і y, дзе намаляваны тэкст.
Гэтыя параметры дазваляюць выразам
x
іy
спасылацца адзін на аднаго, так што вы можаце, напрыклад, паказацьy=x/dar
.pict_type
Аднасiмвольнае апiсанне бягучага тыпу фрэйма.
pkt_pos
Бягучая пазіцыя пакета ва ўваходным файле або патоку (у байтах, ад пачатку ўводу). Значэнне -1 азначае, што гэтая інфармацыя недаступная.
pkt_duration
Працягласць бягучага пакета ў секундах.
pkt_size
Бягучы памер пакета (у байтах).
11.72.2 Text expansion
Каліexpansion
усталявана ў strftime
, фільтр распазнае паслядоўнасці strftime() у прадстаўленым тэксце і пашырае іх адпаведна. Праверце дакументацыю па strftime(). Гэта функцыя састарэла.
Каліexpansion
усталявана none
, тэкст друкуецца даслоўна.
Каліexpansion
усталявана normal
(па змаўчанні), выкарыстоўваецца наступны механізм пашырэння.
Сімвал зваротнай касой рысы '\
', за якім ідзе любы сімвал, заўсёды пашыраецца да другога сімвала.
Паслядоўнасці формы %{...}
пашыраны. Тэкст у фігурных дужках - гэта імя функцыі, за якім, магчыма, ідуць аргументы, падзеленыя знакам ":". Калі аргументы ўтрымліваюць спецыяльныя сімвалы або падзельнікі (':' або '}'), іх трэба экранаваць.
Звярніце ўвагу, што яны, верагодна, таксама павінны быць экранаваныя як значэнне для
text
опцыя ў радку аргумента фільтра і ў якасці аргумента фільтра ў апісанні фільтраграфа, і, магчыма, таксама для абалонкі, якая стварае да чатырох узроўняў экраніравання; выкарыстанне тэкставага файла дазваляе пазбегнуць гэтых праблем.
Даступныя наступныя функцыі:
expr, e
Вынік ацэнкі выразу.
Ён павінен прымаць адзін аргумент, які вызначае выраз для вылічэння, які прымае тыя ж канстанты і функцыі, што
x
іy
значэнні і. Звярніце ўвагу, што не ўсе канстанты павінны выкарыстоўвацца, напрыклад, памер тэксту невядомы пры ацэнцы выразу, таму канстантыtext_w
іtext_h
будуць мець нявызначанае значэнне.expr_int_format, eif
Ацаніць значэнне выразу і вывесці яго як адфарматаванае цэлае.
Першы аргумент - гэта выраз, які трэба вылічыць, як і для
expr
функцыі. Другі аргумент вызначае фармат вываду. Дазволеныя значэнні 'x
','X
','d
'і'u
'. Яны разглядаюцца сапраўды гэтак жа, як і ўprintf
функцыі. Трэці параметр неабавязковы і задае колькасць пазіцый, якія займае вывад. Яго можна выкарыстоўваць, каб дадаць запаўненне нулямі злева.gmtime
Час, у які працуе фільтр, выражаны ў UTC. Ён можа прымаць аргумент: радок фармату strftime(). Радок фармату пашыраны для падтрымкі зменнай
%[1-6]N
, якая друкуе долі секунды з дадаткова зададзенай колькасцю лічбаў.localtime
Час, у які працуе фільтр, выражаны ў мясцовым гадзінным поясе. Ён можа прымаць аргумент: радок фармату strftime(). Радок фармату пашыраны для падтрымкі зменнай
%[1-6]N
, якая друкуе долі секунды з дадаткова зададзенай колькасцю лічбаў.metadata
Метададзеныя фрэйма. Прымае адзін-два аргументы.
Першы аргумент з'яўляецца абавязковым і вызначае ключ метададзеных.
Другі аргумент неабавязковы і вызначае значэнне па змаўчанні, якое выкарыстоўваецца, калі ключ метададзеных не знойдзены або пусты.
Даступныя метададзеныя можна вызначыць шляхам праверкі запісаў, якія пачынаюцца з тэга, уключанага ў кожны раздзел кадра, надрукаваны пры запуску
ffprobe -show_frames
.Таксама даступныя метаданыя радка, створаныя ў фільтрах, якія вядуць да фільтра малюнку.
n, frame_num
Нумар кадра, пачынаючы з 0.
pict_type
Аднасiмвольнае апiсанне бягучага тыпу выявы.
pts
Метка часу бягучага кадра. Гэта можа заняць да трох аргументаў.
Першы аргумент - гэта фармат пазнакі часу; па змаўчанні
flt
для секунд у якасці дзесятковага ліку з дакладнасцю да мікрасекунды;hms
азначае адфарматаваную[-]HH:MM:SS.mmm
метку часу з дакладнасцю да мілісекунд.gmtime
азначае пазнаку часу кадра ў фармаце UTC;localtime
азначае пазнаку часу кадра ў фармаце мясцовага гадзіннага пояса.Другі аргумент - гэта зрушэнне, дададзенае да пазнакі часу.
Калі фармат усталяваны ў
hms
, трэці аргумент24HH
можа быць пастаўлены для прадстаўлення гадзіннай часткі адфарматаванай меткі часу ў 24-гадзінным фармаце (00-23).Калі фармат усталяваны ў
localtime
абоgmtime
, можа быць перададзены трэці аргумент: радок фармату strftime(). Па змаўчанніYYYY-MM-DD HH:MM:SS
будзе выкарыстоўвацца фармат.
11.72.3 Commands
Гэты фільтр падтрымлівае змяненне параметраў з дапамогай каманд:
reinit
Змяніць існуючыя параметры фільтра.
Сінтаксіс для аргумента такі ж, як і для выкліку фільтра, напрыклад
fontsize=56:fontcolor=green:text='Hello World'
Поўны выклік фільтра з дапамогай sendcmd будзе выглядаць так:
sendcmd=c='56.0 drawtext reinit fontsize=56\:fontcolor=green\:text=Hello\\ World'
Калі ўвесь аргумент не можа быць прааналізаваны або прыменены ў якасці сапраўдных значэнняў, то фільтр будзе працягваць працу з існуючымі параметрамі.
11.72.4 Examples
- Намалюйце «Тэставы тэкст» шрыфтам FreeSerif, выкарыстоўваючы значэнні па змаўчанні для дадатковых параметраў.
drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text'"
- Намалюйце «Тэставы тэкст» шрыфтам FreeSerif памерам 24 у пазіцыі x=100 і y=50 (лічачы ад верхняга левага кута экрана), тэкст жоўты з чырвонай рамкай вакол. І тэкст, і поле маюць непразрыстасць 20%.
drawtext="fontfile=/usr/share/fonts/truetype/freefont/FreeSerif.ttf: text='Test Text':\ x=100: y=50: fontsize=24: fontcolor=yellow@0.2: box=1: boxcolor=red@0.2"
Звярніце ўвагу, што двукоссі не патрэбныя, калі ў спісе параметраў не выкарыстоўваюцца прабелы.
- Паказаць тэкст у цэнтры відэакадра:
drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=(w-text_w)/2:y=(h-text_h)/2"
- Паказаць тэкст у выпадковым месцы, пераключаючыся на новае месца кожныя 30 секунд:
drawtext="fontsize=30:fontfile=FreeSerif.ttf:text='hello world':x=if(eq(mod(t\,30)\,0)\,rand(0\,(w-text_w))\,x):y=if(eq(mod(t\,30)\,0)\,rand(0\,(h-text_h))\,y)"
- Паказаць тэкставы радок, які слізгае справа налева ў апошнім радку відэакадра. Файл
LONG_LINE
Мяркуецца, што змяшчае адзін радок без новых радкоў.drawtext="fontsize=15:fontfile=FreeSerif.ttf:text=LONG_LINE:y=h-line_h:x=-50*t"
- Паказаць змест файла
CREDITS
ад ніжняй часткі кадра і пракруціць ўверх.drawtext="fontsize=20:fontfile=FreeSerif.ttf:textfile=CREDITS:y=h-20*t"
- Намалюйце адну зялёную літару "g" у цэнтры ўваходнага відэа. Базавая лінія гліфа размешчана на палове вышыні экрана.
drawtext="fontsize=60:fontfile=FreeSerif.ttf:fontcolor=green:text=g:x=(w-max_glyph_w)/2:y=h/2-ascent"
- Паказваць тэкст на працягу 1 секунды кожныя 3 секунды:
drawtext="fontfile=FreeSerif.ttf:fontcolor=white:x=100:y=x/dar:enable=lt(mod(t\,3)\,1):text='blink'"
- Выкарыстоўвайце fontconfig, каб усталяваць шрыфт. Звярніце ўвагу, што двукроп'е трэба экранаваць.
drawtext='fontfile=Linux Libertine O-40\:style=Semibold:text=FFmpeg'
- Намалюйце «Тэставы тэкст» памерам шрыфта ў залежнасці ад вышыні відэа.
drawtext="text='Test Text': fontsize=h/30: x=(w-text_w)/2: y=(h-text_h*2)"
- Надрукуйце дату кадавання ў рэальным часе (гл. strftime(3)):
drawtext='fontfile=FreeSans.ttf:text=%{localtime\:%a %b %d %Y}'
- Паказаць знікненне і знікненне тэксту (з'яўленне/знікненне):
#!/bin/sh DS=1.0 # display start DE=10.0 # display end FID=1.5 # fade in duration FOD=5 # fade out duration ffplay -f lavfi "color,drawtext=text=TEST:fontsize=50:fontfile=FreeSerif.ttf:fontcolor_expr=ff0000%{eif\\\\: clip(255*(1*between(t\\, $DS + $FID\\, $DE - $FOD) + ((t - $DS)/$FID)*between(t\\, $DS\\, $DS + $FID) + (-(t - $DE)/$FOD)*between(t\\, $DE - $FOD\\, $DE) )\\, 0\\, 255) \\\\: x\\\\: 2 }"
- Выраўнаваць некалькі асобных тэкстаў па гарызанталі. Звярніце ўвагу, што
max_glyph_a
іfontsize
значэнне ўключаны ў стy
зрушэнне.drawtext=fontfile=FreeSans.ttf:text=DOG:fontsize=24:x=10:y=20+24-max_glyph_a, drawtext=fontfile=FreeSans.ttf:text=cow:fontsize=24:x=80:y=20+24-max_glyph_a
- Нанесці спецыяльныя
lavf.image2dec.source_basename
метаданыя на кожны кадр, калі такія метаданыя існуюць. У адваротным выпадку нанясіце радок "NA". Звярніце ўвагу, што дэмультыфікатар image2 павінен мець опцыю-export_path_metadata 1
каб спецыяльныя палі метададзеных былі даступныя для фільтраў.drawtext="fontsize=20:fontcolor=white:fontfile=FreeSans.ttf:text='%{metadata\:lavf.image2dec.source_basename\:NA}':x=10:y=10"
Для атрымання дадатковай інфармацыі пра libfreetype праверце: http://www.freetype.org/ .
Для атрымання дадатковай інфармацыі пра fontconfig праверце: http://freedesktop.org/software/fontconfig/fontconfig-user.html .
Для атрымання дадатковай інфармацыі аб libfribidi праверце: http://fribidi.org/ .
11.73 edgedetect
Выяўляць і маляваць краю. Фільтр выкарыстоўвае алгарытм Canny Edge Detection.
Фільтр прымае наступныя параметры:
low
high
Усталюйце нізкія і высокія парогавыя значэнні, якія выкарыстоўваюцца парогавым алгарытмам Canny.
Высокі парог выбірае "моцныя" краявыя пікселі, якія затым злучаюцца праз 8-сувязь са "слабымі" краявымі пікселямі, выбранымі нізкім парогам.
low
іhigh
парогавыя значэнні павінны быць выбраны ў дыяпазоне [0,1] іlow
павінны быць меншымі або роўныміhigh
.Значэнне па змаўчанні для
low
,20/255
а значэнне па змаўчанніhigh
для50/255
.mode
Вызначце рэжым малявання.
- '
wires
' Намалюйце белы/шэры драты на чорным фоне.
- '
colormix
' Змяшайце колеры, каб стварыць эфект фарбы/мультфільма.
- '
canny
' Прымяніце дэтэктар краёў Canny на ўсіх выбраных плоскасцях.
Значэнне па змаўчанні -
wires
.- '
planes
Выберыце плоскасці для фільтрацыі. Па змаўчанні ўсе даступныя самалёты адфільтраваны.
11.73.1 Examples
- Стандартнае вызначэнне краёў з карыстальніцкімі значэннямі для парогавага значэння гістэрэзісу:
edgedetect=low=0.1:high=0.4
- Эфект афарбоўкі без парогаў:
edgedetect=mode=colormix:high=0
11.74 elbg
Прымяніць эфект постэрызацыі з дапамогай алгарытму ELBG (палепшаны LBG).
Для кожнага ўваходнага відарыса фільтр вылічыць аптымальнае адлюстраванне ўваходу і вываду з улікам даўжыні кодавай кнігі, гэта значыць колькасці розных выходных колераў.
Гэты фільтр прымае наступныя параметры.
codebook_length, l
Задаць даўжыню кодавай кнігі. Значэнне павінна быць цэлым дадатным лікам і ўяўляць колькасць розных выходных колераў. Значэнне па змаўчанні - 256.
nb_steps, n
Усталюйце максімальную колькасць ітэрацый для вылічэння аптымальнага адлюстравання. Чым вышэй значэнне, тым лепшы вынік і большы час вылічэння. Значэнне па змаўчанні - 1.
seed, s
Усталюйце выпадковае пачатковае значэнне, яно павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.
pal8
Задаць фармат выхаднога пікселя pal8. Гэты параметр не працуе з даўжынёй кнігі кодаў больш за 256. Па змаўчанні выключана.
use_alpha
Уключыце альфа-значэнні ў разлік квантавання. Дазваляе ствараць палетзіраваныя выходныя выявы (напрыклад, PNG8) са шматразовым альфа-плаўным змешваннем.
11.75 entropy
Вымерайце энтрапію ўзроўню шэрага ў гістаграме каляровых каналаў відэакадраў.
Ён прымае наступныя параметры:
mode
Можа быць або
normal
абоdiff
. Па змаўчанніnormal
.diff
рэжым вымярае энтрапію дэльта-значэнняў гістаграмы, абсалютныя адрозненні паміж суседнімі значэннямі гістаграмы.
11.76 epx
Прымяніце фільтр павелічэння EPX, прызначаны для піксельнага мастацтва.
Ён прымае наступны варыянт:
n
Задаць памернасць маштабавання:
2
для2xEPX
,3
для3xEPX
. Па змаўчанні3
.
11.77 eq
Усталюйце яркасць, кантраснасць, насычанасць і прыблізную рэгуляванне гамы.
Фільтр прымае наступныя параметры:
contrast
Усталюйце выраз кантрасту. Значэнне павінна быць значэннем з плаваючай часткай у дыяпазоне
-1000.0
да1000.0
. Значэнне па змаўчанні - "1".brightness
Усталюйце выраз яркасці. Значэнне павінна быць значэннем з плаваючай часткай у дыяпазоне
-1.0
да1.0
. Значэнне па змаўчанні - "0".saturation
Задайце выраз насычанасці. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.0
да3.0
. Значэнне па змаўчанні - "1".gamma
Усталюйце гама-выраз. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.1
да10.0
. Значэнне па змаўчанні - "1".gamma_r
Усталюйце гама-выраз для чырвонага. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.1
да10.0
. Значэнне па змаўчанні - "1".gamma_g
Усталюйце гама-выраз для зялёнага. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.1
да10.0
. Значэнне па змаўчанні - "1".gamma_b
Усталюйце гама-выраз для сіняга. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.1
да10.0
. Значэнне па змаўчанні - "1".gamma_weight
Усталюйце гама-вагавы выраз. Яго можна выкарыстоўваць, каб паменшыць уплыў высокага значэння гама на яркія ўчасткі выявы, напрыклад, прадухіліць іх празмернае ўзмацненне і проста белы колер. Значэнне павінна быць з плаваючай часткай у дыяпазоне
0.0
да1.0
. Значэнне0.0
цалкам зніжае гама-карэкцыю, пакідаючы1.0
яе на поўную сілу. Па змаўчанні - "1".eval
Устанавіце, калі вылічваюцца выразы яркасці, кантраснасці, насычанасці і гама.
Ён прымае наступныя значэнні:
- '
init
' вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды
- '
frame
' ацэньваць выразы для кожнага ўваходнага кадра
Значэнне па змаўчанні '
init
'.- '
Выразы прымаюць наступныя параметры:
n
колькасць кадраў уваходнага кадра, пачынаючы з 0
pos
байтавая пазіцыя адпаведнага пакета ва ўваходным файле, NAN, калі не вызначана
r
частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая
t
пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая
11.77.1 Commands
Фільтр падтрымлівае наступныя каманды:
contrast
Усталюйце выраз кантрасту.
brightness
Усталюйце выраз яркасці.
saturation
Задайце выраз насычанасці.
gamma
Усталюйце гама-выраз.
gamma_r
Усталюйце выраз gamma_r.
gamma_g
Задаць выраз gamma_g.
gamma_b
Задаць выраз gamma_b.
gamma_weight
Задаць выраз gamma_weight.
Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.78 erosion
Прымяніць эфект эрозіі да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) мінімумам.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.
coordinates
Сцяг, які вызначае піксель, на які трэба спасылацца. Па змаўчанні 255, гэта значыць выкарыстоўваюцца ўсе восем пікселяў.
Сцягі на мясцовых картах з каардынатамі 3x3, як гэта:
1 2 3 4 5 6 7 8
11.78.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.79 estdif
Дэінтэрлейсаванне ўваходнага відэа ("estdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу трасіроўкі краёў").
Толькі прасторавы фільтр, які выкарыстоўвае алгарытм адсочвання нахілу краю для інтэрпаляцыі адсутных ліній. Ён прымае наступныя параметры:
mode
Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:
frame
Вывесці па адным кадры для кожнага кадра.
field
Вывесці па адным кадры для кожнага поля.
Значэнне па змаўчанні -
field
.parity
Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:
tff
Выкажам здагадку, што верхняе поле - першае.
bff
Выкажам здагадку, што ніжняе поле з'яўляецца першым.
auto
Уключыць аўтаматычнае вызначэнне парытэту поля.
Значэнне па змаўчанні -
auto
. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.deint
Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:
all
Дэінтэрлейс усіх кадраў.
interlaced
Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.
Значэнне па змаўчанні -
all
.rslope
Укажыце радыус пошуку для трасіроўкі кантавых схілаў. Значэнне па змаўчанні - 1. Дазволены дыяпазон ад 1 да 15.
redge
Укажыце радыус пошуку для лепшага супадзення краёў. Значэнне па змаўчанні - 2. Дазволены дыяпазон - ад 0 да 15.
ecost
Укажыце кошт краю для супадзення краю. Значэнне па змаўчанні 1,0. Дазволены дыяпазон ад 0 да 9.
mcost
Укажыце сярэдні кошт для супадзення краёў. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.
dcost
Укажыце кошт адлегласці для супадзення краёў. Значэнне па змаўчанні 0,5. Дазволены дыяпазон ад 0 да 1.
interp
Укажыце выкарыстоўваную інтэрпаляцыю. Па змаўчанні ўстаноўлена 4-кропкавая інтэрпаляцыя. Ён прымае адно з наступных значэнняў:
2p
Двухкропкавая інтэрпаляцыя.
4p
Чатырохкропкавая інтэрпаляцыя.
6p
Шасцікропкавая інтэрпаляцыя.
11.79.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.80 exposure
Адрэгулюйце экспазіцыю відэаструменю.
Фільтр прымае наступныя параметры:
exposure
Усталюйце карэкцыю экспазіцыі ў EV. Дазволены дыяпазон ад -3,0 да 3,0 EV Значэнне па змаўчанні - 0 EV.
black
Усталюйце карэкцыю ўзроўню чорнага. Дазволены дыяпазон ад -1,0 да 1,0. Значэнне па змаўчанні 0.
11.80.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.81 extractplanes
Вылучыце кампаненты каляровага канала з уваходнага відэапатоку ў асобныя відэапатокі адценняў шэрага.
Фільтр прымае наступныя параметры:
planes
Усталюйце плоскасць(-і) для здабывання.
Даступныя значэнні для самалётаў:
- '
y
' - '
u
' - '
v
' - '
a
' - '
r
' - '
g
' - '
b
'
Выбар самалётаў, недаступных ва ўваходных дадзеных, прывядзе да памылкі. Гэта азначае, што вы не можаце адначасова выбраць
r
,g
,b
плоскасці зy
,u
, плоскасцямі.v
- '
11.81.1 Examples
- Вылучыце кампаненты каляровага канала яркасці, u і v з уваходнага відэакадра ў 3 выхады ў адценнях шэрага:
ffmpeg -i video.avi -filter_complex 'extractplanes=y+u+v[y][u][v]' -map '[y]' y.avi -map '[u]' u.avi -map '[v]' v.avi
11.82 fade
Прымяніць эфект знікнення да ўваходнага відэа.
Ён прымае наступныя параметры:
type, t
Тып эфекту можа быць альбо "ўваходзіць" для знікнення, альбо "выхад" для знікнення. Па змаўчанні
in
.start_frame, s
Укажыце нумар кадра, з якога трэба пачаць прымяненне эфекту знікнення. Па змаўчанні 0.
nb_frames, n
Колькасць кадраў, на працягу якіх доўжыцца эфект знікнення. У канцы эфекту знікнення выхадное відэа будзе мець такую ​​ж інтэнсіўнасць, што і ўваходнае відэа. У канцы пераходу з знікненнем выходнае відэа будзе запоўнена выбраным
color
. Па змаўчанні 25.alpha
Калі ўстаноўлена значэнне 1, знікае толькі альфа-канал, калі ён ёсць на ўваходзе. Значэнне па змаўчанні 0.
start_time, st
Укажыце метку часу (у секундах) кадра, каб пачаць прымяняць эфект знікнення. Калі зададзены як start_frame, так і start_time, заміранне пачнецца з таго, што наступіць апошнім. Па змаўчанні 0.
duration, d
Колькасць секунд, на працягу якіх павінен працягвацца эфект знікнення. У канцы эфекту знікнення выхадное відэа будзе мець такую ​​ж інтэнсіўнасць, што і ўваходнае відэа, у канцы знікнення выхадное відэа будзе запоўнена выбраным
color
. Калі ўказаны і працягласць, і nb_frames, выкарыстоўваецца працягласць. Па змаўчанні 0 (па змаўчанні выкарыстоўваецца nb_frames).color, c
Укажыце колер выцвітання. Па змаўчанні - "чорны".
11.82.1 Examples
- Змяншэнне ў першых 30 кадрах відэа:
fade=in:0:30
Каманда вышэй эквівалентная:
fade=t=in:s=0:n=30
- Змяншэнне апошніх 45 кадраў 200-кадравага відэа:
fade=out:155:45 fade=type=out:start_frame=155:nb_frames=45
- Памяншэнне першых 25 кадраў і знікненне апошніх 25 кадраў 1000-кадравага відэа:
fade=in:0:25, fade=out:975:25
- Зрабіце першыя 5 кадраў жоўтымі, затым знікніце з кадраў 5-24:
fade=in:5:20:color=yellow
- Змяншэнне ў альфа-версіі па першых 25 кадрах відэа:
fade=in:0:25:alpha=1
- Зрабіце першыя 5,5 секунды чорнымі, затым знікніце на 0,5 секунды:
fade=t=in:st=5.5:d=0.5
11.83 feedback
Прымяніць відэафільтр зваротнай сувязі.
Гэты фільтр перадае абрэзаныя ўваходныя кадры на другі выхад. Адтуль яго можна фільтраваць іншымі відэафільтрамі. Пасля таго, як фільтр атрымае кадр з 2-га ўваходу, гэты кадр аб'ядноўваецца паверх зыходнага кадра з 1-га ўваходу і перадаецца на 1-ы выхад.
Тыповае выкарыстанне - фільтраваць толькі частку кадра.
Фільтр прымае наступныя параметры:
x
y
Усталюйце верхняе левае становішча кадравання.
w
h
Усталюйце памер кадравання.
11.83.1 Examples
- Размыць толькі верхнюю левую прастакутную частку відэакадра памерам 100x100 з дапамогай фільтра gblur.
[in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]gblur=8[blurin]
- Намалюйце чорную скрынку ў верхняй левай частцы відэакадра памерам 100x100 з фільтрам Drawbox.
[in][blurin]feedback=x=0:y=0:w=100:h=100[out][blurout];[blurout]drawbox=x=0:y=0:w=100:h=100:t=100[blurin]
11.84 fftdnoiz
Шумаць кадры з дапамогай 3D БПФ (фільтрацыя ў частотнай вобласці).
Фільтр прымае наступныя параметры:
sigma
Усталюйце сігма-канстанту шуму. Гэта задае сілу шумашумлення. Значэнне па змаўчанні - 1. Дазволены дыяпазон - ад 0 да 30. Выкарыстанне вельмі высокай сігмы з нізкім перакрыццем можа выклікаць артэфакты блакіроўкі.
amount
Усталюйце колькасць шумашумлення. Па змаўчанні ўсе выяўленыя шумы памяншаюцца. Значэнне па змаўчанні - 1. Дазволены дыяпазон - ад 0 да 1.
block
Усталюйце памер блока ў пікселях, па змаўчанні 32, можа быць ад 8 да 256.
overlap
Усталюйце перакрыцце блокаў. Па змаўчанні 0,5. Дапушчальны дыяпазон ад 0,2 да 0,8.
method
Усталюйце метад шумашумлення. Па змаўчанні
wiener
, таксама можа быцьhard
.prev
Усталюйце колькасць папярэдніх кадраў для выкарыстання для выдалення шуму. Па змаўчанні ўстаноўлена 0.
next
Усталюйце колькасць наступных кадраў, якія будуць выкарыстоўвацца для выдалення шуму. Па змаўчанні ўстаноўлена 0.
planes
Усталюйце плоскасці, якія будуць адфільтраваныя, па змаўчанні ўсе даступныя адфільтраваныя, акрамя альфа.
11.85 fftfilt
Прымяненне адвольных выразаў да ўзораў у частотнай вобласці
dc_Y
Адрэгулюйце значэнне пастаяннага току (узмацненне) плоскасці яркасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне
0
да1000
. Па змаўчанні ўстаноўлена значэнне0
.dc_U
Адрэгулюйце значэнне пастаяннага току (узмацненне) 1-й плоскасці каляровасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне
0
да1000
. Па змаўчанні ўстаноўлена значэнне0
.dc_V
Адрэгулюйце значэнне пастаяннага току (узмацненне) 2-й плоскасці каляровасці выявы. Фільтр прымае цэлае значэнне ў дыяпазоне
0
да1000
. Па змаўчанні ўстаноўлена значэнне0
.weight_Y
Задайце вагавы выраз частотнай вобласці для плоскасці яркасці.
weight_U
Усталюйце вагавы выраз частотнай вобласці для 1-й каляровай плоскасці.
weight_V
Усталюйце вагавы выраз частотнай вобласці для 2-й каляровай плоскасці.
eval
Устанавіце, калі вылічваюцца выразы.
Ён прымае наступныя значэнні:
- '
init
' Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра.
- '
frame
' Ацаніце выразы для кожнага ўваходнага кадра.
Значэнне па змаўчанні '
init
'.Фільтр прымае наступныя зменныя:
- '
X
Y
Каардынаты бягучай выбаркі.
W
H
Шырыня і вышыня выявы.
N
Нумар уваходнага кадра, пачынаючы з 0.
WS
HS
Памер масіва FFT для гарызантальнай і вертыкальнай апрацоўкі.
11.85.1 Examples
- Высокія частоты:
fftfilt=dc_Y=128:weight_Y='squish(1-(Y+X)/100)'
- Нізкія частоты:
fftfilt=dc_Y=0:weight_Y='squish((Y+X)/100-1)'
- Рэзкасць:
fftfilt=dc_Y=0:weight_Y='1+squish(1-(Y+X)/100)'
- Размыццё:
fftfilt=dc_Y=0:weight_Y='exp(-4 * ((Y+X)/(W+H)))'
11.86 field
Вылучыце адно поле з празрадковай выявы, выкарыстоўваючы крокавую арыфметыку, каб не марнаваць працэсарны час. Выхадныя кадры пазначаны як непразрадковыя.
Фільтр прымае наступныя параметры:
type
Укажыце, ці варта выняць верхняе (калі значэнне
0
абоtop
) або ніжняе поле (калі значэнне1
абоbottom
).
11.87 fieldhint
Стварыце новыя кадры, скапіраваўшы верхняе і ніжняе палі з навакольных кадраў, прадстаўленых у выглядзе лічбаў у файле падказкі.
hint
Усталяваць файл, які змяшчае падказкі: абсалютныя/адносныя нумары кадраў.
Для кожнага кадра ў кліпе павінен быць адзін радок. Кожны радок павінен змяшчаць дзве лічбы, падзеленыя коскай, за якімі варта
-
або+
. Лічбы, прыведзеныя ў кожным радку файла, не могуць быць за межамі [N-1,N+1], дзе N - нумар бягучага кадра дляabsolute
рэжыму, або за межамі дыяпазону [-1, 1] дляrelative
рэжыму. Першая лічба паказвае, з якога кадра трэба выбраць верхняе поле, а другая лічба паказвае, з якога кадра выбраць ніжняе поле.Калі неабавязкова ідзе
+
выхадны кадр, ён будзе пазначаны як празрадковы, у адваротным выпадку, калі за ім ідзе-
выхадны кадр, будзе пазначаны як прагрэсіўны, у адваротным выпадку ён будзе пазначаны як уваходны кадр. Калі пасля гэтага неабавязкова ідзеt
рамка вываду, будзе выкарыстоўвацца толькі верхняе поле, або ў выпадкуb
гэтага будзе выкарыстоўвацца толькі ніжняе поле. Калі радок пачынаецца з#
або;
гэты радок прапускаецца.mode
Можа быць item
absolute
orrelative
orpattern
. Па змаўчанніabsolute
. Рэжымpattern
такі ж, як іrelative
рэжым, за выключэннем моманту апошняга ўводу файла, калі трэба апрацаваць больш кадраў, чымhint
файл шукае назад, каб пачаць.
Прыклад першых некалькіх радкоў hint
файла для relative
рэжыму:
0,0 - # first frame
1,0 - # second frame, use third's frame top field and second's frame bottom field
1,0 - # third frame, use fourth's frame top field and third's frame bottom field
1,0 -
0,0 -
0,0 -
1,0 -
1,0 -
1,0 -
0,0 -
0,0 -
1,0 -
1,0 -
1,0 -
0,0 -
11.88 fieldmatch
Фільтр супадзення палёў для зваротнага тэлекіно. Ён прызначаны для рэканструкцыі прагрэсіўных кадраў з тэлекінопатоку. Фільтр не выдаляе дубляваныя кадры, таму для дасягнення поўнага зваротнага тэлекіно fieldmatch
павінен суправаджацца фільтр прарэжвання, напрыклад прарэжванне ў фільтраграфе .
Раздзяленне супастаўлення палёў і дэцымацыі асабліва матывавана магчымасцю ўстаўкі паміж імі рэзервовага фільтра дэпляменнай разгорткі. Калі ў крыніцы ёсць змешаны тэлекіно і рэальны празрадковы кантэнт,
fieldmatch
не атрымаецца супаставіць палі для частак празрадковай разгорткі. Але гэтыя астатнія камбінаваныя кадры будуць пазначаны як празрадковыя, і, такім чынам, перад дэцымацыямі іх можна будзе пазбавіць ад празрадковай разгорткі наступным фільтрам, такім як yadif .
У дадатак да розных опцый канфігурацыі, fieldmatch
можна прыняць дадатковы другі паток, актываваны празppsrc
варыянт. Калі ўключана, рэканструкцыя кадраў будзе грунтавацца на палях і кадрах з гэтага другога патоку. Гэта дазваляе папярэдне апрацаваць першы ўвод, каб дапамагчы розным алгарытмам фільтра, захоўваючы пры гэтым выхад без страт (пры ўмове, што палі супадаюць правільна). Як правіла, можа дапамагчы дэшуйзер з улікам поля або рэгуляванне яркасці/кантрастнасці.
Звярніце ўвагу, што гэты фільтр выкарыстоўвае тыя ж алгарытмы, што і TIVTC/TFM (праект AviSynth) і VIVTC/VFM (праект VapourSynth). Апошні з'яўляецца лёгкім клонам TFM fieldmatch
, на аснове якога. Нягледзячы на ​​тое, што семантыка і выкарыстанне вельмі блізкія, некаторыя паводзіны і назвы параметраў могуць адрознівацца.
У цяперашні час дэцымацыйны фільтр працуе толькі для пастаяннай частаты кадраў. Калі ваш увод змяшчае змешаны тэлекінаграфічны (30 кадраў у секунду) і прагрэсіўны кантэнт з меншай частатой кадраў, напрыклад 24 кадры ў секунду, выкарыстоўвайце наступны ланцужок фільтраў для стварэння неабходнага патоку cfr: dejudder,fps=30000/1001,fieldmatch,decimate
.
Фільтр прымае наступныя параметры:
order
Укажыце меркаваны парадак палёў уваходнага патоку. Даступныя значэнні:
- '
auto
' Аўтаматычнае вызначэнне цотнасці (выкарыстоўвайце ўнутранае значэнне цотнасці FFmpeg).
- '
bff
' Выкажам здагадку, спачатку ніжняе поле.
- '
tff
' Выкажам здагадку, спачатку верхняе поле.
Звярніце ўвагу, што часам рэкамендуецца не давяраць парытэту, абвешчанаму патокам.
Значэнне па змаўчанні -
auto
.- '
mode
Усталюйце рэжым супадзення або стратэгію для выкарыстання.
pc
рэжым з'яўляецца самым бяспечным у тым сэнсе, што ён не рызыкуе стварыць рэзкасць з-за дублікатаў кадраў, калі гэта магчыма, але калі ёсць дрэнныя праўкі або змешаныя палі, ён у канчатковым выніку выводзіць кадры з грэбнем, калі сапраўды можа існаваць добрае супадзенне. З другога боку,pcn_ub
рэжым з'яўляецца найбольш рызыкоўным з пункту гледжання стварэння рыўкоў, але амаль заўсёды можна знайсці добры кадр, калі ён ёсць. Астатнія каштоўнасці знаходзяцца дзесьці пасярэдзінеpc
іpcn_ub
з пункту гледжання рызыкі рыўкоў і стварэння дублікатаў кадраў у параўнанні з пошукам добрых супадзенняў у раздзелах з дрэннымі рэдагаваннямі, асірацелымі палямі, змешанымі палямі і г.д.Больш падрабязную інфармацыю аб p/c/n/u/b можна знайсці ў раздзеле значэнняў p/c/n/u/b .
Даступныя значэнні:
- '
pc
' 2-баковае адпаведнасць (p/c)
- '
pc_n
' 2-баковае супадзенне і спроба 3-га супадзення, калі ўсё яшчэ расчэсаны (p/c + n)
- '
pc_u
' 2-баковае супадзенне і спроба 3-га супадзення (той жа парадак), калі ўсё яшчэ расчэсваецца (p/c + u)
- '
pc_n_ub
' 2-баковае супадзенне, спроба 3-га супадзення, калі ўсё яшчэ расчэсваецца, і спроба 4-га/5-га супадзення, калі ўсё яшчэ расчэсваецца (p/c + n + u/b)
- '
pcn
' 3-баковае адпаведнасць (п/к/н)
- '
pcn_ub
' 3-баковае супадзенне і спроба 4-га/5-га супадзенняў, калі ўсе 3 арыгінальныя супадзенні вызначаюцца як счэсаныя (p/c/n + u/b)
Дужкі ў канцы паказваюць супадзенні, якія будуць выкарыстоўвацца для гэтага рэжыму
order
=tff
(іfield
наauto
абоtop
).З пункту гледжання хуткасці
pc
рэжым, безумоўна, самы хуткі іpcn_ub
з'яўляецца самым павольным.Значэнне па змаўчанні -
pc_n
.- '
ppsrc
Адзначце асноўны ўваходны паток як папярэдне апрацаваны ўваход і ўключыце другасны ўваходны паток як чыстую крыніцу для выбару палёў. Для атрымання дадатковай інфармацыі глядзіце ўвядзенне ў фільтр. Гэта падобна на
clip2
функцыя ад VFM/TFM.Значэнне па змаўчанні
0
(адключана).field
Усталюйце поле для супадзення. Рэкамендуецца ўсталяваць такое ж значэнне, што і
order
калі вы не сутыкнецеся з няўдачамі пры супадзенні з гэтай наладай. У пэўных абставінах змяненне поля, якое выкарыстоўваецца для супастаўлення, можа моцна паўплываць на прадукцыйнасць супастаўлення. Даступныя значэнні:- '
auto
' Аўтаматычна (тое ж значэнне, што і
order
).- '
bottom
' Матч з ніжняга поля.
- '
top
' Матч з верхняга поля.
Значэнне па змаўчанні -
auto
.- '
mchroma
Устанавіце, ці будзе каляровасць уключана падчас параўнання матчаў. У большасці выпадкаў рэкамендуецца пакінуць гэта ўключаным. Варта ўсталяваць гэтае значэнне
0
толькі ў тым выпадку, калі ваш кліп мае дрэнныя праблемы каляровасці, такія як моцная вясёлка або іншыя артэфакты. Усталяванне гэтага0
значэння таксама можа быць выкарыстана для паскарэння працы за кошт пэўнай дакладнасці.Значэнне па змаўчанні -
1
.y0
y1
Яны вызначаюць паласу выключэння, якая выключае лініі паміж імі
y0
іy1
ад уключэння ў рашэнне аб адпаведнасці палёў. Паласа выключэння можа выкарыстоўвацца для ігнаравання субтытраў, лагатыпа або іншых рэчаў, якія могуць перашкаджаць супастаўленню.y0
задае пачатковы радок сканавання іy1
задае канчатковую лінію; усе лініі паміж іміy0
іy1
(у тым лікуy0
іy1
) будзе праігнараваны. Абстаноўкаy0
іy1
да таго ж значэння адключыць функцыю.y0
іy1
па змаўчанні0
.scthresh
Усталюйце парог выяўлення змены сцэны ў працэнтах ад максімальнай змены на плоскасці яркасці. Добрыя значэння знаходзяцца ў
[8.0, 14.0]
дыяпазоне. Выяўленне змены сцэны актуальна толькі ў выпадкуcombmatch
=sc
. Асартымент дляscthresh
ёсць[0.0, 100.0]
.Значэнне па змаўчанні -
12.0
.combmatch
Калі
combatch
не з'яўляецца , пры прыняцці рашэння аб тым, які матч выкарыстоўваць у якасці фінальнага матчаnone
,fieldmatch
будуць улічвацца ацэнкі балаў матчаў. Даступныя значэнні:- '
none
' Няма канчатковага супастаўлення на аснове ацэнак.
- '
sc
' Камбінаваныя балы выкарыстоўваюцца толькі пры выяўленні змены сцэны.
- '
full
' Увесь час выкарыстоўвайце прычэсаныя балы.
Па змаўчанні
sc
.- '
combdbg
Прымусіць
fieldmatch
вылічыць апрацаваныя метрыкі для пэўных супадзенняў і раздрукаваць іх. Гэты параметр вядомы якmicout
у TFM/VFM лексіцы. Даступныя значэнні:- '
none
' Без прымусовага разліку.
- '
pcn
' Сілавыя п/к/н разлікі.
- '
pcnub
' Прымусовыя разлікі p/c/n/u/b.
Значэнне па змаўчанні -
none
.- '
cthresh
Гэта парог абчэсвання вобласці, які выкарыстоўваецца для выяўлення абчэсаных кадраў. Гэта, па сутнасці, кантралюе, наколькі «моцным» або «бачным» павінна быць расчэсванне, каб яно было выяўлена. Большыя значэнні азначаюць, што расчэсванне павінна быць больш прыкметным, а меншыя значэнні азначаюць, што расчэсванне можа быць менш прыкметным або моцным і ўсё роўна быць выяўленым. Дапушчальныя налады ад
-1
(кожны піксель будзе вызначацца як расчасаны) да255
(ні адзін піксель не будзе вызначацца як расчасаны). У асноўным гэта значэнне розніцы ў пікселях. Добры дыяпазон - гэта[8, 12]
.Значэнне па змаўчанні -
9
.chroma
Усталёўвае, ці ўлічваецца каляровасць у вырашэнні камбінаванага кадра. Адключайце гэта толькі ў тым выпадку, калі ў вашай крыніцы ёсць праблемы з каляровасцю (вясёлка і г.д.), якія выклікаюць праблемы з выяўленнем грэбнёвага кадра з уключанай каляровасцю. Уласна, выкарыстоўваючы
chroma
=0
звычайна больш надзейны, за выключэннем выпадку, калі ў крыніцы ёсць толькі расчэсванне каляровасці.Значэнне па змаўчанні -
0
.blockx
blocky
Адпаведна ўсталюйце памеры па восі X і Y для акна, якое выкарыстоўваецца падчас выяўлення камбінаванай рамкі. Гэта звязана з памерам тэрыторыі, у якой
combpel
пікселі павінны быць выяўленыя як расчэсаныя, каб кадр быў аб'яўлены расчэсаным. Глядзіцеcombpel
апісанне параметраў для атрымання дадатковай інфармацыі. Магчымыя значэнні - любы лік, які з'яўляецца ступенню 2, пачынаючы з 4 і заканчваючы 512.Значэнне па змаўчанні -
16
.combpel
Колькасць абчасаных пікселяў у любым з
blocky
паblockx
блокі памеру на раме, каб рама была выяўлена як ачэсаная. Пакульcthresh
кантралюе, наколькі "бачным" павінна быць расчэсванне, гэты параметр кантралюе, "колькі" расчэсваннем павінна быць у любой лакалізаванай вобласці (акно, вызначанаеblockx
іblocky
налады) на раме. Мінімальнае значэнне роўна,0
а максімальнае роўнаblocky x blockx
(у гэты момант кадры ніколі не будуць вызначацца як абчэсаныя). Гэты параметр вядомы якMI
у TFM/VFM лексіцы.Значэнне па змаўчанні -
80
.
11.88.1 p/c/n/u/b meaning
11.88.1.1 p/c/n
Мы мяркуем, што наступны тэлекіно паток:
Top fields: 1 2 2 3 4
Bottom fields: 1 2 3 4 4
Лічбы адпавядаюць прагрэсіўнай рамцы, да якой адносяцца палі. Тут першыя дзве рамкі - прагрэсіўныя, 3-я і 4-я - начесанные і г.д.
Калі fieldmatch
настроена на запуск супастаўлення знізу (field
= bottom
) вось як трансфармуецца гэты ўваходны паток:
Input stream:
T 1 2 2 3 4
B 1 2 3 4 4 <-- matching reference
Matches: c c n n c
Output stream:
T 1 2 3 4 4
B 1 2 3 4 4
У выніку супастаўлення палёў мы бачым, што некаторыя кадры дублююцца. Каб выканаць поўнае зваротнае тэлекіно, вам трэба спадзявацца на дэцымацыйны фільтр пасля гэтай аперацыі. Глядзіце, напрыклад, фільтр дэцымацыі .
Тая ж аперацыя цяпер супадае з верхніх палёў (field
= top
) выглядае так:
Input stream:
T 1 2 2 3 4 <-- matching reference
B 1 2 3 4 4
Matches: c c p p c
Output stream:
T 1 2 2 3 4
B 1 2 2 3 4
У гэтых прыкладах мы бачым, што p
, c
і n
азначае; у асноўным яны адносяцца да кадра і поля супрацьлеглага парытэту:
-
p
супадае з полем процілеглай цотнасці ў папярэднім кадры -
c
супадае з полем процілеглай цотнасці ў бягучым кадры -
n
супадае з полем процілеглай цотнасці ў наступным кадры
11.88.1.2 u/b
Супастаўленне і крыху асаблівае ў тым сэнсе, што яны супадаюць з супрацьлеглым сцягам цотнасці u
. b
У наступных прыкладах мы мяркуем, што зараз супадаем з 2-м кадрам (зверху:2, знізу:2). У адпаведнасці з супадзеннем над і пад кожным супастаўленым полем ставіцца знак «х».
З ніжнім супадзеннем (field
= bottom
):
Match: c p n b u
x x x x x
Top 1 2 2 1 2 2 1 2 2 1 2 2 1 2 2
Bottom 1 2 3 1 2 3 1 2 3 1 2 3 1 2 3
x x x x x
Output frames:
2 1 2 2 2
2 2 2 1 3
З лепшым супадзеннем (field
= top
):
Match: c p n b u
x x x x x
Top 1 2 2 1 2 2 1 2 2 1 2 2 1 2 2
Bottom 1 2 3 1 2 3 1 2 3 1 2 3 1 2 3
x x x x x
Output frames:
2 2 2 1 2
2 1 3 2 2
11.88.2 Examples
Просты IVTC першага тэлекінапатоку верхняга поля:
fieldmatch=order=tff:combmatch=none, decimate
Пашыраны IVTC, з запасным варыянтам yadif для нерухомых кадраў:
fieldmatch=order=tff:combmatch=full, yadif=deint=interlaced, decimate
11.89 fieldorder
Пераўтварэнне парадку палёў уваходнага відэа.
Ён прымае наступныя параметры:
order
Парадак палёў вываду. Дапушчальныя значэнні
tff
для верхняга поля спачатку абоbff
для ніжняга поля спачатку.
Значэнне па змаўчанні 'tff
'.
Пераўтварэнне ажыццяўляецца шляхам зрушэння змесціва малюнка ўверх ці ўніз на адзін радок і запаўнення пакінутага радка адпаведным зместам малюнка. Гэты метад сумяшчальны з большасцю пераўтваральнікаў парадку палёў трансляцыі.
Калі ўваходнае відэа не пазначана як празрадковае, або яно ўжо пазначана як адпаведнае парадку палёў вываду, гэты фільтр не змяняе ўваходнае відэа.
Гэта вельмі карысна пры пераўтварэнні ў або з матэрыялу PAL DV, які знаходзіцца ў ніжнім полі першым.
Напрыклад:
ffmpeg -i in.vob -vf "fieldorder=bff" out.dv
11.90 fifo, afifo
Буферызаваць ўваходныя выявы і адпраўляць іх, калі яны запытваюцца.
Гэта ў асноўным карысна, калі аўтаматычна ўстаўляецца рамкай libavfilter.
Ён не прымае параметры.
11.91 fillborders
Запаўненне межаў уваходнага відэа без змены памераў відэаструменю. Часам відэа можа мець смецце па чатырох краях, і вы можаце не захацець абрэзаць уваходнае відэа, каб захаваць памер, кратны некатораму ліку.
Гэты фільтр прымае наступныя параметры:
left
Колькасць пікселяў для запаўнення ад левай мяжы.
right
Колькасць пікселяў для запаўнення ад правай мяжы.
top
Колькасць пікселяў для запаўнення ад верхняй мяжы.
bottom
Колькасць пікселяў для запаўнення ад ніжняй мяжы.
mode
Усталюйце рэжым запаўнення.
Ён прымае наступныя значэнні:
- '
smear
' запоўніць пікселі, выкарыстоўваючы крайнія пікселі
- '
mirror
' запаўненне пікселяў з выкарыстаннем люстранога адлюстравання (сіметрычная палова выбаркі)
- '
fixed
' запоўніць пікселі пастаянным значэннем
- '
reflect
' запоўніць пікселі з дапамогай адлюстравання (увесь узор сіметрычны)
- '
wrap
' запоўніць пікселі з дапамогай абцякання
- '
fade
' знікненне пікселяў да пастаяннага значэння
- '
margins
' запоўніць пікселі ўверсе і ўнізе пікселямі ўзважанага сярэдняга значэння каля межаў
Па змаўчанні
smear
.- '
color
Усталюйце колер для пікселяў у фіксаваным рэжыме або рэжыме знікнення. Па змаўчанні
black
.
11.91.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.92 find_rect
Знайдзіце прамавугольны прадмет
Ён прымае наступныя варыянты:
object
Шлях да файла відарыса аб'екта павінен быць шэрым8.
threshold
Парог выяўлення, па змаўчанні 0,5.
mipmaps
Колькасць mipmap, па змаўчанні 3.
xmin, ymin, xmax, ymax
Вызначае прамавугольнік, у якім шукаць.
discard
Адхіляць кадры, дзе аб'ект не выяўлены. Па змаўчанні адключана.
11.92.1 Examples
- Накрыйце прамавугольны аб'ект прадастаўленай выявай дадзенага відэа, выкарыстоўваючы
ffmpeg
:ffmpeg -i file.ts -vf find_rect=newref.pgm,cover_rect=cover.jpg:mode=cover new.mkv
11.93 floodfill
Зона затаплення са значэннямі аднолькавых піксельных кампанентаў іншымі значэннямі.
Ён прымае наступныя варыянты:
x
Усталюйце каардынату піксель х.
y
Задаць каардынату пікселя y.
s0
Задаць значэнне кампанента крыніцы №0.
s1
Задайце значэнне кампанента крыніцы №1.
s2
Задайце значэнне кампанента крыніцы №2.
s3
Задайце значэнне кампанента крыніцы №3.
d0
Задаць значэнне кампанента прызначэння №0.
d1
Задайце значэнне кампанента прызначэння №1.
d2
Задайце значэнне кампанента прызначэння №2.
d3
Задайце значэнне кампанента прызначэння №3.
11.94 format
Пераўтварыце ўваходнае відэа ў адзін з зададзеных піксельных фарматаў. Libavfilter паспрабуе выбраць той, які падыходзіць у якасці ўваходных дадзеных для наступнага фільтра.
Ён прымае наступныя параметры:
pix_fmts
Спіс назваў фарматаў пікселяў, падзелены '|', напрыклад "pix_fmts=yuv420p|monow|rgb24".
11.94.1 Examples
- Пераўтварыце ўваходнае відэа ў
yuv420p
фарматformat=pix_fmts=yuv420p
Пераўтварыце ўваходнае відэа ў любы з фарматаў са спісу
format=pix_fmts=yuv420p|yuv444p|yuv410p
11.95 fps
Пераўтварыце відэа ў зададзеную пастаянную частату кадраў шляхам дубліравання або выключэння кадраў па меры неабходнасці.
Ён прымае наступныя параметры:
fps
Жаданая частата кадраў на выхадзе. Ён прымае выразы, якія змяшчаюць наступныя канстанты:
- '
source_fps
' Частата кадраў уводу
- '
ntsc
' Частата кадраў ntsc
30000/1001
- '
pal
' Частата кадраў PAL
25.0
- '
film
' Частата кадраў фільма
24.0
- '
ntsc_film
' Частата кадраў фільма ntsc
24000/1001
Па змаўчанні -
25
.- '
start_time
Выкажам здагадку, што першы PTS павінен быць зададзеным значэннем у секундах. Гэта дазваляе запоўніць/абрэзаць у пачатку патоку. Па змаўчанні не робяцца здагадкі аб чаканым PTS для першага кадра, таму запаўненне або абрэзка не выконваюцца. Напрыклад, гэта можа быць усталявана ў 0, каб запоўніць пачатак дублікатамі першага кадра, калі відэаплынь пачынаецца пасля аўдыёплыні, або абрэзаць любыя кадры з адмоўным PTS.
round
Метад акруглення часовай меткі (PTS).
Магчымыя значэнні:
zero
акругліць у бок 0
inf
акругліць ад 0
down
круглы ў бок -бясконцасці
up
акругленне да +бясконцасці
near
акругліць да бліжэйшага
Па змаўчанні -
near
.eof_action
Дзеянне, якое выконваецца пры чытанні апошняга кадра.
Магчымыя значэнні:
round
Выкарыстоўвайце той жа метад акруглення меткі часу, што і для іншых кадраў.
pass
Пераход праз апошні кадр, калі працягласць уводу яшчэ не дасягнута.
Па змаўчанні -
round
.
У якасці альтэрнатывы параметры можна задаць як просты радок:
fps
[: start_time
[: round
]].
Глядзіце таксама фільтр setpts .
11.95.1 Examples
- Звычайнае выкарыстанне, каб усталяваць 25 кадраў у секунду:
fps=fps=25
- Усталёўвае кадры ў секунду на 24, выкарыстоўваючы абрэвіятуру і метад акруглення для акруглення да бліжэйшага:
fps=fps=film:round=near
11.96 framepack
Спакуйце два розныя відэапатокі ў стэрэаскапічнае відэа, усталяваўшы правільныя метададзеныя ў падтрымоўваных кодэках. Два віды павінны мець аднолькавы памер і частату кадраў, і апрацоўка спыняецца, калі карацейшае відэа скончыцца. Звярніце ўвагу, што вы можаце зручна наладзіць уласцівасці выгляду з дапамогай фільтраў маштабу і кадраў у секунду.
Ён прымае наступныя параметры:
format
Пажаданы фармат упакоўкі. Падтрымліваюцца наступныя значэнні:
sbs
Віды размешчаны побач адзін з адным (па змаўчанні).
tab
Выгляды адзін на аднаго.
lines
Прагляды спакаваныя па радках.
columns
Прагляды спакаваныя па слупках.
frameseq
Погляды часова перамяжоўваюцца.
Некаторыя прыклады:
# Convert left and right views into a frame-sequential video
ffmpeg -i LEFT -i RIGHT -filter_complex framepack=frameseq OUTPUT
# Convert views into a side-by-side video with the same output resolution as the input
ffmpeg -i LEFT -i RIGHT -filter_complex [0:v]scale=w=iw/2[left],[1:v]scale=w=iw/2[right],[left][right]framepack=sbs OUTPUT
11.97 framerate
Зменіце частату кадраў шляхам інтэрпаляцыі новых кадраў выхаду відэа з зыходных кадраў.
Гэты фільтр не прызначаны для правільнай працы з празрадковай разгорткай. Калі вы жадаеце змяніць частату кадраў у празрадковай разгортцы, вам трэба зрабіць дэінтэрлейс перад гэтым фільтрам і паўторна празрадок пасля гэтага фільтра.
Далей апісваюцца прынятыя варыянты.
fps
Укажыце колькасць кадраў у секунду. Гэтую опцыю таксама можна ўказаць як значэнне. Па змаўчанні -
50
.interp_start
Укажыце пачатак дыяпазону, дзе будзе створаны выхадны кадр у выглядзе лінейнай інтэрпаляцыі двух кадраў. Дыяпазон [
0
-255
], па змаўчанні15
.interp_end
Укажыце канец дыяпазону, дзе будзе створаны выхадны кадр у выглядзе лінейнай інтэрпаляцыі двух кадраў. Дыяпазон [
0
-255
], па змаўчанні240
.scene
Укажыце ўзровень, на якім выяўляецца змена сцэны, як значэнне ад 0 да 100, каб паказаць новую сцэну; нізкае значэнне адлюстроўвае нізкую верагоднасць для бягучага кадра ўвесці новую сцэну, у той час як больш высокае значэнне азначае, што бягучы кадр, хутчэй за ўсё, будзе адзін. Па змаўчанні -
8.2
.flags
Укажыце сцягі, якія ўплываюць на працэс фільтрацыі.
Даступнае значэнне для
flags
:scene_change_detect, scd
Уключыць выяўленне змены сцэны, выкарыстоўваючы значэнне параметра
scene
. Гэты сцяг уключаны па змаўчанні.
11.98 framestep
Выбірайце адзін кадр кожны N-ы кадр.
Гэты фільтр прымае наступныя параметры:
step
Выбірайце кадр пасля кожнага
step
кадра. Дазволеныя значэнні - натуральныя лікі, большыя за 0. Значэнне па змаўчанні -1
.
11.99 freezedetect
Выявіць замарожанае відэа.
Гэты фільтр рэгіструе паведамленне і ўсталёўвае метаданыя кадра, калі выяўляе, што ўваходнае відэа не мае істотных змяненняў у змесце на працягу вызначанага перыяду. Выяўленне завісання відэа вылічае сярэднюю абсалютную розніцу ўсіх кампанентаў відэакадраў і параўноўвае яе з мінімальным шумам.
Надрукаваны час і працягласць выражаны ў секундах. Ключ
lavfi.freezedetect.freeze_start
метаданых усталёўваецца на першым кадры, часовая пазнака якога роўная або перавышае працягласць выяўлення, і змяшчае пазнаку часу першага кадра прыпынку. Ключы метададзеных і
задаюцца на першым кадры пасля прыпынку
lavfi.freezedetect.freeze_duration
.
lavfi.freezedetect.freeze_end
Фільтр прымае наступныя параметры:
noise, n
Усталюйце шумацярпімасць. Можа быць указана ў дБ (у выпадку, калі да зададзенага значэння дадаецца "дБ") або ў якасці каэфіцыента рознасці паміж 0 і 1. Значэнне па змаўчанні - -60 дБ або 0,001.
duration, d
Усталюйце працягласць прыпынку да паведамлення (па змаўчанні 2 секунды).
11.100 freezeframes
Стоп-кадры відэа.
Гэты фільтр замарожвае відэакадры, выкарыстоўваючы кадр з 2-га ўваходу.
Фільтр прымае наступныя параметры:
first
Усталюйце нумар першага кадра, з якога пачнецца прыпынак.
last
Усталюйце нумар апошняга кадра, з якога заканчваецца прыпынак.
replace
Усталюйце колькасць кадраў з 2-га ўваходу, якія будуць выкарыстоўвацца замест замененых кадраў.
11.101 frei0r
Прымяніць эфект frei0r да ўваходнага відэа.
Каб уключыць кампіляцыю гэтага фільтра, вам трэба ўсталяваць загаловак frei0r і наладзіць FFmpeg з дапамогай --enable-frei0r
.
Ён прымае наступныя параметры:
filter_name
Назва эфекту frei0r для загрузкі. Калі зменная асяроддзя
FREI0R_PATH
вызначана, эфект frei0r шукаецца ў кожным з каталогаў, вызначаных спісам, падзеленым двукроп'ем уFREI0R_PATH
. У адваротным выпадку шукаюцца стандартныя шляхі frei0r у наступным парадку:HOME/.frei0r-1/lib/
,/usr/local/lib/frei0r-1/
,/usr/lib/frei0r-1/
.filter_params
Спіс параметраў, падзеленых '|' для перадачы ў эфект frei0r.
Параметр эфекту frei0r можа быць лагічным (яго значэнне роўна "y" або "n"), падвойным, колерам (вызначаным як
R
/ G
/ B
, дзе R
, G
і B
з'яўляюцца лікамі з плаваючай коскай ад 0,0 да 1,0 уключна) або апісанне колеру, як паказана ў раздзеле
(ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils , пазіцыя (зададзеная як X
/ Y
, дзе
X
і Y
- лікі з плаваючай коскай) і/або радок.
Колькасць і тыпы параметраў залежаць ад загружанага эфекту. Калі параметр эфекту не ўказаны, усталёўваецца значэнне па змаўчанні.
11.101.1 Examples
- Ужыеце эфект distort0r, усталяваўшы першыя два двайных параметру:
frei0r=filter_name=distort0r:filter_params=0.5|0.01
- Прымяніце эфект каляровай адлегласці, прымаючы колер у якасці першага параметра:
frei0r=colordistance:0.2/0.3/0.4 frei0r=colordistance:violet frei0r=colordistance:0x112233
- Прымяніце эфект перспектывы, указаўшы верхняе левае і верхняе правае становішча выявы:
frei0r=perspective:0.2/0.2|0.8/0.2
Для атрымання дадатковай інфармацыі глядзіце http://frei0r.dyne.org
11.101.2 Commands
Гэты фільтр падтрымліваеfilter_params
варыянт як каманды .
11.102 fspp
Ужывайце хуткую і простую постапрацоўку. Гэта больш хуткая версія spp .
Ён падзяляе (I)DCT на гарызантальныя/вертыкальныя праходы. У адрозненне ад простага фільтра пост-апрацоўкі, адзін з іх выконваецца адзін раз на блок, а не на піксель. Гэта дазваляе значна больш высокую хуткасць.
Фільтр прымае наступныя параметры:
quality
Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 4-5. Значэнне па змаўчанні -
4
.qp
Прымусова ўсталяваць пастаянны параметр квантавання. Ён прымае цэлы лік у дыяпазоне 0-63. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).
strength
Усталюйце трываласць фільтра. Ён прымае цэлы лік у дыяпазоне ад -15 да 32. Больш нізкія значэнні азначаюць больш дэталяў, але таксама больш артэфактаў, у той час як больш высокія значэнні робяць выяву больш гладкай, але таксама размытай. Значэнне па змаўчанні
0
- аптымальны PSNR.use_bframe_qp
Уключыць выкарыстанне QP з B-Frames, калі ўстаноўлена
1
. Выкарыстанне гэтай опцыі можа выклікаць мігценне, паколькі B-рамкі часта маюць большы QP. Па змаўчанні0
(не ўключана).
11.103 gblur
Прымяніць фільтр размыцця Гаўса.
Фільтр прымае наступныя параметры:
sigma
Усталюйце гарызантальную сігму, стандартнае адхіленне размыцця па Гаўсу. Па змаўчанні
0.5
.steps
Задайце колькасць крокаў для набліжэння Гаўса. Па змаўчанні
1
.planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсе плоскасці адфільтраваныя.
sigmaV
Усталюйце вертыкальную сігму, калі адмоўная, яна будзе такой жа, як
sigma
. Па змаўчанні-1
.
11.103.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды, што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.104 geq
Прымяніць агульнае ўраўненне да кожнага пікселя.
Фільтр прымае наступныя параметры:
lum_expr, lum
Усталюйце выраз яркасці.
cb_expr, cb
Усталюйце выраз колернасці сіняга.
cr_expr, cr
Усталюйце каляровасць чырвонага колеру.
alpha_expr, a
Усталюйце альфа-выраз.
red_expr, r
Усталюйце чырвоны выраз.
green_expr, g
Усталюйце зялёны выраз.
blue_expr, b
Усталюйце сіні выраз.
Каляровая прастора падбіраецца ў адпаведнасці з зададзенымі параметрамі. Калі адзін зlum_expr
,cb_expr
, абоcr_expr
параметры вызначаны, фільтр аўтаматычна выбярэ каляровую прастору YCbCr. Калі адзін зred_expr
,green_expr
, або
blue_expr
указваюцца параметры, будзе абраная каляровая прастора RGB.
Калі адзін з выразаў каляровасці не вызначаны, ён вяртаецца да іншага. Калі альфа-выраз не ўказаны, ён будзе мець непразрыстае значэнне. Калі ні адзін з выразаў каляровасці не ўказаны, яны будуць ацэньвацца як выраз яркасці.
Выразы могуць выкарыстоўваць наступныя зменныя і функцыі:
N
Парадкавы нумар адфільтраванага кадра, пачынаючы з
0
.X
Y
Каардынаты бягучай выбаркі.
W
H
Шырыня і вышыня выявы.
SW
SH
Шкала шырыні і вышыні ў залежнасці ад адфільтраванай плоскасці. Гэта стаўленне паміж адпаведнай колькасцю пікселяў плоскасці яркасці і колькасцю пікселяў у бягучай плоскасці. Напрыклад, для YUV4:2:0 значэнні адносяцца
1,1
да плоскасці яркасці і0.5,0.5
для плоскасцей каляровасці.T
Час бягучага кадра, выражаны ў секундах.
p(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) бягучай плоскасці.lum(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) плоскасці яркасці.cb(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) плоскасці каляровасці рознасці сіняга. Вярнуць 0, калі такой плоскасці няма.cr(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) плоскасці каляровасці чырвонай розніцы. Вярнуць 0, калі такой плоскасці няма.r(x, y)
g(x, y)
b(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) чырвонага/зялёнага/сіняга кампанента. Вярнуць 0, калі такога кампанента няма.alpha(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) альфа-плоскасці. Вярнуць 0, калі такой плоскасці няма.psum(x,y), lumsum(x, y), cbsum(x,y), crsum(x,y), rsum(x,y), gsum(x,y), bsum(x,y), alphasum(x,y)
Сума значэнняў выбаркі ў прамавугольніку ад (0,0) да (x,y), гэта дазваляе атрымаць сумы выбарак у прамавугольніку. Глядзіце функцыі без постфікса сумы.
interpolation
Усталюйце адзін з метадаў інтэрпаляцыі:
nearest, n
bilinear, b
Па змаўчанні білінейны.
Для функцый, калі x
і y
знаходзяцца па-за зонай, значэнне будзе аўтаматычна абрэзана да бліжэйшага краю.
Звярніце ўвагу, што гэты фільтр можа выкарыстоўваць некалькі патокаў, і ў гэтым выпадку кожны зрэз будзе мець свой уласны стан выразу. Калі вы хочаце выкарыстоўваць толькі адзін стан выразу, таму што вашы выразы залежаць ад папярэдняга стану, вам варта абмежаваць колькасць патокаў фільтра да 1.
11.104.1 Examples
- Перавярнуць малюнак па гарызанталі:
geq=p(W-X\,Y)
- Сфармуйце двухмерную сінусоіду з вуглом
PI/3
і даўжынёй хвалі 100 пікселяў:geq=128 + 100*sin(2*(PI/100)*(cos(PI/3)*(X-50*T) + sin(PI/3)*Y)):128:128
- Стварыце мудрагелістае загадкавае рухомае святло:
nullsrc=s=256x256,geq=random(1)/hypot(X-cos(N*0.07)*W/2-W/2\,Y-sin(N*0.09)*H/2-H/2)^2*1000000*sin(N*0.02):128:128
- Стварыце хуткі эфект ціснення:
format=gray,geq=lum_expr='(p(X,Y)+(256-p(X-4,Y-4)))/2'
- Змяніць кампаненты RGB у залежнасці ад пазіцыі пікселя:
geq=r='X/W*r(X,Y)':g='(1-X/W)*g(X,Y)':b='(H-Y)/H*b(X,Y)'
- Стварыце радыяльны градыент таго ж памеру, што і ўваход (гл. таксама фільтр
віньеткі ):
geq=lum=255*gauss((X/W-0.5)*3)*gauss((Y/H-0.5)*3)/gauss(0)/gauss(0),format=gray
11.105 gradfun
Выпраўце артэфакты палос, якія часам уводзяцца ў амаль плоскія вобласці шляхам абразання да 8-бітнай глыбіні колеру. Інтэрпалюйце градыенты, якія павінны ісці там, дзе знаходзяцца паласы, і згладзьце іх.
Ён прызначаны толькі для прайгравання. Не выкарыстоўвайце яго перад сцісканнем са стратамі, таму што пры сціску губляецца дрыганне і вяртаюцца паласы.
Ён прымае наступныя параметры:
strength
Максімальная колькасць, на якую фільтр зменіць любы піксель. Гэта таксама парог для выяўлення амаль плоскіх абласцей. Дапушчальныя значэнні ад 0,51 да 64; значэнне па змаўчанні - 1,2. Значэнні за межамі дыяпазону будуць абрэзаны да сапраўднага дыяпазону.
radius
Раён, да якога трэба падагнаць градыент. Большы радыус забяспечвае больш плыўныя градыенты, але таксама не дазваляе фільтру змяняць пікселі каля дэталёвых абласцей. Дапушчальныя значэння 8-32; значэнне па змаўчанні - 16. Значэнні, якія выходзяць за межы дыяпазону, будуць абрэзаны да сапраўднага дыяпазону.
У якасці альтэрнатывы параметры могуць быць вызначаны ў выглядзе плоскага радка:
strength
[: radius
]
11.105.1 Examples
- Ужывайце фільтр з
3.5
трываласцю і радыусам8
:gradfun=3.5:8
- Укажыце радыус, апускаючы трываласць (якая вернецца да значэння па змаўчанні):
gradfun=radius=8
11.106 graphmonitor
Паказаць розныя статыстычныя дадзеныя фільтра.
З дапамогай гэтага фільтра можна адладжваць поўны графік фільтра. Асабліва праблемы з запаўненнем спасылак фрэймамі ў чарзе.
Фільтр прымае наступныя параметры:
size, s
Усталюйце памер вываду відэа. Па змаўчанні
hd720
.opacity, o
Задаць непразрыстасць відэа. Па змаўчанні
0.9
. Дазволены дыяпазон ад0
да1
.mode, m
Усталюйце рэжым вываду, можа быць
fulll
абоcompact
. Уcompact
рэжыме толькі фільтры з некаторымі кадрамі ў чарзе паказваюць статыстыку.flags, f
Усталюйце сцягі, якія дазваляюць паказваць статыстыку ў відэа.
Даступныя значэнні для сцягоў:
- '
queue
' Адлюстраванне колькасці кадраў у чарзе ў кожнай спасылцы.
- '
frame_count_in
' Адлюстраванне колькасці кадраў, узятых з фільтра.
- '
frame_count_out
' Адлюстраванне колькасці кадраў, выдадзеных з фільтра.
- '
frame_count_delta
' Адлюстраванне дэльта-колькасці кадраў паміж двума вышэйзгаданымі значэннямі.
- '
pts
' Адлюстраванне бягучых адфільтраваных кадраў.
- '
pts_delta
' Адлюстраванне дэльты пунктаў паміж бягучым і папярэднім кадрам.
- '
time
' Адлюстраванне бягучага адфільтраванага часу кадра.
- '
time_delta
' Адлюстраванне дэльты часу паміж бягучым і папярэднім кадрам.
- '
timebase
' Адлюстраванне часовай базы для спасылкі на фільтр.
- '
format
' Адлюстраванне выкарыстанага фармату для спасылкі на фільтр.
- '
size
' Адлюстраванне памеру відэа або колькасці аўдыяканалаў у выпадку, калі аўдыё выкарыстоўваецца па спасылцы фільтра.
- '
rate
' Адлюстроўваць частату кадраў відэа або частату дыскрэтызацыі ў выпадку, калі аўдыё выкарыстоўваецца па спасылцы фільтра.
- '
eof
' Адлюстраванне стану выхаду спасылкі.
- '
sample_count_in
' Адлюстраванне колькасці проб, узятых з фільтра.
- '
sample_count_out
' Адлюстраванне колькасці ўзораў, выдадзеных з фільтра.
- '
sample_count_delta
' Паказаць дэльта-колькасць узораў паміж двума вышэйзгаданымі значэннямі.
- '
rate, r
Усталюйце верхнюю мяжу для хуткасці выхаднога відэа, значэнне па змаўчанні
25
. Гэта гарантыя таго, што частата кадраў выхаднога відэа не будзе вышэй за гэта значэнне.
11.107 grayworld
Фільтр пастаяннасці колеру, які прымяняе колеракарэкцыю на аснове дапушчэння шэрага свету
Алгарытм выкарыстоўвае лінейнае святло, таму ўваходныя даныя павінны быць папярэдне лінеарызаваны (і, магчыма, правільна пазначаны).
ffmpeg -i INPUT -vf zscale=transfer=linear,grayworld,zscale=transfer=bt709,format=yuv420p OUTPUT
11.108 greyedge
Фільтр варыяцый сталасці колеру, які ацэньвае асветленасць сцэны з дапамогай алгарытму шэрага краю і адпаведна карэктуе колеры сцэны.
Глядзіце: https://staff.science.uva.nl/th.gevers/pub/GeversTIP07.pdf
Фільтр прымае наступныя параметры:
difford
Парадак дыферэнцыяцыі, які будзе прымяняцца на месцы здарэння. Павінен быць выбраны ў дыяпазоне [0,2] і значэнне па змаўчанні роўна 1.
minknorm
Параметр Мінкоўскага, які будзе выкарыстоўвацца для разліку адлегласці Мінкоўскага. Павінна быць выбрана ў дыяпазоне [0,20], а значэнне па змаўчанні роўна 1. Усталюйце 0 для атрымання максімальнага значэння замест вылічэння адлегласці Мінкоўскага.
sigma
Стандартнае адхіленне размыцця па Гаўсу, якое будзе прымяняцца да сцэны. Павінен быць выбраны ў дыяпазоне [0,1024.0] і значэнне па змаўчанні = 1. floor(
sigma
* break_off_sigma(3) ) не можа быць роўным 0, каліdifford
больш за 0.
11.108.1 Examples
- Шэры край:
greyedge=difford=1:minknorm=5:sigma=2
- Максімальны край:
greyedge=difford=1:minknorm=0:sigma=2
11.109 guided
Прымяненне кіраванага фільтра для згладжвання з захаваннем краёў, ачышчэння ад замутненняў і гэтак далей.
Фільтр прымае наступныя параметры:
radius
Усталюйце радыус поля ў пікселях. Дазволены дыяпазон ад 1 да 20. Па змаўчанні 3.
eps
Усталюйце параметр рэгулярызацыі (з квадратам). Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.
mode
Усталюйце рэжым фільтра. Можа быць
basic
абоfast
. Па змаўчанніbasic
.sub
Усталюйце каэфіцыент падвыбаркі для
fast
рэжыму. Дыяпазон ад 2 да 64. Па змаўчанні 4. Уbasic
рэжыме субвыбарка не адбываецца.guidance
Усталюйце рэжым навядзення. Можа быць
off
абоon
. Па змаўчанніoff
. Каліoff
, патрабуецца адзін увод. Каліon
, патрабуюцца два ўводы з аднолькавым дазволам і фарматам пікселяў. Другі ўваход служыць кіраўніцтвам.planes
Усталюйце плоскасці для фільтрацыі. Па змаўчанні - толькі першы.
11.109.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.109.2 Examples
- Згладжванне з захаваннем краёў з кіраваным фільтрам:
ffmpeg -i in.png -vf guided out.png
- Выдаленне дымлення, фільтраванне перадачы структуры, паляпшэнне дэталізацыі з дапамогай кіраванага фільтра. Каб стварыць кіруючую выяву, звярніцеся да артыкула "Кіраваная фільтрацыя выявы". Глядзіце: http://kaiminghe.com/publications/pami12guidedfilter.pdf .
ffmpeg -i in.png -i guidance.png -filter_complex guided=guidance=on out.png
11.110 haldclut
Прымяніць Hald CLUT да відэапатоку.
Першы ўваход - гэта відэаструмень для апрацоўкі, а другі - Hald CLUT. Уваход Hald CLUT можа быць простым малюнкам або поўным відэапатокам.
Фільтр прымае наступныя параметры:
clut
Усталяваць, якія відэакадры CLUT будуць апрацоўвацца з другога ўваходнага патоку, можа быць
first
абоall
. Па змаўчанніall
.shortest
Прымусовае спыненне, калі заканчваецца самы кароткі ўвод. Па змаўчанні
0
.repeatlast
Працягнуць прымяненне апошняга CLUT пасля заканчэння патоку. Значэнне
0
адключэння фільтра пасля дасягнення апошняга кадра CLUT. Па змаўчанні1
.
haldclut
таксама мае тыя ж параметры інтэрпаляцыі, што і lut3d (абодва фільтры маюць аднолькавыя ўнутраныя функцыі).
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
Дадатковую інфармацыю аб Hald CLUT можна знайсці на вэб-сайце Эскіла Стынберга (аўтара Hald CLUT) па адрасе http://www.quelsolaar.com/technology/clut.html .
11.110.1 Commands
Гэты фільтр падтрымлівае interp
параметр як каманды .
11.110.2 Workflow examples
11.110.2.1 Hald CLUT video stream
Стварыце ідэнтычнасць Hald CLUT паток зменены з рознымі эфектамі:
ffmpeg -f lavfi -i haldclutsrc=8 -vf "hue=H=2*PI*t:s=sin(2*PI*t)+1, curves=cross_process" -t 10 -c:v ffv1 clut.nut
Заўвага: пераканайцеся, што вы выкарыстоўваеце кодэк без страт.
Затым выкарыстоўвайце яго, haldclut
каб прымяніць да нейкага выпадковага патоку:
ffmpeg -f lavfi -i mandelbrot -i clut.nut -filter_complex '[0][1] haldclut' -t 20 mandelclut.mkv
Hald CLUT будзе прымяняцца да 10 першых секунд (працягласць
clut.nut
), то апошняе малюнак гэтага патоку CLUT будзе прымяняцца да астатніх кадраў mandelbrot
патоку.
11.110.2.2 Hald CLUT with preview
Мяркуецца, што Hald CLUT - гэта выява ў квадраце памерам Level*Level*Level
пікселяў
Level*Level*Level
. Для дадзенага Hald CLUT FFmpeg выбярэ максімальна магчымы квадрат, пачынаючы з левага верхняга кута малюнка. Астатнія пікселі запаўнення (унізе або справа) будуць ігнаравацца. Гэтую вобласць можна выкарыстоўваць, каб дадаць папярэдні прагляд Hald CLUT.
Як правіла, наступны згенераваны Hald CLUT будзе падтрымлівацца
haldclut
фільтрам:
ffmpeg -f lavfi -i haldclutsrc=8 -vf "
pad=iw+320 [padded_clut];
smptebars=s=320x256, split [a][b];
[padded_clut][a] overlay=W-320:h, curves=color_negative [main];
[main][b] overlay=W-320" -frames:v 1 clut.png
Ён утрымлівае арыгінал і папярэдні прагляд эфекту CLUT: каляровыя паласы SMPTE адлюстроўваюцца справа ўверсе і ўнізе тыя ж каляровыя палоскі, апрацаваныя змяненнем колеру.
Затым эфект гэтага Hald CLUT можна візуалізаваць з дапамогай:
ffplay input.mkv -vf "movie=clut.png, [in] haldclut"
11.111 hflip
Перавярніце ўваходнае відэа па гарызанталі.
Напрыклад, каб перавярнуць уваходнае відэа па гарызанталі з дапамогай ffmpeg
:
ffmpeg -i in.avi -vf "hflip" out.avi
11.112 histeq
Гэты фільтр прымяняе глабальнае выраўноўванне каляровай гістаграмы для кожнага кадра.
Яго можна выкарыстоўваць для карэкцыі відэа, якое мае сціснуты дыяпазон інтэнсіўнасці пікселяў. Фільтр пераразмяркоўвае інтэнсіўнасць пікселяў, каб выраўнаваць іх размеркаванне ў дыяпазоне інтэнсіўнасці. Яго можна разглядаць як "кантрастны фільтр, які аўтаматычна рэгулюе". Гэты фільтр карысны толькі для карэкціроўкі пагоршанага або дрэнна зафіксаванага зыходнага відэа.
Фільтр прымае наступныя параметры:
strength
Вызначце колькасць выраўноўвання, якое трэба прымяніць. Па меры зніжэння трываласці размеркаванне інтэнсіўнасці пікселяў усё больш набліжаецца да размеркавання інтэнсіўнасці ўваходнага кадра. Значэнне павінна быць лікам з плаваючай часткай у дыяпазоне [0,1] і па змаўчанні роўна 0,200.
intensity
Усталюйце максімальную інтэнсіўнасць, якая можа генеравацца, і адпаведным чынам маштабуйце выхадныя значэнні. Сіла павінна быць зададзена па жаданні, а затым інтэнсіўнасць можа быць абмежавана, калі неабходна, каб пазбегнуць вымывання. Значэнне павінна быць лікам з плаваючай часткай у дыяпазоне [0,1] і па змаўчанні роўна 0,210.
antibanding
Усталюйце ўзровень антыбандынгу. Калі ўключаны, фільтр будзе выпадковым чынам змяняць яркасць выходных пікселяў на невялікую колькасць, каб пазбегнуць палос на гістаграме. Магчымыя значэнні
none
,weak
абоstrong
. Па змаўчанні гэтаnone
.
11.113 histogram
Вылічыце і намалюйце гістаграму размеркавання колеру для ўваходнага відэа.
Вылічаная гістаграма - гэта адлюстраванне размеркавання кампанентаў колеру на малюнку.
Стандартная гістаграма адлюстроўвае размеркаванне кампанентаў колеру на малюнку. Адлюстроўвае каляровы графік для кожнага кампанента колеру. Паказвае размеркаванне кампанентаў Y, U, V, A або R, G, B, у залежнасці ад фармату ўводу, у бягучым кадры. Пад кожным графікам паказаны метр шкалы кампанентаў колеру.
Фільтр прымае наступныя параметры:
level_height
Задайце вышыню ўзроўню. Значэнне па змаўчанні -
200
. Дазволены дыяпазон [50, 2048].scale_height
Задаць вышыню каляровай шкалы. Значэнне па змаўчанні -
12
. Дазволены дыяпазон [0, 40].display_mode
Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:
- '
stack
' Графікі кампанентаў колеру размешчаны адзін пад адным.
- '
parade
' Графікі кампанентаў колеру размешчаны побач.
- '
overlay
' Прадстаўляе інфармацыю, ідэнтычную той, што ў
parade
, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.
Па змаўчанні
stack
.- '
levels_mode
Усталяваць рэжым. Можа быць або
linear
, абоlogarithmic
. Па змаўчанніlinear
.components
Усталюйце кампаненты колеру для адлюстравання. Па змаўчанні
7
.fgopacity
Задаць непразрыстасць пярэдняга плана. Па змаўчанні
0.7
.bgopacity
Задаць непразрыстасць фону. Па змаўчанні
0.5
.colors_mode
Усталяваць каляровы рэжым. Ён прымае наступныя значэнні:
- '
whiteonblack
' - '
blackonwhite
' - '
whiteongray
' - '
blackongray
' - '
coloronblack
' - '
coloronwhite
' - '
colorongray
' - '
blackoncolor
' - '
whiteoncolor
' - '
grayoncolor
'
Па змаўчанні
whiteonblack
.- '
11.113.1 Examples
- Разлічыць і намаляваць гістаграму:
ffplay -i input -vf histogram
11.114 hqdn3d
Гэта высокадакладны/якасны 3d-фільтр шумашумлення. Яна накіравана на памяншэнне шуму выявы, атрымліваючы плыўныя выявы і робячы нерухомыя выявы сапраўды нерухомымі. Гэта павінна павысіць сціскальнасць.
Ён прымае наступныя дадатковыя параметры:
luma_spatial
Неадмоўны лік з плаваючай коскай, які вызначае прасторавую інтэнсіўнасць яркасці. Па змаўчанні 4.0.
chroma_spatial
Неадмоўны лік з плаваючай коскай, які вызначае прасторавую каляровасць. Па змаўчанні 3.0*
luma_spatial
/4.0.luma_tmp
Лік з плаваючай кропкай, які вызначае часовую сілу яркасці. Па змаўчанні 6.0*
luma_spatial
/4.0.chroma_tmp
Лік з плаваючай коскай, які вызначае часовую інтэнсіўнасць каляровасці. Па змаўчанні гэта
luma_tmp
*chroma_spatial
/luma_spatial
.
11.114.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.115 hwdownload
Спампаваць апаратныя кадры ў сістэмную памяць.
Уваход павінен быць у апаратных фрэймах, а выхад - у неапаратным фармаце. Не ўсе фарматы будуць падтрымлівацца на выхадзе - магчыма, спатрэбіцца ўставіць дадатковыformat
фільтраваць адразу пасля графіцы, каб атрымаць вывад у падтрымліваемым фармаце.
11.116 hwmap
Адлюстраванне апаратных кадраў у сістэмнай памяці або іншай прыладзе.
Гэты фільтр мае некалькі розных рэжымаў працы; які з іх выкарыстоўваецца, залежыць ад фарматаў уводу і вываду:
- Апаратны ўвод кадра, звычайны выхад кадра
Адлюструйце ўваходныя кадры ў сістэмную памяць і перадайце іх выхадным. Калі пазней спатрэбіцца арыгінальная апаратная рамка (напрыклад, пасля накладання чагосьці іншага на яе частку), то
hwmap
фільтр можа быць выкарыстаны зноў у наступным рэжыме, каб атрымаць яго. - Звычайны ўвод кадра, апаратны выхад кадра
Калі ўвод насамрэч з'яўляецца праграмна-адлюстраваным апаратным фрэймам, то адмяніце яго адлюстраванне, гэта значыць вярніце зыходны апаратны фрэйм.
У адваротным выпадку неабходна прадаставіць прыладу. Стварыце новыя апаратныя паверхні на гэтай прыладзе для вываду, затым адлюструйце іх у фармат праграмнага забеспячэння на ўваходзе і аддайце гэтыя кадры папярэдняму фільтру. Затым гэта будзе дзейнічаць як
hwupload
фільтр, але можа пазбегнуць дадатковай копіі, калі ўвод ужо знаходзіцца ў сумяшчальным фармаце. - Апаратны ўвод і вывад кадраў
Прылада павінна быць пастаўлена для вываду, альбо непасрэдна, альбо з
derive_device
варыянт. Прылады ўводу і вываду павінны быць розных тыпаў і сумяшчальныя - дакладнае значэнне гэтага залежыць ад сістэмы, але звычайна гэта азначае, што яны павінны спасылацца на адзін і той жа базавы апаратны кантэкст (напрыклад, спасылацца на адну і тую ж відэакарту).Калі ўваходныя кадры былі першапачаткова створаны на прыладзе вываду, адмяніце адлюстраванне, каб атрымаць зыходныя кадры.
У адваротным выпадку адлюстравайце кадры на прыладзе вываду - стварыце новыя апаратныя кадры на выхадзе, якія адпавядаюць кадрам на ўваходзе.
Прымаюцца наступныя дадатковыя параметры:
mode
Усталюйце рэжым адлюстравання кадраў. Некаторыя спалучэнні:
read
Адлюстраваны кадр павінен быць чытэльным.
write
Адлюстраваны кадр павінен быць даступным для запісу.
overwrite
Адлюстраванне заўсёды будзе перазапісваць увесь кадр.
У некаторых выпадках гэта можа павысіць прадукцыйнасць, бо не трэба загружаць зыходнае змесціва кадра.
direct
Адлюстраванне не павінна прадугледжваць капіраванне.
Ускосныя супастаўленні з копіямі кадраў ствараюцца ў некаторых выпадках, калі альбо прамое адлюстраванне немагчыма, альбо яно будзе мець нечаканыя ўласцівасці. Усталяванне гэтага сцяга гарантуе, што адлюстраванне будзе прамым і будзе няўдалым, калі гэта немагчыма.
Па змаўчанні,
read+write
калі не пазначана.derive_device
type
Замест таго, каб выкарыстоўваць прыладу, пастаўленую пры ініцыялізацыі, вывядзіце новую прыладу тыпу
type
з прылады, на якой існуюць ўваходныя кадры.reverse
Пры супастаўленні апаратнага забеспячэння, адлюстраванне ў зваротным парадку - стварэнне кадраў у прыёмніку і адлюстраванне іх назад у крыніцу. Гэта можа спатрэбіцца ў некаторых выпадках, калі патрабуецца адлюстраванне ў адным кірунку, але прылады, якія выкарыстоўваюцца, падтрымліваюць толькі супрацьлеглы кірунак.
Гэты параметр небяспечны - ён можа парушыць папярэдні фільтр нявызначанымі спосабамі, калі ёсць якія-небудзь дадатковыя абмежаванні на выхад гэтага фільтра. Не выкарыстоўвайце яго без поўнага разумення наступстваў яго выкарыстання.
11.117 hwupload
Загружаць кадры сістэмнай памяці на апаратныя паверхні.
Прылада для загрузкі павінна быць прадастаўлена пры ініцыялізацыі фільтра. Пры выкарыстанні ffmpeg выберыце адпаведную прыладу з дапамогай-filter_hw_device
варыянт або зderive_device
варыянт. Прылады ўводу і вываду павінны быць розных тыпаў і сумяшчальныя - дакладнае значэнне гэтага залежыць ад сістэмы, але звычайна гэта азначае, што яны павінны спасылацца на адзін і той жа базавы апаратны кантэкст (напрыклад, спасылацца на адну і тую ж відэакарту).
Прымаюцца наступныя дадатковыя параметры:
derive_device
type
Замест таго, каб выкарыстоўваць прыладу, пастаўленую пры ініцыялізацыі, вывядзіце новую прыладу тыпу
type
з прылады, на якой існуюць ўваходныя кадры.
11.118 hwupload_cuda
Загрузіце кадры сістэмнай памяці на прыладу CUDA.
Ён прымае наступныя дадатковыя параметры:
device
Нумар прылады CUDA для выкарыстання
11.119 hqx
Прымяніце высакаякасны фільтр павелічэння, прызначаны для піксельнага мастацтва. Гэты фільтр быў першапачаткова створаны Максімам Сцёпіным.
Ён прымае наступны варыянт:
n
Усталюйце памер маштабавання:
2
дляhq2x
,3
дляhq3x
і4
дляhq4x
. Па змаўчанні3
.
11.120 hstack
Складайце ўваходныя відэа гарызантальна.
Усе патокі павінны мець аднолькавы піксельны фармат і аднолькавую вышыню.
Звярніце ўвагу, што гэты фільтр працуе хутчэй, чым выкарыстанне накладання і фільтра падкладкі для стварэння таго ж выхаду.
Фільтр прымае наступныя параметры:
inputs
Задаць колькасць уваходных патокаў. Па змаўчанні 2.
shortest
Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.
11.121 hsvhold
Ператварае пэўны дыяпазон HSV у шэрыя значэнні.
Гэты фільтр вымярае каляровую розніцу паміж зададзеным колерам HSV у параметрах і колерам, вымераным у відэаструмені. У залежнасці ад опцый, колеры вываду можна змяніць на шэрыя ці не.
Фільтр прымае наступныя параметры:
hue
Усталюйце значэнне адцення, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -360 да 360. Значэнне па змаўчанні - 0.
sat
Усталюйце значэнне насычанасці, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
val
Усталюйце значэнне, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
similarity
Задайце працэнт падабенства з колерам ключа. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.
0,00001 адпавядае толькі дакладнаму колеру ключа, у той час як 1,0 адпавядае ўсім.
blend
Працэнт сумесі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.
0.0 робіць пікселі альбо цалкам шэрымі, альбо зусім не шэрымі.
Больш высокія значэнні прыводзяць да большай колькасці шэрых пікселяў, чым больш шэры піксель, тым больш падобны колер пікселяў да ключавога колеру.
11.122 hsvkey
Ператварае пэўны дыяпазон HSV у празрысты.
Гэты фільтр вымярае каляровую розніцу паміж зададзеным колерам HSV у параметрах і колерам, вымераным у відэаструмені. У залежнасці ад опцый, выхадныя колеры можна змяніць на празрыстыя, дадаўшы альфа-канал.
Фільтр прымае наступныя параметры:
hue
Усталюйце значэнне адцення, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -360 да 360. Значэнне па змаўчанні - 0.
sat
Усталюйце значэнне насычанасці, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
val
Усталюйце значэнне, якое будзе выкарыстоўвацца пры разліку каляровай розніцы. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
similarity
Задайце працэнт падабенства з колерам ключа. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0,01.
0,00001 адпавядае толькі дакладнаму колеру ключа, у той час як 1,0 адпавядае ўсім.
blend
Працэнт сумесі. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.
0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.
Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.
11.123 hue
Змяніце адценне і/або насычанасць уводу.
Ён прымае наступныя параметры:
h
Укажыце кут адцення ў градусах. Ён прымае выраз і па змаўчанні мае "0".
s
Укажыце насычанасць у дыяпазоне [-10,10]. Ён прымае выраз і па змаўчанні мае "1".
H
Укажыце вугал адцення ў колькасці радыян. Ён прымае выраз і па змаўчанні мае "0".
b
Укажыце яркасць у дыяпазоне [-10,10]. Ён прымае выраз і па змаўчанні мае "0".
h
іH
з'яўляюцца ўзаемавыключальнымі і не могуць быць вызначаны адначасова.
Theb
,h
,H
іs
значэнні параметраў - гэта выразы, якія змяшчаюць наступныя канстанты:
n
колькасць кадраў уваходнага кадра, пачынаючы з 0
pts
пазнака часу прадстаўлення ўваходнага кадра, выражаная ў адзінках асновы часу
r
частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая
t
пазнака часу, выражаная ў секундах, NAN, калі пазнака часу невядомая
tb
часовая база ўваходнага відэа
11.123.1 Examples
- Усталюйце адценне 90 градусаў і насычанасць 1,0:
hue=h=90:s=1
- Тая ж каманда, але з выражэннем адцення ў радыянах:
hue=H=PI/2:s=1
- Павярніце адценне і змяніце насычанасць паміж 0 і 2 на працягу 1 секунды:
hue="H=2*PI*t: s=sin(2*PI*t)+1"
- Прымяніць 3-секундны эфект плыні насычэння, пачынаючы з 0:
hue="s=min(t/3\,1)"
Агульны выраз з знікненнем можна запісаць так:
hue="s=min(0\, max((t-START)/DURATION\, 1))"
- Прымяніць эфект згасання насычанасці на 3 секунды, пачынаючы з 5 секунд:
hue="s=max(0\, min(1\, (8-t)/3))"
Агульны выраз знікнення можна запісаць так:
hue="s=max(0\, min(1\, (START+DURATION-t)/DURATION))"
11.123.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
b
s
h
H
Змяніце адценне і/або насычанасць і/або яркасць уваходнага відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.124 huesaturation
Прымяніць карэкціроўкі адцення, насычанасці і інтэнсіўнасці да ўваходнага відэапатоку.
Гэты фільтр працуе ў каляровай прасторы RGB.
Гэты фільтр прымае наступныя параметры:
hue
Усталюйце зрух адцення ў градусах для прымянення. Па змаўчанні 0. Дазволены дыяпазон ад -180 да 180.
saturation
Усталюйце зрух насычанасці. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
intensity
Усталюйце зрух інтэнсіўнасці. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1.
colors
Усталюйце, якія асноўныя і дадатковыя колеры будуць скарэкціраваны. Гэты параметр усталёўваецца шляхам прадастаўлення аднаго або некалькіх значэнняў. Гэта можа выбраць некалькі колераў адначасова. Па змаўчанні выбраны ўсе колеры.
- '
r
' Адрэгулюйце чырвоныя.
- '
y
' Адрэгулюйце жоўты колер.
- '
g
' Адрэгулюйце зеляніна.
- '
c
' Адрэгулюйце цыяны.
- '
b
' Наладзіць блюз.
- '
m
' Адрэгулюйце пурпурныя колеры.
- '
a
' Адрэгулюйце ўсе колеры.
- '
strength
Усталюйце сілу фільтрацыі. Дазволены дыяпазон ад 0 да 100. Значэнне па змаўчанні - 1.
rw, gw, bw
Усталюйце вагу для кожнага кампанента RGB. Дазволены дыяпазон ад 0 да 1. Па змаўчанні ўстаноўлена 0,333, 0,334, 0,333. Гэтыя варыянты выкарыстоўваюцца ў апрацоўцы насычэння і асвятлення.
lightness
Задаць захаванне лёгкасці, па змаўчанні адключана. Рэгуляванне адценняў можа змяніць яркасць у параўнанні з арыгінальным трыплетам RGB, калі гэты параметр уключаны, яркасць захоўваецца на ранейшым узроўні.
11.125 hysteresis
Перарасці першы паток у другі паток шляхам злучэння кампанентаў. Гэта дазваляе ствараць больш трывалыя краёвыя маскі.
Гэты фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
threshold
Усталюйце парог, які выкарыстоўваецца пры фільтрацыі. Калі значэнне піксельнага кампанента вышэй за гэта значэнне, уключаецца алгарытм фільтра для злучэння кампанентаў. Па змаўчанні значэнне роўна 0.
Фільтр hysteresis
таксама падтрымлівае параметры framesync .
11.126 iccdetect
Вызначце каляровую прастору з убудаванага профілю ICC (калі ён ёсць) і адпаведна абнавіце тэгі кадра.
Гэты фільтр прымае наступныя параметры:
force
Калі ісціна, існуючыя тэгі каляровай прасторы фрэйма заўсёды будуць перавызначацца значэннямі, выяўленымі з профілю ICC. У адваротным выпадку яны будуць прызначаны, толькі калі ўтрымліваюць
unknown
. Уключана па змаўчанні.
11.127 iccgen
Стварыць профілі ICC і прымацаваць іх да рам.
Гэты фільтр прымае наступныя параметры:
color_primaries
color_trc
Наладзьце каляровую прастору, для якой будзе створаны профіль ICC. Значэнне па змаўчанні
auto
выводзіць значэнне з метаданых уваходнага кадра, па змаўчанні - BT.709/sRGB у залежнасці ад выпадку.Спіс магчымых значэнняў глядзіце ў фільтры setparams
unknown
, але звярніце ўвагу, што значэнні для гэтага фільтра недапушчальныя.force
Калі ісціна, профіль ICC будзе створаны, нават калі ён перазапіша ўжо існуючы профіль ICC. Па змаўчанні адключана.
11.128 identity
Атрымаць адзнаку ідэнтычнасці паміж двума ўваходнымі відэа.
Гэты фільтр прымае два ўваходныя відэа.
Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.
Атрыманы па кампаненту, сярэдні, мінімальны і максімальны бал ідэнтычнасці друкуецца праз сістэму рэгістрацыі.
Фільтр захоўвае разлічаныя балы ідэнтычнасці кожнага кадра ў метададзеных кадра.
У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpg
апрацоўваецца параўноўваецца з эталонным файламref.mpg
.
ffmpeg -i main.mpg -i ref.mpg -lavfi identity -f null -
11.129 idet
Вызначыць тып перапляцення відэа.
Гэты фільтр спрабуе вызначыць, калі ўваходныя кадры з'яўляюцца празрадковай, прагрэсіўнай, верхнім або ніжнім полем першым. Ён таксама паспрабуе выявіць палі, якія паўтараюцца паміж суседнімі кадрамі (прыкмета тэлекіно).
Пры класіфікацыі кожнага кадра пры выяўленні аднаго кадра ўлічваюцца толькі непасрэдна суседнія кадры. Выяўленне некалькіх кадраў уключае ў сябе гісторыю класіфікацыі папярэдніх кадраў.
Фільтр будзе запісваць гэтыя значэнні метададзеных:
single.current_frame
Выяўлены тып бягучага кадра з дапамогай выяўлення аднаго кадра. Адзін з: «tff» (спачатку верхняе поле), «bff» (спачатку ніжняе поле), «прагрэсіўны» або «нявызначаны»
single.tff
Сукупная колькасць кадраў, выяўленых у верхнім полі першым з дапамогай выяўлення аднаго кадра.
multiple.tff
Сукупная колькасць кадраў, выяўленых у верхнім полі першым з дапамогай выяўлення некалькіх кадраў.
single.bff
Сукупная колькасць кадраў, выяўленых у ніжнім полі першым з дапамогай выяўлення аднаго кадра.
multiple.current_frame
Выяўлены тып бягучага кадра з дапамогай выяўлення некалькіх кадраў. Адзін з: «tff» (спачатку верхняе поле), «bff» (спачатку ніжняе поле), «прагрэсіўны» або «нявызначаны»
multiple.bff
Сукупная колькасць кадраў, выяўленых у ніжнім полі першым з дапамогай выяўлення некалькіх кадраў.
single.progressive
Сукупная колькасць кадраў, выяўленых як прагрэсіўныя з дапамогай выяўлення аднаго кадра.
multiple.progressive
Сукупная колькасць кадраў, выяўленых як прагрэсіўныя з дапамогай выяўлення некалькіх кадраў.
single.undetermined
Сукупная колькасць кадраў, якія не ўдалося класіфікаваць з дапамогай выяўлення аднаго кадра.
multiple.undetermined
Сукупная колькасць кадраў, якія не ўдалося класіфікаваць з дапамогай выяўлення некалькіх кадраў.
repeated.current_frame
Якое поле ў бягучым кадры паўтараецца з апошняга. Адзін з "ні", "зверху" ці "знізу".
repeated.neither
Сукупная колькасць кадраў без паўтаральнага поля.
repeated.top
Сукупная колькасць кадраў з верхнім полем, якое паўтараецца з верхняга поля папярэдняга кадра.
repeated.bottom
Сукупная колькасць кадраў з ніжнім полем, якое паўтараецца з ніжняга поля папярэдняга кадра.
Фільтр прымае наступныя параметры:
intl_thres
Усталюйце парог перапляцення.
prog_thres
Усталюйце прагрэсіўны парог.
rep_thres
Парог для паўторнага выяўлення поля.
half_life
Колькасць кадраў, пасля якіх уклад дадзенага кадра ў статыстыку памяншаецца ўдвая (г.зн. ён уносіць толькі 0,5 у сваю класіфікацыю). Значэнне па змаўчанні 0 азначае, што ўсім бачным кадрам назаўжды надаецца поўная вага 1,0.
analyze_interlaced_flag
Калі гэта не роўна 0, idet будзе выкарыстоўваць зададзеную колькасць кадраў, каб вызначыць, ці дакладны сцяг празрадковай разгорткі, ён не будзе лічыць нявызначаныя кадры. Калі сцяг прызнаны дакладным, ён будзе выкарыстоўвацца без якіх-небудзь дадатковых вылічэнняў, калі ён будзе прызнаны недакладным, ён будзе выдалены без якіх-небудзь дадатковых вылічэнняў. Гэта дазваляе ўставіць фільтр idet як метад з нізкім узроўнем вылічэнняў, каб ачысціць празрадковы сцяг
11.130 il
Перамежаванне або перамежаванне палёў.
Гэты фільтр дазваляе апрацоўваць палі з празрадковай разгорткай без дэінтэрлейсу. Дэперамежаванне разбівае ўваходны кадр на 2 палі (так званыя паўмалюнкі). Няцотныя радкі перамяшчаюцца ў верхнюю палову выходнага малюнка, цотныя радкі - у ніжнюю. Вы можаце апрацоўваць (фільтраваць) іх незалежна, а потым перамяжоўваць.
Фільтр прымае наступныя параметры:
luma_mode, l
chroma_mode, c
alpha_mode, a
Даступныя значэнні для
luma_mode
іchroma_mode
:alpha_mode
- '
none
' Нічога не рабіць.
- '
deinterleave, d
' Размясціце палі, размясціўшы адно над адным.
- '
interleave, i
' Чаргаванне палёў. Зваротны эфект дэперамежавання.
Значэнне па змаўчанні -
none
.- '
luma_swap, ls
chroma_swap, cs
alpha_swap, as
Памяняйце палі яркасці/каляровасці/альфа. Абмен цотнымі і няцотнымі лініямі. Значэнне па змаўчанні -
0
.
11.130.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.131 inflate
Прымяніць эфект раздзімання да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) сярэднім, прымаючы пад увагу толькі значэнні, вышэйшыя за піксель.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмежаванне максімальнай змены для кожнай плоскасці, па змаўчанні 65535. Калі 0, плоскасць застанецца нязменнай.
11.131.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.132 interlace
Просты празрадковы фільтр з прагрэсіўнага кантэнту. Гэта перамяжоўвае верхнія (або ніжнія) радкі з няцотных кадраў з ніжнімі (або верхнімі) радкамі з цотных кадраў, памяншаючы ўдвая частату кадраў і захоўваючы вышыню выявы.
Original Original New Frame
Frame 'j' Frame 'j+1' (tff)
========== =========== ==================
Line 0 --------------------> Frame 'j' Line 0
Line 1 Line 1 ----> Frame 'j+1' Line 1
Line 2 ---------------------> Frame 'j' Line 2
Line 3 Line 3 ----> Frame 'j+1' Line 3
... ... ...
New Frame + 1 will be generated by Frame 'j+2' and Frame 'j+3' and so on
Ён прымае наступныя дадатковыя параметры:
scan
Гэта вызначае, бярэцца празрадковы кадр з цотных (tff - па змаўчанні) або няцотных (bff) радкоў прагрэсіўнага кадра.
lowpass
Вертыкальны фільтр нізкіх частот, каб пазбегнуць перапляцення твітэра і паменшыць муар.
- '
0, off
' Адключыць вертыкальны фільтр нізкіх частот
- '
1, linear
' Уключыць лінейны фільтр (па змаўчанні)
- '
2, complex
' Уключыць комплексны фільтр. Гэта крыху менш зменшыць шчэбет і муар, але лепш захавае дэталізацыю і суб'ектыўную выразнасць.
- '
11.133 kerndeint
Дэінтэрлінг ўваходнага відэа з дапамогай адаптыўнага ядра Donald Graft. Працуйце з празрадковай разгорткай у відэа для атрымання прагрэсіўных кадраў.
Ніжэй прыводзіцца апісанне прынятых параметраў.
thresh
Усталюйце парог, які ўплывае на допуск фільтра пры вызначэнні неабходнасці апрацоўкі піксельнай лініі. Яно павінна быць цэлым лікам у дыяпазоне [0,255] і па змаўчанні роўна 10. Значэнне 0 прывядзе да прымянення працэсу да кожнага пікселя.
map
Зафарбоўваць пікселі, якія перавышаюць парогавае значэнне, у белы колер, калі ўстаноўлена значэнне 1. Значэнне па змаўчанні - 0.
order
Усталюйце парадак палёў. Памяняйце палі месцамі, калі ўстаноўлена 1, пакіньце палі ў спакоі, калі 0. Па змаўчанні 0.
sharp
Уключыць дадатковую рэзкасць, калі ўстаноўлена 1. Па змаўчанні 0.
twoway
Уключыць двухбаковую рэзкасць, калі ўстаноўлена 1. Па змаўчанні 0.
11.133.1 Examples
- Прымяніць значэнні па змаўчанні:
kerndeint=thresh=10:map=0:order=0:sharp=0:twoway=0
- Уключыць дадатковую рэзкасць:
kerndeint=sharp=1
- Пафарбаваць апрацаваныя пікселі ў белы колер:
kerndeint=map=1
11.134 kirsch
Ужыць аператар Кірша для ўваходнага відэаструменю.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.
delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.
11.134.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.135 lagfun
Павольна абнаўляйце больш цёмныя пікселі.
Гэты фільтр робіць кароткія ўспышкі святла больш доўгімі. Гэты фільтр прымае наступныя параметры:
decay
Устанавіць каэфіцыент распаду. Па змаўчанні 0,95. Дазволены дыяпазон ад 0 да 1.
planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.
11.135.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.136 lenscorrection
Выпраўце радыяльнае скажэнне лінзы
Гэты фільтр можа быць выкарыстаны для карэкцыі радыяльных скажэнняў, якія могуць узнікнуць у выніку выкарыстання шырокавугольных лінзаў, і такім чынам паўторна выправіць выяву. Каб знайсці правільныя параметры, можна выкарыстоўваць інструменты, даступныя, напрыклад, як частка opencv або проста метадам спроб і памылак. Каб выкарыстоўваць opencv, выкарыстоўвайце ўзор каліброўкі (у раздзеле samples/cpp) з крыніц opencv і вылучыце каэфіцыенты k1 і k2 з атрыманай матрыцы.
Звярніце ўвагу, што фактычна той самы фільтр даступны ў інструментах з адкрытым зыходным кодам Krita і Digikam з праекта KDE.
У адрозненне ад фільтра віньеткі , які таксама можа быць выкарыстаны для кампенсацыі памылак аб'ектыва, гэты фільтр выпраўляе скажэнне выявы, у той час як віньетка карэктуе размеркаванне яркасці, так што вы можаце выкарыстоўваць абодва фільтры разам у пэўных выпадках, хоць вам спатрэбіцца паклапаціцца пра ўпарадкаванне, г.зн. аб тым, ці варта наносіць віньеткаванне да або пасля карэкцыі лінзаў.
11.136.1 Options
Фільтр прымае наступныя параметры:
cx
Адносная каардыната х фокуснай кропкі выявы і, такім чынам, цэнтра скажэння. Гэта значэнне мае дыяпазон [0,1] і выражаецца ў долях шырыні выявы. Па змаўчанні 0,5.
cy
Адносная каардыната y фокуснай кропкі відарыса і, такім чынам, цэнтра скажэння. Гэта значэнне мае дыяпазон [0,1] і выражаецца ў долях вышыні выявы. Па змаўчанні 0,5.
k1
Каэфіцыент квадратычнага папраўчага члена. Гэта значэнне мае дыяпазон [-1,1]. 0 азначае адсутнасць выпраўлення. Па змаўчанні 0.
k2
Каэфіцыент двайнога квадратнага папраўчага члена. Гэта значэнне мае дыяпазон [-1,1]. 0 азначае адсутнасць выпраўлення. Па змаўчанні 0.
i
Усталюйце тып інтэрпаляцыі. Можа быць
nearest
абоbilinear
. Па змаўчанніnearest
.fc
Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні
black@0
.
Формула, якая стварае карэкцыю:
r_src
= r_tgt
* (1 + k1
* ( r_tgt
/ r_0
)^2 + k2
* ( r_tgt
/ r_0
)^4)
дзе r_0
- палова дыяганалі выявы, а r_src
і r_tgt
- адлегласці ад фокуснай кропкі на зыходным і мэтавым малюнках адпаведна.
11.136.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.137 lensfun
Прымяніць карэкцыю аб'ектыва праз бібліятэку lensfun ( http://lensfun.sourceforge.net/ ).
Фільтр lensfun
патрабуе маркі камеры, мадэлі камеры і мадэлі аб'ектыва для прымянення карэкцыі аб'ектыва. Фільтр загрузіць базу дадзеных lensfun і запытае яе, каб знайсці адпаведныя запісы камеры і аб'ектыва ў базе дадзеных. Пакуль гэтыя запісы можна знайсці з зададзенымі опцыямі, фільтр можа выконваць выпраўленні кадраў. Звярніце ўвагу, што няпоўныя радкі прывядуць да таго, што фільтр выбярэ найбольшае супадзенне з зададзенымі опцыямі, і фільтр вывядзе выбраныя мадэлі камеры і аб'ектываў (рэгіструецца з узроўнем "інфармацыя"). Вы павінны ўказаць марку, мадэль камеры і мадэль аб'ектыва, калі яны неабходныя.
Каб атрымаць спіс даступных марак і мадэляў, прапусціце адзін або абодва варыянты make
і
. model
Фільтр адправіць поўны спіс у журнал з узроўнем INFO
. Першы слупок - марка, а другі - мадэль. Каб атрымаць спіс даступных аб'ектываў, задайце любыя значэнні маркі і мадэлі і прапусціце
lens_model
опцыю. Фільтр адправіць поўны спіс лінзаў у журнал з узроўнем
INFO
. Інструмент ffmpeg закрыецца пасля таго, як спіс будзе надрукаваны.
Фільтр прымае наступныя параметры:
make
Марка фотаапарата (напрыклад, «Canon»). Гэтая опцыя абавязковая.
model
Мадэль фотаапарата (напрыклад, «Canon EOS 100D»). Гэтая опцыя абавязковая.
lens_model
Мадэль аб'ектыва (напрыклад, "Canon EF-S 18-55mm f/3.5-5.6 IS STM"). Гэтая опцыя абавязковая.
db_path
Поўны шлях да папкі базы дадзеных аб'ектыва. Калі не ўстаноўлена, фільтр будзе спрабаваць загрузіць базу дадзеных са шляху ўстаноўкі, калі бібліятэка была створана. Па змаўчанні не ўстаноўлена.
mode
Тып карэкцыі для прымянення. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:
- '
vignetting
' Дазваляе фіксаваць віньеткаванне аб'ектыва.
- '
geometry
' Дазваляе фіксаваць геаметрыю лінзы. Гэта па змаўчанні.
- '
subpixel
' Дазваляе выправіць храматычныя аберацыі.
- '
vig_geo
' Дазваляе фіксаваць віньеткаванне і геаметрыю аб'ектыва.
- '
vig_subpixel
' Дазваляе фіксаваць віньеткаванне аб'ектыва і храматычныя аберацыі.
- '
distortion
' Дазваляе фіксаваць як геаметрыю лінзы, так і храматычныя аберацыі.
- '
all
' Уключае ўсе магчымыя выпраўленні.
- '
focal_length
Фокусная адлегласць выявы/відэа (маштаб; чаканая канстанта для відэа). Напрыклад, аб'ектыў 18–55 мм мае дыяпазон фокусных адлегласцей [18–55], таму пры выкарыстанні гэтага аб'ектыва трэба выбіраць значэнне ў гэтым дыяпазоне. Па змаўчанні 18.
aperture
Дыяфрагма выявы/відэа (чаканая канстанта для відэа). Звярніце ўвагу, што дыяфрагма выкарыстоўваецца толькі для карэкцыі віньеткавання. Па змаўчанні 3.5.
focus_distance
Дыстанцыя фокусу відарыса/відэа (чаканая канстанта для відэа). Звярніце ўвагу, што фокусная адлегласць выкарыстоўваецца толькі для віньеткавання і толькі нязначна ўплывае на працэс карэкцыі віньеткавання. Калі невядома, пакіньце значэнне па змаўчанні (1000).
scale
Каэфіцыент маштабу, які прымяняецца пасля пераўтварэння. Пасля выпраўлення відэа больш не абавязкова будзе прамавугольным. Гэты параметр кантралюе, наколькі бачная частка атрыманага малюнка. Значэнне 0 азначае, што значэнне будзе выбірацца аўтаматычна, так што на выходным малюнку будзе мала або зусім няма неадлюстраванай вобласці. 1.0 азначае, што дадатковае маштабаванне не праводзіцца. Ніжэйшыя значэнні могуць прывесці да таго, што будзе бачная большая частка выпраўленага відарыса, у той час як больш высокія значэнні могуць пазбегнуць неадлюстраваных абласцей у вывадзе.
target_geometry
Мэтавая геаметрыя выхаднога відарыса/відэа. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:
- '
rectilinear (default)
' - '
fisheye
' - '
panoramic
' - '
equirectangular
' - '
fisheye_orthographic
' - '
fisheye_stereographic
' - '
fisheye_equisolid
' - '
fisheye_thoby
'
- '
reverse
Прымяніце зваротную карэкцыю выявы (замест карэкцыі скажэнняў прымяніце яе).
interpolation
Тып інтэрпаляцыі, які выкарыстоўваецца пры выпраўленні скажэнняў. Наступныя значэнні з'яўляюцца дапушчальнымі варыянтамі:
- '
nearest
' - '
linear (default)
' - '
lanczos
'
- '
11.137.1 Examples
- Ужывайце карэкцыю аб'ектыва маркі "Canon", мадэлі камеры "Canon EOS 100D" і мадэлі аб'ектыва "Canon EF-S 18-55mm f/3.5-5.6 IS STM" з фокуснай адлегласцю "18" і дыяфрагмай "8.0".
ffmpeg -i input.mov -vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF-S 18-55mm f/3.5-5.6 IS STM":focal_length=18:aperture=8 -c:v h264 -b:v 8000k output.mov
- Ужывайце тое ж самае, што і раней, але толькі на першыя 5 секунд відэа.
ffmpeg -i input.mov -vf lensfun=make=Canon:model="Canon EOS 100D":lens_model="Canon EF-S 18-55mm f/3.5-5.6 IS STM":focal_length=18:aperture=8:enable='lte(t\,5)' -c:v h264 -b:v 8000k output.mov
11.138 libplacebo
Гнуткі фільтр апрацоўкі з паскораным GPU на аснове libplacebo ( https://code.videolan.org/videolan/libplacebo ). Звярніце ўвагу, што гэты фільтр зараз прымае толькі ўваходныя кадры Vulkan.
11.138.1 Options
Параметры гэтага фільтра падзелены на наступныя раздзелы:
11.138.1.1 Output mode
Гэтыя параметры кантралююць агульны рэжым вываду. Па змаўчанні libplacebo паспрабуе як мага лепш захаваць каларыметрыю і памер крыніцы, але пры гэтым будзе прымяняцца любая ўбудаваная зярністасць плёнкі, метаданыя Dolby Vision або анаморфны SAR, прысутныя ў зыходных кадрах.
w
h
Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.
Дазваляе тыя ж выразы, што і маштабны фільтр.
format
Усталюйце перавызначэнне фармату вываду. Калі не ўстаноўлена (па змаўчанні), кадры будуць выводзіцца ў тым жа фармаце, што і адпаведныя ўваходныя кадры. У адваротным выпадку будзе выканана пераўтварэнне фармату.
force_original_aspect_ratio
force_divisible_by
Працуюць гэтак жа, як і ідэнтычныя варыянты маштабнага фільтра.
normalize_sar
Калі ўключана (па змаўчанні), выхадныя кадры заўсёды будуць мець суадносіны бакоў пікселяў 1:1. Калі адключана, любыя неадпаведнасці прапорцый, у тым ліку з анаморфных відэакрыніц, перадаюцца ў выхадныя суадносіны бакоў пікселяў.
pad_crop_ratio
Задае суадносіны (паміж
0.0
і1.0
) паміж запаўненнем і кадраваннем, калі суадносіны бакоў уводу не супадаюць з суадносінамі бакоў вываду іnormalize_sar
дзейнічае. Значэнне па змаўчанні0.0
заўсёды запаўняе змесціва чорнымі рамкамі, а значэнне1.0
заўсёды абразае часткі змесціва. Магчымыя прамежкавыя значэнні, якія прыводзяць да спалучэння двух падыходаў.colorspace
color_primaries
color_trc
range
Наладзьце каляровую прастору, у якой будуць дастаўляцца выходныя кадры. Значэнне па змаўчанні
auto
выводзіць кадры ў тым жа фармаце, што і ўваходныя кадры, што не прыводзіць да зменаў. Для любога іншага значэння будзе выканана пераўтварэнне.Спіс магчымых значэнняў глядзіце ў фільтры setparams .
apply_filmgrain
Прымяніце зярністасць плёнкі (напрыклад, AV1 або H.274), калі яна ёсць у зыходных кадрах, і выдаліце ​​яе з выхаду. Уключана па змаўчанні.
apply_dolbyvision
Прымяніць метаданыя Dolby Vision RPU, калі яны ёсць у зыходных кадрах, і выдаліць іх з вываду. Уключана па змаўчанні. Звярніце ўвагу, што Dolby Vision заўсёды будзе выдаваць BT.2020+PQ, адмяняючы звычайныя метаданыя ўваходнага кадра. Яны таксама будуць выбраны ў якасці значэнняў
auto
для адпаведных параметраў вываду кадраў.
11.138.1.2 Scaling
Параметры ў гэтым раздзеле кантралююць, як libplacebo выконвае павелічэнне і (пры неабходнасці) памяншэнне маштабу. Звярніце ўвагу, што libplacebo заўсёды будзе ўнутрана працаваць са змесцівам 4:4:4, таму любыя фарматы каляровасці yuv420p
з субвыбаркай, такія як, абавязкова будуць павышацца і зніжацца як частка працэсу рэндэрынгу. Гэта азначае, што маштабаванне можа дзейнічаць, нават калі дазвол крыніцы і прызначэння аднолькавы.
upscaler
downscaler
Наладзьце ядро ​​фільтра, якое выкарыстоўваецца для павелічэння і памяншэння маштабу. Адпаведныя значэнні па змаўчанні
spline36
іmitchell
. Каб атрымаць поўны спіс магчымых значэнняў, перайдзіцеhelp
да гэтых параметраў. Найбольш важныя каштоўнасці:- '
none
' Прымушае выкарыстоўваць убудаваную выбарку тэкстур GPU (звычайна білінейную). Надзвычай хутка, але нізкай якасці, асабліва пры памяншэнні маштабу.
- '
bilinear
' Білінейная інтэрпаляцыя. Як правіла, гэта можа быць зроблена бясплатна на графічных працэсарах, за выключэннем выпадкаў, калі гэта прывядзе да псеўданімаў. Хутка і нізкаякасная.
- '
nearest
' Інтэрпаляцыя бліжэйшага суседа. Рэзкае, але вельмі згладжанае.
- '
oversample
' Алгарытм, які візуальна падобны на інтэрпаляцыю бліжэйшага суседа, але спрабуе захаваць суадносіны бакоў пікселяў. Добра падыходзіць для піксельнага мастацтва, бо яно прыводзіць да мінімальнага скажэння мастацкага выгляду.
- '
lanczos
' Стандартнае ядро ​​інтэрпаляцыі sinc-sinc.
- '
spline36
' Кубічны сплайн-апраксімацыя Ланцоса. Няма розніцы ў прадукцыйнасці, але звон крыху меншы.
- '
ewa_lanczos
' Эліптычна ўзважаная сярэдняя версія lanczos, заснаваная на ядры jinc-sinc. Гэта таксама ў народзе называюць проста "маштабаванне Jinc". Павольна, але вельмі якасна.
- '
gaussian
' Ядро Гаўса. Мае пэўныя ідэальныя матэматычныя ўласцівасці, але суб'ектыўна вельмі размытыя.
- '
mitchell
' Кубічны сплайн BC з параметрамі, рэкамендаванымі Мітчэлам і Нетравалі. Вельмі мала звоніць.
- '
lut_entries
Канфігуруе памер LUT маштабавальніка ў дыяпазоне ад
1
да256
. Значэнне па змаўчанні0
выбірае ўнутранае значэнне па змаўчанні libplacebo, звычайна64
.antiringing
Уключае антызванок (для фільтраў, якія не ўваходзяць у EWA). Значэнне (паміж
0.0
і1.0
) канфігуруе сілу алгарытму прадухілення выкліку. Можа павялічыць псеўданім, калі зададзена занадта высока. Па змаўчанні адключана.sigmoid
Уключыць сігмаідальнае сціск падчас маштабавання. Трохі памяншае звон. Уключана па змаўчанні.
11.138.1.3 Debanding
Libplacebo пастаўляецца з убудаваным фільтрам дэбандавання, які добра супрацьстаіць шматлікім распаўсюджаным крыніцам палос і блакіровак. Настойліва рэкамендуецца ўключаць гэта, калі патрэбна якасць.
deband
Уключыць (хуткі) алгарытм дэбандыравання. Па змаўчанні адключана.
deband_iterations
Колькасць ітэрацый дэбандавання алгарытму дэбандавання. Кожная ітэрацыя выконваецца з паступовым павелічэннем радыусу (і паніжаным парогам). Рэкамендуемыя значэнні знаходзяцца ў дыяпазоне
1
да4
. Па змаўчанні1
.deband_threshold
Зніжэнне трываласці фільтра. Больш высокія лічбы прыводзяць да больш агрэсіўнага дэбандавання. Па змаўчанні
4.0
.deband_radius
Радыус дэбандызацыйнага фільтра. Большы радыус лепш для павольных градыентаў, у той час як меншы радыус лепш для крутых градыентаў. Па змаўчанні
16.0
.deband_grain
Колькасць дадатковага выходнага збожжа, якое трэба дадаць. Дапамагае схаваць недахопы. Па змаўчанні
6.0
.
11.138.1.4 Color adjustment
Калекцыя суб'ектыўных элементаў кіравання колерам. Не вельмі строгі, таму дакладны эфект будзе некалькі адрознівацца ў залежнасці ад праймерыз уводу і каляровай прасторы.
brightness
Павышэнне яркасці паміж
-1.0
і1.0
. Па змаўчанні0.0
.contrast
Узмацненне кантрасту паміж
0.0
і16.0
. Па змаўчанні1.0
.saturation
Узмацненне насычанасці, паміж
0.0
і16.0
. Па змаўчанні1.0
.hue
Зрух адцення ў радыянах паміж
-3.14
і3.14
. Па змаўчанні0.0
. Гэта паверне УФ-субвектар з каэфіцыентамі па змаўчанні BT.709 для ўваходных сігналаў RGB.gamma
Гама-рэгуляванне паміж
0.0
і16.0
. Па змаўчанні1.0
.cones
Мадэль конусу для мадэлявання дальтанізму. Прымае любую камбінацыю
l
,m
іs
. Вось некалькі прыкладаў:- '
m
' Дэйтэранамалія / дэйтэранапія (закранае 3%-4% насельніцтва)
- '
l
' Пратанамалія / пратанапія (закранае 1%-2% насельніцтва)
- '
l+m
' Манахраматыя (вельмі рэдка)
- '
l+m+s
' Ахраматапсія (поўная страта дзённага гледжання, вельмі рэдка)
- '
cone-strength
Каэфіцыент узмацнення для конусаў
cones
, вызначаных паміж0.0
і10.0
. Значэнне не1.0
прыводзіць да змены каляровага зроку. Значэнне0.0
(па змаўчанні) імітуе поўную страту гэтых конусаў. Прыведзеныя вышэй значэнні1.0
прыводзяць да перабольшвання адрозненняў паміж колбачкамі, што можа дапамагчы кампенсаваць пагаршэнне каляровага зроку.
11.138.1.5 Peak detection
Каб дапамагчы мець справу з крыніцамі, якія маюць толькі статычныя метаданыя HDR10 (ці наогул не маюць тэгаў), libplacebo выкарыстоўвае ўласны ўнутраны вылічальны шэйдар аналізу кадраў для аналізу зыходных кадраў і адаптацыі функцыі адлюстравання тонаў у рэальным часе. Калі гэта адбываецца занадта павольна, або калі неабходны дакладна ўзнаўляемы ідэальны вынік кадра, рэкамендуецца адключыць гэту функцыю.
peak_detect
Уключыць выяўленне піка HDR. Ігнаруе статычныя значэнні MaxCLL/MaxFALL на карысць дынамічнага выяўлення з уводу. Звярніце ўвагу, што выяўленыя значэнні не запісваюцца ў выходныя кадры, яны проста кіруюць працэсам унутранага тонавага адлюстравання. Уключана па змаўчанні.
smoothing_period
Перыяд згладжвання выяўлення піка, паміж
0.0
і1000.0
. Больш высокія значэнні прыводзяць да таго, што выяўленне пікаў становіцца менш рэагуючым на змены ўваходных дадзеных. Па змаўчанні100.0
.minimum_peak
Ніжняя мяжа выяўленага піка (адносна SDR белага), паміж
0.0
і100.0
. Па змаўчанні1.0
.scene_threshold_low
scene_threshold_high
Ніжні і верхні парогі для выяўлення змены сцэны. Выражаецца ў лагарыфмічнай шкале паміж
0.0
і100.0
. Па змаўчанні5.5
і10.0
адпаведна. Адмоўнае значэнне адключае гэтую функцыю.overshoot
Маржа перавышэння пікавага згладжвання паміж
0.0
і1.0
. Забяспечвае запас трываласці для прадухілення абразання ў выніку згладжвання пікаў. Па змаўчанні -0.05
, што адпавядае маржы 5%.
11.138.1.6 Tone mapping
Параметры ў гэтым раздзеле кантралююць, як libplacebo выконвае танальнае адлюстраванне і адлюстраванне гамы пры працы з неадпаведнасцю паміж змесцівам з шырокай гамай і HDR. Увогуле, libplacebo абапіраецца на дакладнае пазначэнне крыніцы і засваенне інфармацыі аб гаме дысплея для атрымання найлепшых вынікаў.
intent
Намер візуалізацыі для выкарыстання пры адаптацыі паміж рознымі асноўнымі каляровымі гамамі (пасля танальнага адлюстравання).
- '
perceptual
' Адлюстраванне перцэпцыйнай гамы. У цяперашні час эквівалентна адноснай каларыметрыі.
- '
relative
' Адносная каларыметрыя. Гэта па змаўчанні.
- '
absolute
' Абсалютная каларыметрыя.
- '
saturation
' Адлюстраванне насычанасці. Прымусова расцягвае зыходную гаму да мэтавай.
- '
gamut_mode
Як апрацоўваць колеры па-за гамай, якія могуць узнікнуць у выніку каларыметрычнага адлюстравання гамы.
- '
clip
' Нічога не рабіце, проста абразайце колеры, якія не ўваходзяць у дыяпазон, у аб'ём RGB. Гэта па змаўчанні.
- '
warn
' Вылучыце пікселі, якія не ўваходзяць у гаму (афарбаваўшы іх у ружовы колер).
- '
darken
' Лінейна зніжае яркасць змесціва да захавання насычаных дэталяў з наступным выразаннем астатніх колераў, якія не ўваходзяць у гаму. Як вынікае з назвы, гэта робіць усё цямней, але забяспечвае добры баланс паміж захаваннем дэталяў і колераў.
- '
desaturate
' Жорстка абясцэньвае колеры па-за гамай да белага, захоўваючы пры гэтым яркасць. Мае схільнасць да змены колеру.
- '
tonemapping
Алгарытм танальнага адлюстравання для выкарыстання. Даступныя значэнні:
- '
auto
' Аўтаматычны выбар на аснове ўнутранай эўрыстыкі. Гэта па змаўчанні.
- '
clip
' Не выконвае танальнага адлюстравання, проста выразае колеры па-за дыяпазонам. Захоўвае ідэальную дакладнасць колеру для колераў у дыяпазоне, але цалкам знішчае інфармацыю па-за дыяпазонам. Адаптацыя чорнай кропкі не выконваецца. Не наладжваецца.
- '
bt.2390
' EETF са справаздачы ITU-R BT.2390, сплайн-згортка Эрміта з лінейным сегментам. Зрушэнне кропкі калена наладжваецца. Звярніце ўвагу, што гэты параметр па змаўчанні
1.0
, а не значэнне0.5
са спецыфікацыі ITU-R.- '
bt.2446a
' EETF са справаздачы ITU-R BT.2446, метад A. Прызначаны для добра асвоеных крыніц HDR. Можа выкарыстоўвацца як для прамога, так і для зваротнага адлюстравання тонаў. Не наладжваецца.
- '
spline
' Просты сплайн, які складаецца з двух шматчленаў, злучаных адной кропкай павароту. Параметр дае кропку павароту (у прасторы PQ), па змаўчанні
0.30
. Можа выкарыстоўвацца як для прамога, так і для зваротнага адлюстравання тонаў.- '
reinhard
' Просты нелінейны глабальны алгарытм адлюстравання тонаў. Параметр вызначае лакальны каэфіцыент кантраснасці на піку дысплея. Па сутнасці, параметр
0.5
азначае, што эталонны белы колер будзе прыкладна ўдвая менш яркім, чым пры абразанні. Па змаўчанні0.5
, што прыводзіць да самай простай фармулёўкі гэтай функцыі.- '
mobius
' Абагульненне алгарытму адлюстравання тонаў Рэйнхарда для падтрымкі дадатковага лінейнага нахілу каля чорнага. Параметр танальнага адлюстравання паказвае кампраміс паміж лінейным і нелінейным участкамі. Па сутнасці, для дадзенага параметра
x
кожнае значэнне колеру ніжэйx
будзе адлюстроўвацца лінейна, у той час як больш высокія значэнні будуць адлюстроўвацца нелінейна. Значэнні каля1.0
прымушаюць гэтую крывую паводзіць сябе якclip
, а значэнні каля0.0
прымушаюць гэтую крывую паводзіць сябе якreinhard
. Значэнне па змаўчанні роўна0.3
, што забяспечвае добры баланс паміж каларыметрычнай дакладнасцю і захаваннем дэталяў па-за гамай.- '
hable
' Алгарытм адлюстравання тонаў у плёнцы, распрацаваны Джонам Хэйблам для выкарыстання ў Uncharted 2, натхнёны падобным алгарытмам адлюстравання тонаў, які выкарыстоўваецца Kodak. Папулярызаваны дзякуючы выкарыстанню ў відэагульнях з HDR-рэндэрынгам. Вельмі добра захоўвае як цёмныя, так і яркія дэталі, але мае недахоп даволі значнага змены сярэдняй яркасці. Гэта падобна на
reinhard
параметр with0.24
.- '
gamma
' Адпавядае гама-функцыі (магутнасці) для перадачы паміж зыходнай і мэтавай каляровымі прасторамі, што фактычна прыводзіць да перцэпцыйнага цвёрдага калена, якое злучае дзве прыблізна лінейныя секцыі. Гэта захоўвае дэталі ва ўсіх маштабах даволі дакладна, але можа прывесці да выявы з прыглушаным або сумным выглядам. Параметр выкарыстоўваецца як кропка адсячэння, па змаўчанні -
0.5
.- '
linear
' Лінейна расцягвае ўваходны дыяпазон да выхаднога ў прасторы PQ. Гэта дакладна захавае ўсе дэталі, але прывядзе да значна іншай сярэдняй яркасці. Можа выкарыстоўвацца для адваротнага танальнага адлюстравання ў дадатак да звычайнага танальнага адлюстравання. Параметр можа выкарыстоўвацца як дадатковы лінейны каэфіцыент узмацнення (па змаўчанні
1.0
).
- '
tonemapping_param
Для наладжвальных функцый танальнага адлюстравання гэты параметр можна выкарыстоўваць для тонкай налады паводзін крывой. Звярніцеся да дакументацыі
tonemapping
. Значэнне па змаўчанні0.0
замяняецца пераважнай наладай крывой па змаўчанні.tonemapping_mode
Гэты параметр вызначае, як функцыя танальнага адлюстравання, зададзеная
tonemapping
параметрам, прымяняецца да колераў у сцэне. Магчымыя значэнні:- '
auto
' Аўтаматычны выбар на аснове ўнутранай эўрыстыкі. Гэта па змаўчанні.
- '
rgb
' Прымяніць функцыю для кожнага канала ў каляровай прасторы RGB. Паканальнае адлюстраванне тонаў у RGB. Гарантуе адсутнасць абразання і моцна абясцэньвае выхад, але даволі значна скажае колеры. Вельмі падобны на «галівудскі» выгляд і адчуванне.
- '
max
' Тональнае адлюстраванне выконваецца на самым яркім кампаненце сігналу. Добра захоўвае дэталі ў бліках, але мае тэндэнцыю здушваць чорныя.
- '
hybrid
' Карта тонаў на канал для блікаў і лінейна (на аснове яркасці) для паўтонаў/ценяў на аснове фіксаванай
2.4
крывой каэфіцыента гама.- '
luma
' Лінейна складайце танальную карту па кампаненту яркасці (CIE Y) і адрэгулюйце (паменшыце насычанасць) каляровасць для кампенсацыі з дапамогай простага пастаяннага каэфіцыента. Па сутнасці, гэта рэжым, які выкарыстоўваецца ў метадзе A ITU-R BT.2446.
- '
inverse_tonemapping
Калі гэты фільтр уключаны, ён таксама будзе спрабаваць расцягнуць сігналы SDR, каб запоўніць аб'ёмы выхаднога колеру HDR. Па змаўчанні адключана.
tonemapping_crosstalk
Дадатковы каэфіцыент перакрыжаваных перашкод, паміж
0.0
і0.3
. Гэта можа дапамагчы паменшыць праблемы тонавай карты некаторых яркіх спектральных колераў. Па змаўчанні0.04
.tonemapping_lut_size
Памер LUT танальнага адлюстравання паміж
2
і1024
. Па змаўчанні256
. Звярніце ўвагу, што гэты паказчык узведзены ў квадрат у спалучэнні зpeak_detect
.
11.138.1.7 Dithering
Па змаўчанні, libplacebo будзе вагацца кожны раз, калі гэта неабходна, што ўключае рэндэрынг у любы цэлы фармат з дакладнасцю ніжэй за 16 біт. Рэкамендуецца заўсёды пакідаць гэта ўключаным, таму што ў адваротным выпадку на вывадзе могуць з'явіцца бачныя палосы, нават калі debanding
фільтр уключаны. Калі патрабуецца максімальная прадукцыйнасць, выкарыстоўвайце ordered_fixed
замест адключэння мітусня.
dithering
Выкарыстоўваць метад дызерінга. Прымае наступныя значэнні:
- '
none
' Цалкам адключае згладжванне. Можа прывесці да бачных палос.
- '
blue
' Дызер з псеўда-сінім шумам. Гэта па змаўчанні.
- '
ordered
' Наладжвальны ўпарадкаваны шаблон дрыгання.
- '
ordered_fixed
' Больш хуткае ўпарадкаванае дрыжанне з фіксаваным памерам
6
. Без тэкстур.- '
white
' Дызер з белым шумам. Без тэкстур.
- '
dither_lut_size
Памер LUT Dither, як log base2 паміж
1
і8
. Па змаўчанні6
, што адпавядае памеру LUT64x64
.dither_temporal
Уключае часовае змятанне. Па змаўчанні адключана.
11.138.1.8 Custom shaders
libplacebo падтрымлівае шэраг карыстальніцкіх шэйдараў, заснаваных на сінтаксісе mpv .hook GLSL. Калекцыю такіх шэйдараў можна знайсці тут: https://github.com/mpv-player/mpv/wiki/User-Scripts#user-shaders
Поўнае апісанне фармату шэйдара mpv выходзіць за рамкі гэтага раздзела, але зводку можна знайсці тут: https://mpv.io/manual/master/#options-glsl-shader
custom_shader_path
Вызначае шлях да карыстацкага файла шэйдара для загрузкі падчас выканання.
custom_shader_bin
Вызначае поўны карыстальніцкі шэйдар у выглядзе неапрацаванага радка.
11.138.1.9 Debugging / performance
Усе параметры ў гэтым раздзеле па змаўчанні выключаны. Яны могуць быць карыснымі пры спробе выціснуць максімальную прадукцыйнасць за кошт якасці.
skip_aa
Адключыць згладжванне пры памяншэнні маштабу.
polar_cutoff
Усечаныя палярныя (EWA) ядра скалера ніжэй гэтай абсалютнай велічыні, паміж
0.0
і1.0
.disable_linear
Адключыць лінейнае маштабаванне святла.
disable_builtin
Адключыць убудаваную выбарку GPU (прымусіць LUT).
force_icc_lut
Прымусовае выкарыстанне поўнага ICC 3DLUT для адлюстравання гамы.
disable_fbos
Прымусовае адключэнне FBO, што прывядзе да страты амаль усіх функцый, але прапануе максімальна магчымую хуткасць.
11.138.2 Commands
Гэты фільтр падтрымлівае практычна ўсе вышэйпералічаныя параметры ў якасці каманд .
11.138.3 Examples
- Поўны прыклад таго, як ініцыялізаваць прыладу Vulkan, загрузіць кадры ў графічны працэсар, выканаць пераўтварэнне фільтра ў yuv420p і загрузіць кадры назад у працэсар для вываду. Звярніце ўвагу, што ў пэўных выпадках вы можаце абыйсці неабходнасць выканання пераўтварэння фармату, указаўшы правільны
format
параметр фільтра, які адпавядае ўваходным кадрам.ffmpeg -i $INPUT -init_hw_device vulkan -vf hwupload,libplacebo=format=yuv420p,hwdownload,format=yuv420p $OUTPUT
- Уваход танальнай карты на выхад стандартнай гамы BT.709:
libplacebo=colorspace=bt709:color_primaries=bt709:color_trc=bt709:range=tv
- Змяніце маштаб уводу, каб ён адпавядаў стандарту 1080p, з высокай якасцю маштабавання:
libplacebo=w=1920:h=1080:force_original_aspect_ratio=decrease:normalize_sar=true:upscaler=ewa_lanczos:downscaler=ewa_lanczos
- Пераўтварэнне ўводу ў стандартны sRGB JPEG:
libplacebo=format=yuv420p:colorspace=bt470bg:color_primaries=bt709:color_trc=iec61966-2-1:range=pc
- Выкарыстоўвайце налады адмены больш высокай якасці:
libplacebo=deband=true:deband_iterations=3:deband_radius=8:deband_threshold=6
- Запусціце гэты фільтр на працэсары ў сістэмах з усталяванай Mesa (і з адключанымі самымі дарагімі опцыямі):
ffmpeg ... -init_hw_device vulkan:llvmpipe ... -vf libplacebo=upscaler=none:downscaler=none:peak_detect=false
- Адмоўцеся ад прымянення зерністасці фільма AV1/H.274 на базе працэсара ў дэкодэры, замест таго, каб рабіць гэта з дапамогай гэтага фільтра. Звярніце ўвагу, што гэта выгада толькі ў тым выпадку, калі кадры ўжо знаходзяцца на графічным працэсары, або калі вы выкарыстоўваеце libplacebo для іншых мэтаў, бо ў адваротным выпадку вяртанне VRAM будзе з лішкам кампенсаваць чаканае паскарэнне.
ffmpeg -export_side_data +film_grain ... -vf libplacebo=apply_filmgrain=true
11.139 libvmaf
Вылічыце ацэнку VMAF (Video Multi-Method Assessment Fusion) для эталоннай/скажонай пары ўваходных відэа.
Першы ўваход - гэта скажонае відэа, а другі - эталоннае відэа.
Атрыманая адзнака VMAF раздрукоўваецца з дапамогай сістэмы рэгістрацыі.
У якасці папярэдняй умовы патрабуецца бібліятэка Netflix vmaf (libvmaf). Пасля ўстаноўкі бібліятэкі яе можна ўключыць з дапамогай:
./configure --enable-libvmaf
.
Фільтр мае наступныя параметры:
model
'|' абмежаваны спіс мадэляў vmaf. Кожную мадэль можна наладзіць па шэрагу параметраў. Значэнне па змаўчанні:
"version=vmaf_v0.6.1"
model_path
Састарэла, выкарыстоўвайце model='path=...'.
enable_transform
Састарэла, выкарыстоўвайце model='enable_transform=true'.
phone_model
Састарэла, выкарыстоўвайце model='enable_transform=true'.
enable_conf_interval
Састарэла, выкарыстоўвайце model='enable_conf_interval=true'.
feature
'|' абмежаваны спіс функцый. Кожную функцыю можна наладзіць з дапамогай шэрагу параметраў.
psnr
Састарэла, выкарыстоўвайце feature='name=psnr'.
ssim
Састарэла, выкарыстоўвайце feature='name=ssim'.
ms_ssim
Састарэла, выкарыстоўвайце feature='name=ms_ssim'.
log_path
Усталюйце шлях да файла, які будзе выкарыстоўвацца для захоўвання файлаў часопісаў.
log_fmt
Усталюйце фармат файла часопіса (xml, json, csv або sub).
n_threads
Задаць колькасць патокаў, якія будуць выкарыстоўвацца пры ініцыялізацыі libvmaf. Значэнне па змаўчанні:
0
, без патокаў.n_subsample
Усталюйце інтэрвал падвыбаркі кадраў, які будзе выкарыстоўвацца.
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
11.139.1 Examples
- У прыведзеных ніжэй прыкладах скажонае відэа
distorted.mpg
параўноўваецца з эталонным файламreference.mpg
. - Асноўнае выкарыстанне:
ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf=log_path=output.xml -f null -
- Прыклад з некалькімі мадэлямі:
ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf='model=version=vmaf_v0.6.1\\:name=vmaf|version=vmaf_v0.6.1neg\\:name=vmaf_neg' -f null -
- Прыклад з некалькімі дадатковымі функцыямі:
ffmpeg -i distorted.mpg -i reference.mpg -lavfi libvmaf='feature=name=psnr|name=ciede' -f null -
- Прыклад з опцыямі і рознымі кантэйнерамі:
ffmpeg -i distorted.mpg -i reference.mkv -lavfi "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]libvmaf=log_fmt=json:log_path=output.json" -f null -
11.140 limitdiff
Прымяніць фільтр з абмежаванай розніцай, выкарыстоўваючы другі і, магчыма, трэці відэаструмень.
Фільтр прымае наступныя параметры:
threshold
Усталюйце парог, які будзе выкарыстоўвацца пры дазволе пэўных адрозненняў паміж відэапатокамі. Любое значэнне абсалютнай розніцы, ніжэйшае або дакладнае за гэты парог, будзе выбіраць піксельныя кампаненты з першага відэапатоку.
elasticity
Усталюйце эластычнасць мяккага парога пры апрацоўцы відэапатокаў. Гэта значэнне, памножанае на першае, усталёўвае другі парог. Любое значэнне абсалютнай розніцы, большае або дакладнае за другі парог, будзе выбіраць піксельныя кампаненты з другога відэапатоку. Для значэнняў паміж гэтымі двума парогавымі значэннямі будзе выкарыстоўвацца лінейная інтэрпаляцыя паміж першым і другім відэапатокам.
reference
Уключыць апрацоўку эталоннага (трэцяга) відэаструменю. Па змаўчанні адключана. Калі ўсталявана, гэтая відэаплынь будзе выкарыстоўвацца для вылічэння абсалютнай розніцы з першай відэаплынню.
planes
Укажыце, якія плоскасці будуць апрацоўвацца. Па змаўчанні ўсе даступныя.
11.140.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя опцыі 'reference
'.
11.141 limiter
Абмяжоўвае значэнні кампанентаў пікселя ўказаным дыяпазонам [мін., макс.].
Фільтр прымае наступныя параметры:
min
Ніжняя мяжа. Па змаўчанні ўстаноўлена самае нізкае дазволенае значэнне для ўводу.
max
Верхняя мяжа. Па змаўчанні ўстаноўлена максімальнае дазволенае значэнне для ўводу.
planes
Укажыце, якія плоскасці будуць апрацоўвацца. Па змаўчанні ўсе даступныя.
11.141.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.142 loop
Колькасць відэа кадраў.
Фільтр прымае наступныя параметры:
loop
Усталюйце колькасць завес. Усталяванне гэтага значэння ў -1 прывядзе да бясконцых цыклаў. Па змаўчанні 0.
size
Усталюйце максімальны памер у колькасці кадраў. Па змаўчанні 0.
start
Усталюйце першы кадр цыкла. Па змаўчанні 0.
11.142.1 Examples
- Бясконцы цыкл аднаго першага кадра:
loop=loop=-1:size=1:start=0
- Паўтор адзінага першага кадра 10 разоў:
loop=loop=10:size=1:start=0
- Пракруціце 10 першых кадраў 5 разоў:
loop=loop=5:size=10:start=0
11.143 lut1d
Прымяніць 1D LUT да ўваходнага відэа.
Фільтр прымае наступныя параметры:
file
Усталюйце назву файла 1D LUT.
У цяперашні час падтрымліваюцца фарматы:
- '
cube
' Ірыды
- '
csp
' кінапрастора
- '
interp
Выберыце рэжым інтэрпаляцыі.
Даступныя значэнні:
- '
nearest
' Выкарыстоўвайце значэнні з бліжэйшай вызначанай кропкі.
- '
linear
' Інтэрпаляваць значэнні з дапамогай лінейнай інтэрпаляцыі.
- '
cosine
' Інтэрпаляваць значэнні з дапамогай косінуснай інтэрпаляцыі.
- '
cubic
' Інтэрпаляваць значэнні з дапамогай кубічнай інтэрпаляцыі.
- '
spline
' Інтэрпаляваць значэнні з дапамогай сплайн-інтэрпаляцыі.
- '
11.143.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.144 lut3d
Прымяніць 3D LUT да ўваходнага відэа.
Фільтр прымае наступныя параметры:
file
Усталюйце назву файла 3D LUT.
У цяперашні час падтрымліваюцца фарматы:
- '
3dl
' AfterEffects
- '
cube
' Ірыды
- '
dat
' ДаВінчы
- '
m3d
' Пандора
- '
csp
' кінапрастора
- '
interp
Выберыце рэжым інтэрпаляцыі.
Даступныя значэнні:
- '
nearest
' Выкарыстоўвайце значэнні з бліжэйшай вызначанай кропкі.
- '
trilinear
' Інтэрпалюйце значэнні, выкарыстоўваючы 8 кропак, якія вызначаюць куб.
- '
tetrahedral
' Інтэрпаляваць значэнні з дапамогай тэтраэдра.
- '
pyramid
' Інтэрпаляваць значэнні з дапамогай піраміды.
- '
prism
' Інтэрпаляваць значэнні з дапамогай прызмы.
- '
11.144.1 Commands
Гэты фільтр падтрымлівае interp
параметр як каманды .
11.145 lumakey
Ператварыце пэўныя значэнні яркасці ў празрыстыя.
Фільтр прымае наступныя параметры:
threshold
Усталюйце яркасць, якая будзе выкарыстоўвацца ў якасці асновы для празрыстасці. Значэнне па змаўчанні -
0
.tolerance
Усталюйце дыяпазон значэнняў яркасці, якія трэба выключыць. Значэнне па змаўчанні -
0.01
.softness
Усталюйце дыяпазон мяккасці. Значэнне па змаўчанні -
0
. Выкарыстоўвайце гэта, каб кіраваць паступовым пераходам ад нуля да поўнай празрыстасці.
11.145.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.146 lut, lutrgb, lutyuv
Вылічыце пошукавую табліцу для прывязкі ўваходнага значэння кожнага кампанента пікселя да выхаднога значэння і прымяніце яе да ўваходнага відэа.
lutyuv
прымяняе табліцу пошуку да ўваходнага відэа YUV, lutrgb
да ўваходнага відэа RGB.
Гэтыя фільтры прымаюць наступныя параметры:
c0
усталяваць выраз першага кампанента пікселя
c1
усталяваць выраз кампанента другога пікселя
c2
ўсталяваць выраз кампанента трэцяга пікселя
c3
усталяваць выраз чацвёртага піксельнага кампанента, які адпавядае альфа-кампаненту
r
усталяваць выраз чырвонага кампанента
g
усталяваць выраз зялёнага кампанента
b
усталяваць выраз сіняга кампанента
a
альфа-кампанентны выраз
y
усталяваць Y/выраз кампанента яркасці
u
усталяваць выраз кампанента U/Cb
v
усталяваць складнік V/Cr
Кожны з іх вызначае выраз, які выкарыстоўваецца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.
Дакладны кампанент, звязаны з кожным з параметраў c*
, залежыць ад фармату ўводу.
Фільтр lut
патрабуе піксельных фарматаў YUV або RGB на ўваходзе,
lutrgb
піксельных фарматаў RGB на ўваходзе і lutyuv
YUV.
Выразы могуць утрымліваць наступныя канстанты і функцыі:
w
h
Шырыня і вышыня ўводу.
val
Уваходнае значэнне для піксельнага кампанента.
clipval
Уваходнае значэнне, абрэзанае ў дыяпазоне
minval
-maxval
.maxval
Максімальнае значэнне піксельнага кампанента.
minval
Мінімальнае значэнне піксельнага кампанента.
negval
Адмоўленае значэнне піксельнага кампанента, абрэзанае ў дыяпазоне
minval
-maxval
; гэта адпавядае выразу "maxval-clipval+minval".clip(val)
Вылічанае значэнне ў
val
, абрэзанае ў дыяпазонеminval
-maxval
.gammaval(gamma)
Вылічанае значэнне гама-карэкцыі значэння кампанента пікселя, абрэзанае ў дыяпазоне
minval
-maxval
. Гэта адпавядае выразу "pow((clipval-minval)/(maxval-minval)\,gamma
)*(maxval-minval)+minval"
Усе выразы па змаўчанні маюць "clipval".
11.146.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.146.2 Examples
- Адхіліць уваходнае відэа:
lutrgb="r=maxval+minval-val:g=maxval+minval-val:b=maxval+minval-val" lutyuv="y=maxval+minval-val:u=maxval+minval-val:v=maxval+minval-val"
Вышэй тое самае, што:
lutrgb="r=negval:g=negval:b=negval" lutyuv="y=negval:u=negval:v=negval"
- Адмоўная яркасць:
lutyuv=y=negval
- Выдаліце ​​кампаненты каляровасці, ператварыўшы відэа ў шэры малюнак:
lutyuv="u=128:v=128"
- Прымяніць эфект гарэння люма:
lutyuv="y=2*val"
- Выдаліце ​​зялёны і сіні кампаненты:
lutrgb="g=0:b=0"
- Усталюйце пастаяннае значэнне альфа-канала на ўваходзе:
format=rgba,lutrgb=a="maxval-minval/2"
- Правільная гама яркасці з каэфіцыентам 0,5:
lutyuv=y=gammaval(0.5)
- Адкіньце малодшыя біты яркасці:
lutyuv=y='bitand(val, 128+64+32)'
- Тэхнічны каляровы эфект:
lutyuv=u='(val-maxval/2)*2+maxval/2':v='(val-maxval/2)*2+maxval/2'
11.147 lut2, tlut2
Фільтр lut2
прымае два ўваходныя патокі і выводзіць адзін паток.
Фільтр tlut2
(час lut2) прымае два паслядоўныя кадры з аднаго патоку.
Гэты фільтр прымае наступныя параметры:
c0
усталяваць выраз першага кампанента пікселя
c1
усталяваць выраз кампанента другога пікселя
c2
ўсталяваць выраз кампанента трэцяга пікселя
c3
усталяваць выраз чацвёртага піксельнага кампанента, які адпавядае альфа-кампаненту
d
задаць глыбіню вываду ў бітах, даступна толькі для
lut2
фільтра. Па змаўчанні значэнне 0, што азначае, што глыбіня ў бітах аўтаматычна выбіраецца з першага ўваходнага фармату.
Фільтр lut2
таксама падтрымлівае параметры framesync .
Кожны з іх вызначае выраз, які выкарыстоўваецца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.
Дакладны кампанент, звязаны з кожным з c*
варыянтаў, залежыць ад фармату ўваходных дадзеных.
Выразы могуць утрымліваць наступныя канстанты:
w
h
Шырыня і вышыня ўводу.
x
Першае ўваходнае значэнне для піксельнага кампанента.
y
Другое ўваходнае значэнне для піксельнага кампанента.
bdx
Бітавая глыбіня першага ўваходнага відэа.
bdy
Разраднасць відэа другога ўваходу.
Усе выразы па змаўчанні маюць "х".
11.147.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя параметра d
.
11.147.2 Examples
- Вылучыце адрозненні паміж двума відэапатокамі RGB:
lut2='ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,0,pow(2,bdx)-1)'
- Вылучыце адрозненні паміж двума відэапатокамі YUV:
lut2='ifnot(x-y,0,pow(2,bdx)-1):ifnot(x-y,pow(2,bdx-1),pow(2,bdx)-1):ifnot(x-y,pow(2,bdx-1),pow(2,bdx)-1)'
- Паказаць максімальную розніцу паміж двума відэаплынямі:
lut2='if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1))):if(lt(x,y),0,if(gt(x,y),pow(2,bdx)-1,pow(2,bdx-1)))'
11.148 maskedclamp
Зацісніце першы ўваходны паток другім уваходным і трэцім уваходным патокам.
Вяртае значэнне першага патоку паміж другім уваходным патокам - undershoot
і трэцім уваходным патокам + overshoot
.
Гэты фільтр прымае наступныя параметры:
undershoot
Значэнне па змаўчанні -
0
.overshoot
Значэнне па змаўчанні -
0
.planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
11.148.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.149 maskedmax
Аб'яднайце другі і трэці ўваходны паток у выхадны паток, выкарыстоўваючы абсалютныя адрозненні паміж другім уваходным патокам і першым уваходным патокам і абсалютную розніцу паміж трэцім уваходным патокам і першым уваходным патокам. Выбранае значэнне будзе з другога ўваходнага патоку, калі другая абсалютная розніца большая за першую, або з трэцяга ўваходнага патоку ў адваротным выпадку.
Гэты фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
11.149.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.150 maskedmerge
Аб'яднайце першы ўваходны паток з другім уваходным патокам, выкарыстоўваючы піксельныя вагі ў трэцім уваходным патоку.
Значэнне 0 у піксельным кампаненце трэцяга патоку азначае, што піксельны кампанент з першага патоку вяртаецца без зменаў, а максімальнае значэнне (напрыклад, 255 для 8-бітных відэа) азначае, што піксельны кампанент з другога патоку вяртаецца без зменаў. Прамежкавыя значэнні вызначаюць аб'ём зліцця піксельных кампанентаў абодвух уваходных патокаў.
Гэты фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
11.150.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.151 maskedmin
Аб'яднайце другі і трэці ўваходны паток у выхадны паток, выкарыстоўваючы абсалютныя адрозненні паміж другім уваходным патокам і першым уваходным патокам і абсалютную розніцу паміж трэцім уваходным патокам і першым уваходным патокам. Выбранае значэнне будзе з другога ўваходнага патоку, калі другая абсалютная розніца меншая за першую, або з трэцяга ўваходнага патоку ў адваротным выпадку.
Гэты фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з першага патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
11.151.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.152 maskedthreshold
Выберыце пікселі, параўноўваючы абсалютную розніцу двух відэапатокаў з фіксаваным парогам.
Калі абсалютная розніца паміж піксельным кампанентам першага і другога відэапатоку роўная або ніжэйшая за парогавае значэнне, вызначанае карыстальнікам, выбіраецца піксельны кампанент з першага відэапатоку, у адваротным выпадку выбіраецца піксельны кампанент з другога відэапатоку.
Гэты фільтр прымае наступныя параметры:
threshold
Устанавіць парогавае значэнне, якое выкарыстоўваецца пры выбары пікселяў з абсалютнай розніцы з двух уваходных відэапатокаў.
planes
Усталюйце, якія плоскасці будуць апрацаваны як растравы малюнак, неапрацаваныя плоскасці будуць скапіяваны з другога патоку. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
11.152.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.153 maskfun
Стварыць маску з уваходнага відэа.
Напрыклад, карысна ствараць маскі руху пасля tblend
фільтра.
Гэты фільтр прымае наступныя параметры:
low
Усталюйце нізкі парог. Любы піксельны кампанент, ніжэйшы за гэтае значэнне або дакладны за яго, будзе мець значэнне 0.
high
Усталюйце высокі парог. Для любога піксельнага кампанента, вышэйшага за гэта значэнне, будзе ўстаноўлена максімальнае значэнне, дазволенае для бягучага фармату пікселяў.
planes
Усталюйце плоскасці для фільтрацыі, па змаўчанні ўсе даступныя плоскасці фільтруюцца.
fill
Запоўніце ўсе пікселі кадра гэтым значэннем.
sum
Усталюйце максімальнае сярэдняе значэнне пікселяў для кадра. Калі сума ўсіх кампанентаў пікселяў вышэй за гэта сярэдняе, выхадны кадр будзе цалкам запоўнены значэннем, устаноўленым
fill
опцыяй. Звычайна карысна для змены сцэны пры выкарыстанні ў спалучэнні зtblend
фільтрам.
11.153.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.154 mcdeint
Прымяніць дэінтэрлейсінг з кампенсацыяй руху.
Патрабуецца адно поле на кадр у якасці ўваходных дадзеных, таму яго трэба выкарыстоўваць разам з yadif=1/3 або эквівалентным.
Гэты фільтр даступны толькі ў ffmpeg версіі 4.4 або больш ранняй.
Гэты фільтр прымае наступныя параметры:
mode
Усталюйце рэжым дэінтэрлейсінгу.
Ён прымае адно з наступных значэнняў:
- '
fast
' - '
medium
' - '
slow
' выкарыстоўваць ітэрацыйную ацэнку руху
- '
extra_slow
' як '
slow
', але выкарыстоўваць некалькі апорных кадраў.
Значэнне па змаўчанні '
fast
'.- '
parity
Усталюйце парытэт поля выявы, які мяркуецца для ўваходнага відэа. Гэта павінна быць адно з наступных значэнняў:
- '
0, tff
' выкажам здагадку, спачатку верхняе поле
- '
1, bff
' спачатку выкажам здагадку, што ніжняе поле
Значэнне па змаўчанні '
bff
'.- '
qp
Усталюйце параметр квантавання для кожнага блока (QP), які выкарыстоўваецца ўнутраным кадавальнікам.
Больш высокія значэнні павінны прывесці да больш гладкага вектарнага поля руху, але менш аптымальных асобных вектараў. Значэнне па змаўчанні - 1.
11.155 median
Выберыце сярэдні піксель з пэўнага прамавугольніка, вызначанага радыусам.
Гэты фільтр прымае наступныя параметры:
radius
Усталюйце памер гарызантальнага радыусу. Значэнне па змаўчанні -
1
. Дазволены цэлы дыяпазон ад 1 да 127.planes
Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні -
15
усе даступныя самалёты.radiusV
Усталюйце памер вертыкальнага радыусу. Значэнне па змаўчанні -
0
. Дазволены дыяпазон - цэлы лік ад 0 да 127. Калі ён роўны 0, значэнне будзе выбірацца з гарызантальнагаradius
варыянту.percentile
Задаць сярэдні працэнт. Значэнне па змаўчанні -
0.5
. Значэнне па змаўчанні0.5
заўсёды будзе выбіраць сярэднія значэнні, а0
мінімальныя значэнні і1
максімальныя.
11.155.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.156 mergeplanes
Аб'яднанне кампанентаў каляровага канала з некалькіх відэапатокаў.
Фільтр прымае да 4 уваходных патокаў і аб'ядноўвае выбраныя ўваходныя плоскасці з выхадным відэа.
Гэты фільтр прымае наступныя параметры:
mapping
Задаць адлюстраванне плоскасці ўводу і вываду. Па змаўчанні
0
.Адлюстраванні задаюцца ў выглядзе растравага малюнка. Ён павінен быць указаны ў выглядзе шаснаццатковага ліку ў выглядзе 0xAa[Bb[Cc[Dd]]]. 'Aa' апісвае адлюстраванне для першай плоскасці выходнага патоку. 'A' задае нумар уваходнага патоку для выкарыстання (ад 0 да 3), а 'a' нумар плоскасці адпаведнага ўваходу для выкарыстання (ад 0 да 3). Астатнія супастаўленні падобныя: «Bb» апісвае адлюстраванне для другой плоскасці выхаднога патоку, «Cc» апісвае адлюстраванне для трэцяй плоскасці выходнага патоку, а «Dd» апісвае адлюстраванне для чацвёртай плоскасці выхаднога патоку.
format
Задаць фармат выхаднога пікселя. Па змаўчанні
yuva444p
.map0s
map1s
map2s
map3s
Усталюйце адлюстраванне уваходнага і выхаднога патоку для выходнай N-й плоскасці. Па змаўчанні
0
.map0p
map1p
map2p
map3p
Усталюйце адлюстраванне плоскасці ўваходу і выхаду для N-й плоскасці выхаду. Па змаўчанні
0
.
11.156.1 Examples
- Аб'яднанне трох шэрых відэапатокаў аднолькавай шырыні і вышыні ў адзін відэапаток:
[a0][a1][a2]mergeplanes=0x001020:yuv444p
- Аб'яднаць 1-ы паток yuv444p і 2-й шэры відэапаток у відэапаток yuva444p:
[a0][a1]mergeplanes=0x00010210:yuva444p
- Памяняйце месцамі плоскасці Y і A у плыні yuva444p:
format=yuva444p,mergeplanes=0x03010200:yuva444p
- Памяняць месцамі плоскасці U і V у патоку yuv420p:
format=yuv420p,mergeplanes=0x000201:yuv420p
- Перадайце кліп rgb24 на yuv444p:
format=rgb24,mergeplanes=0x000102:yuv444p
11.157 mestimate
Ацаніце і экспартуйце вектары руху з дапамогай алгарытмаў супастаўлення блокаў. Вектары руху захоўваюцца ў бакавых дадзеных кадра для выкарыстання іншымі фільтрамі.
Гэты фільтр прымае наступныя параметры:
method
Укажыце метад ацэнкі руху. Прымае адно з наступных значэнняў:
- '
esa
' Вычарпальны алгарытм пошуку.
- '
tss
' Трохкрокавы алгарытм пошуку.
- '
tdls
' Алгарытм двухмернага лагарыфмічнага пошуку.
- '
ntss
' Новы трохэтапны алгарытм пошуку.
- '
fss
' Чатырохкрокавы алгарытм пошуку.
- '
ds
' Алгарытм пошуку алмазаў.
- '
hexbs
' Алгарытм пошуку на аснове шасцікутніка.
- '
epzs
' Палепшаны алгарытм прагназуючага занальнага пошуку.
- '
umh
' Алгарытм пошуку няроўных некалькіх шасцікутнікаў.
Значэнне па змаўчанні '
esa
'.- '
mb_size
Памер макраблока. Па змаўчанні
16
.search_param
Параметр пошуку. Па змаўчанні
7
.
11.158 midequalizer
Прымяніць эфект выраўноўвання выявы Midway з дапамогай двух відэапатокаў.
Midway Image Equalization наладжвае пару малюнкаў, каб мець аднолькавую гістаграму, захоўваючы пры гэтым іх дынаміку, наколькі гэта магчыма. Гэта карысна, напрыклад, для супастаўлення экспазіцыі з пары стэрэакамер.
Гэты фільтр мае два ўваходы і адзін выхад, якія павінны мець аднолькавы фармат у пікселях, але могуць мець розныя памеры. Выхад фільтра - гэта першы ўваход, скарэкціраваны з сярэдняй гістаграмай абодвух уваходаў.
Гэты фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні -
15
усе даступныя самалёты.
11.159 minterpolate
Пераўтварыце відэа ў зададзеную частату кадраў з дапамогай інтэрпаляцыі руху.
Гэты фільтр прымае наступныя параметры:
fps
Укажыце частату выхадных кадраў. Гэта можа быць рацыянальна, напрыклад
60000/1001
. Кадры выдаляюцца, каліfps
яны ніжэйшыя за кадры ў секунду крыніцы. Па змаўчанні60
.mi_mode
Рэжым інтэрпаляцыі руху. Прымаюцца наступныя значэнні:
- '
dup
' Дублюйце папярэдні або наступны кадр для інтэрпаляцыі новых.
- '
blend
' Змяшайце зыходныя кадры. Інтэрпаляваны кадр - гэта сярэдняе значэнне папярэдняга і наступнага кадраў.
- '
mci
' Інтэрпаляцыя з кампенсацыяй руху. Пры выбары гэтага рэжыму дзейнічаюць наступныя параметры:
- '
mc_mode
' Рэжым кампенсацыі руху. Прымаюцца наступныя значэнні:
- '
obmc
' Кампенсацыя руху перакрытага блока.
- '
aobmc
' Адаптыўная кампенсацыя руху блока з перакрыццем. Вагавыя каэфіцыенты вокнаў кантралююцца адаптыўна ў адпаведнасці з надзейнасцю суседніх вектараў руху, каб паменшыць празмернае згладжванне.
Рэжым па змаўчанні '
obmc
'.- '
- '
me_mode
' Рэжым ацэнкі руху. Прымаюцца наступныя значэнні:
- '
bidir
' Двунакіраваная ацэнка руху. Вектары руху ацэньваюцца для кожнага зыходнага кадра ў прамым і зваротным напрамках.
- '
bilat
' Двухбаковая ацэнка руху. Вектары руху ацэньваюцца непасрэдна для інтэрпаляванага кадра.
Рэжым па змаўчанні '
bilat
'.- '
- '
me
' Алгарытм, які будзе выкарыстоўвацца для ацэнкі руху. Прымаюцца наступныя значэнні:
- '
esa
' Вычарпальны алгарытм пошуку.
- '
tss
' Трохкрокавы алгарытм пошуку.
- '
tdls
' Алгарытм двухмернага лагарыфмічнага пошуку.
- '
ntss
' Новы трохэтапны алгарытм пошуку.
- '
fss
' Чатырохкрокавы алгарытм пошуку.
- '
ds
' Алгарытм пошуку алмазаў.
- '
hexbs
' Алгарытм пошуку на аснове шасцікутніка.
- '
epzs
' Палепшаны алгарытм прагназуючага занальнага пошуку.
- '
umh
' Алгарытм пошуку няроўных некалькіх шасцікутнікаў.
Алгарытм па змаўчанні '
epzs
'.- '
- '
mb_size
' Памер макраблока. Па змаўчанні
16
.- '
search_param
' Параметр пошуку ацэнкі руху. Па змаўчанні
32
.- '
vsbmc
' Уключыць кампенсацыю руху блока зменнага памеру. Ацэнка руху прымяняецца з меншымі памерамі блокаў на межах аб'екта, каб зрабіць іх менш размытымі. Па змаўчанні
0
(выключана).
- '
- '
scd
Метад выяўлення змены сцэны. Змена сцэны прыводзіць вектары руху ў выпадковым кірунку. Выяўленне змены сцэны замяняе інтэрпаляваныя кадры дублікатамі. Можа не спатрэбіцца для іншых рэжымаў. Прымаюцца наступныя значэнні:
- '
none
' Адключыць выяўленне змены сцэны.
- '
fdiff
' Розніца кадраў. Адпаведныя значэнні пікселяў параўноўваюцца і, калі яны задавальняюць
scd_threshold
, выяўляецца змена сцэны.
Метад па змаўчанні: '
fdiff
'.- '
scd_threshold
Парог выяўлення змены сцэны. Па змаўчанні
10.
.
11.160 mix
Змяшайце некалькі ўваходных відэапатокаў у адзін відэапаток.
Далей апісваюцца прынятыя варыянты.
inputs
Колькасць уваходаў. Калі не пазначана, па змаўчанні 2.
weights
Укажыце вагу кожнага ўваходнага відэапатоку ў якасці паслядоўнасці. Кожная вага аддзяляецца прабелам. Калі колькасць вагаў меншая за колькасць
frames
апошняй вызначанай вагі, будзе выкарыстоўвацца для ўсіх астатніх неўсталяваных вагаў.scale
Укажыце маштаб, калі ён усталяваны, ён будзе памножаны на суму кожнай вагі, памножанай на значэнні пікселяў, каб атрымаць канчатковае значэнне пікселя прызначэння. Па змаўчанні
scale
аўтаматычна маштабуецца да сумы вагаў.planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.
duration
Укажыце, як вызначаецца канец патоку.
- '
longest
' Працягласць самага доўгага ўводу. (па змаўчанні)
- '
shortest
' Працягласць самага кароткага ўводу.
- '
first
' Працягласць першага ўваходу.
- '
11.160.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
weights
scale
planes
Сінтаксіс той жа, што і варыянт з такой жа назвай.
11.161 monochrome
Пераўтварыце відэа ў шэры з дапамогай карыстацкага каляровага фільтра.
Далей апісваюцца прынятыя варыянты.
cb
Усталюйце каляровую сінюю пляму. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
cr
Усталюйце каляровую чырвоную пляму. Дазволены дыяпазон ад -1 да 1. Значэнне па змаўчанні - 0.
size
Усталюйце памер каляровага фільтра. Дазволены дыяпазон ад 0,1 да 10. Значэнне па змаўчанні - 1.
high
Усталюйце сілу блікаў. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 0.
11.161.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.162 morpho
Гэты фільтр дазваляе ўжываць асноўныя марфалагічныя пераўтварэнні адценняў шэрага, размываць і пашыраць адвольныя структуры, устаноўленыя ў другім уваходным патоку.
У адрозненне ад наіўнай рэалізацыі і значна больш нізкай прадукцыйнасці ў фільтрах эрозіі
і пашырэння , калі хуткасць мае вырашальнае значэнне morpho
, трэба выкарыстоўваць фільтр.
Апісанне прынятых варыянтаў ніжэй,
mode
Задаць марфалагічнае пераўтварэнне для прымянення можа быць:
- '
erode
' - '
dilate
' - '
open
' - '
close
' - '
gradient
' - '
tophat
' - '
blackhat
'
Па змаўчанні
erode
.- '
planes
Усталюйце для фільтрацыі плоскасці, па змаўчанні фільтруюцца ўсе плоскасці, акрамя альфа.
structure
Усталяваць, якая структура відэакадраў будзе апрацоўвацца з другога ўваходнага патоку, можа быць
first
абоall
. Па змаўчанніall
.
Фільтр morpho
таксама падтрымлівае параметры framesync .
11.162.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.163 mpdecimate
Адкіньце кадры, якія не моцна адрозніваюцца ад папярэдняга, каб паменшыць частату кадраў.
Галоўнае прымяненне гэтага фільтра - для кадавання з вельмі нізкім бітрэйтам (напрыклад, струменевая перадача праз камутаваны мадэм), але тэарэтычна ён можа быць выкарыстаны для фіксацыі фільмаў, якія былі няправільна перададзены ў зваротным рэжыме.
Далей апісваюцца прынятыя варыянты.
max
Усталюйце максімальную колькасць паслядоўных кадраў, якія можна скідаць (калі станоўчы), або мінімальны інтэрвал паміж скінутымі кадрамі (калі адмоўны). Калі значэнне роўна 0, кадр скідаецца без уліку колькасці папярэдніх паслядоўна скінутых кадраў.
Значэнне па змаўчанні 0.
hi
lo
frac
Усталюйце парогавыя значэнні падзення.
Каштоўнасці для
hi
іlo
прызначаны для блокаў 8x8 пікселяў і ўяўляюць фактычную розніцу значэнняў пікселяў, таму парогавае значэнне ў 64 адпавядае 1 адзінцы розніцы для кожнага пікселя або таго ж рознага размеркавання па блоку.Кадр з'яўляецца кандыдатам на выпадзенне, калі ні адзін з блокаў 8x8 не адрозніваецца больш чым на парогавае значэнне
hi
, а калі не больш заfrac
блокі (1 азначае ўвесь малюнак) адрозніваюцца больш чым на парогавае значэннеlo
.Значэнне па змаўчанні для
hi
64*12, значэнне па змаўчанні дляlo
складае 64*5 і значэнне па змаўчанні дляfrac
складае 0,33.
11.164 msad
Атрымайце MSAD (сярэднюю суму абсалютных розніц) паміж двума ўваходнымі відэа.
Гэты фільтр прымае два ўваходныя відэа.
Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.
Атрыманае па кампаненту, сярэдняе, мінімальнае і максімальнае MSAD друкуецца праз сістэму рэгістрацыі.
Фільтр захоўвае разлічаны MSAD кожнага кадра ў метададзеных кадра.
У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpg
апрацоўваецца параўноўваецца з эталонным файламref.mpg
.
ffmpeg -i main.mpg -i ref.mpg -lavfi msad -f null -
11.165 multiply
Памножце значэнне пікселяў першага відэапатоку на значэнне пікселяў другога відэапатоку.
Фільтр прымае наступныя параметры:
scale
Усталюйце маштаб, прыменены да другога відэапатоку. Па змаўчанні гэта
1
. Дазволены дыяпазон ад0
да9
.offset
Усталюйце зрушэнне, прымененае да другога відэапатоку. Па змаўчанні гэта
0.5
. Дазволены дыяпазон ад-1
да1
.planes
Укажыце плоскасці з уваходнага відэапатоку, якія будуць апрацоўвацца. Па змаўчанні апрацоўваюцца ўсе плоскасці.
11.165.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.166 negate
Негатаванне (інвертаванне) уваходнага відэа.
Ён прымае наступны варыянт:
components
Усталюйце кампаненты на адмаўленне.
Даступныя значэнні для кампанентаў:
- '
y
' - '
u
' - '
v
' - '
a
' - '
r
' - '
g
' - '
b
'
- '
negate_alpha
Са значэннем 1 ён адмаўляе альфа-кампанент, калі ён ёсць. Значэнне па змаўчанні 0.
11.166.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.167 nlmeans
Шумаць кадры з выкарыстаннем алгарытму нелакальных сродкаў.
Кожны піксель карэктуецца шляхам пошуку іншых пікселяў з аналагічным кантэкстам. Гэта падабенства кантэксту вызначаецца шляхам параўнання навакольных іх участкаў памеру
p
хp
. Латы шукаюць у раёне вr
хr
вакол пікселя.
Звярніце ўвагу, што вобласць даследавання вызначае цэнтры для патчаў, што азначае, што некаторыя патчы будуць зроблены з пікселяў па-за межамі гэтай вобласці даследавання.
Фільтр прымае наступныя параметры.
s
Усталюйце сілу шумашумлення. Па змаўчанні 1.0. Павінна быць у дыяпазоне [1.0, 30.0].
p
Усталюйце памер патча. Па змаўчанні 7. Павінен быць няцотны лік у дыяпазоне [0, 99].
pc
Такі ж, як
p
але для плоскасцей каляровасці.Значэнне па змаўчанні
0
і азначае аўтаматычны.r
Усталюйце памер даследавання. Па змаўчанні 15. Павінен быць няцотны лік у дыяпазоне [0, 99].
rc
Такі ж, як
r
але для плоскасцей каляровасці.Значэнне па змаўчанні
0
і азначае аўтаматычны.
11.168 nnedi
Дэінтэрпаляцыя відэа з выкарыстаннем накіраванай нейронавай сеткі інтэрпаляцыі.
Гэты фільтр прымае наступныя параметры:
weights
Абавязковая опцыя, без бінарнага файла фільтр не можа працаваць. У цяперашні час файл можна знайсці тут: https://github.com/dubhater/vapoursynth-nnedi3/blob/master/src/nnedi3_weights.bin
deint
Усталюйце кадры для дэінтэрлейсу, па змаўчанні гэта
all
. Можа быцьall
абоinterlaced
.field
Задаць рэжым працы.
Можа быць адно з наступнага:
- '
af
' Выкарыстоўвайце сцягі рамкі, абодва палі.
- '
a
' Выкарыстоўвайце сцягі рамкі, адно поле.
- '
t
' Выкарыстоўвайце толькі верхняе поле.
- '
b
' Выкарыстоўвайце толькі ніжняе поле.
- '
tf
' Выкарыстоўвайце абодва палі, спачатку зверху.
- '
bf
' Выкарыстоўвайце абодва палі, спачатку ніжняе.
- '
planes
Усталюйце, якія плоскасці апрацоўваць, па змаўчанні фільтр апрацоўвае ўсе кадры.
nsize
Задайце памер лакальнага наваколля вакол кожнага пікселя, які выкарыстоўваецца нейронавай сеткай прагназатара.
Можа быць адно з наступнага:
- '
s8x6
' - '
s16x6
' - '
s32x6
' - '
s48x6
' - '
s8x4
' - '
s16x4
' - '
s32x4
'
- '
nns
Усталюйце колькасць нейронаў у нейронавай сетцы прадказальніка. Можа быць адно з наступнага:
- '
n16
' - '
n32
' - '
n64
' - '
n128
' - '
n256
'
- '
qual
Кантралюе колькасць розных прагнозаў нейронавай сеткі, якія аб'ядноўваюцца для вылічэння канчатковага выхаднога значэння. Можа быць
fast
, default абоslow
.etype
Усталюйце, які набор вагаў выкарыстоўваць у прадказальніку. Можа быць адно з наступнага:
- '
a, abs
' вагі навучаны, каб мінімізаваць абсалютную памылку
- '
s, mse
' вагі навучаны, каб мінімізаваць памылку ў квадраце
- '
pscrn
Кантралюе, ці будзе нейронавая сетка папярэдняга адбору выкарыстоўвацца для вызначэння таго, якія пікселі павінны быць апрацаваны нейронавай сеткай прадказальніка, а якія можна апрацоўваць простай кубічнай інтэрпаляцыяй. Асоба папярэдняга адбору навучана ведаць, ці будзе кубічнай інтэрпаляцыі дастаткова для пікселя, ці яна павінна прадказвацца прадказальнікам nn. Вылічальная складанасць прэдыктара nn значна меншая, чым прадказальніка nn. Паколькі большасць пікселяў можна апрацоўваць з дапамогай кубічнай інтэрпаляцыі, выкарыстанне папярэдняга прагляду звычайна прыводзіць да значна больш хуткай апрацоўкі. Праграма папярэдняга адбору даволі дакладная, таму розніца паміж яе выкарыстаннем і невыкарыстаннем амаль заўсёды незаўважная.
Можа быць адно з наступнага:
- '
none
' - '
original
' - '
new
' - '
new2
' - '
new3
'
Па змаўчанні
new
.- '
11.168.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі, за выключэннем weights
опцыі.
11.169 noformat
Прымусіць libavfilter не выкарыстоўваць любы з указаных фарматаў пікселяў для ўводу ў наступны фільтр.
Ён прымае наступныя параметры:
pix_fmts
Спіс назваў фарматаў пікселяў, падзелены '|', напрыклад pix_fmts=yuv420p|monow|rgb24".
11.169.1 Examples
- Прымусіць libavfilter выкарыстоўваць фармат, які адрозніваецца ад фармату
yuv420p
ўводу ў фільтр vflip:noformat=pix_fmts=yuv420p,vflip
- Пераўтварыце ўваходнае відэа ў любы з фарматаў, якіх няма ў спісе:
noformat=yuv420p|yuv444p|yuv410p
11.170 noise
Дадаць шум на кадры ўваходнага відэа.
Фільтр прымае наступныя параметры:
all_seed
c0_seed
c1_seed
c2_seed
c3_seed
Усталюйце пачатковае значэнне шуму для пэўнага піксельнага кампанента або ўсіх піксельных кампанентаў у выпадку
all_seed
. Значэнне па змаўчанні -123457
.all_strength, alls
c0_strength, c0s
c1_strength, c1s
c2_strength, c2s
c3_strength, c3s
Усталюйце ўзровень шуму для пэўнага кампанента пікселя або ўсіх кампанентаў пікселя ў выпадку
all_strength
. Значэнне па змаўчанні -0
. Дазволены дыяпазон [0, 100].all_flags, allf
c0_flags, c0f
c1_flags, c1f
c2_flags, c2f
c3_flags, c3f
Усталюйце сцягі піксельных кампанентаў або ўсталюйце сцягі для ўсіх кампанентаў, калі
all_flags
. Даступныя значэнні для сцягоў кампанентаў:- '
a
' асераднёны скроневы шум (больш гладкі)
- '
p
' змешваць выпадковы шум з (паў)рэгулярным малюнкам
- '
t
' часовы шум (змена шумавога малюнка паміж кадрамі)
- '
u
' раўнамерны шум (у іншым выпадку па Гаўсу)
- '
11.170.1 Examples
Дадайце часовы і аднастайны шум да ўваходнага відэа:
noise=alls=20:allf=t+u
11.171 normalize
Нармалізацыя відэа RGB (ён жа расцягванне гістаграмы, расцягванне кантрасту). Глядзіце: https://en.wikipedia.org/wiki/Normalization_(image_processing)
Для кожнага канала кожнага кадра фільтр вылічае ўваходны дыяпазон і лінейна супастаўляе яго з вызначаным карыстальнікам выхадным дыяпазонам. Выхадны дыяпазон па змаўчанні - поўны дынамічны дыяпазон ад чыста чорнага да чыста белага.
Часовае згладжванне можна выкарыстоўваць на ўваходным дыяпазоне, каб паменшыць мігаценне (хуткія змены яркасці), якое ўзнікае, калі невялікія цёмныя або яркія аб'екты ўваходзяць у сцэну або пакідаюць яе. Гэта падобна на аўтаматычную экспазіцыю (аўтаматычны кантроль узмацнення) на відэакамеры, і, як і відэакамера, можа выклікаць перыяд празмернай або недастатковай экспазіцыі відэа.
Каналы R,G,B можна нармалізаваць незалежна адзін ад аднаго, што можа выклікаць некаторую змену колеру, або аб'яднаць іх у адзін канал, што прадухіляе зрух колеру. Звязаная нармалізацыя захоўвае адценне. Незалежнай нармалізацыі няма, таму яе можна выкарыстоўваць для выдалення некаторых каляровых адценняў. Незалежную і звязаную нармалізацыю можна камбінаваць у любых суадносінах.
Фільтр нармалізацыі прымае наступныя параметры:
blackpt
whitept
Колеры, якія вызначаюць выхадны дыяпазон. Мінімальнае ўваходнае значэнне адлюстроўваецца на
blackpt
. Максімальнае ўваходнае значэнне адлюстроўваецца наwhitept
. Па змаўчанні чорны і белы адпаведна. Указанне белага дляblackpt
і чорнага дляwhitept
дасць інвертаваны колер, нармалізаванае відэа. Для памяншэння дынамічнага дыяпазону (кантрастнасці) можна выкарыстоўваць адценні шэрага. Указанне тут насычаных колераў можа стварыць некаторыя цікавыя эфекты.smoothing
Колькасць папярэдніх кадраў для часовага згладжвання. Уваходны дыяпазон кожнага канала згладжваецца з дапамогай слізгальнага сярэдняга па бягучым і
smoothing
папярэдніх кадрах. Па змаўчанні 0 (без часовага згладжвання).independence
Кантралюе суадносіны незалежнай (з зрухам колеру) нармалізацыі канала да звязанай (з захаваннем колеру) нармалізацыі. 0.0 цалкам звязаны, 1.0 цалкам незалежны. Па змаўчанні 1.0 (цалкам незалежна).
strength
Агульная трываласць фільтра. 1.0 - поўная сіла. 0.0 з'яўляецца даволі дарагім без аперацыі. Па змаўчанні 1.0 (поўная моц).
11.171.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і опцыі, за выключэннем smoothing
опцыі. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.171.2 Examples
Расцягнуць кантраснасць відэа для выкарыстання поўнага дынамічнага дыяпазону без часовага згладжвання; можа міргаць у залежнасці ад зыходнага кантэнту:
normalize=blackpt=black:whitept=white:smoothing=0
Як і вышэй, але з 50 кадрамі часовага згладжвання; мігаценне павінна быць зменшана ў залежнасці ад зыходнага кантэнту:
normalize=blackpt=black:whitept=white:smoothing=50
Як і вышэй, але з нармалізацыяй звязанага канала з захаваннем адцення:
normalize=blackpt=black:whitept=white:smoothing=50:independence=0
Як вышэй, але з паловай сілы:
normalize=blackpt=black:whitept=white:smoothing=50:independence=0:strength=0.5
Адлюструйце самы цёмны колер уводу да чырвонага, самы яркі колер уводу да блакітнага:
normalize=blackpt=red:whitept=cyan
11.172 null
Перадайце крыніцу відэа без змен на выхад.
11.173 ocr
Аптычнае распазнаванне сімвалаў
Гэты фільтр выкарыстоўвае Tesseract для аптычнага распазнавання сімвалаў. Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай
--enable-libtesseract
.
Ён прымае наступныя варыянты:
datapath
Усталюйце шлях да дадзеных для даных тэсеракта. Па змаўчанні выкарыстоўваецца тое, што было ўстаноўлена пры ўсталёўцы.
language
Усталюйце мову, па змаўчанні "англ".
whitelist
Усталяваць белы спіс сімвалаў.
blacklist
Усталяваць чорны спіс персанажаў.
Фільтр экспартуе распазнаны тэкст як метаданыя фрэйма lavfi.ocr.text
. Фільтр экспартуе ўпэўненасць распазнаных слоў у якасці метаданых фрэйма lavfi.ocr.confidence
.
11.174 ocv
Прымяніць трансфармацыю відэа з дапамогай libopencv.
Каб уключыць гэты фільтр, усталюйце бібліятэку libopencv і загалоўкі і наладзьце FFmpeg з дапамогай --enable-libopencv
.
Ён прымае наступныя параметры:
filter_name
Назва фільтра libopencv, які трэба прымяніць.
filter_params
Параметры для перадачы ў фільтр libopencv. Калі не пазначана, прымаюцца значэнні па змаўчанні.
Для атрымання больш дакладнай інфармацыі звярніцеся да афіцыйнай дакументацыі libopencv: http://docs.opencv.org/master/modules/imgproc/doc/filtering.html
Падтрымліваюцца некалькі фільтраў libopencv; гл. наступныя падраздзелы.
11.174.1 dilate
Пашырце малюнак, выкарыстоўваючы пэўны структурны элемент. Гэта адпавядае функцыі libopencv cvDilate
.
Ён прымае параметры: struct_el
| nb_iterations
.
struct_el
уяўляе сабой структурны элемент і мае сінтаксіс:
cols
x rows
+ anchor_x
x anchor_y
/shape
cols
і rows
ўяўляюць колькасць слупкоў і радкоў структурнага элемента, кропку прывязкі і anchor_x
форму структурнага элемента.
павінен быць "прамы", "крыж", "эліпс" або "карыстальніцкі".
anchor_y
shape
shape
Калі значэнне для shape
"карыстальніцкі", пасля яго павінен ісці радок у выглядзе "= filename
". Мяркуецца, што файл з назвай
filename
прадстаўляе двайковы малюнак, у якім кожны друкаваны сімвал адпавядае яркаму пікселю. Калі карыстальніцкі
shape
выкарыстоўваецца cols
і rows
ігнаруецца, замест яго прымаецца колькасць або слупкі і радкі прачытанага файла.
Значэнне па змаўчанні struct_el
- "3x3+0x0/rect".
nb_iterations
вызначае колькасць разоў прымянення пераўтварэнняў да выявы і па змаўчанні 1.
Некаторыя прыклады:
# Use the default values
ocv=dilate
# Dilate using a structuring element with a 5x5 cross, iterating two times
ocv=filter_name=dilate:filter_params=5x5+2x2/cross|2
# Read the shape from the file diamond.shape, iterating two times.
# The file diamond.shape may contain a pattern of characters like this
# *
# ***
# *****
# ***
# *
# The specified columns and rows are ignored
# but the anchor point coordinates are not
ocv=dilate:0x0+2x2/custom=diamond.shape|2
11.174.2 erode
Размяць вобраз, выкарыстоўваючы пэўны структурны элемент. Гэта адпавядае функцыі libopencv cvErode
.
Ён прымае параметры: struct_el
: nb_iterations
з тым жа сінтаксісам і семантыкай, што і фільтр
пашырэння .
11.174.3 smooth
Згладжванне ўваходнага відэа.
Фільтр прымае наступныя параметры:
type
| param1
| param2
| param3
| param4
.
type
тып гладкага фільтра, які трэба прымяніць, і павінен мець адно з наступных значэнняў: "blur", "blur_no_scale", "median", "gaussian" або "bilateral". Значэнне па змаўчанні - "Гаўса".
Значэнне param1
, param2
, param3
, і param4
залежыць ад гладкага тыпу. param1
і
param2
прымаць цэлыя дадатныя значэнні або 0. param3
і
param4
прымаць значэнні з плаваючай кропкай.
Значэнне па змаўчанні для param1
- 3. Значэнне па змаўчанні для астатніх параметраў - 0.
Гэтыя параметры адпавядаюць параметрам, прызначаным функцыі libopencv cvSmooth
.
11.175 oscilloscope
2D відэаасцылограф.
Карысна для вымярэння прасторавага імпульсу, крокавых рэакцый, затрымкі каляровасці і г.д.
Ён прымае наступныя параметры:
x
Усталюйце цэнтр прыцэла па X.
y
Усталюйце прыцэл у цэнтр y.
s
Усталюйце памер прыцэла адносна дыяганалі кадра.
t
Усталюйце нахіл/паварот прыцэла.
o
Задаць непразрыстасць трасіроўкі.
tx
Усталюйце цэнтр трасіроўкі па X.
ty
Устанавіць цэнтр трасіроўкі ў становішчы.
tw
Усталюйце шырыню трасіроўкі адносна шырыні рамкі.
th
Усталюйце вышыню трасіроўкі адносна вышыні кадра.
c
Усталюйце, якія кампаненты адсочваць. Па змаўчанні ён адсочвае першыя тры кампаненты.
g
Намалюйце сетку трасіроўкі. Па змаўчанні ўключана.
st
Намалюйце статыстыку. Па змаўчанні ўключана.
sc
Намалюйце аб'ём. Па змаўчанні ўключана.
11.175.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.175.2 Examples
- Праверце поўны першы рад відэакадра.
oscilloscope=x=0.5:y=0:s=1
- Праверце ўвесь апошні рад відэакадра.
oscilloscope=x=0.5:y=1:s=1
- Агледзіце поўны 5-ы радок відэакадра вышынёй 1080.
oscilloscope=x=0.5:y=5/1080:s=1
- Праверце ўвесь апошні слупок відэакадра.
oscilloscope=x=1:y=0.5:s=1:t=1
11.176 overlay
Накласці адно відэа на другое.
Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход.
Ён прымае наступныя параметры:
Далей апісваюцца прынятыя варыянты.
x
y
Усталюйце выраз для каардынат x і y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні "0" для абодвух выразаў. У выпадку, калі выраз несапраўдны, ён усталёўваецца ў вялікае значэнне (гэта азначае, што накладанне не будзе адлюстроўвацца ў бачнай вобласці вываду).
eof_action
Глядзіце framesync .
eval
Усталюйце, калі выразы для
x
, іy
ацэньваюцца.Ён прымае наступныя значэнні:
- '
init
' вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды
- '
frame
' ацэньваць выразы для кожнага ўваходнага кадра
Значэнне па змаўчанні '
frame
'.- '
shortest
Глядзіце framesync .
format
Усталюйце фармат выхаднога відэа.
Ён прымае наступныя значэнні:
- '
yuv420
' сілавы выхад YUV420
- '
yuv420p10
' сілавы выхад YUV420p10
- '
yuv422
' сілавы выхад YUV422
- '
yuv422p10
' сілавы выхад YUV422p10
- '
yuv444
' сілавы выхад YUV444
- '
rgb
' прымусова ўпакаваны выхад RGB
- '
gbrp
' прымусовы плоскі выхад RGB
- '
auto
' аўтаматычна выбраць фармат
Значэнне па змаўчанні '
yuv420
'.- '
repeatlast
Глядзіце framesync .
alpha
Задайце фармат альфа-версіі накладзенага відэа, гэта можа быць
straight
абоpremultiplied
. Па змаўчанніstraight
.
Thex
, іy
выразы могуць утрымліваць наступныя параметры.
main_w, W
main_h, H
Асноўны ўваход шырыня і вышыня.
overlay_w, w
overlay_h, h
Шырыня і вышыня ўводу накладання.
x
y
Вылічаныя значэнні для
x
іy
. Яны ацэньваюцца для кожнага новага кадра.hsub
vsub
гарызантальныя і вертыкальныя значэнні падвыбаркі каляровасці выхаднога фармату. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.n
нумар уваходнага кадра, пачынаючы з 0
pos
пазіцыя ў файле ўваходнага кадра, NAN, калі невядома
t
Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
Звярніце ўвагу, што n
зменныя pos
, t
, даступныя толькі тады, калі ацэнка выконваецца для кадра , і будуць ацэненыя ў NAN, каліeval
усталяваны ў 'init
'.
Майце на ўвазе, што кадры бяруцца з кожнага ўваходнага відэа ў парадку пазнакі часу, таму, калі іх першапачатковыя пазнакі часу адрозніваюцца, добрая ідэя прапусціць два ўваходныя сігналы праз setpts=PTS-STARTPTS
фільтр, каб яны пачыналіся з адной і той жа нулявой пазнакі часу, як у прыкладзе для movie
фільтр робіць.
Вы можаце аб'яднаць больш накладак, але вы павінны праверыць эфектыўнасць такога падыходу.
11.176.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
x
y
Змяніце x і y накладзенага ўводу. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.176.2 Examples
- Намалюйце накладанне ў 10 пікселяў ад ніжняга правага кута асноўнага відэа:
overlay=main_w-overlay_w-10:main_h-overlay_h-10
Выкарыстанне найменных параметраў у прыкладзе вышэй становіцца:
overlay=x=main_w-overlay_w-10:y=main_h-overlay_h-10
- Устаўце празрысты лагатып PNG у левы ніжні кут уводу, выкарыстоўваючы
ffmpeg
інструмент з-filter_complex
опцыяй:ffmpeg -i input -i logo -filter_complex 'overlay=10:main_h-overlay_h-10' output
- Устаўце 2 розныя празрыстыя лагатыпы PNG (другі лагатып у правым ніжнім куце) з дапамогай
ffmpeg
інструмента:ffmpeg -i input -i logo1 -i logo2 -filter_complex 'overlay=x=10:y=H-h-10,overlay=x=W-w-10:y=H-h-10' output
- Дадайце празрысты каляровы пласт паверх асноўнага відэа;
WxH
неабходна вызначыць памер асноўнага ўваходу ў фільтр накладання:color=color=red@.3:size=WxH [over]; [in][over] overlay [out]
- Прайграйце арыгінальнае відэа і адфільтраваную версію (тут з фільтрам паслаблення) побач з дапамогай
ffplay
інструмента:ffplay input.avi -vf 'split[a][b]; [a]pad=iw*2:ih[src]; [b]deshake[filt]; [src][filt]overlay=w'
Прыведзеная вышэй каманда такая ж, як:
ffplay input.avi -vf 'split[b], pad=iw*2[src], [b]deshake, [src]overlay=w'
- Зрабіце слізгальнае накладанне, якое з'яўляецца злева направа ў верхняй частцы экрана, пачынаючы з моманту 2:
overlay=x='if(gte(t,2), -w+(t-2)*20, NAN)':y=0
- Складзіце выхад, размясціўшы два ўваходныя відэа побач:
ffmpeg -i left.avi -i right.avi -filter_complex " nullsrc=size=200x100 [background]; [0:v] setpts=PTS-STARTPTS, scale=100x100 [left]; [1:v] setpts=PTS-STARTPTS, scale=100x100 [right]; [background][left] overlay=shortest=1 [background+left]; [background+left][right] overlay=shortest=1:x=100 [left+right] "
- Маскіруйце 10-20 секунд відэа, ужыўшы фільтр delogo да раздзела
ffmpeg -i test.avi -codec:v:0 wmv2 -ar 11025 -b:v 9000k -vf '[in]split[split_main][split_delogo];[split_delogo]trim=start=360:end=371,delogo=0:0:640:480[delogoed];[split_main][delogoed]overlay=eof_action=pass[out]' masked.avi
- Злучыце некалькі накладак каскадам:
nullsrc=s=200x200 [bg]; testsrc=s=100x100, split=4 [in0][in1][in2][in3]; [in0] lutrgb=r=0, [bg] overlay=0:0 [mid0]; [in1] lutrgb=g=0, [mid0] overlay=100:0 [mid1]; [in2] lutrgb=b=0, [mid1] overlay=0:100 [mid2]; [in3] null, [mid2] overlay=100:100 [out0]
11.177 overlay_cuda
Накласці адно відэа на другое.
Гэта варыянт CUDA фільтра накладання . Ён прымае толькі кадры CUDA. Асноўныя фарматы ўваходных пікселяў павінны супадаць.
Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход.
Ён прымае наступныя параметры:
x
y
Усталюйце выразы для каардынат x і y накладзенага відэа на асноўнае відэа.
Яны могуць утрымліваць наступныя параметры:
main_w, W
main_h, H
Асноўны ўваход шырыня і вышыня.
overlay_w, w
overlay_h, h
Шырыня і вышыня ўводу накладання.
x
y
Вылічаныя значэнні для
x
іy
. Яны ацэньваюцца для кожнага новага кадра.n
Парадкавы індэкс асноўнага ўваходнага кадра, пачынаючы з 0.
pos
Пазіцыя зрушэння байтаў у файле асноўнага ўваходнага кадра, NAN, калі невядома.
t
Метка часу асноўнага ўваходнага кадра, выражаная ў секундах, NAN, калі невядома.
Значэнне па змаўчанні "0" для абодвух выразаў.
eval
Усталюйце, калі выразы для
x
іy
ацэньваюцца.Ён прымае наступныя значэнні:
init
Вылічвайце выразы адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.
frame
Ацаніце выразы для кожнага ўваходнага кадра
Значэнне па змаўчанні
frame
.eof_action
Глядзіце framesync .
shortest
Глядзіце framesync .
repeatlast
Глядзіце framesync .
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
11.178 owdenoise
Прымяніць сродак для ліквідацыі шуму Overcomplete Wavelet.
Фільтр прымае наступныя параметры:
depth
Задаць глыбіню.
Большыя значэнні глыбіні прывядуць да больш нізкачастотных кампанентаў, але запаволіць фільтрацыю.
Павінен быць int у дыяпазоне 8-16, па змаўчанні
8
.luma_strength, ls
Усталюйце сілу яркасці.
Павінна быць падвойнае значэнне ў дыяпазоне 0-1000, па змаўчанні
1.0
.chroma_strength, cs
Усталюйце інтэнсіўнасць каляровасці.
Павінна быць падвойнае значэнне ў дыяпазоне 0-1000, па змаўчанні
1.0
.
11.179 pad
Дадайце пракладкі да ўваходнага відарысу і размесціце зыходны ўвод у прадастаўленых x
каардынатах y
.
Ён прымае наступныя параметры:
width, w
height, h
Укажыце выраз для памеру выхаднога відарыса з дададзенымі пракладкамі. Калі значэнне
width
абоheight
роўна 0, для вываду выкарыстоўваецца адпаведны ўваходны памер.Выраз
width
можа спасылацца на значэнне, зададзенаеheight
выразам, і наадварот.Значэнне па змаўчанні
width
іheight
роўна 0.x
y
Укажыце зрушэнні для размяшчэння ўваходнага відарыса ў падшытай вобласці адносна верхняй/левай мяжы выходнага відарыса.
Выраз
x
можа спасылацца на значэнне, зададзенаеy
выразам, і наадварот.Значэнне па змаўчанні
x
іy
роўна 0.Калі ацэнка
x
ory
дае адмоўны лік, яны будуць зменены так, што ўваходны відарыс будзе адцэнтраваны на падстаўленай вобласці.color
Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
color
- "чорны".eval
Укажыце, калі вылічваць
width
,height
,x
іy
выраз.Ён прымае наступныя значэнні:
- '
init
' Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.
- '
frame
' Ацаніце выразы для кожнага ўваходнага кадра.
Значэнне па змаўчанні '
init
'.- '
aspect
Увядзіце ў фармат замест дазволу.
Значэнні параметраў width
, height
, x
, і y
з'яўляюцца выразамі, якія змяшчаюць наступныя канстанты:
in_w
in_h
Шырыня і вышыня ўваходнага відэа.
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Шырыня і вышыня вываду (памер запаўненай вобласці), зададзеныя выразамі
width
і .height
ow
oh
Гэта тое самае, што
out_w
іout_h
.x
y
Зрушэнні x і y, як вызначана выразамі
x
іy
, або NAN, калі яшчэ не пазначаны.a
тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
суадносіны бакоў уваходнага дысплея, яно такое ж, як (
iw
/ih
) *sar
hsub
vsub
Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.
11.179.1 Examples
- Дадайце пракладкі колеру "фіялетавы" да ўваходнага відэа. Памер выхаднога відэа складае 640x480, а верхні левы кут уваходнага відэа змяшчаецца ў слупку 0, радку 40
pad=640:480:0:40:violet
Прыклад вышэй эквівалентны наступнай камандзе:
pad=width=640:height=480:x=0:y=40:color=violet
- Запоўніце ўваход, каб атрымаць выхад з памерамі, павялічанымі на 3/2, і размесціце ўваходнае відэа ў цэнтры забітай вобласці:
pad="3/2*iw:3/2*ih:(ow-iw)/2:(oh-ih)/2"
- Запоўніце ўваход, каб атрымаць выхад у квадраце з памерам, роўным максімальнаму значэнню паміж шырынёй і вышынёй уваходнага сігналу, і пастаўце ўваходнае відэа ў цэнтр забітай вобласці:
pad="max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2"
- Запоўніце ўвод, каб атрымаць канчатковае суадносіны w/h 16:9:
pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2"
- У выпадку анаморфнага відэа, каб правільна задаць фармат выходнага адлюстравання, неабходна выкарыстоўваць
sar
у выразе, у адпаведнасці з адносінамі:(ih * X / ih) * sar = output_dar X = output_dar / sar
Такім чынам, папярэдні прыклад павінен быць зменены, каб:
pad="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2"
- Удвая павялічце выхадны памер і змесціце ўваходнае відэа ў правым ніжнім куце вывадной вобласці:
pad="2*iw:2*ih:ow-iw:oh-ih"
11.180 palettegen
Стварыць адну палітру для цэлага відэаструменю.
Ён прымае наступныя варыянты:
max_colors
Усталюйце максімальную колькасць колераў для квантавання ў палітры. Заўвага: палітра па-ранейшаму будзе ўтрымліваць 256 колераў; нявыкарыстаныя элементы палітры будуць чорнымі.
reserve_transparent
Стварыце палітру з максімум 255 колераў і захавайце апошні для празрыстасці. Рэзерваванне колеру празрыстасці карысна для аптымізацыі GIF. Калі не ўстаноўлена, максімальная колькасць колераў у палітры будзе 256. Верагодна, вы хочаце адключыць гэту опцыю для асобнага відарыса. Усталёўваецца па змаўчанні.
transparency_color
Усталюйце колер, які будзе выкарыстоўвацца ў якасці фону для празрыстасці.
stats_mode
Ўсталяваць рэжым статыстыкі.
Ён прымае наступныя значэнні:
- '
full
' Вылічыць поўнакадравыя гістаграмы.
- '
diff
' Вылічвайце гістаграмы толькі для той часткі, якая адрозніваецца ад папярэдняга кадра. Гэта можа быць дарэчы, каб надаць большае значэнне рухомай частцы вашага ўводу, калі фон статычны.
- '
single
' Вылічыце новую гістаграму для кожнага кадра.
Значэнне па змаўчанні -
full
.- '
use_alpha
Стварыце палітру колераў з альфа-кампанентамі. Усталяванне гэтага параметра аўтаматычна адключае 'reserve_transparent'.
Фільтр таксама экспартуе метаданыя кадра lavfi.color_quant_ratio
( nb_color_in / nb_color_out
), якія вы можаце выкарыстоўваць для ацэнкі ступені квантавання колеру палітры. Гэтая інфармацыя таксама бачная на
info
ўзроўні рэгістрацыі.
11.180.1 Examples
- Стварыце рэпрэзентатыўную палітру дадзенага відэа з дапамогай
ffmpeg
:ffmpeg -i input.mkv -vf palettegen palette.png
11.181 paletteuse
Выкарыстоўвайце палітру для памяншэння дыскрэтызацыі ўваходнага відэапатоку.
Фільтр прымае два ўваходу: адзін відэаструмень і палітру. Палітра павінна быць выявай памерам 256 пікселяў.
Ён прымае наступныя варыянты:
dither
Выберыце рэжым згладжвання. Даступныя алгарытмы:
- '
bayer
' Замоўленае згладжванне Баера 8x8 (дэтэрмінаванае)
- '
heckbert
' Дызерынг паводле вызначэння Пола Хекберта ў 1982 г. (простая дыфузія памылак). Заўвага: гэта згладжванне часам лічыцца "няправільным" і ўключана ў якасці эталона.
- '
floyd_steinberg
' Дызерынг Флойда і Стынгберга (дыфузія памылак)
- '
sierra2
' Frankie Sierra dithering v2 (дыфузія памылак)
- '
sierra2_4a
' Frankie Sierra dithering v2 "Lite" (дыфузія памылак)
Па змаўчанні
sierra2_4a
.- '
bayer_scale
Калі
bayer
выбрана згладжванне, гэты параметр вызначае маштаб узору (наколькі бачны ўзор штрыхоўкі). Нізкае значэнне азначае больш бачны ўзор з меншай колькасцю палос, а большае значэнне азначае менш бачны ўзор за кошт большай колькасці палос.Параметр павінен быць цэлым лікам у дыяпазоне [0,5]. Па змаўчанні
2
.diff_mode
Калі ўстаноўлена, вызначце зону для апрацоўкі
- '
rectangle
' Будзе паўторна апрацаваны толькі зменлівы прамавугольнік. Гэта падобна на механізм сціску абрэзкі/зрушэння GIF. Гэты параметр можа быць карысным для хуткасці, калі змяняецца толькі частка відарыса і мае такія выпадкі выкарыстання, як абмежаванне аб'ёму распаўсюджвання памылак
dither
да прастакутніка, які абмяжоўвае рухомую сцэну (гэта прыводзіць да больш дэтэрмінаванага вываду, калі сцэна не змяняецца моцна, і, як вынік, менш рухальнага шуму і лепшае сцісканне GIF).
Па змаўчанні
none
.- '
new
Вазьміце новую палітру для кожнага выхаднога кадра.
alpha_threshold
Устанаўлівае альфа-парог для празрыстасці. Значэнні альфа вышэй гэтага парога будуць разглядацца як цалкам непразрыстыя, а значэнні ніжэй гэтага парога будуць разглядацца як цалкам празрыстыя.
Параметр павінен быць цэлым лікам у дыяпазоне [0,255]. Па змаўчанні
128
.use_alpha
Ужывайце палітру з улікам альфа-значэнняў. Карысна толькі з палітрамі, якія змяшчаюць некалькі колераў з альфа-кампанентамі. Вызначэнне гэтага параметра аўтаматычна адключае «alpha_treshold».
11.181.1 Examples
- Выкарыстоўвайце палітру (створаную, напрыклад, з дапамогай palettegen ), каб закадзіраваць GIF з дапамогай
ffmpeg
:ffmpeg -i input.mkv -i palette.png -lavfi paletteuse output.gif
11.182 perspective
Правільны ракурс відэа не запісваецца перпендыкулярна экрану.
Далей апісваюцца прынятыя параметры.
x0
y0
x1
y1
x2
y2
x3
y3
Усталюйце выраз каардынат для верхняга левага, верхняга правага, ніжняга левага і ніжняга правага кутоў. Значэнні па змаўчанні - гэта тое,
0:0:W:0:0:H:W:H
пры якім ракурс застанецца нязменным. Калі дляsense
опцыі ўстаноўленаsource
, то ўказаныя пункты будуць адпраўлены ў куты пункта прызначэння. Каліsense
параметр усталяваны ўdestination
, то вуглы крыніцы будуць адпраўлены па ўказаных каардынатах.Выразы могуць выкарыстоўваць наступныя зменныя:
W
H
шырыня і вышыня кадра відэа.
in
Колькасць уваходных кадраў.
on
Колькасць выхадных кадраў.
interpolation
Усталюйце інтэрпаляцыю для карэкцыі перспектывы.
Ён прымае наступныя значэнні:
- '
linear
' - '
cubic
'
Значэнне па змаўчанні '
linear
'.- '
sense
Задаць інтэрпрэтацыю варыянтаў каардынат.
Ён прымае наступныя значэнні:
- '
0, source
' -
Адправіць кропку ў крыніцы, вызначанай зададзенымі каардынатамі, у куты пункта прызначэння.
- '
1, destination
' -
Адпраўце вуглы крыніцы ў кропку пункта прызначэння, вызначаную зададзенымі каардынатамі.
Значэнне па змаўчанні '
source
'.
- '
eval
Усталюйце, калі выразы для каардынат
x0,y0,...x3,y3
ацэньваюцца.Ён прымае наступныя значэнні:
- '
init
' вылічваць выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды
- '
frame
' ацэньваць выразы для кожнага ўваходнага кадра
Значэнне па змаўчанні '
init
'.- '
11.183 phase
Затрымка празрадковага відэа на адзін час поля, каб змяніць парадак палёў.
Меркаванае выкарыстанне - выправіць фільмы PAL, якія былі зняты з парадкам палёў, процілеглым перадачы з фільма на відэа.
Далей апісваюцца прынятыя параметры.
mode
Усталюйце фазавы рэжым.
Ён прымае наступныя значэнні:
- '
t
' Парадак палёў захопу - зверху, перадача - знізу. Фільтр затрымае ніжняе поле.
- '
b
' Парадак палёў захопу - унізе, перадача - уверсе. Фільтр затрымае верхняе поле.
- '
p
' Захоп і перадача з такім жа парадкам палёў. Гэты рэжым існуе толькі для дакументацыі іншых параметраў, на якія можна спасылацца, але калі вы сапраўды выберыце яго, фільтр дакладна нічога не будзе рабіць.
- '
a
' Парадак палёў захопу вызначаецца аўтаматычна сцяжкамі палёў, перадача насупраць. Фільтр выбірае сярод "
t
'і'b
' рэжымы на кадравай аснове з выкарыстаннем сцягоў палёў. Калі інфармацыя аб полі недаступная, гэта працуе гэтак жа, як 'u
'.- '
u
' Захоп невядомых або вар'іруючых, перадача насупраць. Фільтр выбірае сярод "
t
'і'b
' на кадравай аснове, аналізуючы выявы і выбіраючы альтэрнатыву, якая дае лепшае супадзенне паміж палямі.- '
T
' Захоп зверху, перадача невядомая або розная. Фільтр выбірае сярод "
t
'і'p
з дапамогай аналізу выявы.- '
B
' Захоп знізу, перадача невядомая або розная. Фільтр выбірае сярод "
b
'і'p
з дапамогай аналізу выявы.- '
A
' Захоп вызначаецца сцяжкамі палёў, перадача невядомая або змяняецца. Фільтр выбірае сярод "
t
','b
'і'p
' з дапамогай сцяжкоў палёў і аналізу малюнкаў. Калі інфармацыя аб полі недаступная, гэта працуе гэтак жа, як 'U
'. Гэта рэжым па змаўчанні.- '
U
' І захоп, і перадача невядомыя або розныя. Фільтр выбірае сярод "
t
','b
'і'p
толькі з выкарыстаннем аналізу выявы.
- '
11.183.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.184 photosensitivity
Паменшыце розныя ўспышкі ў відэа, каб дапамагчы карыстальнікам з эпілепсіяй.
Ён прымае наступныя варыянты:
frames, f
Усталюйце, колькі кадраў выкарыстоўваць пры фільтрацыі. Па змаўчанні 30.
threshold, t
Усталюйце парогавы каэфіцыент выяўлення. Па змаўчанні 1. Меншы - больш строгі.
skip
Усталюйце, колькі пікселяў прапускаць пры выбарцы кадраў. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 1024.
bypass
Рамкі пакінуць без зменаў. Па змаўчанні адключана.
11.185 pixdesctest
Тэставы фільтр дэскрыптара фармату пікселя, у асноўным карысны для ўнутранага тэсціравання. Выходнае відэа павінна быць роўным уваходнаму.
Напрыклад:
format=monow, pixdesctest
можа выкарыстоўвацца для праверкі вызначэння дэскрыптара фармату манабелага пікселя.
11.186 pixelize
Прымяніць пікселізацыю да відэаструменю.
Фільтр прымае наступныя параметры:
width, w
height, h
Усталюйце памеры блокаў, якія будуць выкарыстоўвацца для пікселізацыі. Значэнне па змаўчанні -
16
.mode, m
Усталюйце выкарыстоўваны рэжым пікселізацыі.
Магчымыя значэнні:
- '
avg
' - '
min
' - '
max
'
Значэнне па змаўчанні -
avg
.- '
planes, p
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні фільтруюць усе плоскасці.
11.186.1 Commands
Гэты фільтр падтрымлівае ўсе параметры ў выглядзе каманд .
11.187 pixscope
Адлюстраванне прыкладных значэнняў каляровых каналаў. У асноўным карысна для праверкі колеру і ўзроўняў. Мінімальны падтрымліваемы дазвол - 640x480.
Фільтры прымаюць наступныя параметры:
x
Усталюйце становішча X, адноснае зрушэнне па восі X.
y
Усталюйце пазіцыю прыцэла па Y, адноснае зрушэнне па восі Y.
w
Задаць шырыню прыцэла.
h
Задаць вышыню прыцэла.
o
Задаць непразрыстасць акна. Гэта акно таксама змяшчае статыстыку аб плошчы пікселяў.
wx
Усталюйце пазіцыю акна X, адноснае зрушэнне па восі X.
wy
Усталюйце становішча акна па Y, адноснае зрушэнне па восі Y.
11.187.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.188 pp
Уключыце ўказаны ланцужок падфільтраў постапрацоўкі з дапамогай libpostproc. Гэтая бібліятэка павінна быць аўтаматычна выбрана з дапамогай зборкі GPL ( --enable-gpl
). Падфільтры павінны быць падзеленыя знакам '/' і могуць быць адключаны, паставіўшы перад '-'. Кожны падфільтр і некаторыя параметры маюць кароткую і доўгую назву, якія можна выкарыстоўваць узаемазаменна, г. зн. dr/dering аднолькавыя.
Фільтры прымаюць наступныя параметры:
subfilters
Задаць радок падфільтраў постапрацоўкі.
Усе субфільтры маюць агульныя параметры для вызначэння іх вобласці:
a/autoq
Выконвайце патрабаванні якасці гэтага падфільтра.
c/chrom
Выканайце таксама фільтрацыю каляровасці (па змаўчанні).
y/nochrom
Выконвайце толькі фільтрацыю яркасці (без каляровасці).
n/noluma
Выконвайце толькі фільтрацыю каляровасці (без яркасці).
Гэтыя параметры могуць быць дададзены пасля назвы падфільтра, падзеленыя знакам '|'.
Даступныя падфільтры:
hb/hdeblock[|difference[|flatness]]
Гарызантальны фільтр дэблакіроўкі
difference
Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
32
).flatness
Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
39
).
vb/vdeblock[|difference[|flatness]]
Вертыкальны дэблакавальны фільтр
difference
Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
32
).flatness
Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
39
).
ha/hadeblock[|difference[|flatness]]
Дакладны гарызантальны фільтр для дэблакіроўкі
difference
Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
32
).flatness
Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
39
).
va/vadeblock[|difference[|flatness]]
Дакладны фільтр для вертыкальнай дэблакіроўкі
difference
Каэфіцыент рознасці, дзе больш высокія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
32
).flatness
Парог аднастайнасці, дзе больш нізкія значэнні азначаюць большую дэблакіроўку (па змаўчанні:
39
).
Гарызантальныя і вертыкальныя фільтры дэблакіроўкі маюць агульныя значэнні розніцы і роўнасці, таму вы не можаце ўсталяваць розныя гарызантальныя і вертыкальныя парогі.
h1/x1hdeblock
Эксперыментальны гарызантальны дэблакавальны фільтр
v1/x1vdeblock
Эксперыментальны фільтр для вертыкальнай дэблакіроўкі
dr/dering
Ачышчальны фільтр
tn/tmpnoise[|threshold1[|threshold2[|threshold3]]], temporal noise reducer
threshold1
большы -> мацнейшая фільтрацыя
threshold2
большы -> мацнейшая фільтрацыя
threshold3
большы -> мацнейшая фільтрацыя
al/autolevels[:f/fullyrange], automatic brightness / contrast correction
f/fullyrange
Расцягнуць яркасць да
0-255
.
lb/linblenddeint
Лінейны фільтр дэінтэрлейсінгу, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі ўсіх радкоў з дапамогай
(1 2 1)
фільтра.li/linipoldeint
Фільтр дэінтэрпаляцыі з лінейнай інтэрпаляцыяй, які дэінтэрпалюе дадзены блок шляхам лінейнай інтэрпаляцыі кожнага другога радка.
ci/cubicipoldeint
Кубічны інтэрпаляцыйны фільтр дэінтэрпаляцыі дэінтэрпалюе дадзены блок шляхам кубічнай інтэрпаляцыі кожнага другога радка.
md/mediandeint
Сярэдні фільтр дэінтэрлейсінгу, які дэінтэрлейсіруе дадзены блок шляхам прымянення медыяннага фільтра да кожнага другога радка.
fd/ffmpegdeint
Фільтр дэінтэрлейсінгу FFmpeg, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі кожнага другога радка з дапамогай
(-1 4 2 4 -1)
фільтра.l5/lowpass5
Вертыкальна ўжыты FIR-фільтр дэінтэрлейсінгу нізкіх частот, які дэінтэрлейсіруе дадзены блок шляхам фільтрацыі ўсіх радкоў з дапамогай
(-1 2 6 2 -1)
фільтра.fq/forceQuant[|quantizer]
Перавызначае табліцу квантавальніка з уваходу на ўказаны вамі пастаянны квантавальнік.
quantizer
Квантавальнік для выкарыстання
de/default
Стандартная камбінацыя фільтраў pp (
hb|a,vb|a,dr|a
)fa/fast
Хуткая камбінацыя фільтраў pp (
h1|a,v1|a,dr|a
)ac
Высакаякасная камбінацыя фільтраў pp (
ha|a|128|7,va|a,dr|a
)
11.188.1 Examples
- Прымяненне гарызантальнай і вертыкальнай дэблакіроўкі, дэрынгацыі і аўтаматычнай яркасці/кантрастнасці:
pp=hb/vb/dr/al
- Прымяніць стандартныя фільтры без карэкцыі яркасці/кантраснасці:
pp=de/-al
- Ужыць фільтры па змаўчанні і часовае прыглушэнне шуму:
pp=default/tmpnoise|1|2|3
- Ужывайце дэблакіроўку толькі для яркасці і аўтаматычна ўключайце або выключайце вертыкальную дэблакіроўку ў залежнасці ад даступнага часу ЦП:
pp=hb|y/vb|a
11.189 pp7
Прымяніць фільтр постапрацоўкі 7. Гэта варыянт фільтра spp , падобны да spp = 6 з 7-кропкавым DCT, дзе пасля IDCT выкарыстоўваецца толькі цэнтральная выбарка.
Фільтр прымае наступныя параметры:
qp
Прымусова ўсталяваць пастаянны параметр квантавання. Ён прымае цэлы лік у дыяпазоне ад 0 да 63. Калі не ўсталяваны, фільтр будзе выкарыстоўваць QP з відэаплыні (пры наяўнасці).
mode
Усталюйце парогавы рэжым. Даступныя рэжымы:
- '
hard
' Усталюйце жорсткі парог.
- '
soft
' Усталюйце мяккі парог (лепшы эфект выдалення званка, але, верагодна, больш размыты).
- '
medium
' Усталюйце сярэдні парог (добрыя вынікі, па змаўчанні).
- '
11.190 premultiply
Прымяніць эфект папярэдняга множання альфа-канала да ўваходнага відэапатоку з выкарыстаннем першай плоскасці другога патоку ў якасці альфа-канала.
Абодва патокі павінны мець аднолькавыя памеры і аднолькавы фармат пікселяў.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
inplace
Не патрабуецца другі ўвод для апрацоўкі, замест гэтага выкарыстоўвайце альфа-плоскасць з уваходнага патоку.
11.191 prewitt
Ужыць аператар prewitt для ўваходнага відэапатоку.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.
delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.
11.191.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.192 pseudocolor
Змяняйце колеры рамкі ў відэа з дапамогай псеўдаколераў.
Гэты фільтр прымае наступныя параметры:
c0
ўсталяваць выраз першага кампанента пікселя
c1
ўсталяваць выраз другога кампанента пікселя
c2
усталяваць выраз трэцяга кампанента пікселя
c3
усталяваць выраз чацвёртага кампанента пікселя, які адпавядае альфа-кампаненту
index, i
ўсталяваць кампанент для выкарыстання ў якасці асновы для змены колераў
preset, p
Выберыце адзін з убудаваных LUT. Па змаўчанні не ўстаноўлена.
Даступныя LUT:
- '
magma
' - '
inferno
' - '
plasma
' - '
viridis
' - '
turbo
' - '
cividis
' - '
range1
' - '
range2
' - '
shadows
' - '
highlights
' - '
solar
' - '
nominal
' - '
preferred
' - '
total
'
- '
opacity
Задаць непразрыстасць выходных колераў. Дазволены дыяпазон ад 0 да 1. Значэнне па змаўчанні - 1.
Кожны з варыянтаў выразаў вызначае выраз, які будзе выкарыстоўвацца для вылічэння табліцы пошуку для адпаведных значэнняў піксельных кампанентаў.
Выразы могуць утрымліваць наступныя канстанты і функцыі:
w
h
Шырыня і вышыня ўводу.
val
Уваходнае значэнне для піксельнага кампанента.
ymin, umin, vmin, amin
Мінімальна дазволенае значэнне кампанента.
ymax, umax, vmax, amax
Максімальна дазволенае значэнне кампанента.
Усе выразы па змаўчанні маюць "val".
11.192.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.192.2 Examples
- Змяніць занадта высокія значэнні яркасці на градыент:
pseudocolor="'if(between(val,ymax,amax),lerp(ymin,ymax,(val-ymax)/(amax-ymax)),-1):if(between(val,ymax,amax),lerp(umax,umin,(val-ymax)/(amax-ymax)),-1):if(between(val,ymax,amax),lerp(vmin,vmax,(val-ymax)/(amax-ymax)),-1):-1'"
11.193 psnr
Атрымайце сярэдняе, максімальнае і мінімальнае PSNR (пікавае стаўленне сігнал/шум) паміж двума ўваходнымі відэа.
Гэты фільтр прымае на ўваход два ўваходныя відэа, першы ўваход лічыцца "асноўнай" крыніцай і без змен перадаецца на выхад. Другі ўваход выкарыстоўваецца ў якасці "эталоннага" відэа для вылічэння PSNR.
Абодва відэаўваходы павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.
Атрыманае сярэдняе PSNR раздрукоўваецца праз сістэму каротажу.
Фільтр захоўвае назапашаную MSE (сярэднеквадратычную памылку) кожнага кадра, і ў канцы апрацоўкі яна ўсярэдніваецца па ўсіх кадрах аднолькава, і для атрымання PSNR прымяняецца наступная формула:
PSNR = 10*log10(MAX^2/MSE)
Дзе MAX - сярэдняе з максімальных значэнняў кожнага кампанента выявы.
Ніжэй прыводзіцца апісанне прынятых параметраў.
stats_file, f
Калі пазначаны, фільтр будзе выкарыстоўваць названы файл для захавання PSNR кожнага асобнага кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.
stats_version
Вызначае, якую версію фармату файла статыстыкі выкарыстоўваць. Падрабязнасці кожнага фармату апісаны ніжэй. Значэнне па змаўчанні - 1.
stats_add_max
Вызначае, ці выводзіцца максімальнае значэнне ў журнал статыстыкі. Значэнне па змаўчанні 0. Патрабуецца stats_version >= 2. Калі гэта ўстаноўлена і stats_version < 2, фільтр верне памылку.
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
Файл, які друкуецца stats_file
, калі абраны, змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key
: value
для кожнай пары кадраў, якія параўноўваюцца.
Калі stats_version
ўказана значэнне большае за 1, радок загалоўка папярэднічае спісу статыстыкі па пары кадраў з парамі ключоў і значэнняў пасля фармату кадра з наступнымі параметрамі:
psnr_log_version
Версія фармату файла журнала. Будзе адпавядаць
stats_version
.fields
Спіс параметраў для кожнай пары кадраў, падзелены коскамі, уключаны ў журнал.
Ніжэй прыводзіцца апісанне кожнага паказанага параметра для кожнай пары кадраў:
n
парадкавы нумар уваходнага кадра, пачынаючы з 1
mse_avg
Сярэдняя квадратычная памылка сярэдняя піксельная сярэдняя розніца параўноўваных кадраў, асераднёная па ўсіх кампанентах выявы.
mse_y, mse_u, mse_v, mse_r, mse_g, mse_b, mse_a
Сярэдняя квадратычная памылка папіксельная сярэдняя розніца параўноўваных кадраў для кампанента, вызначанага суфіксам.
psnr_y, psnr_u, psnr_v, psnr_r, psnr_g, psnr_b, psnr_a
Пікавае стаўленне сігнал/шум параўноўваных кадраў для кампанента, вызначанага суфіксам.
max_avg, max_y, max_u, max_v
Максімальна дазволенае значэнне для кожнага канала і сярэдняе па ўсіх каналах.
11.193.1 Examples
- Напрыклад:
movie=ref_movie.mpg, setpts=PTS-STARTPTS [main]; [main][ref] psnr="stats_file=stats.log" [out]
У гэтым прыкладзе ўваходны файл, які апрацоўваецца, параўноўваецца з эталонным файлам
ref_movie.mpg
. PSNR кожнага асобнага кадра захоўваецца ўstats.log
. - Яшчэ адзін прыклад з рознымі кантэйнерамі:
ffmpeg -i main.mpg -i ref.mkv -lavfi "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]psnr" -f null -
11.194 pullup
Рэверсіўны (зваротны тэлекіно) фільтр, здольны апрацоўваць змешаны жорсткі тэлекіно, прагрэсіўны кантэнт 24000/1001 кадраў/с і прагрэсіўны кантэнт 30000/1001 кадраў/с.
Фільтр падцягвання распрацаваны, каб выкарыстоўваць будучы кантэкст пры прыняцці рашэнняў. Гэты фільтр не мае стану ў тым сэнсе, што ён не замыкаецца на шаблоне, якому трэба прытрымлівацца, але замест гэтага ён чакае наступных палёў, каб ідэнтыфікаваць супадзенні і аднавіць прагрэсіўныя кадры.
Каб ствараць змесціва з аднолькавай частатой кадраў, устаўце фільтр кадраў у секунду пасля падцягвання, выкарыстоўвайце яго, fps=24000/1001
калі ўваходная частата кадраў складае 29,97 кадраў у секунду,
fps=24
для 30 кадраў у секунду і (рэдкі) тэлекіно 25 кадраў у секунду.
Фільтр прымае наступныя параметры:
jl
jr
jt
jb
Гэтыя параметры вызначаюць колькасць «смецця», якое трэба ігнараваць, адпаведна злева, справа, уверсе і ўнізе выявы. Злева і справа - па 8 пікселяў, а зверху і знізу - па 2 радкі. Па змаўчанні 8 пікселяў з кожнага боку.
sb
Усталюйце строгія перапынкі. Усталяванне гэтага параметра ў 1 знізіць імавернасць таго, што фільтр час ад часу генеруе неадпаведныя кадры, але гэта таксама можа прывесці да выключэння празмернай колькасці кадраў падчас паслядоўнасцей з высокім рухам. І наадварот, усталяваўшы для яго значэнне -1, палягчаецца супадзенне палёў фільтраў. Гэта можа дапамагчы апрацоўцы відэа, дзе ёсць невялікая размытасць паміж палямі, але таксама можа прывесці да празрадковай разгорткі кадраў у вывадзе. Значэнне па змаўчанні -
0
.mp
Усталюйце метрычную плоскасць для выкарыстання. Ён прымае наступныя значэнні:
- '
l
' Выкарыстоўвайце плоскасць luma.
- '
u
' Выкарыстоўвайце каляровую сінюю плоскасць.
- '
v
' Выкарыстоўвайце каляровую чырвоную плоскасць.
Гэты параметр можа быць настроены на выкарыстанне плоскасці каляровасці замест стандартнай плоскасці яркасці для выканання вылічэнняў фільтра. Гэта можа павысіць дакладнасць вельмі чыстага зыходнага матэрыялу, але, хутчэй за ўсё, знізіць дакладнасць, асабліва калі ёсць каляровы шум (эфект вясёлкі) або любое відэа ў адценнях шэрага. Асноўная мэта ўстаноўкі
mp
да каляровай плоскасці - гэта паменшыць нагрузку на працэсар і зрабіць падцягванне выкарыстоўваным у рэальным часе на павольных машынах.- '
Для дасягнення найлепшых вынікаў (без дубляваных кадраў у выходным файле) неабходна змяніць выходную частату кадраў. Напрыклад, для зваротнага ўводу тэлекіно NTSC:
ffmpeg -i input -vf pullup -r 24000/1001 ...
11.195 qp
Змена параметраў квантавання відэа (QP).
Фільтр прымае наступныя параметры:
qp
Задаць выраз для параметра квантавання.
Выраз ацэньваецца праз eval API і можа ўтрымліваць, сярод іншага, наступныя канстанты:
known
1, калі індэкс не роўны 129, 0 у адваротным выпадку.
qp
Паслядоўны індэкс ад -129 да 128.
11.195.1 Examples
- Нейкае ўраўненне накшталт:
qp=2+2*sin(PI*qp)
11.196 random
Ачысціць відэакадры з унутранага кэша кадраў у выпадковым парадку. Ні адзін кадр не адкідаецца. Натхнёны нервовым фільтрам frei0r .
frames
Задайце памер у колькасці кадраў унутранага кэша ў дыяпазоне ад
2
да512
. Па змаўчанні30
.seed
Задаць пачатковы лік для генератара выпадковых лікаў, павінен быць цэлы лік паміж
0
іUINT32_MAX
. Калі не пазначана або відавочна ўстаноўлена менш за0
, фільтр будзе спрабаваць выкарыстаць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.
11.197 readeia608
Чытайце інфармацыю субцітраў (EIA-608) з верхніх радкоў відэакадра.
Гэты фільтр дадае метаданыя кадра для lavfi.readeia608.X.cc
і
lavfi.readeia608.X.line
, дзе X
нумар ідэнтыфікаванага радка з дадзенымі EIA-608 (пачынаючы з 0). Ніжэй прыводзіцца апісанне кожнага значэння метададзеных:
lavfi.readeia608.X.cc
Два байты, якія захоўваюцца ў выглядзе даных EIA-608 (друкуюцца ў шаснаццатковым выглядзе).
lavfi.readeia608.X.line
Нумар радка, у якім былі ідэнтыфікаваныя і счытаныя даныя EIA-608.
Гэты фільтр прымае наступныя параметры:
scan_min
Усталюйце радок для пачатку сканіравання даных EIA-608. Па змаўчанні
0
.scan_max
Усталюйце радок для завяршэння сканавання даных EIA-608. Па змаўчанні
29
.spw
Усталюйце суадносіны шырыні, зарэзерваванай для выяўлення кода сінхранізацыі. Па змаўчанні
0.27
. Дазволены дыяпазон[0.1 - 0.7]
.chp
Уключыць праверку біта цотнасці. У выпадку памылкі цотнасці фільтр будзе выводзіць
0x00
для гэтага сімвала. Па змаўчанні - false.lp
Лініі нізкіх частот перад далейшай апрацоўкай. Па змаўчанні ўключана.
11.197.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.197.2 Examples
- Вывесці файл csv з часам прэзентацыі і першымі двума радкамі ідэнтыфікаваных даных цітраў EIA-608.
ffprobe -f lavfi -i movie=captioned_video.mov,readeia608 -show_entries frame=pts_time:frame_tags=lavfi.readeia608.0.cc,lavfi.readeia608.1.cc -of csv
11.198 readvitc
Счытвайце інфармацыю пра таймкод вертыкальнага інтэрвалу (VITC) з верхніх радкоў відэакадра.
Фільтр дадае ключ метаданых кадра lavfi.readvitc.tc_str
са значэннем тайм-кода, калі быў выяўлены сапраўдны тайм-код. Дадатковы ключ метаданых
lavfi.readvitc.found
усталяваны ў 0/1 у залежнасці ад таго, былі знойдзены даныя часовага кода ці не.
Гэты фільтр прымае наступныя параметры:
scan_max
Усталюйце максімальную колькасць радкоў для сканавання даных VITC. Калі ўсталявана значэнне,
-1
скануецца поўны відэакадр. Па змаўчанні45
.thr_b
Усталюйце парог яркасці для чорнага. Прымае лікі з плаваючай часткай у дыяпазоне [0.0,1.0], значэнне па змаўчанні
0.2
. Значэнне павінна быць роўным або меншым заthr_w
.thr_w
Усталюйце парог яркасці для белага. Прымае лікі з плаваючай часткай у дыяпазоне [0.0,1.0], значэнне па змаўчанні
0.6
. Значэнне павінна быць роўным або большым заthr_b
.
11.198.1 Examples
- Выяўляць і маляваць даныя VITC на відэакадры; калі сапраўдны VITC не выяўлены, намаляваць
--:--:--:--
у якасці запаўняльніка:ffmpeg -i input.avi -filter:v 'readvitc,drawtext=fontfile=FreeMono.ttf:text=%{metadata\\:lavfi.readvitc.tc_str\\:--\\\\\\:--\\\\\\:--\\\\\\:--}:x=(w-tw)/2:y=400-ascent'
11.199 remap
Пераназначце пікселі з дапамогай уваходнага відэаструменя 2nd: Xmap і 3rd: Ymap.
Піксель прызначэння ў пазіцыі (X, Y) будзе абраны з пазіцыі крыніцы (x, y), дзе x = Xmap(X, Y) і y = Ymap(X, Y). Калі значэнні адлюстравання выходзяць за межы дыяпазону, для пікселя прызначэння будзе выкарыстоўвацца нулявое значэнне для пікселя.
Уваходныя відэапатокі Xmap і Ymap павінны мець аднолькавы памер. Выхадны відэаструмень будзе мець памеры відэаструменю Xmap/Ymap. Уваходныя відэапатокі Xmap і Ymap маюць глыбіню 16 біт, аднаканальныя.
format
Укажыце піксельны фармат вываду з гэтага фільтра. Можа быць
color
абоgray
. Па змаўчанніcolor
.fill
Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні
black
.
11.200 removegrain
Фільтр removegrain - гэта прасторавае прымяненне шуму для прагрэсіўнага відэа.
m0
Усталюйце рэжым для першага самалёта.
m1
Усталюйце рэжым для другога самалёта.
m2
Усталюйце рэжым для трэцяга самалёта.
m3
Усталюйце рэжым для чацвёртага самалёта.
Дыяпазон рэжымаў ад 0 да 24. Апісанне кожнага рэжыму:
0
Пакіньце ўваходную плоскасць без зменаў. Па змаўчанні.
1
Выразае піксель з мінімальным і максімальным з 8 суседніх пікселяў.
2
Выразае піксель другім мінімумам і максімумам з 8 суседніх пікселяў.
3
Адразае піксель з трэцім мінімумам і максімумам з 8 суседніх пікселяў.
4
Адразае піксель з чацвёртым мінімумам і максімумам з 8 суседніх пікселяў. Гэта эквівалентна сярэдняму фільтру.
5
Абразанне з улікам ліній забяспечвае мінімальныя змены.
6
Выразанне з улікам лініі, прамежкавае.
7
Выразанне з улікам лініі, прамежкавае.
8
Выразанне з улікам лініі, прамежкавае.
9
Адразанне з улікам лініі на лініі, дзе бліжэйшыя пікселі знаходзяцца бліжэй за ўсё.
10
Замяняе мэтавы піксель бліжэйшым суседам.
11
[1 2 1] гарызантальнае і вертыкальнае размыццё ядра.
12
Тое самае, што і рэжым 11.
13
Рэжым Боба інтэрпалюе верхняе поле ад радка, дзе бліжэйшыя суседнія пікселі.
14
Рэжым Боба інтэрпалюе ніжняе поле ад лініі, дзе бліжэйшыя суседнія пікселі.
15
Рэжым Боб, інтэрпалюе верхняе поле. Тое самае, што і 13, але з больш складанай формулай інтэрпаляцыі.
16
Рэжым Боб, інтэрпалюе ніжняе поле. Тое самае, што і 14, але з больш складанай формулай інтэрпаляцыі.
17
Адсякае піксель з мінімумам і максімумам, адпаведна, максімумам і мінімумам кожнай пары супрацьлеглых суседніх пікселяў.
18
Адсячэнне з улікам лініі з выкарыстаннем супрацьлеглых суседзяў, найбольшая адлегласць якіх ад бягучага пікселя мінімальная.
19
Замяняе піксель сярэднім з 8 яго суседзяў.
20
У сярэднім 9 пікселяў ([1 1 1] гарызантальнае і вертыкальнае размыццё).
21
Выразае пікселі з выкарыстаннем сярэдніх значэнняў супрацьлеглага суседа.
22
Такі ж, як і рэжым 21, але больш просты і хуткі.
23
Невялікі край і выдаленне гало, але лічыцца бескарысным.
24
Падобна на 23.
11.201 removelogo
Схаваць лагатып тэлевізійнай станцыі, выкарыстоўваючы файл выявы, каб вызначыць, якія пікселі складаюць лагатып. Ён працуе шляхам запаўнення пікселяў, якія складаюць лагатып, суседнімі пікселямі.
Фільтр прымае наступныя параметры:
filename, f
Усталюйце растравы файл фільтра, які можа быць любога фармату выявы, які падтрымліваецца libavformat. Шырыня і вышыня файла выявы павінны адпавядаць шырыні і вышыні відэаструменю, які апрацоўваецца.
Пікселі ў прадстаўленым растравым малюнку з нулявым значэннем не лічацца часткай лагатыпа, а ненулявыя пікселі лічацца часткай лагатыпа. Калі вы выкарыстоўваеце белы (255) для лагатыпа і чорны (0) для астатніх, вы будзеце ў бяспецы. Каб стварыць растравы малюнак фільтра, рэкамендуецца зрабіць здымак экрана чорнай рамкі з бачным лагатыпам, а затым выкарыстаць парогавы фільтр, а затым адзін ці два разы фільтр размывання.
Пры неабходнасці невялікія плямы можна выправіць ўручную. Памятайце, што калі пікселі лагатыпа не пакрытыя, якасць фільтра будзе значна зніжана. Пазначэнне занадта вялікай колькасці пікселяў як часткі лагатыпа не так моцна шкодзіць, але гэта павялічыць колькасць размыцця, неабходнага для пакрыцця выявы, і знішчыць больш інфармацыі, чым неабходна, а дадатковыя пікселі запаволіць працу на вялікім лагатыпе.
11.202 repeatfields
Гэты фільтр выкарыстоўвае сцяжок repeat_field з загалоўкаў Video ES і палі жорсткіх паўтораў на аснове яго значэння.
11.203 reverse
Перавярнуць відэакліп.
Папярэджанне: гэтаму фільтру патрабуецца памяць для буферызацыі ўсяго кліпа, таму рэкамендуецца абрэзаць.
11.203.1 Examples
- Вазьміце першыя 5 секунд кліпа і перавярніце яго назад.
trim=end=5,reverse
11.204 rgbashift
Зрух R/G/B/A пікселяў па гарызанталі і/або вертыкалі.
Фільтр прымае наступныя параметры:
rh
Усталюйце велічыню зрушэння чырвонага па гарызанталі.
rv
Усталюйце колькасць зруху чырвонага па вертыкалі.
gh
Усталюйце колькасць зрушэння зялёнага колеру па гарызанталі.
gv
Усталюйце колькасць зрушэння зялёнага колеру па вертыкалі.
bh
Усталюйце колькасць для зрушэння сіняга колеру па гарызанталі.
bv
Усталюйце колькасць зрушэння сіняга колеру па вертыкалі.
ah
Усталюйце велічыню зрушэння альфа-канала па гарызанталі.
av
Усталюйце колькасць зруху альфа-версіі па вертыкалі.
edge
Усталяваць рэжым краю, можа быць
smear
, стандартны абоwarp
.
11.204.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.205 roberts
Прымяненне крыжаванага аператара Робертса для ўваходнага відэапатоку.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.
delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.
11.205.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.206 rotate
Павярнуць відэа на адвольны кут, выражаны ў радыянах.
Фільтр прымае наступныя параметры:
Ніжэй прыводзіцца апісанне дадатковых параметраў.
angle, a
Усталюйце выраз для вугла, на які трэба павярнуць уваходнае відэа па гадзіннікавай стрэлцы, выражанага ў колькасці радыян. Адмоўнае значэнне прывядзе да павароту супраць гадзіннікавай стрэлкі. Па змаўчанні ён усталяваны ў "0".
Гэты выраз вылічваецца для кожнага кадра.
out_w, ow
Задайце выраз шырыні вываду, значэнне па змаўчанні - "iw". Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі.
out_h, oh
Усталюйце выраз вышыні вываду, значэнне па змаўчанні - "ih". Гэты выраз вылічваецца толькі адзін раз падчас канфігурацыі.
bilinear
Уключыць білінейную інтэрпаляцыю, калі зададзена значэнне 1, значэнне 0 адключае яе. Значэнне па змаўчанні - 1.
fillcolor, c
Усталюйце колер, які выкарыстоўваецца для запаўнення вобласці вываду, не пакрытай павернутым відарысам. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выбрана спецыяльнае значэнне «няма», фон не друкуецца (карысна, напрыклад, калі фон ніколі не паказваецца).
Значэнне па змаўчанні - "чорны".
Выразы для вугла і выхаднога памеру могуць утрымліваць наступныя канстанты і функцыі:
n
парадкавы нумар уваходнага кадра, пачынаючы з 0. Заўсёды NAN перад фільтраваннем першага кадра.
t
час у секундах уваходнага кадра, ён усталяваны ў 0, калі фільтр настроены. Заўсёды NAN перад фільтраваннем першага кадра.
hsub
vsub
гарызантальныя і вертыкальныя значэнні каляровай подвыборки. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.in_w, iw
in_h, ih
шырыня і вышыня ўваходнага відэа
out_w, ow
out_h, oh
шырыня і вышыня вываду, гэта значыць памер запаўненай вобласці, вызначаны выразамі
width
іheight
rotw(a)
roth(a)
мінімальная шырыня/вышыня, неабходная для поўнага ўтрымання ўваходнага відэа, павернутага ў
a
радыянах.Яны даступныя толькі пры вылічэнні
out_w
іout_h
выразы.
11.206.1 Examples
- Павярнуць увод на PI/6 радыян па гадзіннікавай стрэлцы:
rotate=PI/6
- Павярнуць увод на PI/6 радыян супраць гадзіннікавай стрэлкі:
rotate=-PI/6
- Павярнуць увод на 45 градусаў па гадзіннікавай стрэлцы:
rotate=45*PI/180
- Прымяніць пастаяннае кручэнне з перыядам T, пачынаючы з вугла PI/3:
rotate=PI/3+2*PI*t/T
- Зрабіце паварот уваходнага відэа вагальным з перыядам Т секунд і амплітудай А радыян:
rotate=A*sin(2*PI/T*t)
- Паварот відэа, памер вываду выбіраецца такім чынам, каб усё паваротнае ўваходнае відэа заўсёды цалкам утрымлівалася ў вывадзе:
rotate='2*PI*t:ow=hypot(iw,ih):oh=ow'
- Павярніце відэа, паменшыце памер вываду, каб фон ніколі не паказваўся:
rotate=2*PI*t:ow='min(iw,ih)/sqrt(2)':oh=ow:c=none
11.206.2 Commands
Фільтр падтрымлівае наступныя каманды:
a, angle
Задайце выраз вугла. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.207 sab
Прымяніць адаптыўнае размыццё формы.
Фільтр прымае наступныя параметры:
luma_radius, lr
Задаць інтэнсіўнасць фільтра размыцця яркасці, павінна быць значэнне ў дыяпазоне 0,1-4,0, значэнне па змаўчанні роўна 1,0. Большае значэнне прывядзе да больш размытай выявы і больш павольнай апрацоўкі.
luma_pre_filter_radius, lpfr
Задаць радыус папярэдняга фільтра яркасці, павінна быць значэнне ў дыяпазоне 0,1-2,0, значэнне па змаўчанні роўна 1,0.
luma_strength, ls
Устанавіць максімальную розніцу ў яркасці паміж пікселямі, якая будзе ўлічвацца, павінна быць значэнне ў дыяпазоне 0,1-100,0, значэнне па змаўчанні роўна 1,0.
chroma_radius, cr
Усталюйце сілу фільтра каляровага размыцця, значэнне павінна быць у дыяпазоне -0,9-4,0. Большае значэнне прывядзе да больш размытай выявы і больш павольнай апрацоўкі.
chroma_pre_filter_radius, cpfr
Задайце радыус папярэдняга фільтра каляровасці, павінна быць значэнне ў дыяпазоне -0,9-2,0.
chroma_strength, cs
Устанавіць максімальную розніцу каляровасці паміж пікселямі, якая будзе ўлічвацца, павінна быць значэнне ў дыяпазоне -0,9-100,0.
Кожнае значэнне параметра каляровасці, калі яно не вызначана відавочна, усталёўваецца ў адпаведнае значэнне параметра яркасці.
11.208 scale
Маштабуйце (змяняйце памер) уваходнага відэа з дапамогай бібліятэкі libswscale.
Фільтр маштабу прымушае суадносіны бакоў выхаднога дысплея быць такімі ж, як і ўваходныя, шляхам змены суадносін бакоў выхаднога ўзору.
Калі фармат уваходнага відарыса адрозніваецца ад фармату, запытанага наступным фільтрам, фільтр маштабу пераўтворыць уваход у запытаны фармат.
11.208.1 Options
Фільтр прымае наступныя параметры або любыя з варыянтаў, якія падтрымліваюцца праграмай маштабавання libswscale.
Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для поўнага спісу параметраў маштабавання.
width, w
height, h
Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.
Калі значэнне
width
orw
роўна 0, шырыня ўводу выкарыстоўваецца для вываду. Калі значэннеheight
orh
роўна 0, вышыня ўводу выкарыстоўваецца для вываду.Калі адно і толькі адно са значэнняў роўна -n з n >= 1, фільтр маштабу будзе выкарыстоўваць значэнне, якое падтрымлівае суадносіны бакоў уваходнага відарыса, разлічаныя з іншага зададзенага памеру. Аднак пасля гэтага ён пераканаецца, што вылічаны памер дзеліцца на n, і пры неабходнасці скарэктуе значэнне.
Калі абодва значэнні маюць -n з n >= 1, паводзіны будуць аднолькавымі да таго, што для абодвух значэнняў будзе прысвоена 0, як было апісана раней.
Глядзіце ніжэй спіс прынятых канстант для выкарыстання ў выразе памернасці.
eval
Укажыце, калі ацэньваць
width
іheight
выраз. Ён прымае наступныя значэнні:- '
init
' Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.
- '
frame
' Ацаніце выразы для кожнага ўваходнага кадра.
Значэнне па змаўчанні '
init
'.- '
interl
Усталюйце рэжым перапляцення. Ён прымае наступныя значэнні:
- '
1
' Прымусовае празрадковае ўсвядомленае маштабаванне.
- '
0
' Не ўжывайце празрадковае маштабаванне.
- '
-1
' Выберыце празрадковае ўсвядомленае маштабаванне ў залежнасці ад таго, пазначаны зыходныя кадры як празрадковыя ці не.
Значэнне па змаўчанні '
0
'.- '
flags
Усталюйце сцягі маштабавання libswscale. Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для атрымання поўнага спісу значэнняў. Калі гэта не вызначана відавочна, фільтр прымяняе сцягі па змаўчанні.
param0, param1
Усталюйце ўваходныя параметры libswscale для алгарытмаў маштабавання, якім яны патрэбныя. Глядзіце (ffmpeg-scaler) кіраўніцтва ffmpeg-scaler для атрымання поўнай дакументацыі. Калі гэта не пазначана відавочна, фільтр прымяняе пустыя параметры.
size, s
Усталюйце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
in_color_matrix
out_color_matrix
Задаць тып каляровай прасторы ўваходу/вываду YCbCr.
Гэта дазваляе перавызначыць аўтаматычна вызначанае значэнне, а таксама дазваляе прымусова ўводзіць пэўнае значэнне, якое выкарыстоўваецца для вываду і кадавальніка.
Калі не пазначана, тып каляровай прасторы залежыць ад фармату пікселяў.
Магчымыя значэнні:
- '
auto
' Выбіраць аўтаматычна.
- '
bt709
' Фармат адпавядае рэкамендацыі Міжнароднага саюза электрасувязі (МСЭ) BT.709.
- '
fcc
' Усталюйце каляровую прастору ў адпаведнасці з кодэксам федэральных правілаў (CFR) Федэральнай камісіі ЗША па сувязі (FCC), раздзел 47 (2003) 73.682 (a).
- '
bt601
' - '
bt470
' - '
smpte170m
' Усталюйце каляровую прастору ў адпаведнасці з:
- Рэкамендацыя Сектара радыёсувязі МСЭ (МСЭ-R) BT.601
- Рэк. МСЭ-R BT.470-6 (1998) Сістэмы B, B1 і G
- Таварыства інжынераў па кіно і тэлебачанні (SMPTE) ST 170:2004
- '
smpte240m
' Усталюйце каляровую прастору ў адпаведнасці са SMPTE ST 240:1999.
- '
bt2020
' Усталюйце каляровую прастору ў адпаведнасці з сістэмай непастаяннай яркасці ITU-R BT.2020.
- '
in_range
out_range
Усталяваць уваходны/выхадны дыяпазон выбаркі YCbCr.
Гэта дазваляе перавызначыць аўтаматычна вызначанае значэнне, а таксама дазваляе прымусова ўводзіць пэўнае значэнне, якое выкарыстоўваецца для вываду і кадавальніка. Калі не пазначана, дыяпазон залежыць ад фармату пікселяў. Магчымыя значэнні:
- '
auto/unknown
' Выбіраць аўтаматычна.
- '
jpeg/full/pc
' Усталюйце поўны дыяпазон (0-255 у выпадку 8-бітнай яркасці).
- '
mpeg/limited/tv
' Усталюйце дыяпазон «MPEG» (16-235 у выпадку 8-бітнай яркасці).
- '
force_original_aspect_ratio
Пры неабходнасці ўключыце памяншэнне або павелічэнне шырыні або вышыні выходнага відэа, каб захаваць зыходныя суадносіны бакоў. Магчымыя значэнні:
- '
disable
' Павялічце відэа ў адпаведнасці з указаннямі і адключыце гэту функцыю.
- '
decrease
' Памеры выхаднога відэа будуць аўтаматычна памяншацца пры неабходнасці.
- '
increase
' Памеры выхаднога відэа будуць аўтаматычна павялічаны пры неабходнасці.
Адным з карысных прыкладаў гэтай опцыі з'яўляецца тое, што, калі вы ведаеце максімальна дазволеную раздзяляльнасць пэўнай прылады, вы можаце выкарыстоўваць яе, каб абмежаваць выхад відэа гэтым, захоўваючы суадносіны бакоў. Напрыклад, прылада A дазваляе прайграваць 1280x720, а ваша відэа мае 1920x800. Выкарыстанне гэтай опцыі (усталюйце для яе памяншэнне) і ўказанне 1280x720 у камандным радку робіць выхад 1280x533.
Звярніце ўвагу, што гэта адрозніваецца ад указання -1 для
w
абоh
, вам усё роўна трэба ўказаць разрозненне вываду, каб гэты параметр працаваў.- '
force_divisible_by
Гарантуе, што абодва выходныя памеры, шырыня і вышыня, дзеляцца на зададзены цэлы лік пры выкарыстанні разам з
force_original_aspect_ratio
. Гэта працуе падобна на выкарыстанне-n
ўw
іh
опцыі.Гэты параметр улічвае значэнне, зададзенае для
force_original_aspect_ratio
, адпаведна павялічваючы або памяншаючы дазвол. Суадносіны бакоў відэа могуць быць крыху зменены.Гэтая опцыя можа быць зручнай, калі вам трэба, каб відэа змясцілася ў межах вызначанага дазволу або перавышала яго
force_original_aspect_ratio
але таксама ёсць абмежаванні кадавальніка па шырыні і вышыні.
Каштоўнасці стw
іh
параметры - гэта выразы, якія змяшчаюць наступныя канстанты:
in_w
in_h
Шырыня і вышыня ўводу
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Шырыня і вышыня вываду (у маштабе).
ow
oh
Гэта тое самае, што
out_w
іout_h
a
Тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
Суадносіны бакоў уваходнага дысплея. Разлічваецца з
(iw / ih) * sar
.hsub
vsub
гарызантальныя і вертыкальныя ўваходныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.ohsub
ovsub
гарызантальныя і вертыкальныя вывадныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.n
(Парадкавы) нумар уваходнага кадра, пачынаючы з 0. Даступна толькі з
eval=frame
.t
Метка часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з
eval=frame
.pos
Палажэнне (байтавае зрушэнне) кадра ва ўваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з
eval=frame
.
11.208.2 Examples
- Павялічце ўваходнае відэа да памеру 200x100
scale=w=200:h=100
Гэта эквівалентна:
scale=200:100
або:
scale=200x100
- Укажыце абрэвіятуру памеру для выхаднога памеру:
scale=qcif
што таксама можа быць запісана як:
scale=size=qcif
- Павялічце ўвод у 2 разы:
scale=w=2*iw:h=2*ih
- Вышэй тое самае, што:
scale=2*in_w:2*in_h
- Павялічце ўвод да 2x з прымусовым празрадковым маштабаваннем:
scale=2*iw:2*ih:interl=1
- Паменшыць увод да паловы памеру:
scale=w=iw/2:h=ih/2
- Павялічце шырыню і ўсталюйце той жа памер для вышыні:
scale=3/2*iw:ow
- Шукайце грэчаскую гармонію:
scale=iw:1/PHI*iw scale=ih*PHI:ih
- Павялічце вышыню і ўсталюйце шырыню на 3/2 вышыні:
scale=w=3/2*oh:h=3/5*ih
- Павялічце памер, зрабіўшы памер кратным значэнням падвыбаркі каляровасці:
scale="trunc(3/2*iw/hsub)*hsub:trunc(3/2*ih/vsub)*vsub"
- Павялічце шырыню максімум да 500 пікселяў, захаваўшы тыя ж суадносіны бакоў, што і ўвод:
scale=w='min(500\, iw*3/2):h=-1'
- Зрабіце пікселі квадратнымі, камбінуючы маштаб і набор:
scale='trunc(ih*dar):ih',setsar=1/1
- Зрабіце пікселі квадратнымі, аб'яднаўшы scale і setsar, пераканаўшыся, што выніковае раздзяленне роўнае (патрабуецца некаторымі кодэкамі):
scale='trunc(ih*dar/2)*2:trunc(ih/2)*2',setsar=1/1
11.208.3 Commands
Гэты фільтр падтрымлівае наступныя каманды:
width, w
height, h
Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.209 scale_cuda
Маштабуйце (змяняйце памер) і пераўтварайце (піксельны фармат) уваходнае відэа з дапамогай паскораных ядраў CUDA. Налада выхадных шырыні і вышыні працуе гэтак жа, як і для маштабнага фільтра.
Фільтр прымае наступныя параметры:
w
h
Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.
Дазваляе тыя ж выразы, што і маштабны фільтр.
interp_algo
Задае алгарытм, які выкарыстоўваецца для маштабавання:
nearest
Бліжэйшы сусед
Выкарыстоўваецца па змаўчанні, калі ўваходныя параметры супадаюць з жаданым выхадам.
bilinear
Білінейны
bicubic
Бікубічны
Гэта па змаўчанні.
lanczos
Ланцош
format
Кіруе фарматам выхаднога пікселя. Па змаўчанні або, калі не пазначана, выкарыстоўваецца ўваходны фармат пікселяў.
Фільтр не падтрымлівае пераўтварэнне паміж фарматамі пікселяў YUV і RGB.
passthrough
Калі ўстаноўлена значэнне 0, апрацоўваецца кожны кадр, нават калі пераўтварэнне не патрабуецца. Гэты рэжым можа быць карысны для выкарыстання фільтра ў якасці буфера для спажыўца фрэйма ніжэй па плыні, які вычэрпвае абмежаваны пул кадраў дэкодэра.
Калі ўстаноўлена ў 1, кадры перадаюцца як ёсць, калі яны адпавядаюць жаданым выходным параметрам. Гэта паводзіны па змаўчанні.
param
Спецыфічны для алгарытму параметр.
Уплывае на крывыя бікубічнага алгарытму.
force_original_aspect_ratio
force_divisible_by
Працуюць гэтак жа, як і ідэнтычныя варыянты маштабнага фільтра.
11.209.1 Examples
- Маштабуйце ўваход да 720p, захоўваючы суадносіны бакоў і забяспечваючы выхад yuv420p.
scale_cuda=-2:720:format=yuv420p
- Павялічыць да 4K з выкарыстаннем алгарытму бліжэйшага суседа.
scale_cuda=4096:2160:interp_algo=nearest
- Не рабіце ніякіх пераўтварэнняў або маштабавання, але скапіруйце ўсе ўваходныя кадры ў новыя выдзеленыя. Гэта можа быць карысна для працы з ланцужком фільтра і кадавання, які ў іншым выпадку вычэрпвае пул кадраў дэкодэра.
scale_cuda=passthrough=0
11.210 scale_npp
Выкарыстоўвайце NVIDIA Performance Primitives (libnpp) для выканання маштабавання і/або пераўтварэння фармату пікселяў на відэакадрах CUDA. Наладжванне шырыні і вышыні вываду працуе гэтак жа, як і для scale
фільтра.
Прымаюцца наступныя дадатковыя варыянты:
format
Піксельны фармат выходных кадраў CUDA. Калі ўсталяваны радок "same" (па змаўчанні), фармат уводу будзе захаваны. Звярніце ўвагу, што аўтаматычнае ўзгадненне фармату і пераўтварэнне пакуль не падтрымліваюцца для апаратных кадраў
interp_algo
Алгарытм інтэрпаляцыі, які выкарыстоўваецца для змены памеру. Адзін з наступнага:
nn
Бліжэйшы сусед.
linear
cubic
cubic2p_bspline
Кубік з 2 параметрамі (B=1, C=0)
cubic2p_catmullrom
Кубік з 2 параметрамі (B=0, C=1/2)
cubic2p_b05c03
Кубік з 2 параметрамі (B=1/2, C=3/10)
super
Суперсэмплінг
lanczos
force_original_aspect_ratio
Пры неабходнасці ўключыце памяншэнне або павелічэнне шырыні або вышыні выходнага відэа, каб захаваць зыходныя суадносіны бакоў. Магчымыя значэнні:
- '
disable
' Павялічце відэа ў адпаведнасці з указаннямі і адключыце гэту функцыю.
- '
decrease
' Памеры выхаднога відэа будуць аўтаматычна памяншацца пры неабходнасці.
- '
increase
' Памеры выхаднога відэа будуць аўтаматычна павялічаны пры неабходнасці.
Адным з карысных прыкладаў гэтай опцыі з'яўляецца тое, што, калі вы ведаеце максімальна дазволеную раздзяляльнасць пэўнай прылады, вы можаце выкарыстоўваць яе, каб абмежаваць выхад відэа гэтым, захоўваючы суадносіны бакоў. Напрыклад, прылада A дазваляе прайграваць 1280x720, а ваша відэа мае 1920x800. Выкарыстанне гэтай опцыі (усталюйце для яе памяншэнне) і ўказанне 1280x720 у камандным радку робіць выхад 1280x533.
Звярніце ўвагу, што гэта адрозніваецца ад указання -1 для
w
абоh
, вам усё роўна трэба ўказаць разрозненне вываду, каб гэты параметр працаваў.- '
force_divisible_by
Гарантуе, што абодва выходныя памеры, шырыня і вышыня, дзеляцца на зададзены цэлы лік пры выкарыстанні разам з
force_original_aspect_ratio
. Гэта працуе падобна на выкарыстанне-n
ўw
іh
опцыі.Гэты параметр улічвае значэнне, зададзенае для
force_original_aspect_ratio
, адпаведна павялічваючы або памяншаючы дазвол. Суадносіны бакоў відэа могуць быць крыху зменены.Гэтая опцыя можа быць зручнай, калі вам трэба, каб відэа змясцілася ў межах вызначанага дазволу або перавышала яго
force_original_aspect_ratio
але таксама ёсць абмежаванні кадавальніка па шырыні і вышыні.eval
Укажыце, калі ацэньваць
width
іheight
выраз. Ён прымае наступныя значэнні:- '
init
' Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра або падчас апрацоўкі каманды.
- '
frame
' Ацаніце выразы для кожнага ўваходнага кадра.
- '
Каштоўнасці стw
іh
параметры - гэта выразы, якія змяшчаюць наступныя канстанты:
in_w
in_h
Шырыня і вышыня ўводу
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Шырыня і вышыня вываду (у маштабе).
ow
oh
Гэта тое самае, што
out_w
іout_h
a
Тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
Суадносіны бакоў уваходнага дысплея. Разлічваецца з
(iw / ih) * sar
.n
(Парадкавы) нумар уваходнага кадра, пачынаючы з 0. Даступна толькі з
eval=frame
.t
Метка часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з
eval=frame
.pos
Палажэнне (байтавае зрушэнне) кадра ва ўваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з
eval=frame
.
11.211 scale2ref
Маштабаванне (змена памеру) уваходнага відэа на аснове эталоннага відэа.
Глядзіце фільтр маштабу, каб даведацца пра даступныя параметры, scale2ref падтрымлівае тое ж самае, але выкарыстоўвае эталоннае відэа замест асноўнага ўводу ў якасці асновы. scale2ref таксама падтрымлівае наступныя дадатковыя канстанты дляw
і
h
варыянты:
main_w
main_h
Шырыня і вышыня асноўнага ўваходнага відэа
main_a
Тое самае, што
main_w
/main_h
main_sar
Узор суадносін бакоў асноўнага ўваходнага відэа
main_dar, mdar
Суадносіны бакоў адлюстравання асноўнага ўваходнага відэа. Разлічваецца з
(main_w / main_h) * main_sar
.main_hsub
main_vsub
Значэнні падвыбаркі каляровасці асноўнага ўваходнага відэа па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.main_n
(Парадкавы) нумар асноўнага кадра ўводу, пачынаючы з 0. Даступна толькі з
eval=frame
.main_t
Метка часу прэзентацыі асноўнага ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з
eval=frame
.main_pos
Палажэнне (байтавае зрушэнне) кадра ў асноўным уваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з
eval=frame
.
11.211.1 Examples
- Перад накладаннем змяніце паток субтытраў (b), каб ён адпавядаў памеру асноўнага відэа (a).
'scale2ref[b][a];[a][b]overlay'
- Павялічце лагатып да 1/10 вышыні відэа, захаваўшы суадносіны бакоў экрана.
[logo-in][video-in]scale2ref=w=oh*mdar:h=ih/10[logo-out][video-out]
11.211.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
width, w
height, h
Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
11.212 scale2ref_npp
Выкарыстоўвайце NVIDIA Performance Primitives (libnpp), каб маштабаваць (змяняць памер) уваходнага відэа на аснове эталоннага відэа.
Глядзіце фільтр scale_npp , каб даведацца пра даступныя параметры, scale2ref_npp падтрымлівае тое ж самае, але выкарыстоўвае эталоннае відэа замест асноўнага ўводу ў якасці асновы. scale2ref_npp таксама падтрымлівае наступныя дадатковыя канстанты дляw
і
h
варыянты:
main_w
main_h
Шырыня і вышыня асноўнага ўваходнага відэа
main_a
Тое самае, што
main_w
/main_h
main_sar
Узор суадносін бакоў асноўнага ўваходнага відэа
main_dar, mdar
Суадносіны бакоў адлюстравання асноўнага ўваходнага відэа. Разлічваецца з
(main_w / main_h) * main_sar
.main_n
(Парадкавы) нумар асноўнага кадра ўводу, пачынаючы з 0. Даступна толькі з
eval=frame
.main_t
Метка часу прэзентацыі асноўнага ўваходнага кадра, выражаная ў колькасці секунд. Даступна толькі з
eval=frame
.main_pos
Палажэнне (байтавае зрушэнне) кадра ў асноўным уваходным патоку або NaN, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа). Даступна толькі з
eval=frame
.
11.212.1 Examples
- Перад накладаннем змяніце паток субтытраў (b), каб ён адпавядаў памеру асноўнага відэа (a).
'scale2ref_npp[b][a];[a][b]overlay_cuda'
- Павялічце лагатып да 1/10 вышыні відэа, захаваўшы суадносіны бакоў экрана.
[logo-in][video-in]scale2ref_npp=w=oh*mdar:h=ih/10[logo-out][video-out]
11.213 scharr
Прымяніць аператар scharr да ўваходнага відэаструменю.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.
delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.
11.213.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.214 scroll
Пракрутка ўваходнага відэа па гарызанталі і/ці па вертыкалі з пастаяннай хуткасцю.
Фільтр прымае наступныя параметры:
horizontal, h
Усталюйце хуткасць гарызантальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1. Адмоўныя значэнні змяняюць кірунак пракруткі.
vertical, v
Усталюйце хуткасць вертыкальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад -1 да 1. Адмоўныя значэнні змяняюць кірунак пракруткі.
hpos
Усталюйце пачатковае становішча гарызантальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 1.
vpos
Усталюйце пачатковае становішча вертыкальнай пракруткі. Па змаўчанні 0. Дазволены дыяпазон ад 0 да 1.
11.214.1 Commands
Гэты фільтр падтрымлівае наступныя каманды :
horizontal, h
Усталюйце хуткасць гарызантальнай пракруткі.
vertical, v
Усталюйце хуткасць вертыкальнай пракруткі.
11.215 scdet
Выяўленне змены сцэны відэа.
Гэты фільтр усталёўвае метаданыя кадра з mafd паміж кадрам, ацэнкай сцэны і перанакіроўвае кадр да наступнага фільтра, каб яны маглі выкарыстоўваць гэтыя метаданыя для выяўлення змены сцэны ці іншых.
Акрамя таго, гэты фільтр рэгіструе паведамленне і ўсталёўвае метаданыя кадра пры выяўленні змены сцэныthreshold
.
lavfi.scd.mafd
ключы метададзеных усталёўваюцца з дапамогай mafd для кожнага кадра.
lavfi.scd.score
ключы метададзеных усталёўваюцца з ацэнкай змены сцэны для кожнага кадра для выяўлення змены сцэны.
lavfi.scd.time
ключы метададзеных усталёўваюцца з бягучым адфільтраваным часам кадра, які вызначае змену сцэныthreshold
.
Фільтр прымае наступныя параметры:
threshold, t
Усталюйце парог выяўлення змены сцэны ў працэнтах ад максімальнай змены. Добрыя значэння знаходзяцца ў
[8.0, 14.0]
дыяпазоне. Асартымент дляthreshold
ёсць[0., 100.]
.Значэнне па змаўчанні -
10.
.sc_pass, s
Усталюйце сцяг для перадачы кадраў змены сцэны ў наступны фільтр. Значэнне па змаўчанні -
0
Вы можаце ўключыць яго, калі хочаце атрымаць здымак толькі кадраў змены сцэны.
11.216 selectivecolor
Адрэгулюйце блакітны, пурпурны, жоўты і чорны (CMYK) для пэўных дыяпазонаў колераў (напрыклад, «чырвоныя», «жоўтыя», «зялёныя», «блакітныя», ...). Дыяпазон рэгулявання вызначаецца «чысцінёй» колеру (гэта значыць, наколькі ён ужо насычаны).
Гэты фільтр падобны да інструмента Adobe Photoshop Selective Color.
Фільтр прымае наступныя параметры:
correction_method
Выберыце метад карэкцыі колеру.
Даступныя значэнні:
- '
absolute
' Указаныя карэкціроўкі прымяняюцца "як ёсць" (дадаюцца/адымаюцца да зыходнага значэння піксельнага кампанента).
- '
relative
' Указаныя карэкціроўкі адносяцца да зыходнага значэння кампанента.
Па змаўчанні
absolute
.- '
reds
Карэкціроўкі для чырвоных пікселяў (пікселяў, дзе чырвоны кампанент максімальны)
yellows
Карэкціроўкі жоўтых пікселяў (пікселяў, дзе сіні кампанент мінімальны)
greens
Карэкціроўкі для зялёных пікселяў (пікселяў, у якіх зялёны кампанент максімальны)
cyans
Карэкціроўкі блакітных пікселяў (пікселяў, у якіх чырвоны кампанент мінімальны)
blues
Карэкціроўкі для сініх пікселяў (пікселяў, дзе сіні кампанент максімальны)
magentas
Карэкціроўкі для пурпурных пікселяў (пікселяў, у якіх зялёны кампанент мінімальны)
whites
Карэкціроўкі для белых пікселяў (пікселяў, у якіх усе кампаненты больш за 128)
neutrals
Карэкціроўкі для ўсіх пікселяў, акрамя чыста чорнага і чыста белага
blacks
Карэкціроўкі для чорных пікселяў (пікселяў, у якіх усе кампаненты менш за 128)
psfile
Укажыце файл селектыўнага колеру Photoshop (
.asv
), з якога трэба імпартаваць налады.
Усе параметры рэгулявання (reds
,yellows
, ...) прымаюць да 4 значэнняў рэгулявання з плаваючай коскай, падзеленых прабелам, у дыяпазоне [-1,1] адпаведна, каб наладзіць колькасць блакітнага, пурпурнога, жоўтага і чорнага для пікселяў у сваім дыяпазоне.
11.216.1 Examples
- Павялічце блакітны на 50% і паменшыце жоўты на 33% у кожнай зялёнай вобласці і павялічце пурпурны на 27% у сініх абласцях:
selectivecolor=greens=.5 0 -.33 0:blues=0 .27
- Скарыстайцеся перадусталёўкай выбарачнага колеру Photoshop:
selectivecolor=psfile=MySelectiveColorPresets/Misty.asv
11.217 separatefields
Ён separatefields
прымае відэаўваход на аснове кадраў і разбівае кожны кадр на палі кампанентаў, ствараючы новы кліп на палову вышыні з удвая большай частатой і ўдвая большай колькасцю кадраў.
Гэты фільтр выкарыстоўвае інфармацыю аб дамінаванні палёў у кадры, каб вырашыць, якое з кожнай пары палёў размясціць першым у вывадзе. Калі гэта памыляецца, выкарыстоўвайце фільтр setfield перад separatefields
фільтрам.
11.218 setdar, setsar
Фільтр setdar
усталёўвае суадносіны бакоў дысплея для выхаднога відэа фільтра.
Гэта робіцца шляхам змены вызначанага суадносін бакоў выбаркі (ён жа піксель) у адпаведнасці з наступным ураўненнем:
DAR
= HORIZONTAL_RESOLUTION
/ VERTICAL_RESOLUTION
* SAR
Майце на ўвазе, што setdar
фільтр не змяняе памеры відэакадра ў пікселях. Акрамя таго, суадносіны бакоў дысплея, устаноўленыя гэтым фільтрам, могуць быць зменены пазнейшымі фільтрамі ў ланцужку фільтраў, напрыклад, у выпадку маштабавання або прымянення іншага фільтра "setdar" або "setsar".
Фільтр setsar
задае выбарку (ён жа піксель) суадносін бакоў для выхаднога відэа фільтра.
Звярніце ўвагу, што ў выніку прымянення гэтага фільтра суадносіны бакоў выхаднога дысплея зменяцца ў адпаведнасці з прыведзеным вышэй ураўненнем.
Майце на ўвазе, што суадносіны бакоў узору, устаноўленыя setsar
фільтрам, могуць быць зменены пазнейшымі фільтрамі ў ланцужку фільтраў, напрыклад, калі ўжыты іншы фільтр "setsar" або "setdar".
Ён прымае наступныя параметры:
r, ratio, dar (
setdar
only), sar (setsar
only)Усталюйце суадносіны бакоў, якія выкарыстоўваюцца фільтрам.
Параметрам можа быць лічбавы радок з плаваючай коскай, выраз або радок выгляду
num
:den
, дзеnum
іden
з'яўляюцца лічнікам і назоўнікам суадносін бакоў. Калі параметр не ўказаны, прымаецца значэнне «0». У выпадку выкарыстання формы "num
:den
":
сімвал павінен быць экранаваны.max
Усталюйце максімальнае цэлае значэнне для выражэння лічніка і назоўніка пры памяншэнні выражанага суадносін бакоў да рацыянальнага. Значэнне па змаўчанні -
100
.
Параметр sar
- гэта выраз, які змяшчае наступныя канстанты:
E, PI, PHI
Гэта прыблізныя значэнні матэматычных канстант e (лік Эйлера), pi (грэцкае pi) і phi (залатое сячэнне).
w, h
Шырыня і вышыня ўводу.
a
Гэта тое самае, што
w
/h
.sar
Суадносіны бакоў уводнага ўзору.
dar
Суадносіны бакоў уваходнага дысплея. Гэта тое самае, што (
w
/h
) *sar
.hsub, vsub
Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.
11.218.1 Examples
- Каб змяніць суадносіны бакоў дысплея на 16:9, задайце адно з наступнага:
setdar=dar=1.77777 setdar=dar=16/9
- Каб змяніць узор суадносін бакоў на 10:11, укажыце:
setsar=sar=10/11
- Каб усталяваць суадносіны бакоў дысплея 16:9 і ўказаць максімальнае цэлае значэнне 1000 у памяншэнні суадносін бакоў, выкарыстоўвайце каманду:
setdar=ratio=16/9:max=1000
11.219 setfield
Сілавое поле для выхаднога відэакадра.
Фільтр setfield
пазначае поле тыпу празрадковай разгорткі для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра наступнымі фільтрамі (напрыклад, fieldorder
або yadif
).
Фільтр прымае наступныя параметры:
mode
Даступныя значэнні:
- '
auto
' Захаваць аднолькавае ўласцівасць поля.
- '
bff
' Пазначце кадр як ніжняе поле спачатку.
- '
tff
' Пазначце кадр як верхняе поле спачатку.
- '
prog
' Пазначце кадр як прагрэсіўны.
- '
11.220 setparams
Параметр Force frame для выхаднога відэакадра.
Фільтр setparams
адзначае празрадковую разгортку і дыяпазон колераў для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра фільтрамі/кадавальнікамі.
field_mode
Даступныя значэнні:
- '
auto
' Захаваць аднолькавае ўласцівасць поля (па змаўчанні).
- '
bff
' Пазначце кадр як ніжняе поле спачатку.
- '
tff
' Пазначце кадр як верхняе поле спачатку.
- '
prog
' Пазначце кадр як прагрэсіўны.
- '
range
Даступныя значэнні:
- '
auto
' Захаваць тую ж уласцівасць каляровага дыяпазону (па змаўчанні).
- '
unspecified, unknown
' Пазначыць рамку як нявызначаную каляровую гаму.
- '
limited, tv, mpeg
' Адзначце кадр як абмежаваны дыяпазон.
- '
full, pc, jpeg
' Адзначце кадр як поўны дыяпазон.
- '
color_primaries
Усталюйце асноўны колер. Даступныя значэнні:
- '
auto
' Захаваць уласцівасць асноўных колераў (па змаўчанні).
- '
bt709
' - '
unknown
' - '
bt470m
' - '
bt470bg
' - '
smpte170m
' - '
smpte240m
' - '
film
' - '
bt2020
' - '
smpte428
' - '
smpte431
' - '
smpte432
' - '
jedec-p22
'
- '
color_trc
Усталюйце перадачу колеру. Даступныя значэнні:
- '
auto
' Захаваць уласцівасць trc колеру той жа (па змаўчанні).
- '
bt709
' - '
unknown
' - '
bt470m
' - '
bt470bg
' - '
smpte170m
' - '
smpte240m
' - '
linear
' - '
log100
' - '
log316
' - '
iec61966-2-4
' - '
bt1361e
' - '
iec61966-2-1
' - '
bt2020-10
' - '
bt2020-12
' - '
smpte2084
' - '
smpte428
' - '
arib-std-b67
'
- '
colorspace
Усталюйце каляровую прастору. Даступныя значэнні:
- '
auto
' Захаваць тую ж уласцівасць каляровай прасторы (па змаўчанні).
- '
gbr
' - '
bt709
' - '
unknown
' - '
fcc
' - '
bt470bg
' - '
smpte170m
' - '
smpte240m
' - '
ycgco
' - '
bt2020nc
' - '
bt2020c
' - '
smpte2085
' - '
chroma-derived-nc
' - '
chroma-derived-c
' - '
ictcp
'
- '
11.221 sharpen_npp
Выкарыстоўвайце NVIDIA Performance Primitives (libnpp) для павышэння рэзкасці выявы з кантролем межаў.
Прымаюцца наступныя дадатковыя варыянты:
border_type
Тып выбаркі, якая будзе выкарыстоўвацца, межы рамкі аб'явы. Адзін з наступнага:
replicate
Паўтарыць значэнні пікселяў.
11.222 shear
Прымяніць пераўтварэнне зруху да ўваходнага відэа.
Гэты фільтр падтрымлівае наступныя параметры:
shx
Каэфіцыент зруху ў напрамку X. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад -2 да 2.
shy
Каэфіцыент зруху ў напрамку Y. Значэнне па змаўчанні - 0. Дазволены дыяпазон ад -2 да 2.
fillcolor, c
Усталюйце колер, які выкарыстоўваецца для запаўнення вобласці вываду, не пакрытай трансфармаваным відэа. Для атрымання агульнага сінтаксісу гэтай опцыі праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Калі выбрана спецыяльнае значэнне «няма», фон не друкуецца (карысна, напрыклад, калі фон ніколі не паказваецца).
Значэнне па змаўчанні - "чорны".
interp
Усталюйце тып інтэрпаляцыі. Можа быць
bilinear
абоnearest
. Па змаўчанніbilinear
.
11.222.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.223 showinfo
Паказаць радок, які змяшчае розную інфармацыю для кожнага кадра ўваходнага відэа. Уваходнае відэа не зменена.
Гэты фільтр падтрымлівае наступныя параметры:
checksum
Вылічыце кантрольныя сумы кожнай плоскасці. Па змаўчанні ўключана.
Паказаны радок змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе
key
: value
.
У вывадзе паказаны наступныя значэнні:
n
(Парадкавы) нумар уваходнага кадра, пачынаючы з 0.
pts
Пазнака часу прэзентацыі ўваходнага кадра, выражаная ў колькасці адзінак асноўнага часу. Адзінка асновы часу залежыць ад пляцоўкі ўводу фільтра.
pts_time
Пазнака часу прэзентацыі ўваходнага кадра, выражаная ў колькасці секунд.
pos
Становішча кадра ва ўваходным патоку або -1, калі гэтая інфармацыя недаступная і/або бессэнсоўная (напрыклад, у выпадку сінтэтычнага відэа).
fmt
Назва фармату пікселяў.
sar
Прыклад суадносін бакоў уваходнага кадра, выражаны ў форме
num
/den
.s
Памер уваходнага кадра. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
i
Тып празрадковага рэжыму ("P" для "прагрэсіўнага", "T" для верхняга поля, "B" для ніжняга поля).
iskey
Гэта 1, калі кадр з'яўляецца ключавым, 0 у адваротным выпадку.
type
Тып выявы ўваходнага кадра ("I" для I-кадра, "P" для P-кадра, "B" для B-кадра або "?" для невядомага тыпу). Таксама звярніцеся да дакументацыі
AVPictureType
пералічэння іav_get_picture_type_char
функцыі, вызначанай уlibavutil/avutil.h
.checksum
Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) усіх плоскасцей уваходнага кадра.
plane_checksum
Кантрольная сума Adler-32 (надрукаваная ў шаснаццатковай форме) кожнай плоскасці ўваходнага кадра, выражаная ў выглядзе "[ ]".
c0
c1
c2
c3
mean
Сярэдняе значэнне пікселяў у кожнай плоскасці ўваходнага кадра, выражанае ў выглядзе "[ ]".
mean0
mean1
mean2
mean3
stdev
Стандартнае адхіленне значэнняў пікселяў у кожнай плоскасці ўваходнага кадра, выражанае ў выглядзе "[ ]".
stdev0
stdev1
stdev2
stdev3
11.224 showpalette
Адлюстроўвае палітру з 256 колераў кожнага кадра. Гэты фільтр актуальны толькі для
pal8
кадраў піксельнага фармату.
Ён прымае наступны варыянт:
s
Усталюйце памер поля, якое выкарыстоўваецца для прадстаўлення аднаго запісу колеру палітры. Па змаўчанні
30
(для30x30
скрынкі пікселяў).
11.225 shuffleframes
Змяніце парадак і/або дублюйце і/або выдаліце ​​відэакадры.
Ён прымае наступныя параметры:
mapping
Усталюйце індэксы прызначэння ўваходных кадраў. Гэта прабел або '|' асобны спіс індэксаў, які адлюстроўвае ўваходныя кадры ў выходныя кадры. Колькасць індэксаў таксама задае максімальнае значэнне, якое можа мець кожны індэкс. «-1» індэкс мае асаблівае значэнне, і гэта падзенне кадра.
Першы кадр мае індэкс 0. Па змаўчанні ўвод застаецца нязменным.
11.225.1 Examples
- Памяняйце месцамі другі і трэці кадр з кожных трох кадраў уводу:
ffmpeg -i INPUT -vf "shuffleframes=0 2 1" OUTPUT
- Памяняць месцамі 10-ы і 1-ы кадры кожных дзесяці кадраў уводу:
ffmpeg -i INPUT -vf "shuffleframes=9 1 2 3 4 5 6 7 8 0" OUTPUT
11.226 shufflepixels
Змяніць парадак пікселяў у кадрах відэа.
Гэты фільтр прымае наступныя параметры:
direction, d
Усталюйце кірунак ператасавання. Можа быць прамым або зваротным напрамкам. Напрамак па змаўчанні - наперад.
mode, m
Усталюйце рэжым ператасоўкі. Можа быць гарызантальны, вертыкальны або блокавы рэжым.
width, w
height, h
Усталюйце ператасаваць block_size. У выпадку гарызантальнага рэжыму перамешвання выкарыстоўваецца толькі частка памеру шырыні, а ў выпадку рэжыму вертыкальнай ператасоўкі выкарыстоўваецца толькі частка памеру вышыні.
seed, s
Усталюйце выпадковае пачатковае значэнне з ператасоўкай пікселяў. Галоўным чынам карысна ўсталяваць, каб мець магчымасць адмяніць працэс фільтрацыі, каб атрымаць зыходны ўвод. Напрыклад, каб ператасаваць уперад назад, трэба выкарыстоўваць аднолькавыя параметры і сапраўды такі ж пачатковы момант, а таксама задаць кірунак у зваротным парадку.
11.227 shuffleplanes
Змяніце парадак і/або дублюйце плоскасці відэа.
Ён прымае наступныя параметры:
map0
Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці першай плоскасці вываду.
map1
Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці другой плоскасці вываду.
map2
Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці трэцяй плоскасці вываду.
map3
Індэкс плоскасці ўводу, якая будзе выкарыстоўвацца ў якасці чацвёртай плоскасці вываду.
Першая плоскасць мае індэкс 0. Па змаўчанні ўвод застаецца нязменным.
11.227.1 Examples
- Памяняйце месцамі другую і трэцюю плоскасці ўводу:
ffmpeg -i INPUT -vf shuffleplanes=0:2:1:3 OUTPUT
11.228 signalstats
Ацэнка розных візуальных паказчыкаў, якія дапамагаюць у вызначэнні праблем, звязаных з алічбоўкай аналагавых відэа носьбітаў.
Па змаўчанні фільтр будзе запісваць гэтыя значэнні метададзеных:
YMIN
Адлюстраванне мінімальнага значэння Y, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
YLOW
Адлюстраванне значэння Y на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
YAVG
Адлюстраванне сярэдняга значэння Y ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
YHIGH
Адлюстраванне значэння Y на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
YMAX
Адлюстраванне максімальнага значэння Y, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
UMIN
Адлюстраванне мінімальнага значэння U, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
ULOW
Адлюстраванне значэння U на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
UAVG
Адлюстраванне сярэдняга значэння U ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
UHIGH
Адлюстраванне значэння U на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
UMAX
Адлюстраванне максімальнага значэння U, якое змяшчаецца ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
VMIN
Адлюстраванне мінімальнага значэння V, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].
VLOW
Адлюстраванне значэння V на ўзроўні 10% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
VAVG
Адлюстраванне сярэдняга значэння V ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].
VHIGH
Адлюстраванне значэння V на ўзроўні 90% працэнтыля ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-255].
VMAX
Адлюстраванне максімальнага значэння V, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-255].
SATMIN
Адлюстраванне мінімальнага значэння насычанасці, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].
SATLOW
Адлюстраванне значэння насычанасці на ўзроўні 10% працэнтыля ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].
SATAVG
Адлюстраванне сярэдняга значэння насычанасці ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].
SATHIGH
Адлюстраванне значэння насычанасці на ўзроўні 90% працэнтыля ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].
SATMAX
Адлюстраванне максімальнага значэння насычанасці, якое змяшчаецца ва ўваходным кадры. Выражаецца ў дыяпазоне [0-~181,02].
HUEMED
Адлюстраванне сярэдняга значэння адцення ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-360].
HUEAVG
Адлюстраванне сярэдняга значэння адцення ва ўваходным фрэйме. Выражаецца ў дыяпазоне [0-360].
YDIF
Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці Y у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].
UDIF
Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці U у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].
VDIF
Адлюстраванне сярэдняга розніцы значэнняў выбаркі паміж усімі значэннямі плоскасці V у бягучым кадры і адпаведнымі значэннямі папярэдняга ўваходнага кадра. Выражаецца ў дыяпазоне [0-255].
YBITDEPTH
Адлюстраванне бітавай глыбіні плоскасці Y у бягучым кадры. Выражаецца ў дыяпазоне [0-16].
UBITDEPTH
Адлюстраванне бітавай глыбіні плоскасці U ў бягучым кадры. Выражаецца ў дыяпазоне [0-16].
VBITDEPTH
Адлюстраванне бітавай глыбіні плоскасці V у бягучым кадры. Выражаецца ў дыяпазоне [0-16].
Фільтр прымае наступныя параметры:
stat
out
-
stat
указаць дадатковую форму аналізу выявы.out
выводзіць відэа з вылучаным пікселем зададзенага тыпу.Абодва варыянты прымаюць наступныя значэнні:
- '
tout
' Вызначыць
temporal outliers
пікселі. Atemporal outlier
- гэта піксель у адрозненне ад суседніх пікселяў таго ж поля. Прыклады часовых выкідаў ўключаюць вынікі адключэння відэа, закаркаванне галавы або праблемы са стужкай.- '
vrep
' Ідэнтыфікаваць
vertical line repetition
. Паўтарэнне вертыкальнай лініі ўключае аднолькавыя шэрагі пікселяў у кадры. У народжаным лічбавым відэа паўтор вертыкальных радкоў з'яўляецца звычайнай з'явай, але гэты шаблон рэдка сустракаецца ў відэа, алічбаваным з аналагавай крыніцы. Калі гэта адбываецца ў відэа, якое з'яўляецца вынікам алічбоўкі аналагавай крыніцы, гэта можа паказваць на ўтойванне ад кампенсатара выпадзення.- '
brng
' Вызначце пікселі, якія выходзяць за межы дазволенага дыяпазону вяшчання.
- '
color, c
Усталюйце колер вылучэння для
out
варыянт. Колер па змаўчанні жоўты.
11.228.1 Examples
- Выхадныя даныя розных відэаметрык:
ffprobe -f lavfi movie=example.mov,signalstats="stat=tout+vrep+brng" -show_frames
- Вывядзіце канкрэтныя даныя аб мінімальных і максімальных значэннях плоскасці Y на кадр:
ffprobe -f lavfi movie=example.mov,signalstats -show_entries frame_tags=lavfi.signalstats.YMAX,lavfi.signalstats.YMIN
- Прайгравайце відэа, вылучаючы пікселі, якія знаходзяцца за межамі дыяпазону трансляцыі, чырвоным колерам.
ffplay example.mov -vf signalstats="out=brng:color=red"
- Прайграванне відэа з метададзенымі сігналаў, намаляванымі па-над кадрам.
ffplay example.mov -vf signalstats=stat=brng+vrep+tout,drawtext=fontfile=FreeSerif.ttf:textfile=signalstat_drawtext.txt
Змесціва signalstat_drawtext.txt, якое выкарыстоўваецца ў камандзе:
time %{pts:hms} Y (%{metadata:lavfi.signalstats.YMIN}-%{metadata:lavfi.signalstats.YMAX}) U (%{metadata:lavfi.signalstats.UMIN}-%{metadata:lavfi.signalstats.UMAX}) V (%{metadata:lavfi.signalstats.VMIN}-%{metadata:lavfi.signalstats.VMAX}) saturation maximum: %{metadata:lavfi.signalstats.SATMAX}
11.229 signature
Разлічвае відэаподпіс MPEG-7. Фільтр можа апрацоўваць больш чым адзін увод. У гэтым выпадку адпаведнасць паміж уваходамі можа быць вылічана дадаткова. Фільтр заўсёды праходзіць праз першы ўваход. Подпіс кожнага патоку можа быць запісаны ў файл.
Ён прымае наступныя варыянты:
detectmode
Уключыць або выключыць працэс супастаўлення.
Даступныя значэнні:
- '
off
' Адключыць разлік адпаведнасці (па змаўчанні).
- '
full
' Вылічыць адпаведнасць для ўсяго відэа і вывесці, ці супадае ўсё відэа ці толькі яго часткі.
- '
fast
' Вылічвайце толькі да таго часу, пакуль не будзе знойдзена адпаведнасць або пакуль не скончыцца відэа. У некаторых выпадках павінна быць хутчэй.
- '
nb_inputs
Усталюйце колькасць уваходаў. Значэнне параметра павінна быць неадмоўным цэлым лікам. Значэнне па змаўчанні - 1.
filename
Усталюйце шлях, у які запісваецца вывад. Калі ёсць больш чым адзін увод, шлях павінен быць прататыпам, г.зн. павінен утрымліваць %d або %0nd (дзе n - дадатнае цэлае), якія будуць заменены нумарам уводу. Калі імя файла не пазначана, вывад не будзе запісаны. Гэта па змаўчанні.
format
Выберыце фармат вываду.
Даступныя значэнні:
- '
binary
' Выкарыстоўваць указанае двайковае прадстаўленне (па змаўчанні).
- '
xml
' Выкарыстоўвайце азначанае прадстаўленне ў фармаце xml.
- '
th_d
Усталюйце парог для выяўлення аднаго слова як падобнага. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 9000.
th_dc
Усталюйце парог, каб усе словы былі падобныя. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 60000.
th_xh
Усталюйце парог для выяўлення кадраў як падобных. Значэнне опцыі павінна быць цэлым лікам, большым за нуль. Значэнне па змаўчанні - 116.
th_di
Усталюйце мінімальную даўжыню паслядоўнасці ў кадрах, каб распазнаць яе як адпаведную паслядоўнасць. Значэнне параметра павінна быць неадмоўным цэлым лікам. Значэнне па змаўчанні - 0.
th_it
Усталюйце мінімальнае стаўленне, якое павінны мець адпаведныя кадры да ўсіх кадраў. Значэнне параметра павінна быць падвойным значэннем ад 0 да 1. Значэнне па змаўчанні роўна 0,5.
11.229.1 Examples
- Каб вылічыць подпіс уваходнага відэа і захаваць яго ў signature.bin:
ffmpeg -i input.mkv -vf signature=filename=signature.bin -map 0:v -f null -
- Каб вызначыць, ці супадаюць два відэа, і захаваць подпісы ў фармаце XML у signature0.xml і signature1.xml:
ffmpeg -i input1.mkv -i input2.mkv -filter_complex "[0:v][1:v] signature=nb_inputs=2:detectmode=full:format=xml:filename=signature%d.xml" -map :v -f null -
11.230 siti
Разлік балаў прасторавай інфармацыі (SI) і часовай інфармацыі (TI) для відэа, як гэта вызначана ў ITU-T P.910: Суб'ектыўныя метады ацэнкі якасці відэа для мультымедыйных прыкладанняў. Даступны ў фармаце PDF на https://www.itu.int/rec/T-REC-P.910-199909-S/en .
Ён прымае наступны варыянт:
print_summary
Калі ўсталявана 1, зводная статыстыка будзе друкавацца на кансолі. Па змаўчанні 0.
11.230.1 Examples
- Каб разлічыць паказчыкі SI/TI і надрукаваць зводку:
ffmpeg -i input.mp4 -vf siti=print_summary=1 -f null -
11.231 smartblur
Размыць уваходнае відэа, не закранаючы контуры.
Ён прымае наступныя варыянты:
luma_radius, lr
Усталюйце радыус яркасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [0.1,5.0], які вызначае дысперсію фільтра Гаўса, які выкарыстоўваецца для размыцця выявы (павольней, калі больш). Значэнне па змаўчанні 1,0.
luma_strength, ls
Усталюйце інтэнсіўнасць яркасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [-1.0,1.0], які канфігуруе размыццё. Значэнне, уключанае ў [0.0,1.0], прывядзе да размыцця выявы, а значэнне, уключанае ў [-1.0,0.0], павысіць рэзкасць выявы. Значэнне па змаўчанні 1,0.
luma_threshold, lt
Усталюйце парог яркасці, які выкарыстоўваецца ў якасці каэфіцыента, каб вызначыць, ці павінен піксель быць размытым ці не. Значэнне параметра павінна быць цэлым лікам у дыяпазоне [-30,30]. Значэнне 0 будзе фільтраваць увесь відарыс, значэнне, уключанае ў [0,30], будзе фільтраваць плоскія вобласці, а значэнне, уключанае ў [-30,0], будзе фільтраваць краю. Значэнне па змаўчанні 0.
chroma_radius, cr
Усталюйце радыус каляровасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [0.1,5.0], які вызначае дысперсію фільтра Гаўса, які выкарыстоўваецца для размыцця выявы (павольней, калі больш). Значэнне па змаўчанні
luma_radius
.chroma_strength, cs
Усталюйце інтэнсіўнасць каляровасці. Значэнне параметра павінна быць лікам з плаваючай часткай у дыяпазоне [-1.0,1.0], які канфігуруе размыццё. Значэнне, уключанае ў [0.0,1.0], прывядзе да размыцця выявы, а значэнне, уключанае ў [-1.0,0.0], павысіць рэзкасць выявы. Значэнне па змаўчанні
luma_strength
.chroma_threshold, ct
Усталюйце парог каляровасці, які выкарыстоўваецца ў якасці каэфіцыента, каб вызначыць, ці павінен піксель быць размытым ці не. Значэнне параметра павінна быць цэлым лікам у дыяпазоне [-30,30]. Значэнне 0 будзе фільтраваць увесь відарыс, значэнне, уключанае ў [0,30], будзе фільтраваць плоскія вобласці, а значэнне, уключанае ў [-30,0], будзе фільтраваць краю. Значэнне па змаўчанні
luma_threshold
.
Калі параметр каляровасці не зададзены яўна, усталёўваецца адпаведнае значэнне яркасці.
11.232 sobel
Ужыць аператар sobel для ўваходнага відэаструменю.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік.
delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку.
11.232.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.233 spp
Прымяніць просты фільтр постапрацоўкі, які сціскае і распакоўвае малюнак на некалькі (ці - у выпадкуquality
узровень 6
- усе) змены і асерадненне вынікаў.
Фільтр прымае наступныя параметры:
quality
Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 0-6. Калі ўстаноўлена
0
, фільтр не будзе мець ніякага эфекту. Значэнне6
азначае больш высокую якасць. Для кожнага павелічэння гэтага значэння хуткасць падае прыблізна ў 2 разы. Значэнне па змаўчанні -3
.qp
Прымусова ўсталяваць пастаянны параметр квантавання. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).
mode
Усталюйце парогавы рэжым. Даступныя рэжымы:
- '
hard
' Устанавіць цвёрдае парогавае значэнне (па змаўчанні).
- '
soft
' Усталюйце мяккі парог (лепшы эфект выдалення званка, але, верагодна, больш размыты).
- '
use_bframe_qp
Уключыць выкарыстанне QP з B-Frames, калі ўстаноўлена
1
. Выкарыстанне гэтай опцыі можа выклікаць мігценне, паколькі B-рамкі часта маюць большы QP. Па змаўчанні0
(не ўключана).
11.233.1 Commands
Гэты фільтр падтрымлівае наступныя каманды:
quality, level
Усталюйце ўзровень якасці. Значэнне
max
можа быць выкарыстана для ўстаноўкі максімальнага ўзроўню, у цяперашні час6
.
11.234 sr
Павялічце ўваходныя дадзеныя, ужыўшы адзін з метадаў звышраздзялення на аснове згортачных нейронавых сетак. Падтрымліваюцца мадэлі:
- Мадэль сверточной нейроннай сеткі звышраздзялення (SRCNN). Глядзіце https://arxiv.org/abs/1501.00092 .
- Эфектыўная мадэль сверточной нейроннай сеткі субпікселяў (ESPCN). Глядзіце https://arxiv.org/abs/1609.05158 .
Навучальныя скрыпты, а таксама скрыпты для захавання файла мадэлі (.pb) можна знайсці на https://github.com/XueweiMeng/sr/tree/sr_dnn_native . Арыгінальны рэпазітар знаходзіцца на https://github.com/HighVoltageRocknRoll/sr.git .
Файлы ўласнай мадэлі (.model) могуць быць створаны з файлаў мадэлі TensorFlow (.pb) з дапамогай tools/python/convert.py
Фільтр прымае наступныя параметры:
dnn_backend
Укажыце, які бэкэнд DNN выкарыстоўваць для загрузкі і выканання мадэлі. Гэты параметр прымае наступныя значэнні:
- '
native
' Уласная рэалізацыя загрузкі і выканання DNN.
- '
tensorflow
' Бэкэнд TensorFlow. Каб уключыць гэты бэкэнд, вам трэба ўсталяваць бібліятэку TensorFlow для C (гл. https://www.tensorflow.org/install/lang_c ) і наладзіць FFmpeg з
--enable-libtensorflow
Значэнне па змаўчанні '
native
'.- '
model
Задайце шлях да файла мадэлі з указаннем архітэктуры сеткі і яе параметраў. Звярніце ўвагу, што розныя бэкэнды выкарыстоўваюць розныя фарматы файлаў. Бэкэнд TensorFlow можа загружаць файлы для абодвух фарматаў, у той час як уласны бэкэнд можа загружаць файлы толькі для свайго фармату.
scale_factor
Задаць маштабны каэфіцыент для мадэлі SRCNN. Дазволеныя значэнні
2
,3
і4
. Значэнне па змаўчанні -2
. Маштабны каэфіцыент неабходны для мадэлі SRCNN, таму што яна прымае ўваходныя дадзеныя, пашыраныя з выкарыстаннем бікубічнага маштабавання з належным маштабным каэфіцыентам.
Каб атрымаць поўную функцыянальнасць (напрыклад, асінхроннае выкананне), выкарыстоўвайце фільтр dnn_processing .
11.235 ssim
Атрымайце SSIM (метрыка структурнага падабенства) паміж двума ўваходнымі відэа.
Гэты фільтр прымае на ўваход два ўваходныя відэа, першы ўваход лічыцца "асноўнай" крыніцай і без змен перадаецца на выхад. Другі ўваход выкарыстоўваецца ў якасці "эталоннага" відэа для вылічэння SSIM.
Абодва відэаўваходы павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.
Фільтр захоўвае разлічаны SSIM кожнага кадра.
Ніжэй прыводзіцца апісанне прынятых параметраў.
stats_file, f
Калі пазначаны, фільтр будзе выкарыстоўваць названы файл для захавання SSIM кожнага асобнага кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.
Файл, які друкуецца stats_file
, калі абраны, змяшчае паслядоўнасць пар ключ/значэнне ў выглядзе key
: value
для кожнай пары кадраў, якія параўноўваюцца.
Далей апісваецца кожны паказаны параметр:
n
парадкавы нумар уваходнага кадра, пачынаючы з 1
Y, U, V, R, G, B
SSIM параўноўваных кадраў для кампанента, вызначанага суфіксам.
All
SSIM параўноўваных кадраў для ўсяго кадра.
dB
Тое самае, што і вышэй, але ў дБ.
Гэты фільтр таксама падтрымлівае параметры сінхранізацыі кадраў .
11.235.1 Examples
- Напрыклад:
movie=ref_movie.mpg, setpts=PTS-STARTPTS [main]; [main][ref] ssim="stats_file=stats.log" [out]
У гэтым прыкладзе ўваходны файл, які апрацоўваецца, параўноўваецца з эталонным файлам
ref_movie.mpg
. SSIM кожнага асобнага кадра захоўваецца ўstats.log
. - Іншы прыклад адначасова з psnr і ssim:
ffmpeg -i main.mpg -i ref.mpg -lavfi "ssim;[0:v][1:v]psnr" -f null -
- Яшчэ адзін прыклад з рознымі кантэйнерамі:
ffmpeg -i main.mpg -i ref.mkv -lavfi "[0:v]settb=AVTB,setpts=PTS-STARTPTS[main];[1:v]settb=AVTB,setpts=PTS-STARTPTS[ref];[main][ref]ssim" -f null -
11.236 stereo3d
Пераўтварэнне паміж рознымі фарматамі стэрэаскапічных малюнкаў.
Фільтры прымаюць наступныя параметры:
in
Задаць фармат стэрэаскапічнага відарыса для ўводу.
Даступныя значэнні для ўваходных фарматаў выявы:
- '
sbsl
' побач паралельна (левае вока злева, правае вока справа)
- '
sbsr
' бок аб бок крыжавокі (правае вока злева, левае вока справа)
- '
sbs2l
' побач паралельна з дазволам на палову шырыні (левае вока злева, правае вока справа)
- '
sbs2r
' бок аб бок крыж з раздзяленнем у палову шырыні (правае вока злева, левае вока справа)
- '
abl
' - '
tbl
' зверху-знізу (левае вока ўверсе, правае вока ўнізе)
- '
abr
' - '
tbr
' уверсе-ўнізе (правае вока ўверсе, левае вока ўнізе)
- '
ab2l
' - '
tb2l
' уверсе-ўнізе з дазволам на палову вышыні (левае вока ўверсе, правае вока ўнізе)
- '
ab2r
' - '
tb2r
' уверсе-ўнізе з дазволам на палову вышыні (правае вока ўверсе, левае вока ўнізе)
- '
al
' чаргаванне кадраў (спачатку левае вока, другое вока правае)
- '
ar
' чаргаванне кадраў (правае вока першым, левае вока другім)
- '
irl
' перамежаваныя радкі (для левага вока верхні радок, для правага вока пачынаецца наступны радок)
- '
irr
' перамежаваныя радкі (правае вока мае верхні радок, левае вока пачынаецца з наступнага радка)
- '
icl
' перамежаваныя слупкі, левым вокам наперад
- '
icr
' перамежаваныя слупкі, правае вока спачатку
Значэнне па змаўчанні '
sbsl
'.
- '
out
Задаць фармат вываду стэрэаскапічнага відарыса.
- '
sbsl
' побач паралельна (левае вока злева, правае вока справа)
- '
sbsr
' бок аб бок крыжавокі (правае вока злева, левае вока справа)
- '
sbs2l
' побач паралельна з дазволам на палову шырыні (левае вока злева, правае вока справа)
- '
sbs2r
' бок аб бок крыж з раздзяленнем у палову шырыні (правае вока злева, левае вока справа)
- '
abl
' - '
tbl
' зверху-знізу (левае вока ўверсе, правае вока ўнізе)
- '
abr
' - '
tbr
' уверсе-ўнізе (правае вока ўверсе, левае вока ўнізе)
- '
ab2l
' - '
tb2l
' уверсе-ўнізе з дазволам на палову вышыні (левае вока ўверсе, правае вока ўнізе)
- '
ab2r
' - '
tb2r
' уверсе-ўнізе з дазволам на палову вышыні (правае вока ўверсе, левае вока ўнізе)
- '
al
' чаргаванне кадраў (спачатку левае вока, другое вока правае)
- '
ar
' чаргаванне кадраў (правае вока першым, левае вока другім)
- '
irl
' перамежаваныя радкі (для левага вока верхні радок, для правага вока пачынаецца наступны радок)
- '
irr
' перамежаваныя радкі (правае вока мае верхні радок, левае вока пачынаецца з наступнага радка)
- '
arbg
' анагліф чырвоны/сіне-шэры (чырвоны фільтр на левым воку, сіні фільтр на правым воку)
- '
argg
' анагліф чырвоны/зялёны шэры (чырвоны фільтр на левым воку, зялёны фільтр на правым воку)
- '
arcg
' анагліф чырвоны/блакітна-шэры (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)
- '
arch
' анагліф чырвоны/блакітны напаўкаляровы (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)
- '
arcc
' анагліф чырвонага/блакітнага колеру (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)
- '
arcd
' анагліф чырвоны/блакітны колер аптымізаваны з дапамогай найменшых квадратаў праекцыі Дюбуа (чырвоны фільтр на левым воку, блакітны фільтр на правым воку)
- '
agmg
' анагліф зялёны/пурпурны шэры (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)
- '
agmh
' анагліф зялёны/пурпурны напалову (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)
- '
agmc
' анагліф зялёнага/пурпурнога колеру (зялёны фільтр на левым воку, пурпурны фільтр на правым воку)
- '
agmd
' колер анагліфа зялёны/пурпурны, аптымізаваны з дапамогай праекцыі Дзюбуа паводле метаду найменшых квадратаў (зялёны фільтр на левае вока, пурпурны фільтр на правае вока)
- '
aybg
' анагліф жоўты/блакітна-шэры (жоўты фільтр на левым воку, сіні фільтр на правым воку)
- '
aybh
' анагліф жоўты/сіні напаўкаляровы (жоўты фільтр на левым воку, сіні фільтр на правым воку)
- '
aybc
' анагліф жоўта-сіняга колеру (жоўты фільтр на левым воку, сіні фільтр на правым воку)
- '
aybd
' анагліф жоўты / сіні колер, аптымізаваны з дапамогай найменшых квадратаў праекцыі Дюбуа (жоўты фільтр на левым воку, сіні фільтр на правым воку)
- '
ml
' монавыхад (толькі левае вока)
- '
mr
' монавыхад (толькі правае вока)
- '
chl
' шашка, левым вокам наперад
- '
chr
' шахматная дошка, правае вока наперад
- '
icl
' перамежаваныя слупкі, левым вокам наперад
- '
icr
' перамежаваныя слупкі, правае вока спачатку
- '
hdmi
' Пакет кадраў HDMI
Значэнне па змаўчанні '
arcd
'.- '
11.236.1 Examples
- Пераўтварыце ўваходнае відэа з паралельнага анагліфа ў жоўты/блакітны Дюбуа:
stereo3d=sbsl:aybd
- Пераўтварыце ўваходнае відэа зверху ўніз (левае вока ўверсе, правае вока ўнізе) у бок аб бок папярочна.
stereo3d=abl:sbsr
11.237 streamselect, astreamselect
Выберыце відэа ці аўдыяплыні.
Фільтр прымае наступныя параметры:
inputs
Усталюйце колькасць уваходаў. Па змаўчанні 2.
map
Усталюйце ўваходныя індэксы для пераназначэння на выхады.
11.237.1 Commands
Фільтр streamselect
і astreamselect
падтрымлівае наступныя каманды:
map
Усталюйце ўваходныя індэксы для пераназначэння на выхады.
11.237.2 Examples
- Выберыце першыя 5 секунд 1-га патоку і астатні час 2-га патоку:
sendcmd='5.0 streamselect map 1',streamselect=inputs=2:map=0
- Тое самае, што і вышэй, але для аўдыя:
asendcmd='5.0 astreamselect map 1',astreamselect=inputs=2:map=0
11.238 subtitles
Намалюйце субтытры паверх уваходнага відэа з дапамогай бібліятэкі libass.
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-libass
. Гэты фільтр таксама патрабуе зборкі з libavcodec і libavformat для пераўтварэння перададзенага файла субтытраў у фармат субтытраў ASS (Advanced Substation Alpha).
Фільтр прымае наступныя параметры:
filename, f
Усталюйце імя файла субтытраў для чытання. Яго трэба ўдакладніць.
original_size
Пакажыце памер зыходнага відэа, відэа, для якога быў складзены файл ASS. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . З-за няправільнай распрацоўкі арыфметыкі суадносін бакоў ASS гэта неабходна для правільнага маштабавання шрыфтоў, калі суадносіны бакоў былі зменены.
fontsdir
Усталюйце шлях да каталога, які змяшчае шрыфты, якія могуць выкарыстоўвацца фільтрам. Гэтыя шрыфты будуць выкарыстоўвацца ў дадатак да таго, што выкарыстоўвае пастаўшчык шрыфтоў.
alpha
Апрацаваць альфа-канал, па змаўчанні альфа-канал не закрануты.
charenc
Усталюйце кадоўку сімвалаў уводу субтытраў.
subtitles
толькі фільтр. Карысна, толькі калі не UTF-8.stream_index, si
Усталяваць індэкс патоку субтытраў.
subtitles
толькі фільтр.force_style
Перавызначыць параметры субтытраў па змаўчанні ў стылі ці сцэнары. Ён прымае радок, які змяшчае
KEY=VALUE
пары фарматаў у стылі ASS, падзеленыя знакамі ",".
Калі першы ключ не ўказаны, мяркуецца, што першае значэнне вызначаеfilename
.
Напрыклад, для адлюстравання файлаsub.srt
паверх уваходнага відэа выкарыстоўвайце каманду:
subtitles=sub.srt
што эквівалентна:
subtitles=filename=sub.srt
Для адлюстравання патоку субтытраў па змаўчанні з файлаvideo.mkv
, выкарыстоўваць:
subtitles=video.mkv
Каб зрабіць другі паток субтытраў з гэтага файла, выкарыстоўвайце:
subtitles=video.mkv:si=1
Каб трансляваць субтытрыsub.srt
выглядаць у 80% празрыста-блакітным колеры
DejaVu Serif
, выкарыстоўвайце:
subtitles=sub.srt:force_style='Fontname=DejaVu Serif,PrimaryColour=&HCCFF0000'
11.239 super2xsai
Павялічце ўвод у 2 разы і згладзьце з дапамогай алгарытму маштабавання піксельнага мастацтва Super2xSaI (Scale and Interpolate).
Карысна для павелічэння піксельных малюнкаў без памяншэння рэзкасці.
11.240 swaprect
Памяняйце месцамі два прамавугольныя аб'екты ў відэа.
Гэты фільтр прымае наступныя параметры:
w
Задаць шырыню аб'екта.
h
Задайце вышыню аб'екта.
x1
Усталюйце 1-ю каардынату прамастая х.
y1
Задайце 1-ю каардынату прамавуха.
x2
Усталюйце 2-ю каардынату прамастая х.
y2
Задайце 2-ю каардынату прамавуха.
Усе выразы вылічваюцца адзін раз для кожнага кадра.
Усе параметры - гэта выразы, якія змяшчаюць наступныя канстанты:
w
h
Шырыня і вышыня ўводу.
a
тое самае, што
w
/h
sar
суадносіны бакоў узору ўводу
dar
суадносіны бакоў уваходнага дысплея, яно такое ж, як (
w
/h
) *sar
n
Нумар уваходнага кадра, пачынаючы з 0.
t
Метка часу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.
pos
пазіцыя ў файле ўваходнага кадра, NAN, калі невядома
11.240.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.241 swapuv
Памяняйце месцамі самалёты U і V.
11.242 tblend
Змяшайце паслядоўныя відэакадры.
Глядзі сумесь
11.243 telecine
Прымяніць працэс тэлекіно да відэа.
Гэты фільтр прымае наступныя параметры:
first_field
- '
top, t
' спачатку верхняе поле
- '
bottom, b
' ніжняе поле спачатку Значэнне па змаўчанні -
top
.
- '
pattern
Лічбавы радок, які прадстаўляе шаблон выпадальнага меню, які вы хочаце прымяніць. Значэнне па змаўчанні -
23
.
Some typical patterns:
NTSC output (30i):
27.5p: 32222
24p: 23 (classic)
24p: 2332 (preferred)
20p: 33
18p: 334
16p: 3444
PAL output (25i):
27.5p: 12222
24p: 222222222223 ("Euro pulldown")
16.67p: 33
16p: 33333334
11.244 thistogram
Вылічыце і намалюйце гістаграму размеркавання колеру для ўваходнага відэа ў часе.
У адрозненне ад відэафільтра гістаграмы , які паказвае гістаграму толькі аднаго ўваходнага кадра ў пэўны час, гэты фільтр паказвае таксама мінулыя гістаграмы колькасці кадраў, вызначаных width
опцыяй.
Вылічаная гістаграма - гэта адлюстраванне размеркавання кампанентаў колеру на малюнку.
Фільтр прымае наступныя параметры:
width, w
Задаць шырыню вываду аднакаляровага кампанента. Значэнне па змаўчанні -
0
. Значэнне0
сярэдняй шырыні будзе выбірацца з уваходнага відэа. Гэта таксама задае колькасць пройдзеных гістаграм, якія трэба захаваць. Дазволены дыяпазон [0, 8192].display_mode, d
Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:
- '
stack
' Графікі кампанентаў колеру размешчаны адзін пад адным.
- '
parade
' Графікі кампанентаў колеру размешчаны побач.
- '
overlay
' Прадстаўляе інфармацыю, ідэнтычную той, што ў
parade
, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.
Па змаўчанні
stack
.- '
levels_mode, m
Усталяваць рэжым. Можа быць або
linear
, абоlogarithmic
. Па змаўчанніlinear
.components, c
Усталюйце кампаненты колеру для адлюстравання. Па змаўчанні
7
.bgopacity, b
Задаць непразрыстасць фону. Па змаўчанні
0.9
.envelope, e
Паказаць канверт. Па змаўчанні адключана.
ecolor, ec
Задаць колер канверта. Па змаўчанні
gold
.slide
Усталяваць рэжым слайдаў.
Даступныя значэнні для слайда:
- '
frame
' Намалюйце новую рамку, калі будзе дасягнута правая мяжа.
- '
replace
' Замяніць старыя слупкі на новыя.
- '
scroll
' Пракрутка справа налева.
- '
rscroll
' Пракруціць злева направа.
- '
picture
' Намалюйце адну карцінку.
Па змаўчанні
replace
.- '
11.245 threshold
Прымяніць парогавы эфект да відэаструменю.
Для выканання парогавага значэння гэтаму фільтру патрэбны чатыры відэапатокі. Першы паток - гэта паток, які мы фільтруем. Другі паток утрымлівае парогавыя значэнні, трэці паток утрымлівае мінімальныя значэнні, а апошні, чацвёрты паток утрымлівае максімальныя значэнні.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
Напрыклад, калі значэнне кампанента пікселя першага патоку меншае за парогавае значэнне кампанента пікселя з 2-га парогавага патоку, будзе выбрана значэнне трэцяга патоку, у адваротным выпадку будзе выбрана значэнне кампанента пікселя чацвёртага патоку.
Выкарыстоўваючы фільтр крыніцы колеру, можна выконваць розныя тыпы парогаў:
11.245.1 Commands
Гэты фільтр падтрымлівае ўсе параметры ў якасці каманд .
11.245.2 Examples
- Двайковы парог з выкарыстаннем шэрага колеру ў якасці парога:
ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=black -f lavfi -i color=white -lavfi threshold output.avi
- Перавернуты двайковы парог з выкарыстаннем шэрага колеру ў якасці парога:
ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=white -f lavfi -i color=black -lavfi threshold output.avi
- Скароціце двайковы парог, выкарыстоўваючы шэры колер у якасці парога:
ffmpeg -i 320x240.avi -f lavfi -i color=gray -i 320x240.avi -f lavfi -i color=gray -lavfi threshold output.avi
- Парог да нуля, з выкарыстаннем шэрага колеру ў якасці парога:
ffmpeg -i 320x240.avi -f lavfi -i color=gray -f lavfi -i color=white -i 320x240.avi -lavfi threshold output.avi
- Інвертаваны парог да нуля, выкарыстанне шэрага колеру ў якасці парога:
ffmpeg -i 320x240.avi -f lavfi -i color=gray -i 320x240.avi -f lavfi -i color=white -lavfi threshold output.avi
11.246 thumbnail
Выберыце найбольш рэпрэзентатыўны кадр у дадзенай паслядоўнасці паслядоўных кадраў.
Фільтр прымае наступныя параметры:
n
Усталюйце памер пакета кадраў для аналізу; у наборы
n
кадраў фільтр выбярэ адзін з іх, а затым апрацуе наступную партыюn
кадраў да канца. Па змаўчанні100
.
Паколькі фільтр адсочвае ўсю паслядоўнасць кадраў, большае n
значэнне прывядзе да большага выкарыстання памяці, таму высокае значэнне не рэкамендуецца.
11.246.1 Examples
- Вылучыце адну фатаграфію на кожныя 50 кадраў:
thumbnail=50
- Поўны прыклад стварэння эскіза з дапамогай
ffmpeg
:ffmpeg -i in.avi -vf thumbnail,scale=300:200 -frames:v 1 out.png
11.247 tile
Злучыце некалькі паслядоўных кадраў.
Фільтр untle можа зрабіць адваротнае.
Фільтр прымае наступныя параметры:
layout
Усталюйце памер сеткі ў форме
COLUMNSxROWS
. Дыяпазон да UINT_MAX ячэек. Па змаўчанні6x5
.nb_frames
Усталюйце максімальную колькасць кадраў для адлюстравання ў дадзенай вобласці. Яно павінна быць меншым або роўным
w
xh
. Значэнне па змаўчанні - гэта0
азначае, што будзе выкарыстоўвацца ўся вобласць.margin
Усталюйце вонкавае поле мяжы ў пікселях. Дыяпазон ад 0 да 1024. Па змаўчанні -
0
.padding
Усталюйце таўшчыню ўнутранай мяжы (г.зн. колькасць пікселяў паміж кадрамі). Каб атрымаць больш пашыраныя параметры запаўнення (напрыклад, розныя значэнні для краёў), звярніцеся да відэафільтра пракладкі. Дыяпазон ад 0 да 1024. Па змаўчанні -
0
.color
Пакажыце колер невыкарыстоўваемай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні
color
- "чорны".overlap
Усталюйце колькасць кадраў, якія будуць перакрывацца пры аб'яднанні некалькіх паслядоўных кадраў. Значэнне павінна быць паміж
0
іnb_frames - 1
. Па змаўчанні0
.init_padding
Усталюйце пустую колькасць кадраў перад адлюстраваннем першага выходнага кадра. Гэта кантралюе, як хутка атрымаецца першы выходны кадр. Значэнне павінна быць паміж
0
іnb_frames - 1
. Па змаўчанні0
.
11.247.1 Examples
- Стварайце пліткі PNG для ўсіх ключавых кадраў 8x8 (
-skip_frame nokey
) у фільме:ffmpeg -skip_frame nokey -i file.avi -vf 'scale=128:72,tile=8x8' -an -vsync 0 keyframes%03d.png
The
-vsync 0
неабходна прадухіліцьffmpeg
дубліравання кожнага выхаднога кадра для размяшчэння першапачаткова выяўленай частаты кадраў. - Паказваць
5
малюнкі ў вобласці3x2
кадраў з7
пікселямі паміж імі і2
пікселямі пачатковага поля, выкарыстоўваючы змешаныя плоскія і названыя параметры:tile=3x2:nb_frames=5:padding=7:margin=2
11.248 tinterlace
Выканайце розныя віды перапляцення скроневых палёў.
Кадры лічацца, пачынаючы з 1, таму першы ўваходны кадр лічыцца няцотным.
Фільтр прымае наступныя параметры:
mode
Укажыце рэжым перапляцення. Гэтую опцыю таксама можна ўказаць як значэнне. Спіс значэнняў для гэтай опцыі глядзіце ніжэй.
Даступныя значэнні:
- '
merge, 0
' Перамясціць няцотныя кадры ў верхняе поле, цотныя ў ніжняе поле, ствараючы кадр падвойнай вышыні з паловай частатой кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 11111 33333 22222 44444 11111 33333 22222 44444 11111 33333 22222 44444 11111 33333 22222 44444
- '
drop_even, 1
' Выводзяць толькі няцотныя кадры, цотныя кадры выдаляюцца, ствараючы кадр з нязменнай вышынёй з паловай частаты кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 11111 33333 11111 33333 11111 33333 11111 33333
- '
drop_odd, 2
' Выводзяць толькі цотныя кадры, няцотныя кадры выдаляюцца, ствараючы кадр з нязменнай вышынёй з паловай частаты кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 22222 44444 22222 44444 22222 44444 22222 44444
- '
pad, 3
' Разгарніце кожны кадр на поўную вышыню, але чаргайце лініі чорным колерам, ствараючы кадр з падвойнай вышынёй пры той жа частаце ўваходных кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 11111 ..... 33333 ..... ..... 22222 ..... 44444 11111 ..... 33333 ..... ..... 22222 ..... 44444 11111 ..... 33333 ..... ..... 22222 ..... 44444 11111 ..... 33333 ..... ..... 22222 ..... 44444
- '
interleave_top, 4
' Перамяжоўвайце верхняе поле з няцотных кадраў з ніжнім полем з цотных кадраў, ствараючы кадр з нязменнай вышынёй з палавінай частаты кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111<- 22222 33333<- 44444 11111 22222<- 33333 44444<- 11111<- 22222 33333<- 44444 11111 22222<- 33333 44444<- Output: 11111 33333 22222 44444 11111 33333 22222 44444
- '
interleave_bottom, 5
' Перамяжоўвайце ніжняе поле з няцотных кадраў з верхнім полем з цотных кадраў, ствараючы кадр з нязменнай вышынёй з палавінай частаты кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222<- 33333 44444<- 11111<- 22222 33333<- 44444 11111 22222<- 33333 44444<- 11111<- 22222 33333<- 44444 Output: 22222 44444 11111 33333 22222 44444 11111 33333
- '
interlacex2, 6
' Падвоеная частата кадраў пры нязменнай вышыні. Устаўляюцца кадры, кожны з якіх змяшчае другое часовае поле з папярэдняга ўваходнага кадра і першае часовае поле з наступнага ўваходнага кадра. Гэты рэжым абапіраецца на сцяг top_field_first. Карысна для дысплеяў празрадковай разгорткі без сінхранізацыі палёў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 11111 22222 22222 33333 33333 44444 44444 11111 11111 22222 22222 33333 33333 44444 11111 22222 22222 33333 33333 44444 44444 11111 11111 22222 22222 33333 33333 44444
- '
mergex2, 7
' Перамясціць няцотныя кадры ў верхняе поле, цотныя ў ніжняе поле, ствараючы кадр падвойнай вышыні з той жа частатой кадраў.
------> time Input: Frame 1 Frame 2 Frame 3 Frame 4 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 11111 22222 33333 44444 Output: 11111 33333 33333 55555 22222 22222 44444 44444 11111 33333 33333 55555 22222 22222 44444 44444 11111 33333 33333 55555 22222 22222 44444 44444 11111 33333 33333 55555 22222 22222 44444 44444
Лікавыя значэнні састарэлі, але прымаюцца з меркаванняў зваротнай сумяшчальнасці.
Рэжым па змаўчанні -
merge
.- '
flags
Укажыце сцягі, якія ўплываюць на працэс фільтрацыі.
Даступнае значэнне для
flags
:low_pass_filter, vlpf
Уключыце ў фільтры лінейную вертыкальную фільтрацыю нізкіх частот. Вертыкальная фільтрацыя нізкіх частот патрабуецца пры стварэнні празрадковага пункта прызначэння з прагрэсіўнай крыніцы, якая змяшчае высокачашчынныя вертыкальныя дэталі. Фільтрацыя зменшыць празрадковы "шчабятанне" і муар.
complex_filter, cvlpf
Уключыце складаную вертыкальную фільтрацыю нізкіх частот. Гэта крыху менш зменшыць празрадковы "шчабятанне" і муар, але лепш захавае дэталі і суб'ектыўную выразнасць.
bypass_il
Абыходзьце ўжо празрадковыя кадры, адрэгулюйце толькі частату кадраў.
Вертыкальную фільтрацыю нізкіх частот і абыход ужо празрадковай разгорткі можна ўключыць толькі для
mode
interleave_top
іinterleave_bottom
.
11.249 tmedian
Выберыце сярэднія пікселі з некалькіх паслядоўных уваходных відэакадраў.
Фільтр прымае наступныя параметры:
radius
Задаць радыус сярэдняга фільтра. Па змаўчанні 1. Дазволены дыяпазон ад 1 да 127.
planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
15
, паводле якога апрацоўваюцца ўсе плоскасці.percentile
Задаць сярэдні працэнт. Значэнне па змаўчанні -
0.5
. Значэнне па змаўчанні0.5
заўсёды будзе выбіраць сярэднія значэнні, а0
мінімальныя значэнні і1
максімальныя.
11.249.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд , за выключэннем опцыі radius
.
11.250 tmidequalizer
Прымяненне эфекту Temporal Midway Video Equalization.
Midway Video Equalization наладжвае паслядоўнасць відэакадраў, каб мець аднолькавыя гістаграмы, захоўваючы пры гэтым іх дынаміку, наколькі гэта магчыма. Гэта карысна, напрыклад, для супастаўлення экспазіцыі з паслядоўнасці відэакадраў.
Гэты фільтр прымае наступныя параметры:
radius
Усталюйце радыус фільтрацыі. Па змаўчанні
5
. Дазволены дыяпазон ад 1 да 127.sigma
Усталюйце сігму фільтрацыі. Па змаўчанні
0.5
. Гэта кантралюе сілу фільтрацыі. Усталяванне гэтага параметра ў 0 фактычна нічога не дае.planes
Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні -
15
усе даступныя самалёты.
11.251 tmix
Змяшайце паслядоўныя відэакадры.
Далей апісваюцца прынятыя варыянты.
frames
Колькасць паслядоўных кадраў для змешвання. Калі не пазначана, па змаўчанні 3.
weights
Укажыце вагу кожнага ўваходнага відэакадра. Кожная вага аддзяляецца прабелам. Калі колькасць вагаў меншая за колькасць
frames
апошняй вызначанай вагі, будзе выкарыстоўвацца для ўсіх астатніх неўсталяваных вагаў.scale
Укажыце маштаб, калі ён усталяваны, ён будзе памножаны на суму кожнай вагі, памножанай на значэнні пікселяў, каб атрымаць канчатковае значэнне пікселя прызначэння. Па змаўчанні
scale
аўтаматычна маштабуецца да сумы вагаў.planes
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні ўсё. Дазволены дыяпазон ад 0 да 15.
11.251.1 Examples
- У сярэднім 7 паслядоўных кадраў:
tmix=frames=7:weights="1 1 1 1 1 1 1"
- Прымяніць простую часовую згортку:
tmix=frames=3:weights="-1 3 -1"
- Падобна вышэй, але паказвае толькі часовыя адрозненні:
tmix=frames=3:weights="-1 2 -1":scale=1
11.251.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
weights
scale
planes
Сінтаксіс той жа, што і варыянт з такой жа назвай.
11.252 tonemap
Колеры танальнай карты з розных дынамічных дыяпазонаў.
Гэты фільтр чакае даныя ў адзінарнай дакладнасці з плаваючай кропкай, таму што ён павінен працаваць са значэннямі (і можа выводзіць) па-за дыяпазонам. Іншы фільтр, напрыклад, zscale , неабходны для пераўтварэння атрыманага кадра ў фармат, прыдатны для выкарыстання.
Рэалізаваныя алгарытмы адлюстравання тонаў працуюць толькі на лінейным святле, таму ўваходныя даныя павінны быць папярэдне лінеарызаваны (і, магчыма, правільна пазначаны).
ffmpeg -i INPUT -vf zscale=transfer=linear,tonemap=clip,zscale=transfer=bt709,format=yuv420p OUTPUT
11.252.1 Options
Фільтр прымае наступныя параметры.
tonemap
Усталюйце алгарытм танальнай карты для выкарыстання.
Магчымыя значэнні:
none
Не прымяняйце карту тонаў, толькі абясцэньвайце яркія пікселі.
clip
Жорсткае адсячэнне значэнняў, якія выходзяць за межы дыяпазону. Выкарыстоўвайце яго для ідэальнай дакладнасці колеру для значэнняў у дыяпазоне, адначасова скажаючы значэнні па-за дыяпазонам.
linear
Расцягнуць усю эталонную гаму да лінейнага кратнага дысплею.
gamma
Падбярыце лагарыфмічны перанос паміж крывымі тону.
reinhard
Захавайце агульную яркасць выявы з дапамогай простай крывой, выкарыстоўваючы нелінейны кантраст, што прыводзіць да згладжвання дэталяў і пагаршэння дакладнасці колеру.
hable
Захавайце як цёмныя, так і яркія дэталі лепш, чым
reinhard
, за кошт таго, каб усё крыху зацямніць. Выкарыстоўвайце яго, калі захаванне дэталяў больш важна, чым дакладнасць колеру і яркасці.mobius
Плаўна адлюстроўвайце значэнні па-за дыяпазонам, захоўваючы пры гэтым кантраснасць і колеры для матэрыялу ў дыяпазоне, наколькі гэта магчыма. Выкарыстоўвайце яго, калі дакладнасць колеру больш важная, чым захаванне дэталяў.
Па змаўчанні няма.
param
Наладзьце алгарытм танальнага адлюстравання.
Гэта ўплывае на наступныя алгарытмы:
none
Ігнаруецца.
linear
Вызначае маштабны каэфіцыент для выкарыстання падчас расцягвання. Па змаўчанні 1.0.
gamma
Задае паказчык функцыі. Па змаўчанні 1.8.
clip
Укажыце дадатковы лінейны каэфіцыент для множання сігналу перад адсячэннем. Па змаўчанні 1.0.
reinhard
Укажыце мясцовы каэфіцыент кантраснасці на піку дысплея. Па змаўчанні значэнне 0,5, што азначае, што значэнні ўнутранай гамы будуць прыкладна ўдвая менш яркімі, чым пры выразанні.
hable
Ігнаруецца.
mobius
Укажыце кропку пераходу ад лінейнага да пераўтварэння Мёбіуса. Кожнае значэнне ніжэй за гэты пункт гарантавана адлюстроўваецца 1:1. Чым вышэй значэнне, тым больш дакладным будзе вынік за кошт страты яркіх дэталяў. Па змаўчанні 0,3, які з-за крутога пачатковага нахілу па-ранейшаму даволі дакладна захоўвае колеры ў дыяпазоне.
desat
Ужывайце дэсатурацыю для блікаў, якія перавышаюць гэты ўзровень яркасці. Чым вышэй параметр, тым больш інфармацыі аб колеры будзе захавана. Гэта налада дапамагае прадухіліць ненатуральна цьмяныя колеры для суперблікаў, замест гэтага (плаўна) ператвараючыся ў белыя. Гэта робіць выявы больш натуральнымі, за кошт памяншэння інфармацыі аб колерах, якія не ўваходзяць у дыяпазон.
Значэнне па змаўчанні 2.0 з'яўляецца некалькі кансерватыўным і ў асноўным будзе прымяняцца толькі да неба або паверхняў, асветленых прамым сонцам. Параметр 0.0 адключае гэты параметр.
Гэты параметр працуе, толькі калі ўваходны фрэйм ​​мае падтрымліваемую каляровую тэгу.
peak
Перавызначыць сігнал/намінальны/эталонны пік гэтым значэннем. Карысна, калі ўбудаваная пікавая інфармацыя ў метададзеныя дысплея ненадзейная або калі танальнае адлюстраванне з ніжняга дыяпазону на больш высокі.
11.253 tpad
Часова змясціць відэакадры.
Фільтр прымае наступныя параметры:
start
Укажыце колькасць кадраў затрымкі перад уваходным відэаструменем. Па змаўчанні 0.
stop
Укажыце колькасць кадраў запаўнення пасля ўваходнага відэаструменю. Усталюйце -1, каб пракладваць бясконца. Па змаўчанні 0.
start_mode
Усталюйце тып кадраў, якія дадаюцца ў пачатак патоку. Можа быць або
add
абоclone
. Дадаюццаadd
рамкі суцэльнага колеру. Зclone
кадрамі - клоны першага кадра. Па змаўчанніadd
.stop_mode
Усталюйце тып кадраў, якія дадаюцца ў канец патоку. Можа быць або
add
абоclone
. Дадаюццаadd
рамкі суцэльнага колеру. Зclone
кадрамі - клоны апошняга кадра. Па змаўчанніadd
.start_duration, stop_duration
Укажыце працягласць затрымкі запуску/выключэння. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) . Гэтыя параметры перавызначаюць
start
іstop
. Па змаўчанні 0.color
Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
Значэнне па змаўчанні
color
- "чорны".
11.254 transpose
Транспанаваць радкі са слупкамі ва ўваходным відэа і пры жаданні перавярнуць яго.
Ён прымае наступныя параметры:
dir
Укажыце напрамак транспазіцыі.
Можа прымаць наступныя значэнні:
- '
0, 4, cclock_flip
' Паварот на 90 градусаў супраць гадзіннікавай стрэлкі і вертыкальны пераварот (па змаўчанні), гэта значыць:
L.R L.l . . -> . . l.r R.r
- '
1, 5, clock
' Паварот на 90 градусаў па гадзіннікавай стрэлцы, гэта значыць:
L.R l.L . . -> . . l.r r.R
- '
2, 6, cclock
' Паварот на 90 градусаў супраць гадзінны стрэлкі, гэта значыць:
L.R R.r . . -> . . l.r L.l
- '
3, 7, clock_flip
' Паварот на 90 градусаў па гадзіннікавай стрэлцы і вертыкальны пераварот, гэта значыць:
L.R r.R . . -> . . l.r l.L
Для значэнняў паміж 4-7 транспазіцыя выконваецца толькі ў тым выпадку, калі геаметрыя ўваходнага відэа з'яўляецца партрэтнай, а не альбомнай. Гэтыя значэнні састарэлі,
passthrough
замест іх трэба выкарыстоўваць опцыю.Лікавыя значэнні састарэлі, і ад іх трэба адмовіцца на карысць сімвалічных канстант.
- '
passthrough
Не прымяняйце транспазіцыю, калі ўваходная геаметрыя супадае з той, якая вызначана ўказаным значэннем. Ён прымае наступныя значэнні:
- '
none
' Заўсёды ўжывайце транспазіцыю.
- '
portrait
' Захоўваць партрэтную геаметрыю (калі
height
>=width
).- '
landscape
' Захаваць ландшафтную геаметрыю (калі
width
>=height
).
Значэнне па змаўчанні -
none
.- '
Напрыклад, каб павярнуць на 90 градусаў па гадзіннікавай стрэлцы і захаваць партрэтны макет:
transpose=dir=1:passthrough=portrait
Прыведзеная вышэй каманда таксама можа быць вызначана як:
transpose=1:portrait
11.255 transpose_npp
Транспанаваць радкі са слупкамі ва ўваходным відэа і пры жаданні перавярнуць яго. Для атрымання больш падрабязных прыкладаў глядзіце відэафільтр транспанавання , які мае ў асноўным тыя ж параметры.
Ён прымае наступныя параметры:
dir
Укажыце напрамак транспазіцыі.
Можа прымаць наступныя значэнні:
- '
cclock_flip
' Павярніце на 90 градусаў супраць гадзіннікавай стрэлкі і перавярніце вертыкальна. (па змаўчанні)
- '
clock
' Паварот на 90 градусаў па гадзіннікавай стрэлцы.
- '
cclock
' Павярніце на 90 градусаў супраць гадзінны стрэлкі.
- '
clock_flip
' Павярніце на 90 градусаў па гадзіннікавай стрэлцы і перавярніце вертыкальна.
- '
passthrough
Не прымяняйце транспазіцыю, калі ўваходная геаметрыя супадае з той, якая вызначана ўказаным значэннем. Ён прымае наступныя значэнні:
- '
none
' Заўсёды ўжывайце транспазіцыю. (па змаўчанні)
- '
portrait
' Захоўваць партрэтную геаметрыю (калі
height
>=width
).- '
landscape
' Захаваць ландшафтную геаметрыю (калі
width
>=height
).
- '
11.256 trim
Абрэжце ўваход так, каб выхад утрымліваў адну суцэльную падчастку ўваходу.
Ён прымае наступныя параметры:
start
Пакажыце час пачатку захаванага раздзела, г.зн. кадр з пазнакай часу
start
будзе першым кадрам у вывадзе.end
Укажыце час першага кадра, які будзе выдалены, гэта значыць кадр, які непасрэдна папярэднічае кадру з пазнакай часу
end
, будзе апошнім кадрам у вывадзе.start_pts
Гэта тое ж самае, што і
start
, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу пачатку ў адзінках базы часу, а не ў секундах.end_pts
Гэта тое ж самае, што і
end
, за выключэннем таго, што гэты параметр усталёўвае пазнаку часу ў часавых адзінках замест секунд.duration
Максімальная працягласць вываду ў секундах.
start_frame
Нумар першага кадра, які трэба перадаць на выхад.
end_frame
Нумар першага кадра, які павінен быць адкінуты.
start
,end
, іduration
выражаюцца як характарыстыкі працягласці часу; гл.
(ffmpeg-utils) раздзел Працягласць часу ў кіраўніцтве ffmpeg-utils(1) , каб даведацца
пра прыняты сінтаксіс.
Звярніце ўвагу, што першыя два наборы параметраў пачатку/канца іduration
Варыянт глядзіць на пазнаку часу кадра, у той час як варыянты _frame проста падлічваюць кадры, якія праходзяць праз фільтр. Таксама звярніце ўвагу, што гэты фільтр не змяняе часовыя пазнакі. Калі вы хочаце, каб пазнакі часу вываду пачыналіся з нуля, устаўце фільтр setpts пасля фільтра абрэзкі.
Калі ўстаноўлена некалькі параметраў пачатку або канца, гэты фільтр спрабуе быць прагным і захаваць усе кадры, якія адпавядаюць хаця б аднаму з указаных абмежаванняў. Каб захаваць толькі тую частку, якая адначасова адпавядае ўсім абмежаванням, звяжыце некалькі фільтраў падрэзкі.
Значэнні па змаўчанні такія, што ўвесь увод захоўваецца. Такім чынам, можна ўсталяваць, напрыклад, толькі канчатковыя значэнні, каб захаваць усё да вызначанага часу.
Прыклады:
- Адкіньце ўсё, акрамя другой хвіліны ўводу:
ffmpeg -i INPUT -vf trim=60:120
- Захоўвайце толькі першую секунду:
ffmpeg -i INPUT -vf trim=duration=1
11.257 unpremultiply
Прымяненне эфекту альфа-непамнажэння да ўваходнага відэапатоку з выкарыстаннем першай плоскасці другога патоку ў якасці альфа-канала.
Абодва патокі павінны мець аднолькавыя памеры і аднолькавы фармат пікселяў.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці будуць апрацаваны, неапрацаваныя плоскасці будуць скапіяваны. Па змаўчанні значэнне 0xf, усе плоскасці будуць апрацаваны.
Калі фармат мае 1 ці 2 кампаненты, то яркасць мае біт 0. Калі фармат мае 3 ці 4 кампаненты: для фарматаў RGB біт 0 зялёны, біт 1 сіні і біт 2 чырвоны; для фарматаў YUV біт 0 - яркасць, біт 1 - каляровасць-U, а біт 2 - каляровасць-V. Пры наяўнасці альфа-канал заўсёды апошні біт.
inplace
Не патрабуецца другі ўвод для апрацоўкі, замест гэтага выкарыстоўвайце альфа-плоскасць з уваходнага патоку.
11.258 unsharp
Павышэнне рэзкасці або размыццё ўваходнага відэа.
Ён прымае наступныя параметры:
luma_msize_x, lx
Усталюйце гарызантальны памер матрыцы яркасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
luma_msize_y, ly
Усталюйце вертыкальны памер матрыцы яркасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
luma_amount, la
Усталюйце сілу эфекту яркасці. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.
Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.
Значэнне па змаўчанні 1,0.
chroma_msize_x, cx
Усталюйце гарызантальны памер матрыцы каляровасці. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
chroma_msize_y, cy
Усталюйце вертыкальны памер каляровай матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
chroma_amount, ca
Усталюйце сілу каляровага эфекту. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.
Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.
Значэнне па змаўчанні 0,0.
alpha_msize_x, ax
Усталюйце гарызантальны памер альфа-матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
alpha_msize_y, ay
Усталюйце вертыкальны памер альфа-матрыцы. Яно павінна быць няцотным цэлым лікам ад 3 да 23. Значэнне па змаўчанні роўна 5.
alpha_amount, aa
Усталюйце сілу альфа-эфекту. Гэта павінна быць лік з плаваючай коскай, разумныя значэнні ляжаць ад -1,5 да 1,5.
Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.
Значэнне па змаўчанні 0,0.
Усе параметры неабавязковыя і па змаўчанні адносяцца да радка "5:5:1.0:5:5:0.0".
11.258.1 Examples
- Ужыць моцны эфект павышэння яркасці:
unsharp=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5
- Прымяніце моцнае размыццё параметраў яркасці і каляровасці:
unsharp=7:7:-2:7:7:-2
11.259 untile
Раздзяліце відэа, складзенае з пліткавых малюнкаў, на асобныя выявы.
Частата кадраў выхаднога відэа - гэта частата кадраў уваходнага відэа, памножаная на колькасць плітак.
Гэты фільтр выконвае дзеянні, адваротныя плітцы .
Фільтр прымае наступныя параметры:
layout
Усталюйце памер сеткі (г.зн. колькасць радкоў і слупкоў). Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
11.259.1 Examples
- Стварыце 1-секунднае відэа з файла нерухомай выявы, які складаецца з 25 кадраў, размешчаных вертыкальна, як аналагавая кінастужка:
ffmpeg -r 1 -i image.jpg -vf untile=1x25 movie.mkv
11.260 uspp
Ужывайце звышпавольны/просты фільтр постапрацоўкі, які сціскае і распакоўвае малюнак на некалькі (або - у выпадкуquality
узровень 8
- усе) змены і асерадненне вынікаў.
Адрозненне гэтага ад паводзін spp заключаецца ў тым, што uspp фактычна кадуе і дэкадуе кожны выпадак з дапамогай libavcodec Snow, у той час як spp выкарыстоўвае спрошчаны DCT толькі 8x8, падобны на MJPEG.
Гэты фільтр даступны толькі ў ffmpeg версіі 4.4 або больш ранняй.
Фільтр прымае наступныя параметры:
quality
Ўсталяваць якасць. Гэты параметр вызначае колькасць узроўняў для асераднення. Ён прымае цэлы лік у дыяпазоне 0-8. Калі ўстаноўлена
0
, фільтр не будзе мець ніякага эфекту. Значэнне8
азначае больш высокую якасць. Для кожнага павелічэння гэтага значэння хуткасць падае прыблізна ў 2 разы. Значэнне па змаўчанні -3
.qp
Прымусова ўсталяваць пастаянны параметр квантавання. Калі не ўстаноўлена, фільтр будзе выкарыстоўваць QP з відэаплыні (калі ёсць).
11.261 v360
Пераўтварэнне 360 відэа ў розныя фарматы.
Фільтр прымае наступныя параметры:
input
output
Устанавіць фармат відэаўваходу/вываду.
Даступныя фарматы:
- '
e
' - '
equirect
' Раўнапрамавугольнае праецыраванне.
- '
c3x2
' - '
c6x1
' - '
c1x6
' Кубічная карта з макетам 3x2/6x1/1x6.
Спецыфічныя параметры фармату:
in_pad
out_pad
Усталюйце прапорцыю запаўнення для кубічнай карты ўводу/вываду. Значэнні ў дзесятковых знаках.
Прыклады значэнняў:
- '
0
' Няма абіўкі.
- '
0.01
' 1% твару займае абіўка. Напрыклад, пры раздзяленні 1920x1280 памер грані будзе 640x640, а водступ будзе складаць 3 пікселі з кожнага боку. (640 * 0,01 = 6 пікселяў)
Значэнне па змаўчанні '
0
' . Максімальнае значэнне '0.1
' .- '
fin_pad
fout_pad
Усталюйце фіксаванае запаўненне кубічнай карты ўводу/вываду. Значэнні ў пікселях.
Значэнне па змаўчанні '
0
' . Калі больш за нуль, гэта перавызначае іншыя параметры запаўнення.in_forder
out_forder
Задаць парадак граняў для кубічнай карты ўводу/вываду. Выберыце адзін кірунак для кожнай пазіцыі.
Абазначэнне напрамкаў:
- '
r
' справа
- '
l
' злева
- '
u
' уверх
- '
d
' ўніз
- '
f
' наперад
- '
b
' назад
Значэнне па змаўчанні '
rludfb
' .- '
in_frot
out_frot
Задаць паварот граняў для кубічнай карты ўводу/вываду. Выберыце адзін кут для кожнай пазіцыі.
Абазначэнне вуглоў:
- '
0
' 0 градусаў па гадзіннікавай стрэлцы
- '
1
' 90 градусаў па гадзіннікавай стрэлцы
- '
2
' 180 градусаў па гадзіннікавай стрэлцы
- '
3
' 270 градусаў па гадзіннікавай стрэлцы
Значэнне па змаўчанні '
000000
' .- '
- '
eac
' Раўнавугольная кубічная карта.
- '
flat
' - '
gnomonic
' - '
rectilinear
' Звычайнае відэа.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
dfisheye
' Двайны рыбін вачэй.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
barrel
' - '
fb
' - '
barrelsplit
' Фарматы Facebook 360.
- '
sg
' Стэрэаграфічны фармат.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
mercator
' Фармат Mercator.
- '
ball
' Шарыкавы фармат дае значнае скажэнне ў бок спіны.
- '
hammer
' Фармат праекцыі карты Hammer-Aitoff.
- '
sinusoidal
' Фармат сінусоіднай картаграфічнай праекцыі.
- '
fisheye
' Праекцыя рыбінага вока.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
pannini
' Праекцыя Паніні.
Спецыфічныя параметры фармату:
h_fov
Усталюйце выходны параметр Pannini.
ih_fov
Задаць уваходны параметр Pannini.
- '
cylindrical
' Цыліндрычная праекцыя.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
perspective
' Перспектыўная праекцыя. (толькі выхад)
Спецыфічныя параметры фармату:
v_fov
Задаць параметр перспектывы.
- '
tetrahedron
' Праекцыя тэтраэдра.
- '
tsp
' Праекцыя ўсечанай квадратнай піраміды.
- '
he
' - '
hequirect
' Палавінная раўнавугольная праекцыя.
- '
equisolid
' Equisolid фармат.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
og
' Арфаграфічны фармат.
Спецыфічныя параметры фармату:
h_fov
v_fov
d_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
ih_fov
iv_fov
id_fov
Усталюйце гарызантальнае/вертыкальнае/дыяганальнае поле зроку. Значэнні ў градусах.
Калі ўстаноўлена дыяганальнае поле зроку, яно пераважвае гарызантальнае і вертыкальнае поле зроку.
- '
octahedron
' Праекцыя актаэдра.
- '
cylindricalea
' Цыліндрычная роўнаплошчавая праекцыя.
- '
interp
Задаць метад інтэрпаляцыі.
Заўвага: для выканання больш складаных метадаў інтэрпаляцыі патрабуецца значна больш памяці.Даступныя метады:
- '
near
' - '
nearest
' Бліжэйшы сусед.
- '
line
' - '
linear
' Білінейная інтэрпаляцыя.
- '
lagrange9
' Інтэрпаляцыя Лагранжа9.
- '
cube
' - '
cubic
' Бікубічная інтэрпаляцыя.
- '
lanc
' - '
lanczos
' Інтэрпаляцыя Ланцоша.
- '
sp16
' - '
spline16
' Сплайн16 інтэрпаляцыя.
- '
gauss
' - '
gaussian
' Інтэрпаляцыя Гаўса.
- '
mitchell
' Інтэрпаляцыя Мітчэла.
Значэнне па змаўчанні '
line
' .- '
w
h
Усталюйце дазвол выходнага відэа.
Раздзяленне па змаўчанні залежыць ад фарматаў.
in_stereo
out_stereo
Усталюйце стэрэафармат уваходу/вываду.
- '
2d
' 2D мона
- '
sbs
' Побач
- '
tb
' Зверху знізу
Значэнне па змаўчанні '
2d
' для фармату ўводу і вываду.- '
yaw
pitch
roll
Усталюйце паварот для выхаднога відэа. Значэнні ў градусах.
rorder
Усталюйце парадак павароту для выхаднога відэа. Абярыце адзін прадмет для кожнай пазіцыі.
- '
y, Y
' гойсанне
- '
p, P
' крок
- '
r, R
' рулет
Значэнне па змаўчанні '
ypr
' .- '
h_flip
v_flip
d_flip
Перавярнуць выходнае відэа гарызантальна (памяняць месцамі злева направа)/вертыкальна (памяняць месцамі ўверх-уніз)/углыб (памяняць месцамі назад-уперад). Лагічныя значэнні.
ih_flip
iv_flip
Устанавіце, калі ўваходнае відэа пераварочваецца па гарызанталі/вертыкалі. Лагічныя значэнні.
in_trans
Устанавіце, калі ўваходнае відэа транспануецца. Лагічнае значэнне, па змаўчанні адключана.
out_trans
Устанавіце, ці патрэбна транспазіцыя выхаднога відэа. Лагічнае значэнне, па змаўчанні адключана.
h_offset
v_offset
Устанавіць гарызантальнае/вертыкальнае зрушэнне па восі вываду. Па змаўчанні ўстаноўлена 0. Дазволены дыяпазон ад -1 да 1.
alpha_mask
Стварыце маску ў альфа-плоскасці для ўсіх неадлюстраваных пікселяў, пазначыўшы іх цалкам празрыстымі. Лагічнае значэнне, па змаўчанні адключана.
reset_rot
Скінуць паварот выхаднога відэа. Лагічнае значэнне, па змаўчанні адключана.
11.261.1 Examples
- Пераўтварыце роўнапрастакутнае відэа ў кубічную карту з кампаноўкай 3x2 і 1% запаўнення з дапамогай бікубічнай інтэрпаляцыі:
ffmpeg -i input.mkv -vf v360=e:c3x2:cubic:out_pad=0.01 output.mkv
- Выняць выгляд ззаду Equi-Angular Cubemap:
ffmpeg -i input.mkv -vf v360=eac:flat:yaw=180 output.mkv
- Пераўтварыце транспазіраваную і гарызантальна перавернутую кубічную карту Equi-Angular Cubemap у стэрэафармаце бок аб бок у раўнапрамавугольны стэрэафармат зверху ўніз:
v360=eac:equirect:in_stereo=sbs:in_trans=1:ih_flip=1:out_stereo=tb
11.261.2 Commands
Гэты фільтр падтрымлівае падмноства вышэйзгаданых опцый у якасці каманд .
11.262 vaguedenoiser
Прымяніце сродак для знішчэння шуму на аснове вейвлетаў.
Ён пераўтварае кожны кадр з уваходнага відэа ў дамен вейвлетаў з дапамогай Коэна-Дабешы-Фэво 9/7. Затым ён прымяняе пэўную фільтрацыю да атрыманых каэфіцыентаў. Пасля гэтага выконваецца зваротнае вейвлет-пераўтварэнне. Дзякуючы ўласцівасцям хвалі, гэта павінна даць добры згладжаны вынік і паменшаны шум без размывання функцый выявы.
Гэты фільтр прымае наступныя параметры:
threshold
Сіла фільтрацыі. Чым вышэй, тым больш адфільтраваным будзе відэа. Жорсткі парог можа выкарыстоўваць больш высокі парог, чым мяккі парог, перш чым відэа будзе выглядаць празмерна адфільтраваным. Значэнне па змаўчанні - 2.
method
Метад фільтрацыі, які будзе выкарыстоўваць фільтр.
Ён прымае наступныя значэнні:
- '
hard
' Усе значэнні ніжэй парогавага значэння будуць абнулены.
- '
soft
' Усе значэнні ніжэй парогавага значэння будуць абнулены. Усе значэнні вышэй будуць паменшаны на парог.
- '
garrote
' Маштабуе або абнуляе каэфіцыенты - пасярэднік паміж (больш) мяккім і (менш) жорсткім парогамі.
Па змаўчанні - гаррота.
- '
nsteps
Колькасць разоў вейвлет раскладзе малюнак. Малюнак не можа быць разбіты за межы пэўнай кропкі (як правіла, 8 для кадра 640x480 - як 2^9 = 512 > 480). Дапушчальныя значэнні - гэта цэлыя лікі ад 1 да 32. Значэнне па змаўчанні - 6.
percent
Частковае ці поўнае знішчэнне шумоў (абмежаванае скарачэнне каэфіцыентаў), ад 0 да 100. Значэнне па змаўчанні 85.
planes
Спіс плоскасцей для апрацоўкі. Па змаўчанні апрацоўваюцца ўсе плоскасці.
type
Тып парога, які будзе выкарыстоўваць фільтр.
Ён прымае наступныя значэнні:
- '
universal
' Парог, які выкарыстоўваецца, аднолькавы для ўсіх разлажэнняў.
- '
bayes
' Парог, які выкарыстоўваецца, таксама залежыць ад кожнага каэфіцыента раскладання.
Па змаўчанні ўніверсальны.
- '
11.263 varblur
Прымяніце зменны фільтр размыцця, выкарыстоўваючы 2-й відэаплынь, каб задаць радыус размыцця. 2-й паток павінен мець такія ж памеры.
Гэты фільтр прымае наступныя параметры:
min_r
Задаць мінімальна дазволены радыус. Дазволены дыяпазон ад 0 да 254. Па змаўчанні 0.
max_r
Усталюйце максімальна дазволены радыус. Дазволены дыяпазон ад 1 да 255. Па змаўчанні 8.
planes
Усталюйце, якія плоскасці апрацоўваць. Па змаўчанні выкарыстоўваюцца ўсе.
Фільтр varblur
таксама падтрымлівае параметры framesync .
11.263.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйзгаданыя параметры ў якасці каманд .
11.264 vectorscope
Адлюстраванне 2 значэнняў каляровых кампанентаў у двухмерным графіцы (які называецца вектарскоп).
Гэты фільтр прымае наступныя параметры:
mode, m
Усталюйце рэжым вектороскопа.
Ён прымае наступныя значэнні:
- '
gray
' - '
tint
' Значэнні шэрага адлюстроўваюцца на графіку, большая яркасць азначае, што больш пікселяў маюць аднолькавае значэнне колеру кампанента ў месцы на графіку. Гэта рэжым па змаўчанні.
- '
color
' Шэрыя значэнні адлюстроўваюцца на графіцы. Значэнні навакольных пікселяў, якіх няма ў відэакадры, малююцца градыентам 2 кампанентаў колеру, якія задаюцца опцыяй
x
іy
. 3-ці кампанент колеру статычны.- '
color2
' Фактычныя значэнні кампанентаў колеру, якія прысутнічаюць у відэакадры, адлюстроўваюцца на графіцы.
- '
color3
' Падобны да color2, але больш высокая частата аднолькавых значэнняў
x
іy
на графіцы павялічвае значэнне іншага кампанента колеру, якім з'яўляецца яркасць па значэннях па змаўчанніx
іy
.- '
color4
' Фактычныя колеры, якія прысутнічаюць у відэакадры, адлюстроўваюцца на графіцы. Калі два розныя колеры супадаюць з адной і той жа пазіцыяй на графіцы, то выбіраецца колер з больш высокім значэннем кампанента, якога няма на графіцы.
- '
color5
' Шэрыя значэнні адлюстроўваюцца на графіцы. Падобна,
color
але з 3-м кампанентам колеру, выбраным з радыяльнага градыенту.
- '
x
Усталюйце кампанент колеру, які будзе прадстаўлены на восі X. Па змаўчанні
1
.y
Усталюйце кампанент колеру, які будзе прадстаўлены на восі Y. Па змаўчанні
2
.intensity, i
Усталюйце інтэнсіўнасць, якая выкарыстоўваецца рэжымамі: шэры, колер, колер3 і колер5 для павелічэння яркасці кампанента колеру, які прадстаўляе частату размяшчэння (X, Y) на графіцы.
envelope, e
- '
none
' Без канверта, гэта па змаўчанні.
- '
instant
' Імгненны канверт, нават самы цёмны асобны піксель будзе выразна вылучаны.
- '
peak
' Захоўвайце максімальныя і мінімальныя значэнні, прадстаўленыя на графіку з цягам часу. Такім чынам вы па-ранейшаму можаце заўважыць значэнні за межамі дыяпазону, не гледзячы пастаянна на вектарскоп.
- '
peak+instant
' Пік і імгненны канверт разам.
- '
graticule, g
Усталюйце, якую сетку маляваць.
- '
none
' - '
green
' - '
color
' - '
invert
'
- '
opacity, o
Задаць непразрыстасць сеткі.
flags, f
Усталюйце сцягі сетак.
- '
white
' Намалюйце сетку для белай кропкі.
- '
black
' Намалюйце сетку для чорнай кропкі.
- '
name
' Намалюйце каляровымі кропкамі кароткія назвы.
- '
bgopacity, b
Задаць непразрыстасць фону.
lthreshold, l
Усталюйце нізкі парог для каляровага кампанента, які не прадстаўлены на восі X або Y. Значэнні ніжэйшыя за гэта значэнне будуць ігнаравацца. Па змаўчанні 0. Звярніце ўвагу, што гэтае значэнне памнажаецца на фактычнае максімальна магчымае значэнне, якое можа мець адзін кампанент пікселя. Такім чынам, для 8-бітнага ўваходу і нізкага парогавага значэння 0,1 фактычны парог складае 0,1 * 255 = 25.
hthreshold, h
Усталюйце высокі парог для кампанента колеру, які не прадстаўлены на восі X або Y. Значэнні, большыя за гэта значэнне, будуць ігнаравацца. Па змаўчанні 1. Звярніце ўвагу, што гэтае значэнне памнажаецца на фактычнае максімальна магчымае значэнне, якое можа мець адзін кампанент пікселя. Такім чынам, для 8-бітнага ўваходу і высокага парогавага значэння 0,9 фактычны парог складае 0,9 * 255 = 230.
colorspace, c
Усталюйце, якую каляровую прастору выкарыстоўваць пры маляванні сеткі.
- '
auto
' - '
601
' - '
709
'
Па змаўчанні ўстаноўлена аўтаматычна.
- '
tint0, t0
tint1, t1
Усталюйце адценне колеру для рэжыму вектарскопа шэрага/адцення. Па змаўчанні абодва варыянты роўныя нулю. Гэта азначае адсутнасць адцення, і выхад застанецца шэрым.
11.265 vidstabdetect
Прааналізуйце стабілізацыю/скасаванне відэа. Выканайце праход 1 з 2, гл. vidstabtransform для праходу 2.
Гэты фільтр стварае файл з інфармацыяй аб адносным перакладзе і пераўтварэнні павароту аб наступных кадрах, які затым выкарыстоўваецца vidstabtransform .
Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай
--enable-libvidstab
.
Гэты фільтр прымае наступныя параметры:
result
Усталюйце шлях да файла, які выкарыстоўваецца для запісу інфармацыі пра пераўтварэнні. Значэнне па змаўчанні
transforms.trf
.shakiness
Усталюйце, наколькі хісткае відэа і хуткасць камеры. Ён прымае цэлы лік у дыяпазоне 1-10, значэнне 1 азначае невялікую хісткасць, значэнне 10 азначае моцную хісткасць. Значэнне па змаўчанні - 5.
accuracy
Усталюйце дакладнасць працэсу выяўлення. Значэнне павінна быць у дыяпазоне 1-15. Значэнне 1 азначае нізкую дакладнасць, значэнне 15 азначае высокую дакладнасць. Значэнне па змаўчанні - 15.
stepsize
Задаць памер кроку працэсу пошуку. Вобласць вакол мінімуму скануецца з дазволам 1 піксель. Значэнне па змаўчанні - 6.
mincontrast
Усталюйце мінімальны кантраст. Ніжэй гэтага значэння лакальнае поле вымярэння адкідаецца. Павінна быць значэнне з плаваючай коскай у дыяпазоне 0-1. Значэнне па змаўчанні 0,3.
tripod
Усталюйце апорны нумар кадра для рэжыму штатыва.
Калі ўключана, рух кадраў параўноўваецца з эталонным кадрам у адфільтраваным патоку, ідэнтыфікаваным зададзеным нумарам. Ідэя складаецца ў тым, каб кампенсаваць усе рухі ў больш-менш статычнай сцэне і трымаць агляд камеры абсалютна нерухомым.
Калі ўсталявана 0, ён адключаны. Кадры лічацца ад 1.
show
Паказаць палі і пераўтварэнні ў атрыманых кадрах. Ён прымае цэлы лік у дыяпазоне 0-2. Значэнне па змаўчанні - 0, якое адключае любую візуалізацыю.
11.265.1 Examples
- Выкарыстоўвайце значэнні па змаўчанні:
vidstabdetect
- Прааналізуйце моцна хісткі фільм і змесціце вынікі ў файл
mytransforms.trf
:vidstabdetect=shakiness=10:accuracy=15:result="mytransforms.trf"
- Уявіце вынік унутраных пераўтварэнняў у атрыманым відэа:
vidstabdetect=show=1
- Прааналізуйце відэа з сярэдняй дрыготкай з дапамогай
ffmpeg
:ffmpeg -i input -vf vidstabdetect=shakiness=5:show=1 dummy.avi
11.266 vidstabtransform
Стабілізацыя/скасаванне відэа: прайдзіце 2 з 2, гл. vidstabdetect для праходу 1.
Прачытайце файл з інфармацыяй аб трансфармацыі для кожнага кадра і прымяніце/кампенсуйце іх. Разам з фільтрам vidstabdetect гэта можа быць выкарыстана для ліквідацыі ўзрушэння відэа. Глядзіце таксама http://public.hronopik.de/vid.stab . Важна таксама выкарыстоўваць нярэзкі , гл. ніжэй.
Каб уключыць кампіляцыю гэтага фільтра, трэба наладзіць FFmpeg з дапамогай
--enable-libvidstab
.
11.266.1 Options
input
Задайце шлях да файла, які выкарыстоўваецца для чытання пераўтварэнняў. Значэнне па змаўчанні
transforms.trf
.smoothing
Усталюйце колькасць кадраў (значэнне*2 + 1), якія выкарыстоўваюцца для нізкачастотнай фільтрацыі рухаў камеры. Значэнне па змаўчанні - 10.
Напрыклад, лік 10 азначае, што для згладжвання руху ў відэа выкарыстоўваецца 21 кадр (10 у мінулым і 10 у будучыні). Большае значэнне прыводзіць да больш плаўнага відэа, але абмяжоўвае паскарэнне камеры (панарамаванне/нахіл). 0 - асаблівы выпадак, калі імітуецца статычная камера.
optalgo
Усталюйце алгарытм аптымізацыі траекторыі камеры.
Дапушчальныя значэнні:
- '
gauss
' фільтр нізкіх частот ядра Гаўса па руху камеры (па змаўчанні)
- '
avg
' асерадненне па пераўтварэннях
- '
maxshift
Усталюйце максімальную колькасць пікселяў для перакладу кадраў. Значэнне па змаўчанні -1, што азначае адсутнасць абмежаванняў.
maxangle
Усталюйце максімальны вугал у радыянах (градус*PI/180) для павароту кадраў. Значэнне па змаўчанні -1, што азначае адсутнасць абмежаванняў.
crop
Укажыце, як дзейнічаць з межамі, якія могуць быць бачныя з-за кампенсацыі руху.
Даступныя значэнні:
- '
keep
' захаваць інфармацыю аб малюнку з папярэдняга кадра (па змаўчанні)
- '
black
' запоўніце мяжу чорным
- '
invert
Інвертаваць пераўтварэнні, калі ўстаноўлена значэнне 1. Значэнне па змаўчанні - 0.
relative
Разглядаць пераўтварэнні адносна папярэдняга кадра, калі ўстаноўлена значэнне 1, або абсалютнае, калі значэнне 0. Значэнне па змаўчанні роўна 0.
zoom
Усталюйце працэнт маштабавання. Станоўчае значэнне прывядзе да эфекту павелічэння, а адмоўнае - да эфекту памяншэння. Значэнне па змаўчанні 0 (без маштабавання).
optzoom
Усталюйце аптымальнае маштабаванне, каб пазбегнуць межаў.
Дапушчальныя значэнні:
- '
0
' адключаны
- '
1
' вызначаецца аптымальнае значэнне статычнага маштабавання (толькі вельмі моцныя рухі прывядуць да бачных межаў) (па змаўчанні)
- '
2
' вызначаецца аптымальнае значэнне адаптыўнага павелічэння (межы не будуць бачныя), гл
zoomspeed
Звярніце ўвагу, што значэнне, дадзенае пры маштабаванні, дадаецца да разлічанага тут.
- '
zoomspeed
Усталюйце працэнт для максімальнага маштабавання кожнага кадра (уключана, калі
optzoom
усталяваны ў 2). Дыяпазон ад 0 да 5, значэнне па змаўчанні 0,25.interpol
Укажыце тып інтэрпаляцыі.
Даступныя значэнні:
- '
no
' няма інтэрпаляцыі
- '
linear
' лінейныя толькі гарызантальныя
- '
bilinear
' лінейна ў абодвух напрамках (па змаўчанні)
- '
bicubic
' кубічны ў абодвух напрамках (павольна)
- '
tripod
Уключыць рэжым віртуальнага штатыва, калі ўстаноўлена значэнне 1, што эквівалентна
relative=0:smoothing=0
. Значэнне па змаўчанні 0.Выкарыстоўвайце таксама
tripod
опцыю vidstabdetect .debug
Павялічыць шматслоўнасць журнала, калі ўстаноўлена ў 1. Таксама выяўленыя глабальныя рухі запісваюцца ў часовы файл
global_motions.trf
. Значэнне па змаўчанні 0.
11.266.2 Examples
- Выкарыстоўвайце
ffmpeg
для звычайнай стабілізацыі са значэннямі па змаўчанні:ffmpeg -i inp.mpeg -vf vidstabtransform,unsharp=5:5:0.8:3:3:0.4 inp_stabilized.mpeg
Звярніце ўвагу на выкарыстанне недыстра , які заўсёды рэкамендуецца.
- Павялічце яшчэ трохі і загрузіце дадзеныя пераўтварэння з дадзенага файла:
vidstabtransform=zoom=5:input="mytransforms.trf"
- Згладзьце відэа яшчэ больш:
vidstabtransform=smoothing=30
11.267 vflip
Перавярнуць уваходнае відэа вертыкальна.
Напрыклад, каб вертыкальна перавярнуць відэа з дапамогай ffmpeg
:
ffmpeg -i in.avi -vf "vflip" out.avi
11.268 vfrdet
Выяўленне відэа з зменнай частатой кадраў.
Гэты фільтр спрабуе вызначыць, зменная ці пастаянная частата кадраў.
У канцы ён выдасць колькасць кадраў, выяўленых як тыя, што маюць зменныя дэльта-пункты, і кадры з пастаяннымі дэльта-пунктамі. Калі былі кадры са зменнай дэльтай, то ён таксама пакажа мінімальную, максімальную і сярэднюю дэльту.
11.269 vibrance
Павялічце або зменіце насычанасць.
Фільтр прымае наступныя параметры:
intensity
Усталюйце сілу ўзмацнення, калі значэнне дадатнае, або сілу змены, калі значэнне адмоўнае. Па змаўчанні 0. Дазволены дыяпазон ад -2 да 2.
rbal
Усталюйце чырвоны баланс. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.
gbal
Усталюйце зялёны баланс. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.
bbal
Усталюйце баланс сіняга. Па змаўчанні 1. Дазволены дыяпазон ад -10 да 10.
rlum
Усталюйце чырвоны каэфіцыент яркасці.
glum
Усталюйце каэфіцыент яркасці зялёнага колеру.
blum
Усталюйце сіні каэфіцыент яркасці.
alternate
Калі
intensity
значэнне адмоўнае і ўстаноўлена ў 1, колеры будуць змяняцца, інакш колеры будуць менш насычанымі, больш набліжанымі да шэрага.
11.269.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд .
11.270 vif
Атрымайце сярэдні VIF (дакладнасць візуальнай інфармацыі) паміж двума ўваходнымі відэа.
Гэты фільтр прымае два ўваходныя відэа.
Абодва ўваходныя відэа павінны мець аднолькавае раздзяленне і фармат пікселяў, каб гэты фільтр працаваў правільна. Таксама мяркуецца, што абодва ўваходы маюць аднолькавую колькасць кадраў, якія параўноўваюцца адзін за адным.
Атрыманая сярэдняя адзнака VIF раздрукоўваецца праз сістэму рэгістрацыі.
Фільтр захоўвае разлічаны бал VIF кожнага кадра.
У прыведзеным ніжэй прыкладзе ўваходны файлmain.mpg
апрацоўваецца параўноўваецца з эталонным файламref.mpg
.
ffmpeg -i main.mpg -i ref.mpg -lavfi vif -f null -
11.271 vignette
Зрабіце або адмяніце натуральны эфект віньеткавання.
Фільтр прымае наступныя параметры:
angle, a
Задаць выраз кута лінзы ў колькасці радыян.
Значэнне абразаецца ў
[0,PI/2]
дыяпазоне.Значэнне па змаўчанні:
"PI/5"
x0
y0
Задайце выразы каардынат цэнтра. Адпаведна
"w/2"
і"h/2"
па змаўчанні.mode
Усталюйце рэжым наперад/назад.
Даступныя рэжымы:
- '
forward
' Чым больш адлегласць ад цэнтральнай кропкі, тым цямней становіцца малюнак.
- '
backward
' Чым больш адлегласць ад цэнтральнай кропкі, тым ярчэй становіцца малюнак. Гэта можа быць выкарыстана для зваротнага эфекту віньеткі, хоць аўтаматычнага выяўлення для вымання лінзы няма
angle
і іншыя налады (пакуль). Таксама яго можна выкарыстоўваць для стварэння эфекту пякучага.
Значэнне па змаўчанні '
forward
'.- '
eval
Задаць рэжым ацэнкі для выразаў (
angle
,x0
,y0
).Ён прымае наступныя значэнні:
- '
init
' Вылічвайце выразы толькі адзін раз падчас ініцыялізацыі фільтра.
- '
frame
' Ацаніце выразы для кожнага ўваходнага кадра. Гэта значна павольней, чым "
init
' рэжым, паколькі ён патрабуе паўторнага вылічэння ўсіх скалераў, але ён дазваляе пашыраныя дынамічныя выразы.
Значэнне па змаўчанні '
init
'.- '
dither
Усталюйце згладжванне, каб паменшыць эфект кругавых палос. Па змаўчанні
1
(уключана).aspect
Задаць прапорцыі віньеткі. Гэты параметр дазваляе наладзіць форму віньеткі. Пры ўсталёўцы гэтага значэння SAR ўваходных дадзеных будзе зроблена прамавугольнае віньеткаванне, якое адпавядае памерам відэа.
Па змаўчанні
1/1
.
11.271.1 Expressions
Thealpha
,x0
іy0
выразы могуць утрымліваць наступныя параметры.
w
h
увядзіце шырыню і вышыню
n
нумар уваходнага кадра, пачынаючы з 0
pts
час PTS (Presentation TimeStamp) адфільтраванага відэакадра, выражаны ў
TB
адзінках, NAN, калі не вызначаныr
частата кадраў уваходнага відэа, NAN, калі частата кадраў уваходнага сігналу невядомая
t
PTS (TimeStamp прэзентацыі) адфільтраванага відэакадра, выражаны ў секундах, NAN, калі не вызначаны
tb
часовая база ўваходнага відэа
11.271.2 Examples
- Прымяніць просты эфект моцнага віньетка:
vignette=PI/4
- Зрабіце мігатлівую віньетку:
vignette='PI/4+random(1)*PI/50':eval=frame
11.272 vmafmotion
Атрымайце сярэднюю ацэнку руху VMAF для відэа. Гэта адзін з кампанентаў паказчыкаў VMAF.
Атрыманая сярэдняя адзнака руху друкуецца праз сістэму рэгістрацыі.
Фільтр прымае наступныя параметры:
stats_file
Калі пазначана, фільтр будзе выкарыстоўваць названы файл для захавання ацэнкі руху кожнага кадра адносна папярэдняга кадра. Калі імя файла роўна "-", даныя адпраўляюцца ў стандартны вывад.
прыклад:
ffmpeg -i ref.mpg -vf vmafmotion -f null -
11.273 vstack
Складайце ўваходныя відэа вертыкальна.
Усе патокі павінны мець аднолькавы піксельны фармат і аднолькавую шырыню.
Звярніце ўвагу, што гэты фільтр працуе хутчэй, чым выкарыстанне накладання і фільтра падкладкі для стварэння таго ж выхаду.
Фільтр прымае наступныя параметры:
inputs
Задаць колькасць уваходных патокаў. Па змаўчанні 2.
shortest
Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.
11.274 w3fdif
Дэінтэрлейсаванне ўваходнага відэа ("w3fdif" расшыфроўваецца як "фільтр дэінтэрлейсінгу палёў Weston 3").
Заснаваны на працэсе, апісаным Марцінам Уэстанам для BBC R&D, і рэалізаваным на аснове алгарытму дэінтэрлейсу, напісанага Джымам Істэрбрукам для BBC R&D, палявы дэінтэрлейсінг-фільтр Weston 3 выкарыстоўвае каэфіцыенты фільтра, разлічаныя BBC R&D.
Гэты фільтр выкарыстоўвае інфармацыю аб дамінаванні палёў у кадры, каб вырашыць, якое з кожнай пары палёў размясціць першым у вывадзе. Калі гэта памыляецца, выкарыстоўвайце фільтр setfield перад w3fdif
фільтрам.
Ёсць два наборы каэфіцыентаў фільтра, так званыя "просты" і "складаны". Які набор каэфіцыентаў фільтра выкарыстоўваецца, можна задаць шляхам перадачы дадатковага параметра:
filter
Усталюйце каэфіцыенты фільтра празрадковай разгорткі. Прымае адно з наступных значэнняў:
- '
simple
' Просты набор каэфіцыентаў фільтра.
- '
complex
' Больш складаны набор каэфіцыентаў фільтра.
Значэнне па змаўчанні '
complex
'.- '
mode
Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:
frame
Вывесці па адным кадры для кожнага кадра.
field
Вывесці па адным кадры для кожнага поля.
Значэнне па змаўчанні -
field
.parity
Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:
tff
Выкажам здагадку, што верхняе поле - першае.
bff
Выкажам здагадку, што ніжняе поле з'яўляецца першым.
auto
Уключыць аўтаматычнае вызначэнне парытэту поля.
Значэнне па змаўчанні -
auto
. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.deint
Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:
- '
all
' Дэінтэрлейс усіх кадраў,
- '
interlaced
' Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.
Значэнне па змаўчанні '
all
'.- '
11.274.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.275 waveform
Манітор відэасігналу.
Манітор формы хвалі адлюстроўвае інтэнсіўнасць кампанента колеру. Па змаўчанні толькі яркасць. Кожны слупок формы сігналу адпавядае слупку пікселяў у зыходным відэа.
Ён прымае наступныя варыянты:
mode, m
Можа быць або
row
, абоcolumn
. Па змаўчанніcolumn
. У рэжыме радка графік з левага боку ўяўляе значэнне кампанента колеру 0, а правы бок уяўляе значэнне = 255. У рэжыме слупка верхні бок уяўляе значэнне кампанента колеру = 0, а ніжні бок уяўляе значэнне = 255.intensity, i
Усталюйце інтэнсіўнасць. Меншыя значэнні карысныя, каб даведацца, колькі значэнняў аднолькавай яркасці размеркавана па ўваходных радках/слупках. Значэнне па змаўчанні -
0.04
. Дазволены дыяпазон [0, 1].mirror, r
Усталюйце рэжым адлюстравання.
0
значыць нелюстраваны,1
значыць люстраны. У люстраным рэжыме больш высокія значэнні будуць прадстаўлены злева дляrow
рэжыму і ўверсе дляcolumn
рэжыму. Па змаўчанні1
(люстравана).display, d
Усталюйце рэжым адлюстравання. Ён прымае наступныя значэнні:
- '
overlay
' Прадстаўляе інфармацыю, ідэнтычную той, што ў
parade
, за выключэннем таго, што графікі, якія прадстаўляюць каляровыя кампаненты, накладзены непасрэдна адзін на другі.Гэты рэжым адлюстравання палягчае выяўленне адносных адрозненняў або падабенстваў у перакрываючыхся абласцях каляровых кампанентаў, якія павінны быць аднолькавымі, напрыклад, нейтральных белых, шэрых або чорных.
- '
stack
' Паказаць асобны графік для кампанентаў колеру побач у
row
рэжыме або адзін пад адным уcolumn
рэжыме.- '
parade
' Паказаць асобны графік для кампанентаў колеру побач у
column
рэжыме або адзін пад адным уrow
рэжыме.Выкарыстанне гэтага рэжыму адлюстравання дазваляе лёгка заўважыць каляровыя адценні ў бліках і ценях выявы, параўноўваючы контуры верхняга і ніжняга графікаў кожнай хвалі. Паколькі белы, шэры і чорны колеры характарызуюцца дакладна роўнай колькасцю чырвонага, зялёнага і сіняга, нейтральныя вобласці выявы павінны адлюстроўваць тры хвалі прыкладна роўнай шырыні/вышыні. Калі няма, то карэкцыю лёгка выканаць, адрэгуляваўшы ўзровень трох сігналаў.
Па змаўчанні
stack
.- '
components, c
Усталюйце кампаненты колеру для адлюстравання. Значэнне па змаўчанні - 1, што азначае толькі кампанент яркасці або чырвонага колеру, калі ўвод у каляровай прасторы RGB. Калі, напрыклад, усталявана 7, будуць адлюстраваны ўсе 3 (калі) даступныя кампаненты колеру.
envelope, e
- '
none
' Без канверта, гэта па змаўчанні.
- '
instant
' Імгненны канверт, мінімальныя і максімальныя значэнні, прадстаўленыя на графіцы, будуць лёгка бачныя нават пры невялікім
step
значэнні.- '
peak
' Захоўвайце мінімальныя і максімальныя значэнні, прадстаўленыя на графіцы ў залежнасці ад часу. Такім чынам вы па-ранейшаму можаце заўважыць значэнні за межамі дыяпазону, не гледзячы ўвесь час на формы сігналу.
- '
peak+instant
' Пік і імгненны канверт разам.
- '
filter, f
- '
lowpass
' Без фільтрацыі, гэта па змаўчанні.
- '
flat
' Яркасць і каляровасць спалучаюцца разам.
- '
aflat
' Падобна вышэйшаму, але паказвае розніцу паміж сіняй і чырвонай каляровасцю.
- '
xflat
' Падобна вышэйзгаданаму, але выкарыстоўвайце іншыя колеры.
- '
yflat
' Падобна вышэйшаму, але зноў жа іншых колераў.
- '
chroma
' Адлюстроўвае толькі каляровасць.
- '
color
' Адлюстроўвае фактычнае значэнне колеру на сігнале.
- '
acolor
' Падобна вышэй, але з яркасцю, якая паказвае частату значэнняў каляровасці.
- '
graticule, g
Усталюйце, якую сетку адлюстроўваць.
- '
none
' Не паказваць сетку.
- '
green
' Паказаць зялёную сетку, якая паказвае дазволеныя дыяпазоны вяшчання.
- '
orange
' Паказаць аранжавую сетку, якая паказвае дазволеныя дыяпазоны вяшчання.
- '
invert
' Адлюстраванне інвертаванай сеткі, якая паказвае дазволеныя дыяпазоны вяшчання.
- '
opacity, o
Задаць непразрыстасць сеткі.
flags, fl
Усталюйце сцягі сетак.
- '
numbers
' Намалюйце лічбы над лініямі. Па змаўчанні ўключана.
- '
dots
' Малюйце кропкі замест ліній.
- '
scale, s
Усталюйце маштаб для адлюстравання сеткі.
- '
digital
' - '
millivolts
' - '
ire
'
Па змаўчанні лічбавы.
- '
bgopacity, b
Задаць непразрыстасць фону.
tint0, t0
tint1, t1
Задаць адценне для вываду. Выкарыстоўваецца толькі з фільтрам нізкіх частот і калі дысплей не накладзены, а фарматы ўваходных пікселяў не RGB.
fitmode, fm
Устанавіць узор суадносін бакоў выходных кадраў відэа. Можна выкарыстоўваць для канфігурацыі формы сігналу, каб ён не расцягваўся занадта моцна ў адным з напрамкаў.
- '
none
' Усталюйце для ўзору суадносіны бакоў 1/1.
- '
size
' Усталюйце ўзор суадносін бакоў у адпаведнасці з уваходным памерам відэа
Па змаўчанні '
none
'.- '
11.276 weave, doubleweave
Ён weave
прымае відэаўваход на аснове поля і аб'ядноўвае кожныя два паслядоўныя палі ў адзін кадр, ствараючы новы кліп з падвойнай вышынёй з удвая меншай частатой і ўдвая меншай колькасцю кадраў.
doubleweave
Працуе гэтак жа, як і weave
без памяншэння ўдвая частаты і колькасці кадраў.
Ён прымае наступны варыянт:
first_field
Усталяваць першае поле. Даступныя значэнні:
- '
top, t
' Усталюйце кадр як верхняе поле спачатку.
- '
bottom, b
' Усталюйце кадр як ніжняе поле спачатку.
- '
11.276.1 Examples
- Перапляценне відэа з дапамогай фільтра
выбару і асобных палёў:
separatefields,select=eq(mod(n,4),0)+eq(mod(n,4),3),weave
11.277 xbr
Прымяніце высакаякасны фільтр павелічэння xBR, прызначаны для піксельнага мастацтва. Ён прытрымліваецца набору правілаў выяўлення краёў, гл . https://forums.libretro.com/t/xbr-algorithm-tutorial/123 .
Ён прымае наступны варыянт:
n
Усталюйце памер маштабавання:
2
для2xBR
,3
для3xBR
і4
для4xBR
. Па змаўчанні3
.
11.278 xcorrelate
Прымяніць нармалізаваную карэляцыю паміж першым і другім уваходным відэапатокам.
Памеры відэапатоку другога ўваходу павінны быць меншымі за памеры відэапатоку першага ўваходу.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці апрацоўваць.
secondary
Усталяваць, якія другасныя відэакадры будуць апрацоўвацца з другога ўваходнага відэапатоку, можна
first
абоall
. Па змаўчанніall
.
Фільтр xcorrelate
таксама падтрымлівае параметры framesync .
11.279 xfade
Прымяненне крыжаванага знікнення ад аднаго ўваходнага відэапатоку да іншага ўваходнага відэапатоку. Перакрыжаванае знікненне прымяняецца на вызначаны час.
Абодва ўваходныя дадзеныя павінны быць пастаяннай частатой кадраў і аднолькавым дазволам, фарматам пікселяў, частатой кадраў і развагай па часе.
Фільтр прымае наступныя параметры:
transition
Усталюйце адзін з даступных эфектаў пераходу:
- '
custom
' - '
fade
' - '
wipeleft
' - '
wiperight
' - '
wipeup
' - '
wipedown
' - '
slideleft
' - '
slideright
' - '
slideup
' - '
slidedown
' - '
circlecrop
' - '
rectcrop
' - '
distance
' - '
fadeblack
' - '
fadewhite
' - '
radial
' - '
smoothleft
' - '
smoothright
' - '
smoothup
' - '
smoothdown
' - '
circleopen
' - '
circleclose
' - '
vertopen
' - '
vertclose
' - '
horzopen
' - '
horzclose
' - '
dissolve
' - '
pixelize
' - '
diagtl
' - '
diagtr
' - '
diagbl
' - '
diagbr
' - '
hlslice
' - '
hrslice
' - '
vuslice
' - '
vdslice
' - '
hblur
' - '
fadegrays
' - '
wipetl
' - '
wipetr
' - '
wipebl
' - '
wipebr
' - '
squeezeh
' - '
squeezev
' - '
zoomin
' - '
fadefast
' - '
fadeslow
'
Эфект пераходу па змаўчанні - знікненне.
- '
duration
Усталюйце працягласць перакрыжаванага знікнення ў секундах. Дыяпазон ад 0 да 60 секунд. Працягласць па змаўчанні - 1 секунда.
offset
Усталюйце пачатак перакрыжаванага знікнення адносна першага ўваходнага патоку ў секундах. Зрушэнне па змаўчанні роўна 0.
expr
Задаць выраз для карыстацкага эфекту пераходу.
Выразы могуць выкарыстоўваць наступныя зменныя і функцыі:
X
Y
Каардынаты бягучай выбаркі.
W
H
Шырыня і вышыня выявы.
P
Прагрэс эфекту пераходу.
PLANE
У цяперашні час апрацоўваецца самалёт.
A
Вяртанае значэнне першага ўводу ў бягучым месцы і плоскасці.
B
Вяртанае значэнне другога ўводу ў бягучым месцы і плоскасці.
a0(x, y)
a1(x, y)
a2(x, y)
a3(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) першага/другога/трэцяга/чацвёртага кампанента першага ўводу.b0(x, y)
b1(x, y)
b2(x, y)
b3(x, y)
Вяртае значэнне пікселя ў месцы (
x
,y
) першага/другога/трэцяга/чацвёртага кампанента другога ўводу.
11.279.1 Examples
- Перакрыжаванае знікненне ад аднаго ўваходнага відэа да іншага ўваходнага відэа з знікненнем і працягласцю пераходу 2 секунды, пачынаючы са зрушэння 5 секунд:
ffmpeg -i first.mp4 -i second.mp4 -filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4
11.280 xmedian
Выберыце сярэднія пікселі з некалькіх уваходных відэа.
Фільтр прымае наступныя параметры:
inputs
Усталюйце колькасць уваходаў. Па змаўчанні 3. Дазволены дыяпазон ад 3 да 255. Калі колькасць уводаў цотная, вынікам будзе сярэдняе значэнне паміж двума сярэднімі значэннямі.
planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
15
, паводле якога апрацоўваюцца ўсе плоскасці.percentile
Задаць сярэдні працэнт. Значэнне па змаўчанні -
0.5
. Значэнне па змаўчанні0.5
заўсёды будзе выбіраць сярэднія значэнні, а0
мінімальныя значэнні і1
максімальныя.
11.280.1 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд , за выключэннем опцыі inputs
.
11.281 xstack
Складайце відэаўваходы ў карыстальніцкі макет.
Усе патокі павінны мець аднолькавы піксельны фармат.
Фільтр прымае наступныя параметры:
inputs
Задаць колькасць уваходных патокаў. Па змаўчанні 2.
layout
Укажыце схему ўваходаў. Гэты параметр патрабуе, каб жаданая канфігурацыя макета была відавочна ўстаноўлена карыстальнікам. Гэта задае пазіцыю кожнага відэаўваходу на выхадзе. Кожны ўвод аддзяляецца знакам '|'. Першая лічба ўяўляе слупок, а другая лічба ўяўляе радок. Лічбы пачынаюцца з 0 і падзяляюцца знакам "_". Пры жаданні можна выкарыстоўваць wX і hX, дзе X - відэаўваход, з якога бярэцца шырыня або вышыня. Можна выкарыстоўваць некалькі значэнняў, падзеленыя знакам "+". У такім выпадку значэнні сумуюцца.
Звярніце ўвагу, што калі ўваходы маюць розныя памеры, могуць з'явіцца прабелы, бо не ўвесь кадр выхаднога відэа будзе запоўнены. Падобным чынам відэа могуць накладвацца адно на адно, калі іх становішча не пакідае дастаткова месца для поўнага кадра сумежных відэа.
Для 2 уваходаў усталяваны макет па змаўчанні
0_0|w0_0
(эквівалентныgrid=2x1
). Ва ўсіх астатніх выпадках макет або сетку павінен усталёўваць карыстальнік. Адначасова можа быць указана альбоgrid
або .layout
Вызначэнне абодвух прывядзе да памылкі.grid
Укажыце сетку ўваходных дадзеных з фіксаваным памерам. Гэты параметр выкарыстоўваецца для стварэння сеткі фіксаванага памеру ўваходных патокаў. Усталюйце памер сеткі ў форме
COLUMNSxROWS
. Павінны быцьROWS * COLUMNS
ўваходныя патокі, і яны будуць размешчаны ў выглядзе сеткі зROWS
радкамі іCOLUMNS
слупкамі. Пры выкарыстанні гэтай опцыі кожны паток уводу ў радку павінен мець аднолькавую вышыню, а ўсе радкі павінны мець аднолькавую шырыню.Калі
grid
ўстаноўлена, тоinputs
параметр ігнаруецца і няяўна задаецца якROWS * COLUMNS
.Для 2 уваходаў усталявана сетка па змаўчанні
2x1
(эквівалентнаяlayout=0_0|w0_0
). Ва ўсіх астатніх выпадках макет або сетку павінен усталёўваць карыстальнік. Адначасова можа быць указана альбоgrid
або .layout
Вызначэнне абодвух прывядзе да памылкі.shortest
Калі ўстаноўлена значэнне 1, прымусова спыніць вывад, калі заканчваецца самы кароткі ўвод. Значэнне па змаўчанні 0.
fill
Калі ўсталяваны правільны колер, усе нявыкарыстаныя пікселі будуць запоўнены гэтым колерам. Па змаўчанні запаўненне не ўстаноўлена, таму яно адключана.
11.281.1 Examples
- Адлюстраванне 4 уваходаў у сетку 2x2.
Макет:
input1(0, 0) | input3(w0, 0) input2(0, h0) | input4(w0, h0)
xstack=inputs=4:layout=0_0|0_h0|w0_0|w0_h0
Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.
- Адлюстраванне 4 уваходаў у сетку 1x4.
Макет:
input1(0, 0) input2(0, h0) input3(0, h0+h1) input4(0, h0+h1+h2)
xstack=inputs=4:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2
Звярніце ўвагу, што калі ўваходы маюць розную шырыню, з'явіцца нявыкарыстаная прастора.
- Адлюстраванне 9 уваходаў у сетку 3x3.
Макет:
input1(0, 0) | input4(w0, 0) | input7(w0+w3, 0) input2(0, h0) | input5(w0, h0) | input8(w0+w3, h0) input3(0, h0+h1) | input6(w0, h0+h1) | input9(w0+w3, h0+h1)
xstack=inputs=9:layout=0_0|0_h0|0_h0+h1|w0_0|w0_h0|w0_h0+h1|w0+w3_0|w0+w3_h0|w0+w3_h0+h1
Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.
- Адлюстраванне 16 уваходаў у сетку 4x4.
Макет:
input1(0, 0) | input5(w0, 0) | input9 (w0+w4, 0) | input13(w0+w4+w8, 0) input2(0, h0) | input6(w0, h0) | input10(w0+w4, h0) | input14(w0+w4+w8, h0) input3(0, h0+h1) | input7(w0, h0+h1) | input11(w0+w4, h0+h1) | input15(w0+w4+w8, h0+h1) input4(0, h0+h1+h2)| input8(w0, h0+h1+h2)| input12(w0+w4, h0+h1+h2)| input16(w0+w4+w8, h0+h1+h2)
xstack=inputs=16:layout=0_0|0_h0|0_h0+h1|0_h0+h1+h2|w0_0|w0_h0|w0_h0+h1|w0_h0+h1+h2|w0+w4_0| w0+w4_h0|w0+w4_h0+h1|w0+w4_h0+h1+h2|w0+w4+w8_0|w0+w4+w8_h0|w0+w4+w8_h0+h1|w0+w4+w8_h0+h1+h2
Звярніце ўвагу, што калі ўводы маюць розныя памеры, могуць узнікаць прабелы або накладання.
11.282 yadif
Дэінтэрлейсінг ўваходнага відэа ("yadif" азначае "яшчэ адзін фільтр дэінтэрлейсінгу").
Ён прымае наступныя параметры:
mode
Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:
0, send_frame
Вывесці па адным кадры для кожнага кадра.
1, send_field
Вывесці па адным кадры для кожнага поля.
2, send_frame_nospatial
Падабаецца
send_frame
, але прапускае праверку прасторавага перапляцення.3, send_field_nospatial
Падабаецца
send_field
, але прапускае праверку прасторавага перапляцення.
Значэнне па змаўчанні -
send_frame
.parity
Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:
0, tff
Выкажам здагадку, што верхняе поле - першае.
1, bff
Выкажам здагадку, што ніжняе поле з'яўляецца першым.
-1, auto
Уключыць аўтаматычнае вызначэнне парытэту поля.
Значэнне па змаўчанні -
auto
. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.deint
Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:
0, all
Дэінтэрлейс усіх кадраў.
1, interlaced
Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.
Значэнне па змаўчанні -
all
.
11.283 yadif_cuda
Дэінтэрлейс ўваходнага відэа з выкарыстаннем алгарытму yadif , але рэалізаванага ў CUDA, каб ён мог працаваць як частка канвеера паскарэння GPU з nvdec і/або nvenc.
Ён прымае наступныя параметры:
mode
Рэжым перапляцення, які трэба прыняць. Ён прымае адно з наступных значэнняў:
0, send_frame
Вывесці па адным кадры для кожнага кадра.
1, send_field
Вывесці па адным кадры для кожнага поля.
2, send_frame_nospatial
Падабаецца
send_frame
, але прапускае праверку прасторавага перапляцення.3, send_field_nospatial
Падабаецца
send_field
, але прапускае праверку прасторавага перапляцення.
Значэнне па змаўчанні -
send_frame
.parity
Парытэт поля выявы мяркуецца для ўваходнага празрадковага відэа. Ён прымае адно з наступных значэнняў:
0, tff
Выкажам здагадку, што верхняе поле - першае.
1, bff
Выкажам здагадку, што ніжняе поле з'яўляецца першым.
-1, auto
Уключыць аўтаматычнае вызначэнне парытэту поля.
Значэнне па змаўчанні -
auto
. Калі перапляценне невядома або дэкодэр не экспартуе гэтую інфармацыю, першым будзе лічыцца верхняе поле.deint
Укажыце, якія кадры трэба дэінтэрлейсаваць. Прымае адно з наступных значэнняў:
0, all
Дэінтэрлейс усіх кадраў.
1, interlaced
Дэінтэрлейсаваць толькі кадры, пазначаныя як празрадковыя.
Значэнне па змаўчанні -
all
.
11.284 yaepblur
Прымяніць фільтр размыцця з захаваннем краёў («yaepblur» азначае «яшчэ адзін фільтр размыцця, які захоўвае краю»). Алгарытм апісаны ў "JS Lee, Digital Image Enhanced and Noise Filtering by use of local Statistics, IEEE Trans. Pattern Anal. Mach. Intell. PAMI-2, 1980."
Ён прымае наступныя параметры:
radius, r
Усталюйце радыус акна. Значэнне па змаўчанні - 3.
planes, p
Усталюйце, якія плоскасці фільтраваць. Па змаўчанні - толькі першая плоскасць.
sigma, s
Задаць сілу размыцця. Значэнне па змаўчанні - 128.
11.284.1 Commands
Гэты фільтр падтрымлівае тыя ж каманды , што і параметры.
11.285 zoompan
Прымяніць эфект маштабавання і панарамавання.
Гэты фільтр прымае наступныя параметры:
zoom, z
Усталюйце выраз маштабавання. Дыяпазон 1-10. Па змаўчанні 1.
x
y
Задайце выразы x і y. Па змаўчанні 0.
d
Усталюйце выраз працягласці ў колькасці кадраў. Гэта вызначае, колькі кадраў будзе працягвацца эфект для адной уваходнай выявы. Па змаўчанні 90.
s
Усталюйце памер выходнай выявы, па змаўчанні "hd720".
fps
Усталюйце выходную частату кадраў, па змаўчанні "25".
Кожны выраз можа ўтрымліваць наступныя канстанты:
in_w, iw
Шырыня ўваходу.
in_h, ih
Вышыня ўваходу.
out_w, ow
Шырыня выхаду.
out_h, oh
Выхад вышыня.
in
Колькасць уваходных кадраў.
on
Колькасць выхадных кадраў.
in_time, it
Метка часу ўводу, выражаная ў секундах. Гэта NAN, калі пазнака часу ўводу невядомая.
out_time, time, ot
Метка часу вываду, выражаная ў секундах.
x
y
Апошняе разлічанае становішча "x" і "y" з выразаў "x" і "y" для бягучага ўваходнага кадра.
px
py
'x' і 'y' апошняга выходнага кадра папярэдняга ўваходнага кадра або 0, калі такога кадра яшчэ не было (першы ўваходны кадр).
zoom
Апошні разлічаны маштаб з выразу 'z' для бягучага ўваходнага кадра.
pzoom
Апошні разлічаны маштаб апошняга выходнага кадра папярэдняга ўваходнага кадра.
duration
Колькасць выходных кадраў для бягучага ўваходнага кадра. Вылічваецца з выразу "d" для кожнага ўваходнага кадра.
pduration
колькасць выходных кадраў, створаных для папярэдняга ўваходнага кадра
a
Рацыянальны лік: шырыня ўводу / вышыня ўводу
sar
узор суадносін бакоў
dar
суадносіны бакоў дысплея
11.285.1 Examples
- Павелічэнне маштабу да 1,5x і панарамаванне ў той жа час да нейкай кропкі паблізу цэнтра выявы:
zoompan=z='min(zoom+0.0015,1.5)':d=700:x='if(gte(zoom,1.5),x,x+1/a)':y='if(gte(zoom,1.5),y,y+1)':s=640x360
- Павелічэнне да 1,5x і панарамаванне заўсёды ў цэнтры выявы:
zoompan=z='min(zoom+0.0015,1.5)':d=700:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
- Тое самае, што і вышэй, але без паўзы:
zoompan=z='min(max(zoom,pzoom)+0.0015,1.5)':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
- Павялічце ў 2 разы цэнтр выявы толькі для першай секунды ўваходнага відэа:
zoompan=z='if(between(in_time,0,1),2,1)':d=1:x='iw/2-(iw/zoom/2)':y='ih/2-(ih/zoom/2)'
11.286 zscale
Зменіце памер (зменіце памер) уваходнага відэа з дапамогай бібліятэкі z.lib:
https://github.com/sekrit-twc/zimg . Каб уключыць кампіляцыю гэтага фільтра, неабходна наладзіць FFmpeg з дапамогай --enable-libzimg
.
Фільтр zscale прымушае суадносіны бакоў выхаднога дысплея быць такімі ж, як і ўваходныя, шляхам змены суадносін бакоў выхаднога ўзору.
Калі фармат уваходнага відарыса адрозніваецца ад фармату, запытанага наступным фільтрам, фільтр zscale пераўтворыць уваход у запытаны фармат.
11.286.1 Options
Фільтр прымае наступныя параметры.
width, w
height, h
Усталюйце выраз памернасці выхаднога відэа. Значэнне па змаўчанні - гэта памер уводу.
Калі значэнне
width
orw
роўна 0, шырыня ўводу выкарыстоўваецца для вываду. Калі значэннеheight
orh
роўна 0, вышыня ўводу выкарыстоўваецца для вываду.Калі адно і толькі адно са значэнняў роўна -n з n >= 1, фільтр zscale будзе выкарыстоўваць значэнне, якое падтрымлівае суадносіны бакоў уваходнага відарыса, разлічаныя з іншага зададзенага памеру. Аднак пасля гэтага ён пераканаецца, што вылічаны памер дзеліцца на n, і пры неабходнасці скарэктуе значэнне.
Калі абодва значэнні маюць -n з n >= 1, паводзіны будуць аднолькавымі да таго, што для абодвух значэнняў будзе прысвоена 0, як было апісана раней.
Глядзіце ніжэй спіс прынятых канстант для выкарыстання ў выразе памернасці.
size, s
Усталюйце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
dither, d
Усталюйце тып дрыгацення.
Магчымыя значэнні:
none
ordered
random
error_diffusion
Па змаўчанні няма.
filter, f
Усталюйце тып фільтра змены памеру.
Магчымыя значэнні:
point
bilinear
bicubic
spline16
spline36
lanczos
Па змаўчанні білінейны.
range, r
Усталюйце каляровую гаму.
Магчымыя значэнні:
input
limited
full
Па змаўчанні тое самае, што і ўвод.
primaries, p
Усталюйце асноўны колер.
Магчымыя значэнні:
input
709
unspecified
170m
240m
2020
Па змаўчанні тое самае, што і ўвод.
transfer, t
Задайце характарыстыкі перадачы.
Магчымыя значэнні:
input
709
unspecified
601
linear
2020_10
2020_12
smpte2084
iec61966-2-1
arib-std-b67
Па змаўчанні тое самае, што і ўвод.
matrix, m
Усталюйце матрыцу каляровай прасторы.
Магчымыя значэнні:
input
709
unspecified
470bg
170m
2020_ncl
2020_cl
Па змаўчанні тое самае, што і ўвод.
rangein, rin
Усталюйце ўваходны колеравы дыяпазон.
Магчымыя значэнні:
input
limited
full
Па змаўчанні тое самае, што і ўвод.
primariesin, pin
Усталюйце асноўныя колеры ўводу.
Магчымыя значэнні:
input
709
unspecified
170m
240m
2020
Па змаўчанні тое самае, што і ўвод.
transferin, tin
Усталюйце характарыстыкі перадачы ўваходу.
Магчымыя значэнні:
input
709
unspecified
601
linear
2020_10
2020_12
Па змаўчанні тое самае, што і ўвод.
matrixin, min
Усталюйце ўваходную матрыцу каляровай прасторы.
Магчымыя значэнні:
input
709
unspecified
470bg
170m
2020_ncl
2020_cl
chromal, c
Усталюйце месцазнаходжанне каляровасці выхаду.
Магчымыя значэнні:
input
left
center
topleft
top
bottomleft
bottom
chromalin, cin
Усталюйце размяшчэнне каляровасці ўводу.
Магчымыя значэнні:
input
left
center
topleft
top
bottomleft
bottom
npl
Усталюйце намінальную пікавую яркасць.
param_a
Параметр A для фільтраў маштабавання. Параметр «b» для bicubic і колькасць кранаў фільтра для lanczos.
param_b
Параметр B для маштабавання фільтраў. Параметр "с" для бікубічнага.
Каштоўнасці стw
іh
параметры - гэта выразы, якія змяшчаюць наступныя канстанты:
in_w
in_h
Шырыня і вышыня ўводу
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Шырыня і вышыня вываду (у маштабе).
ow
oh
Гэта тое самае, што
out_w
іout_h
a
Тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
Суадносіны бакоў уваходнага дысплея. Разлічваецца з
(iw / ih) * sar
.hsub
vsub
гарызантальныя і вертыкальныя ўваходныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.ohsub
ovsub
гарызантальныя і вертыкальныя вывадныя значэнні каляровасці падвыбаркі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.
11.286.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
width, w
height, h
Усталюйце выраз памернасці выхаднога відэа. Каманда прымае той жа сінтаксіс адпаведнай опцыі.
Калі ўказаны выраз несапраўдны, ён захоўваецца ў сваім бягучым значэнні.
12 OpenCL Video Filters
Ніжэй прыводзіцца апісанне даступных на дадзены момант відэафільтраў OpenCL.
Каб уключыць кампіляцыю гэтых фільтраў, трэба наладзіць FFmpeg з дапамогай
--enable-opencl
.
Запуск фільтраў OpenCL патрабуе ініцыялізацыі апаратнай прылады і перадачы гэтай прылады ўсім фільтрам у любым графе фільтраў.
-init_hw_device opencl[=
name
][:device
[,key=value
...]]opencl
Ініцыялізуйце новую апаратную прыладу тыпуname
, выкарыстоўваючы зададзеныя параметры прылады.-filter_hw_device
name
Перадайце выкліканую апаратную прыладу
name
ўсім фільтрам у любым графе фільтраў.
Для атрымання больш падрабязнай інфармацыі гл. https://www.ffmpeg.org/ffmpeg.html#Advanced-Video-options
- Прыклад выбару першай прылады на другой платформе і запуску на ёй фільтра avgblur_opencl з параметрамі па змаўчанні.
-init_hw_device opencl=gpu:1.0 -filter_hw_device gpu -i INPUT -vf "hwupload, avgblur_opencl, hwdownload" OUTPUT
Паколькі фільтры OpenCL не могуць атрымаць доступ да дадзеных кадраў у звычайнай памяці, перад выкарыстаннем усе дадзеныя кадраў неабходна загрузіць ( hwupload ) на апаратныя паверхні, падлучаныя да адпаведнай прылады, а затым загрузіць ( hwdownload ) назад у звычайную памяць. Звярніце ўвагу, што hwupload будзе загружаць на паверхню з той жа кампаноўкай, што і фрэйм ​​праграмнага забеспячэння, таму, магчыма, спатрэбіцца дадаць фільтр фармату непасрэдна перад тым, каб перавесці ўвод у правільны фармат, і hwdownload не падтрымлівае ўсе фарматы на выхадзе - гэта можа неабходна ўставіць дадатковы фільтр фармату адразу пасля графіка, каб атрымаць вывад у фармаце, які падтрымліваецца.
12.1 avgblur_opencl
Прымяніць фільтр сярэдняй размытасці.
Фільтр прымае наступныя параметры:
sizeX
Усталюйце памер гарызантальнага радыусу. Дыяпазон
[1, 1024]
і значэнне па змаўчанні1
.planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
0xf
, паводле якога апрацоўваюцца ўсе плоскасці.sizeY
Усталюйце памер вертыкальнага радыусу. Дыяпазон
[1, 1024]
і значэнне па змаўчанні0
. Калі нуль,sizeX
будзе выкарыстоўвацца значэнне.
12.1.1 Example
- Прымяніце фільтр сярэдняга размыцця з гарызантальным і вертыкальным памерам 3, усталяваўшы для кожнага пікселя вываду сярэдняе значэнне вобласці 7x7 з цэнтрам на ўваходзе. Для пікселяў па краях выявы вобласць не выходзіць за межы выявы, таму каардынаты па-за дыяпазонам не выкарыстоўваюцца ў разліках.
-i INPUT -vf "hwupload, avgblur_opencl=3, hwdownload" OUTPUT
12.2 boxblur_opencl
Прымяніць алгарытм размыцця скрынкі да ўваходнага відэа.
Ён прымае наступныя параметры:
luma_radius, lr
luma_power, lp
chroma_radius, cr
chroma_power, cp
alpha_radius, ar
alpha_power, ap
Далей апісваюцца прынятыя варыянты.
luma_radius, lr
chroma_radius, cr
alpha_radius, ar
Усталюйце выраз для радыуса поля ў пікселях, які выкарыстоўваецца для размыцця адпаведнай плоскасці ўводу.
Значэнне радыуса павінна быць неадмоўным лікам і не павінна перавышаць значэнне выразу
min(w,h)/2
для плоскасцей яркасці і альфа, а таксамаmin(cw,ch)/2
для плоскасцей каляровасці.Значэнне па змаўчанні для
luma_radius
роўна "2". Калі не ўказана,chroma_radius
іalpha_radius
па змаўчанні адпаведнае значэнне, усталяванае дляluma_radius
.Выразы могуць утрымліваць наступныя канстанты:
w
h
Шырыня і вышыня ўводу ў пікселях.
cw
ch
Шырыня і вышыня уваходнага каляровага малюнка ў пікселях.
hsub
vsub
Значэнні падвыбаркі каляровасці па гарызанталі і па вертыкалі. Напрыклад, для піксельнага фармату "yuv422p"
hsub
роўна 2 іvsub
роўна 1.
luma_power, lp
chroma_power, cp
alpha_power, ap
Укажыце, колькі разоў фільтр boxblur прымяняецца да адпаведнай плоскасці.
Значэнне па змаўчанні для
luma_power
роўна 2. Калі не пазначана,chroma_power
іalpha_power
па змаўчанні адпаведнае значэнне, усталяванае дляluma_power
.Значэнне 0 адключыць эфект.
12.2.1 Examples
Прымяніце фільтр BoxBlur, усталяваўшы для кожнага пікселя вываду сярэдняе значэнне радыусаў скрынкі luma_radius
, chroma_radius
, alpha_radius
для кожнай плоскасці адпаведна. Фільтр будзе прымяняцца luma_power
, chroma_power
, alpha_power
раз на адпаведнай плоскасці. Для пікселяў па краях выявы радыус не выходзіць за межы выявы, таму каардынаты па-за дыяпазонам не выкарыстоўваюцца ў разліках.
- Прымяніце фільтр BoxBlur з яркасцю, каляровасцю і альфа-радыусам, усталяваным на 2, і яркасцю, каляровасцю і альфа-магутнасцю, усталяванымі на 3. Фільтр будзе запушчаны 3 разы з усталяваным у квадрат-радыусе 2 для кожнай плоскасці выявы.
-i INPUT -vf "hwupload, boxblur_opencl=luma_radius=2:luma_power=3, hwdownload" OUTPUT -i INPUT -vf "hwupload, boxblur_opencl=2:3, hwdownload" OUTPUT
- Прымяніце фільтр boxblur з радыусам яркасці, усталяваным на 2, luma_power на 1, chroma_radius на 4, chroma_power на 5, alpha_radius на 3 і alpha_power на 7.
Для плоскасці яркасці радыус скрынкі 2x2 будзе выкананы адзін раз.
Для каляровай плоскасці радыус квадрата 4x4 будзе выкананы 5 разоў.
Для альфа-плоскасці радыус скрынкі 3x3 будзе прабегся 7 разоў.
-i INPUT -vf "hwupload, boxblur_opencl=2:1:4:5:3:7, hwdownload" OUTPUT
12.3 colorkey_opencl
Каляровая маніпуляцыя каляровай прасторы RGB.
Фільтр прымае наступныя параметры:
color
Колер, які будзе заменены на празрыстасць.
similarity
Працэнт падабенства з колерам ключа.
0.01 адпавядае толькі дакладнаму колеру ключа, у той час як 1.0 адпавядае ўсім.
blend
Працэнт сумесі.
0.0 робіць пікселі альбо цалкам празрыстымі, альбо ўвогуле непразрыстымі.
Больш высокія значэнні прыводзяць да напаўпразрыстых пікселяў, чым больш высокая празрыстасць, тым больш падобны колер пікселяў да ключавога колеру.
12.3.1 Examples
- Зрабіце кожны паўзялёны піксель ва ўводзе празрыстым з лёгкім змешваннем:
-i INPUT -vf "hwupload, colorkey_opencl=green:0.3:0.1, hwdownload" OUTPUT
12.4 convolution_opencl
Прымяніць згортванне матрыцы 3x3, 5x5, 7x7.
Фільтр прымае наступныя параметры:
0m
1m
2m
3m
Усталюйце матрыцу для кожнай плоскасці. Матрыца - гэта паслядоўнасць з 9, 25 або 49 лікаў са знакам. Значэнне па змаўчанні для кожнай плоскасці
0 0 0 0 1 0 0 0 0
.0rdiv
1rdiv
2rdiv
3rdiv
Усталюйце множнік для разліковага значэння для кожнай плоскасці. Калі не ўстаноўлена або 0, гэта будзе сума ўсіх элементаў матрыцы. Значэнне опцыі павінна быць лікам з плаваючай часткай, большым або роўным
0.0
. Значэнне па змаўчанні -1.0
.0bias
1bias
2bias
3bias
Усталюйце ўхіл для кожнай плоскасці. Гэта значэнне дадаецца да выніку множання. Карысна, каб зрабіць агульны малюнак ярчэй або цямней. Значэнне опцыі павінна быць лікам з плаваючай часткай, большым або роўным
0.0
. Значэнне па змаўчанні -0.0
.
12.4.1 Examples
- Ужыць рэзкасць:
-i INPUT -vf "hwupload, convolution_opencl=0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0:0 -1 0 -1 5 -1 0 -1 0, hwdownload" OUTPUT
- Прымяніць размыццё:
-i INPUT -vf "hwupload, convolution_opencl=1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1 1 1 1 1 1 1 1 1:1/9:1/9:1/9:1/9, hwdownload" OUTPUT
- Прымяніць паляпшэнне краёў:
-i INPUT -vf "hwupload, convolution_opencl=0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:0 0 0 -1 1 0 0 0 0:5:1:1:1:0:128:128:128, hwdownload" OUTPUT
- Прымяніць вызначэнне краю:
-i INPUT -vf "hwupload, convolution_opencl=0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:0 1 0 1 -4 1 0 1 0:5:5:5:1:0:128:128:128, hwdownload" OUTPUT
- Ужывайце дэтэктар краёў Лапласа, які ўключае дыяганалі:
-i INPUT -vf "hwupload, convolution_opencl=1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:1 1 1 1 -8 1 1 1 1:5:5:5:1:0:128:128:0, hwdownload" OUTPUT
- Нанесці рэльеф:
-i INPUT -vf "hwupload, convolution_opencl=-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2:-2 -1 0 -1 1 1 0 1 2, hwdownload" OUTPUT
12.5 erosion_opencl
Прымяніць эфект эрозіі да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) мінімумам.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмяжуйце максімальную змену для кожнай плоскасці. Дыяпазон
[0, 65535]
і значэнне па змаўчанні65535
. Калі0
, плоскасць застанецца нязменнай.coordinates
Сцяг, які вызначае піксель, на які трэба спасылацца. Дыяпазон
[0, 255]
і значэнне па змаўчанні255
, г.зн. выкарыстоўваюцца ўсе восем пікселяў.Сцягі мясцовага рэгіёну каардынат 3x3 з цэнтрам
x
:1 2 3
4 х 5
6 7 8
12.5.1 Example
- Прымяніце эразійны фільтр з значэннем threshold0 30, threshold1 40, threshold2 50 і каардынатамі 231, усталяваўшы для кожнага пікселя выхаду лакальны мінімум паміж пікселямі: 1, 2, 3, 6, 7, 8 3x3 вобласці з цэнтрам на ім ва уваход. Калі розніца паміж уваходным пікселем і лакальным мінімумам перавышае парог адпаведнай плоскасці, выхадны піксель будзе ўсталяваны як уваходны піксель - парог адпаведнай плоскасці.
-i INPUT -vf "hwupload, erosion_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
12.6 deshake_opencl
Фільтр стабілізацыі відэа на аснове асаблівасцей.
Фільтр прымае наступныя параметры:
tripod
Імітуе штатыў, прадухіляючы рух камеры ад зыходнага кадра. Па змаўчанні
0
.debug
Ці павінна адлюстроўвацца дадатковая адладкавая інфармацыя як у апрацаваным вывадзе, так і ў кансолі.
Звярніце ўвагу, што для таго, каб убачыць выснову адладкі кансолі, вам таксама трэба будзе перайсці
-v verbose
да ffmpeg.Супадзенне кропак прагляду ў выходным відэа падтрымліваецца толькі для ўваходу RGB.
Па змаўчанні
0
.adaptive_crop
Ці трэба рабіць невялікую кадрацыю па межах, каб скараціць колькасць люстраных пікселяў.
Па змаўчанні
1
.refine_features
Ці трэба ўдакладняць кропкі функцый на субпіксельным узроўні.
Гэта можна адключыць для невялікага прыросту прадукцыйнасці за кошт дакладнасці.
Па змаўчанні
1
.smooth_strength
Моц згладжвання, прымененага да шляху камеры ад
0.0
да1.0
.1.0
- гэта максімальная трываласць згладжвання, у той час як меншыя значэнні прыводзяць да меншага згладжвання.0.0
прымушае фільтр адаптыўна выбіраць сілу згладжвання для кожнага кадра.Па змаўчанні
0.0
.smooth_window_multiplier
Кантралюе памер акна згладжвання (колькасць кадраў, буферызаваных для вызначэння інфармацыі аб руху).
Памер акна згладжвання вызначаецца шляхам множання частоты кадраў відэа на гэты лік.
Дапушчальныя значэнні ад
0.1
да10.0
.Большыя значэнні павялічваюць аб'ём даных аб руху, даступных для вызначэння таго, як згладзіць траекторыю камеры, патэнцыйна паляпшаючы плыўнасць, але таксама павялічваюць затрымку і выкарыстанне памяці.
Па змаўчанні
2.0
.
12.6.1 Examples
- Стабілізаваць відэа з фіксаванай сярэдняй сілай згладжвання:
-i INPUT -vf "hwupload, deshake_opencl=smooth_strength=0.5, hwdownload" OUTPUT
- Стабілізаваць відэа з дапамогай адладкі (як у кансолі, так і ў візуалізаваным відэа):
-i INPUT -filter_complex "[0:v]format=rgba, hwupload, deshake_opencl=debug=1, hwdownload, format=rgba, format=yuv420p" -v verbose OUTPUT
12.7 dilation_opencl
Прымяніць эфект пашырэння да відэа.
Гэты фільтр замяняе піксель лакальным (3x3) максімумам.
Ён прымае наступныя варыянты:
threshold0
threshold1
threshold2
threshold3
Абмяжуйце максімальную змену для кожнай плоскасці. Дыяпазон
[0, 65535]
і значэнне па змаўчанні65535
. Калі0
, плоскасць застанецца нязменнай.coordinates
Сцяг, які вызначае піксель, на які трэба спасылацца. Дыяпазон
[0, 255]
і значэнне па змаўчанні255
, г.зн. выкарыстоўваюцца ўсе восем пікселяў.Сцягі мясцовага рэгіёну каардынат 3x3 з цэнтрам
x
:1 2 3
4 х 5
6 7 8
12.7.1 Example
- Прымяніце фільтр пашырэння з значэннем threshold0 30, threshold1 40, threshold2 50 і каардынатамі 231, усталяваўшы кожны піксель вываду на лакальны максімум паміж пікселямі: 1, 2, 3, 6, 7, 8 3x3 вобласці з цэнтрам на ім ва уваход. Калі розніца паміж уваходным пікселем і лакальным максімумам перавышае парогавае значэнне адпаведнай плоскасці, выхадны піксель будзе ўсталяваны як уваходны піксель + парог адпаведнай плоскасці.
-i INPUT -vf "hwupload, dilation_opencl=30:40:50:coordinates=231, hwdownload" OUTPUT
12.8 nlmeans_opencl
Нелакальныя сродкі фільтруюць шум праз OpenCL, гэты фільтр прымае тыя ж параметры, што і nlmeans .
12.9 overlay_opencl
Накласці адно відэа на другое.
Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход. Гэты фільтр патрабуе аднолькавага размяшчэння памяці для ўсіх уваходаў. Такім чынам, можа спатрэбіцца пераўтварэнне фармату.
Фільтр прымае наступныя параметры:
x
Усталюйце каардынату x накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні -
0
.y
Усталюйце каардынату y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні -
0
.
12.9.1 Examples
- Накласці выяву LOGO ў верхнім левым куце INPUT відэа. Абодва ўваходы маюць фармат yuv420p.
-i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
- Уваходы маюць аднолькавы макет памяці для каляровых каналаў, накладанне мае дадатковую альфа-плоскасць, напрыклад, INPUT - yuv420p, а LOGO - yuva420p.
-i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_opencl, hwdownload" OUTPUT
12.10 pad_opencl
Дадайце пракладкі да ўваходнага відарысу і размесціце зыходны ўвод у прадастаўленых x
каардынатах y
.
Ён прымае наступныя варыянты:
width, w
height, h
Укажыце выраз для памеру выхаднога відарыса з дададзенымі пракладкамі. Калі значэнне
width
абоheight
роўна 0, для вываду выкарыстоўваецца адпаведны ўваходны памер.Выраз
width
можа спасылацца на значэнне, зададзенаеheight
выразам, і наадварот.Значэнне па змаўчанні
width
іheight
роўна 0.x
y
Укажыце зрушэнні для размяшчэння ўваходнага відарыса ў падшытай вобласці адносна верхняй/левай мяжы выходнага відарыса.
Выраз
x
можа спасылацца на значэнне, зададзенаеy
выразам, і наадварот.Значэнне па змаўчанні
x
іy
роўна 0.Калі ацэнка
x
ory
дае адмоўны лік, яны будуць зменены так, што ўваходны відарыс будзе адцэнтраваны на падстаўленай вобласці.color
Вызначце колер афарбаванай вобласці. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
aspect
Перакласці на аспект замест дазволу.
Значэнні параметраў width
, height
, x
, і y
з'яўляюцца выразамі, якія змяшчаюць наступныя канстанты:
in_w
in_h
Шырыня і вышыня ўваходнага відэа.
iw
ih
Гэта тое самае, што
in_w
іin_h
.out_w
out_h
Шырыня і вышыня вываду (памер запаўненай вобласці), зададзеныя выразамі
width
і .height
ow
oh
Гэта тое самае, што
out_w
іout_h
.x
y
Зрушэнні x і y, як вызначана выразамі
x
іy
, або NAN, калі яшчэ не пазначаны.a
тое самае, што
iw
/ih
sar
суадносіны бакоў узору ўводу
dar
суадносіны бакоў уваходнага дысплея, яно такое ж, як (
iw
/ih
) *sar
12.11 prewitt_opencl
Прымяніце аператар Prewitt ( https://en.wikipedia.org/wiki/Prewitt_operator ) для ўводу відэаструменю.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
0xf
, паводле якога апрацоўваюцца ўсе плоскасці.scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон
[0.0, 65535]
і значэнне па змаўчанні1.0
.delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон
[-65535, 65535]
і значэнне па змаўчанні0.0
.
12.11.1 Example
- Прымяніце аператар Прэвітта, усталяваўшы маштаб 2 і дэльта 10.
-i INPUT -vf "hwupload, prewitt_opencl=scale=2:delta=10, hwdownload" OUTPUT
12.12 program_opencl
Фільтруйце відэа з дапамогай праграмы OpenCL.
source
Зыходны файл праграмы OpenCL.
kernel
Імя ядра ў праграме.
inputs
Колькасць уваходаў у фільтр. Па змаўчанні 1.
size, s
Памер выходных кадраў. Па змаўчанні тое самае, што і першы ўвод.
Фільтр program_opencl
таксама падтрымлівае параметры framesync .
Зыходны файл праграмы павінен утрымліваць функцыю ядра з дадзеным імем, якая будзе запускацца адзін раз для кожнай плоскасці вываду. Кожны запуск на плоскасці ставіцца ў чаргу як асобны 2D глабальны NDRange з адным працоўным элементам для кожнага пікселя, які будзе згенераваны. Такім чынам, глабальнае зрушэнне ідэнтыфікатара для кожнага працоўнага элемента - гэта каардынаты пікселя ў малюнку прызначэння.
Функцыя ядра павінна прымаць наступныя аргументы:
- Выява пункта прызначэння,
__write_only image2d_t
,.Гэта выява стане выхадам; ядро павінна запісаць усё гэта.
- Індэкс кадра,
unsigned int
,.Гэта лічыльнік, які пачынаецца з нуля і павялічваецца на адзінку для кожнага кадра.
- Зыходныя выявы,
__read_only image2d_t
,.Гэта самыя свежыя выявы для кожнага ўваходу. Ядро можа чытаць з іх для стварэння вываду, але ў іх нельга запісваць.
Прыклады праграм:
- Скапіруйце ўвод у выхад (вывад павінен быць такога ж памеру, што і ўваход).
__ядро пустой копіі (__write_only image2d_t прызначэння, індэкс unsigned int, __read_only image2d_t крыніца) { const sampler_t сэмплер = CLK_NORMALIZED_COORDS_FALSE; месцазнаходжанне int2 = (int2)(get_global_id(0), get_global_id(1)); значэнне float4 = read_imagef(крыніца, сэмплер, месца); write_imagef(пункт прызначэння, размяшчэнне, значэнне); }
- Прымяніце простае пераўтварэнне, паварочваючы ўвод на велічыню, якая павялічваецца разам са лічыльнікам індэкса. Значэнні пікселяў лінейна інтэрпалююцца сэмплерам, і выхад не павінен мець тыя ж памеры, што і ўваход.
__kernel void rotate_image(__write_only image2d_t dst, індэкс unsigned int, __read_only image2d_t src) { const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE | CLK_FILTER_LINEAR); вугал плавання = (паплавок)індэкс / 100.0f; float2 dst_dim = convert_float2(get_image_dim(dst)); float2 src_dim = convert_float2(get_image_dim(src)); float2 dst_cen = dst_dim / 2.0f; float2 src_cen = src_dim / 2.0f; int2 dst_loc = (int2)(get_global_id(0), get_global_id(1)); float2 dst_pos = convert_float2(dst_loc) - dst_cen; float2 src_pos = { cos(кут) * dst_pos.x - sin(кут) * dst_pos.y, sin(кут) * dst_pos.x + cos(кут) * dst_pos.y }; src_pos = src_pos * src_dim / dst_dim; float2 src_loc = src_pos + src_cen; калі (src_loc.x < 0.0f || src_loc.y < 0.0f || src_loc.x > src_dim.x || src_loc.y > src_dim.y) write_imagef(dst, dst_loc, 0,5f); яшчэ write_imagef(dst, dst_loc, read_imagef(src, сэмплер, src_loc)); }
- Сумяшчэнне двух уваходных дадзеных разам, прычым колькасць кожнага выкарыстоўванага ўводу вар'іруецца ў залежнасці ад лічыльніка індэкса.
__kernel void blend_images(__write_only image2d_t dst, індэкс unsigned int, __read_only image2d_t src1, __read_only image2d_t src2) { const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE | CLK_FILTER_LINEAR); float blend = (cos((float)index / 50.0f) + 1.0f) / 2.0f; int2 dst_loc = (int2)(get_global_id(0), get_global_id(1)); int2 src1_loc = dst_loc * get_image_dim(src1) / get_image_dim(dst); int2 src2_loc = dst_loc * get_image_dim(src2) / get_image_dim(dst); float4 val1 = read_imagef(src1, сэмплер, src1_loc); float4 val2 = read_imagef(src2, сэмплер, src2_loc); write_imagef(dst, dst_loc, val1 * blend + val2 * (1.0f - blend)); }
12.13 remap_opencl
Пераназначце пікселі з дапамогай уваходнага відэаструменя 2nd: Xmap і 3rd: Ymap.
Піксель прызначэння ў пазіцыі (X, Y) будзе абраны з пазіцыі крыніцы (x, y), дзе x = Xmap(X, Y) і y = Ymap(X, Y). Калі значэнні адлюстравання выходзяць за межы дыяпазону, для пікселя прызначэння будзе выкарыстоўвацца нулявое значэнне для пікселя.
Уваходныя відэапатокі Xmap і Ymap павінны мець аднолькавы памер. Выхадны відэаструмень будзе мець памеры відэаструменю Xmap/Ymap. Уваходныя відэапатокі Xmap і Ymap маюць 32-бітны фармат плаваючага пікселя, аднаканальны.
interp
Укажыце інтэрпаляцыю, якая выкарыстоўваецца для перапрызначэння пікселяў. Дазволеныя значэнні
near
іlinear
. Значэнне па змаўчанні -linear
.fill
Укажыце колер неадпаведных пікселяў. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils . Колер па змаўчанні
black
.
12.14 roberts_opencl
Прымяніце аператар крыжа Робертса ( https://en.wikipedia.org/wiki/Roberts_cross ) для ўводу відэапатоку.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
0xf
, паводле якога апрацоўваюцца ўсе плоскасці.scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон
[0.0, 65535]
і значэнне па змаўчанні1.0
.delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон
[-65535, 65535]
і значэнне па змаўчанні0.0
.
12.14.1 Example
- Прымяніце крыжаваны аператар Робертса са шкалой 2 і дэльтай 10
-i INPUT -vf "hwupload, roberts_opencl=scale=2:delta=10, hwdownload" OUTPUT
12.15 sobel_opencl
Прымяніце аператар Sobel ( https://en.wikipedia.org/wiki/Sobel_operator ) для ўводу відэапатоку.
Фільтр прымае наступныя параметры:
planes
Усталюйце, якія плоскасці фільтраваць. Значэнне па змаўчанні
0xf
, паводле якога апрацоўваюцца ўсе плоскасці.scale
Задайце значэнне, якое будзе памнажацца на адфільтраваны вынік. Дыяпазон
[0.0, 65535]
і значэнне па змаўчанні1.0
.delta
Задайце значэнне, якое будзе дададзена да адфільтраванага выніку. Дыяпазон
[-65535, 65535]
і значэнне па змаўчанні0.0
.
12.15.1 Example
- Прымяніце аператар sobel са шкалой 2 і дэльтай 10
-i INPUT -vf "hwupload, sobel_opencl=scale=2:delta=10, hwdownload" OUTPUT
12.16 tonemap_opencl
Выканайце пераўтварэнне HDR(PQ/HLG) у SDR з танальным адлюстраваннем.
Ён прымае наступныя параметры:
tonemap
Укажыце аператар танальнага адлюстравання, які будзе выкарыстоўвацца. Тое самае, што і опцыя tonemap у tonemap .
param
Наладзьце алгарытм танальнага адлюстравання. тое самае, што параметр param у карце тонаў .
desat
Ужывайце дэсатурацыю для блікаў, якія перавышаюць гэты ўзровень яркасці. Чым вышэй параметр, тым больш інфармацыі аб колеры будзе захавана. Гэта налада дапамагае прадухіліць ненатуральна цьмяныя колеры для суперблікаў, замест гэтага (плаўна) ператвараючыся ў белыя. Гэта робіць выявы больш натуральнымі, за кошт памяншэння інфармацыі аб колерах, якія не ўваходзяць у дыяпазон.
Значэнне па змаўчанні роўна 0,5, і алгарытм тут крыху адрозніваецца ад карты тонаў працэсара ў цяперашняй версіі. Параметр 0.0 адключае гэты параметр.
threshold
Параметры алгарытму адлюстравання тонаў наладжваюцца для кожнай сцэны. І парог выкарыстоўваецца, каб вызначыць, змянілася сцэна ці не. Калі адлегласць паміж бягучай сярэдняй яркасцю кадра і бягучай сярэдняй яркасцю перавышае парогавае значэнне, мы пералічым сярэднюю і пікавую яркасць сцэны. Значэнне па змаўчанні - 0,2.
format
Укажыце фармат выхаднога пікселя.
У цяперашні час падтрымліваюцца наступныя фарматы:
p010
nv12
range, r
Усталюйце выхадны каляровы дыяпазон.
Магчымыя значэнні:
tv/mpeg
pc/jpeg
Па змаўчанні тое самае, што і ўвод.
primaries, p
Усталюйце асноўныя колеры вываду.
Магчымыя значэнні:
bt709
bt2020
Па змаўчанні тое самае, што і ўвод.
transfer, t
Усталюйце характарыстыкі выхаду перадачы.
Магчымыя значэнні:
bt709
bt2020
Па змаўчанні bt709.
matrix, m
Усталюйце выходную матрыцу каляровай прасторы.
Магчымыя значэнні:
bt709
bt2020
Па змаўчанні тое самае, што і ўвод.
12.16.1 Example
- Пераўтварыце відэа HDR(PQ/HLG) у фармат bt2020-transfer-characteristic p010 з дапамогай лінейнага аператара.
-i INPUT -vf "format=p010,hwupload,tonemap_opencl=t=bt2020:tonemap=linear:format=p010,hwdownload,format=p010" OUTPUT
12.17 unsharp_opencl
Павышэнне рэзкасці або размыццё ўваходнага відэа.
Ён прымае наступныя параметры:
luma_msize_x, lx
Усталюйце гарызантальны памер матрыцы яркасці. Дыяпазон
[1, 23]
і значэнне па змаўчанні5
.luma_msize_y, ly
Усталюйце вертыкальны памер матрыцы яркасці. Дыяпазон
[1, 23]
і значэнне па змаўчанні5
.luma_amount, la
Усталюйце сілу эфекту яркасці. Дыяпазон
[-10, 10]
і значэнне па змаўчанні1.0
.Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.
chroma_msize_x, cx
Усталюйце гарызантальны памер матрыцы каляровасці. Дыяпазон
[1, 23]
і значэнне па змаўчанні5
.chroma_msize_y, cy
Усталюйце вертыкальны памер каляровай матрыцы. Дыяпазон
[1, 23]
і значэнне па змаўчанні5
.chroma_amount, ca
Усталюйце сілу каляровага эфекту. Дыяпазон
[-10, 10]
і значэнне па змаўчанні0.0
.Адмоўныя значэнні прывядуць да размыцця ўваходнага відэа, у той час як дадатныя значэнні павялічаць яго, нулявое значэнне адключыць эфект.
Усе параметры неабавязковыя і па змаўчанні адносяцца да радка "5:5:1.0:5:5:0.0".
12.17.1 Examples
- Ужыць моцны эфект павышэння яркасці:
-i INPUT -vf "hwupload, unsharp_opencl=luma_msize_x=7:luma_msize_y=7:luma_amount=2.5, hwdownload" OUTPUT
- Прымяніце моцнае размыццё параметраў яркасці і каляровасці:
-i INPUT -vf "hwupload, unsharp_opencl=7:7:-2:7:7:-2, hwdownload" OUTPUT
12.18 xfade_opencl
Перакрыжаванае знікненне двух відэа з карыстацкім эфектам пераходу з дапамогай OpenCL.
Ён прымае наступныя варыянты:
transition
Усталюйце адзін з магчымых эфектаў пераходу.
custom
Выберыце карыстальніцкі эфект пераходу, фактычнае апісанне пераходу будзе выбрана з параметраў зыходнага кода і ядра.
fade
wipeleft
wiperight
wipeup
wipedown
slideleft
slideright
slideup
slidedown
-
Пераход па змаўчанні - знікненне.
source
Зыходны файл праграмы OpenCL для карыстацкага пераходу.
kernel
Усталюйце назву ядра для карыстальніцкага пераходу з зыходнага файла праграмы.
duration
Задаць працягласць пераходу відэа.
offset
Усталюйце час пачатку пераходу адносна першага відэа.
Зыходны файл праграмы павінен утрымліваць функцыю ядра з дадзеным імем, якая будзе запускацца адзін раз для кожнай плоскасці вываду. Кожны запуск на плоскасці ставіцца ў чаргу як асобны 2D глабальны NDRange з адным працоўным элементам для кожнага пікселя, які будзе згенераваны. Такім чынам, глабальнае зрушэнне ідэнтыфікатара для кожнага працоўнага элемента - гэта каардынаты пікселя ў малюнку прызначэння.
Функцыя ядра павінна прымаць наступныя аргументы:
- Выява пункта прызначэння
__write_only image2d_t
,.Гэта выява стане выхадам; ядро павінна запісаць усё гэта.
- Першая зыходная выява
__read_only image2d_t
,. Другая зыходная выява__read_only image2d_t
,.Гэта самыя свежыя выявы для кожнага ўваходу. Ядро можа чытаць з іх для стварэння вываду, але ў іх нельга запісваць.
- Прагрэс пераходу
float
,. Гэта значэнне заўсёды ад 0 да 1 уключна.
Прыклады праграм:
- Прымяніць эфект пераходу кропкавай заслоны:
__kernel void blend_images(__write_only image2d_t dst, __read_only image2d_t src1, __read_only image2d_t src2, паплавок прагрэс) { const sampler_t sampler = (CLK_NORMALIZED_COORDS_FALSE | CLK_FILTER_LINEAR); int2 p = (int2)(get_global_id(0), get_global_id(1)); float2 rp = (float2)(get_global_id(0), get_global_id(1)); float2 dim = (float2)(get_image_dim(src1).x, get_image_dim(src1).y); rp = rp / цьмяны; float2 кропкі = (float2)(20.0, 20.0); float2 цэнтр = (float2)(0,0); float2 не выкарыстоўваецца; float4 val1 = read_imagef(src1, сэмплер, p); float4 val2 = read_imagef(src2, сэмплер, p); bool next = distance(fract(rp * dots, &unused), (float2)(0.5, 0.5)) < (прагрэс / адлегласць(rp, цэнтр)); write_imagef(dst, p, наступны? val1 : val2); }
13 VAAPI Video Filters
Відэафільтры VAAPI звычайна выкарыстоўваюцца з дэкодэрам VAAPI і кадавальнікам VAAPI. Ніжэй прыводзіцца апісанне відэафільтраў VAAPI.
Каб уключыць кампіляцыю гэтых фільтраў, трэба наладзіць FFmpeg з дапамогай
--enable-vaapi
.
Каб выкарыстоўваць фільтры vaapi, неабходна правільна наладзіць прыладу vaapi. Для атрымання дадатковай інфармацыі, калі ласка, прачытайце https://trac.ffmpeg.org/wiki/Hardware/VAAPI
13.1 overlay_vaapi
Накласці адно відэа на другое.
Ён прымае два ўваходы і мае адзін выхад. Першы ўваход - гэта "асноўнае" відэа, на якое накладваецца другі ўваход. Гэты фільтр патрабуе аднолькавага размяшчэння памяці для ўсіх уваходаў. Такім чынам, можа спатрэбіцца пераўтварэнне фармату.
Фільтр прымае наступныя параметры:
x
Усталюйце каардынату x накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні -
0
.y
Усталюйце каардынату y накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні -
0
.w
Усталюйце шырыню накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - гэта шырыня ўваходнага накладнога відэа.
h
Усталюйце вышыню накладзенага відэа на асноўнае відэа. Значэнне па змаўчанні - гэта вышыня ўваходнага накладання відэа.
alpha
Усталюйце парогі выяўлення блакіроўкі. Дазволены дыяпазон ад 0,0 да 1,0, патрабуецца ўваходнае відэа з альфа-каналам. Значэнне па змаўчанні -
0.0
.
13.1.1 Examples
- Накласці выяву LOGO ў верхнім левым куце INPUT відэа. Абодва ўваходы для гэтага фільтра маюць фармат yuv420p.
-i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuv420p, hwupload[b], [a][b]overlay_vaapi" OUTPUT
- Накласці выяву LOGO са зрушэннем (200, 100) ад верхняга левага кута INPUT відэа. Уваходы маюць аднолькавы макет памяці для каляровых каналаў, накладанне мае дадатковую альфа-плоскасць, напрыклад, INPUT - yuv420p, а LOGO - yuva420p.
-i INPUT -i LOGO -filter_complex "[0:v]hwupload[a], [1:v]format=yuva420p, hwupload[b], [a][b]overlay_vaapi=x=200:y=100:w=400:h=300:alpha=1.0, hwdownload, format=nv12" OUTPUT
13.2 tonemap_vaapi
Выканайце пераўтварэнне HDR (Шырокі дынамічны дыяпазон) у SDR (Стандартны дынамічны дыяпазон) з тонавым адлюстраваннем. Ён супастаўляе дынамічны дыяпазон кантэнту HDR10 з кантэнтам SDR. У цяперашні час ён прымае толькі HDR10 у якасці ўводу.
Ён прымае наступныя параметры:
format
Укажыце фармат выхаднога пікселя.
У цяперашні час падтрымліваюцца наступныя фарматы:
p010
nv12
Па змаўчанні - nv12.
primaries, p
Усталюйце асноўныя колеры вываду.
Па змаўчанні тое самае, што і ўвод.
transfer, t
Усталюйце характарыстыкі выхаду перадачы.
Па змаўчанні bt709.
matrix, m
Усталюйце выходную матрыцу каляровай прасторы.
Па змаўчанні тое самае, што і ўвод.
13.2.1 Example
- Пераўтварэнне відэа HDR(HDR10) у фармат bt2020-transfer-characteristic p010
tonemap_vaapi=format=p010:t=bt2020-10
14 Video Sources
Ніжэй прыводзіцца апісанне даступных на дадзены момант крыніц відэа.
14.1 buffer
Буферызаваць відэакадры і зрабіць іх даступнымі для ланцужка фільтраў.
Гэтая крыніца ў асноўным прызначана для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersrc.h
.
Ён прымае наступныя параметры:
video_size
Укажыце памер (шырыню і вышыню) буферызаваных відэакадраў. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
width
Шырыня ўваходнага відэа.
height
Вышыня ўваходнага відэа.
pix_fmt
Радок, які прадстаўляе фармат пікселяў буферызаваных відэакадраў. Гэта можа быць лічба, якая адпавядае піксельнаму фармату, або назва піксельнага фармату.
time_base
Укажыце часовую базу, якую мяркуюць пазнакі часу буферызаваных кадраў.
frame_rate
Укажыце чаканую частату кадраў для відэаструменю.
pixel_aspect, sar
Суадносіны бакоў выбаркі (пікселяў) уваходнага відэа.
sws_param
Гэты параметр састарэў і ігнаруецца. Дадайце да апісання фільтра, каб вызначыць сцягі swscale для аўтаматычна ўстаўленых маштабіроўшчыкаў. Глядзіце сінтаксіс Filtergraph .
sws_flags=
flags
;hw_frames_ctx
Пры выкарыстанні апаратнага піксельнага фармату гэта павінна быць спасылка на AVHWFramesContext, які апісвае ўваходныя кадры.
Напрыклад:
buffer=width=320:height=240:pix_fmt=yuv410p:time_base=1/24:sar=1
будзе інструктаваць крыніцу прымаць відэакадры памерам 320x240 і фарматам "yuv410p", пры ўмове, што 1/24 у якасці метак часу разгорткі і квадратных пікселяў (суадносіны бакоў узору 1:1). Паколькі піксельны фармат з назвай "yuv410p" адпавядае лічбе 6 (праверце вызначэнне пераліку AVPixelFormat уlibavutil/pixfmt.h
), гэты прыклад адпавядае:
buffer=size=320x240:pixfmt=6:time_base=1/24:pixel_aspect=1/1
У якасці альтэрнатывы параметры можна задаць як просты радок, але гэты сінтаксіс састарэў:
width
: height
: pix_fmt
: time_base.num
: time_base.den
: pixel_aspect.num
:pixel_aspect.den
14.2 cellauto
Стварыце шаблон, згенераваны элементарным клеткавым аўтаматам.
Пачатковы стан клетачнага аўтамата можна вызначыць праз
filename
іpattern
опцыі. Калі такія параметры не вызначаны, пачатковы стан ствараецца выпадковым чынам.
У кожным новым кадры новы радок у відэа запаўняецца вынікам клетачнага аўтамата наступнага пакалення. Паводзіны, калі ўвесь кадр запоўнены, вызначаеццаscroll
варыянт.
Гэтая крыніца прымае наступныя параметры:
filename, f
Счытванне пачатковага стану клетачнага аўтамата, г.зн. пачатковага радка, з названага файла. У файле кожны сімвал без прабелаў лічыцца жывой ячэйкай, новы радок заканчвае радок, а далейшыя сімвалы ў файле будуць ігнаравацца.
pattern, p
Счытванне пачатковага стану клеткавага аўтамата, г.зн. пачатковага радка, з названага радка.
Кожны сімвал у радку, які не з'яўляецца прабелам, лічыцца жывой ячэйкай, новы радок завяршае радок, а далейшыя сімвалы ў радку будуць ігнаравацца.
rate, r
Усталюйце частату відэа, гэта значыць колькасць кадраў, якія ствараюцца ў секунду. Па змаўчанні 25.
random_fill_ratio, ratio
Усталюйце выпадковы каэфіцыент запаўнення для пачатковага радка клеткавага аўтамата. Гэта лік з плаваючай коскай у дыяпазоне ад 0 да 1, па змаўчанні 1/PHI.
Гэты параметр ігнаруецца, калі ўказаны файл або шаблон.
random_seed, seed
Усталюйце пачатковае значэнне для выпадковага запаўнення пачатковага радка, яно павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.
rule
Усталюйце правіла сотавага аўтамата, гэта лік у дыяпазоне ад 0 да 255. Значэнне па змаўчанні - 110.
size, s
Усталюйце памер выхаднога відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
Калі
filename
абоpattern
зададзены, памер па змаўчанні ўсталёўваецца на шырыню вызначанага радка пачатковага стану, а вышыня - наwidth
* PHI.Калі
size
усталяваны, ён павінен змяшчаць шырыню ўказанага радка шаблону, і ўказаны шаблон будзе знаходзіцца па цэнтры ў большым радку.Калі імя файла або радок шаблону не ўказаны, значэнне памеру па змаўчанні роўна "320x518" (выкарыстоўваецца для выпадкова згенераванага пачатковага стану).
scroll
Калі ўстаноўлена значэнне 1, пракручваць вывад уверх, калі ўсе радкі вываду ўжо запоўнены. Калі ўсталявана 0, новы згенераваны радок будзе запісаны над верхнім радком адразу пасля запаўнення ніжняга радка. Па змаўчанні 1.
start_full, full
Калі ўстаноўлена ў 1, цалкам запоўніць вывад згенераванымі радкамі перад вывадам першага кадра. Гэта паводзіны па змаўчанні, для адключэння ўсталюйце значэнне 0.
stitch
Калі ўстаноўлена значэнне 1, сшыйце левы і правы краю шэрагу. Гэта паводзіны па змаўчанні, для адключэння ўсталюйце значэнне 0.
14.2.1 Examples
- Прачытайце пачатковы стан з
pattern
, і ўкажыце памер вываду 200x400.cellauto=f=pattern:s=200x400
- Стварыце выпадковы пачатковы радок шырынёй 200 вочак з каэфіцыентам запаўнення 2/3:
cellauto=ratio=2/3:s=200x200
- Стварыце ўзор, згенераваны правілам 18, пачынаючы з адной жывой ячэйкі з цэнтрам у пачатковым радку шырынёй 100:
cellauto=p=@:s=100x400:full=0:rule=18
- Укажыце больш складаны пачатковы ўзор:
cellauto=p='@@ @ @@':s=100x400:full=0:rule=18
14.3 coreimagesrc
Крыніца відэа, створаная на графічным працэсары з выкарыстаннем Apple CoreImage API на OSX.
Гэтая крыніца відэа з'яўляецца спецыялізаванай версіяй відэафільтра coreimage . Выкарыстоўвайце асноўны генератар выявы ў пачатку прымененага ланцужка фільтраў для стварэння кантэнту.
Крыніца відэа coreimagesrc прымае наступныя параметры:
list_generators
Пералічыце ўсе даступныя генератары разам з усімі іх адпаведнымі параметрамі, а таксама магчымыя мінімальныя і максімальныя значэнні разам са значэннямі па змаўчанні.
list_generators=true
size, s
Укажыце памер зыходнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
320x240
.rate, r
Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце
frame_rate_num
/frame_rate_den
, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".sar
Усталюйце прыклад суадносін бакоў атрыманага відэа.
duration, d
Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.
Акрамя таго, прымаюцца ўсе параметры відэафільтра coreimage . Поўную ланцужок фільтраў можна выкарыстоўваць для далейшай апрацоўкі згенераванага ўводу без перадачы CPU-HOST. Падрабязнасці глядзіце ў дакументацыі і прыкладах coreimage .
14.3.1 Examples
- Скарыстайцеся CIQRCodeGenerator, каб стварыць QR-код для галоўнай старонкі FFmpeg, зададзены ў выглядзе поўнага і экранаванага каманднага радка для стандартнай абалонкі bash ад Apple:
ffmpeg -f lavfi -i coreimagesrc=s=100x100:filter=CIQRCodeGenerator@inputMessage=https\\\\\://FFmpeg.org/@inputCorrectionLevel=H -frames:v 1 QRCode.png
Гэты прыклад эквівалентны прыкладу QRCode для coreimage без неабходнасці крыніцы відэа nullsrc.
14.4 gradients
Стварыце некалькі градыентаў.
size, s
Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".
rate, r
Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".
c0, c1, c2, c3, c4, c5, c6, c7
Набор 8 колераў. Значэнні па змаўчанні для колераў выбіраюцца выпадковым чынам.
x0, y0, y0, y1
Усталюйце зыходную і пункты прызначэння лініі градыенту. Калі адмоўны або па-за дыяпазонам, выбіраюцца выпадковыя.
nb_colors, n
Усталюйце колькасць колераў для адначасовага выкарыстання. Дазволены дыяпазон ад 2 да 8. Значэнне па змаўчанні - 2.
seed
Задайце пачатковы пункт для выбару кропак лініі градыенту.
duration, d
Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.
speed
Задаць хуткасць кручэння градыентаў.
type, t
Задаць тып градыентаў, можа быць
linear
абоradial
абоcircular
абоspiral
.
14.5 mandelbrot
Стварыце фрактал мноства Мандэльброта і паступова набліжайце да кропкі, вызначанай кнопкамі start_x
і start_y
.
Гэтая крыніца прымае наступныя параметры:
end_pts
Усталюйце значэнне тэрмінальных балаў. Значэнне па змаўчанні - 400.
end_scale
Усталюйце значэнне шкалы тэрмінала. Павінна быць значэнне з плаваючай коскай. Значэнне па змаўчанні 0,3.
inner
Усталюйце рэжым унутранай афарбоўкі, гэта значыць алгарытм, які выкарыстоўваецца для малявання ўнутранай вобласці фрактала Мандэльброта.
Ён прымае адно з наступных значэнняў:
black
Усталюйце чорны рэжым.
convergence
Паказаць час да збліжэння.
mincol
Усталюйце колер на аснове пункту, бліжэйшага да пачатку ітэрацый.
period
Усталяваць рэжым перыяду.
Значэнне па змаўчанні -
mincol
.bailout
Усталюйце значэнне выратавання. Значэнне па змаўчанні 10.0.
maxiter
Усталюйце максімальную колькасць ітэрацый, выкананых алгарытмам візуалізацыі. Значэнне па змаўчанні - 7189.
outer
Усталюйце рэжым знешняй афарбоўкі. Ён прымае адно з наступных значэнняў:
iteration_count
Усталюйце рэжым падліку ітэрацый.
normalized_iteration_count
ўсталяваць нармалізаваны рэжым падліку ітэрацый.
Значэнне па змаўчанні -
normalized_iteration_count
.rate, r
Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".
size, s
Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".
start_scale
Усталюйце пачатковае значэнне маштабу. Значэнне па змаўчанні 3.0.
start_x
Усталюйце пачатковую пазіцыю x. Павінна быць значэнне з плаваючай коскай ад -100 да 100. Значэнне па змаўчанні - -0,743643887037158704752191506114774.
start_y
Усталюйце пачатковае становішча y. Павінна быць значэнне з плаваючай коскай ад -100 да 100. Значэнне па змаўчанні - -0,131825904205311970493132056385139.
14.6 mptestsrc
Стварэнне розных тэставых шаблонаў, якія ствараюцца тэставым фільтрам MPlayer.
Памер створанага відэа фіксаваны і складае 256x256. Гэтая крыніца карысная, у прыватнасці, для тэставання функцый кадавання.
Гэтая крыніца прымае наступныя параметры:
rate, r
Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце
frame_rate_num
/frame_rate_den
, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".duration, d
Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.
test, t
-
Усталюйце нумар або назву тэсту для выканання. Падтрымліваюцца наступныя тэсты:
dc_luma
dc_chroma
freq_luma
freq_chroma
amp_luma
amp_chroma
cbp
mv
ring1
ring2
all
max_frames, m
Усталюйце максімальную колькасць кадраў, згенераваных для кожнага тэсту, значэнне па змаўчанні роўна 30.
Значэнне па змаўчанні - "усе", якое будзе цыклічна перабіраць спіс усіх тэстаў.
Некаторыя прыклады:
mptestsrc=t=dc_luma
створыць тэставы шаблон "dc_luma".
14.7 frei0r_src
Дайце крыніцу frei0r.
Каб уключыць кампіляцыю гэтага фільтра, трэба ўсталяваць загаловак frei0r і наладзіць FFmpeg з дапамогай --enable-frei0r
.
Гэтая крыніца прымае наступныя параметры:
size
Памер відэа для стварэння. Сінтаксіс гэтай опцыі праверце (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
framerate
Частата кадраў створанага відэа. Гэта можа быць радок формы
num
/den
або абрэвіятура частоты кадраў.filter_name
Імя крыніцы frei0r для загрузкі. Для атрымання дадатковай інфармацыі аб frei0r і аб тым, як усталяваць параметры, прачытайце раздзел frei0r у дакументацыі відэафільтраў.
filter_params
Падзелены '|' спіс параметраў для перадачы ў крыніцу frei0r.
Напрыклад, каб стварыць крыніцу frei0r partik0l памерам 200x200 і частатой кадраў 10, якая накладваецца на асноўны ўваход фільтра накладання:
frei0r_src=size=200x200:framerate=10:filter_name=partik0l:filter_params=1234 [overlay]; [in][overlay] overlay
14.8 life
Стварыце ўзор жыцця.
Гэтая крыніца заснавана на абагульненні жыццёвай гульні Джона Конвея.
Уваход з крыніцы ўяўляе сабой сетку жыцця, кожны піксель уяўляе сабой клетку, якая можа знаходзіцца ў адным з двух магчымых станаў: жывая або мёртвая. Кожная ячэйка ўзаемадзейнічае са сваімі васьмю суседзямі, якія з'яўляюцца клеткамі, якія знаходзяцца побач па гарызанталі, вертыкалі або дыяганалі.
Пры кожным узаемадзеянні сетка развіваецца ў адпаведнасці з прынятым правілам, якое вызначае колькасць суседніх жывых клетак, якія прымусяць клетку застацца ў жывых або нарадзіцца. Therule
опцыя дазваляе вызначыць правіла, якое трэба прыняць.
Гэтая крыніца прымае наступныя параметры:
filename, f
Усталюйце файл, з якога будзе счытвацца пачатковы стан сеткі. У файле кожны сімвал без прабелаў лічыцца жывой ячэйкай, а сімвал новага радка выкарыстоўваецца для размежавання канца кожнага радка.
Калі гэты параметр не пазначаны, пачатковая сетка генеруецца выпадковым чынам.
rate, r
Усталюйце частату відэа, гэта значыць колькасць кадраў, якія ствараюцца ў секунду. Па змаўчанні 25.
random_fill_ratio, ratio
Усталюйце выпадковы каэфіцыент запаўнення для пачатковай выпадковай сеткі. Гэта лік з плаваючай коскай у дыяпазоне ад 0 да 1, па змаўчанні 1/PHI. Ён ігнаруецца, калі пазначаны файл.
random_seed, seed
Усталюйце пачатковую базу для запаўнення пачатковай выпадковай сеткі, яна павінна быць цэлым лікам ад 0 да UINT32_MAX. Калі не пазначана або відавочна ўстаноўлена на -1, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.
rule
Усталюйце правіла жыцця.
Правіла можа быць вызначана кодам тыпу "S
NS
/ BNB
", дзеNS
іNB
- паслядоўнасці лікаў у дыяпазоне 0-8,NS
вызначае колькасць жывых суседніх клетак, якія прымушаюць жывую клетку заставацца жывой, іNB
колькасць жывых суседнія клеткі, якія прымушаюць мёртвую клетку ажываць (г.зн. «нараджацца»). "s" і "b" могуць выкарыстоўвацца замест "S" і "B" адпаведна.У якасці альтэрнатывы правіла можа быць вызначана 18-бітным цэлым лікам. 9 старэйшых біт выкарыстоўваюцца для кадавання наступнага стану клеткі, калі яна жывая для кожнай колькасці суседніх жывых клетак, малодшыя біты вызначаюць правіла для "нараджэння" новых клетак. Біты больш высокага парадку кадуюць большую колькасць суседніх вочак. Напрыклад, лік 6153 =
(12<<9)+9
вызначае правіла застацца ў жывых 12 і правіла нараджэння 9, што адпавядае "S23/B03".Значэнне па змаўчанні - "S23/B3", якое з'яўляецца арыгінальным правілам гульні ў жыццё Конвея, якое будзе падтрымліваць клетку ў жывых, калі ў ёй ёсць 2 ці 3 жывыя клеткі, і ствараць новую клетку, калі вакол мёртвай ёсць тры жывыя клеткі. вочка.
size, s
Усталюйце памер выхаднога відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils .
Калі
filename
зададзены, памер па змаўчанні задаецца такім жа памерам, як і ўваходны файл. Каліsize
усталяваны, ён павінен утрымліваць памер, указаны ва ўваходным файле, і першапачатковая сетка, вызначаная ў гэтым файле, знаходзіцца па цэнтры ў большай выніковай вобласці.Калі імя файла не пазначана, значэнне памеру па змаўчанні роўна "320x240" (выкарыстоўваецца для выпадкова згенераванай пачатковай сеткі).
stitch
Калі ўстаноўлена значэнне 1, сшыйце разам левы і правы краю сеткі, а таксама верхні і ніжні краю. Па змаўчанні 1.
mold
Усталюйце хуткасць формы для ячэек. Калі ўстаноўлена, мёртвая клетка будзе выходзіць з
death_color
кабmold_color
з крокамmold
.mold
можа мець значэнне ад 0 да 255.life_color
Устанавіць колер жывых (або нованароджаных) клетак.
death_color
Усталюйце колер мёртвых клетак. Калі
mold
усталяваны, гэта першы колер, які выкарыстоўваецца для адлюстравання мёртвай клеткі.mold_color
Усталюйце колер цвілі для дакладна мёртвых і заплесневелых клетак.
Каб даведацца пра сінтаксіс гэтых 3 варыянтаў колеру, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .
14.8.1 Examples
- Чытаць сетку з
pattern
, і адцэнтруйце яго ў сетцы памерам 300x300 пікселяў:life=f=pattern:s=300x300
- Стварыце выпадковую сетку памерам 200x200 з каэфіцыентам запаўнення 2/3:
life=ratio=2/3:s=200x200
- Укажыце карыстальніцкае правіла для развіцця выпадкова згенераванай сеткі:
life=rule=S14/B34
- Поўны прыклад з эфектам павольнай смерці (цвіль) з выкарыстаннем
ffplay
:ffplay -f lavfi life=s=300x200:mold=10:r=60:ratio=0.1:death_color=#C83232:life_color=#00ff00,scale=1200:800:flags=16
14.9 allrgb, allyuv, color, colorchart, colorspectrum, haldclutsrc, nullsrc, pal75bars, pal100bars, rgbtestsrc, smptebars, smptehdbars, testsrc, testsrc2, yuvtestsrc
Крыніца allrgb
вяртае кадры памерам 4096x4096 усіх колераў rgb.
Крыніца allyuv
вяртае кадры памерам 4096x4096 усіх колераў yuv.
Крыніца color
забяспечвае аднолькава афарбаваны ўвод.
Крыніца colorchart
дае дыяграму праверкі колераў.
Крыніца colorspectrum
забяспечвае ўвод каляровага спектру.
Крыніца haldclutsrc
забяспечвае асобу Hald CLUT. Глядзіце таксама
фільтр haldclut .
Крыніца nullsrc
вяртае неапрацаваныя відэакадры. Гэта ў асноўным карысна для выкарыстання ў інструментах аналізу/адладкі або ў якасці крыніцы для фільтраў, якія ігнаруюць ўваходныя даныя.
Крыніца pal75bars
стварае шаблон каляровых палос на аснове рэкамендацый EBU PAL з узроўнем колеру 75%.
Крыніца pal100bars
стварае ўзор каляровых палос на аснове рэкамендацый EBU PAL са 100% узроўнем колеру.
Крыніца rgbtestsrc
стварае тэставы ўзор RGB, карысны для выяўлення праблем з RGB і BGR. Вы павінны ўбачыць чырвоную, зялёную і сінюю паласы зверху ўніз.
Крыніца smptebars
стварае ўзор каляровых палос на аснове інжынерных рэкамендацый SMPTE EG 1-1990.
Крыніца smptehdbars
стварае шаблон каляровых палос на аснове SMPTE RP 219-2002.
Крыніца testsrc
стварае шаблон тэставага відэа, які паказвае каляровы ўзор, градыент пракруткі і метку часу. У асноўным гэта прызначана для тэставання.
Зыходны testsrc2
код падобны на testsrc, але падтрымлівае больш піксельных фарматаў, а не проста rgb24
. Гэта дазваляе выкарыстоўваць яго ў якасці ўваходных дадзеных для іншых тэстаў без неабходнасці пераўтварэння фармату.
Крыніца yuvtestsrc
генеруе тэставы шаблон YUV. Вы павінны ўбачыць палосы ay, cb і cr зверху ўніз.
Крыніцы прымаюць наступныя параметры:
level
Пакажыце ўзровень Hald CLUT, даступны толькі ў
haldclutsrc
крыніцы. УзровеньN
генеруе выяву зN*N*N
пікселяўN*N*N
для выкарыстання ў якасці ідэнтыфікацыйнай матрыцы для трохмерных табліц пошуку. Кожны кампанент кадуецца па1/(N*N)
шкале.color, c
Пакажыце колер крыніцы, даступны толькі ў
color
крыніцы. Каб даведацца пра сінтаксіс гэтай опцыі, праверце раздзел (ffmpeg-utils)"Колер" у кіраўніцтве ffmpeg-utils .size, s
Укажыце памер зыходнага відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
320x240
.Гэтая опцыя недаступная з фільтрамі
allrgb
,allyuv
, і .haldclutsrc
rate, r
Укажыце частату кадраў атрыманага відэа як колькасць кадраў, якія ствараюцца ў секунду. Гэта павінен быць радок у фармаце
frame_rate_num
/frame_rate_den
, цэлы лік, лік з плаваючай коскай або сапраўднае скарачэнне частаты кадраў відэа. Значэнне па змаўчанні - "25".duration, d
Усталюйце працягласць атрыманага відэа. Прыняты сінтаксіс глядзіце ў раздзеле (ffmpeg-utils) у раздзеле «Працягласць часу» ў кіраўніцтве ffmpeg-utils(1) .
Калі не пазначана або выяўленая працягласць адмоўная, мяркуецца, што відэа ствараецца вечна.
Паколькі частата кадраў выкарыстоўваецца ў якасці часовай базы, усе кадры, уключаючы апошні, будуць мець поўную працягласць. Калі ўказаная працягласць не кратная працягласці кадра, яна будзе акруглена ў большы бок.
sar
Усталюйце прыклад суадносін бакоў атрыманага відэа.
alpha
Укажыце альфа (непразрыстасць) фону, даступны толькі ў
testsrc2
зыходным коды. Значэнне павінна быць ад 0 (цалкам празрысты) да 255 (цалкам непразрысты, стандартнае).decimals, n
Усталюйце колькасць знакаў пасля коскі для паказу ў пазнацы часу, даступна толькі ў
testsrc
крыніцы.Адлюстраванае значэнне меткі часу будзе адпавядаць зыходнаму значэнню меткі часу, памножанаму на ступень 10 вызначанага значэння. Значэнне па змаўчанні 0.
type
Усталюйце тып каляровага спектру, даступны толькі ў
colorspectrum
крыніцы. Можа быць адно з наступнага:- '
black
' - '
white
' - '
all
'
- '
patch_size
Усталюйце памер плямы аднаго колеру, даступны толькі ў
colorchart
крыніцы. Па змаўчанні64x64
.preset
Усталюйце прадусталяваныя колеры Colorchecker, даступныя толькі ў
colorchart
крыніцы.Даступныя значэнні:
- '
reference
' - '
skintones
'
Значэнне па змаўчанні -
reference
.- '
14.9.1 Examples
- Стварыце відэа працягласцю 5,3 секунды, памерам 176x144 і частатой кадраў 10 кадраў у секунду:
testsrc=duration=5.3:size=qcif:rate=10
- У наступным апісанні графіка будзе створана чырвоная крыніца з непразрыстасцю 0,2, памерам "qcif" і частатой кадраў 10 кадраў у секунду:
color=c=red@0.2:s=qcif:r=10
- Калі змесціва ўводу трэба ігнараваць,
nullsrc
можна выкарыстоўваць. Наступная каманда стварае шум у плоскасці яркасці, выкарыстоўваючыgeq
фільтр:nullsrc=s=256x256, geq=random(1)*255:128:128
14.9.2 Commands
Крыніца color
падтрымлівае наступныя каманды:
c, color
Задайце колер створанага малюнка. Прымае той жа сінтаксіс адпаведнага
color
варыянт.
14.10 openclsrc
Стварэнне відэа з дапамогай праграмы OpenCL.
source
Зыходны файл праграмы OpenCL.
kernel
Імя ядра ў праграме.
size, s
Памер кадраў для стварэння. Гэта трэба ўсталяваць.
format
Піксельны фармат для стварэння кадраў. Гэта трэба ўсталяваць.
rate, r
Колькасць кадраў, якія ствараюцца кожную секунду. Значэнне па змаўчанні '25'.
Для атрымання падрабязнай інфармацыі аб тым, як працуе загрузка праграмы, глядзіце фільтр program_opencl .
Прыклады праграм:
- Стварыце змяненне колеру, усталяваўшы значэнні пікселяў з пазіцыі пікселя на выходным малюнку. (Звярніце ўвагу, што гэта будзе працаваць з усімі фарматамі пікселяў, але згенераваны вынік не будзе аднолькавым.)
__ядро несапраўднай рампы (__write_only image2d_t dst, unsigned int index) { int2 loc = (int2)(get_global_id(0), get_global_id(1)); float4 val; val.xy = val.zw = convert_float2(loc) / convert_float2(get_image_dim(dst)); write_imagef(dst, loc, val); }
- Стварыце ўзор дывана Серпінскага, перамяшчаючы кожны кадр на адзін піксель.
__kernel void siepinski_carpet(__write_only image2d_t dst, unsigned int index) { int2 loc = (int2)(get_global_id(0), get_global_id(1)); значэнне float4 = 0.0f; int x = loc.x + індэкс; int y = loc.y + індэкс; у той час як (x > 0 || y > 0) { if (x % 3 == 1 && y % 3 == 1) { значэнне = 1.0f; разбіваць; } х /= 3; у /= 3; } write_imagef(dst, loc, value); }
14.11 sierpinski
Стварыце фрактал дывана/трохвугольніка Серпінскага і выпадкова панаруйце.
Гэтая крыніца прымае наступныя параметры:
size, s
Усталюйце памер рамкі. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні - "640x480".
rate, r
Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".
seed
Усталюйце пачатковы код, які выкарыстоўваецца для выпадковага панарамавання.
jump
Усталюйце максімальны скачок для адной кропкі прызначэння. Дазволены дыяпазон ад 1 да 10000.
type
Усталюйце тып фрактала, можа быць па змаўчанні
carpet
абоtriangle
.
15 Video Sinks
Ніжэй прыводзіцца апісанне даступных на дадзены момант відэапрыёмнікаў.
15.1 buffersink
Буферызаваць відэакадры і зрабіць іх даступнымі ў канцы графіка фільтра.
Гэты прыёмнік у асноўным прызначаны для праграмнага выкарыстання, у прыватнасці праз інтэрфейс, вызначаны ўlibavfilter/buffersink.h
або сістэма опцый.
Ён прымае паказальнік на структуру AVBufferSinkContext, якая вызначае фарматы ўваходных буфераў, які перадаецца ў якасці непразрыстага параметра avfilter_init_filter
для ініцыялізацыі.
15.2 nullsink
Нулявы прыём відэа: не рабіць абсалютна нічога з уваходным відэа. Ён галоўным чынам карысны як шаблон і для выкарыстання ў інструментах аналізу/адладкі.
16 Multimedia Filters
Ніжэй прыводзіцца апісанне даступных на дадзены момант мультымедыйных фільтраў.
16.1 abitscope
Пераўтварэнне ўваходнага аўдыя ў відэавыхад з адлюстраваннем разраднасці гуку.
Фільтр прымае наступныя параметры:
rate, r
Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
1024x256
.colors
Укажыце спіс колераў, падзеленых прабелам або знакам '|' які будзе выкарыстоўвацца для малявання каналаў. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.
mode, m
Задаць рэжым вываду. Можа быць
bars
абоtrace
. Па змаўчанніbars
.
16.2 adrawgraph
Намалюйце графік, выкарыстоўваючы метаданыя ўваходнага гуку.
Глядзіце малюнак
16.3 agraphmonitor
Глядзіце graphmonitor .
16.4 ahistogram
Пераўтварэнне ўваходнага аўдыё ў відэавыхад з адлюстраваннем гістаграмы гучнасці.
Фільтр прымае наступныя параметры:
dmode
Укажыце, як разлічваецца гістаграма.
Ён прымае наступныя значэнні:
- '
single
' Выкарыстоўвайце адну гістаграму для ўсіх каналаў.
- '
separate
' Выкарыстоўвайце асобную гістаграму для кожнага канала.
Па змаўчанні
single
.- '
rate, r
Задаць частату кадраў, выражаную ў колькасці кадраў у секунду. Значэнне па змаўчанні - "25".
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
hd720
.scale
Задаць маштаб адлюстравання.
Ён прымае наступныя значэнні:
- '
log
' лагарыфмічны
- '
sqrt
' квадратны корань
- '
cbrt
' кубічны корань
- '
lin
' лінейны
- '
rlog
' зваротная лагарыфмічная
Па змаўчанні
log
.- '
ascale
Усталюйце шкалу амплітуды.
Ён прымае наступныя значэнні:
- '
log
' лагарыфмічны
- '
lin
' лінейны
Па змаўчанні
log
.- '
acount
Усталюйце, колькі кадраў назапашваць у гістаграме. Па змаўчанні 1. Устаноўка -1 назапашвае ўсе кадры.
rheight
Задаць суадносіны вышыні акна гістаграмы.
slide
Ўстаноўка сонограммы слізгальная.
Ён прымае наступныя значэнні:
- '
replace
' замяніць старыя радкі новымі.
- '
scroll
' пракруціць зверху ўніз.
Па змаўчанні
replace
.- '
hmode
Ўсталяваць рэжым гістаграмы.
Ён прымае наступныя значэнні:
- '
abs
' Выкарыстоўвайце абсалютныя значэнні выбарак.
- '
sign
' Выкарыстоўвайце некранутыя значэння ўзораў.
Па змаўчанні
abs
.- '
16.5 aphasemeter
Вымярае фазу ўваходнага гуку, які экспартуецца ў выглядзе метададзеных lavfi.aphasemeter.phase
, якія прадстаўляюць сярэднюю фазу бягучага гукавога кадра. Відэавыхад таксама можа быць выраблены і ўключаны па змаўчанні. Гук перадаецца як першы выхад.
Аўдыя будзе ператворана ў стэрэа, калі яно мае іншую планіроўку каналаў. Значэнне фазы знаходзіцца ў дыяпазоне, [-1, 1]
дзе -1
азначае, што левы і правы каналы цалкам не сфазаваны, а 1
каналы знаходзяцца ў фазе.
Фільтр прымае наступныя параметры, усе звязаныя з яго відэавыхадам:
rate, r
Усталюйце выходную частату кадраў. Значэнне па змаўчанні -
25
.size, s
Усталюйце памер відэа для выхаду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
800x400
.rc
gc
bc
Укажыце чырвоны, зялёны, сіні кантраст. Значэнні па змаўчанні
2
:7
і1
. Дазволены дыяпазон[0, 255]
.mpc
Задайце колер, які будзе выкарыстоўвацца для малявання сярэдняй фазы. Калі колер
none
па змаўчанні, сярэдняе значэнне фазы намалявана не будзе.video
Уключыць выхад відэа. Па змаўчанні ўключана.
16.5.1 phasing detection
Фільтр таксама выяўляе не ў фазе і мона паслядоўнасці ў стэрэа патоках. Ён рэгіструе пачатак, канец і працягласць паслядоўнасці, калі яна доўжыцца даўжэй або да мінімальнага набору.
Фільтр прымае наступныя параметры для гэтага выяўлення:
phasing
Уключыце выяўленне мона і зрушэння фазы. Па змаўчанні адключана.
tolerance, t
Усталюйце фазавы допуск для выяўлення мона ў суадносінах амплітуд. Па змаўчанні
0
. Дазволены дыяпазон[0, 1]
.angle, a
Усталюйце парогавае значэнне вугла для выяўлення сыходу па фазе ў градусах. Па змаўчанні
170
. Дазволены дыяпазон[90, 180]
.duration, d
Усталюйце мона або нефазавую працягласць да паведамлення, выражаную ў секундах. Па змаўчанні
2
.
16.5.2 Examples
- Поўны прыклад з
ffmpeg
выяўленнем 1 секунды мона з допускам фазы 0,001:ffmpeg -i stereo.wav -af aphasemeter=video=0:phasing=1:duration=1:tolerance=0.001 -f null -
16.6 avectorscope
Пераўтварэнне ўваходнага аўдыя ў відэавыхад, які прадстаўляе вобласць аўдыявектара.
Фільтр выкарыстоўваецца для вымярэння розніцы паміж каналамі стэрэааўдыяпатоку. Манаўральны сігнал, які складаецца з аднолькавых левага і правага сігналаў, прыводзіць да прамой вертыкальнай лініі. Любы стэрэападзел бачны як адхіленне ад гэтай лініі, ствараючы фігуру Лісажу. Калі з'яўляецца прамая (або адхіленая ад яе), але гарызантальная лінія, гэта сведчыць аб тым, што левы і правы каналы не зрушаны па фазе.
Фільтр прымае наступныя параметры:
mode, m
Усталюйце рэжым вектороскопа.
Даступныя значэнні:
- '
lissajous
' Ліссажу павернуты на 45 градусаў.
- '
lissajous_xy
' Тое самае, што і вышэй, але без павароту.
- '
polar
' Па форме нагадвае палову круга.
Значэнне па змаўчанні '
lissajous
'.- '
size, s
Усталюйце памер відэа для выхаду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
400x400
.rate, r
Усталюйце выходную частату кадраў. Значэнне па змаўчанні -
25
.rc
gc
bc
ac
Укажыце чырвоны, зялёны, сіні і альфа-кантраст. Значэнні па змаўчанні :
40
, і . Дазволены дыяпазон .160
80
255
[0, 255]
rf
gf
bf
af
Укажыце чырвоны, зялёны, сіні і альфа-затуханне. Значэнні па змаўчанні :
15
, і . Дазволены дыяпазон .10
5
5
[0, 255]
zoom
Усталюйце каэфіцыент маштабавання. Значэнне па змаўчанні -
1
. Дазволены дыяпазон[0, 10]
. Значэнні, ніжэйшыя за1
, будуць аўтаматычна наладжваць каэфіцыент маштабавання да максімальна магчымага значэння.draw
Усталюйце рэжым малявання вектарскопа.
Даступныя значэнні:
- '
dot
' Намалюйце кропку для кожнага ўзору.
- '
line
' Правядзіце мяжу паміж папярэднім і бягучым узорам.
Значэнне па змаўчанні '
dot
'.- '
scale
Укажыце шкалу амплітуды аўдыёсэмплоў.
Даступныя значэнні:
- '
lin
' Лінейны.
- '
sqrt
' Квадратны корань.
- '
cbrt
' Кубічны корань.
- '
log
' Лагарыфмічны.
- '
swap
Памяняць месцамі вось левага канала на вось правага канала.
mirror
Люстраная вось.
- '
none
' Без люстэрка.
- '
x
' Люстэрка толькі па восі х.
- '
y
' Люстэрка толькі па восі y.
- '
xy
' Люстэрка абедзвюх восяў.
- '
16.6.1 Examples
- Поўны прыклад з выкарыстаннем
ffplay
:ffplay -f lavfi 'amovie=input.mp3, asplit [a][out1]; [a] avectorscope=zoom=1.3:rc=2:gc=200:bc=10:rf=1:gf=8:bf=7 [out0]'
16.6.2 Commands
Гэты фільтр падтрымлівае ўсе вышэйпералічаныя параметры ў якасці каманд, акрамя опцый size
і rate
.
16.7 bench, abench
Параўнальная частка фільтра.
Фільтр прымае наступныя параметры:
action
Запусціць або спыніць таймер.
Даступныя значэнні:
- '
start
' Атрымаць бягучы час, усталяваць яго ў якасці метададзеных кадра (з дапамогай ключа
lavfi.bench.start_time
) і пераслаць кадр да наступнага фільтра.- '
stop
' Атрымаць бягучы час і атрымаць
lavfi.bench.start_time
метаданыя з метададзеных кадра ўводу, каб атрымаць розніцу ў часе. Затым друкуецца розніца ў часе, сярэдні, максімальны і мінімальны час (адпаведнаt
,avg
,max
і ).min
Пазнакі часу выражаюцца ў секундах.
- '
16.7.1 Examples
- Тэст селектыўнага каляровага фільтра:
bench=start,selectivecolor=reds=-.2 .12 -.49,bench=stop
16.8 concat
Аб'ядноўвайце аўдыя- і відэапатокі, злучаючы іх адзін за адным.
Фільтр працуе на сегментах сінхранізаваных відэа- і аўдыёпатокаў. Усе сегменты павінны мець аднолькавую колькасць патокаў кожнага тыпу, і гэта таксама будзе колькасць патокаў на выхадзе.
Фільтр прымае наступныя параметры:
n
Усталюйце колькасць сегментаў. Па змаўчанні 2.
v
Усталюйце колькасць выходных відэапатокаў, гэта значыць таксама колькасць відэапатокаў у кожным сегменце. Па змаўчанні 1.
a
Усталюйце колькасць выходных аўдыяпатокаў, гэта значыць таксама колькасць аўдыяпатокаў у кожным сегменце. Па змаўчанні 0.
unsafe
Актывуйце небяспечны рэжым: не адмаўляйцеся, калі сегменты маюць іншы фармат.
Фільтр мае v
+ a
выхады: спачатку v
відэавыхады, потым
a
аўдыёвыхады.
Ёсць n
x( v
+ a
) уваходы: спачатку ўваходы для першага сегмента ў тым жа парадку, што і выхады, затым уваходы для другога сегмента і г.д.
Звязаныя патокі не заўсёды маюць аднолькавую працягласць па розных прычынах, уключаючы памер кадра кодэка або неакуратнае аўтарства. Па гэтай прычыне звязаныя сінхранізаваныя патокі (напрыклад, відэа і яго гукавая дарожка) павінны быць аб'яднаны адначасова. Фільтр concat будзе выкарыстоўваць працягласць самага доўгага патоку ў кожным сегменце (акрамя апошняга) і пры неабходнасці запаўняць больш кароткія аўдыяпатокі цішынёй.
Каб гэты фільтр працаваў правільна, усе сегменты павінны пачынацца з пазнакі часу 0.
Усе адпаведныя патокі павінны мець аднолькавыя параметры ва ўсіх сегментах; сістэма фільтрацыі аўтаматычна абярэ агульны фармат пікселяў для відэапатокаў, а таксама агульны фармат выбаркі, частату дыскрэтызацыі і планіроўку канала для аўдыёпатокаў, але іншыя налады, такія як раздзяленне, павінны быць пераўтвораны карыстальнікам відавочна.
Розная частата кадраў прымальная, але прывядзе да зменнай частаты кадраў на выхадзе; не забудзьцеся наладзіць выходны файл для яго апрацоўкі.
16.8.1 Examples
- Аб'яднайце пачатак, эпізод і канцоўку, усё ў двухмоўнай версіі (відэа ў патоку 0, аўдыя ў патоках 1 і 2):
ffmpeg -i opening.mkv -i episode.mkv -i ending.mkv -filter_complex \ '[0:0] [0:1] [0:2] [1:0] [1:1] [1:2] [2:0] [2:1] [2:2] concat=n=3:v=1:a=2 [v] [a1] [a2]' \ -map '[v]' -map '[a1]' -map '[a2]' output.mkv
- Аб'яднанне дзвюх частак, асобная апрацоўка аўдыя і відэа, выкарыстанне крыніц (а)фільмаў і рэгуляванне разрознасці:
movie=part1.mp4, scale=512:288 [v1] ; amovie=part1.mp4 [a1] ; movie=part2.mp4, scale=512:288 [v2] ; amovie=part2.mp4 [a2] ; [v1] [v2] concat [outv] ; [a1] [a2] concat=v=0:a=1 [outa]
Звярніце ўвагу, што рассінхранізацыя адбудзецца ў стыку, калі аўдыя- і відэаплыні не маюць аднолькавай працягласці ў першым файле.
16.8.2 Commands
Гэты фільтр падтрымлівае наступныя каманды:
next
Закрыць бягучы сегмент і перайсці да наступнага
16.9 ebur128
Фільтр сканэра EBU R128. Гэты фільтр прымае аўдыёпаток і аналізуе ўзровень яго гучнасці. Па змаўчанні ён рэгіструе паведамленне з частатой 10 Гц з імгненнай гучнасцю (пазначаецца M
), кароткачасовай гучнасцю ( S
), убудаванай гучнасцю ( I
) і дыяпазонам гучнасці ( LRA
).
Фільтр можа аналізаваць толькі тыя патокі, якія маюць фармат выбаркі з плаваючай кропкай падвойнай дакладнасці. Пры неабходнасці ўваходны паток будзе пераўтвораны ў гэтую спецыфікацыю. Каб атрымаць зыходныя параметры, карыстальнікам можа спатрэбіцца ўставіць фільтры фармату і/або выбаркі пасля гэтага фільтра.
Фільтр таксама мае відэавыхад (гл. video
опцыю) з графікам у рэальным часе для назірання за змяненнем гучнасці. Графіка змяшчае зарэгістраванае паведамленне, згаданае вышэй, таму яно больш не друкуецца, калі ўсталяваны гэты параметр, калі не ўсталявана падрабязнае вядзенне журнала. Асноўная вобласць графіка ўтрымлівае кароткачасовую гучнасць (3 секунды аналізу), а датчык справа прызначаны для імгненнай гучнасці (400 мілісекунд), але пры жаданні яе можна наладзіць для адлюстравання кароткачасовай гучнасці (гл gauge
.).
Зялёная вобласць пазначае мэтавы дыяпазон +/- 1LU вакол мэтавай гучнасці (-23LUFS па змаўчанні, калі не зменена праз target
).
Дадатковая інфармацыя аб рэкамендацыі па гучнасці EBU R128 на http://tech.ebu.ch/loudness .
Фільтр прымае наступныя параметры:
video
Актывуйце відэавыхад. Аўдыяпаток перадаецца нязменным незалежна ад таго, усталяваны гэты параметр ці не. Відэаструмень будзе першым выходным патокам, калі ён актываваны. Па змаўчанні
0
.size
Усталюйце памер відэа. Гэты параметр прызначаны толькі для відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Па змаўчанні і мінімальным дазволам з'яўляецца
640x480
.meter
Усталюйце шкалу EBU. Па змаўчанні
9
. Агульнымі значэннямі з'яўляюцца9
і18
, адпаведна, для метра шкалы EBU +9 і метра шкалы EBU +18. Дапускаецца любое іншае цэлае значэнне ў межах гэтага дыяпазону.metadata
Усталяваць увядзенне метададзеных. Калі зададзена значэнне
1
, уваходны аўдыя будзе сегментаваны на выходныя кадры працягласцю 100 мс, кожны з якіх змяшчае розную інфармацыю аб гучнасці ў метададзеных. Усе ключы метададзеных маюць прэфіксlavfi.r128.
.Па змаўчанні
0
.framelog
Прымусовы ўзровень рэгістравання кадра.
Даступныя значэнні:
- '
info
' узровень рэгістрацыі інфармацыі
- '
verbose
' падрабязны ўзровень вядзення часопіса
Па змаўчанні ўзровень вядзення журнала ўстаноўлены на
info
. Каліvideo
абоmetadata
усталяваны параметры, ён пераключаецца наverbose
.- '
peak
Усталяваць пікавы рэжым(ы).
Даступныя рэжымы можна назапашваць (параметр з'яўляецца
flag
тыпам). Магчымыя значэнні:- '
none
' Адключыць любы пікавы рэжым (па змаўчанні).
- '
sample
' Уключыце рэжым пікавай выбаркі.
Просты пікавы рэжым шукае больш высокае значэнне выбаркі. Ён рэгіструе паведамленне для піку выбаркі (пазначаецца
SPK
).- '
true
' Уключыць рэжым сапраўднага піку.
Калі ўключана, пошук пікаў выконваецца на версіі ўваходнага патоку з падвышанай выбаркай для лепшай дакладнасці пікаў. Ён рэгіструе паведамленне для праўдзівага піку. (пазначаецца
TPK
) і сапраўдны пік на кадр (пазначаеццаFTPK
). Гэты рэжым патрабуе зборкі зlibswresample
.
- '
dualmono
Разглядайце ўваходныя файлы мона як "двайны мона". Калі монафайл прызначаны для прайгравання на стэрэасістэме, яго вымярэнне EBU R128 будзе няправільным для ўспрымання. Калі ўсталявана
true
, гэты параметр будзе кампенсаваць гэты эфект. Гэтая опцыя не ўплывае на шматканальныя ўваходныя файлы.panlaw
Усталюйце пэўны закон панарамавання, які будзе выкарыстоўвацца для вымярэння падвойных монафайлаў. Гэты параметр неабавязковы і мае значэнне па змаўчанні -3,01 дБ.
target
Усталюйце пэўны мэтавы ўзровень (у LUFS), які выкарыстоўваецца ў якасці адноснага нуля ў візуалізацыі. Гэты параметр неабавязковы і мае значэнне па змаўчанні -23LUFS, як вызначана EBU R128. Тым не менш, матэрыялы, апублікаваныя ў Інтэрнэце, могуць аддаваць перавагу ўзроўню -16LUFS (напрыклад, для выкарыстання з падкастамі або відэаплатформамі).
gauge
Усталюйце значэнне, якое паказвае манометр. Дапушчальныя значэнні
momentary
і sshortterm
. Па змаўчанні будзе выкарыстоўвацца імгненнае значэнне, але ў пэўных сітуацыях можа быць больш карысна назіраць за кароткатэрміновым значэннем (напрыклад, жывое мікшаванне).scale
Устанаўлівае шкалу адлюстравання для гучнасці. Дапушчальныя параметры
absolute
(у LUFS) абоrelative
(LU) адносна мэты. Гэта ўплывае толькі на выхад відэа, а не на зводку або бесперапынны вывад часопіса.
16.9.1 Examples
- Графік у рэжыме рэальнага часу з выкарыстаннем
ffplay
, з шкалой EBU +18:ffplay -f lavfi -i "amovie=input.mp3,ebur128=video=1:meter=18 [out0][out1]"
- Запусціце аналіз з дапамогай
ffmpeg
:ffmpeg -nostats -i input.mp3 -filter_complex ebur128 -f null -
16.10 interleave, ainterleave
Часовае чаргаванне кадраў з некалькіх уваходаў.
interleave
працуе з відэа ўваходамі, ainterleave
з аўдыё.
Гэтыя фільтры счытваюць кадры з некалькіх уваходаў і адпраўляюць на выхад самы стары кадр у чарзе.
Уваходныя патокі павінны мець дакладна вызначаныя, манатонна ўзрастаючыя значэнні часовых метак кадра.
Каб адправіць адзін кадр на вывад, гэтыя фільтры павінны паставіць у чаргу па меншай меры адзін кадр для кожнага ўваходу, таму яны не могуць працаваць, калі адзін з уваходных дадзеных яшчэ не завершаны і не будзе атрымліваць уваходныя кадры.
Напрыклад, разгледзім выпадак, калі адзін увод з'яўляецца select
фільтрам, які заўсёды выдаляе ўваходныя кадры. Фільтр interleave
будзе працягваць чытаць з гэтага ўваходу, але ён ніколі не зможа адпраўляць новыя кадры на выхад, пакуль уваход не адправіць сігнал канца патоку.
Акрамя таго, у залежнасці ад сінхранізацыі уваходаў, фільтры будуць адкідваць кадры ў выпадку, калі адзін уваход атрымлівае больш кадраў, чым іншыя, і чарга ўжо запоўнена.
Гэтыя фільтры прымаюць наступныя параметры:
nb_inputs, n
Усталюйце колькасць розных уваходаў, па змаўчанні 2.
duration
Як вызначыць канец патоку.
longest
Працягласць самага доўгага ўводу. (па змаўчанні)
shortest
Працягласць самага кароткага ўводу.
first
Працягласць першага ўваходу.
16.10.1 Examples
- Перамяжоўвайце кадры, якія належаць да розных патокаў, выкарыстоўваючы
ffmpeg
:ffmpeg -i bambi.avi -i pr0n.mkv -filter_complex "[0:v][1:v] interleave" out.avi
- Дадайце эфект мігатлівага размыцця:
select='if(gt(random(0), 0.2), 1, 2)':n=2 [tmp], boxblur=2:2, [tmp] interleave
16.11 latency, alatency
Вымерайце затрымку фільтрацыі.
Паведаміць пра затрымку папярэдняй фільтрацыі фільтра, затрымку ў колькасці выбарак аўдыя для аўдыяфільтраў або колькасці відэакадраў для відэафільтраў.
У канцы ўваходнага патоку фільтр паведаміць мінімальную і максімальную вымераную затрымку для папярэдняга запушчанага фільтра ў графіку фільтра.
16.12 metadata, ametadata
Маніпуляваць метаданымі фрэйма.
Гэты фільтр прымае наступныя параметры:
mode
Задайце рэжым працы фільтра.
Можа быць адно з наступнага:
- '
select
' Калі ўсталяваны абодва
value
іkey
, выбірайце кадры, якія маюць такія метададзеныя. Каліkey
ўстаноўлена толькі, выбіраць кожны кадр, які мае такі ключ у метададзеных.- '
add
' Дадайце новыя метададзеныя
key
іvalue
. Калі ключ ужо даступны, нічога не рабіць.- '
modify
' Змяніць значэнне ўжо існуючага ключа.
- '
delete
' Калі
value
ўстаноўлена, выдаляць толькі ключы, якія маюць такое значэнне. У адваротным выпадку выдаліце ​​ключ. Каліkey
не ўстаноўлена, выдаліць усе значэнні метаданых у кадры.- '
print
' Ключ друку і яго значэнне, калі метаданыя знойдзены. Калі
key
не ўстаноўлена, друкаваць усе значэнні метададзеных, даступныя ў кадры.
- '
key
Усталяваць ключ, які выкарыстоўваецца ва ўсіх рэжымах. Павінен быць усталяваны для ўсіх рэжымаў, акрамя
print
іdelete
.value
Усталюйце значэнне метаданых, якое будзе выкарыстоўвацца. Гэтая опцыя з'яўляецца абавязковай для рэжыму
modify
і .add
function
Якую функцыю выкарыстоўваць пры параўнанні значэння метададзеных і
value
.Можа быць адно з наступнага:
- '
same_str
' Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых супадае з
value
.- '
starts_with
' Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых пачынаецца з
value
радка параметра.- '
less
' Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі значэнне метаданых меншае за
value
.- '
equal
' Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі
value
роўна значэнню метаданых.- '
greater
' Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі значэнне метаданых большае за
value
.- '
expr
' Значэнні інтэрпрэтуюцца як плывучыя, вяртае ісціну, калі выраз з опцыі
expr
ісціна.- '
ends_with
' Значэнні інтэрпрэтуюцца як радкі, вяртае ісціну, калі значэнне метаданых заканчваецца
value
радком опцыі.
- '
expr
Усталяваць выраз, які выкарыстоўваецца, калі
function
ўстаноўленаexpr
. Выраз вылічваецца праз eval API і можа ўтрымліваць наступныя канстанты:VALUE1, FRAMEVAL
Плаваючае прадстаўленне
value
з ключа метададзеных.VALUE2, USERVAL
Прадстаўленне з плаваючай часткай
value
, якое падаецца карыстальнікам уvalue
опцыі.
file
Калі паказана ў
print
рэжыме, вывад запісваецца ў названы файл. Замест простага імя файла можа быць указаны любы URL-адрас, які можна запісваць. Імя файла «-» з'яўляецца скарачэннем для стандартнага вываду. Каліfile
параметр не ўсталяваны, вывад запісваецца ў журнал з узроўнем часопіса AV_LOG_INFO.direct
Памяншае буферызацыю ў рэжыме друку, калі вывад запісваецца ў URL, усталяваны з дапамогай
file
.
16.12.1 Examples
- Раздрукаваць усе значэнні метаданых для фрэймаў з ключом
lavfi.signalstats.YDIF
са значэннямі ад 0 да 1.signalstats,metadata=print:key=lavfi.signalstats.YDIF:value=0:function=expr:expr='between(VALUE1,0,1)'
- Раздрукаваць выхад silencedetect у файл
metadata.txt
.silencedetect,ametadata=mode=print:file=metadata.txt
- Накіруйце ўсе метададзеныя ў канал з дэскрыптарам файла 4.
metadata=mode=print:file='pipe\:4'
16.13 perms, aperms
Усталюйце дазволы на чытанне/запіс для выходных кадраў.
Гэтыя фільтры ў асноўным прызначаны для распрацоўшчыкаў для праверкі прамога шляху ў наступным фільтры на графіку фільтраў.
Фільтры прымаюць наступныя параметры:
mode
Выберыце рэжым дазволаў.
Ён прымае наступныя значэнні:
- '
none
' Нічога не рабіць. Гэта па змаўчанні.
- '
ro
' Усталюйце ўсе выходныя кадры ў рэжыме толькі для чытання.
- '
rw
' Усталяваць усе выходныя кадры для прамога запісу.
- '
toggle
' Зрабіць фрэйм ​​толькі для чытання, калі ён даступны для запісу, і для запісу, калі ён даступны толькі для чытання.
- '
random
' Выпадковым чынам усталюйце кожны выхадны кадр толькі для чытання або запісу.
- '
seed
Усталюйце пачатковы код для
random
рэжыму, павінен быць цэлым лікам паміж0
іUINT32_MAX
. Калі не пазначана або яўна ўстаноўлена значэнне-1
, фільтр будзе спрабаваць выкарыстоўваць добрае выпадковае пачатковае значэнне на аснове максімальнай магчымасці.
Заўвага: у выпадку аўтаматычнай устаўкі фільтра паміж фільтрам дазволаў і наступным, дазвол можа быць не атрыманы, як чакалася, у наступным фільтры. Устаўка фармату або фільтра афармата перад фільтрам perms/aperms можа пазбегнуць гэтай праблемы.
16.14 realtime, arealtime
Запавольце фільтраванне, каб прыблізна адпавядаць рэжыму рэальнага часу.
Гэтыя фільтры будуць прыпыняць фільтрацыю на розны час, каб супаставіць хуткасць вываду з пазнакамі часу ўводу. Яны падобныя наre
варыянт для ffmpeg
.
Яны прымаюць наступныя варыянты:
limit
Абмежаванне часу на паўзы. Любая паўза больш працяглая будзе лічыцца разрывам часовай меткі і скідаць таймер. Па змаўчанні 2 секунды.
speed
Каэфіцыент хуткасці апрацоўкі. Значэнне павінна быць большым за нуль. Значэнні, большыя за 1,0, прывядуць да апрацоўкі хутчэй, чым у рэальным часе, а меншыя - запавольваюць апрацоўку.
limit
Аўтаматычна адаптуецца адпаведна . Па змаўчанні 1.0.Хуткасць апрацоўкі вышэй, чым магчымая без гэтых фільтраў, немагчымая.
16.14.1 Commands
Абодва фільтры падтрымліваюць усе вышэйпералічаныя параметры ў якасці каманд .
16.15 segment, asegment
Падзяленне аднаго ўваходнага патоку на некалькі патокаў.
Гэты фільтр робіць супрацьлегласць фільтрам concat.
segment
працуе на відэакадрах, asegment
на аўдыёсэмплах.
Гэты фільтр прымае наступныя параметры:
timestamps
Пазнакі часу выходных сегментаў, падзеленыя знакам '|'. Першы сегмент будзе запускацца з пачатку ўваходнага патоку. Апошні сегмент будзе працаваць да канца ўваходнага патоку
frames, samples
Дакладная колькасць кадраў/узораў для падзелу сегментаў.
Ва ўсіх выпадках, калі да кожнага сегмента дадаецца прэфікс "+", ён будзе адносіцца да папярэдняга сегмента.
16.15.1 Examples
- Падзяліць уваходны аўдыяпаток на тры выходныя аўдыяпатокі, пачынаючы з пачатку ўваходнага аўдыяпатоку і захоўваючы яго ў 1-м выхадным аўдыяпатоку, затым пасля 60-й секунды і захоўваючы, чым у 2-м выхадным аўдыяпатоку, і апошнім пасля 150-й секунды ўваходнага аўдыяпатоку. у 3-м выхадным аўдыяструмені:
asegment=timestamps="60|150"
16.16 select, aselect
Выберыце кадры для перадачы ў вывад.
Гэты фільтр прымае наступныя параметры:
expr, e
Задаць выраз, які вылічваецца для кожнага ўваходнага кадра.
Калі выраз дае нуль, фрэйм ​​адкідаецца.
Калі вынік ацэнкі адмоўны або NaN, кадр адпраўляецца на першы выхад; у адваротным выпадку ён адпраўляецца на выхад з індэксам
ceil(val)-1
, мяркуючы, што ўваходны індэкс пачынаецца з 0.Напрыклад, значэнне
1.2
адпавядае выхаду з індэксамceil(1.2)-1 = 2-1 = 1
, гэта значыць другому выхаду.outputs, n
Усталюйце колькасць выхадаў. Выхад, куды трэба адправіць выбраны кадр, заснаваны на выніку ацэнкі. Значэнне па змаўчанні - 1.
Выраз можа ўтрымліваць наступныя канстанты:
n
(Парадкавы) нумар адфільтраванага кадра, пачынаючы з 0.
selected_n
(Парадкавы) нумар абранага кадра, пачынаючы з 0.
prev_selected_n
Парадкавы нумар апошняга выбранага кадра. Гэта NAN, калі не вызначана.
TB
Часовая база для ўведзеных часавых пазнак.
pts
PTS (TimeStamp прэзентацыі) адфільтраванага кадра, выражаны ў
TB
адзінках. Гэта NAN, калі не вызначана.t
PTS адфільтраванага кадра, выражаны ў секундах. Гэта NAN, калі не вызначана.
prev_pts
PTS раней адфільтраванага кадра. Гэта NAN, калі не вызначана.
prev_selected_pts
PTS апошняга раней адфільтраванага кадра. Гэта NAN, калі не вызначана.
prev_selected_t
PTS апошняга раней выбранага кадра, выражаны ў секундах. Гэта NAN, калі не вызначана.
start_pts
Першы PTS у патоку, які не з'яўляецца NAN. Ён застаецца NAN, калі не знойдзены.
start_t
Першы PTS, у секундах, у патоку, які не з'яўляецца NAN. Ён застаецца NAN, калі не знойдзены.
pict_type (video only)
Тып кадра з фільтрам. Ён можа прымаць адно з наступных значэнняў:
I
P
B
S
SI
SP
BI
interlace_type (video only)
Тып перапляцення кадраў. Ён можа прымаць адно з наступных значэнняў:
PROGRESSIVE
Кадр прагрэсіўны (не празрадковы).
TOPFIRST
Рама верхняе поле наперад.
BOTTOMFIRST
Рамка ніжнім полем.
consumed_sample_n (audio only)
колькасць выбраных выбарак перад бягучым кадрам
samples_n (audio only)
колькасць узораў у бягучым кадры
sample_rate (audio only)
частата дыскрэтызацыі ўводу
key
Гэта 1, калі адфільтраваны кадр з'яўляецца ключавым, 0 у адваротным выпадку.
pos
пазіцыя ў файле адфільтраванага кадра, -1, калі інфармацыя недаступная (напрыклад, для сінтэтычнага відэа)
scene (video only)
значэнне ад 0 да 1 для абазначэння новай сцэны; нізкае значэнне адлюстроўвае нізкую верагоднасць для бягучага кадра ўвесці новую сцэну, у той час як больш высокае значэнне азначае, што бягучы кадр, хутчэй за ўсё, будзе адным (гл. прыклад ніжэй)
concatdec_select
Дэмультыфікатар concat можа выбраць толькі частку ўваходнага файла concat, усталяваўшы ўваходную і выходную кропку, але выходныя пакеты могуць не цалкам утрымлівацца ў абраным інтэрвале. Выкарыстоўваючы гэту зменную, можна прапускаць кадры, згенераваныя дэмультыфікатарам concat, якія дакладна не ўтрымліваюцца ў абраным інтэрвале.
Гэта працуе шляхам параўнання пунктаў кадра са
lavf.concat.start_time
значэнняміlavf.concat.duration
метададзеных пакета, якія таксама прысутнічаюць у дэкадзіраваных кадрах.Пераменная роўная -1 ,
concatdec_select
калі кропка кадра роўна меншай за час_пачатку і альбо адсутнічаюць метаданыя працягласці, альбо кропка кадра меншая за час_пачатку + працягласць, у адваротным выпадку 0, і NaN, калі метаданыя пра час_пачатку адсутнічаюць.У асноўным гэта азначае, што ўваходны кадр выбіраецца, калі яго кропкі знаходзяцца ў межах інтэрвалу, устаноўленага дэмультыфікатарам concat.
Значэнне выразу выбару па змаўчанні - "1".
16.16.1 Examples
- Выберыце ўсе кадры ва ўводзе:
select
Прыклад вышэй такі ж, як:
select=1
- Прапусціць усе кадры:
select=0
- Выберыце толькі I-фреймы:
select='eq(pict_type\,I)'
- Выберыце адзін кадр на кожныя 100:
select='not(mod(n\,100))'
- Выберыце толькі кадры, якія змяшчаюцца ў інтэрвале часу 10-20:
select=between(t\,10\,20)
- Выберыце толькі I-кадры, якія змяшчаюцца ў інтэрвале часу 10-20:
select=between(t\,10\,20)*eq(pict_type\,I)
- Выберыце кадры з мінімальнай адлегласцю 10 секунд:
select='isnan(prev_selected_t)+gte(t-prev_selected_t\,10)'
- Выкарыстоўвайце aselect, каб выбраць толькі аўдыякадры з колькасцю сэмплоў > 100:
aselect='gt(samples_n\,100)'
- Стварыце мазаіку з першых сцэн:
ffmpeg -i video.avi -vf select='gt(scene\,0.4)',scale=160:120,tile -frames:v 1 preview.png
Параўнанне
scene
са значэннем ад 0,3 да 0,5, як правіла, разумны выбар. - Адпраўляйце цотныя і няцотныя кадры на асобныя выхады і складайце іх:
select=n=2:e='mod(n, 2)+1' [odd][even]; [odd] pad=h=2*ih [tmp]; [tmp][even] overlay=y=h
- Выберыце карысныя кадры з файла ffconcat, які выкарыстоўвае кропкі ўваходу і выхаду, але дзе зыходныя файлы з'яўляюцца не толькі ўнутры кадра.
ffmpeg -copyts -vsync 0 -segment_time_metadata 1 -i input.ffconcat -vf select=concatdec_select -af aselect=concatdec_select output.avi
16.17 sendcmd, asendcmd
Адпраўляйце каманды фільтрам у графе фільтраў.
Гэтыя фільтры счытваюць каманды для адпраўкі іншым фільтрам у графе фільтраў.
sendcmd
павінны быць устаўлены паміж двума відэафільтрамі,
asendcmd
павінны быць устаўлены паміж двума аўдыяфільтрамі, але, акрамя гэтага, яны дзейнічаюць аднолькава.
Спецыфікацыя каманд можа быць прадстаўлена ў аргументах фільтра з commands
опцыяй або ў файле, вызначаным
filename
опцыяй.
Гэтыя фільтры прымаюць наступныя параметры:
commands, c
Усталюйце каманды для чытання і адпраўкі іншым фільтрам.
filename, f
Усталюйце імя файла каманд, якія будуць счытвацца і адпраўляцца іншым фільтрам.
16.17.1 Commands syntax
Апісанне каманд складаецца з паслядоўнасці спецыфікацый інтэрвалу, якая змяшчае спіс каманд, якія павінны быць выкананы, калі адбываецца пэўная падзея, звязаная з гэтым інтэрвалам. Падзея, якая адбываецца, звычайна з'яўляецца бягучым часам кадра, які ўваходзіць або пакідае зададзены інтэрвал часу.
Інтэрвал задаецца наступным сінтаксісам:
START
[-END
] COMMANDS
;
Прамежак часу вызначаецца START
і END
часамі.
END
неабавязковы і па змаўчанні максімальны час.
Бягучы час кадра лічыцца ў вызначаным інтэрвале, калі ён уключаны ў інтэрвал [ START
, END
), гэта значыць калі час большы або роўны START
і меншы за
END
.
COMMANDS
складаецца з паслядоўнасці адной або некалькіх спецыфікацый каманды, падзеленых знакам ",", якія адносяцца да гэтага інтэрвалу. Сінтаксіс спецыфікацыі каманды задаецца наступным чынам:
[FLAGS
] TARGET
COMMAND
ARG
FLAGS
не з'яўляецца абавязковым і вызначае тып падзей, звязаных з інтэрвалам часу, якія дазваляюць адправіць азначаную каманду, і павінна быць ненулявой паслядоўнасцю сцягоў ідэнтыфікатараў, падзеленых знакамі "+" ці "|" і заключаны паміж "[" і "]".
Распазнаюцца наступныя сцягі:
enter
Каманда адпраўляецца, калі пазнака часу бягучага кадра ўваходзіць у вызначаны інтэрвал. Іншымі словамі, каманда адпраўляецца, калі пазнака часу папярэдняга кадра не была ў зададзеным інтэрвале, а бягучая -.
leave
Каманда адпраўляецца, калі пазнака часу бягучага кадра пакідае зададзены інтэрвал. Іншымі словамі, каманда адпраўляецца, калі пазнака часу папярэдняга кадра была ў зададзеным інтэрвале, а бягучая - не.
expr
Каманда
ARG
інтэрпрэтуецца як выраз, а вынік выразу перадаецца якARG
.Выраз вылічваецца праз API eval і можа ўтрымліваць наступныя канстанты:
POS
Зыходная пазіцыя ў файле кадра або нявызначаная, калі не вызначана для бягучага кадра.
PTS
Пазнака часу прэзентацыі ва ўваходных дадзеных.
N
Колькасць уваходных кадраў для відэа ці аўдыя, пачынаючы з 0.
T
Час у секундах бягучага кадра.
TS
Час пачатку ў секундах бягучага інтэрвалу каманды.
TE
Час заканчэння ў секундах бягучага інтэрвалу каманды.
TI
Інтэрпаляваны час бягучага інтэрвалу каманды, TI = (T - TS) / (TE - TS).
W
Шырыня кадра відэа.
H
Вышыня кадра відэа.
Калі FLAGS
не вызначана, [enter]
прымаецца значэнне па змаўчанні.
TARGET
задае мэту каманды, звычайна імя класа фільтра або імя канкрэтнага асобніка фільтра.
COMMAND
задае назву каманды для мэтавага фільтра.
ARG
не з'яўляецца абавязковым і вызначае неабавязковы спіс аргументаў для дадзенага COMMAND
.
Паміж адной спецыфікацыяй інтэрвалу і другой прабелы або паслядоўнасці сімвалаў, якія пачынаюцца з і #
да канца радка, ігнаруюцца і могуць выкарыстоўвацца для анатавання каментарыяў.
Спрошчанае апісанне BNF сінтаксісу спецыфікацыі каманд наступнае:
COMMAND_FLAG
::= "enter" | "leave"
COMMAND_FLAGS
::= COMMAND_FLAG
[(+|"|")COMMAND_FLAG
]
COMMAND
::= ["[" COMMAND_FLAGS
"]"] TARGET
COMMAND
[ARG
]
COMMANDS
::= COMMAND
[,COMMANDS
]
INTERVAL
::= START
[-END
] COMMANDS
INTERVALS
::= INTERVAL
[;INTERVALS
]
16.17.2 Examples
- Укажыце змяненне тэмпу гуку на 4-й секундзе:
asendcmd=c='4.0 atempo tempo 1.5',atempo
- Нацэліцеся на пэўны асобнік фільтра:
asendcmd=c='4.0 atempo@my tempo 1.5',atempo@my
- Укажыце спіс каманд для маляванага тэксту і адцення ў файле.
# show text in the interval 5-10 5.0-10.0 [enter] drawtext reinit 'fontfile=FreeSerif.ttf:text=hello world', [leave] drawtext reinit 'fontfile=FreeSerif.ttf:text='; # desaturate the image in the interval 15-20 15.0-20.0 [enter] hue s 0, [enter] drawtext reinit 'fontfile=FreeSerif.ttf:text=nocolor', [leave] hue s 1, [leave] drawtext reinit 'fontfile=FreeSerif.ttf:text=color'; # apply an exponential saturation fade-out effect, starting from time 25 25 [enter] hue s exp(25-t)
Граф фільтра, які дазваляе чытаць і апрацоўваць прыведзены вышэй спіс каманд, захаваны ў файле
test.cmd
, можа быць указана з дапамогай:sendcmd=f=test.cmd,drawtext=fontfile=FreeSerif.ttf:text='',hue
16.18 setpts, asetpts
Зменіце PTS (пазнаку часу прэзентацыі) уваходных кадраў.
setpts
працуе на відэакадрах, asetpts
на аўдыякадрах.
Гэты фільтр прымае наступныя параметры:
expr
Выраз, які вылічваецца для кожнага кадра, каб стварыць яго метку часу.
Выраз вылічваецца праз API eval і можа ўтрымліваць наступныя канстанты:
FRAME_RATE, FR
частата кадраў, вызначаная толькі для відэа з пастаяннай частатой кадраў
PTS
Пазнака часу прэзентацыі ва ўваходных дадзеных
N
Колькасць уваходнага кадра для відэа або колькасць спажытых выбарак, не уключаючы бягучы кадр для аўдыя, пачынаючы з 0.
NB_CONSUMED_SAMPLES
Колькасць спажытых сэмплоў, не уключаючы бягучы кадр (толькі аўдыя)
NB_SAMPLES, S
Колькасць узораў у бягучым кадры (толькі аўдыё)
SAMPLE_RATE, SR
Частата дыскрэтызацыі гуку.
STARTPTS
ПТС першага кадра.
STARTT
час у секундах першага кадра
INTERLACED
Укажыце, ці з'яўляецца бягучы кадр празрадковым.
T
час у секундах бягучага кадра
POS
зыходная пазіцыя ў файле кадра, або нявызначаная, калі не вызначана для бягучага кадра
PREV_INPTS
Папярэдні ўваход ПТС.
PREV_INT
час папярэдняга ўводу ў секундах
PREV_OUTPTS
Папярэдні выхад ПТС.
PREV_OUTT
папярэдні час вываду ў секундах
RTCTIME
Час насценнага гадзінніка (RTC) у мікрасекундах. Гэта састарэла, замест гэтага выкарыстоўвайце час (0).
RTCSTART
Час насценнага гадзінніка (RTC) у пачатку фільма ў мікрасекундах.
TB
Часовая база для ўведзеных часавых пазнак.
16.18.1 Examples
- Пачніце адлік ВТС з нуля
setpts=PTS-STARTPTS
- Прымяніць эфект хуткага руху:
setpts=0.5*PTS
- Прымяніць эфект запаволенага руху:
setpts=2.0*PTS
- Усталюйце фіксаваную частату 25 кадраў у секунду:
setpts=N/(25*TB)
- Усталюйце фіксаваную хуткасць 25 кадраў у секунду з некаторым дрыгаценнем:
setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
- Прымяніць зрушэнне ў 10 секунд да PTS уводу:
setpts=PTS+10/TB
- Стварыць часовыя пазнакі з "жывой крыніцы" і перабазіраваць на бягучую часовую базу:
setpts='(RTCTIME - RTCSTART) / (TB * 1000000)'
- Стварыце пазнакі часу шляхам падліку выбарак:
asetpts=N/SR/TB
16.19 setrange
Прымусовы каляровы дыяпазон для выхаднога відэакадра.
Фільтр setrange
пазначае ўласцівасць каляровага дыяпазону для выходных кадраў. Ён не змяняе ўваходны кадр, а толькі задае адпаведную ўласцівасць, якая ўплывае на апрацоўку кадра наступнымі фільтрамі.
Фільтр прымае наступныя параметры:
range
Даступныя значэнні:
- '
auto
' Захоўвайце аднолькавую ўласцівасць каляровага дыяпазону.
- '
unspecified, unknown
' Усталюйце дыяпазон колераў як нявызначаны.
- '
limited, tv, mpeg
' Усталюйце абмежаваны дыяпазон колераў.
- '
full, pc, jpeg
' Усталюйце каляровы дыяпазон як поўны.
- '
16.20 settb, asettb
Усталюйце часовую базу, якая будзе выкарыстоўвацца для часовых пазнак выхадных кадраў. Гэта ў асноўным карысна для тэсціравання канфігурацыі часавай базы.
Ён прымае наступныя параметры:
expr, tb
Выраз, які вылічваецца ў часавай базе вываду.
Значэнне дляtb
гэта арыфметычны выраз, які прадстаўляе рацыянальнае. Выраз можа ўтрымліваць канстанты "AVTB" (па змаўчанні развага), "intb" (уваходная развага) і "sr" (частата дыскрэтызацыі, толькі гук). Значэнне па змаўчанні - "intb".
16.20.1 Examples
- Усталюйце часовую базу на 1/25:
settb=expr=1/25
- Усталюйце часовую базу на 1/10:
settb=expr=0.1
- Усталюйце часовую базу 1001/1000:
settb=1+0.001
- Усталюйце часовую базу 2*intb:
settb=2*intb
- Усталюйце значэнне разгорткі па змаўчанні:
settb=AVTB
16.21 showcqt
Пераўтварыце ўваходны аўдыё ў відэавыхад, які прадстаўляе частотны спектр лагарыфмічна з дапамогай алгарытму пераўтварэння пастаяннай Q Браўна-Пакетта з прамым вылічэннем каэфіцыента ў частотнай вобласці (але само пераўтварэнне насамрэч не з'яўляецца пастаянным Q, замест гэтага каэфіцыент Q на самай справе зменны/заціснуты), з музычным тонам шкала, ад E0 да D#10.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Яно павінна быць роўным. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
1920x1080
.fps, rate, r
Усталюйце выходную частату кадраў. Значэнне па змаўчанні -
25
.bar_h
Усталюйце вышыню гістаграмы. Яно павінна быць роўным. Значэнне па змаўчанні
-1
аўтаматычна вылічае вышыню гістаграмы.axis_h
Усталюйце вышыню восі. Яно павінна быць роўным. Значэнне па змаўчанні
-1
аўтаматычна вылічвае вышыню восі.sono_h
Усталюйце вышыню сонаграмы. Яно павінна быць роўным. Значэнне па змаўчанні - гэта
-1
аўтаматычнае вылічэнне вышыні сонаграмы.fullhd
Усталюйце дазвол fullhd. Гэты параметр састарэў, выкарыстоўвайце
size
заместs
яго. Значэнне па змаўчанні -1
.sono_v, volume
Укажыце выраз аб'ёму сонаграмы. Ён можа ўтрымліваць зменныя:
bar_v
ацэньваемы
bar_v
выразfrequency, freq, f
частата, дзе яна ацэньваецца
timeclamp, tc
значэнне
timeclamp
апцыёна
і функцыі:
a_weighting(f)
А-ўзважванне роўнай гучнасці
b_weighting(f)
B-ўзважванне роўнай гучнасці
c_weighting(f)
C-узважванне роўнай гучнасці.
Значэнне па змаўчанні -
16
.bar_v, volume2
Укажыце выраз аб'ёму гістаграмы. Ён можа ўтрымліваць зменныя:
sono_v
ацэньваемы
sono_v
выразfrequency, freq, f
частата, дзе яна ацэньваецца
timeclamp, tc
значэнне
timeclamp
апцыёна
і функцыі:
a_weighting(f)
А-ўзважванне роўнай гучнасці
b_weighting(f)
B-ўзважванне роўнай гучнасці
c_weighting(f)
C-узважванне роўнай гучнасці.
Значэнне па змаўчанні -
sono_v
.sono_g, gamma
Укажыце гаму сонограммы. Больш нізкая гама робіць спектр больш кантрасным, больш высокая гама робіць спектр больш шырокім дыяпазонам. Значэнне па змаўчанні -
3
. Дапушчальны дыяпазон[1, 7]
.bar_g, gamma2
Укажыце гаму гістаграмы. Значэнне па змаўчанні -
1
. Дапушчальны дыяпазон[1, 7]
.bar_t
Укажыце ўзровень празрыстасці гістаграмы. Меншае значэнне робіць гістаграму больш рэзкай. Значэнне па змаўчанні -
1
. Дапушчальны дыяпазон[0, 1]
.timeclamp, tc
Укажыце фіксатар часу пераўтварэння. Пры нізкай частаце існуе кампраміс паміж дакладнасцю ў часавай і частотнай вобласці. Калі заціск меншы, падзея ў часовай вобласці адлюстроўваецца больш дакладна (напрыклад, хуткі бас-барабан), у адваротным выпадку падзея ў частотнай вобласці прадстаўляецца больш дакладна (напрыклад, бас-гітара). Дапушчальны дыяпазон
[0.002, 1]
. Значэнне па змаўчанні -0.17
.attack
Усталюйце час атакі ў секундах. Па змаўчанні
0
(выключана). У адваротным выпадку гэта абмяжоўвае будучыя выбаркі шляхам прымянення асіметрычнага аконнага афармлення ў часовай вобласці, што карысна, калі патрабуецца нізкая затрымка. Дапушчальны дыяпазон[0, 1]
.basefreq
Укажыце базавую частату пераўтварэння. Значэнне па змаўчанні -
20.01523126408007475
гэта частата на 50 цэнтаў ніжэй за E0. Дапушчальны дыяпазон[10, 100000]
.endfreq
Укажыце канчатковую частату пераўтварэння. Значэнне па змаўчанні -
20495.59681441799654
гэта частата на 50 цэнтаў вышэй D#10. Дапушчальны дыяпазон[10, 100000]
.coeffclamp
Гэты параметр састарэў і ігнаруецца.
tlength
Укажыце даўжыню пераўтварэння ў часовай вобласці. Выкарыстоўвайце гэты параметр, каб кантраляваць кампраміс дакладнасці паміж часовай вобласцю і частотнай вобласцю на кожнай частотнай выбарцы. Ён можа ўтрымліваць зменныя:
frequency, freq, f
частата, дзе яна ацэньваецца
timeclamp, tc
значэнне
timeclamp
апцыёна.
Значэнне па змаўчанні -
384*tc/(384+tc*f)
.count
Укажыце колькасць пераўтварэнняў для кожнага відэакадра. Значэнне па змаўчанні -
6
. Дапушчальны дыяпазон[1, 30]
.fcount
Укажыце колькасць пераўтварэнняў для кожнага пікселя. Значэнне па змаўчанні - гэта значыць
0
, што ён вылічваецца аўтаматычна. Дапушчальны дыяпазон[0, 10]
.fontfile
Укажыце файл шрыфта для выкарыстання з FreeType для малявання восі. Калі не пазначана, выкарыстоўваць убудаваны шрыфт. Звярніце ўвагу, што маляванне з файлам шрыфтоў або ўбудаваным шрыфтам не рэалізавана з карыстальніцкім
basefreq
іendfreq
, замест гэтага выкарыстоўвайцеaxisfile
параметр.font
Укажыце шаблон fontconfig. Гэта мае больш нізкі прыярытэт, чым
fontfile
. У:
шаблоне можна замяніць на,|
каб пазбегнуць непатрэбнага экраніравання.fontcolor
Укажыце колер шрыфта. Гэта арыфметычны выраз, які павінен вяртаць цэлае значэнне 0xRRGGBB. Ён можа ўтрымліваць зменныя:
frequency, freq, f
частата, дзе яна ацэньваецца
timeclamp, tc
значэнне
timeclamp
апцыёна
і функцыі:
midi(f)
нумар midi частаты f, некаторыя нумары midi: E0(16), C1(24), C2(36), A4(69)
r(x), g(x), b(x)
чырвонае, зялёнае і сіняе значэнне інтэнсіўнасці х.
Значэнне па змаўчанні -
st(0, (midi(f)-59.5)/12); st(1, if(between(ld(0),0,1), 0.5-0.5*cos(2*PI*ld(0)), 0)); r(1-ld(1)) + b(ld(1))
.axisfile
Укажыце файл відарыса для малявання восі. Гэтая опцыя перавызначае
fontfile
іfontcolor
опцыю.axis, text
Уключыць/выключыць малюнак тэксту да восі. Калі ён усталяваны ў
0
, маляванне да восі адключана, ігнаруючы опцыюfontfile
і .axisfile
Значэнне па змаўчанні -1
.csp
Задаць каляровую прастору. Дапушчальныя значэнні:
- '
unspecified
' Не вызначана (па змаўчанні)
- '
bt709
' BT.709
- '
fcc
' FCC
- '
bt470bg
' BT.470BG або BT.601-6 625
- '
smpte170m
' SMPTE-170M або BT.601-6 525
- '
smpte240m
' СМПТЭ-240М
- '
bt2020ncl
' BT.2020 з непастаяннай яркасцю
- '
cscheme
Задаць каляровую схему спектраграмы. Гэта спіс значэнняў з плаваючай коскай у фармаце
left_r|left_g|left_b|right_r|right_g|right_b
. Па змаўчанні -1|0.5|0|0|0.5|1
.
16.21.1 Examples
- Прайграванне аўдыё падчас паказу спектру:
ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt [out0]'
- Тое самае, што і вышэй, але з частатой кадраў 30 кадраў у секунду:
ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt=fps=30:count=5 [out0]'
- Прайграванне ў 1280x720:
ffplay -f lavfi 'amovie=a.mp3, asplit [a][out1]; [a] showcqt=s=1280x720:count=4 [out0]'
- Адключыць адлюстраванне сонаграмы:
sono_h=0
- A1 і яго гармонікі: A1, A2, (каля) E3, A3:
ffplay -f lavfi 'aevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t), asplit[a][out1]; [a] showcqt [out0]'
- Тое самае, што і вышэй, але з большай дакладнасцю ў частотнай вобласці:
ffplay -f lavfi 'aevalsrc=0.1*sin(2*PI*55*t)+0.1*sin(4*PI*55*t)+0.1*sin(6*PI*55*t)+0.1*sin(8*PI*55*t), asplit[a][out1]; [a] showcqt=timeclamp=0.5 [out0]'
- Карыстальніцкі аб'ём:
bar_v=10:sono_v=bar_v*a_weighting(f)
- Карыстальніцкая гама, цяпер спектр лінейны па амплітудзе.
bar_g=2:sono_g=2
- Карыстальніцкае ўраўненне даўжыні:
tc=0.33:tlength='st(0,0.17); 384*tc / (384 / ld(0) + tc*f /(1-ld(0))) + 384*tc / (tc*f / ld(0) + 384 /(1-ld(0)))'
- Карыстальніцкі колер шрыфта і файл шрыфта, C-note афарбаваны ў зялёны колер, іншыя афарбаваны ў сіні:
fontcolor='if(mod(floor(midi(f)+0.5),12), 0x0000FF, g(1))':fontfile=myfont.ttf
- Карыстальніцкі шрыфт з дапамогай fontconfig:
font='Courier New,Monospace,mono|bold'
- Карыстальніцкі дыяпазон частот з карыстацкай воссю з дапамогай файла выявы:
axisfile=myaxis.png:basefreq=40:endfreq=10000
16.22 showfreqs
Пераўтварэнне ўваходнага аўдыё ў відэавыход, які прадстаўляе спектр магутнасці гуку. Амплітуда гуку знаходзіцца па восі Y, а частата - па восі X.
Фільтр прымае наступныя параметры:
size, s
Пазначце памер відэа. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Па змаўчанні
1024x512
.rate, r
Задаць хуткасць відэа. Па змаўчанні
25
.mode
Усталюйце рэжым адлюстравання. Гэта вызначае, як будзе прадстаўлены кожны дыяпазон частот.
Ён прымае наступныя значэнні:
- '
line
' - '
bar
' - '
dot
'
Па змаўчанні
bar
.- '
ascale
Усталюйце шкалу амплітуды.
Ён прымае наступныя значэнні:
- '
lin
' Лінейны маштаб.
- '
sqrt
' Шкала квадратнага кораня.
- '
cbrt
' Кубічны корань шкалы.
- '
log
' Лагарыфмічная шкала.
Па змаўчанні
log
.- '
fscale
Усталюйце шкалу частот.
Ён прымае наступныя значэнні:
- '
lin
' Лінейны маштаб.
- '
log
' Лагарыфмічная шкала.
- '
rlog
' Зваротная лагарыфмічная шкала.
Па змаўчанні
lin
.- '
win_size
Усталюйце памер акна. Дазволены дыяпазон ад 16 да 65536.
Па змаўчанні
2048
win_func
Усталяваць функцыю акон.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Па змаўчанні
hanning
.- '
overlap
Усталюйце перакрыцце вокнаў. У дыяпазоне
[0, 1]
. Па змаўчанні ўстаноўлена1
, што азначае, што будзе выбрана аптымальнае перакрыцце для выбранай функцыі акна.averaging
Усталюйце асерадненне часу. Усталяванне гэтага значэння ў 0 будзе адлюстроўваць бягучыя максімальныя пікі. Па змаўчанні ўстаноўлена
1
, што азначае, што асерадненне часу адключана.colors
Укажыце спіс колераў, падзеленых прабелам або знакам '|' які будзе выкарыстоўвацца для малявання частот каналаў. Нераспазнаныя або адсутныя колеры будуць заменены белым колерам.
cmode
Усталюйце рэжым адлюстравання канала.
Ён прымае наступныя значэнні:
- '
combined
' - '
separate
'
Па змаўчанні
combined
.- '
minamp
Усталюйце мінімальную амплітуду, якая выкарыстоўваецца ў
log
шкаляры амплітуды.data
Усталюйце рэжым адлюстравання даных.
Ён прымае наступныя значэнні:
- '
magnitude
' - '
phase
' - '
delay
'
Па змаўчанні
magnitude
.- '
channels
Усталюйце каналы для выкарыстання пры апрацоўцы аўдыя. Па змаўчанні ўсе апрацоўваюцца.
16.23 showspatial
Пераўтварэнне уваходнага стэрэа аўдыё ў відэавыхад, прадстаўляючы прасторавыя адносіны паміж двума каналамі.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
512x512
.win_size
Усталюйце памер акна. Дазволены дыяпазон ад
1024
да65536
. Памер па змаўчанні4096
.win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann
' - '
hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Значэнне па змаўчанні -
hann
.- '
overlap
Задайце каэфіцыент перакрыцця акна. Значэнне па змаўчанні -
0.5
. Калі значэнне1
перакрываецца, усталяваны рэкамендаваны памер для пэўнай функцыі акна, якая выкарыстоўваецца ў цяперашні час.
16.24 showspectrum
Пераўтварэнне ўваходнага аўдыё ў відэавыхад, які прадстаўляе частотны спектр гуку.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
640x512
.slide
Укажыце, як спектр павінен слізгаць па акне.
Ён прымае наступныя значэнні:
- '
replace
' ўзоры пачынаюцца зноў злева, калі яны дасягаюць правага
- '
scroll
' ўзоры пракручваюцца справа налева
- '
fullframe
' кадры вырабляюцца толькі тады, калі ўзоры дасягаюць права
- '
rscroll
' ўзоры пракручваюцца злева направа
- '
lreplace
' ўзоры зноў пачынаюцца справа, калі яны дасягаюць левага краю
Значэнне па змаўчанні -
replace
.- '
mode
Пакажыце рэжым адлюстравання.
Ён прымае наступныя значэнні:
- '
combined
' усе каналы адлюстроўваюцца ў адным радку
- '
separate
' усе каналы адлюстроўваюцца ў асобных радках
Значэнне па змаўчанні '
combined
'.- '
color
Укажыце каляровы рэжым адлюстравання.
Ён прымае наступныя значэнні:
- '
channel
' кожны канал адлюстроўваецца асобным колерам
- '
intensity
' кожны канал адлюстроўваецца з выкарыстаннем той жа каляровай схемы
- '
rainbow
' кожны канал адлюстроўваецца з дапамогай каляровай схемы вясёлкі
- '
moreland
' кожны канал адлюстроўваецца з дапамогай каляровай схемы moreland
- '
nebulae
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы туманнасцей
- '
fire
' кожны канал адлюстроўваецца з дапамогай каляровай схемы агню
- '
fiery
' кожны канал адлюстроўваецца ў вогненнай каляровай гаме
- '
fruit
' кожны канал адлюстроўваецца з выкарыстаннем фруктовай каляровай схемы
- '
cool
' кожны канал адлюстроўваецца з выкарыстаннем халоднай каляровай схемы
- '
magma
' кожны канал адлюстроўваецца з дапамогай каляровай схемы магмы
- '
green
' кожны канал адлюстроўваецца з дапамогай зялёнай каляровай схемы
- '
viridis
' кожны канал адлюстроўваецца з дапамогай каляровай схемы Viridis
- '
plasma
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы плазмы
- '
cividis
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы cividis
- '
terrain
' кожны канал адлюстроўваецца з дапамогай каляровай схемы мясцовасці
Значэнне па змаўчанні '
channel
'.- '
scale
Укажыце шкалу, якая выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру.
Ён прымае наступныя значэнні:
- '
lin
' лінейны
- '
sqrt
' квадратны корань, па змаўчанні
- '
cbrt
' кубічны корань
- '
log
' лагарыфмічны
- '
4thrt
' 4-ы корань
- '
5thrt
' 5-ы корань
Значэнне па змаўчанні '
sqrt
'.- '
fscale
Укажыце шкалу частот.
Ён прымае наступныя значэнні:
- '
lin
' лінейны
- '
log
' лагарыфмічны
Значэнне па змаўчанні '
lin
'.- '
saturation
Усталюйце мадыфікатар насычанасці для адлюстраваных колераў. Адмоўныя значэнні забяспечваюць альтэрнатыўную каляровую схему.
0
зусім не насычэнне. Насычанасць павінна быць у дыяпазоне [-10,0, 10,0]. Значэнне па змаўчанні -1
.win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann
' - '
hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Значэнне па змаўчанні -
hann
.- '
orientation
Усталюйце арыентацыю восі часу і частоты. Можа быць
vertical
абоhorizontal
. Па змаўчанніvertical
.overlap
Задайце каэфіцыент перакрыцця акна. Значэнне па змаўчанні -
0
. Калі значэнне1
перакрываецца, усталяваны рэкамендаваны памер для пэўнай функцыі акна, якая выкарыстоўваецца ў цяперашні час.gain
Усталюйце ўзмацненне маштабу для разліку значэнняў інтэнсіўнасці колеру. Значэнне па змаўчанні -
1
.data
Усталюйце, якія дадзеныя адлюстроўваць. Можа быць
magnitude
, па змаўчанні абоphase
, або разгорнутая фаза:uphase
.rotation
Задаць паварот колеру, павінен быць у дыяпазоне [-1,0, 1,0]. Значэнне па змаўчанні -
0
.start
Усталюйце пачатковую частату, з якой будзе паказвацца спектраграма. Па змаўчанні
0
.stop
Усталюйце частату прыпынку, да якой будзе паказвацца спектраграма. Па змаўчанні
0
.fps
Усталюйце верхнюю мяжу частаты кадраў. Па змаўчанні -
auto
неабмежавана.legend
Малюйце восі часу і частоты і легенды. Па змаўчанні адключана.
drange
Усталюйце дынамічны дыяпазон, які выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру. Па змаўчанні 120 dBFS. Дазволены дыяпазон ад 10 да 200.
limit
Усталюйце верхнюю мяжу гучнасці ўваходных аўдыёсэмплоў у dBFS. Па змаўчанні 0 dBFS. Дазволены дыяпазон ад -100 да 100.
opacity
Усталюйце ўзровень непразрыстасці пры выкарыстанні вываду ў фармаце пікселяў з альфа-кампанентам.
Выкарыстанне вельмі падобнае на фільтр showwaves; глядзіце прыклады ў гэтым раздзеле.
16.24.1 Examples
- Вялікае акно з лагарыфмічнай каляровай шкалой:
showspectrum=s=1280x480:scale=log
- Поўны прыклад для каляровага і слізгальнага спектру на канал з выкарыстаннем
ffplay
:ffplay -f lavfi 'amovie=input.mp3, asplit [a][out1]; [a] showspectrum=mode=separate:color=intensity:slide=1:scale=cbrt [out0]'
16.25 showspectrumpic
Пераўтварэнне ўваходнага гуку ў адзін відэакадр, які прадстаўляе спектр частот гуку.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
4096x2048
.mode
Пакажыце рэжым адлюстравання.
Ён прымае наступныя значэнні:
- '
combined
' усе каналы адлюстроўваюцца ў адным радку
- '
separate
' усе каналы адлюстроўваюцца ў асобных радках
Значэнне па змаўчанні '
combined
'.- '
color
Укажыце каляровы рэжым адлюстравання.
Ён прымае наступныя значэнні:
- '
channel
' кожны канал адлюстроўваецца асобным колерам
- '
intensity
' кожны канал адлюстроўваецца з выкарыстаннем той жа каляровай схемы
- '
rainbow
' кожны канал адлюстроўваецца з дапамогай каляровай схемы вясёлкі
- '
moreland
' кожны канал адлюстроўваецца з дапамогай каляровай схемы moreland
- '
nebulae
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы туманнасцей
- '
fire
' кожны канал адлюстроўваецца з дапамогай каляровай схемы агню
- '
fiery
' кожны канал адлюстроўваецца ў вогненнай каляровай гаме
- '
fruit
' кожны канал адлюстроўваецца з выкарыстаннем фруктовай каляровай схемы
- '
cool
' кожны канал адлюстроўваецца з выкарыстаннем халоднай каляровай схемы
- '
magma
' кожны канал адлюстроўваецца з дапамогай каляровай схемы магмы
- '
green
' кожны канал адлюстроўваецца з дапамогай зялёнай каляровай схемы
- '
viridis
' кожны канал адлюстроўваецца з дапамогай каляровай схемы Viridis
- '
plasma
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы плазмы
- '
cividis
' кожны канал адлюстроўваецца з выкарыстаннем каляровай схемы cividis
- '
terrain
' кожны канал адлюстроўваецца з дапамогай каляровай схемы мясцовасці
Значэнне па змаўчанні '
intensity
'.- '
scale
Укажыце шкалу, якая выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру.
Ён прымае наступныя значэнні:
- '
lin
' лінейны
- '
sqrt
' квадратны корань, па змаўчанні
- '
cbrt
' кубічны корань
- '
log
' лагарыфмічны
- '
4thrt
' 4-ы корань
- '
5thrt
' 5-ы корань
Значэнне па змаўчанні '
log
'.- '
fscale
Укажыце шкалу частот.
Ён прымае наступныя значэнні:
- '
lin
' лінейны
- '
log
' лагарыфмічны
Значэнне па змаўчанні '
lin
'.- '
saturation
Усталюйце мадыфікатар насычанасці для адлюстраваных колераў. Адмоўныя значэнні забяспечваюць альтэрнатыўную каляровую схему.
0
зусім не насычэнне. Насычанасць павінна быць у дыяпазоне [-10,0, 10,0]. Значэнне па змаўчанні -1
.win_func
Усталяваць функцыю акна.
Ён прымае наступныя значэнні:
- '
rect
' - '
bartlett
' - '
hann
' - '
hanning
' - '
hamming
' - '
blackman
' - '
welch
' - '
flattop
' - '
bharris
' - '
bnuttall
' - '
bhann
' - '
sine
' - '
nuttall
' - '
lanczos
' - '
gauss
' - '
tukey
' - '
dolph
' - '
cauchy
' - '
parzen
' - '
poisson
' - '
bohman
'
Значэнне па змаўчанні -
hann
.- '
orientation
Усталюйце арыентацыю восі часу і частоты. Можа быць
vertical
абоhorizontal
. Па змаўчанніvertical
.gain
Усталюйце ўзмацненне маштабу для разліку значэнняў інтэнсіўнасці колеру. Значэнне па змаўчанні -
1
.legend
Малюйце восі часу і частоты і легенды. Па змаўчанні ўключана.
rotation
Задаць паварот колеру, павінен быць у дыяпазоне [-1,0, 1,0]. Значэнне па змаўчанні -
0
.start
Усталюйце пачатковую частату, з якой будзе паказвацца спектраграма. Па змаўчанні
0
.stop
Усталюйце частату прыпынку, да якой будзе паказвацца спектраграма. Па змаўчанні
0
.drange
Усталюйце дынамічны дыяпазон, які выкарыстоўваецца для разліку значэнняў інтэнсіўнасці колеру. Па змаўчанні 120 dBFS. Дазволены дыяпазон ад 10 да 200.
limit
Усталюйце верхнюю мяжу гучнасці ўваходных аўдыёсэмплоў у dBFS. Па змаўчанні 0 dBFS. Дазволены дыяпазон ад -100 да 100.
opacity
Усталюйце ўзровень непразрыстасці пры выкарыстанні вываду ў фармаце пікселяў з альфа-кампанентам.
16.25.1 Examples
- Вылучыце аўдыяспектраграму ўсёй аўдыядарожкі ў малюнку 1024x1024 з дапамогай
ffmpeg
:ffmpeg -i audio.flac -lavfi showspectrumpic=s=1024x1024 spectrogram.png
16.26 showvolume
Пераўтварыце гучнасць уваходнага аўдыя ў выхадны відэа.
Фільтр прымае наступныя параметры:
rate, r
Задаць хуткасць відэа.
b
Задаць шырыню мяжы, дазволены дыяпазон [0, 5]. Па змаўчанні 1.
w
Задаць шырыню канала, дазволены дыяпазон [80, 8192]. Па змаўчанні 400.
h
Задаць вышыню канала, дазволены дыяпазон [1, 900]. Па змаўчанні 20.
f
Задаць знікненне, дазволены дыяпазон [0, 1]. Па змаўчанні 0,95.
c
Усталюйце аб'ёмны каляровы выраз.
Выраз можа выкарыстоўваць наступныя зменныя:
VOLUME
Бягучая максімальная гучнасць канала ў дБ.
PEAK
Бягучы пік.
CHANNEL
Нумар бягучага канала, пачынаючы з 0.
t
Калі ўстаноўлена, адлюстроўвае назвы каналаў. Па змаўчанні ўключана.
v
Калі ўстаноўлена, адлюстроўвае значэнні гучнасці. Па змаўчанні ўключана.
o
Усталюйце арыентацыю, можа быць гарызантальнай:
h
або вертыкальнай:v
, па змаўчанніh
.s
Задаць памер кроку, дазволены дыяпазон [0, 5]. Па змаўчанні 0, што азначае крок адключаны.
p
Задаць непразрыстасць фону, дазволены дыяпазон [0, 1]. Па змаўчанні 0.
m
Усталюйце рэжым вымярэння, можа быць peak:
p
або rms:,r
па змаўчанні -p
.ds
Устанавіць маштаб адлюстравання, можа быць лінейным:
lin
або лагарыф:log
, па змаўчанніlin
.dm
У другім. Калі ўстаноўлена > 0., адлюстроўваць радок максімальнага ўзроўню за папярэднія секунды. па змаўчанні адключана:
0.
dmc
Колер максімальнай лініі. Выкарыстоўваць, калі
dm
параметр усталяваны ў > 0. Па змаўчанні:orange
16.27 showwaves
Пераўтварэнне ўваходнага аўдыё ў відэавыхад, які прадстаўляе ўзоры хваль.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
600x240
.mode
Усталюйце рэжым адлюстравання.
Даступныя значэнні:
- '
point
' Намалюйце кропку для кожнага ўзору.
- '
line
' Правядзіце вертыкальную лінію для кожнага ўзору.
- '
p2p
' Намалюйце кропку для кожнага ўзору і лінію паміж імі.
- '
cline
' Правядзіце па цэнтры вертыкальную лінію для кожнага ўзору.
Значэнне па змаўчанні -
point
.- '
n
Усталюйце колькасць узораў, якія друкуюцца на адным слупку. Большае значэнне знізіць частату кадраў. Павінен быць дадатным цэлым лікам. Гэты параметр можа быць усталяваны, толькі калі значэнне для
rate
не вызначана відавочна.rate, r
Усталюйце (прыблізную) выходную частату кадраў. Гэта робіцца шляхам усталявання опцыі
n
. Значэнне па змаўчанні - "25".split_channels
Усталюйце, калі каналы павінны малявацца асобна або перакрывацца. Значэнне па змаўчанні 0.
colors
Задайце колеры, падзеленыя знакам '|' якія збіраюцца выкарыстоўваць для малявання кожнага канала.
scale
Усталюйце шкалу амплітуды.
Даступныя значэнні:
- '
lin
' Лінейны.
- '
log
' Лагарыфмічны.
- '
sqrt
' Квадратны корань.
- '
cbrt
' Кубічны корань.
Па змаўчанні лінейны.
- '
draw
Усталюйце рэжым малявання. Часцей за ўсё гэта карысна ўсталяваць для высокага ўзроўню
n
.Даступныя значэнні:
- '
scale
' Маштабуйце значэнні пікселяў для кожнага намаляванага ўзору.
- '
full
' Намалюйце кожны ўзор непасрэдна.
Значэнне па змаўчанні -
scale
.- '
16.27.1 Examples
- Адначасова вывядзіце аўдыё ўваходнага файла і адпаведнае відэа:
amovie=a.mp3,asplit[out0],showwaves[out1]
- Стварыце сінтэтычны сігнал і пакажыце яго з дапамогай шоў-хваляў, усталяваўшы частату кадраў 30 кадраў у секунду:
aevalsrc=sin(1*2*PI*t)*sin(880*2*PI*t):cos(2*PI*200*t),asplit[out0],showwaves=r=30[out1]
16.28 showwavespic
Пераўтварэнне ўваходнага гуку ў адзін відэакадр, які прадстаўляе хвалі выбарак.
Фільтр прымае наступныя параметры:
size, s
Укажыце памер відэа для вываду. Сінтаксіс гэтай опцыі глядзіце ў раздзеле (ffmpeg-utils) «Памер відэа» ў кіраўніцтве ffmpeg-utils . Значэнне па змаўчанні -
600x240
.split_channels
Усталюйце, калі каналы павінны малявацца асобна або перакрывацца. Значэнне па змаўчанні 0.
colors
Задайце колеры, падзеленыя знакам '|' якія збіраюцца выкарыстоўваць для малявання кожнага канала.
scale
Усталюйце шкалу амплітуды.
Даступныя значэнні:
- '
lin
' Лінейны.
- '
log
' Лагарыфмічны.
- '
sqrt
' Квадратны корань.
- '
cbrt
' Кубічны корань.
Па змаўчанні лінейны.
- '
draw
Усталюйце рэжым малявання.
Даступныя значэнні:
- '
scale
' Маштабуйце значэнні пікселяў для кожнага намаляванага ўзору.
- '
full
' Намалюйце кожны ўзор непасрэдна.
Значэнне па змаўчанні -
scale
.- '
filter
Усталюйце рэжым фільтра.
Даступныя значэнні:
- '
average
' Выкарыстоўвайце сярэднія значэнні ўзораў для кожнага ўзятага ўзору.
- '
peak
' Выкарыстоўвайце пікавыя значэнні ўзораў для кожнага ўзятага ўзору.
Значэнне па змаўчанні -
average
.- '
16.28.1 Examples
- Вылучыце прадстаўленне падзелу канала формы хвалі цэлай гукавой дарожкі ў выяве 1024x800 з дапамогай
ffmpeg
:ffmpeg -i audio.flac -lavfi showwavespic=split_channels=1:s=1024x800 waveform.png
16.29 sidedata, asidedata
Выдаліце ​​бакавыя даныя кадра або выберыце кадры на іх аснове.
Гэты фільтр прымае наступныя параметры:
mode
Задайце рэжым працы фільтра.
Можа быць адно з наступнага:
- '
select
' Выберыце кожны кадр з бакавымі дадзенымі
type
.- '
delete
' Выдаліць пабочныя дадзеныя
type
. Каліtype
не ўстаноўлена, выдаліць усе бакавыя даныя ў кадры.
- '
type
Усталюйце бакавы тып даных, які выкарыстоўваецца ва ўсіх рэжымах. Неабходна ўсталяваць
select
рэжым. Для атрымання спісу тыпаў даных на баку кадра звярніцеся даAVFrameSideDataType
пералічэння ўlibavutil/frame.h
. Напрыклад, каб выбрацьAV_FRAME_DATA_PANSCAN
пабочныя даныя, неабходна ўказацьPANSCAN
.
16.30 spectrumsynth
Сінтэз аўдыя з 2 уваходных відэаспектраў, першы ўваходны паток уяўляе велічыню ў часе, а другі ўяўляе фазу ў часе. Фільтр ператворыцца з частотнай вобласці, якая адлюстроўваецца ў відэа, у часовую вобласць, якая прадстаўлена ў аўдыявыхадзе.
Гэты фільтр у першую чаргу створаны для рэверсавання апрацаваных вынікаў фільтра showspectrum
, але можа сінтэзаваць гук і з іншых спектраграм. Але ў такім выпадку вынікі будуць дрэннымі, калі даныя фазы недаступныя, таму што ў такіх выпадках даныя фазы трэба аднавіць, звычайна яны проста ўзнаўляюцца з выпадковага шуму. Для дасягнення найлепшых вынікаў выкарыстоўвайце вывад толькі ў шэрым колеры ( channel
каляровы рэжым у
фільтры showspectrum ) і log
шкалу для магнітуднага відэа і
lin
маштаб для фазавага відэа. Каб стварыць фазу, для 2-га відэа выкарыстоўвайце
data
параметр. Уваходныя відэа звычайна павінны выкарыстоўваць fullframe
слайд-рэжым, паколькі гэта эканоміць рэсурсы, неабходныя для дэкадавання відэа.
Фільтр прымае наступныя параметры:
sample_rate
Укажыце частату дыскрэтызацыі выхаднога гуку, частата дыскрэтызацыі гуку, з якога быў створаны спектр, можа адрознівацца.
channels
Устанавіць колькасць каналаў, прадстаўленых ва ўваходных відэаспектрах.
scale
Устанавіць маштаб, які выкарыстоўваўся пры генерацыі ўваходнага спектру велічыні. Можа быць
lin
абоlog
. Па змаўчанніlog
.slide
Усталюйце слайд, які выкарыстоўваўся пры генерацыі ўваходных спектраў. Можа быць
replace
,scroll
,fullframe
абоrscroll
. Па змаўчанніfullframe
.win_func
Задаць функцыю акна, якая выкарыстоўваецца для паўторнага сінтэзу.
overlap
Усталюйце перакрыцце вокнаў. У дыяпазоне
[0, 1]
. Па змаўчанні ўстаноўлена1
, што азначае, што будзе выбрана аптымальнае перакрыцце для выбранай функцыі акна.orientation
Задаць арыентацыю ўваходных відэа. Можа быць
vertical
абоhorizontal
. Па змаўчанніvertical
.
16.30.1 Examples
- Спачатку стварыце відэа з амплітуды і фазы з аўдыя, мяркуючы, што аўдыё стэрэа з частатой дыскрэтызацыі 44 100, а потым паўторна сінтэзуйце відэа ў аўдыя з дапамогай spectrumsynth:
ffmpeg -i input.flac -lavfi showspectrum=mode=separate:scale=log:overlap=0.875:color=channel:slide=fullframe:data=magnitude -an -c:v rawvideo magnitude.nut ffmpeg -i input.flac -lavfi showspectrum=mode=separate:scale=lin:overlap=0.875:color=channel:slide=fullframe:data=phase -an -c:v rawvideo phase.nut ffmpeg -i magnitude.nut -i phase.nut -lavfi spectrumsynth=channels=2:sample_rate=44100:win_func=hann:overlap=0.875:slide=fullframe output.flac
16.31 split, asplit
Падзяліць уваход на некалькі аднолькавых выхадаў.
asplit
працуе з аўдыё ўваходам, split
з відэа.
Фільтр прымае адзіны параметр, які вызначае колькасць выхадаў. Калі не пазначана, па змаўчанні 2.
16.31.1 Examples
- Стварыце два асобных выхаду з аднаго ўводу:
[in] split [out0][out1]
- Каб стварыць 3 ці больш выхадаў, вам трэба пазначыць колькасць выхадаў, як у:
[in] asplit=3 [out0][out1][out2]
- Стварыце два асобных вываду з аднаго ўводу, адзін абрэзаны, а другі дапоўнены:
[in] split [splitout1][splitout2]; [splitout1] crop=100:100:0:0 [cropout]; [splitout2] pad=200:200:100:100 [padout];
- Стварыце 5 копій уваходнага аўдыё з дапамогай
ffmpeg
:ffmpeg -i INPUT -filter_complex asplit=5 OUTPUT
16.32 zmq, azmq
Атрымлівайце каманды, адпраўленыя праз кліент libzmq, і перасылайце іх у фільтры ў filtergraph.
zmq
і azmq
працуюць як прахадныя фільтры. zmq
павінен быць устаўлены паміж двума відэафільтрамі, azmq
паміж двума аўдыяфільтрамі. Абодва здольныя адпраўляць паведамленні на любы тып фільтра.
Каб уключыць гэтыя фільтры, неабходна ўсталяваць бібліятэку libzmq і загалоўкі, а таксама наладзіць FFmpeg з дапамогай --enable-libzmq
.
Для атрымання дадатковай інфармацыі аб libzmq глядзіце: http://www.zeromq.org/
Фільтры zmq
і azmq
працуюць як сервер libzmq, які атрымлівае паведамленні, адпраўленыя праз сеткавы інтэрфейс, вызначаны ў
bind_address
(або абрэвіятура "b
"). Значэнне гэтага параметра па змаўчанні роўнаtcp://localhost:5555
. Магчыма, вы захочаце змяніць гэтае значэнне ў адпаведнасці з вашымі патрэбамі, але не забудзьцеся экранаваць любыя знакі ':' (гл. Экранаванне фільтраграфа ).
Атрыманае паведамленне павінна быць у форме:
TARGET
COMMAND
[ARG
]
TARGET
задае мэту каманды, звычайна імя класа фільтра або імя канкрэтнага асобніка фільтра. Імя асобніка фільтра па змаўчанні выкарыстоўвае шаблон 'Parsed_<filter_name>_<index>
', але вы можаце перавызначыць гэта з дапамогай 'filter_name@id
' сінтаксіс (гл . Сінтаксіс Filtergraph ).
COMMAND
задае назву каманды для мэтавага фільтра.
ARG
не з'яўляецца абавязковым і вызначае неабавязковы спіс аргументаў для дадзенага COMMAND
.
Пасля атрымання паведамленне апрацоўваецца і адпаведная каманда ўводзіцца ў фільтраграму. У залежнасці ад выніку фільтр адправіць кліенту адказ у фармаце:
ERROR_CODE
ERROR_REASON
MESSAGE
MESSAGE
не з'яўляецца абавязковым.
16.32.1 Examples
Паглядзіцеtools/zmqsend
для прыкладу кліента zmq, які можна выкарыстоўваць для адпраўкі каманд, апрацаваных гэтымі фільтрамі.
Разгледзім наступны графік фільтра, створаны ffplay
. У гэтым прыкладзе апошні фільтр накладання мае імя асобніка. Усе астатнія фільтры будуць мець імёны асобнікаў па змаўчанні.
ffplay -dumpgraph 1 -f lavfi "
color=s=100x100:c=red [l];
color=s=100x100:c=blue [r];
nullsrc=s=200x100, zmq [bg];
[bg][l] overlay [bg+l];
[bg+l][r] overlay@my=x=100 "
Каб змяніць колер левага боку відэа, можна выкарыстоўваць наступную каманду:
echo Parsed_color_0 c yellow | tools/zmqsend
Каб змяніць правы бок:
echo Parsed_color_1 c pink | tools/zmqsend
Каб змяніць становішча правага боку:
echo overlay@my x 150 | tools/zmqsend
17 Multimedia Sources
Ніжэй прыводзіцца апісанне даступных на дадзены момант мультымедыйных крыніц.
17.1 amovie
Гэта тое ж самае, што крыніца фільма , за выключэннем таго, што па змаўчанні выбіраецца аўдыяплынь.
17.2 avsynctest
Стварыце тэст сінхранізацыі аўдыё/відэа.
Згенераваны паток перыядычна паказвае кадр флэш-відэа і выдае гукавы сігнал у гуку. Карысна для праверкі праблем з сінхранізацыяй A/V.
Ён прымае наступныя варыянты:
size, s
Задаць памер выхаднога відэа. Значэнне па змаўчанні -
hd720
.framerate, fr
Задаць частату кадраў выхаднога відэа. Значэнне па змаўчанні -
30
.samplerate, sr
Задаць частату дыскрэтызацыі выхаднога гуку. Значэнне па змаўчанні -
44100
.amplitude, a
Усталюйце амплітуду выхаднога гукавога сігналу. Значэнне па змаўчанні -
0.7
.period, p
Усталюйце перыяд выхаднога гукавога сігналу ў секундах. Значэнне па змаўчанні -
3
.delay, dl
Усталюйце затрымку ўспышкі выхаднога відэа ў колькасці кадраў. Значэнне па змаўчанні -
0
.cycle, c
Уключыць перыядычныя затрымкі відэа, па змаўчанні адключана.
duration, d
Задаць працягласць вываду патоку. Па змаўчанні працягласць неабмежаваная.
fg, bg, ag
Устанавіць колер пярэдняга/фонавага/дадатковага плана.
17.3 movie
Чытанне аўдыя- і/або відэаструменяў з кантэйнера фільмаў.
Ён прымае наступныя параметры:
filename
Імя рэсурсу для чытання (неабавязкова файла; гэта таксама можа быць прылада або паток, доступ да якога ажыццяўляецца праз нейкі пратакол).
format_name, f
Вызначае фармат, які мяркуецца для чытання фільма, і можа быць назвай кантэйнера або прылады ўводу. Калі не пазначана, фармат адгадваецца з
movie_name
або шляхам зандзіравання.seek_point, sp
Вызначае кропку пошуку ў секундах. Кадры будуць выводзіцца, пачынаючы з гэтай кропкі пошуку. Параметр ацэньваецца з дапамогай
av_strtod
, так што лікавае значэнне можа быць суфіксаваны постфіксам IS. Значэнне па змаўчанні - "0".streams, s
Вызначае патокі для чытання. Можна ўказаць некалькі патокаў, падзеленыя знакам "+". Затым крыніца будзе мець столькі ж вывадаў у тым жа парадку. Сінтаксіс тлумачыцца ў (ffmpeg) раздзеле "Спецыфікатары патоку" ў кіраўніцтве ffmpeg . Дзве спецыяльныя назвы, "dv" і "da" вызначаюць адпаведна стандартныя (найлепш прыдатныя) відэа- і аўдыяплыні. Па змаўчанні - "dv" або "da", калі фільтр называецца "amovie".
stream_index, si
Вызначае індэкс відэаплыні для чытання. Калі значэнне роўна -1, будзе аўтаматычна абраны найбольш прыдатны відэаструмень. Значэнне па змаўчанні - "-1". Састарэла. Калі фільтр называецца "amovie", ён будзе выбіраць аўдыя замест відэа.
loop
Вызначае, колькі разоў паслядоўна чытаць паток. Калі значэнне роўна 0, паток будзе бясконца зацыклены. Значэнне па змаўчанні - "1".
Звярніце ўвагу, што калі фільм зацыкліваецца, зыходныя пазнакі часу не змяняюцца, таму ён будзе ствараць неманатонна ўзрастаючыя пазнакі часу.
discontinuity
Вызначае розніцу ў часе паміж кадрамі, вышэй якой кропка лічыцца разрывам часовай меткі, якая выдаляецца шляхам карэкціроўкі пазнейшых часавых пазнак.
dec_threads
Задае колькасць патокаў для дэкадавання
format_opts
Пакажыце параметры фармату для адкрытага файла. Параметры фармату можна задаць як спіс пар
key
=value
, падзеленых знакам ':'. У наступным прыкладзе паказана, як дадаць параметры protocol_whitelist і protocol_blacklist:ffplay -f lavfi "movie=filename='1.sdp':format_opts='protocol_whitelist=file,rtp,udp\:protocol_blacklist=http'"
Гэта дазваляе накласці другое відэа на асноўны ўваход фільтра, як паказана на гэтым графіку:
input -----------> deltapts0 --> overlay --> output
^
|
movie --> scale--> deltapts1 -------+
17.3.1 Examples
- Прапусціце 3,2 секунды ад пачатку файла AVI in.avi і накладзеце яго на ўвод з надпісам "in":
movie=in.avi:seek_point=3.2, scale=180:-1, setpts=PTS-STARTPTS [over]; [in] setpts=PTS-STARTPTS [main]; [main][over] overlay=16:16 [out]
- Прачытайце з прылады video4linux2 і накладзіце яго на ўвод, пазначаны "in":
movie=/dev/video0:f=video4linux2, scale=180:-1, setpts=PTS-STARTPTS [over]; [in] setpts=PTS-STARTPTS [main]; [main][over] overlay=16:16 [out]
- Прачытаць першы відэаструмень і аўдыяструмень з ідэнтыфікатарам 0x81 з dvd.vob; відэа падлучана да пляцоўкі пад назвай «відэа», а аўдыя падлучана да пляцоўкі пад назвай «аўдыё»:
movie=dvd.vob:s=v:0+#0x81 [video] [audio]
17.3.2 Commands
І movie, і amovie падтрымліваюць наступныя каманды:
seek
Выканайце пошук з дапамогай «av_seek_frame». Сінтаксіс: шукаць
stream_index
|timestamp
|flags
-
stream_index
: Калі stream_index роўны -1, выбіраецца паток па змаўчанні,timestamp
які аўтаматычна пераўтворыцца з адзінак AV_TIME_BASE ў спецыфічную базу часу_патоку. -
timestamp
: Метка часу ў адзінках AVStream.time_base або, калі паток не ўказаны, у адзінках AV_TIME_BASE. -
flags
: Сцяжкі, якія выбіраюць кірунак і рэжым пошуку.
-
get_duration
Атрымайце працягласць фільма ў адзінках AV_TIME_BASE.
18 See Also
ffmpeg , ffplay , ffprobe , libavfilter
19 Authors
Распрацоўшчыкі ffmpeg.
Для атрымання падрабязнай інфармацыі аб аўтарстве глядзіце гісторыю Git праекта (git://source.ffmpeg.org/ffmpeg), напрыклад, увёўшы каманду
git log
ў каталогу зыходных кодаў FFmpeg або прагледзеўшы інтэрнэт-рэпазітар па адрасе http://source. ffmpeg.org .
Абслугоўвальнікі для канкрэтных кампанентаў пералічаны ў файле
MAINTAINERS
у дрэве зыходнага кода.
Гэты дакумент быў створаны 11 ліпеня 2022 г. з дапамогай makeinfo .
Хостынг прадастаўляецца telepoint.bg