ResizeBuffer(int,int,IntPtr,long) Method

Summary

Retrieves resized data in an unmanaged buffer, one line at a time.

Syntax

C++/CLI

Python

public void ResizeBuffer( 
   int row, 
   int column, 
   IntPtr buffer, 
   long bytes 
)

public: 
void ResizeBuffer(  
   int row, 
   int column, 
   IntPtr buffer, 
   int64 bytes 
)

def ResizeBuffer(self,row,column,buffer,bytes):

Parameters

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

column
The column offset within the row to retrieve. The first column offset is 0, and the last column offset is 1 less than the image Width.

buffer
The unmanaged buffer to hold the image data that this method gets.

bytes
The number of bytes to retrieve. Consider the BitsPerPixel, and avoid specifying a number that goes past the end of the row.

For a 1-bit image, each byte represents 8 pixels.
For a 4-bit image, each byte represents 2 pixels.
For an 8-bit image, each byte represents 1 pixel.
For a 16-bit image, every 2 bytes represents one pixel.
For a 24-bit image, every three bytes represents one pixel.
For a 32-bit image, every four bytes represents one pixel.
For a 48-bit image, every six bytes represents one pixel.
For a 64-bit image, every eight bytes represents one pixel.

You can use the BitsPerPixel property with integer math to calculate the number of bytes needed for a particular number of pixels. For example:

NumberOfBytes = Image.BitsPerPixel * (Image.Width * Image.Height + 7) / 8;

Remarks

By using this low-level method to get any part of a row, you can write a procedure that accesses a single pixel or a rectangular area within the image.

This method accepts an offset parameter ( column) in pixels and a length ( bytes) in bytes. Therefore, you must consider the BitsPerPixel of the image when specifying these parameters. The following table describes the rules:

BitsPerPixel	Column Offset (in Pixels)	Bytes to Get
1	Must be a multiple of 8 (such as 0,8, or 16).	Can be any number up to the end of the row. Consider that there are 8 pixels per byte.
4	Must be an even number (such as 0, 2, or 4).	Can be any number up to the end of the row. Consider that there are 2 pixels per byte.
8	Can be any column within the image.	Can be any number up to the end of the row. Consider that there is 1 pixel per byte.
16	Can be any column within the image.	Must be a multiple of 2 (such as 2, 4, or 6), because there are 2 bytes per pixel.
24	Can be any column within the image.	Must be a multiple of 3 (such as 3, 6, or 9), because there are 3 bytes per pixel.
32	Can be any column within the image.	Must be a multiple of 4 (such as 4, 8, or 12), because there are 4 bytes per pixel.
48	Can be any column within the image.	Must be a multiple of 6 (such as 6, 12, or 18), because there are 6 bytes per pixel.
64	Can be any column within the image.	Must be a multiple of 8 (such as 8, 16, or 24), because there are 8 bytes per pixel.

Do not pass a value in bytes that goes past the end of the row. The process is faster when rows are retrieved sequentially, either top-down or bottom-up.

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

Example

using Leadtools; 
using Leadtools.Codecs; 
 
 
public void RasterImageResizeExample() 
{ 
	string srcFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1.cmp"); 
	string destFileName = Path.Combine(LEAD_VARS.ImagesDir, "Image1_RasterImageResize.bmp"); 
 
	using (RasterCodecs codecs = new RasterCodecs()) 
	{ 
		// Load the source image 
		using (RasterImage srcImage = codecs.Load(srcFileName)) 
		{ 
			// We will resize to half the original size 
			int destWidth = srcImage.Width / 2; 
			int destHeight = srcImage.Height / 2; 
 
			// Create the destination image 
			using (RasterImage destImage = new RasterImage( 
			   RasterMemoryFlags.Conventional, 
			   destWidth, 
			   destHeight, 
			   srcImage.BitsPerPixel, 
			   srcImage.Order, 
			   srcImage.ViewPerspective, 
			   srcImage.GetPalette(), 
			   IntPtr.Zero, 
			   0)) 
			{ 
				RasterImageResize resize = new RasterImageResize(); 
 
				// Add Event Handler 
				resize.Resize += new EventHandler<RasterImageResizeEventArgs>(resize_Resize); 
 
				byte[] buffer = new byte[destImage.BytesPerLine]; 
 
				// Start the resize process 
				resize.Start( 
				   srcImage, 
				   destWidth, 
				   destHeight, 
				   srcImage.BitsPerPixel, 
				   srcImage.Order, 
				   srcImage.DitheringMethod, 
				   RasterSizeFlags.None, 
				   srcImage.GetPalette()); 
 
				destImage.Access(); 
				// get the rows for the resized image, one by one 
				for (int row = 0; row < destImage.Height; row++) 
				{ 
					resize.ResizeBuffer(row, 0, buffer, 0, destImage.BytesPerLine); 
					destImage.SetRow(row, buffer, 0, destImage.BytesPerLine); 
				} 
				destImage.Release(); 
				resize.Stop(); 
 
				// Save the destination image 
				codecs.Save(destImage, destFileName, RasterImageFormat.Bmp, 24); 
			} 
		} 
	} 
} 
 
private void resize_Resize(object sender, RasterImageResizeEventArgs e) 
{ 
	// e.Row should ALWAYS be less than e.Image.Height 
	if (e.Row >= e.Image.Height) 
	{ 
		e.Cancel = true; // abort the resize 
		return; 
	} 
 
	byte[] buffer = new byte[e.Bytes]; 
	e.Image.Access(); 
	e.Image.GetRowColumn(e.Row, e.Column, buffer, 0, e.Bytes); 
	e.Image.Release(); 
	Marshal.Copy(buffer, 0, e.Buffer, e.Bytes); 
	Console.WriteLine("{0}, {1}", e.Row, e.Column); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}

Requirements

Target Platforms

Reference

RasterImageResize Class

RasterImageResize Members

Overload List

Download our FREE evaluation

Help Version 23.0.2024.5.22