Sharpen compositing node

Sharpens an image by enhancing the contrast of edges.

All Parameters Local variables Example files

See also: Blur, Edge Blur, Edge

This operation sharpens an image by enhancing the contrast of edges. Increasing the size of the sharpen kernel reduces the pixel noise that a sharpen operation enhances.

Parameters

Sharpen

Size

Increases the size of the areas over which it performs the sharpen (in pixels). Larger values will enhance larger features.

Units

The units that the Size parameter is expressed in, either pixels or UV coords.

Effect

Intensity of the sharpen effect.

Noise Suppress

If on, image noise is not sharpened. Noise is any edge that has a smaller magnitude than the Noise Suppress value. This produces clearer images.

Image variances less than the suppress value are not sharpened (as if the effect was zero). If a blend region is used, variances just above the suppress cutoff are sharpened somewhat, depending on their position within the blend region.

           |  No Sharpening |  Diminished Sharpening  |  Full Sharpening
effect:    |       0%       |    25%     50%     75%  |       100%  ---->
           |                |      suppress blend     |
variance:  0           (Suppress)             (Suppress + Blend)

Suppress Function

Determines how noise in the Suppress Blend range is sharpened:

Sharp Cutoff

No blend region is used.

Linear

Sharpening is uniformly reduced.

Ease In

Sharpening is gradually reduced.

Ease Out

Sharpening is quickly reduced.

Ease In Ease Out

Similar to linear but using a smoother function.

Gaussian

Similar to Ease In Ease Out, with a quicker dropoff.

Suppress Blend

The size of the blend region between full sharpening and no sharpening of the variances just above the noise threshold. This prevents “patches” of sharp areas in the image by blending the patches in.

Show Edges

Sharpens all the edges, while removing non-edge components.

Mask

A mask can be chosen to limit the effect of the operator to areas defined by the mask. The mask can be taken from the mask input (side input) or from the first input itself.

Effect Amount

If no mask is present, this blends the output with the input by a constant amount (0 = all input, 1 = all output).

If a mask is present, this amount multiplies the mask.

Operation Mask

Selects the mask plane to use as a mask from the mask input. The mask can be selected from:

A mask can be a component of a plane or an entire plane. If a vector plane is supplied as a mask, its components are multiplied by the images' components.

Scalar Mask ('A', 'C.r')

C.r = I.r * M
C.g = I.g * M
C.b = I.b * M

Vector Mask ('C')

C.r = I.r * M.r
C.g = I.g * M.g
C.b = I.b * M.b

First Input

Useful for masking the operation to the image’s own alpha plane.

Mask Input

Selects the mask from the side mask input.

Off

Turns off masking, without requiring disconnection of the mask input (useful for temporarily disabling the mask).

Resize Mask to Fit Image

If the mask image is a different resolution than the output image, turning on this parameter will scale the mask to the output image’s resolution.

If this node is changing constantly, and the mask is not, it is somewhat faster to put a Scale COP down to do the resize for the mask image. Otherwise, the scale will occur every time this node cooks.

Invert Mask

Inverts the mask so that all fully 'masked' portions become unmasked. This saves you from inserting an Invert COP after the node with the mask.

Scope

Plane Scope

Specifies the scope for both the RGB components of Color, Alpha, and other planes. The (C)RGBA mask only affects Color components and Alpha. 'C' will toggle all the RGB components.

For planes other than Color and Alpha, the plane name (plus component, if applicable) should be specified in the string field. The pulldown menu can be used to select planes or components present in this node.

A plane is specified by its name. A component is specified by both its plane and component name. The '*' wildcard may be used to scope all extra planes. Any number of planes or components can be specified, separated by spaces.

Examples:

P
N.x N.y
P N Pz

Frame Scope

Frame Scope

Allows scoping of specific frames in the frame range. This is in addition to the plane scope (so a plane at a certain frame must be both plane scoped and frame scoped to be modified).

All Frames

All frames are scoped.

Inside Range

All frames inside a subrange are scoped.

Outside Range

All frames outside a subrange are scoped.

Even Frames

Even numbered frames are scoped.

Odd Frames

Odd numbered frames are scoped.

Specific Frames

A user-defined list of frames are scoped.

Frame Range

For Inside/Outside range, this parameter specifies the subrange of the sequence to scope (or unscope). This can be edited in Timeline viewer mode ( Ctrl + 2 in viewer).

Frame Dropoff

For Inside/Outside Range, this parameter specifies certain number of frames before and after to slowly ramp up to scoped. The operation will be blended with its input to 'ease in' or 'ease out' the scoping effect over a number of frames. This can be edited in Timeline viewer mode ( Ctrl + 2 in viewer).

Non-scoped Effect

For unscoped frames, this sets the blend factor between the input and modified images. Normally this is zero (use the input image). By setting this to a non-zero value, you can make unscoped frames be 'slightly' unscoped. The value can vary between 0 (unscoped) and 1 (scoped).

Frame List

The frame list for 'Specific Frames'. Frame numbers should be separated by spaces.

Automatically Adjust for Length Changes

If the sequence range changes, enabling this parameter will adjust the subrange and frame dropoff lengths to fit the new range.

Local variables

L

Sequence length

S

Start of sequence

E

End of sequence

IL

Input sequence length

SR

Sequence frame rate

NP

Number of planes in sequence

W,H

Width and height of image

I

Image index (0 at start frame)

IT

Image time (0 at start frame)

AI

Current plane array index

PI

Current plane index

PC

Num of channels in current plane

CXRES

Composite Project X resolution

CYRES

Composite Project Y resolution

CPIXA

Composite Project pixel aspect ratio

CDEPTH

Composite Project raster depth

CBP

Composite Project black point

CWP

Composite Project white point

Example files

SharpeningFeatures

$HFS/houdini/help/examples/nodes/cop2/sharpen/SharpeningFeatures.cmd

Load | Launch

Using the Sharpen COP to reduce blurriness and enhance edges.

Usages in other examples

Example name Example for