diff options
author | wm4 <wm4@nowhere> | 2013-06-05 00:28:15 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2013-06-05 01:39:54 +0200 |
commit | b9607b63a45e041ee1cc317a37a737b256c79d41 (patch) | |
tree | a6bac519cd09bf6d8546978d8a076b067aa73a9e /DOCS | |
parent | b9cb011ba5add82a63eed5850975abf43f257b72 (diff) | |
download | mpv-b9607b63a45e041ee1cc317a37a737b256c79d41.tar.bz2 mpv-b9607b63a45e041ee1cc317a37a737b256c79d41.tar.xz |
docs: update tech-overview.txt
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/tech-overview.txt | 28 |
1 files changed, 19 insertions, 9 deletions
diff --git a/DOCS/tech-overview.txt b/DOCS/tech-overview.txt index 9582caaea4..2037ab653e 100644 --- a/DOCS/tech-overview.txt +++ b/DOCS/tech-overview.txt @@ -186,15 +186,25 @@ audio/out/: why buggy audio drivers can have a bad influence on playback quality. sub/: - A big mess. Contains subtitle rendering (parts of it), OSD rendering, - subtitle loading. - - There are about 3 types of subtitles: image subs, ASS subs, text subs. Also, - there are 3 rendering methods: image subs, libass, internal subtitle - renderer. Also, subtitles can come from demuxers or external files. All the - possible combinations create weird special cases, e.g. taking a text - subtitle event from the demuxer and converting it to ass for display is - different from loading a text subtitle and converting it to ass. + Contains subtitle rendering, OSD rendering, and parts of subtitle loading. + + sub.c/.h is actually the OSD code. It queries dec_sub.c to retrieve + decoded/rendered subtitles. osd_libass.c is the actual implementation of + the OSD text renderer (which uses libass, and takes care of all the tricky + fontconfig/freetype API usage and text layouting). + + Subtitles are loaded either via libass (for .ass), subreader.c (the old + MPlayer subtitle loader code), or libavformat demuxers. The subtitles are + then passed to dec_sub.c and the subtitle decoders in sd_*.c. All text + subtitles are rendered by sd_ass.c. If text subtitles are not in the ASS + format, subtitle converters are inserted, for example sd_srt.c, which is + used to convert SRT->ASS. sd_srt.c is also used as general converter for + text->ASS (to prevent interpretation of text as ASS tags). + + subreader.c should eventually go away. It should be replaced by either + libavformat's demuxers, or by mpv native demuxers for more common formats + like SRT. See commit message of commit 92ae48d what needs to be done to + replace subreader.c completely and why. core/timeline/: A timeline is the abstraction used by mplayer.c to combine several files |