ffprobe

JADUAL:

NAMA

ffprobe - prober media ffprobe

SINOPSIS

ffprobe [pilihan] [input_file]

DESCRIPTION

ffprobe mengumpulkan maklumat daripada aliran multimedia dan mencetaknya dalam manusia dan mesin-
fesyen yang boleh dibaca.

Contohnya ia boleh digunakan untuk menyemak format bekas yang digunakan oleh sesebuah multimedia
aliran dan format serta jenis setiap aliran media yang terkandung di dalamnya.

Jika nama fail dinyatakan dalam input, ffprobe akan cuba membuka dan menyiasat kandungan fail.
Jika fail tidak boleh dibuka atau dikenali sebagai fail multimedia, kod keluar positif ialah
kembali.

ffprobe boleh digunakan sebagai aplikasi kendiri atau digabungkan dengan teks
penapis, yang mungkin melakukan pemprosesan yang lebih canggih, contohnya pemprosesan statistik atau
merancang.

Pilihan digunakan untuk menyenaraikan beberapa format yang disokong oleh ffprobe atau untuk menentukan yang mana
maklumat untuk dipaparkan, dan untuk menetapkan cara ffprobe akan menunjukkannya.

Output ffprobe direka bentuk untuk mudah dihuraikan oleh penapis teks, dan terdiri daripada satu
atau lebih banyak bahagian borang yang ditakrifkan oleh penulis yang dipilih, yang ditentukan oleh
format_cetak pilihan.

Bahagian mungkin mengandungi bahagian bersarang lain dan dikenal pasti dengan nama (yang mungkin
dikongsi oleh bahagian lain), dan nama unik. Lihat output daripada bahagian.

Teg metadata yang disimpan dalam bekas atau dalam strim diiktiraf dan dicetak dalam
bahagian "FORMAT", "STREAM" atau "PROGRAM_STREAM" yang sepadan.

PILIHAN

Semua pilihan berangka, jika tidak dinyatakan sebaliknya, terima rentetan yang mewakili a
nombor sebagai input, yang mungkin diikuti oleh salah satu awalan unit SI, contohnya: 'K',
'M', atau 'G'.

Jika 'i' dilampirkan pada awalan unit SI, awalan lengkap akan ditafsirkan sebagai
awalan unit untuk gandaan binari, yang berdasarkan kuasa 1024 dan bukannya kuasa
1000. Menambah 'B' pada awalan unit SI mendarabkan nilai dengan 8. Ini membolehkan penggunaan,
contohnya: 'KB', 'MiB', 'G' dan 'B' sebagai akhiran nombor.

Pilihan yang tidak mengambil hujah ialah pilihan boolean dan tetapkan nilai yang sepadan
kepada benar. Ia boleh ditetapkan kepada palsu dengan memberi awalan nama pilihan dengan "tidak". Sebagai contoh
menggunakan "-nofoo" akan menetapkan pilihan boolean dengan nama "foo" kepada palsu.

Stream khusus
Sesetengah pilihan digunakan setiap strim, contohnya kadar bit atau codec. Penentu aliran digunakan untuk
nyatakan dengan tepat strim mana yang dimiliki oleh pilihan yang diberikan.

Penentu strim ialah rentetan yang biasanya dilampirkan pada nama pilihan dan dipisahkan daripadanya
oleh kolon. Cth "-codec:a:1 ac3" mengandungi penentu aliran "a:1", yang sepadan dengan
aliran audio kedua. Oleh itu, ia akan memilih codec ac3 untuk aliran audio kedua.

Penentu strim boleh memadankan beberapa strim, supaya pilihan digunakan pada semua
mereka. Cth penentu strim dalam "-b:a 128k" sepadan dengan semua strim audio.

Penentu strim kosong sepadan dengan semua strim. Contohnya, "-codec copy" atau "-codec:
copy" akan menyalin semua aliran tanpa pengekodan semula.

Bentuk penentu aliran yang mungkin adalah:

stream_index
Padankan strim dengan indeks ini. Cth "-threads:1 4" akan menetapkan kiraan thread untuk
aliran kedua hingga 4.

stream_type[:stream_index]
stream_type adalah salah satu daripada berikut: 'v' atau 'V' untuk video, 'a' untuk audio, 's' untuk
sari kata, 'd' untuk data, dan 't' untuk lampiran. 'v' sepadan dengan semua aliran video, 'V'
hanya sepadan dengan strim video yang tidak dilampirkan gambar, lakaran kecil video atau kulit
seni. Jika stream_index diberikan, maka ia sepadan dengan nombor aliran stream_index ini
taip. Jika tidak, ia sepadan dengan semua aliran jenis ini.

