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.