Houdini 20.5 Nodes Copernicus nodes

Resample Copernicus node

Performs image scaling by changing the width, height and pixel sizes.

On this page

This node performs image scaling by changing the width, height and pixel sizes of an image. This node is used for resizing images into new output canvases that can be of different aspect ratios or resolutions. This node allows for different sampling algorithms such as point sampling, bilinear sampling and box sampling.

Parameters

Signature

The layer type that the source accepts.

See Signatures for more information.

Canvas

Size Control

The method to control how resample is done.

Resolution

Control the number of pixels in the width or height.

Aspect Ratio

Control the ratio between the width and height.

Pixel Size

Control the size of the pixels.

Base Size

The base size to use as the final output’s dimensions. This can be scaled later on.

Parameter

Set the base parameters directly.

Size Input

Inherit the parameters from the size_ref input or source otherwise.

Resolution Menu

Base Resolution

The base number of pixels for the final image’s width and height.

Resolution Scale

The scales for the number of pixels in width and height respectively.

Aspect Ratio Menu

Base Aspect Ratio

The base aspect ratio for the final image.

Fixed Dimension

The fixed dimension marks which dimension will stay constant from the input image, and the other dimension will be the one that changes to match the aspect ratio.

Width

The width matches the input image’s width.

Height

The height matches the input image’s height.

Smaller Dimension

The smaller resolution matches the input image’s smaller resolution.

Larger Dimension

The larger resolution matches the input image’s larger resolution.

Pixel Size Menu

Pixel Size

The base pixel size for the final image. This base pixel size are square pixels, so this size is for both the width and height of a pixel.

Size Scale

The scales for the pixel’s width and height respectively.

Uniform Scale

The scale to apply to the base size. For resolution this means scaling the number of pixels in both dimensions. For aspect ratio, this means scaling the aspect ratio. For pixel size, this means scaling the pixel’s dimensions.

Reframe to Destination

Stretches the input image through resampling to conform to the entire boundary of the output and maintains the given pixel size. Specifically, makes the display window match the data window.

Refer to display and data windows documentation.

Sampling

Filter

Determines the filter used to sample. See Filters on more information and examples.

Point

Sets the pixel value to the pixel value of the nearest neighbour.

Bilinear

Sets the pixel value through bilinear interpolation .

Box

Sets the pixel value through a box filter, done by sampling all pixels within a box on the original image’s matching pixel.

Bartlett

Sets the pixel value through interpolating according to a triangular window or a Barlett window , taking each pixel as a sample of this signal.

Catmull-Rom

Sets the pixel value through a bicubic spline known as the Catmull-Rom spline . This is a special case of the Mitchell-Netravali filter .

Mitchell

Sets the pixel value through a bicubic spline known as the Mitchell-Netravali filter .

B-spline

Sets the pixel value through a bicubic spline known as the B-spline . This is a special case of the Mitchell-Netravali filter .

Stretch Behaviour

Determines how the image will stretch after the resample operation. Specifically, determines how the display window will be stretched.

Note: Stretch Behaviour has no effect if Reframe to Destination is set because then the display window does not stretch differently.

Stretch to Fit

Stretches the pixels to fit within the new display window. The display window is scaled naively according to the same scale that the data window is scaled at.

Fit Horizontally

Maintains the original pixel aspect ratio and aspect ratio by scaling the display window’s x dimension in relation to the data window’s x dimension.

Fit Vertically

Maintains the original pixel aspect ratio and aspect ratio by scaling the display window’s y dimension in relation to the data window’s y dimension.

Fit Maximally

Maintains the original pixel aspect ratio and aspect ratio by scaling the display window according to the original image’s data window’s maximal dimension.

Fit Minimally

Maintains the original pixel aspect ratio and aspect ratio by scaling the display window according to the original image’s data window’s minimal dimension.

Inputs

source

The source image to resample.

size_ref

The base size read under Size Input.

Outputs

resample

The output image with the new resolution or pixel size.

Copernicus nodes