Houdini 20.5 Nodes Copernicus nodes

Illegal Pixel Copernicus node

Detects and then fixes or highlights illegal pixels in images.

On this page

Shaders and renderers can occasionally generate illegal floating point values. This node detects these bad pixels, specifically Not a Number (NAN) and infinite (Inf) values, and either fixes or highlights those pixels. You can fix a pixel that’s missing data by zeroing out the pixel or replacing it by blending surrounding pixels together (see the Illegal Pixels parameter).

Note

The node detects only bad pixels in floating point formats (16- and 32-bit floating point). Integer formats are already quantized to a valid (and possibly random) color in the renderer, which makes them undetectable.

When zeroing pixels, this node zeroes the entire pixel even if only one component is bad to avoid color shifting.

When replacing pixels and only part of a pixel’s components are bad, this node replaces only those components. For a large block of bad pixels, the node attempts to iterate up to 16 times to break down the block. Large blocks appear as blurry spots in the image, so you may want to limit the number of bad pixels to replace.

Parameters

Illegal Pixels

The method used to fix or flag illegal pixels. Often, fixing is used when you want to continue with the image as-is and flagging is used to debug the shader.

Fix by Blending Surrounding Pixels

Replace a bad pixel by blending the surrounding pixels together. This method is best for small numbers or isolated pixels.

Fix by Zeroing

Clear the NANs so that downstream operations behave. This method doesn’t visually correct the image.

Show with Highlight

Show bad pixels by highlighting them based on the Highlight Color value.

Show by Isolating

Show bad pixels by highlighting them and clearing all correct pixels.

Highlight Color

When Illegal Pixels is Show with Highlight, this is the color in which to highlight the bad pixels.

Detect

The type of illegal pixels to find.

NaN Values

Find only NaN values.

Infinite Values

Find only infinite values.

NaN and Infinite Values

Find both NaN and infinite values.

Custom

Find values according to a custom Rule.

Rule

The custom rule to use.

Less Than

Flag pixels less than the comparison value.

Less Than or Equal

Flag pixels less than or equal to the comparison value.

Greater Than

Flag pixels greater than the comparison value.

Greater Than or Equal

Flag pixels greater than or equal to the comparison value.

Equal

Flag pixels equal to the comparison value.

Inputs

source

The original layer with illegal floating point values you want to detect.

Outputs

clean

The layer with fixed or highlighted illegal floating point values.

Copernicus nodes