←Select platform

SetRow(int,IntPtr,int) Method


Copies one or more rows of image data from an unmanaged memory buffer to this RasterImage.

public int SetRow( 
   int row, 
   IntPtr buffer, 
   int bufferCount 
Public Overloads Function SetRow( _ 
   ByVal row As Integer, _ 
   ByVal buffer As IntPtr, _ 
   ByVal bufferCount As Integer _ 
) As Integer 
public long setRow( 
  int row,  
  byte[] buffer,  
  long bufferCount 
int SetRow(  
   int row, 
   IntPtr buffer, 
   int bufferCount 


The number of the row to update. The first row is 0, and the last row is 1 less than the image height.

Pointer to unmanaged memory buffer containing the image data. The buffer should contain uncompressed data regardless of whether the image is compressed or not.

Number of bytes to set. Use the BytesPerLine property of this RasterImage to determine the byte count of each line.

Return Value

The number of bytes copied.


The image memory must be locked when you use this method. Normally, you can call Access to lock the memory before starting an operation that uses this method. Then call Release when the operation is finished.

You can use the BitsPerPixel property of the image to determine the number of bytes to set the bufferCount parameter. If the image is 8-bit then each byte is an index to the palette. If the image is a 24-bit image, then each three bytes represents one pixel element. Color order is determined by the Order property of the RasterImage object. This value can be RasterByteOrder.Rgb, RasterByteOrder.Bgr, or RasterByteOrder.Romm.

Note: To calculate the correct size for a single row of image data:

  • Windows-based platforms: (((Width * BitsPerPixel) + 31) >> 3)) & ~3
  • Unix-based platforms (Linux, Android, OSX, iOS): (((Width * BitsPerPixel) + 7) / 8)

RasterByteOrder.Gray is only valid for 12 and 16-bit grayscale images. Support for 12 and 16-bit grayscale images is only available in the Document/Medical Imaging editions.

For more information, refer to Introduction to Image Processing With LEADTOOLS.


For an example, refer to GetRow.


Target Platforms

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

Leadtools Assembly