You are here: Start » Function Reference » Image » Image Point Transforms » RescalePixels

RescalePixels

Header:	FIL.h
Namespace:	fil
Module:	FoundationLite

Applies linear transformation to pixel values.

Syntax

void fil::RescalePixels
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	float inA,
	float inB,
	fil::Image& outImage
)

Parameters

Name	Type	Default	Description
inImage	const Image&		Input image
inRoi	Optional<const Region&>	NIL	Range of pixels to be processed
inA	float	1.0f	Value multiplied
inB	float	0.0f	Value added
outImage	Image&		Output image

In-place Processing

This function supports in-place data processing - you can pass the same reference to inImage and outImage

Description

The operation applies linear transformation to pixel values.

\[{\forall _{i,j} }{\bf{outImag} }{ {\bf{e} }_{ {\rm{i} },{\rm{j} } } }{\rm{ = } }{\bf{inA} }\cdot{\bf{inImag} }{ {\bf{e} }_{ {\rm{i} },{\rm{j} } } }{\rm{ + } }{\bf{inB} }\]

Whenever the resulting value exceeds the range of pixel values, it is clipped to the nearest proper value.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: UINT8, SINT8, SINT16, REAL.

This operation supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type	Description
DomainError	Region exceeds an input image in RescalePixels.