You are here: Start » Image » Image Spatial Transforms » ResizeImage_FixedAspectRatio
ResizeImage_FixedAspectRatio
Header: | AVL.h |
---|---|
Namespace: | avl |
Changes one dimension of the image to a desired length while the other dimension is set to a length such that the aspect ration of the image is maintained.
Syntax
void avl::ResizeImage_FixedAspectRatio ( const avl::Image& inImage, atl::Optional<int> inNewLength, avl::Dimension::Type inDimension, avl::ResizeMethod::Type inResizeMethod, avl::Image& outImage )
Parameters
Name | Type | Range | Default | Description | |
---|---|---|---|---|---|
inImage | const Image& | Input image | |||
inNewLength | Optional<int> | 1 - 65535 | NIL | The length in pixels that the chosen dimension will be set to | |
inDimension | Dimension::Type | The dimension that will be set to the given length | |||
inResizeMethod | ResizeMethod::Type | ||||
outImage | Image& | Output image |
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
List of possible exceptions:
Error type | Description |
---|---|
DomainError | Empty image on input in ResizeImage_FixedAspectRatio. |
DomainError | Unsupported dimension given in inDimension, only Width and Height are supported in ResizeImage_FixedAspectRatio. |