Vapoursynth DustDenoise: Difference between revisions
New filter page (via create-page on MediaWiki MCP Server) |
Update to current Hybrid behaviour; code as <pre> (via update-page on MediaWiki MCP Server) |
||
| Line 15: | Line 15: | ||
| Mode || mode || faery, pixie, gold, space || pixie || faery = temporal only, pixie = temporal and spatial (weighted to temporal), gold = temporal and spatial (weighted to spatial), space = spatial only. | | Mode || mode || faery, pixie, gold, space || pixie || faery = temporal only, pixie = temporal and spatial (weighted to temporal), gold = temporal and spatial (weighted to spatial), space = spatial only. | ||
|- | |- | ||
| Limit || limit || 1 – 64 || 5 || Largest change per sample, on the 8-bit scale. | | Limit || limit || 1 – 64 || 5 || Largest change per sample, on the 8-bit scale. Changing the mode sets Limit to that mode's plugin default (faery 2, pixie 5, gold 8, space 6); the value stays editable. | ||
|- | |- | ||
| Edge limit / Edge threshold || limit_edge, edge_thresh || -1 – 64 / 1 – 255 || -1 (off) / 32 || A separate limit on strong edges; the threshold sets the edge strength that counts as a full edge. Limit is raised to match when Edge limit is set higher. | | Edge limit / Edge threshold || limit_edge, edge_thresh || -1 – 64 / 1 – 255 || -1 (off) / 32 || A separate limit on strong edges; the threshold sets the edge strength that counts as a full edge. Limit is raised to match when Edge limit is set higher. | ||
| Line 41: | Line 41: | ||
== Example == | == Example == | ||
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU): | Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU): | ||
< | <pre> | ||
# denoising using DustDenoise | # denoising using DustDenoise | ||
clip = DustDenoise.DustDenoise(clip, tools={'mv': 'mvgpu'}) | clip = DustDenoise.DustDenoise(clip, limit=5, tools={'mv': 'mvgpu'}) | ||
</ | </pre> | ||
== How Hybrid calls it == | == How Hybrid calls it == | ||
* DustDenoise works on 8–16-bit integer YUV and gray clips; other formats are converted first. Interlaced material is handled by Hybrid's general field handling. | * DustDenoise works on 8–16-bit integer YUV and gray clips; other formats are converted first. Interlaced material is handled by Hybrid's general field handling. | ||
* | * Limit is always written; the other values only when they differ from the defaults. All levels stay on the 8-bit scale, the plugin scales them. | ||
* DustDenoise also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | * DustDenoise also offers the [[Vapoursynth common filter options|common options]] (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick). | ||
Latest revision as of 09:49, 16 November 2026
DustDenoise is a port of Steady's AviSynth Dust filters (FaeryDust, PixieDust, GoldDust, SpaceDust). It denoises spatially and/or temporally, but no sample may move more than Limit away from the source, so detail cannot be smeared beyond that amount.
Filtering → Vapoursynth → DeNoise

What it does
The filter averages (or takes the median of) the pixel's neighbors in space and/or in the neighbor frames, and then clips the result to Limit around the source value. Optionally the neighbor frames are motion-compensated, edges get a lower limit, and frames from another scene are kept out of the temporal window.
Settings
| Control | Parameter | Range / values | Hybrid default | Meaning |
|---|---|---|---|---|
| Mode | mode | faery, pixie, gold, space | pixie | faery = temporal only, pixie = temporal and spatial (weighted to temporal), gold = temporal and spatial (weighted to spatial), space = spatial only. |
| Limit | limit | 1 – 64 | 5 | Largest change per sample, on the 8-bit scale. Changing the mode sets Limit to that mode's plugin default (faery 2, pixie 5, gold 8, space 6); the value stays editable. |
| Edge limit / Edge threshold | limit_edge, edge_thresh | -1 – 64 / 1 – 255 | -1 (off) / 32 | A separate limit on strong edges; the threshold sets the edge strength that counts as a full edge. Limit is raised to match when Edge limit is set higher. |
| Planes | planes | all, chroma only, luma only | all | Planes that are processed; the others are copied. |
| Scene change | scthresh | -1 – 255 | 20 | Mean luma difference that counts as a cut; 0 = use the scene change frame properties only, -1 = no scene change handling. |
| Radius | tr | 1 – 5 | 1 | Frames on each side; not for space. |
| Temporal | temporal | mean, median | mean | How the frames are combined; median rejects specks and dead pixels. |
| Motion compensation | mc | on/off | on | Compensates the motion of the neighbor frames. |
| thSAD | thsad | 0 – 10000 | 300 | Blocks that match worse keep the source. |
| Block size / Overlap | blksize, overlap | 4 – 64 / 0 – 32 | 8 / 4 | Motion search blocks; the overlap is at most half the block size. |
| Search / Pel / True motion | search, pel, truemotion | 8 algorithms / 1, 2, 4 / on/off | hexagon / 2 / on | Motion search settings; Search is ignored with mvgpu. |
| Tools: MV | – | mvgpu, mvutensils, mv | mvgpu with a discrete GPU, otherwise mvutensils | Motion vector implementation; mvgpu needs Vulkan and VapourSynth R82 (not on macOS). |
The motion settings are only enabled with motion compensation and a mode other than space.
Example
Default settings on a 10-bit YUV 4:2:0 source (machine with a discrete GPU):
# denoising using DustDenoise
clip = DustDenoise.DustDenoise(clip, limit=5, tools={'mv': 'mvgpu'})
How Hybrid calls it
- DustDenoise works on 8–16-bit integer YUV and gray clips; other formats are converted first. Interlaced material is handled by Hybrid's general field handling.
- Limit is always written; the other values only when they differ from the defaults. All levels stay on the 8-bit scale, the plugin scales them.
- DustDenoise also offers the common options (Masked, ApplyOnlyTo, Merge, OnRegion, Gimmick).
Background
Dust
Dust 1.0.0 is a single engine with four presets; SpaceDust is the fastest and reads no other frames. Window positions behind a cut or past the clip end are replaced by the nearest frame of the same scene, and borders are mirrored. The SIMD versions give the same output as the C code. The project is a fork of Yuri Pronkin's DustPort and deliberately differs from its output; it runs on Windows, Linux and macOS, for VapourSynth and AviSynth+.
Sources
- Dust README
- VapoursynthScriptsInHybrid (the script collection Hybrid uses)
- Hybrid's tooltips