You are here: Start » Filter Reference » Image Spatial Transforms » ResizeImage

ResizeImage

Enlarges or shrinks an image to new dimensions.

Name	Type	Range	Description
inImage	Image		Input image
inNewWidth	Integer *	1 - 65535
inNewHeight	Integer *	1 - 65535
inResizeMethod	ResizeMethod
outImage	Image		Output image

Description

The operation stretches or shrinks the inImage so that the dimensions of the outImage equal inNewWidth, inNewHeight. Three modes of pixel interpolation are available, with Area mode giving best results, but being most computationally expensive.

Examples

Description of usage of this filter can be found in examples and tutorial: Dynamic Template Matching.

ResizeImage performed on the sample image with inNewWidth = 300, inNewHeight = 200.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

This operation is optimized for SSE2 technology for pixels of types: UINT8 (when inResizeMethod = Area), UINT16 (when inResizeMethod = Area), 3xUINT8 (when inResizeMethod = Area), 3xUINT16 (when inResizeMethod = Area).

This operation is optimized for AVX2 technology for pixels of types: UINT8 (when inResizeMethod = Area), UINT16 (when inResizeMethod = Area), 3xUINT8 (when inResizeMethod = Area), 3xUINT16 (when inResizeMethod = Area).

Errors

This filter can throw an exception to report error. Read how to deal with errors in Error Handling.

List of possible exceptions:

Error type	Description
DomainError	Empty image on input in ResizeImage.
DomainError	Input and output images are not distinct in ResizeImage.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of ResizeImage filter group.