Noise Reduction:
DarkroomNoiseReduction reduces visible grain and unwanted color speckles in images while offering controls for retaining fine detail and tonal transitions. It treats brightness noise separately from color noise: brightness is smoothed with an edge-aware guided filter, while color is smoothed with either an edge-aware filter or a stronger Gaussian blur, depending on the detail setting. This separation helps you clean up an image without necessarily softening its colors and brightness in the same way. The filtering scale also adjusts with image dimensions, and the final result can be blended with the original for a subtler finish.
Noise Reduction Input Parameters:
image
The required IMAGE to process. Connect the image whose brightness grain, color speckles, or both you want to reduce. The node processes each image in an incoming batch and returns an image in the same output socket. There is no numeric range or default value for this input; you must provide an image.
preset
A required preset selection that supplies a ready-made combination of luminance and color noise-reduction settings. The default is Medium — general purpose. Selecting a recognized preset overrides the five manual luminance and color settings, so choose Custom when you want those settings to control the result. The source references a preset list but does not include its complete options or preset values, so additional preset names and their exact effects cannot be specified here. This selection does not override strength.
luminance_amount
Controls how much noise reduction is applied to brightness, or luminance, variations. Higher values increase the filtering radius and can add filtering passes, producing stronger smoothing; this may also remove fine texture. The allowed range is 0 to 100, with a default of 55. This setting takes effect only when preset is Custom; luminance filtering runs when the effective value is greater than 0.5.
luminance_detail
Adjusts how the brightness filter responds to image detail. The control is intended to help you balance noise removal against retaining fine features: increase it when important texture is being softened, or lower it when noise remains too prominent. The allowed range is 0 to 100, with a default of 45. The value changes the guided filter’s edge-sensitivity calculation rather than directly setting its radius. It affects the result when luminance filtering is active and preset is Custom.
luminance_contrast
Controls how much local brightness variation is added back after luminance filtering, helping retain tonal transitions that might otherwise look flat. Higher values add back more of this local contrast; lower values favor a smoother result. The allowed range is 0 to 100, with a default of 50. The contrast-preservation step runs only when the effective value is greater than 10, luminance filtering is active, and preset is Custom.
color_amount
Controls smoothing of color differences, which can reduce colored speckles without targeting brightness in the same way. Higher values increase the scale of color smoothing and can make subtle color variation look more uniform. The allowed range is 0 to 100, with a default of 55. This setting takes effect only when preset is Custom; color filtering runs when the effective value is greater than 0.5.
color_detail
Controls how color smoothing handles boundaries between differently colored areas. Values above 30 select edge-aware guided filtering of the color channels; values of 30 or below select Gaussian smoothing, which does not use that edge-aware guidance. Within the edge-aware mode, changing this value also changes the filter’s behavior. The allowed range is 0 to 100, with a default of 40. It affects the result when color filtering is active and preset is Custom.
strength
Blends the processed image with the original image. A value of 0 returns the original unchanged, a value of 1 uses the fully processed result, and values between them provide a partial effect. The allowed range is 0 to 1 in steps of 0.05, with a default of 1. Unlike the five luminance and color controls, strength remains active when a preset is selected.
Noise Reduction Output Parameters:
image
The resulting IMAGE after the enabled brightness and color noise-reduction steps and the final blend with the original. Use it as the cleaned image for later editing or comparison with the input. At strength 0, the output is the original image; it is also returned unchanged when both effective noise-reduction amounts are below 0.5. When processing runs, the node constrains the processed result to the standard 0-to-1 image-value range before blending. Incoming image batches are processed image by image.
Noise Reduction Usage Tips:
- Start with
Medium — general purposefor a quick result, then adjuststrengthif the effect looks too strong. Move it toward 0 to retain more of the original appearance. - Select
Custombefore adjusting the five luminance and color sliders; a recognized preset replaces their values during processing. - For visible brightness grain, raise
luminance_amountgradually. If texture or tonal separation suffers, adjustluminance_detailandluminance_contrastwhile comparing the result with the original. - For colored speckles, raise
color_amount. Trycolor_detailabove 30 when preserving boundaries between colors matters; values of 30 or below use non-edge-aware Gaussian smoothing. - If you only need one type of cleanup, set the other amount to 0 under
Custom. For example, setcolor_amountto 0 to work on brightness noise without running the color-noise step.
Noise Reduction Common Errors and Solutions:
Missing required input: image
- Explanation: The node needs an
IMAGEconnection before it can process anything. The exact validation message may vary by host application. - Solution: Connect a compatible image source to
imageand run the workflow again.
Invalid choice for preset
- Explanation:
presetmust be one of the choices supplied by the installed node. A saved workflow from another installation may contain a choice that is unavailable in yours; the exact validation message may vary. - Solution: Open the preset menu and select an available option. Choose
Customif you want to use the manual settings.
Image appears unchanged
- Explanation: This is not necessarily an error. The node returns the input unchanged when
strengthis 0 or when both effective noise-reduction amounts are below 0.5. A preset can also override manual amounts you expected to use. - Solution: Set
strengthabove 0, chooseCustomif you are adjusting manual amounts, and raise at least one amount above 0.5.
Manual sliders appear to have no effect
- Explanation: When a recognized preset is selected, its values replace
luminance_amount,luminance_detail,luminance_contrast,color_amount, andcolor_detailduring processing. - Solution: Select
Custombefore changing those sliders. You can continue usingstrengthwith any preset.
Out of memory or device allocation error
- Explanation: Large images or batches can require substantial memory because filtering creates intermediate image data. The exact error text depends on your device and runtime.
- Solution: Try a smaller image or batch, close other memory-intensive tasks, and rerun the node.
Shape or channel mismatch error
- Explanation: The processing code reads three color channels and expects images in a compatible image layout. An incompatible tensor supplied by another node may cause a runtime error; its exact wording depends on where processing fails.
- Solution: Supply a standard compatible
IMAGEthrough an image-loading or conversion node, and check that any upstream node has not changed its expected layout or channels.
