You are here: Start » AVL.NET » Function Reference » Image » Image Spatial Transforms » AVL.ResizeImage_FixedAspectRatio

AVL.ResizeImage_FixedAspectRatio

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.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax

C++
C#
 
public static void ResizeImage_FixedAspectRatio
(
	AvlNet.Image inImage,
	int? inNewLength,
	AvlNet.Dimension inDimension,
	AvlNet.ResizeMethod inResizeMethod,
	AvlNet.Image outImage
)

Parameters

Name Type Range Default Description
inImageAvlNet.ImageInput image.
inNewLengthint?<1, 65535>The length in pixels that the chosen dimension will be set to. Default value: atl::NIL.
inDimensionAvlNet.DimensionThe dimension that will be set to the given length.
inResizeMethodAvlNet.ResizeMethod
outImageAvlNet.ImageOutput 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).

Hardware acceleration settings may be manipulated with Settings class.

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.

Function Overrides

See also