Leadtools Send comments on this topic. | Back to Introduction - All Topics | Help Version 15.3.5
GetPixelData(Int32,Int32,IntPtr,Int32) Method
See Also 
Leadtools Namespace > RasterImage Class > GetPixelData Method : GetPixelData(Int32,Int32,IntPtr,Int32) Method




row
The zero-based row number of the pixel.
column
The zero-based column number of the pixel
data
Pointer to unmanaged memory buffer to copy the pixel data to.
dataSize
Size of bytesthe buffer in data.
Copies the pixel data of the specified pixel into an unmanaged memory buffer.

Syntax

Visual Basic (Declaration) 
Public Overloads Sub GetPixelData( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal data As IntPtr, _
   ByVal dataSize As Integer _
) 
Visual Basic (Usage)Copy Code
Dim instance As RasterImage
Dim row As Integer
Dim column As Integer
Dim data As IntPtr
Dim dataSize As Integer
 
instance.GetPixelData(row, column, data, dataSize)
C# 
public void GetPixelData( 
   int row,
   int column,
   IntPtr data,
   int dataSize
)
Managed Extensions for C++ 
public: void GetPixelData( 
   int row,
   int column,
   IntPtr data,
   int dataSize
) 
C++/CLI 
public:
void GetPixelData( 
   int row,
   int column,
   IntPtr data,
   int dataSize
) 

Parameters

row
The zero-based row number of the pixel.
column
The zero-based column number of the pixel
data
Pointer to unmanaged memory buffer to copy the pixel data to.
dataSize
Size of bytesthe buffer in data.

Example

This example uses GetPixelData and SetPixelData methods to swap the R and G values for a particular pixel.

Remarks

No transformations are performed on the pixel data.

The pixel data copied may represent an index into an images's palette, a grayscale value ((Document/Medical only), or red, green, and blue color values.

This method should be called only for 8, 16, 24, 32, 48 and 64-bit images. It works as follows:

  • For 8-bit images, this method will retrieve the palette index for the specified pixel.
  • For 16-bit images, this method will retrieve the 2-byte value that forms the pixel.
    • For grayscale 16-bit images, the data will contain the gray value. LowBit and HighBit properties indicate the valid pixel data.
    • For color 16-bit images, the data contains packed 5-bit R, G and B values. The high bit contains the alpha information. The Order determines whether the data is RGB or BGR.
  • For 24-bit images, this method will retrieve the 3 bytes containing the pixel color. The Order determines whether the data is RGB or BGR.
  • For 32-bit images, this method will retrieve the 4 bytes containing the pixel color and alpha information. The first 3 bytes contain the pixel color. The The Order determines whether the data in the first 3 bytes is RGB or BGR. The 4th byte is the alpha channel information.
  • For 48-bit images, this method will retrieve the 6 bytes containing the pixel color. The Order determines whether the data is RGB or BGR. Each color component is stored as a 16-bit value, where 0 corresponds to black and 0xFFFF corresponds to full white.
  • For 64-bit images, this method will retrieve the 8 bytes containing the pixel color and alpha information. The Order determines whether the data in the first 6 bytes is RGB or BGR. Each color component is stored as a 16-bit value, where 0 corresponds to black and 0xFFFF corresponds to full white. The last two bytes contain the alpha information (also stored as a short value).

The minimum size of the returned byte array is calculated:

( + 7) / 8

You can use the SetPixelData method to assign the returned value to another pixel.

This method uses image coordinates to specify the pixel. Therefore, you must account for the view perspective of the image. If you specify a pixel that is outside the image or outside the region (if the image has one), this method throws an exception.

The SetPixelData method changes the data of the specified pixel.

For more information, refer to Processing an Image.

For more information refer to Accounting for View Perspective.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also