You are here: Start » AVL.NET » AVL.AverageChannels_Weighted(AvlNet.Image, AvlNet.Region, int, int, int, int, AvlNet.Image)

AVL.AverageChannels_Weighted(AvlNet.Image, AvlNet.Region, int, int, int, int, AvlNet.Image)

Creates a monochromatic image from weighted averages of the input image channels.

Namespace:AvlNet
Assembly:AVL.NET.dll

Syntax


public static void AverageChannels_Weighted(
	AvlNet.Image inImage,
	AvlNet.Region inRoi,
	int inWeight1,
	int inWeight2,
	int inWeight3,
	int inWeight4,
	out AvlNet.Image outImage
)

Parameters

inImage
Type: AvlNet.Image
Input image
inRoi
Type: AvlNet.Region
Range of pixels to be processed, or null.
inWeight1
Type: System.Int32
Weight of the first channel
inWeight2
Type: System.Int32
Weight of the second channel
inWeight3
Type: System.Int32
Weight of the third channel
inWeight4
Type: System.Int32
Weight of the fourth channel
outImage
Type: AvlNet.Image
Output image

Description

The operation computes the monochromatic average of the inImage color channels. Average being computed at each pixel is a weighted arithmetic mean.

Weights of the channels are determined by the parameters inWeight1, inWeight2, inWeight3, inWeight4. For images having less than four channels, it is required that weights assigned to non-existing channels equal zero.

Examples

AverageChannels_Weighted run on example image with inWeight1 = 1, inWeight2 = 0, inWeight3 = 0, inWeight4 = 0, which for a RGB image is equivalent to the extraction of the Red channel.

Hardware Acceleration

This operation supports automatic parallelization for multicore and multiprocessor systems.

Hardware acceleration settings may be manipulated with Settings class.

Errors

Error type Description
DomainError Non-zero weight of not existing image channel in AverageChannels_Weighted.
DomainError Sum of weights equals zero in AverageChannels_Weighted.

See also