[MPlayer-DOCS] r30849 - in trunk: DOCS/man/en/mplayer.1 Makefile libmpcodecs/vf.c libmpcodecs/vf_fixpts.c mencoder.c

[greg]

Author: greg
Date: Sat Mar  6 00:13:08 2010
New Revision: 30849

Log:
Enable ASS/SSA subtitle support in mencoder

Enable ASS/SSA rendering through libass in mencoder. This duplicates a
bit of code (to parse font attachments, for example). Additionally, add
a filter "fixpts" that generates PTS, simulating fixed fps. PTS
generated by this filter are then used for subtitle timing.

Original patch by Nicolas George. (nicolas.george normalesup.org)

Modified:
   trunk/DOCS/man/en/mplayer.1

Changes in other areas also in this revision:
Added:
   trunk/libmpcodecs/vf_fixpts.c
Modified:
   trunk/Makefile
   trunk/libmpcodecs/vf.c
   trunk/mencoder.c

Modified: trunk/DOCS/man/en/mplayer.1
==============================================================================
--- trunk/DOCS/man/en/mplayer.1	Sat Mar  6 00:09:36 2010	(r30848)
+++ trunk/DOCS/man/en/mplayer.1	Sat Mar  6 00:13:08 2010	(r30849)
@@ -7500,6 +7500,48 @@ Larger radius makes for smoother gradien
 from modifying pixels near detailed regions (default: 16).
 .RE
 .
+.TP
+.B fixpts[=options]
+Fixes the presentation timestamps (PTS) of the frames.
+By default, the PTS passed to the next filter is dropped, but the following
+options can change that:
+.RSs
+.IPs print
+Print the incoming PTS.
+.IPs fps=<fps>
+Specify a frame per second value.
+.IPs start=<pts>
+Specify an initial value for the PTS.
+.IPs autostart=<n>
+Uses the
+.IR n th
+incoming PTS as the initial PTS.
+All previous pts are kept, so setting a huge value or \-1 keeps the PTS
+intact.
+.IPs autofps=<n>
+Uses the
+.IR n th
+incoming PTS after the end of autostart to determine the framerate.
+.RE
+.sp 1
+.RS
+.I EXAMPLE:
+.RE
+.PD 0
+.RSs
+.IPs "\-vf fixpts=fps=24000/1001,ass,fixpts"
+Generates a new sequence of PTS, uses it for ASS subtitles, then drops it.
+Generating a new sequence is useful when the timestamps are reset during the
+program; this is frequent on DVDs.
+Dropping it may be necessary to avoid confusing encoders.
+.RE
+.PD 1
+.sp 1
+.RS
+.I NOTE:
+Using this filter together with any sort of seeking (including -ss and EDLs)
+may make demons fly out of your nose.
+.RE
 .
 .
 .SH "GENERAL ENCODING OPTIONS (MENCODER ONLY)"