Back to FabImage Library website

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

RescalePixels_FixedRange


Header: FIL.h
Namespace: fil
Module: FoundationLite

Transforms pixels value from given range into new one.

Syntax

C++
C#
 
void fil::RescalePixels_FixedRange
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	float inMinValue,
	float inMaxValue,
	float inNewMinValue,
	float inNewMaxValue,
	fil::Image& outImage
)

Parameters

Name Type Default Description
Input value
inImage const Image& Input image
Input value
inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value
inMinValue float Declared minimum value of input image
Input value
inMaxValue float Declared maximum value of input image
Input value
inNewMinValue float Desired minimum value of the resulting image
Input value
inNewMaxValue float Desired maximum value of the resulting image
Output value
outImage Image& Output image

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 A inMinValue cannot be equal to inMaxValue in RescalePixels_FixedRange.
DomainError A inMinValue cannot be higher than the inMaxValue in RescalePixels_FixedRange.
DomainError The inNewMinValue cannot be higher than the inNewMaxValue in RescalePixels_FixedRange.