From Avisynth wiki
Jump to: navigation, search
Version 1.7.1
Download AddGrainC-
Category Effects
License GPLv2
Discussion Doom9 Thread



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.


* These additional planar colorspaces are not available in AviSynth 2.5.8.

Syntax and Parameters

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

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.

bool  sse2 = true
Enable SSE2 optimization if available. 1.5x faster than MMX.


AddGrainC with default values:

AddGrainC(var=1.0, uvar=0.0, hcorr=0.0, vcorr=0.0, seed=-1, constant=false, sse2=true)


Version      Date            Developer       Changes
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

Personal tools