You are here: Start » Filter Reference » Image » Image Spatial Transforms » ResizeImage
Module: | FoundationLite |
---|
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
![]() |
![]() |
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. |
Complexity Level
This filter is available on Basic Complexity Level.
Filter Group
This filter is member of ResizeImage filter group.
See Also
- ResizeImage_Relative – Resizes an image by a factor along each axis.