<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en">
	<id>https://wiki.selur.net/index.php?action=history&amp;feed=atom&amp;title=Vapoursynth_AddGrain</id>
	<title>Vapoursynth AddGrain - Revision history</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.selur.net/index.php?action=history&amp;feed=atom&amp;title=Vapoursynth_AddGrain"/>
	<link rel="alternate" type="text/html" href="https://wiki.selur.net/index.php?title=Vapoursynth_AddGrain&amp;action=history"/>
	<updated>2026-11-19T07:24:37Z</updated>
	<subtitle>Revision history for this page on the wiki</subtitle>
	<generator>MediaWiki 1.46.2</generator>
	<entry>
		<id>https://wiki.selur.net/index.php?title=Vapoursynth_AddGrain&amp;diff=450&amp;oldid=prev</id>
		<title>Selur: New filter page (via create-page on MediaWiki MCP Server)</title>
		<link rel="alternate" type="text/html" href="https://wiki.selur.net/index.php?title=Vapoursynth_AddGrain&amp;diff=450&amp;oldid=prev"/>
		<updated>2026-11-16T08:47:24Z</updated>

		<summary type="html">&lt;p&gt;New filter page (via create-page on MediaWiki MCP Server)&lt;/p&gt;
&lt;p&gt;&lt;b&gt;New page&lt;/b&gt;&lt;/p&gt;&lt;div&gt;&amp;lt;div style=&amp;quot;float:right; margin:0 0 1em 1em;&amp;quot;&amp;gt;__TOC__&amp;lt;/div&amp;gt;&lt;br /&gt;
&amp;#039;&amp;#039;&amp;#039;AddGrain&amp;#039;&amp;#039;&amp;#039; adds random noise to luma and optionally chroma, to mask banding, keep some texture after strong denoising or give a film look. An optional adaptive mode puts the grain mainly into dark areas.&lt;br /&gt;
&lt;br /&gt;
&amp;#039;&amp;#039;Filtering → Vapoursynth → Add Grain&amp;#039;&amp;#039;&lt;br /&gt;
&lt;br /&gt;
[[File:Vapoursynth_AddGrain.png|none|AddGrain controls in Hybrid]]&lt;br /&gt;
&lt;br /&gt;
== What it does ==&lt;br /&gt;
A new noise pattern is added to every frame (unless &amp;#039;&amp;#039;Constant&amp;#039;&amp;#039; is set). Correlation makes neighbor noise values similar, which gives coarser, streaky grain but also lowers its visible strength. With the vs-noise implementation other noise types than Gaussian are available.&lt;br /&gt;
&lt;br /&gt;
== Requirements ==&lt;br /&gt;
* vs-noise (all platforms) or the AddGrain plugin (Linux/macOS); adaptivegrain for &amp;#039;&amp;#039;Adaptive&amp;#039;&amp;#039;.&lt;br /&gt;
&lt;br /&gt;
== Settings ==&lt;br /&gt;
{| class=&amp;quot;wikitable&amp;quot;&lt;br /&gt;
! Control !! Parameter !! Range / values !! Hybrid default !! Meaning&lt;br /&gt;
|-&lt;br /&gt;
| Strength (V/U) || var / uvar || 0 – 1000 || 1.0 / 0 || Luma / chroma noise strength as a variance on the 8-bit scale; 0 = off. Chroma strength has no effect on gray and RGB clips.&lt;br /&gt;
|-&lt;br /&gt;
| Correlation (H/V) || hcorr / vcorr || 0 – 1 || 0 / 0 || Horizontal / vertical similarity of neighbor noise values.&lt;br /&gt;
|-&lt;br /&gt;
| Seed || seed || −1 – 1000 || −1 || 0 or higher selects a repeatable grain sequence.&lt;br /&gt;
|-&lt;br /&gt;
| Constant || constant || on/off || off || Same grain pattern on every frame.&lt;br /&gt;
|-&lt;br /&gt;
| Type || type || Gaussian, Perlin, Simplex, fBm, Poisson || Gaussian || vs-noise only: noise type (fBm = fractal Brownian motion).&lt;br /&gt;
|-&lt;br /&gt;
| Size (x/y) || xsize / ysize || 1 – 100 || 2.0 / 2.0 || vs-noise with Perlin, Simplex or fBm only: size of the noise pattern in pixels. Whole numbers sample Perlin noise on its grid points, where it is zero.&lt;br /&gt;
|-&lt;br /&gt;
| Adaptive || – || on/off || off || Weights the grain by brightness: more in dark areas, where banding shows, less in bright ones.&lt;br /&gt;
|-&lt;br /&gt;
| Luma scaling || luma_scaling || 0 – 100 || 12 || With Adaptive: higher values restrict the grain more to the shadows.&lt;br /&gt;
|-&lt;br /&gt;
| Tools: grain || – || noise, grain (Linux/macOS) || noise || Implementation; grain only makes Gaussian noise, so Type and Size are disabled with it.&lt;br /&gt;
|}&lt;br /&gt;
&lt;br /&gt;
== Example ==&lt;br /&gt;
Default settings on a 10-bit YUV 4:2:0 source (640x356):&lt;br /&gt;
&amp;lt;pre&amp;gt;&lt;br /&gt;
# adding Grain using noise&lt;br /&gt;
clip = core.noise.Add(clip)&lt;br /&gt;
&amp;lt;/pre&amp;gt;&lt;br /&gt;
&lt;br /&gt;
== How Hybrid calls it ==&lt;br /&gt;
* Works on integer and 32-bit float YUV, RGB and gray clips; with Adaptive only on integer YUV.&lt;br /&gt;
* The strength is given on the 8-bit scale; the plugin scales it to the bit depth itself.&lt;br /&gt;
* All options are only written when they differ from the defaults; Luma scaling is always written with Adaptive.&lt;br /&gt;
* With Adaptive, the grained clip is merged into the original through the adaptivegrain mask.&lt;br /&gt;
* In the default filter order AddGrain comes after the anti-aliasing and GLSL filters and before GrainFactory3 and FilmGrain (GLSL).&lt;br /&gt;
* AddGrain also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).&lt;br /&gt;
&lt;br /&gt;
== Background ==&lt;br /&gt;
=== vs-noise and AddGrain ===&lt;br /&gt;
vs-noise is the successor of the archived VapourSynth AddGrain plugin and adds Perlin, Simplex, fBm and Poisson noise. Its README notes that the correlation is implemented as exponential smoothing, so a higher correlation needs a higher strength for the same visible amount of grain; strong vertical correlation can look like rain.&lt;br /&gt;
&lt;br /&gt;
=== adaptivegrain ===&lt;br /&gt;
adaptivegrain builds a gray mask from the luma of each frame (it needs the frame&amp;#039;s average brightness, which Hybrid measures first). The mask is bright in dark areas, so grain goes there; &amp;#039;&amp;#039;Luma scaling&amp;#039;&amp;#039; shapes the curve.&lt;br /&gt;
&lt;br /&gt;
== Sources ==&lt;br /&gt;
* [https://github.com/wwww-wwww/vs-noise vs-noise]&lt;br /&gt;
* [https://github.com/HomeOfVapourSynthEvolution/VapourSynth-AddGrain VapourSynth-AddGrain]&lt;br /&gt;
* [https://github.com/Irrational-Encoding-Wizardry/adaptivegrain adaptivegrain]&lt;br /&gt;
* Hybrid&amp;#039;s tooltips&lt;br /&gt;
&lt;br /&gt;
[[Category:Vapoursynth Filters]]&lt;/div&gt;</summary>
		<author><name>Selur</name></author>
	</entry>
</feed>