summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-06-05 00:28:15 +0200
committerwm4 <wm4@nowhere>2013-06-05 01:39:54 +0200
commitb9607b63a45e041ee1cc317a37a737b256c79d41 (patch)
treea6bac519cd09bf6d8546978d8a076b067aa73a9e /DOCS
parentb9cb011ba5add82a63eed5850975abf43f257b72 (diff)
downloadmpv-b9607b63a45e041ee1cc317a37a737b256c79d41.tar.bz2
mpv-b9607b63a45e041ee1cc317a37a737b256c79d41.tar.xz
docs: update tech-overview.txt
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/tech-overview.txt28
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