This documentation is for the old version. Go to the latest Graphics Mill docs

PixelFormatConverter.ConvertArray Method (Int32[,], PixelFormat, ColorProfile)

Converts several colors into another pixel format. These colors are represented by array. Color management is applied.

Namespace: Aurigma.GraphicsMill.Transforms
Assembly: Aurigma.GraphicsMill (in Aurigma.GraphicsMill.dll)

Syntax

Visual Basic
Public Function ConvertArray ( _
	array As Integer(,,), _
	format As PixelFormat, _
	profile As ColorProfile _
) As Integer(,,)
C#
public int[,,] ConvertArray(
	int[,,] array,
	PixelFormat format,
	ColorProfile profile
)

Parameters

array

Type: System.Int32 [,]

Array of image pixels should have the following format: first dimension is bitmap columns, second dimension is a bitmap rows, third dimension is a pixels channels. Array with this format is returned from Export() method of Bitmap and BitmapData.

Note

Array channel number (third dimension) must conform pixel format specified by format argument.

format

Type: Aurigma.GraphicsMill.PixelFormat

PixelFormat value that describes pixel format for the pixels in the specified array.
profile

Type: Aurigma.GraphicsMill.ColorProfile

ColorPalette class instance that is used as an input profile.

Return Value

An array of integers in the same format as input array. Pixel format that describes an order of channels is stored at DestinationPixelFormat property.

Remarks

The destination pixel format is specified by DestinationPixelFormat property.

During conversion with this method, the color management will be applied. Argument profile will be used as an input profile, output profiles are specified by CmykColorProfile, RgbColorProfile, and GrayScaleColorProfile properties. Property TargetColorProfile will be used as well.

Note

If output profile is not specified or ColorManagementEngine property is None, color management is disabled.

See Also

Reference