Butteraugli - Revision history

Asd: Butteraugli 2.0.1

2023-05-18T07:14:13Z

Butteraugli 2.0.1

Asd: Update to the latest version

2022-01-12T22:24:04Z

Update to the latest version

Reel.Deal: category

2020-11-08T04:46:48Z

Reel.Deal: v1.1.0

2020-11-08T04:09:18Z

v1.1.0

Reel.Deal: v1.0.2

2020-11-03T20:39:06Z

v1.0.2

Asd: Update examples

2020-11-01T02:55:37Z

Update examples

Reel.Deal: Butteraugli v1.0.0

2020-10-31T20:34:07Z

Butteraugli v1.0.0

New page

{{FilterCat5|External_filters|Plugins|Plugins_x64|Other_filters|Debugging/Diagnostic_filters}}
{{Filter3
| 1={{Author/Asd-g}}
| 2=v1.0.0
| 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli-1.0.0.7z]
| 4=Debug filter
| 5=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/blob/main/LICENSE GPLv3]
| 6=}}

== Description ==
[[Butteraugli]] estimating filter for the psychovisual similarity of two images.

A quality metric for lossy image and video compression.

This is [https://github.com/fdar0536/VapourSynth-butteraugli a port of the VapourSynth plugin butteraugli.]

[https://github.com/google/butteraugli Google's Butteraugli] is used.
 
 
== Requirements ==
*'''AviSynth+ >=3.6 required in order to use this filter.'''
* [x86] [[AviSynth+]]
* [x64] [[AviSynth+]]
* Supported color formats: [[RGBP8]]
 

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|Butteraugli (clip clip1, clip clip2, bool "heatmap")}}
 
::{{Par2| |clip| }}
::{{Par2| |clip| }}
::: Clips that are use for estimating the psychovisual similarity. They must be in RGB 8-bit [[planar]] format.
 
::{{Par2|heatmap|bool|true}}
:::True: A heatmap is returned containing differences between two input clips.
:::False: Returns clip2.
 
:The psychovisual similarity of the clips will be stored as frame property '_FrameButteraugli' in the output clip. Larger values indicate to bigger difference.
 

==Examples==
[[TODO]]
Butteraugli(clip1, clip2, heatmap=true)

 

== Changelog ==
Version Date Changes 
v1.0.0 2020/10/31 - Initial release
 

