Back to Adaptive Vision Library website

You are here: Start » Function Reference » All Functions » Image Point Transforms » AvsFilter_CorrectGamma

AvsFilter_CorrectGamma


This is Filter Equivalent. This function may be present in generated code, but should not be used in hand-written code.

Header: AVL.h
Namespace: avs
Module: FoundationLite

Performs gamma correction.

Applications: Image enhancement for human perception. For computer vision consider LogarithmImage.

Syntax

void avs::AvsFilter_CorrectGamma
(
	AvsFilters_ImagePointTransformsState& ioState,
	const avl::Image& inImage,
	atl::Optional<const avl::Region&> inRoi,
	float inValue,
	avl::Image& outImage
)

Parameters

Name Type Range Default Description
Input will be modified
ioState AvsFilters_ImagePointTransformsState& Object used to maintain state of the function.
Input value
inImage const Image& Input image
Input value
inRoi Optional<const Region&> NIL Range of pixels to be processed
Input value
inValue float 0.01 - 8.0 2.0f Gamma coefficient, where 1.0 is neutral
Output value
outImage Image& Output image

Requirements

For input inImage only pixel formats are supported: int8, uint8, int16, uint16, int32.

Read more about pixel formats in Image documentation.

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 supports automatic parallelization for multicore and multiprocessor systems.

Errors

List of possible exceptions:

Error type Description
DomainError Region exceeds an input image in CorrectGamma.
DomainError Not supported inImage pixel format in AvsFilter_CorrectGamma. Supported formats: Int8, UInt8, Int16, UInt16, Int32.