p:program_id[:stream_index]
If stream_index diberikan, maka ia sepadan dengan aliran dengan nombor stream_index dalam
program dengan id program_id. Jika tidak, ia sepadan dengan semua aliran dalam program.

#stream_id or i:stream_id
Padankan strim mengikut id strim (cth PID dalam bekas MPEG-TS).

m:utama[:nilai]
Memadankan strim dengan teg metadata utama mempunyai nilai yang ditetapkan. Jika nilai tidak
diberikan, memadankan strim yang mengandungi teg yang diberikan dengan sebarang nilai.

u Memadankan strim dengan konfigurasi yang boleh digunakan, codec mesti ditakrifkan dan yang penting
maklumat seperti dimensi video atau kadar sampel audio mesti ada.

Perhatikan bahawa dalam ffmpeg, pemadanan mengikut metadata hanya akan berfungsi dengan betul untuk fail input.

Generik pilihan
Pilihan ini dikongsi antara alat ff*.

-L Tunjukkan lesen.

-h, -?, -membantu, - membantu [berhujah]
Tunjukkan bantuan. Parameter pilihan mungkin ditentukan untuk mencetak bantuan tentang item tertentu.
Jika tiada hujah dinyatakan, hanya pilihan alat asas (bukan lanjutan) ditunjukkan.

Nilai yang mungkin bagi berhujah ialah:

lama
Cetak pilihan alat lanjutan sebagai tambahan kepada pilihan alat asas.

penuh
Cetak senarai lengkap pilihan, termasuk pilihan kongsi dan peribadi untuk pengekod,
dekoder, demuxer, muxer, penapis, dll.

penyahkod=nama_penyahkod
Cetak maklumat terperinci tentang penyahkod bernama nama_penyahkod. Menggunakan -dekoder
pilihan untuk mendapatkan senarai semua penyahkod.

pengekod=nama_pengekod
Cetak maklumat terperinci tentang pengekod yang dinamakan nama_pengekod. Menggunakan -pengekod
pilihan untuk mendapatkan senarai semua pengekod.

demuxer=nama_demuxer
Cetak maklumat terperinci tentang demuxer bernama nama_demuxer. Menggunakan -format
pilihan untuk mendapatkan senarai semua demuxer dan muxer.

muxer=muxer_name
Cetak maklumat terperinci tentang muxer bernama muxer_name. Menggunakan -format
pilihan untuk mendapatkan senarai semua muxer dan demuxer.

penapis=nama_penapis
Cetak maklumat terperinci tentang nama penapis nama_penapis. Menggunakan -penapis
pilihan untuk mendapatkan senarai semua penapis.

-turun
Tunjukkan versi.

-format
Tunjukkan format yang tersedia (termasuk peranti).

-peranti
Tunjukkan peranti yang tersedia.

-codec
Tunjukkan semua codec yang diketahui oleh libavcodec.

Ambil perhatian bahawa istilah 'codec' digunakan sepanjang dokumentasi ini sebagai jalan pintas untuk
apa yang lebih tepat dipanggil format aliran bit media.

-dekoder
Tunjukkan dekoder yang tersedia.

-pengekod
Tunjukkan semua pengekod yang tersedia.

-bsfs
Tunjukkan penapis aliran bit yang tersedia.

-protokol
Tunjukkan protokol yang tersedia.

-penapis
Tunjukkan penapis libavfilter yang tersedia.

-pix_fmts
Tunjukkan format piksel yang tersedia.

-sample_fmts
Tunjukkan format sampel yang tersedia.

-susun atur
Tunjukkan nama saluran dan susun atur saluran standard.

-warna
Tunjukkan nama warna yang diiktiraf.

-sumber peranti[,memilih1=val1[,memilih2=val2]...]
Tunjukkan sumber peranti input yang dikesan secara automatik. Sesetengah peranti mungkin menyediakan sistem-
nama sumber bergantung yang tidak boleh dikesan secara automatik. Senarai yang dikembalikan tidak boleh
diandaikan sentiasa lengkap.

ffmpeg -sources pulse,server=192.168.0.4

-tenggelam peranti[,memilih1=val1[,memilih2=val2]...]
Tunjukkan sinki peranti output yang dikesan secara automatik. Sesetengah peranti mungkin menyediakan sistem-
nama singki bergantung yang tidak boleh dikesan secara automatik. Senarai yang dikembalikan tidak boleh diandaikan
untuk sentiasa lengkap.

ffmpeg -menenggelamkan nadi,pelayan=192.168.0.4

