GetPixelVariant (ImageKit Control/PrintDraw Method)

This method retrieves the RGB values from a specified pixel in the designated object. (The screen or the image data).

[Visual Basic] [ Boolean = ]imagekitcontrolname.PrintDraw.GetPixelVariant(DeviceValue As Long, x As LONG_PTR, y As Long, Red As Variant, Green As Variant, Blue As Variant, DeviceMode As OutPutDeviceModeConstants)

[VB.NET] [ Boolean = ]imagekitcontrolname.PrintDraw.GetPixelVariant(DeviceValue As Integer(x86) or Long(x64), x As Integer, y As Integer, ByRef Red As Object, ByRef Green As Object, ByRef Blue As Object, DeviceMode As ImageKit9(A)Lib.OutPutDeviceModeConstants)

[C#.NET] [ bool = ]imagekitcontrolname.PrintDraw.GetPixelVariant(int(x86) or long(x64) DeviceValue, int x, int y, ref object Red, ref object Green, ref object Blue, ImageKit9(A)Lib.OutPutDeviceModeConstants DeviceMode)

* ImageKit9ALib refers to the ANSI version, ImageKit9Lib refers to the Unicode version, (x86) refers to the 32 bit version, and (x64) refers to the 64 bit version.

Parameters

Name	Explanation
DeviceValue	The device context or the raster image data (i.e. Hdc or ImgHandle)
x,y	The x,y coordinates of the pixel
Red	The red component of the RGB value
Green	The green component of the RGB value
Blue	The blue component of the RGB value
DeviceMode	The designated object (0: Screen, 2: Image data)

The following constants can be used: (ikScreen = 0, ikMemoryHandle = 2).

Return Value

Returns True (nonzero) if successful. Returns False (0) if unsuccessful.

Explanation

The GetPixelVariant method retrieves the RGB values from the pixel specified by the x and y parameters.

This method is recommended when using scripting or other languages that require variant types or when using 64 bit builds in VB.NET or C#.

This method is enabled when the DeviceMode parameter is 0 or 2. In other words, this method can only be used with the screen or the image data but not with the printer. Please set the x and y parameters in pixel units.

Note: With the Visual Basic PictureBox, the AutoRedraw property must be set to True.

Also see the GetPixel method.

Differences between the ImageKit7/8

The DeviceValue argument type has changed.