MaxCLLFind - Revision history

FranceBB: Added reference to Windows XP compatible binaries

2025-11-23T20:34:00Z

Added reference to Windows XP compatible binaries

Reel.Deal: v0.36

2022-08-07T19:23:24Z

v0.36

Reel.Deal: add Deep_color_tools category

2020-06-25T23:53:28Z

add Deep_color_tools category

Reel.Deal: MaxCLLFind: add documentation

2020-04-13T14:32:50Z

MaxCLLFind: add documentation

New page

{{FilterCat5|External_filters|Plugins|Plugins_x64|Other_filters|Debugging/Diagnostic_filters}}
{{Filter3
| [https://github.com/TomArrow Tom Arrow]
| v0.35
| 3=[https://github.com/TomArrow/MaxCLLFindAVS/releases MaxCLLFindAVS.v0.35.zip]
| 4=Debug filter
| 5=?
| 6=[https://forum.doom9.org/showthread.php?t=177135 Doom9 Thread]}}

== Description ==
PQ HDR Analyzer plugin for AviSynth+, analyzes MaxCLL and MaxFALL and writes that to a text file after closing the application that is calling AviSynth+.

The created textfile's name is "MaxCLLFind_Results0.txt". It will be overwritten if it already exists.
 
 
== Requirements ==
* [x64] [[AviSynth+]]
* Supported color formats: [[RGB64]]
 

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|MaxCLLFind (clip, int "maxFallAlgorithm") }}
 
::{{Par2| |clip| }}
:::Input clip, must be 16-bit RGB ([[RGB64]]).
 
::{{Par2|maxFallAlgorithm|int|0}}
:::The default MaxFALL algorithm uses the SMPTE recommendation of averaging max(R,G,B) across all pixels, meaning the brightest channel of each pixel goes into the average.
:::If you want the average of all channels of all pixels (not the official recommendation) instead, do this:
:::<code>maxFallAlgorithm=1</code>
:::This is more for your own curiosity and might lead to playback problems like flickering if used as actual HDR metadata, since it typically leads to typically slightly lower average intensity readings and if the TV bases its own dimming on the official recommendation, it might dim the image when it reaches a higher FALL than your calculated MaxFALL, which will almost certainly happen.
 
 
==Examples==
clip.MaxCLLFind()

Load in VirtualDub and click Play. After video is finished playing, close VirtualDub. The plugin also writes the Average FALL (frame average light level) into the text file. If you want this result to be accurate, make sure to not load any frame more than once.

If your HDR clip isn't RGB64, convert it first. This plugin only accepts RGB64 input.

For example, let's say you are loading a HDR HEVC YUV file, do this:

clip = clip.ConvertToRGB64(matrix="Rec2020")
clip.MaxCLLFind()

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

@@ Line 48: / Line 48: @@
 *[https://github.com/TomArrow/MaxCLLFindAVS GitHub] - Source code repository.
 *[https://github.com/erazortt/MaxCLLFindAVS GitHub] - Source code repository (v0.36 update).
 <br>
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] &larr;'''

@@ Line 1: / Line 1: @@
 {{FilterCat6|External_filters|Plugins|Plugins_x64|Other_filters|Debugging/Diagnostic_filters|Deep_color_tools}}
 {{Filter3
-| [https://github.com/TomArrow Tom Arrow]
+| [https://github.com/TomArrow Tom Arrow], [https://github.com/erazortt erazortt]
-| v0.35
+| v0.36
-| 3=[https://github.com/TomArrow/MaxCLLFindAVS/releases MaxCLLFindAVS.v0.35.zip]
+| 3=[https://github.com/erazortt/MaxCLLFindAVS/releases MaxCLLFindAVS.v0.36.7z]
 | 4=Debug filter
 | 5=?
@@ Line 47: / Line 47: @@
 ==External Links ==
 *[https://github.com/TomArrow/MaxCLLFindAVS GitHub] - Source code repository.
 <br>
 <br>
 -----------------------------------------------
 '''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] &larr;'''