ImageGear Professional DLL v17.1 for Windows Accusoft
IG_DIB_line_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > DIB Functions > IG_DIB_line_get

Glossary Item Box

This function obtains an arbitrary line of pixels from the DIB image bitmap of the image referenced by hIGear.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_DIB_line_get ( HIGEAR hIGear, 
        PIXPOS nX1, 
        AT_PIXPOS nY1, 
        AT_PIXPOS nX2, 
        AT_PIXPOS nY2, 
        LPAT_PIXEL lpPixel, 
        const AT_DIMENSION nlenOfArray, 
        LPAT_DIMENSION lpNumPixels 
);

Arguments:

hIGear HIGEAR handle of image.
nX1 X coordinate of the first endpoint of line to get.
nY1 Y coordinate of the first endpoint.
nX2 X coordinate of the second endpoint of line.
nY2 Y coordinate of the second endpoint.
lpPixel Far pointer to your data area to which the pixels should be returned.
nLenOfArray Length, in bytes, of lpPixel block.
lpNumPixels Far pointer to an AT_DIMENSION variable in which the number of pixels (not bytes) transferred is returned.

Return Value:

Returns the number of ImageGear errors that occurred during the function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

All pixel formats supported by ImageGear Professional.

Sample:

Pixel Access

Example:

See the example for function IG_DIB_line_set().

Remarks:

The line of pixels does not have to be horizontal or vertical. nX1,nY1 are the coordinates of one endpoint of the line and nX2,nY2 are of the other.

If the pixel data would overflow your area (nLenOfArray), the transfer will be truncated; your data area will not be overflowed. The actual number of pixels returned will be stored in your variable pointed to by lpNumPixels.

ImageGear's pixel access functions consider the coordinates (0,0) to refer to the upper left-hand corner of the bitmap data. They do not follow the DIB's orientation, which considers (0,0) to refer to the lower left-hand corner of the bitmap.

To determine the number of pixels that your line will be comprised of, use the following formula:
max((1+abs(x2-x1)), (1+abs(y2-y1)))

1-bit and 4-bit pixels are returned one to a byte, right justified. 24-bit pixels are returned 3 bytes per pixel, in Blue-Green-Red order.

©2012. Accusoft Corporation. All Rights Reserved.