summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorNiklas Haas <git@nand.wakku.to>2016-05-12 03:34:47 +0200
committerNiklas Haas <git@nand.wakku.to>2016-05-15 20:42:02 +0200
commit034faaa9d818bd8c1c52c879e383b8e7350d3df5 (patch)
tree18333dad4b120905363456479bafb14fff1db299 /DOCS
parent7c3d78fd82d4d1e1a0b15284386d39b4014cb7d1 (diff)
downloadmpv-034faaa9d818bd8c1c52c879e383b8e7350d3df5.tar.bz2
mpv-034faaa9d818bd8c1c52c879e383b8e7350d3df5.tar.xz
vo_opengl: use RPN expressions for user hook sizes
This replaces the previous TRANSFORM by WIDTH, HEIGHT and OFFSET where WIDTH and HEIGHT are RPN expressions. This allows for more fine-grained control over the output size, and also makes sure that overwriting existing textures works more cleanly. (Also add some more useful bstr functions)
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/vo.rst24
1 files changed, 17 insertions, 7 deletions
diff --git a/DOCS/man/vo.rst b/DOCS/man/vo.rst
index 3f19c4c2ab..4d6972e5a3 100644
--- a/DOCS/man/vo.rst
+++ b/DOCS/man/vo.rst
@@ -739,11 +739,20 @@ Available video output drivers are:
into. By default, this is set to the special name HOOKED which has
the effect of overwriting the hooked texture.
- TRANSFORM sx sy ox oy
- Specifies how this pass intends to transform the hooked texture.
- ``sx``/``sy`` refer to a linear scale factor, and ``ox``/``oy``
- refer to a constant pixel shift that the shader will introduce. The
- default values are 1 1 0 0 which leave the texture size unchanged.
+ WIDTH <szexpr>, HEIGHT <szexpr>
+ Specifies the size of the resulting texture for this pass.
+ ``szexpr`` refers to an expression in RPN (reverse polish
+ notation), using the operators + - * /, floating point literals,
+ and references to existing texture sizes such as MAIN.width or
+ CHROMA.height. By default, these are set to HOOKED.w and HOOKED.h,
+ respectively.
+
+ OFFSET ox oy
+ Indicates a pixel shift (offset) introduced by this pass. These
+ pixel offsets will be accumulated and corrected during the
+ next scaling pass (``cscale`` or ``scale``). The default values
+ are 0 0 which correspond to no shift. Note that offsets are ignored
+ when not overwriting the hooked texture.
COMPONENTS n
Specifies how many components of this pass's output are relevant
@@ -810,8 +819,9 @@ Available video output drivers are:
The final output image, after color management but before
dithering and drawing to screen.
- Only the textures labelled with (resizable) may be transformed by
- the pass. For all others, the TRANSFORM must be 1 1 0 0 (default).
+ Only the textures labelled with ``resizable`` may be transformed by the
+ pass. When overwriting a texture marked ``fixed``, the WIDTH, HEIGHT
+ and OFFSET must be left at their default values.
``deband``
Enable the debanding algorithm. This greatly reduces the amount of