-peringkat log [ulang+]tahap log | -v [ulang+]tahap log
Tetapkan tahap pengelogan yang digunakan oleh perpustakaan. Menambah "ulang+" menunjukkan bahawa berulang
output log tidak boleh dimampatkan ke baris pertama dan "Mesej terakhir diulang n
times" baris akan diabaikan. "repeat" juga boleh digunakan secara bersendirian. Jika "repeat" digunakan
sahaja, dan tanpa set loglevel sebelumnya, loglevel lalai akan digunakan. Jika berbilang
parameter loglevel diberikan, menggunakan 'repeat' tidak akan mengubah loglevel. tahap log
ialah rentetan atau nombor yang mengandungi salah satu daripada nilai berikut:

senyap, -8
Tidak menunjukkan apa-apa; diamlah.

panik, 0
Hanya tunjukkan ralat maut yang boleh menyebabkan proses ranap, seperti dan menegaskan
kegagalan. Ini tidak digunakan pada masa ini untuk apa-apa.

maut, 8
Hanya tunjukkan ralat yang membawa maut. Ini adalah ralat yang selepas itu proses benar-benar tidak boleh
sambung selepas.

kesilapan, 16
Tunjukkan semua ralat, termasuk ralat yang boleh dipulihkan.

amaran, 24
Tunjukkan semua amaran dan ralat. Sebarang mesej yang berkaitan dengan kemungkinan salah atau
peristiwa yang tidak dijangka akan ditunjukkan.

maklumat, 32
Tunjukkan mesej bermaklumat semasa pemprosesan. Ini adalah tambahan kepada amaran dan
kesilapan. Ini ialah nilai lalai.

bertele-tele, 40
Sama seperti "maklumat", kecuali lebih bertele-tele.

nyahpepijat, 48
Tunjukkan segala-galanya, termasuk maklumat penyahpepijatan.

jejak, 56

Secara lalai program log ke stderr, jika pewarnaan disokong oleh terminal,
warna digunakan untuk menandakan ralat dan amaran. Pewarna log boleh dinyahdayakan menetapkan
pembolehubah persekitaran AV_LOG_FORCE_NOCOLOR or NO_COLOR, atau boleh dipaksa menetapkan
pembolehubah persekitaran AV_LOG_FORCE_COLOR. Penggunaan pembolehubah persekitaran NO_COLOR
ditamatkan dan akan digugurkan dalam versi FFmpeg berikut.

-laporan
Buang baris arahan penuh dan output konsol ke fail bernama
"program-YYYYMMDD-HHMMSS.log" dalam direktori semasa. Fail ini boleh berguna untuk
laporan pepijat. Ia juga membayangkan "kata kerja-loglevel".

Menetapkan pembolehubah persekitaran FFREPORT kepada mana-mana nilai mempunyai kesan yang sama. Sekiranya
nilai ialah ':'-separated key=jujukan nilai, pilihan ini akan mempengaruhi laporan;
nilai pilihan mesti dilepaskan jika ia mengandungi aksara khas atau pilihan
pembatas ':' (lihat bahagian ``Petikan dan melarikan diri'' dalam manual ffmpeg-utils).

Pilihan berikut diiktiraf:

fail
tetapkan nama fail untuk digunakan untuk laporan; %p dikembangkan kepada nama
program, %t dikembangkan kepada cap masa, "%%" dikembangkan kepada "%" biasa

tahap
tetapkan tahap verbositi log menggunakan nilai berangka (lihat "-loglevel").

