path: root/DOCS
diff options
authorharklu <harklu@wat>2011-08-04 21:47:36 +0200
committerUoti Urpala <>2011-08-12 14:19:10 +0300
commit9e6933440ae59c523fce85b64d6f52f444910003 (patch)
tree2b54de48e505866e95c946db1b3e497bfcc9867b /DOCS
parente30416c9979232bf86cb58992421e66e03eda492 (diff)
options, subs: add --ass-vsfilter-aspect-compat
Add option --ass-vsfilter-aspect-compat and corresponding property ass_vsfilter_aspect_compat. The setting controls whether to enable the emulation of traditional VSFilter behavior where subtitles are stretched if the video is anamorphic (previously always enabled for native SSA/ASS subtitles). Enabled by default. Add 'V' as a new default keybinding to toggle the property.
Diffstat (limited to 'DOCS')
2 files changed, 23 insertions, 0 deletions
diff --git a/DOCS/man/en/mplayer.1 b/DOCS/man/en/mplayer.1
index bbbea0e7c2..3575fb22a6 100644
--- a/DOCS/man/en/mplayer.1
+++ b/DOCS/man/en/mplayer.1
@@ -251,6 +251,9 @@ Toggle displaying "forced subtitles".
Toggle subtitle alignment: top / middle / bottom.
.IPs "x and z"
Adjust subtitle delay by +/\- 0.1 seconds.
+.IPs "V\ \ \ \ "
+Toggle subtitle VSFilter aspect compatibility mode.
+See -ass\-vsfilter\-aspect\-compat for more info.
.IPs "C (\-capture only)"
Start/stop capturing the primary stream.
.IPs "r and t"
@@ -2226,6 +2229,25 @@ Enables placing toptitles and subtitles in black borders when they
are available.
+.B \-ass\-vsfilter\-aspect\-compat
+Stretch SSA/ASS subtitles when playing anamorphic videos for compatibility
+with traditional VSFilter behavior.
+This switch has no effect when the video is stored with square pixels.
+.sp 1
+The renderer historically most commonly used for the SSA/ASS subtitle formats,
+VSFilter, had questionable behavior that resulted in subtitles being
+stretched too if the video was stored in anamorphic format that required
+scaling for display.
+This behavior is usually undesirable and newer VSFilter versions may
+behave differently.
+However, many existing scripts compensate for the stretching by modifying
+things in the opposite direction.
+Thus if such scripts are displayed "correctly" they will not appear as intended.
+This switch enables emulation of the old VSFilter behavior (undesirable but
+expected by many existing scripts).
+Enabled by default.
.B \-dumpjacosub
Convert the given subtitle (specified with the \-sub option) to the time-based
JACOsub subtitle format.
diff --git a/DOCS/tech/slave.txt b/DOCS/tech/slave.txt
index d95ef41d84..0e906cf857 100644
--- a/DOCS/tech/slave.txt
+++ b/DOCS/tech/slave.txt
@@ -585,6 +585,7 @@ sub_alignment int 0 2 X X X subtitle alignment
sub_visibility flag 0 1 X X X show/hide subtitles
sub_forced_only flag 0 1 X X X
sub_scale float 0 100 X X X subtitles font size
+ass_vsfilter_aspect_compat flag 0 1 X X X SSA/ASS aspect ratio correction
tv_brightness int -100 100 X X X
tv_contrast int -100 100 X X X
tv_saturation int -100 100 X X X