Image8Root.GetRawPixelMemory Method

Image8Root GetRawPixelMemory Method

Cognex VisionPro 9.21 SR1

Gets an object that can be used to directly access the raw pixel data. The caller MUST call Dispose on this object when finished with it.

Namespace: Cognex.Vision
Assembly: Cognex.Vision.Core.Net (in Cognex.Vision.Core.Net.dll) Version: 9.21.1.1

Syntax

C++

Copy to Clipboard Print

public void GetRawPixelMemory(
	ImageDataModeConstants dataMode,
	int x,
	int y,
	int width,
	int height,
	out IImage8PixelMemory pixelMemory
)

public void GetRawPixelMemory(
	ImageDataModeConstants dataMode,
	int x,
	int y,
	int width,
	int height,
	out IImage8PixelMemory pixelMemory
)

Public Sub GetRawPixelMemory ( 
	dataMode As ImageDataModeConstants,
	x As Integer,
	y As Integer,
	width As Integer,
	height As Integer,
	<OutAttribute> ByRef pixelMemory As IImage8PixelMemory
)

Public Sub GetRawPixelMemory ( 
	dataMode As ImageDataModeConstants,
	x As Integer,
	y As Integer,
	width As Integer,
	height As Integer,
	<OutAttribute> ByRef pixelMemory As IImage8PixelMemory
)

public:
virtual void GetRawPixelMemory(
	ImageDataModeConstants dataMode, 
	int x, 
	int y, 
	int width, 
	int height, 
	[OutAttribute] IImage8PixelMemory^% pixelMemory
) sealed

public:
virtual void GetRawPixelMemory(
	ImageDataModeConstants dataMode, 
	int x, 
	int y, 
	int width, 
	int height, 
	[OutAttribute] IImage8PixelMemory^% pixelMemory
) sealed

Parameters

dataMode: Type: Cognex.Vision ImageDataModeConstants
Specifies whether the pixel data are read, write, or read/write.

x: Type: System Int32
The x-coordinate of the portion of the image to get.

y: Type: System Int32
The y-coordinate of the portion of the image to get.

width: Type: System Int32
The width of the image to get.

height: Type: System Int32
The height of the image to get.

pixelMemory: Type: Cognex.Vision IImage8PixelMemory
(output param) An object that represents the pixel data.

Implements

IImage8Root GetRawPixelMemory(ImageDataModeConstants, Int32, Int32, Int32, Int32, IImage8PixelMemory )

Exceptions

Exception	Condition
ImageException	This Root Image has not been initialized.
ImageException	x, y, width, and height do not describe a region that is fully contained within this image.

Remarks

This method is intended for Cognex use only. To access the pixel data directly, use Image8Grey's Get8GreyPixelMemory() instead.