Introduced new LogIntermediateStats boolean to allow the user to decide whether to only output the final value or each value every 100 frame

[FranceBB]

• Updated maxcllfind.h: Added the new logIntermediateStats member variable and updated the constructor signature in the header.
• Updated maxcllfind.cpp: Updated the constructor definition, the parameter parsing in the function and added a conditional check to GetFrame() to decide whether to output the results every 100 frames or just the end value calculated based on the logIntermediateStats (by default is true for backwards compatibility with the current behavior).
• Updated Documentation with info and examples about the usage of the new LogIntermediateStats boolean.

[FranceBB]

Example:

LWLibavVideoSource("Test_Source.mov")
ConvertToRGB64(matrix="Rec2020")
MaxCLLFind(maxFallAlgorithm=0)

Stats at frame 1:
MaxCLL: 0, raw value: 0 0 at X 0 Y 0 at frame 0
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 0 at frame 0
FALL Average: 0 across 1 frames.

Stats at frame 101:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 4.07527 across 101 frames.

Stats at frame 201:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 2.84126 across 201 frames.

Stats at frame 301:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.94568 across 301 frames.

Stats at frame 401:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.52747 across 401 frames.

Stats at frame 501:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.42005 across 501 frames.

Stats at frame 601:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.24852 across 601 frames.

Stats at frame 701:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.18646 across 701 frames.

Stats at frame 801:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.11332 across 801 frames.

Stats at frame 901:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 8.55332 at frame 41
FALL Average: 1.06956 across 901 frames.

Stats at frame 1001:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.569 at frame 991
FALL Average: 2.12734 across 1001 frames.

Stats at frame 1101:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 7.41441 across 1101 frames.

Stats at frame 1201:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 8.57353 across 1201 frames.

Stats at frame 1301:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 9.43403 across 1301 frames.

Stats at frame 1401:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 10.2929 across 1401 frames.

Stats at frame 1501:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 11.1018 across 1501 frames.

Stats at frame 1601:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 11.4985 across 1601 frames.

Stats at frame 1701:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 11.8852 across 1701 frames.

Stats at frame 1801:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 12.1784 across 1801 frames.

Stats at frame 1901:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 11.9798 across 1901 frames.

Stats at frame 2001:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 11.7196 across 2001 frames.

Stats at frame 2101:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 12.1415 across 2101 frames.

Stats at frame 2201:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 12.4846 across 2201 frames.

Stats at frame 2301:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 12.7015 across 2301 frames.

Stats at frame 2401:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 13.3252 across 2401 frames.

Stats at frame 2501:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 13.9658 across 2501 frames.

Stats at frame 2601:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 14.2071 across 2601 frames.

Stats at frame 2701:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 14.5209 across 2701 frames.

Stats at frame 2801:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 14.8495 across 2801 frames.

Stats at frame 2901:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 15.115 across 2901 frames.

Stats at frame 3001:
MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007
FALL Average: 15.0032 across 3001 frames.

Setting the new boolean to false makes the function only return the last value

LWLibavVideoSource("Test_Source.mov")
ConvertToRGB64(matrix="Rec2020")
MaxCLLFind(maxFallAlgorithm=0, LogIntermediateStats=false)

MaxCLL: 400.011, raw value: 42767 0.652583 at X 0 Y 1101 at frame 7
MinCLL: 0, raw value: 0 0 at X 0 Y 2159 at frame 0
MaxFALL: 222.57 at frame 1007

In this last case, FALL Average is disabled.

[FranceBB]

MaxCLLFind_Results0_OnlyLast.txt
MaxCLLFind_Results1_Normal.txt