diff options
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/options.rst | 31 |
1 files changed, 30 insertions, 1 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 0ef7aae84a..b7ffda9a8c 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -4346,10 +4346,16 @@ The following video options are currently all specific to ``--vo=gpu`` and Used in ``--dither=fruit`` mode only. -``--dither=<fruit|ordered|no>`` +``--dither=<fruit|ordered|error-diffusion|no>`` Select dithering algorithm (default: fruit). (Normally, the ``--dither-depth`` option controls whether dithering is enabled.) + The ``error-diffusion`` option requires compute shader support. It also + requires large amount of shared memory to run, the size of which depends on + both the kernel (see ``--error-diffusion`` option below) and the height of + video window. It will fallback to ``fruit`` dithering if there is no enough + shared memory to run the shader. + ``--temporal-dither`` Enable temporal dithering. (Only active if dithering is enabled in general.) This changes between 8 different dithering patterns on each frame @@ -4362,6 +4368,29 @@ The following video options are currently all specific to ``--vo=gpu`` and ``--temporal-dither`` is in use. 1 (the default) will update on every video frame, 2 on every other frame, etc. +``--error-diffusion=<kernel>`` + The error diffusion kernel to use when ``--dither=error-diffusion`` is set. + + ``simple`` + Propagate error to only two adjacent pixels. Fastest but low quality. + + ``sierra-lite`` + Fast with reasonable quality. This is the default. + + ``floyd-steinberg`` + Most notable error diffusion kernel. + + ``atkinson`` + Looks different from other kernels because only fraction of errors will + be propagated during dithering. A typical use case of this kernel is + saving dithered screenshot (in window mode). This kernel produces + slightly smaller file, with still reasonable dithering quality. + + There are other kernels (use ``--error-diffusion=help`` to list) but most of + them are much slower and demanding even larger amount of shared memory. + Among these kernels, ``burkes`` achieves a good balance between performance + and quality, and probably is the one you want to try first. + ``--gpu-debug`` Enables GPU debugging. What this means depends on the API type. For OpenGL, it calls ``glGetError()``, and requests a debug context. For Vulkan, it |