==External Links ==
*[https://github.com/Asd-g/AviSynthPlus-Butteraugli GitHub] - Source code repository.
 
 
-----------------------------------------------
'''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] ←'''

@@ Line 2: / Line 2: @@
 {{Filter3
 | 1={{Author/Asd-g}}
-| 2=v2.0.0
+| 2=v2.0.1
 | 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli]
 | 4=Debug filter
@@ Line 59: / Line 59: @@
 == Changelog ==
   Version      Date            Changes<br>
   v2.0.0       2021/10/20      - Updated to butteraugli library from libjxl.<br>
   v1.1.0       2020/11/06      - Added support for 10..32-bit clips.

@@ Line 2: / Line 2: @@
 {{Filter3
 | 1={{Author/Asd-g}}
-| 2=v1.1.0
+| 2=v2.0.0
-| 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli-1.1.0.7z]
+| 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli]
 | 4=Debug filter
 | 5=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/blob/main/LICENSE GPLv3]
@@ Line 15: / Line 15: @@
 This is [https://github.com/fdar0536/VapourSynth-butteraugli a port of the VapourSynth plugin butteraugli.]
-[https://github.com/google/butteraugli Google's Butteraugli] is used.
+[https://github.com/libjxl/libjxl libjxl's Butteraugli] is used.
 <br>
 <br>
@@ Line 26: / Line 26: @@
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|Butteraugli (clip clip1, clip clip2, float "hf_asymmetry", bool "heatmap", bool "linput")}}
+:{{Template:FuncDef|Butteraugli (clip reference, clip distorted, bool "distmap", float "intensity_target", bool "linput")}}
 <br>
-::{{Par2| |clip| }}
+::{{Par2| |reference| }}
-::{{Par2| |clip| }}
+::{{Par2| |distorted| }}
 ::: Clips that are use for estimating the psychovisual similarity. They must be in [[Planar|planar RGB]] format (8-32bit).
 <br>
-::{{Par2|hf_asymmetry|float|1.0}}
+::{{Par2|distmap|bool|false}}
-:::Multiplier for penalizing new HF artifacts more than blurring away features. 1.0=neutral.
+:::Whether to return heatmap instead of distorted clip
-:::Must be greater than 0.0.
-:::Default: 1.0.
 <br>
-::{{Par2|heatmap|bool|true}}
+::{{Par2|intensity_target|float|80.0}}
-:::True: A heatmap is returned containing differences between two input clips.
+:::Viewing conditions screen nits
-:::False: Returns clip2.
 <br>
 ::{{Par2|linput|bool|false}}
 :::True: The input clips must have linear transfer functions.
 :::False: The input clips are assumed in sRGB color space and internal conversion to linear transfer function is done.
 <br>
 :The psychovisual similarity of the clips will be stored as frame property '_FrameButteraugli' in the output clip. Larger values indicate to bigger difference.
@@ Line 51: / Line 47: @@
 ==Examples==
   # Return the difference between the clips with displayed all frame properties alongside with '_FrameButteraugli'
-  Butteraugli(clip1, clip2, hf_asymmetry=1.0, heatmap=true, linput=false)
+  Butteraugli(clip1, clip2, distmap=true, linput=false)
   propShow()
   # Return clip2 with displayed the value of the frame property '_FrameButteraugli'.
-  Butteraugli(clip1, clip2, hf_asymmetry=1.0, heatmap=true, linput=false)
+  Butteraugli(clip1, clip2, linput=false)
   ScriptClip("""Subtitle(String(propGetFloat("_FrameButteraugli")))""")
@@ Line 63: / Line 59: @@
 == Changelog ==
   Version      Date            Changes<br>
   v1.1.0       2020/11/06      - Added support for 10..32-bit clips.
-                              - Added parameters 'hf_asymmetry' and 'linput'.<br>
+                                                  - Added parameters 'hf_asymmetry' and 'linput'.<br>
   v1.0.2       2020/11/02      - Registered as [[MT_MULTI_INSTANCE]].
-                              - Used faster butteraugli lib.<br>
+                                                  - Used faster butteraugli lib.<br>
   v1.0.0       2020/10/31      - Initial release
 <br>

@@ Line 2: / Line 2: @@
 {{Filter3
 | 1={{Author/Asd-g}}
-| 2=v1.0.2
+| 2=v1.1.0
-| 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli-1.0.2.7z]
+| 3=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/releases/ Butteraugli-1.1.0.7z]
 | 4=Debug filter
 | 5=[https://github.com/Asd-g/AviSynthPlus-Butteraugli/blob/main/LICENSE GPLv3]
@@ Line 22: / Line 22: @@
 * [x86] [[AviSynth+]]
 * [x64] [[AviSynth+]]
-* Supported color formats: [[RGBP8]]
+* Supported color formats: [[Planar|Planar RGB]] (8-32bit)
 <br>
 == [[Script variables|Syntax and Parameters]] ==
-:{{Template:FuncDef|Butteraugli (clip clip1, clip clip2, bool "heatmap")}}
+:{{Template:FuncDef|Butteraugli (clip clip1, clip clip2, float "hf_asymmetry", bool "heatmap", bool "linput")}}
 <br>
 ::{{Par2| |clip| }}
 ::{{Par2| |clip| }}
-::: Clips that are use for estimating the psychovisual similarity. They must be in RGB 8-bit [[planar]] format.
+::: Clips that are use for estimating the psychovisual similarity. They must be in [[Planar|planar RGB]] format (8-32bit).
 <br>
 ::{{Par2|heatmap|bool|true}}
 :::True: A heatmap is returned containing differences between two input clips.
 :::False: Returns clip2.
 <br>
 :The psychovisual similarity of the clips will be stored as frame property '_FrameButteraugli' in the output clip. Larger values indicate to bigger difference.
@@ Line 41: / Line 51: @@
 ==Examples==
   # Return the difference between the clips with displayed all frame properties alongside with '_FrameButteraugli'
-  Butteraugli(clip1, clip2, heatmap=true)
+  Butteraugli(clip1, clip2, hf_asymmetry=1.0, heatmap=true, linput=false)
   propShow()
   # Return clip2 with displayed the value of the frame property '_FrameButteraugli'.
-  Butteraugli(clip1, clip2, heatmap=false)
+  Butteraugli(clip1, clip2, hf_asymmetry=1.0, heatmap=true, linput=false)
   ScriptClip("""Subtitle(String(propGetFloat("_FrameButteraugli")))""")
@@ Line 53: / Line 63: @@
 == Changelog ==
   Version      Date            Changes<br>
   v1.0.2       2020/11/02      - Registered as [[MT_MULTI_INSTANCE]].
                                - Used faster butteraugli lib.<br>

@@ Line 1: / Line 1: @@
-{{FilterCat5|External_filters|Plugins|Plugins_x64|Other_filters|Debugging/Diagnostic_filters}}
+{{FilterCat6|External_filters|Plugins|Plugins_x64|Other_filters|Debugging/Diagnostic_filters|Deep_color_tools}}
 {{Filter3
 | 1={{Author/Asd-g}}