[MPlayer-DOCS] Need help documenting dsize

[Oded Shimon]

On Fri, Jul 08, 2005 at 11:31:01AM +0200, Guillaume POIRIER wrote:
> Hi,
> 
> On 7/8/05, Oded Shimon <ods15 at ods15.dyndns.org> wrote:
> > Documentation maintainers - Could you help me format this to nroff?
> 
> Sure, if you give us a patch to work from.

OK, here's what I got so far.. It's actually OK I think...

- ods15
-------------- next part --------------
Index: DOCS/man/en/mplayer.1
===================================================================
RCS file: /cvsroot/mplayer/main/DOCS/man/en/mplayer.1,v
retrieving revision 1.1022
diff -u -r1.1022 mplayer.1
--- DOCS/man/en/mplayer.1	20 Jun 2005 18:28:46 -0000	1.1022
+++ DOCS/man/en/mplayer.1	8 Jul 2005 10:04:24 -0000
@@ -4305,7 +4305,7 @@
 .RE
 .
 .TP
-.B dsize[=aspect|w:h]
+.B dsize[=aspect|w:h:aspect-method:r]
 Changes the intended display size/\:aspect at an arbitrary point in the
 filter chain.
 Aspect can be given as a fraction (4/\:3) or floating point number
@@ -4317,6 +4317,51 @@
 do any scaling itself; it just affects
 what later scalers (software or hardware) will do when auto-scaling to
 correct aspect.
+.RSs
+.IPs <w>,<h>
+New display width and height.
+Can also be these special values:
+.RSss
+ 0:   Original display width, height.
+.br
+-1:   Original video width and height. (default)
+.br
+-2:   Calculate by using the other dimention and the original video aspect ratio.
+.br
+-3:   Calculate by using the other dimention and the original display aspect ratio.
+.REss
+.sp 1
+.I EXAMPLE:
+.PD 0
+.RSs
+.IP dsize=800:-2
+Specifies a dsize of 800x600 for a 4/\:3 aspect movie.
+.RE
+.IPs <aspect\-method>
+Modifies width and height according to original aspect ratios.
+.RSss
+-1: Ignore original aspect ratio. (default)
+.br
+ 0: Keep display aspect ratio by using <w> and <h> as a maximum size.
+.br
+ 1: Keep display aspect ratio by using <w> and <h> as a minimum size.
+.br
+ 2: Keep video aspect ratio by using <w> and <h> as a maximum size.
+.br
+ 3: Keep video aspect ratio by using <w> and <h> as a minimum size.
+.REss
+.sp 1
+.I EXAMPLE:
+.PD 0
+.RSs
+.IP dsize=800:600:1
+Specifies a dsize of at most 800x600, or smaller, in order to
+keep aspect.
+.RE
+.PD 1
+.IPs <r>
+Round width and hieght up to be divisable by <r>. (default: 1)
+.RE
 .
 .TP
 .B yuy2\ \ \