updated manual and new libplacebo GUI options

docs/changelog.md

@@ -1,10 +1,11 @@
 
 # v7.0.0.4 Beta (2023-??-??)
 
+- Updated manual.
 - mpv.net is available via command line package manager winget.
 - New libplacebo config editor options added.
-- The conf editor uses a newly developed combo box control instead of radio buttons
+- The conf editor uses a newly developed combo box control (dropdown menu)
-  whenever an option has more than 3 items.
+  instead of radio buttons whenever an option has more than 3 items.
 - New zhongfly libmpv build.
 
 

docs/manual.md

@@ -43,9 +43,7 @@ Download
 --------
 
 1. [Stable and beta portable and setup via GitHub download](../../../releases)
-
+2. Stable via command line with winget: `winget install mpv.net`
-2. Stable via command line from winget: `winget install mpv.net`
-
 3. [Automated nightly portable builds](https://github.com/mpvnet-player/mpv.net/actions)
 
 [Changelog](changelog.md)
@@ -54,10 +52,8 @@ Download
 Installation
 ------------
 
-1. Windows 7 or higher is required (Windows 10 or higher is recommended).
+1. Windows 10 or higher.
-2. mpv.net since version 7.0 requires the
+2. [.NET Desktop Runtime 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
-   [.NET Desktop Runtime 6.0](https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
-   being installed. mpv.net before version 7.0 requires .NET Framework 4.8.
 
 Internet streaming requires:
 
@@ -69,8 +65,8 @@ Internet streaming requires:
 
 File Associations can be registered using the context menu under 'Settings > Setup'.
 
-After the file associations were registered, it might be necessary to change the
+After the file associations were registered, it might still be necessary to change the
-default app in the Windows settings (Win+I, ms-settings:defaultapps).
+default app in the Windows settings.
 
 Another way to register file associations is using Windows File Explorer,
 select a media file and select 'Open with > Choose another app' in the context menu.
@@ -82,6 +78,11 @@ to get menu items for [Play with mpv.net](https://github.com/stax76/OpenWithPlus
 When multiple files are selected in File Explorer and enter is pressed then
 the files are opened in mpv.net in random order, this works with maximum 15 files.
 
+#### Path environment variable
+
+In order to use mpv.net in a terminal for advanced use cases,
+mpv.net must be added to the Path environment variable,
+this can be achieved with the context menu (Settings/Setup).
 
 Support
 -------
@@ -108,8 +109,9 @@ Settings
 
 mpv.net searches the config folder at:
 
-1. startup\portable_config
+1. Folder defined via MPVNET_HOME environment variable.
-2. %APPDATA%\mpv.net (`C:\Users\%USERNAME%\AppData\Roaming\mpv.net`)
+2. startup\portable_config (startup means the directory containing mpvnet.exe)
+3. `%APPDATA%\mpv.net` (`C:\Users\Username\AppData\Roaming\mpv.net`)
 
 mpv options are stored in the file mpv.conf,
 mpv.net options are stored in the file mpvnet.conf,
@@ -119,7 +121,7 @@ mpv.net options are documented [here](#mpvnet-specific-options).
 Input and context menu
 ----------------------
 
-Global keyboard shortcuts are supported via global-input.conf file.
+Global keyboard shortcuts are supported via `global-input.conf` file.
 
 The config folder can be opened from the context menu: `Settings > Open Config Folder`
 
@@ -139,24 +141,31 @@ mpv input options:
 https://mpv.io/manual/master/#input
 
 Before version v7 all bindings and the context menu definition
-was contained in the input.conf file, which mpv.net created
+were defined in the input.conf file, which mpv.net created
 in case it didn't exist. This had the disadvantage that mpv.net
-lost control over all default bindings and the context menu
+lost control over all default bindings and context menu
-defaults. This was unfortunate, v7 introduces a new design
+defaults. This was unfortunate, v7 introduces a new bindings
-fixing it.
+and context menu design fixing it.
 
 In v7 no input.conf file is created, the default bindings and
 context menu is defined internally. input.conf only contains
 what is different from the internally defined defaults,
-so it's the same how mpv is used.
+so it works the same it work with mpv.
 
-For backward compatibility the old input.conf format with the
+For backward compatibility the old input.conf context menu
-menu definition using `#menu: ` is still supported. The new
+format with the menu definition using `#menu: ` is still
-design also allows for a menu customization, in a sub section
+supported. The new design also allows for a menu customization,
-called `Custom`. In input.conf it can be defined like so:
+in a sub section called `Custom`. In input.conf it can be
+defined like so:
 
 `Ctrl+a  show-text Test  #custom-menu: Test > Test`
 
+Users that have their bindings and context menu customized
+before v7 can easily migrate to the new design by deleting
+bindings they don't use and remember the shortcut and remove
+`#menu:` everywhere, it's important to remove `#menu:`
+everywhere in order to enable the new mode/design.
+
 
 Command Line Interface
 ----------------------
@@ -192,8 +201,6 @@ Terminal
 When mpv.net is started from a terminal it will output status,
 error and debug messages to the terminal and accept input keys from the terminal.
 
-A common task for the terminal is debugging scripts.
-
 
 mpv.net specific commands
 -------------------------
@@ -205,6 +212,9 @@ mpv.net commands are used when mpv commands don't exist or lack a feature.
 ### add-to-path
 Adds mpv.net to the Path environment variable.
 
+### edit-conf-file [mpv.conf|input.conf]
+Opens mpv.conf or input.conf in a text editor.
+
 ### load-audio
 Shows a file browser dialog to open external audio files.
 
@@ -513,7 +523,8 @@ Scripting
 
 #### Lua
 
-A very large collection of Lua user scripts can be found in the mpv wiki [here](https://github.com/mpv-player/mpv/wiki/User-Scripts).
+A very large collection of user scripts can be found in the GitHub repository
+[awesome-mpv](https://github.com/stax76/awesome-mpv). 
 
 Lua scripting is documented in the mpv.net wiki [here](https://github.com/mpvnet-player/mpv.net/wiki/Extending-mpv-and-mpv.net-via-Lua-scripting).
 
@@ -522,10 +533,10 @@ Lua scripting is documented in the mpv.net wiki [here](https://github.com/mpvnet
 [mpv JavaScript documentation](https://mpv.io/manual/master/#javascript)
 
 
-Extensions
+.NET Extensions
-----------
+---------------
 
-Extensions are located in a subfolder _extensions_ in the config folder,
+.NET Extensions are located in a subfolder _extensions_ in the config folder,
 the filename must have the same name as the directory:
 
 ```Text
@@ -677,10 +688,6 @@ Environment Variables
 
 Directory where mpv.net looks for user settings.
 
-### MPVNET_VERSION
-
-Returns the version of mpv.net.
-
 
 Context Menu Commands
 ---------------------

src/MpvNet.Windows/Resources/editor_conf.txt

@@ -320,6 +320,48 @@ file = libplacebo
 directory = Video/libplacebo/Scaling
 help = <0.0..1.0> Antiringing strength to use for all filters. A value of 0.0 disables antiringing, and a value of 1.0 enables full-strength antiringing. Defaults to 0.0.
 
+name = deband
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = Enables debanding.
+default = no
+option = yes
+option = no
+
+name = deband_iterations
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = <0..16> The number of debanding steps to perform per sample. Each step reduces a bit more banding, but takes time to compute. Note that the strength of each step falls off very quickly, so high numbers (>4) are practically useless. Defaults to 1.
+
+name = deband_threshold
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = <0.0..1000.0> The debanding filter's cut-off threshold. Higher numbers increase the debanding strength dramatically, but progressively diminish image details. Defaults to 3.0.
+
+name = deband_radius
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = <0.0..1000.0> The debanding filter's initial radius. The radius increases linearly for each iteration. A higher radius will find more gradients, but a lower radius will smooth more aggressively. Defaults to 16.0.
+
+name = deband_grain
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = <0.0..1000.0> Add some extra noise to the image. This significantly helps cover up remaining quantization artifacts. Higher numbers add more noise. Defaults to 4.0, which is very mild.
+
+name = deband_grain_neutral_r
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = 'Neutral' grain value for each channel being debanded. Grain application will be modulated to avoid disturbing colors close to this value. Set this to a value corresponding to black in the relevant colorspace.
+
+name = deband_grain_neutral_g
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = 'Neutral' grain value for each channel being debanded. Grain application will be modulated to avoid disturbing colors close to this value. Set this to a value corresponding to black in the relevant colorspace.
+
+name = deband_grain_neutral_b
+file = libplacebo
+directory = Video/libplacebo/Debanding
+help = 'Neutral' grain value for each channel being debanded. Grain application will be modulated to avoid disturbing colors close to this value. Set this to a value corresponding to black in the relevant colorspace.
 
 name = screenshot-directory
 file = mpv