mirror of
https://github.com/mpv-player/mpv
synced 2025-03-11 08:37:59 +00:00
obsolete
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@5585 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
arpi
parent
5adab7b7bf
commit
5fe2b92862
@ -1,34 +0,0 @@
|
||||
# video decoder:
|
||||
|
||||
int init(sh_video) -> loads codec dll, check if available and it accepts header if any
|
||||
|
||||
int control(sh_video,cmd,param,...) -> various set/get/query functions
|
||||
|
||||
int decode(sh_video,framedrop) -> decode frame, callbacks to config/get_surface
|
||||
|
||||
int uninit(sh_video)
|
||||
|
||||
# callbacks for video decoder:
|
||||
|
||||
mpcodecs_config_vo(sh_video, w, h, preferred_outfmt){
|
||||
// it will be called by codec (either init() or decode()) when it gets
|
||||
// enough info to know image dimensions, colorspaces and buffering type
|
||||
|
||||
// this func should use control() to get/set parameters for a given outfmt
|
||||
// (like supported buffering types, stride limitations, etc) or to
|
||||
// query and select other colorspace.
|
||||
|
||||
}
|
||||
|
||||
// possible buffer setups:
|
||||
- 1 static overwrite only (partial update type codecs: cvid, fli, vfw etc)
|
||||
- 1+ independent temp writeonly (I-only mpegs, jpeg, mjpeg etc)
|
||||
- 2+ static read/write (I+P mpegs)
|
||||
- 2+ static read/write and 1+ temp writeonly (I+P+B mpegs)
|
||||
|
||||
image_t* mpcodecs_get_surface(sh_video, flags){
|
||||
// flags:
|
||||
// 0x1 - read (make it readable -> don't put to slow video ram)
|
||||
|
||||
}
|
||||
|
||||
@ -1,296 +0,0 @@
|
||||
Nos, akkor leírom, hogyan is működik ez az egész.
|
||||
|
||||
A fő modulok:
|
||||
|
||||
1. streamer.c: ez az input layer, azaz ez olvassa a filet, VCD-t vagy stdin-t.
|
||||
amit tudnia kell: megfelelő sectoronkénti bufferelés, seek, skip funkciók,
|
||||
byte-onkénti ill. tetszőleges méretű blockonkénti olvasás.
|
||||
Egy stream (input device/file) leírására a stream_t struktúra szolgál.
|
||||
|
||||
2. demuxer.c: ez végzi az input szétszedését audio és video csatornákra,
|
||||
és a kiválasztott csatornák bufferelt package-enkénti olvasását.
|
||||
A demuxer.c inkább csak egy framework, ami közös minden input
|
||||
formátumra, és az egyes formátumokhoz (mpeg-es, mpeg-ps, avi, avi-ni,
|
||||
asf) külön parser van, ezek a demux_*.c file-okban vannak.
|
||||
A hozzá tartozó struktúra a demuxer_t. Összesen egy demuxer van.
|
||||
|
||||
2.a. demux_packet_t, azaz dp.
|
||||
ez egy darab chunk-ot (avi) vagy packet-et (asf, mpg) tartalmaz.
|
||||
memóriában ezek láncolt listában vannak, mivel különböző méretűek.
|
||||
|
||||
2.b. demuxer stream, azaz ds.
|
||||
struct: demux_stream_t
|
||||
minden egyes csatornához (a/v) tartozik egy ilyen.
|
||||
ez tartalmazza a stream-hez tartozó packeteket (lásd. 2.a.)
|
||||
egyelőre demuxer-enként 3 ilyen lehet:
|
||||
- hang (d_audio)
|
||||
- kép (d_video)
|
||||
- DVD felirat (d_dvdsub)
|
||||
|
||||
2.c. stream header. 2 féle van (egyelőre): sh_audio_t és sh_video_t
|
||||
ez tartalmaz minden, a dekódoláshoz szükséges paramétert, így az input
|
||||
és output buffereket, kiválasztott codecet, fps/framerate stb adatokat.
|
||||
Annyi van belőle, ahány stream van a file-ban tárolva. Lesz minimum egy
|
||||
a videohoz, ha van hang akkor ahhoz is, de ha több audio/video stream
|
||||
is van, akkor mindegyikhez lesz egy ilyen struct.
|
||||
Ezeket avi/asf esetén a header alapján tölti fel a header beolvasó,
|
||||
mpeg esetén pedig a demux_mpg.c fogja létrehozni, ha egy új streamet
|
||||
talál. Új stream esetén ====> Found audio/video stream: <id> jelenik meg.
|
||||
|
||||
A kiválasztott stream header és a hozzá tartozó demuxer stream kölcsönösen
|
||||
hivatkoznak egymásra (ds->sh és sh->ds) az egyszerűbb használat végett.
|
||||
(így a funkciótól függően elég vagy csak a ds vagy csak az sh átadása)
|
||||
|
||||
Példa: van egy .asf file-unk, abban 6 db stream, ebből 1 audio és 5 video.
|
||||
A header beolvasásakor létre fog jönni 6 db sh struct, 1 audio és 5 video.
|
||||
Amikor elkezdi olvasni a packeteket, az első talált audio és video
|
||||
packethez tartozó streamet kivalasztja, es ezekre allitja be a d_audio
|
||||
és d_video sh pointereit.
|
||||
Így a későbbiekben már csak ezeket a streameket olvassa, a többit nem.
|
||||
Persze, ha a user másik streameket szeretne kiválasztani, akkor
|
||||
force-olhatja az -aid és -vid kapcsolókkal.
|
||||
Jó pelda erre a DVD, ahol nem mindig az angol szinkron hang az első
|
||||
megtalált stream, és így random minden vob más nyelven szólalhat meg :)
|
||||
Ilyenkor kell pl. az -aid 128 kapcsolót használni.
|
||||
|
||||
hogy is műxik ez a beolvasósdi?
|
||||
- meghívódik a demuxer.c/demux_read_data(), megkapja melyik ds-ből
|
||||
(audio vagy video), mennyi byte-ot és hova (memóriacím) szeretnénk
|
||||
beolvasni. Ezt hívogatják gyakorlatilag a codec-ek.
|
||||
- ez megnézi, hogy az adott ds bufferében van-e valami, ha igen akkor
|
||||
onnan olvas, amennyit kell. Ha nincs/nincs elég, akkor meghívja
|
||||
a ds_fill_buffer()-t ami:
|
||||
- megnézi, hogy az adott ds-ben vannak-e bufferelve csomagok (dp-k)
|
||||
ha igen, akkor a legrégebbit átrakja a bufferbe és olvas tovább. Ha
|
||||
üres a láncolt lista, akkor meghívja a demux_fill_buffer()-t:
|
||||
- ez az input formátumnak megfelelő parser-t hívja meg, ami továbbol-
|
||||
vassa a file-t, és a talált csomagokat berakja a megfelelő bufferbe.
|
||||
Na, ha mondjuk audio csomagot szeretnénk, de csak egy rakat
|
||||
video csomag van, akkor jön előbb-utóbb a DEMUXER: Too many
|
||||
(%d in %d bytes) audio packets in the buffer... hibaüzenet.
|
||||
|
||||
Eddig kb. tiszta ügy, ezt akarom majd átrakni külön lib-be.
|
||||
|
||||
na nézzuk tovább:
|
||||
|
||||
3. mplayer.c - igen, ő a főnök :)
|
||||
|
||||
Fő feladata a különböző modulok összekapcsolása, illetve az A-V
|
||||
szinkron biztosítása.
|
||||
|
||||
Az adott stream aktuális pozíciója a megfelelo stream header
|
||||
(sh_audio / sh_video) timer field-ben van.
|
||||
(Régen ez volt az a_frame és egy v_frame nevű float változó)
|
||||
|
||||
A lejátszó ciklus felépítése:
|
||||
while(not EOF) {
|
||||
fill audio buffer (read & decode audio) + increase a_frame
|
||||
read & decode a single video frame + increase v_frame
|
||||
sleep (wait until a_frame>=v_frame)
|
||||
display the frame
|
||||
apply A-V PTS correction to a_frame
|
||||
check for keys -> pause,seek,...
|
||||
}
|
||||
|
||||
amikor lejátszik (hang/kép) akkor a lejátszott valami időtartamával
|
||||
növeli a megfelelő változót:
|
||||
- audionál ez a lejátszott byte-ok / sh_audio->o_bps
|
||||
megj.: i_bps = tömörített byte-ok széma egy másodpercnyi hanghoz
|
||||
o_bps = tömörítetlen byte-ok száma egy másodpercnyi hanghoz
|
||||
(ez utóbbi == bps*samplerate*channels)
|
||||
- videonál ez általában az sh_video->frametime.
|
||||
Ez általában == 1.0/fps, persze meg kell jegyeznem, hogy videonál nem
|
||||
igazán számít az fps, asf-nél pl. nincs is olyan, ahelyett duration
|
||||
van és frame-enként változhat.
|
||||
mpeg2-nél pedig repeat_count van, ami 1-2.5 időtartamban elnyújtja
|
||||
a frame-et... avi-nál van talán egyedül fix fps, meg mpeg1-nél.
|
||||
|
||||
Na most ez addig nagyon szépen működik, amíg a hang és kép tökéletes
|
||||
szinkronban van, mivel így végülis a hang szól, az adja az időzítést,
|
||||
és amikor eltelt egy frame-nyi idő, akkor kirakja a következő frame-et.
|
||||
De mi van, ha valamiért az input file-ban csúszik a kettő?
|
||||
Akkor jön be a PTS correction. Az input demuxer-ek olvassák a
|
||||
csomagokkal együtt a hozzájuk tartozó PTS-t (presentation timestamp)
|
||||
is, ami alapján észrevehető, ha el van csúszva a kettő. Ilyenkor egy
|
||||
megadott maximális határon (lásd -mc opció) belül képes az mplayer
|
||||
korrigalni az a_frame értékét. A korrekciók összege van a c_total-ban.
|
||||
|
||||
Persze ez még nem minden szinkron ügyben, van még némi gáz. Pl. az,
|
||||
hogy a hangkártya elég rendesen késleltet, ezt az mplayernek korrigálnia
|
||||
kell! Az összes audio késleltetés másodpercben ezek összege:
|
||||
- az utolsó timestamp (PTS) óta beolvasott byte-ok:
|
||||
t1 = d_audio->pts_bytes/sh_audio->i_bps
|
||||
- Win32/ACM esetén az audio input bufferben tárolt byte-ok:
|
||||
t2 = a_in_buffer_len/sh_audio->i_bps
|
||||
- az audio out bufferben tárolt tömörítetlen byte-ok:
|
||||
t3 = a_buffer_len/sh_audio->o_bps
|
||||
- a hangkártya bufferében (vagy DMA bufferben) tárolt, még nem
|
||||
lejátszott byte-ok:
|
||||
t4 = get_audio_delay()/sh_audio->o_bps
|
||||
|
||||
Ezekből kiszámolható egészen pontosan, hogy az épp hallható hanghoz
|
||||
milyen PTS tartozik, majd ezt összevetve a video-hoz tartozo PTS-el
|
||||
meg is kapjuk az A-V eltérését!
|
||||
|
||||
Avi-nál sem egyszerű az élet. Ott a 'hivatalos' időzítési mód a
|
||||
BPS-alapú, azaz a headerben le van tárolva, hány tömörített audio
|
||||
byte vagy chunk tartozik egy másodpercnyi (fps darab) képhez.
|
||||
Az AVI stream headerben van 2 fontos mezo, a dwSampleSize, es
|
||||
a dwRate/dwScale aránypár:
|
||||
- Ha a dwSampleSize 0, akkor VBR stream, tehat nem konstans a
|
||||
bitrate. Ilyenkor 1 chunk tarol 1 sample-t, es a masodpercenkenti
|
||||
chunkok szamat adja a dwRate/dwScale.
|
||||
- Ha a dwSampleSize>0, akkor constant bitrate van, es az ido igy
|
||||
szamolhato: time = (bytepos/dwSampleSize) / (dwRate/dwScale)
|
||||
(tehat a sample sorszamat elosztjuk a samplerate-el)
|
||||
Ilyenkor stream-kent kezelheto az audio, ami tetszolegesen
|
||||
chunk-okra van darabolva, de lehet akar 1 db chunk is az egesz.
|
||||
|
||||
A másik lehetőség csak az interleaved fileoknál használható: a
|
||||
chunk-ok sorrendjéből számolható egy timestamp (PTS) érték.
|
||||
A video chunkok PTS-e egyszerű: chunk száma * fps
|
||||
Az audio pedig az előtte levő video chunk-éval azonos.
|
||||
Ilyenkor viszont szamolni kell az ugynev. "audio preload"-al is,
|
||||
azaz van egy fix kesleltetes az audio es video stream-ek kozott.
|
||||
Ez altalaban 0.5-1.0 sec, de van amikor egeszen mas.
|
||||
A pontos erteket regen mertuk, most a demux_avi.c kezeli le:
|
||||
az elso video utani audio chunknal kiszamolja az A-V elterest,
|
||||
es ezt veszi az audio preload mertekenek.
|
||||
|
||||
3.a. audio playback:
|
||||
pár szó az audio lejátszásról:
|
||||
az egészben nem maga a lejátszás a nehéz, hanem:
|
||||
1. hogy tudjuk, mikor lehet írni a bufferbe, blocking nélkül
|
||||
2. hogy tudjuk, mennyit játszott már le abból, amit a bufferbe írtunk
|
||||
Az 1. az audio dekódoláshoz kell, valamint hogy a buffert mindig teli
|
||||
állapotban tudjuk tartani (így sose fog megakadni a hang).
|
||||
A 2. pedig a korrekt időzítéshez szükséges, ugyanis némely hangkártya
|
||||
akár 3-7 másodpercet is késleltet, ami azért nem elhanyagolható!
|
||||
Ezek megvalósítására az OSS többféle lehetőséget is kínál:
|
||||
- ioctl(SNDCTL_DSP_GETODELAY): megmondja, hány lejátszatlan byte
|
||||
várakozik a hangkártya bufferében -> időzítéshez kiváló,
|
||||
de nem minden driver támogatja :(
|
||||
- ioctl(SNDCTL_DSP_GETOSPACE): megmondja, mennyit írhatunk a kártya
|
||||
bufferébe blocking nélkül. Ha a driver nem tudja a GETODELAY-t,
|
||||
akkor ezt hasznalhatjuk arra is, hogy megtudjuk a késleltetést.
|
||||
- select(): meg kéne mondja, hogy írhatunk-e a kártya bufferébe
|
||||
blocking nélkül. Azt, hogy mennyit írhatunk, nem mondja meg :(
|
||||
valamint sok driverrel egyáltalán nem, vagy rosszul működik :((
|
||||
csak akkor használom, ha egyik fenti ioctl() sem működik.
|
||||
|
||||
4. codecek. ezek különböző lib-ek szanaszét mindenfelől.
|
||||
mint pl. libac3, libmpeg2, xa/*, alaw.c, opendivx/*, loader, mp3lib.
|
||||
|
||||
Az mplayer.c nem kozvetlenul hivja oket, hanem a dec_audio.c es a
|
||||
dec_video.c fileokon keresztul, igy az mplayer.c-nek nem kell semmit
|
||||
sem tudnia a codecrol.
|
||||
|
||||
5. libvo: ez végzi a kép kirakását.
|
||||
|
||||
Az img_format.h-ban definiálva vannak konstansok a különböző pixel-
|
||||
formátumokhoz, ezeket kötelező használni.
|
||||
|
||||
1-1 vo drivernek a következőket kell kötelezően implementálnia:
|
||||
|
||||
query_format() - lekérdezi, hogy egy adott pixelformat támogatott-e.
|
||||
return value: flags:
|
||||
0x1 - supported (by hardware or with conversion)
|
||||
0x2 - supported (by hardware, without conversion)
|
||||
0x4 - sub/osd supported (has draw_alpha)
|
||||
FONTOS: minden vo drivernek kötelező támogatnia az YV12 formátumot, és
|
||||
egyiket (vagy mindkettőt) a BGR15 és BGR24 közül, ha kell, konvertálással.
|
||||
Ha ezeket nem támogatja, akkor nem fog minden codec-kel működni!
|
||||
Ennek az az oka, hogy az mpeg codecek csak YV12-t tudnak előállítani,
|
||||
a régebbi Win32 DLL codecek pedig csak 15 és 24bpp-t tudnak.
|
||||
Van egy gyors MMX-es 15->16bpp konvertáló, így az nem okoz különösebb
|
||||
sebességcsökkenést!
|
||||
|
||||
A BPP táblázat, ha a driver nem tud bpp-t váltani:
|
||||
jelenlegi bpp: ezeket kell elfogadni:
|
||||
15 15
|
||||
16 15,16
|
||||
24 24
|
||||
24,32 24,32
|
||||
|
||||
Ha tud bpp-t váltani (pl. DGA 2, fbdev, svgalib) akkor, ha lehet, be kell
|
||||
váltani a kért bpp-re. Ha azt a hardver nem támogatja, akkor a legközelebbi
|
||||
módra (15 esetén 16-ra, 24 esetén 32-re) kell váltani és konvertálni!
|
||||
|
||||
init() - ez hívódik meg a legelső frame kirakása előtt - bufferek foglalása
|
||||
stb a célja.
|
||||
van egy flags paraméter is (régen fullscreen volt a neve):
|
||||
0x01 - fullscreen (-fs)
|
||||
0x02 - vidmode switch (-vm)
|
||||
0x04 - scaling enabled (-zoom)
|
||||
0x08 - flip image (upside-down)
|
||||
|
||||
draw_slice(): ez planar YV12 képet rak ki (3 db plane, egy teljes
|
||||
méretű, ami a fényerőt (Y) tartalmazza, és 2 negyedakkora, ami a
|
||||
szín (U,V) infót). ezt használják az mpeg codecek (libmpeg2, opendivx).
|
||||
ez már tud olyat, hogy nem az egész kép kirakása, hanem csak kis
|
||||
részletek update-elése: ilyenkor a sarkának és a darabka méretének
|
||||
megadásával lehet használni.
|
||||
|
||||
draw_frame(): ez a régebbi interface, ez csak komplett frame-et rak ki,
|
||||
és csak packed formátumot (YUY2 stb, RGB/BGR) tud.
|
||||
ezt használják a win32 codecek (divx, indeo stb).
|
||||
|
||||
draw_alpha(): ez rakja ki a subtitle-t és az OSD-t.
|
||||
használata kicsit cseles, mivel ez nem a libvo API része, hanem egy
|
||||
callback jellegű cucc. a flip_page() kell meghívja a vo_draw_text()-et
|
||||
úgy, hogy paraméterként átadja a képernyő méreteit és a pixel-
|
||||
formátumnak megfelelő draw_alpha() implementációt (function pointer).
|
||||
Ezután a vo_draw_text() végigmegy a kirajzolandó karaktereken, és
|
||||
egyenként meghívja minden karakterre a draw_alpha()-t.
|
||||
Segítség képpen az osd.c-ben meg van írva a draw_alpha mindenféle
|
||||
pixelformátumhoz, ha lehet ezt használd!
|
||||
|
||||
flip_page(): ez meghívódik minden frame után, ennek kell ténylegesen meg-
|
||||
jeleníteni a buffert. double buffering esetén ez lesz a 'swapbuffers'.
|
||||
|
||||
6. libao2: ez vezérli a hang lejátszást
|
||||
|
||||
A libvo-hoz (lásd 5.) hasonlóan itt is különböző driverek vannak, amik
|
||||
egy közös API-t (interface) valósítanak meg:
|
||||
|
||||
static int control(int cmd,int arg);
|
||||
Ez egy általános célú függvény, a driverfüggő és egyéb speciális paraméterek
|
||||
olvasására/beállítására. Egyelőre nem nagyon használt.
|
||||
|
||||
static int init(int rate,int channels,int format,int flags);
|
||||
Driver initje, ilyenkor kell megnyitni a device-t, beállítani samplerate,
|
||||
channels, sample format paramétereket.
|
||||
Sample format: általában AFMT_S16_LE vagy AFMT_U8, további definíciókért
|
||||
lásd. dec_audio.c ill. linux/soundcard.h file-okat!
|
||||
|
||||
static void uninit();
|
||||
Találd ki!
|
||||
Na jó, segítek: lezárja a device-t, kilépéskor (még nem) hívódik meg.
|
||||
|
||||
static void reset();
|
||||
Reseteli a device-t. Egész pontosan a bufferek törlésére szolgál,
|
||||
tehát hogy a reset() után már ne szóljon tovább az, amit előtte kapott.
|
||||
(pause ill. seek esetén hívódik meg)
|
||||
|
||||
static int get_space();
|
||||
Vissza kell adja, hogy hány byte írható az audio bufferbe anélkül, hogy
|
||||
blockolna (várakoztatná a hívó processt). Amennyiben a buffer (majdnem)
|
||||
tele van, 0-t kell visszaadni!
|
||||
Ha sosem ad vissza 0-t, akkor nem fog működni az MPlayer!
|
||||
|
||||
static int play(void* data,int len,int flags);
|
||||
Lejátszik egy adag hangot, amit a data című memóriaterületen kap és len
|
||||
a mérete. a flags még nem használt. Az adatokat át kell másolnia, mert a
|
||||
hívás után felülíródhatnak! Nem kell feltétlen minden byte-ot felhasználni,
|
||||
hanem azt kell visszaadnia, mennyit használt fel (másolt a bufferbe).
|
||||
|
||||
static int get_delay();
|
||||
Visszaadja meddig fog tartani az éppen az audio bufferben levő adat
|
||||
lejátszása. Lehetőleg minél pontosabban, mert ettől függ az egész időzítés!
|
||||
Legrosszabb esetben adja vissza a maximális időzítést.
|
||||
|
||||
!!! Mivel a kép a hanghoz (hangkártyához) van szinkronizálva, így nagyon fontos,
|
||||
!!! hogy a get_space ill. get_delay függvények korrektül legyenek megírva!
|
||||
|
||||
6.a Audio plugin-ek
|
||||
Remélem tudsz angolul.
|
||||
@ -1,52 +0,0 @@
|
||||
First draft on video filter layer by A'rpi
|
||||
=================================
|
||||
|
||||
Main goals:
|
||||
- it should be in libmpcodecs
|
||||
- it should reduce number of memcpys and memoru allocation to minimum
|
||||
- it should do postprocessing, colorspace convert, scale and crop/expand/flip
|
||||
[is there any other type of filters? maybe we could generalize these]
|
||||
- maybe: sub/osd
|
||||
|
||||
Implementation:
|
||||
|
||||
The video filter plugin should implement the get_image() call (called from
|
||||
the video decoder) and call get_image() for the destination image.
|
||||
|
||||
so, it would have:
|
||||
|
||||
optional:
|
||||
int get_image(mp_image_t* mpi) // called through control()
|
||||
|
||||
if the filter doesn't implement this call, the core (vd.c) will alloc
|
||||
buffer using memalign() as for disabled direct rendering.
|
||||
|
||||
mandatory:
|
||||
mp_vfilter_data* init()
|
||||
|
||||
void uninit(mp_vfilter_data* vfd)
|
||||
|
||||
int control(mp_vfilter_data* vfd, ...)
|
||||
|
||||
mp_image_t* process(mp_vfilter_data* vfd, mp_image_t* mpi,(*get_image)())
|
||||
|
||||
this function will receive an mpi (maybe previously returned by get_image())
|
||||
and should return the filtered mpi. it should use mpcodecs_get_image() to
|
||||
allocate a new mpi.
|
||||
the returned mpi may be EXPORT type, so just doing some pointer/stride
|
||||
tricks (usually enough for crop/expand/flip) without duplicating the
|
||||
image buffer or doing the modifications in the incoming buffer (if its
|
||||
type allows it - so no flags PRESERVE/READABLE set)
|
||||
|
||||
mp_vfilter_data would be a transparent (to caller) pointer, used by the
|
||||
filter instance to store its internal data, tables, parameters etc.
|
||||
it would allow a fliter to be used more than one times in the queue.
|
||||
for example: resize in 2 step, postproc+resize+postproc, expand+scale+crop etc
|
||||
|
||||
the tricky part of these filters is finding and implementing Direct
|
||||
Filtering(C) using get_image().
|
||||
|
||||
anyway, as first step you can skip get_image() implementation, and just
|
||||
leave it to vd.c core. in most cases it will be enough, direct filtering
|
||||
only helps with simple filters (crop/expand/flip) in most cases.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user