An expression evaluating to an object of type McRegionAccess.
pvLine
Required. A Variant value.
VARIANT* : A pointer to a VARIANT receiving the pixel values. If the VARIANT is empty, the function will return one containing a one-dimensional SAFEARRAY (for one channel per pixel) or a two-dimensional SAFEARRAY (for multiple channels per pixel). If a 1-D array is created, it will be shaped as vLine(0 to lWidth-1) for VB arrays and as vLine[lWidth] for C/C++/Java arrays. If a 2-D array is created, it will be shaped as vLine(0 to nChannels-1, 0 to lWidth-1) for VB arrays and as vLine[lWidth][nChannels] for C/C++/Java arrays.
The total number of values contained in the SAFEARRAY is equal to the width of the McRegionAccess times the number of channels in the McRegionAccess. For color McRegionAccess red, green, and blue values are interlaced. The type of values in the SAFEARRAY and the number of channels returned is determined by the type and channel arguments of the call to McImage.CreateRegionAccess.
y
Required. A Long value.
long : The 0-based line number. Line 0 is the top line of the McRegionAccess.
Remarks
The y coordinate is relative to the McRegionAccessROI, not the image. The pixel values returned are in the requested color model, which may differ from the image's native color model.
This is the preferred method for accessing an image.
When the routine itself creates the array it is typed after the image type, which guarantees that the pixel values will fit into the array. If pvLine already contains an array it must be of the right data type and size.
For languages that do not support the unsigned integer type (like Visual Basic or VBA), 16 bits values bigger than 32767 will be reported as negative because their sign bit is set. The best way to work around this limitation is to use a “long” McRegionAccess, which will then return long positive values (4 bytes) instead of unsigned integers (2 bytes).
GetLine Method (McRegionAccess)
