Back to FabImage Library website

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

ReplacePixels


Header: FIL.h
Namespace: fil
Module: FoundationLite

Substitutes pixels having the specified value with a new value.

Syntax

C++
C#
 
void fil::ReplacePixels
(
	const fil::Image& inImage,
	ftl::Optional<const fil::Region&> inRoi,
	const fil::Pixel& inOldPixel,
	const fil::Pixel& inNewPixel,
	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 inOldPixel const Pixel&
Input value inNewPixel const Pixel&
Output value outImage Image& Output image

In-place Processing

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

Read more about In-place Computation.

Hardware Acceleration

This operation is optimized for SSE2 technology for pixels of types: 1xUINT8, 1xSINT16.

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