Avslibplacebo - Revision history

Asd: avslibplacebo 1.2.0

2023-05-18T09:39:56Z

avslibplacebo 1.2.0

Show changes

Reel.Deal: /* Requirements */ update avs+ link

2023-02-21T03:28:48Z

‎Requirements: update avs+ link

Reel.Deal: /* External Links */

2023-02-21T03:21:13Z

‎External Links

Reel.Deal: /* External Links */ add link

2022-12-11T17:45:09Z

‎External Links: add link

Reel.Deal: /* External Links */ add links to compatible shaders

2022-09-07T02:10:58Z

‎External Links: add links to compatible shaders

Reel.Deal: /* Tonemap */ copy paste typo

2022-09-06T04:15:16Z

‎Tonemap: copy paste typo

Reel.Deal: /* Description */

2022-09-06T04:12:05Z

‎Description

Reel.Deal: /* Description */

2022-09-06T00:34:56Z

‎Description

Reel.Deal: /* Description */ add description to filters

2022-09-06T00:20:35Z

‎Description: add description to filters

Reel.Deal: /* Tonemap */ add documentation

2022-09-05T23:59:37Z

‎Tonemap: add documentation

@@ Line 23: / Line 23: @@
 == Requirements ==
 * [https://en.wikipedia.org/wiki/Vulkan Vulkan] compatible devive
-* '''AviSynth+ r3682''' (can be downloaded from [https://gitlab.com/uvz/AviSynthPlus-Builds here] until official release is uploaded) or later
+* [x64]: '''AviSynth+ r3682''' or greater (AviSynth+ 3.7.3 (test 6, r3935 can be [https://forum.doom9.org/showthread.php?p=1983250#post1983250 downloaded from here])
 * Microsoft VisualC++ Redistributable Package 2022 (can be downloaded from [https://github.com/abbodi1406/vcredist/releases here])
 * Supported color formats: listed below for each filter
 <br>
 == [[Script variables|Syntax and Parameters]] ==

@@ Line 549: / Line 549: @@
 <br>
 -----------------------------------------------
-'''Back to [[External_filters#Averaging.2FLayering.2FMasking|External Filters]] &larr;'''
+'''Back to [[External_filters#Multipurpose_Filters|External Filters]] &larr;'''
 -----------------------------------------------

@@ Line 545: / Line 545: @@
 * [https://github.com/Alexkral/AviSynthAiUpscale/tree/master/mpv%20user%20shaders GitHub] - AviSynthAiUpscale: implementation of some Super-Resolution Convolutional Neural Networks.
 * [https://github.com/butterw/bShaders/tree/master/mpv GitHub] - small collection of mpv shaders, more info [https://forum.videohelp.com/threads/397797-Pixel-shaders-for-video-playback-%28-hlsl-glsl%29 here].
-* [https://www.reddit.com/r/mpv/comments/hvwvsl/crt_scanline_glsl_shader/ Reddit] - crt-easymode shader.
+* [https://www.reddit.com/r/mpv/comments/hvwvsl/crt_scanline_glsl_shader/ Reddit] - crt-easymode shader. Fix for YUV ouput: [https://forum.doom9.org/showthread.php?t=184366 Doom9 thread]
 <br>
 <br>

@@ Line 541: / Line 541: @@
 == External Links ==
 *[https://github.com/Asd-g/avslibplacebo GitHub] - Source code repository.
 <br>
 <br>

@@ Line 487: / Line 487: @@
 <br>
 ::{{Par2|tone_mapping_function|int|0}}
-:::Antiringing strength.
+:::*0: auto (Special tone mapping function that means "automatically pick a good function based on the HDR levels")
-:::0: auto (Special tone mapping function that means "automatically pick a good function based on the HDR levels")
 :::*1: clip (Performs no tone-mapping, just clips out-of-range colors.<br>Retains perfect color accuracy for in-range colors but completely destroys out-of-range information.<br>Does not perform any black point adaptation.)
 :::*2: bt2390 (EETF from the ITU-R Report BT.2390, a hermite spline roll-off with linear segment.<br>The knee point offset is configurable. Note that this defaults to 1.0, rather than the value of 0.5 from the ITU-R spec.)

@@ Line 17: / Line 17: @@
 * [[avslibplacebo#Deband|Deband]] - tunable debanding. Based on flash3kyuu, expanded to provide high quality by combining multiple debanding passes.
 * [[avslibplacebo#Resample|Resample]] - high-quality, optimized upscaling and downscaling including support for polar filters ("Jinc"), anti-aliasing, anti-ringing and gamma correct scaling.
-* [[avslibplacebo#Shader|Shader]] - loads shaders written in [https://mpv.io/manual/master/#options-glsl-shaders mpv's .hook syntax]. This can be used to arbitrarily extend the range of custom shaders to include popular user shaders like RAVU, FSRCNNX, or Anime4K, and others.
+* [[avslibplacebo#Shader|Shader]] - loads GLSL shaders written in [https://mpv.io/manual/master/#options-glsl-shaders mpv's .hook syntax]. This can be used to arbitrarily extend the range of custom shaders to include popular user shaders like RAVU, FSRCNNX, or Anime4K, and others.
 * [[avslibplacebo#Tonemap|Tonemap]] - dynamic HDR tone mapping, includes peak and scene-change detection, chroma-preserving (luma-only) tone mapping, highlight desaturation, dynamic exposure control and a variety of industry-standard EETFs including BT.2390.
 <br>

@@ Line 15: / Line 15: @@
 '''Filters'''
-* [[avslibplacebo#Deband|Debanding]] - tunable debanding. Based on flash3kyuu, expanded to provide high quality by combining multiple debanding passes.
+* [[avslibplacebo#Deband|Deband]] - tunable debanding. Based on flash3kyuu, expanded to provide high quality by combining multiple debanding passes.
-* [[avslibplacebo#Resample|Resampling]] - high-quality, optimized upscaling and downscaling including support for polar filters ("Jinc"), anti-aliasing, anti-ringing and gamma correct scaling.
+* [[avslibplacebo#Resample|Resample]] - high-quality, optimized upscaling and downscaling including support for polar filters ("Jinc"), anti-aliasing, anti-ringing and gamma correct scaling.
 * [[avslibplacebo#Shader|Shader]] - loads shaders written in [https://mpv.io/manual/master/#options-glsl-shaders mpv's .hook syntax]. This can be used to arbitrarily extend the range of custom shaders to include popular user shaders like RAVU, FSRCNNX, or Anime4K, and others.
-* [[avslibplacebo#Tonemap|Tone mapping]] - dynamic HDR tone mapping, includes peak and scene-change detection, chroma-preserving (luma-only) tone mapping, highlight desaturation, dynamic exposure control and a variety of industry-standard EETFs including BT.2390.
+* [[avslibplacebo#Tonemap|Tonemap]] - dynamic HDR tone mapping, includes peak and scene-change detection, chroma-preserving (luma-only) tone mapping, highlight desaturation, dynamic exposure control and a variety of industry-standard EETFs including BT.2390.
 <br>

← Older revision		Revision as of 23:59, 5 September 2022
Line 427:		Line 427:

	===Tonemap===		===Tonemap===
		+	:{{Template:FuncDef\| libplacebo_Tonemap (clip input, int "src_csp", float "dst_csp", float "src_max", float "src_min", float "dst_max", float "dst_min", bool "dynamic_peak_detection", float "smoothing_period", float "scene_threshold_low", float "scene_threshold_high", int "intent", int "gamut_mode", int "tone_mapping_function", int "tone_mapping_mode", float "tone_mapping_param", float "tone_mapping_crosstalk", bool "use_dovi", int "device", bool "list_device")}}
		+	<br>
		+	::{{Par2\| \|clip\| }}
		+	:::A clip to process.
		+	:::It must be 16-bit planar format. (min. 3 planes)
		+	:::The output is YUV444P16 if the input is YUV.
		+	<br>
		+	::{{Par2\|src_csp\|int\|1}}
		+	::{{Par2\|dst_csp\|int\|0}}
		+	:::Respectively source and output color space.
		+	:::*0: SDR
		+	:::*1: HDR10
		+	:::*2: HLG
		+	:::*3: DOVI
		+	:::Default: src_csp = 1; dst_csp = 0.
		+	:::For example, to map from [BT.2020, PQ] (HDR) to traditional [BT.709, BT.1886] (SDR), pass <code>src_csp=1, dst_csp=0</code>.
		+	<br>
		+	::{{Par2\|src_max\|float\|}}
		+	::{{Par2\|src_min\|float\|}}
		+	::{{Par2\|dst_max\|float\|}}
		+	::{{Par2\|dst_min\|float\|}}
		+	:::Source max/min and output max/min in nits (cd/m^2).
		+	:::The source values can be derived from props if available.
		+	:::Default: max = 1000 (HDR)/203 (SDR); min = 0.005 (HDR)/0.2023 (SDR)
		+	<br>
		+	::{{Par2\|dynamic_peak_detection\|bool\|true}}
		+	:::Enables computation of signal stats to optimize HDR tonemapping quality.
		+	:::Default: True.
		+	<br>
		+	::{{Par2\|smoothing_period\|float\|100.0}}
		+	:::Smoothing coefficient for the detected values.
		+	:::This controls the time parameter (tau) of an IIR low pass filter. In other words, it represent the cutoff period (= 1 / cutoff frequency) in frames. Frequencies below this length will be suppressed.
		+	:::This helps block out annoying "sparkling" or "flickering" due to small variations in frame-to-frame brightness.
		+	:::Default: 100.0.
		+	<br>
		+	::{{Par2\|scene_threshold_low\|float\|5.5}}
		+	::{{Par2\|scene_threshold_high\|float\|10.0}}
		+	:::In order to avoid reacting sluggishly on scene changes as a result of the low-pass filter, we disable it when the difference between the current frame brightness and the average frame brightness exceeds a given threshold difference.
		+	:::But rather than a single hard cutoff, which would lead to weird discontinuities on fades, we gradually disable it over a small window of brightness ranges. These parameters control the lower and upper bounds of this window, in dB.
		+	:::To disable this logic entirely, set either one to a negative value.
		+	:::Default: scene_threshold_low = 5.5; scene_threshold_high = 10.0
		+	<br>
		+	::{{Par2\|intent\|int\|1}}
		+	:::The rendering intent to use for gamut mapping.
		+	:::*0: PERCEPTUAL
		+	:::*1: RELATIVE_COLORIMETRIC
		+	:::*2: SATURATION
		+	:::*3: ABSOLUTE_COLORIMETRIC
		+	:::Default: 1.
		+	<br>
		+	::{{Par2\|gamut_mode\|int\|0}}
		+	:::How to handle out-of-gamut colors when changing the content primaries.
		+	:::*0: CLIP (Do nothing, simply clip out-of-range colors to the RGB volume)
		+	:::*1: WARN (Equal to CLIP but also highlights out-of-gamut colors (by coloring them pink))
		+	:::*2: DARKEN (Linearly reduces content brightness to preserves saturated details, followed by clipping the remaining out-of-gamut colors.<br>As the name implies, this makes everything darker, but provides a good balance between preserving details and colors.)
		+	:::*3: DESATURATE (Hard-desaturates out-of-gamut colors towards white, while preserving the luminance. Has a tendency to shift colors.)
		+	:::Default: 0.
		+	<br>
		+	::{{Par2\|tone_mapping_function\|int\|0}}
		+	:::Antiringing strength.
		+	:::0: auto (Special tone mapping function that means "automatically pick a good function based on the HDR levels")
		+	:::*1: clip (Performs no tone-mapping, just clips out-of-range colors.<br>Retains perfect color accuracy for in-range colors but completely destroys out-of-range information.<br>Does not perform any black point adaptation.)
		+	:::*2: bt2390 (EETF from the ITU-R Report BT.2390, a hermite spline roll-off with linear segment.<br>The knee point offset is configurable. Note that this defaults to 1.0, rather than the value of 0.5 from the ITU-R spec.)
		+	:::*3: bt2446a (EETF from ITU-R Report BT.2446, method A.<br>Can be used for both forward and inverse tone mapping. Not configurable.)
		+	:::*4: spline (Simple spline consisting of two polynomials, joined by a single pivot point.<br>The <code>tone_mapping_param</code> gives the pivot point (in PQ space), defaulting to 0.30.<br>Can be used for both forward and inverse tone mapping.)
		+	:::*5: reinhard (Simple non-linear, global tone mapping algorithm.<br>Named after Erik Reinhard.<br>The <code>tone_mapping_param</code> specifies the local contrast coefficient at the display peak.<br>Essentially, a value of param=0.5 implies that the reference white will be about half as bright as when clipping.<br>Defaults to 0.5, which results in the simplest formulation of this function.)
		+	:::*6: mobius (Generalization of the reinhard tone mapping algorithm to support an additional linear slope near black.<br>The tone mapping <code>tone_mapping_param</code> indicates the trade-off between the linear section and the non-linear section.<br>Essentially, for param=0.5, every color value below 0.5 will be mapped linearly, with the higher values being non-linearly tone mapped.<br>Values near 1.0 make this curve behave like clip, and values near 0.0 make this curve behave like reinhard.<br>The default value is 0.3, which provides a good balance between colorimetric accuracy and preserving out-of-gamut details.<br>The name is derived from its function shape (ax+b)/(cx+d), which is known as a Möbius transformation in mathematics.)
		+	:::*7: hable (Piece-wise, filmic tone-mapping algorithm developed by John Hable for use in Uncharted 2, inspired by a similar tone-mapping algorithm used by Kodak.<br>Popularized by its use in video games with HDR rendering.<br>Preserves both dark and bright details very well, but comes with the drawback of changing the average brightness quite significantly.<br>This is sort of similar to reinhard with <code>tone_mapping_param</code> 0.24.)
		+	:::*8: gamma (Fits a gamma (power) function to transfer between the source and target color spaces, effectively resulting in a perceptual hard-knee joining two roughly linear sections.<br>This preserves details at all scales fairly accurately, but can result in an image with a muted or dull appearance.<br>The <code>tone_mapping_param</code> is used as the cutoff point, defaulting to 0.5.)
		+	:::*9: linear (Linearly stretches the input range to the output range, in PQ space.<br>This will preserve all details accurately, but results in a significantly different average brightness.<br>Can be used for inverse tone-mapping in addition to regular tone-mapping.<br>The parameter can be used as an additional linear gain coefficient (defaulting to 1.0).)
		+	:::Default: 0.
		+	<br>
		+	::{{Par2\|tone_mapping_mode\|int\|0}}
		+	:::*0: AUTO (Picks the best tone-mapping mode based on internal heuristics.)
		+	:::*1: RGB (Per-channel tone-mapping in RGB. Guarantees no clipping and heavily desaturates the output, but distorts the colors quite significantly.)
		+	:::*2: MAX (Tone-mapping is performed on the brightest component found in the signal.<br>Good at preserving details in highlights, but has a tendency to crush blacks.)
		+	:::*3: HYBRID (Tone-map per-channel for highlights and linearly (luma-based) for midtones/shadows, based on a fixed gamma 2.4 coefficient curve.)
		+	:::*4: LUMA (Tone-map linearly on the luma component, and adjust (desaturate) the chromaticities to compensate using a simple constant factor.<br>This is essentially the mode used in ITU-R BT.2446 method A.)
		+	:::Default: 0.
		+	<br>
		+	::{{Par2\|tone_mapping_param\|float\|}}
		+	:::The tone-mapping curve parameter.
		+	:::Default: Default for the selected <code>tone_mapping_function</code>.
		+	<br>
		+	::{{Par2\|tone_mapping_crosstalk\|float\|0.04}}
		+	:::Extra crosstalk factor to apply before tone-mapping.
		+	:::May help to improve the appearance of very bright, monochromatic highlights.
		+	:::Default: 0.04.
		+	<br>
		+	::{{Par2\|use_dovi\|bool\|}}
		+	:::Whether to use the Dolby Vision RPU for ST2086 metadata.
		+	:::Defaults to true when tonemapping from Dolby Vision.
		+	<br>
		+	::{{Par2\|device\|int\|}}
		+	:::Sets target Vulkan device.
		+	:::Use list_device to get the index of the available devices.
		+	:::By default the default device is selected.
		+	<br>
		+	::{{Par2\|list_device\|bool\|false}}
		+	:::Whether to draw the devices list on the frame.
		+	:::Default: False.
	<br>		<br>