Sebagai contoh, untuk mengeluarkan laporan kepada fail bernama ffreport.log menggunakan tahap log 32
(alias untuk "info" peringkat log:

FFREPORT=file=ffreport.log:level=32 ffmpeg -i output input

Ralat dalam menghuraikan pembolehubah persekitaran tidak membawa maut, dan tidak akan muncul dalam
melaporkan.

-sembunyikan_banner
Sekat percetakan sepanduk.

Semua alat FFmpeg biasanya akan menunjukkan notis hak cipta, pilihan binaan dan perpustakaan
versi. Pilihan ini boleh digunakan untuk menyekat pencetakan maklumat ini.

-cpuflags bendera (global)
Membenarkan menetapkan dan mengosongkan bendera cpu. Pilihan ini bertujuan untuk ujian. Jangan guna
melainkan anda tahu apa yang anda lakukan.

ffmpeg -cpuflags -sse+mmx ...
ffmpeg -cpuflags mmx ...
ffmpeg -cpuflags 0 ...

Bendera yang mungkin untuk pilihan ini ialah:

x86
MMX
mmxxt
ess
sse2
sse2slow
sse3
sse3slow
ssse3
atom
sse4.1
sse4.2
avx
avx2
xop
fma3
fma4
3dnow
3dnowet
bmi1
bmi2
cmov
ARM
armv5te
armv6
armv6t2
vfp
vfpv3
neon
setend
AAArch64
armv8
vfp
neon
PowerPC
altivec
Khusus Pemproses
Pentium 2
Pentium 3
Pentium 4
k6
k62
Athlon
athlonxp
k8
-opencl_bench
Pilihan ini digunakan untuk menanda aras semua peranti OpenCL yang tersedia dan mencetak hasilnya.
Pilihan ini hanya tersedia apabila FFmpeg telah disusun dengan "--enable-opencl".

Apabila FFmpeg dikonfigurasikan dengan "--enable-opencl", pilihan untuk OpenCL global
konteks ditetapkan melalui -opencl_options. Lihat bahagian "OpenCL Options" dalam ffmpeg-
utils manual untuk senarai lengkap pilihan yang disokong. Antara lain, pilihan ini
termasuk keupayaan untuk memilih platform dan peranti tertentu untuk menjalankan kod OpenCL
pada. Secara lalai, FFmpeg akan berjalan pada peranti pertama platform pertama. Sementara
pilihan untuk konteks OpenCL global memberikan fleksibiliti kepada pengguna dalam memilih
Peranti OpenCL pilihan mereka, kebanyakan pengguna mungkin mahu memilih yang terpantas
Peranti OpenCL untuk sistem mereka.

Pilihan ini membantu pemilihan konfigurasi yang paling cekap dengan mengenal pasti
peranti yang sesuai untuk sistem pengguna. Penanda aras terbina dalam dijalankan pada semua
Peranti OpenCL dan prestasi diukur untuk setiap peranti. Peranti dalam
senarai keputusan diisih berdasarkan prestasi mereka dengan peranti terpantas disenaraikan
pertama. Pengguna kemudiannya boleh memanggil ffmpeg menggunakan peranti yang dianggap paling banyak
sesuai melalui -opencl_options untuk mendapatkan prestasi terbaik untuk OpenCL
kod dipercepatkan.

Penggunaan biasa untuk menggunakan peranti OpenCL terpantas melibatkan langkah-langkah berikut.

Jalankan arahan:

ffmpeg -opencl_bench

Catatkan ID platform (pidx) dan ID peranti (didx) daripada peranti pertama iaitu terpantas
dalam senarai. Pilih platform dan peranti menggunakan arahan:

ffmpeg -opencl_options platform_idx= :device_idx= ...

-opencl_options pilihan (global)
Tetapkan pilihan persekitaran OpenCL. Pilihan ini hanya tersedia apabila FFmpeg telah
disusun dengan "--enable-opencl".

pilihan mestilah senarai utama=nilai pasangan pilihan dipisahkan dengan ':'. Lihat ``OpenCL
Bahagian pilihan dalam manual ffmpeg-utils untuk senarai pilihan yang disokong.

AVOptions
Pilihan ini disediakan secara langsung oleh libavformat, libavdevice dan libavcodec
perpustakaan. Untuk melihat senarai AVOptions yang tersedia, gunakan -membantu pilihan. Mereka adalah
dibahagikan kepada dua kategori:

generik
Pilihan ini boleh ditetapkan untuk mana-mana bekas, codec atau peranti. Pilihan generik ialah
disenaraikan di bawah pilihan AVFormatContext untuk bekas/peranti dan di bawah AVCodecContext
pilihan untuk codec.

swasta
Pilihan ini khusus untuk bekas, peranti atau codec yang diberikan. Pilihan peribadi
disenaraikan di bawah bekas/peranti/codec yang sepadan.

Contohnya untuk menulis pengepala ID3v2.3 dan bukannya ID3v2.4 lalai pada fail MP3, gunakan
yang id3v2_version pilihan peribadi muxer MP3:

ffmpeg -i input.flac -id3v2_version 3 out.mp3

Semua codec AVOptions adalah per-strim, dan oleh itu penentu aliran harus dilampirkan pada
Mereka.

Nota: the -nooption sintaks tidak boleh digunakan untuk AVOptions boolean, gunakan -pilihan 0/-pilihan 1.

Nota: cara lama yang tidak didokumenkan untuk menentukan AVOptions setiap aliran dengan menambahkan v/a/s kepada
nama pilihan kini sudah usang dan akan dialih keluar tidak lama lagi.

Utama pilihan
-f format
Paksa format untuk digunakan.

-unit
Tunjukkan unit nilai yang dipaparkan.

-awalan
Gunakan awalan SI untuk nilai yang dipaparkan. Melainkan pilihan "-byte_binary_prefix" ialah
digunakan semua awalan adalah perpuluhan.

-byte_binary_prefix
Paksa penggunaan awalan binari untuk nilai bait.

-seksagesimal
Gunakan format sexagesimal HH:MM:SS.MICROSECONDS untuk nilai masa.

-cantik
Cantikkan format nilai yang dipaparkan, ia sepadan dengan pilihan "-unit
-awalan -byte_binary_prefix -sexagesimal".

-daripada, -format_cetak nama_penulis[=pilihan_penulis]
Tetapkan format cetakan output.

nama_penulis menyatakan nama penulis, dan pilihan_penulis menentukan pilihan
untuk disampaikan kepada penulis.

Contohnya untuk mencetak output dalam format JSON, nyatakan:

-print_format json

Untuk butiran lanjut tentang format pencetakan output yang tersedia, lihat bahagian Penulis
di bawah.

-bahagian
Cetak bahagian struktur dan maklumat bahagian, dan keluar. Keluaran tidak dimaksudkan
dihuraikan oleh mesin.

-select_streams stream_specifier
Pilih hanya strim yang ditentukan oleh stream_specifier. Pilihan ini hanya mempengaruhi
pilihan yang berkaitan dengan strim (cth. "show_streams", "show_packets", dsb.).

Contohnya untuk menunjukkan hanya aliran audio, anda boleh menggunakan arahan:

ffprobe -show_streams -select_streams a INPUT

Untuk menunjukkan hanya paket video kepunyaan strim video dengan indeks 1:

ffprobe -show_packets -select_streams v:1 INPUT

-tunjukkan_data
Tunjukkan data muatan, sebagai heksadesimal dan longgokan ASCII. Ditambah pula dengan -paket_tunjukkan, Ia
akan membuang data paket. Ditambah pula dengan -show_streams, ia akan membuang codec
data tambahan.

Tempat pembuangan dicetak sebagai medan "data". Ia mungkin mengandungi baris baharu.

-show_data_hash algoritma
Tunjukkan cincang data muatan, untuk paket dengan -paket_tunjukkan dan untuk extradata codec
bersama -show_streams.

-show_error
Tunjukkan maklumat tentang ralat yang ditemui semasa cuba menyiasat input.

Maklumat ralat dicetak dalam bahagian dengan nama "ERROR".

-format_tunjuk
Tunjukkan maklumat tentang format bekas aliran multimedia input.

Semua maklumat format bekas dicetak dalam bahagian dengan nama "FORMAT".

-show_format_entry nama
suka -format_tunjuk, tetapi hanya mencetak masukan yang ditentukan bagi format bekas
maklumat, bukannya semua. Pilihan ini boleh diberikan lebih daripada sekali, kemudian semua
entri yang ditetapkan akan ditunjukkan.

Pilihan ini ditamatkan, gunakan "show_entry" sebaliknya.

-show_entry bahagian_entri
Tetapkan senarai entri untuk ditunjukkan.

Entri ditentukan mengikut sintaks berikut. bahagian_entri mengandungi a
senarai entri bahagian dipisahkan oleh ":". Setiap entri bahagian dikarang oleh bahagian
nama (atau nama unik), secara pilihan diikuti dengan senarai entri setempat ke bahagian itu,
dipisahkan oleh ",".

Jika nama bahagian dinyatakan tetapi diikuti dengan tiada "=", semua entri dicetak ke
output, bersama-sama dengan semua bahagian yang terkandung. Jika tidak hanya entri yang dinyatakan
dalam senarai entri bahagian tempatan dicetak. Khususnya, jika "=" dinyatakan tetapi
senarai entri tempatan kosong, maka tiada entri akan ditunjukkan untuk bahagian tersebut.

Ambil perhatian bahawa susunan spesifikasi entri bahagian tempatan tidak dihormati
output, dan susunan paparan biasa akan dikekalkan.

Sintaks formal diberikan oleh:

::= [, ]
::= [=[ ]]
::= [: ]

Contohnya, untuk menunjukkan hanya indeks dan jenis setiap aliran, dan masa PTS,
tempoh masa, dan indeks aliran paket, anda boleh menentukan hujah:

packet=pts_time, duration_time,stream_index : stream=index,codec_type

Untuk menunjukkan semua entri dalam bahagian "format", tetapi hanya jenis codec dalam
bahagian "strim", nyatakan hujah:

format : stream=codec_type

Untuk menunjukkan semua teg dalam bahagian strim dan format:

stream_tags : format_tags

Untuk menunjukkan hanya teg "tajuk" (jika tersedia) dalam bahagian strim:

stream_tags=tajuk

-paket_tunjukkan
Tunjukkan maklumat tentang setiap paket yang terkandung dalam aliran multimedia input.

Maklumat untuk setiap paket tunggal dicetak dalam bahagian khusus dengan nama
"PAKET".

-show_frames
Tunjukkan maklumat tentang setiap bingkai dan sari kata yang terkandung dalam multimedia input
aliran.

Maklumat untuk setiap bingkai tunggal dicetak dalam bahagian khusus dengan nama
"FRAME" atau "SARIKATA".

-show_streams
Tunjukkan maklumat tentang setiap aliran media yang terkandung dalam aliran multimedia input.

Setiap maklumat aliran media dicetak dalam bahagian khusus dengan nama
"ALIRAN".

-tunjukkan_program
Tunjukkan maklumat tentang program dan alirannya yang terkandung dalam multimedia input
aliran.

Setiap maklumat aliran media dicetak dalam bahagian khusus dengan nama
"PROGRAM_STREAM".

-show_bab
Tunjukkan maklumat tentang bab yang disimpan dalam format.

Setiap bab dicetak dalam bahagian khusus dengan nama "BAB".

-bilangan_bingkai
Kira bilangan bingkai setiap strim dan laporkannya dalam strim yang sepadan
bawah seksyen ini.

-count_packets
Kira bilangan paket setiap aliran dan laporkannya dalam aliran yang sepadan
bawah seksyen ini.

-selang_baca selang_baca
Baca hanya selang yang ditentukan. selang_baca mestilah urutan selang
spesifikasi dipisahkan oleh ",". ffprobe akan mencari ke titik permulaan selang,
dan akan terus membaca daripada itu.

Setiap selang ditentukan oleh dua bahagian pilihan, dipisahkan dengan "%".

Bahagian pertama menentukan kedudukan mula selang. Ia ditafsirkan sebagai abolute
kedudukan, atau sebagai pengimbang relatif daripada kedudukan semasa jika ia didahului oleh
watak "+". Jika bahagian pertama ini tidak dinyatakan, tiada pencarian akan dilakukan apabila
membaca selang ini.

Bahagian kedua menentukan kedudukan akhir selang. Ia ditafsirkan sebagai mutlak
kedudukan, atau sebagai pengimbang relatif daripada kedudukan semasa jika ia didahului oleh
watak "+". Jika spesifikasi offset bermula dengan "#", ia ditafsirkan sebagai
bilangan paket untuk dibaca (tidak termasuk paket siram) dari selang waktu
mulakan. Jika tiada bahagian kedua dinyatakan, atur cara akan dibaca sehingga penghujung
input.

Ambil perhatian bahawa pencarian adalah tidak tepat, oleh itu titik mula selang sebenar mungkin
berbeza daripada kedudukan yang ditetapkan. Juga, apabila tempoh selang ditentukan,
masa tamat mutlak akan dikira dengan menambah tempoh pada permulaan selang
titik ditemui dengan mencari fail, bukannya nilai permulaan yang ditentukan.

Sintaks formal diberikan oleh:

::= [ |+ ][%[ |+ ]]
::= [, ]

Beberapa contoh berikut.

· Cari masa 10, baca paket sehingga 20 saat selepas titik carian ditemui, kemudian
cari kedudukan "01:30" (1 minit dan tiga puluh saat) dan baca paket sehingga
kedudukan "01:45".

10%+20,01:30%01:45

· Baca hanya 42 paket selepas mencari kedudukan "01:23":

01:23%+#42

· Baca hanya 20 saat pertama dari permulaan:

%+20

· Baca dari mula hingga kedudukan "02:30":

% 02:30

-tunjukkan_data_peribadi, -peribadi
Tunjukkan data peribadi, iaitu data bergantung pada format yang ditunjukkan
unsur. Pilihan ini didayakan secara lalai, tetapi anda mungkin perlu melumpuhkannya untuk
kegunaan khusus, contohnya apabila mencipta output XML yang mematuhi XSD.

-show_program_version
Tunjukkan maklumat yang berkaitan dengan versi program.

Maklumat versi dicetak dalam bahagian dengan nama "PROGRAM_VERSION".

-show_library_versions
Tunjukkan maklumat yang berkaitan dengan versi perpustakaan.

Maklumat versi untuk setiap perpustakaan dicetak dalam bahagian dengan nama
"VERSION_PERPUSTAKAAN".

-show_versions
Tunjukkan maklumat yang berkaitan dengan versi program dan perpustakaan. Ini adalah bersamaan dengan
menetapkan kedua-duanya -show_program_version and -show_library_versions pilihan.

-show_pixel_formats
Tunjukkan maklumat tentang semua format piksel yang disokong oleh FFmpeg.

Maklumat format piksel untuk setiap format dicetak dalam bahagian dengan nama
"PIXEL_FORMAT".

-bitexact
Force bitexact output, berguna untuk menghasilkan output yang tidak bergantung pada spesifik
membina.

-i input_file
Baca input_file.

PENULIS

Seorang penulis mentakrifkan format output yang diterima pakai oleh ffprobe, dan akan digunakan untuk mencetak semua
bahagian keluaran.

Seorang penulis boleh menerima satu atau lebih hujah, yang menentukan pilihan untuk diterima pakai. Pilihan
dinyatakan sebagai senarai utama=nilai pasangan, dipisahkan oleh ":".

Semua penulis menyokong pilihan berikut:

string_validation, sv
Tetapkan mod pengesahan rentetan.

Nilai berikut diterima.

gagal
Penulis akan gagal serta-merta sekiranya urutan rentetan (UTF-8) tidak sah atau
titik kod ditemui dalam input. Ini amat berguna untuk mengesahkan input
metadata.

mengabaikan
Sebarang ralat pengesahan akan diabaikan. Ini akan mengakibatkan output mungkin rosak,
terutamanya dengan penulis json atau xml.

menggantikan
Penulis akan menggantikan urutan UTF-8 yang tidak sah atau titik kod dengan rentetan
dinyatakan dengan string_validation_replacement.

Nilai lalai ialah menggantikan.

string_validation_replacement, svr
Tetapkan rentetan gantian untuk digunakan dalam kes string_validation ditetapkan untuk menggantikan.

Sekiranya pilihan tidak ditentukan, penulis akan menganggap rentetan kosong, iaitu
ia akan mengalih keluar urutan yang tidak sah daripada rentetan input.

Penerangan mengenai penulis yang ada sekarang berikut.

lalai
Format lalai.

Cetak setiap bahagian dalam borang:

[BAHAGIAN]
kunci1=val1
...
keyN=valN
[/BAHAGIAN]

Teg metadata dicetak sebagai baris dalam FORMAT, STREAM atau PROGRAM_STREAM yang sepadan
bahagian, dan diawali dengan rentetan "TAG:".

Penerangan mengenai pilihan yang diterima berikut.

nokey, nk
Jika ditetapkan kepada 1 tentukan untuk tidak mencetak kunci setiap medan. Nilai lalai ialah 0.

noprint_wrappers, nw
Jika ditetapkan kepada 1 tentukan untuk tidak mencetak pengepala dan pengaki bahagian. Nilai lalai ialah 0.

padat, csv
Format padat dan CSV.

Penulis "csv" adalah bersamaan dengan "kompak", tetapi menyokong lalai yang berbeza.

Setiap bahagian dicetak pada satu baris. Jika tiada pilihan dinyatakan, output mempunyai
bentuk:

bahagian|kunci1=val1| ... |keyN=valN

Teg metadata dicetak dalam bahagian "format" atau "strim" yang sepadan. Metadata
kunci tag, jika dicetak, diawali dengan rentetan "tag:".

Penerangan mengenai pilihan yang diterima berikut.

item_sep, s
Tentukan aksara untuk digunakan untuk mengasingkan medan dalam baris keluaran. Ia mestilah a
aksara boleh cetak tunggal, ia ialah "|" secara lalai ("," untuk penulis "csv").

nokey, nk
Jika ditetapkan kepada 1 tentukan untuk tidak mencetak kunci setiap medan. Nilai lalainya ialah 0 (1 untuk
penulis "csv").

melarikan diri, e
Tetapkan mod melarikan diri untuk digunakan, lalai kepada "c" ("csv" untuk penulis "csv").

Ia boleh menganggap salah satu daripada nilai berikut:

c Lakukan pelarian seperti C. Rentetan yang mengandungi baris baharu (\n), pengangkutan balik (\r),
tab (\t), suapan borang (\f), watak yang melarikan diri (\) atau pemisah item
watak September diloloskan menggunakan pelarian bergaya seperti C, supaya baris baharu adalah
ditukar kepada urutan \n, gerabak kembali ke \r, \ kepada \\ dan pemisah
September ditukar kepada \September.

csv Lakukan pelarian seperti CSV, seperti yang diterangkan dalam RFC4180. Rentetan yang mengandungi baris baharu
(\n), pemulangan pengangkutan (\r), petikan berganda ("), atau September disertakan dalam dua-
petikan.

tiada
Tidak melakukan pelarian.

bahagian_cetak, p
Cetak nama bahagian pada permulaan setiap baris jika nilainya ialah 1, lumpuhkannya dengan
nilai ditetapkan kepada 0. Nilai lalai ialah 1.

rata
Format rata.

Output bentuk bebas di mana setiap baris mengandungi kunci=nilai eksplisit, seperti
"streams.stream.3.tags.foo=bar". Output adalah shell melarikan diri, jadi ia boleh secara langsung
tertanam dalam skrip sh selagi aksara pemisah ialah aksara alfanumerik atau
garis bawah (lihat sep_char pilihan).

Penerangan mengenai pilihan yang diterima berikut.

sep_char, s
Aksara pemisah digunakan untuk memisahkan bab, nama bahagian, ID dan potensi
tag dalam kekunci medan bercetak.

Nilai lalai ialah ..

hierarki, h
Tentukan jika spesifikasi nama bahagian harus berhierarki. Jika ditetapkan kepada 1, dan jika
terdapat lebih daripada satu bahagian dalam bab semasa, nama bahagian akan menjadi
diawali dengan nama bab. Nilai 0 akan melumpuhkan tingkah laku ini.

Nilai lalai ialah 1.

Jogja
Output format INI.

Cetak output dalam format berasaskan INI.

Konvensyen berikut diterima pakai:

· semua kunci dan nilai adalah UTF-8

· . ialah pemisah subkumpulan

· baris baru, \t, \f, \b dan watak-watak berikut dilepaskan

· \ ialah watak melarikan diri

· # ialah penunjuk ulasan

· = ialah pemisah kunci/nilai

· : tidak digunakan tetapi biasanya dihuraikan sebagai pemisah kunci/nilai

Penulis ini menerima pilihan sebagai senarai utama=nilai berpasangan, dipisahkan oleh :.

Penerangan mengenai pilihan yang diterima berikut.

hierarki, h
Tentukan jika spesifikasi nama bahagian harus berhierarki. Jika ditetapkan kepada 1, dan jika
terdapat lebih daripada satu bahagian dalam bab semasa, nama bahagian akan menjadi
diawali dengan nama bab. Nilai 0 akan melumpuhkan tingkah laku ini.

Nilai lalai ialah 1.

json
Format berasaskan JSON.

Setiap bahagian dicetak menggunakan tatatanda JSON.

Penerangan mengenai pilihan yang diterima berikut.

padat, c
Jika ditetapkan kepada 1 dayakan output padat, iaitu setiap bahagian akan dicetak pada satu
barisan. Nilai lalai ialah 0.

Untuk maklumat lanjut tentang JSON, lihathttp://www.json.org/>.

xml
Format berasaskan XML.

Output XML diterangkan dalam fail penerangan skema XML ffprobe.xsd dipasang di
datadir FFmpeg.

Versi skema yang dikemas kini boleh diambil pada url
<http://www.ffmpeg.org/schema/ffprobe.xsd>, yang mengubah hala kepada skema terkini yang dilakukan
ke dalam pokok kod sumber pembangunan FFmpeg.

Ambil perhatian bahawa output yang dikeluarkan akan mematuhi ffprobe.xsd skema hanya apabila tidak
pilihan keluaran global khas (unit, awalan, byte_binary_prefix, seksagesimal dll.) adalah
dinyatakan.

Penerangan mengenai pilihan yang diterima berikut.

berkelayakan penuh, q
Jika ditetapkan kepada 1 nyatakan sama ada keluaran itu layak sepenuhnya. Nilai lalai ialah 0. Ini
diperlukan untuk menghasilkan fail XML yang boleh disahkan melalui fail XSD.

xsd_compliant, x
Jika ditetapkan kepada 1 lakukan lebih banyak semakan untuk memastikan output mematuhi XSD. lalai
nilai ialah 0. Pilihan ini ditetapkan secara automatik berkelayakan penuh untuk 1.

Untuk maklumat lanjut tentang format XML, lihathttp://www.w3.org/XML/>.

TIMECODE

ffprobe menyokong pengekstrakan Timecode:

· Kod masa MPEG1/2 diekstrak daripada GOP, dan tersedia dalam strim video
butiran (-show_streams, Lihat kod masa).

· Kod masa MOV diekstrak daripada trek tmcd, jadi tersedia dalam metadata aliran tmcd
(-show_streams, Lihat TAG:kod masa).

· Kod masa DV, GXF dan AVI tersedia dalam format metadata (-format_tunjuk, Lihat
TAG:kod masa).

Gunakan ffprobe dalam talian menggunakan perkhidmatan onworks.net