Back to FabImage Studio website

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

ResizeImage


Module: FoundationLite

Enlarges or shrinks an image to new dimensions.

Name Type Range Description
Input value inImage Image Input image
Input value inRoi Box* Box defining a subimage to be cropped and resized.
Input value inNewWidth Integer* 1 - 65535
Input value inNewHeight Integer* 1 - 65535
Input value inResizeMethod ResizeMethod
Output value 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 SSE41 technology for pixels of types: UINT8(when inResizeMethod = Bilinear), 3xUINT8(when inResizeMethod = Bilinear).

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

This operation is optimized for NEON technology for pixels of types: UINT8 (when inResizeMethod = Area), 3xUINT8 (when inResizeMethod = Area), UINT16 (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.
DomainError ROI is out of inImage range in ResizeImage.

Complexity Level

This filter is available on Basic Complexity Level.

Filter Group

This filter is member of ResizeImage filter group.

See Also