RgbAmplifier

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(redirect for convenient searching)
 
(RgbAmplifier: add documentation)
Line 1: Line 1:
−
#REDIRECT [[External_filters#Levels_and_Chroma]]
+
{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters}}
−
{{FilterCat|External_filters|Adjustment_filters|Levels_and_Chroma_filters}}
+
{{Filter3
 +
|{{Author/StainlessS}}
 +
|v1.04
 +
|3=[http://www.mediafire.com/file/x19cs7ydw97xx6g/RgbAmplifier_25%252626_x86_x64_dll_v1-04_20181128.zip/file RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip]
 +
|4=Adjustment Filters
 +
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 +
|6=[http://forum.doom9.org/showthread.php?t=168293 Doom9 Thread]
 +
}}
 +
== Description ==
 +
An AviSynth plugin to amplify color shifts
 +
 
 +
Given a clip, this filter examines every pixel of every frame and independently multiplies the difference of its specific R, G and B values from the average R, G and B values of that same pixel location spanning a defined radius of adjacent frames. If the new values are above or below the allowed RGB values, they are capped at those limits. The revised RGB values replace the original values, and the amplified clip is returned. If the Multiplier is set to a value of zero, the plugin acts as a temporal frame averager.
 +
 
 +
This plugin will:
 +
*Convert seemingly imperceptible color changes into obvious color changes
 +
*Highlight seemingly imperceptible movements of high contrast pixels
 +
*Sharpen the details of moving objects
 +
*Cause distortion or ghosting/transparency effect to moving objects (an unavoidable side effect)
 +
 
 +
This plugin requires RGB24 or RGB32 color space, and is intended for forensic analysis of videos created from fixed position cameras. Usage on non-stationary cameras may produce unpredictable or content destructive results. The faster the object and/or the greater the radius, the greater the risk of negatively impacting the visual accuracy of the moving object.
 +
 
 +
<br>
 +
== Requirements ==
 +
* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
 +
* [x64]: [[AviSynth+]]
 +
* Supported color formats: [[RGB24]], [[RGB32]]
 +
<br>
 +
* [https://www.microsoft.com/en-us/download/details.aspx?id=11895 Microsoft Visual C++ 2008 Redistributable Package (x86 / x64)]
 +
:<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>RgbAmplifier-x86</tt>
 +
:<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>RgbAmplifier-x64</tt>
 +
<br>
 +
 
 +
== [[Script variables|Syntax and Parameters]] ==
 +
<pre>
 +
=====
 +
Usage
 +
 
 +
RgbAmplifier(clip clip,int "Radius"=2,float "Multiplier"=2.0,int "Rmin"=0,int "GMin"=0,int "Bmin"=0, \
 +
    int "RMax"=255,int "GMax"=255,int "BMax"=255,bool "Precise"=false)
 +
 
 +
 
 +
=====
 +
Parameters:
 +
 
 +
Radius: integer from 1 to 99 (default 2). Defines the radius of how many frames are to be averaged (2 * radius -1).
 +
For example, a radius of 7 will instruct the filter to average 13 frames (2 * 7 -1).
 +
A value of 1 effectively disables the function (useful if adjusting the values within AVSpmod).
 +
 
 +
Multiplier: float from >=0.0 to <=20.0 (default 2.0). Defines the multiplier for the difference between a pixel’s color value
 +
(for each of R, G and B values) and its average value (as defined by the Radius).
 +
For example, the default value of 2.0 will replace every R, G and B value of every pixel with a value twice as far from the
 +
average R, G or B value of that pixel.
 +
 
 +
Rmin: integer from 0 to 255 (default 0). Cannot be greater than Rmax.
 +
The filter will not alter any pixel whose Red color value is below this threshold value.
 +
 
 +
Gmin: integer from 0 to 255 (default 0). Cannot be greater than Gmax.
 +
The filter will not alter any pixel whose Green color value is below this threshold value.
 +
 
 +
Bmin: integer from 0 to 255 (default 0). Cannot be greater than Bmax.
 +
The filter will not alter any pixel whose Blue color value is below this threshold value.
 +
 
 +
Rmax: integer from 0 to 255 (default 255). Cannot be less than Rmin.
 +
The filter will not alter any pixel whose Red color value is above this threshold value.
 +
 
 +
Gmax: integer from 0 to 255 (default 255). Cannot be less than Gmin.
 +
The filter will not alter any pixel whose Ged color value is above this threshold value.
 +
 
 +
Bmax: integer from 0 to 255 (default 255). Cannot be less than Bmin.
 +
The filter will not alter any pixel whose Blue color value is above this threshold value.
 +
 
 +
Precise: bool default false. Default uses integer math and is faster than Precise=true which uses double precision Floating point.
 +
</pre>
 +
<br>
 +
== Examples ==
 +
<pre>
 +
Double pixel color deviations from the average of the current, preceding and postceding frame’s pixel value
 +
RgbAmplifier ()
 +
 
 +
 
 +
Temporal averaging using the current frame and the first four (Radius - 1) preceding and postceding frame’s pixel values
 +
RgbAmplifier (Radius=5, Multiplier=0.0)
 +
 
 +
 
 +
Triple pixel color deviations from the average of the current frame and the first two preceding and postceding frame’s
 +
pixel values, but only for pixels with a color within 2% of pure Cyan (“00AEEF”)
 +
</pre>
 +
<br>
 +
== Changelog ==
 +
<pre>
 +
v1.02, Sped up a bit. Extended max multiplier to 20.0.
 +
v1.03, Dont reset if n==last (should not happen if cache works correctly).
 +
v1.04,  VS2008, Added version resource, and x64.
 +
</pre>
 +
<br>
 +
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
|-
 +
!v1.04
 +
|[http://www.mediafire.com/file/x19cs7ydw97xx6g/RgbAmplifier_25%252626_x86_x64_dll_v1-04_20181128.zip/file RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip]
 +
|[https://web.archive.org/web/20200421172233if_/http://s000.tinyupload.com/download.php?file_id=91423714464635350800&t=9142371446463535080088928 RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip]
 +
|}
 +
<br>
 +
 
 +
==External Links ==
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] &larr;'''

Revision as of 16:28, 21 April 2020

Abstract
Author StainlessS
Version v1.04
Download RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip
Category Adjustment Filters
License GPLv2
Discussion Doom9 Thread

Contents

Description

An AviSynth plugin to amplify color shifts

Given a clip, this filter examines every pixel of every frame and independently multiplies the difference of its specific R, G and B values from the average R, G and B values of that same pixel location spanning a defined radius of adjacent frames. If the new values are above or below the allowed RGB values, they are capped at those limits. The revised RGB values replace the original values, and the amplified clip is returned. If the Multiplier is set to a value of zero, the plugin acts as a temporal frame averager.

This plugin will:

  • Convert seemingly imperceptible color changes into obvious color changes
  • Highlight seemingly imperceptible movements of high contrast pixels
  • Sharpen the details of moving objects
  • Cause distortion or ghosting/transparency effect to moving objects (an unavoidable side effect)

This plugin requires RGB24 or RGB32 color space, and is intended for forensic analysis of videos created from fixed position cameras. Usage on non-stationary cameras may produce unpredictable or content destructive results. The faster the object and/or the greater the radius, the greater the risk of negatively impacting the visual accuracy of the moving object.


Requirements


*** vcredist_x86.exe is required for RgbAmplifier-x86
*** vcredist_x64.exe is required for RgbAmplifier-x64


Syntax and Parameters 

=====
Usage

RgbAmplifier(clip clip,int "Radius"=2,float "Multiplier"=2.0,int "Rmin"=0,int "GMin"=0,int "Bmin"=0, \
    int "RMax"=255,int "GMax"=255,int "BMax"=255,bool "Precise"=false)


=====
Parameters:

Radius: integer from 1 to 99 (default 2). Defines the radius of how many frames are to be averaged (2 * radius -1).
 For example, a radius of 7 will instruct the filter to average 13 frames (2 * 7 -1).
 A value of 1 effectively disables the function (useful if adjusting the values within AVSpmod).

Multiplier: float from >=0.0 to <=20.0 (default 2.0). Defines the multiplier for the difference between a pixel’s color value
 (for each of R, G and B values) and its average value (as defined by the Radius).
 For example, the default value of 2.0 will replace every R, G and B value of every pixel with a value twice as far from the
 average R, G or B value of that pixel.

Rmin: integer from 0 to 255 (default 0). Cannot be greater than Rmax.
 The filter will not alter any pixel whose Red color value is below this threshold value.

Gmin: integer from 0 to 255 (default 0). Cannot be greater than Gmax.
 The filter will not alter any pixel whose Green color value is below this threshold value.

Bmin: integer from 0 to 255 (default 0). Cannot be greater than Bmax.
 The filter will not alter any pixel whose Blue color value is below this threshold value.

Rmax: integer from 0 to 255 (default 255). Cannot be less than Rmin.
 The filter will not alter any pixel whose Red color value is above this threshold value.

Gmax: integer from 0 to 255 (default 255). Cannot be less than Gmin.
 The filter will not alter any pixel whose Ged color value is above this threshold value.

Bmax: integer from 0 to 255 (default 255). Cannot be less than Bmin.
 The filter will not alter any pixel whose Blue color value is above this threshold value.

Precise: bool default false. Default uses integer math and is faster than Precise=true which uses double precision Floating point.


Examples 

Double pixel color deviations from the average of the current, preceding and postceding frame’s pixel value
RgbAmplifier ()


Temporal averaging using the current frame and the first four (Radius - 1) preceding and postceding frame’s pixel values
RgbAmplifier (Radius=5, Multiplier=0.0)


Triple pixel color deviations from the average of the current frame and the first two preceding and postceding frame’s
 pixel values, but only for pixels with a color within 2% of pure Cyan (“00AEEF”)


Changelog 

	v1.02,	Sped up a bit. Extended max multiplier to 20.0.
	v1.03,	Dont reset if n==last (should not happen if cache works correctly).
	v1.04,  VS2008, Added version resource, and x64.



Archived Downloads

Version Download Mirror
v1.04 RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip RgbAmplifier_25&26_x86_x64_dll_v1-04_20181128.zip


External Links



Back to External Filters ←

Retrieved from "http://avisynth.nl/index.php?title=RgbAmplifier&oldid=11176"
Personal tools