From 28a971e26f7318d2081dff8c95a3844823ed7c9d Mon Sep 17 00:00:00 2001 From: wm4 Date: Fri, 26 Apr 2013 16:52:54 +0200 Subject: options: allow using [ ] for quoting in sub-options This is an attempt to make quoting of sub-option values less awkward, even if it works only with some shells. This is needed mainly for vf_lavfi. Also update the vf_lavfi manpage section. --- DOCS/man/en/vf.rst | 19 +++++++++++++------ 1 file changed, 13 insertions(+), 6 deletions(-) (limited to 'DOCS') diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst index e534c73ec3..846d3ffac6 100644 --- a/DOCS/man/en/vf.rst +++ b/DOCS/man/en/vf.rst @@ -383,14 +383,21 @@ lavfi=graph[:sws_flags] *EXAMPLE*: - ``'--vf=lavfi="gradfun=20:30"'`` - gradfun filter with non-sensical parameters. The ``'`` quotes are - for the shell. Otherwise, the shell would remove the ``"`` quotes. + ``-vf lavfi=[gradfun=20:30,vflip]`` + gradfun filter with nonsense parameters, followed by a vflip + filter. (This demonstrates how libavfilter takes a graph and not + just a single filter.) The filter graph string is quoted with + ``[`` and ``]``. This requires no additional quoting or escaping + with some shells (like bash), while others (like zsh) require + additional ``"`` quotes around the option string. + + ``'--vf=lavfi="gradfun=20:30,vflip"'`` + same as before, but uses quoting that should be safe with all + shells. The outer ``'`` quotes make sure that the shell doesn't + remove the ``"`` quotes needed by mpv. ``'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'`` - same as before, but uses named parameters. Also a vflip filter is - appended, demonstrating how libavfilter actually takes a graph - description and not a single filter. + same as before, but uses named parameters for everything. If libavfilter inserts filters for pixel format conversion, this -- cgit v1.2.3