AddGrainC

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(→‎Changelog: add newer versions)
(Update docs to version 1.8)
Line 6: Line 6:
 
*{{Author/LaTo}}
 
*{{Author/LaTo}}
 
*{{Author/cretindesalpes}}
 
*{{Author/cretindesalpes}}
−
|1.7.1
+
*[https://github.com/HolyWu/ HolyWu]
−
|[http://ldesoras.free.fr/src/avs/AddGrainC-1.7.1.7z AddGrainC-1.7.1.7z] [http://web-beta.archive.org/web/20160315211447/http://ldesoras.free.fr/src/avs/AddGrainC-1.7.1.7z Archived]
+
*StvG
 +
*{{Author/pinterf}}
 +
|1.8
 +
|[https://github.com/pinterf/AddGrainC/releases AddGrainC_v1.8.7z]
 
|Effects
 
|Effects
 
|[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 
|[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
Line 17: Line 20:
 
<br>
 
<br>
 
== Requirements ==
 
== Requirements ==
−
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ 2.6.0 or greater]
+
* [x86]: [[AviSynth+]] or [http://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
 +
* [x64]: [[AviSynth+]]
 
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only  
 
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only  
−
* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]], <span style="color:red">*</span>[[YV16]], <span style="color:red">*</span>[[YV24]], <span style="color:red">*</span>[[YV411]], <span style="color:red">*</span>[[Y8]]
+
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
−
: <span style="color:red">*</span> These additional [[planar]] colorspaces are not available in AviSynth 2.5.8.
+
**AviSynth+: all planar formats (8/10/12/14/16bit and float, YUV/RGB with or without alpha) are supported.
−
 
+
−
* [[MMX]] or [[SSE2]] capable CPU
+
−
* [http://www.microsoft.com/en-us/download/details.aspx?id=30679 Microsoft Visual C++ 2012 Redistributable Package (x86 / x64)]
+
 
<br>
 
<br>
  
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
−
:{{Template:FuncDef|AddGrain (''clip'', ''float'' "var", ''float'' "hcorr", ''float'' "vcorr", ''float'' "uvar", ''int'' "seed", ''bool'' "constant", ''bool'' "sse2")}}
+
:{{Template:FuncDef|AddGrain (''clip'', ''float'' "var", ''float'' "uvar", ''float'' "hcorr", ''float'' "vcorr", ''int'' "seed", ''bool'' "constant")}}
−
:{{Template:FuncDef|AddGrainC (''clip'', ''float'' "var", ''float'' "uvar", ''float'' "hcorr", ''float'' "vcorr", ''int'' "seed", ''bool'' "constant", ''bool'' "sse2")}}
+
:{{Template:FuncDef|AddGrainC (''clip'', ''float'' "var", ''float'' "uvar", ''float'' "hcorr", ''float'' "vcorr", ''int'' "seed", ''bool'' "constant")}}
 
<br>
 
<br>
 
::{{Par2| |clip| }}
 
::{{Par2| |clip| }}
Line 50: Line 51:
 
::{{Par2|constant|bool|false}}
 
::{{Par2|constant|bool|false}}
 
:::Specifies a constant grain pattern on every frame.
 
:::Specifies a constant grain pattern on every frame.
−
<br>
 
−
::{{Par2|sse2|bool|true}}
 
−
:::Enable [[SSE2]] optimization if available. 1.5x faster than [[MMX]].
 
 
<br>
 
<br>
  
Line 96: Line 94:
 
==External Links ==
 
==External Links ==
 
*[http://forum.doom9.org/showthread.php?t=111849 Doom9 Forum] - AddGrainC discussion.
 
*[http://forum.doom9.org/showthread.php?t=111849 Doom9 Forum] - AddGrainC discussion.
 +
*[https://github.com/pinterf/AddGrainC GitHub] - Source code repository.
 
<br>
 
<br>
 
<br>
 
<br>
 
-----------------------------------------------
 
-----------------------------------------------
 
'''Back to [[External_filters#Effects|External Filters]] &larr;'''
 
'''Back to [[External_filters#Effects|External Filters]] &larr;'''

Revision as of 15:38, 9 April 2020

Abstract
Author
Version 1.8
Download AddGrainC_v1.8.7z
Category Effects
License GPLv2
Discussion Doom9 Thread

Contents

Description

Generate film-like grain or other effects (like rain) by adding random noise to a video clip. This noise may optionally be horizontally or vertically correlated to cause streaking.

AddGrain and AddGrainC are aliases for one another; there is no difference in functionality, only in syntax.

Requirements


Syntax and Parameters

AddGrain (clip, float "var", float "uvar", float "hcorr", float "vcorr", int "seed", bool "constant")
AddGrainC (clip, float "var", float "uvar", float "hcorr", float "vcorr", int "seed", bool "constant")


clip   =
Input clip.


float  var = 1.0
The standard deviation (strength) of the luma noise, 0.0 is disabled.


float  uvar = 0.0
The standard deviation (strength) of the chroma noise, 0.0 is disabled.
uvar does nothing in RGB mode.


float  hcorr = 0.0
float  vcorr = 0.0
Horizontal and vertical correlation, which causes a nifty streaking effect.
Range: 0.0 - 1.0


int  seed = -1
Specifies a repeatable grain sequence. Set to at least 0 to use.


bool  constant = false
Specifies a constant grain pattern on every frame.


Examples

AddGrainC with default values: 

AviSource("Blah.avi")
AddGrainC(var=1.0, uvar=0.0, hcorr=0.0, vcorr=0.0, seed=-1, constant=false, sse2=true)


Changelog 

Version      Date            Developer       Changes

v1.8         2020/04/09      pinterf         - Plugin name changed back to AddGrainC
                                             - Fix output darkening (regression in VS port)
                                             - Add back documentation, credits
                                             - Add back SIMD optimization (SSE2, SSE4)
                                             - Add back version resource

             2020/03/30      StvG            - Backport to AviSynth+
                                             - Changes to 1.7.1:
                                               * Support AviSynth+ high bit depth
                                               * Register Avisynth+ MT mode as MT_MULTI_INSTANCE
                                               * AddGrain parameter order made similar to AddGrainC:
                                                 var, uvar, hcorr, vcorr, seed, constant (was: var, hcorr, vcorr, uvar, seed, constant)
                                               * Removed bool "sse2" parameter
                                               * Name is AddGrain
                                               * Removed SIMD optimization

             2014-2018       HolyWu          - VapourSynth port

1.7.1      2013/11/25      Firesledge       - Added a 64-bit version. Compiled with MSVC 2012 (requires the 2012 runtime libraries) 
1.7.0      2012/08/16      Firesledge       - Supports Y8, YV16, YV24 and YV411 colorspaces.
1.6.1      2011/10/29      LaTo INV.        - Automatic switch to MMX if SSE2 is not supported by the CPU.
1.6.0      2011/10/28      LaTo INV.        - Added SSE2 code (50% faster than MMX)
1.5.4      2011/10/27      Firesledge       - Fixed bad pixels on the last line in YV12 mode when constant=true,
                                                fixed potential problems with frame width > 4096 pixels
                                                and fixed several other minor things.
1.5.3      2011/10/26      Firesledge       - Fixed coloring and bluring in RGB24 mode.
1.5.2      2011/10/26      Firesledge       - Removed the SSE2 requirement.
1.5.1      2010/05/13      Firesledge       - The source code compiles on Visual C++ versions older than 2008.
1.5        2010/05/07      Foxyshadis       - Limit the initial seed generation to fix memory issues.
1.4          2006/08/11      Foxyshadis       - Constant replaces seed, seed repeatable.
1.3        2006/06/10      Foxyshadis       - Crashfix, noisegen optimization.
1.2        2006/06/06      Foxyshadis       - Supports YUY2, RGB. Fix cache mess.
1.1        2006/06/01      Foxyshadis       - Chroma grain + constant seed.
1.0        2003/06/18      Tom Barry        - Initial Release

External Links



Back to External Filters ←

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