You are here: Start » Function Reference » Image » Image Spatial Transforms » ResizeImage_Relative

ResizeImage_Relative

Header:	FIL.h
Namespace:	fil
Module:	FoundationLite

Resizes an image by a factor along each axis.

Syntax

void fil::ResizeImage_Relative
(
	const fil::Image& inImage,
	float inHorizontalScale,
	float inVerticalScale,
	fil::ResizeMethod::Type inResizeMethod,
	fil::Image& outImage
)

Parameters

Name	Type	Range	Default	Description
inImage	const Image&			Input image
inHorizontalScale	float	0.0 - 65535.0	1.0f
inVerticalScale	float	0.0 - 65535.0	1.0f
inResizeMethod	ResizeMethod::Type
outImage	Image&			Output image

Description

The operation stretches or shrinks the inImage so that its dimensions are scaled, accordingly, by the factor of inHorizontalScale, inVerticalScale. Two modes of pixel interpolation are available, the bilinear filtering being more precise and computationally expensive.

Examples

ResizeImage_Relative performed on the sample image with inHorizontalScale = 0.5, inVerticalScale = 0.25.

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).