ClipBlend - Revision history

Reel.Deal: add Deep_color_tools category

2020-06-25T17:44:35Z

add Deep_color_tools category

Reel.Deal at 04:06, 30 May 2020

2020-05-30T04:06:00Z

Reel.Deal: /* Changelog */

2020-05-26T17:27:20Z

‎Changelog

Reel.Deal: archived link

2020-05-23T16:49:04Z

archived link

Reel.Deal at 12:46, 23 April 2020

2020-04-23T12:46:55Z

Reel.Deal: ClipBlend: add documentation

2020-04-22T14:35:42Z

ClipBlend: add documentation

New page

{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Averaging}}
{{Filter3
| {{Author/StainlessS}}
| v1.01
| 3= [http://www.mediafire.com/file/y1iavve6lkesxhd/ClipBlend_25%252626_x86_x64_dll_v1-01_20181127.zip/file ClipBlend_25&26_x86_x64_dll_v1-01_20181127.zip]
| 4= Averaging
| 5= [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
| 6= [https://forum.doom9.org/showthread.php?t=168048 Doom9 Thread]}}

== Description ==
AviSynth filter to blend consecutive frames in a clip.
 
 
== Requirements ==
* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
 
* [https://www.microsoft.com/en-us/download/details.aspx?id=11895 Microsoft Visual C++ 2008 Redistributable Package (x86 / x64)]
:*** <tt>vcredist_x86.exe</tt> is required for <tt>ClipBlend-x86</tt>
:*** <tt>vcredist_x64.exe</tt> is required for <tt>ClipBlend-x64</tt>
 
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|ClipBlend (clip, int "delay")}}
:{{Template:FuncDef|ClipBlend16 (clip, int "delay")}}
 
::{{Par2| |clip| }}
:::Input clip.
 
::{{Par2|delay|int|0}}
:::Delay, default = 0, == ALL frames played so far blended.
:::*1 = blend with previous frame ie two frames blended.
:::*10 = blend with 10 previous frames, ie 11 frames blended, etc.
 
== Examples ==
#ClipBlend with default settings:
AviSource("blah.avi")
ClipBlend(delay=0)

#To get average of all frames 0 to frame 300:
AviSource("blah.avi")
ClipBlend() # Default delay=0 ie all previous frames
Trim(300,-1) # Get Required frame

#Or to get a single frame average of all frames in a clip:
AviSource("blah.avi")
ClipBlend()
Trim(FrameCount-1,-1)

#[[Stack16|Stacked 16-bit]] processing with AviSynth+:
AviSource("blah.avi")
[[ConvertStacked|ConvertToStacked()]]
ClipBlend16(delay=0)
[[ConvertStacked|ConvertFromStacked()]]
 
==How ClipBlend Works==

ClipBlend() uses a single 32 bit accumulator (unsigned int) for each channel of each pixel x,y position in the clip frame.
With a maximum possible value per pixel/channel being 255 ie 8 bits, this leaves 24 bits available for accumulating
the sum of values for that pixel/channel position, ie adding the values for that pixel/channel from every selected frame
in the blended range. The additional 24 bits would allow for up to ~16 Million (2^24) frames to be summed, however we also
need another bit to maintain maximum precision possible for 8 bit result, so reducing maximum possible frame range to
~8 million frames.

Code:

Return AviSource("test.avi").ClipBlend(delay=0).Trim(999,-1) # 1000 frames, 1000 values per accumulator, ie max 1000*255

Above would sum (each channel/pixel) with maximum possible sum for an accumulator being 1000*255 (about 18 bits, 2^10=1024,2^8=256)
As clipblend scans frames, it adds the channel/pixel values at each x,y position to the accumulators, for all of the
required frames. If delay = 0, it just adds next frame values to the accumulators. If eg delay=10, and current scanned range is already
10, it subtracts the channel/pixel values of the oldest frame (lowest number) and then adds the values for the next frame to the
accumulators. When delivering the result (delay=whatever), it just divides the accumulated sum by the number of sample frames to
get the average, and writes it to the relevant pixel/channel/x/y position, could not be simpler.

Implementation is equivalent to this:

int(accumulator / Float(FramesDone) + 0.5)

The actual implementation and reason for the extra needed bit that was mentioned (ie accumulator*2):

((accumulator*2) + FramesDone) / (FramesDone*2)

The *2 pair and addition of FramesDone is the integer equivalent of division, adding 0.5 and taking Int() whist maintaining max possible precision at 8 bits result.

 
== Changelog ==
Version Date(D/M/Y) Changes 
v1.01 2018/11/27 - Added Version resource. Moved to VS2008, with x64.
v1.00 2013/06/11 - Initial version.
 

== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.01
|[http://www.mediafire.com/file/y1iavve6lkesxhd/ClipBlend_25%252626_x86_x64_dll_v1-01_20181127.zip/file ClipBlend_25&26_x86_x64_dll_v1-01_20181127.zip]
|
|}
 
==External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Averaging.2FLayering.2FMasking|External Filters]] ←'''

@@ Line 17: / Line 17: @@
 * Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
 <br>
-* [https://www.microsoft.com/en-us/download/details.aspx?id=11895 Microsoft Visual C++ 2008 Redistributable Package (x86 / x64)]
+* [https://www.microsoft.com/en-us/download/details.aspx?id=26368 Microsoft Visual C++ 2008 Redistributable Package (x86 / x64)]
 :<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>ClipBlend-x86</tt>
 :<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>ClipBlend-x64</tt>

@@ Line 1: / Line 1: @@
-{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Averaging}}
+{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Averaging|Deep_color_tools}}
 {{Filter3
 | {{Author/StainlessS}}

@@ Line 27: / Line 27: @@
 ::{{Par2| |clip| }}
 :::Input clip.
 <br>
 ::{{Par2|delay|int|0}}

@@ Line 86: / Line 86: @@
 <br>
 == Changelog ==
-  Version      Date(D/M/Y)      Changes<br>
+  Version      Date(Y/M/D)      Changes<br>
   v1.01        2018/11/27       - Added Version resource. Moved to VS2008, with x64.
   v1.00        2013/06/11       - Initial version.

@@ Line 3: / Line 3: @@
 | {{Author/StainlessS}}
 | v1.01
-| 3= [http://www.mediafire.com/file/y1iavve6lkesxhd/ClipBlend_25%252626_x86_x64_dll_v1-01_20181127.zip/file ClipBlend_25&26_x86_x64_dll_v1-01_20181127.zip]
+| 3= [https://web.archive.org/web/20200523184634if_/https://files.videohelp.com/u/223002/ClipBlend_25_26_x86_x64_dll_v1-01_20181127.zip ClipBlend_25_26_x86_x64_dll_v1-01_20181127.zip]
 | 4= Averaging
 | 5= [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
@@ Line 13: / Line 13: @@
 <br>
 == Requirements ==
-* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
+* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
 * [x64]: [[AviSynth+]]
 * Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
@@ Line 99: / Line 99: @@
 |-
 !v1.01
-|[http://www.mediafire.com/file/y1iavve6lkesxhd/ClipBlend_25%252626_x86_x64_dll_v1-01_20181127.zip/file ClipBlend_25&26_x86_x64_dll_v1-01_20181127.zip]
+|[https://www.mediafire.com/file/y1iavve6lkesxhd/ClipBlend_25%252626_x86_x64_dll_v1-01_20181127.zip/file ClipBlend_25&26_x86_x64_dll_v1-01_20181127.zip]
+|[https://web.archive.org/web/20200523184634if_/https://files.videohelp.com/u/223002/ClipBlend_25_26_x86_x64_dll_v1-01_20181127.zip ClipBlend_25_26_x86_x64_dll_v1-01_20181127.zip]
 |}
 <br>