←Select platform

Access Method

Summary

Provides exclusive access to the image data contained in this RasterImage.

Syntax
C#
C++/CLI
Java
Python
public void Access() 
public void access(); 
public: 
void Access();  
def Access(self): 
Remarks

If the image data of this RasterImage object is stored in a global Windows handle, then use the Access method to lock the memory. If you do not call this method before accessing the data with a low-level method like GetRow or SetRow the application might fail.

To make the most of available system resources, you should only keep a RasterImage object locked when you need to access the image data. Call Release to unlock the image data for more efficient use of system memory resources.

If the image data of this RasterImage is not stored in a global Windows handle, then this method will do nothing and calling it will not have any effect on the RasterImage.

Use IsGlobalMemory to determine whether the image data of this RasterImage is stored in a global Windows handle.

Example
C#
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.ImageProcessing; 
using Leadtools.ImageProcessing.Core; 
using Leadtools.ImageProcessing.Color; 
using Leadtools.Dicom; 
using Leadtools.Drawing; 
using Leadtools.Controls; 
using Leadtools.Svg; 
 
 
public void GetRowTest() 
{ 
	RasterCodecs codecs = new RasterCodecs(); 
	RasterImage image = codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1.CMP")); 
 
	byte[] row1 = new byte[image.BytesPerLine]; 
	byte[] row2 = new byte[image.BytesPerLine]; 
 
	image.Access(); 
	for (int y = 0; y < image.Height / 2; y++) 
	{ 
		image.GetRow(y, row1, 0, row1.Length); 
		image.GetRow(image.Height - y - 1, row2, 0, row2.Length); 
 
		image.SetRow(y, row2, 0, row2.Length); 
		image.SetRow(image.Height - y - 1, row1, 0, row1.Length); 
	} 
	image.Release(); 
 
	codecs.Save(image, Path.Combine(LEAD_VARS.ImagesDir, "IMAGE1_getrow.BMP"), RasterImageFormat.Bmp, 0); 
 
	image.Dispose(); 
	codecs.Dispose(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS22\Resources\Images"; 
} 
Requirements

Target Platforms

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

Leadtools Assembly

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.