IG_DIB_row

This function obtains a consecutive row of nLength pixels beginning at coordinates (nXpos, xYpos) in the image bitmap.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_DIB_row_get ( HIGEAR hIGear, AT_PIXPOS nXpos, AT_PIXPOS nYpos, AT_DIMENSION nLength, LPVOID lpPixel, AT_MODE nFormat );

Arguments:

Name	Type	Description
hIGear	HIGEAR	HIGEAR handle of image.
nXpos	AT_PIXPOS	X offset (in pixels) from beginning of the raster line. First pixel on line is pixel number 0. Specify as -1 to obtain the entire raster line of pixels.
nYpos	AT_PIXPOS	Raster line number (0 is top line).
nLength	AT_DIMENSION	Number of consecutive pixels to obtain (entire raster line if nXpos = -1).
lpPixel	LPVOID	Far pointer to first byte of your area, at which the pixels obtained are to be stored.
nFormat	AT_MODE	Format in which the raster data is read: IG_PIXEL_PACKED, IG_PIXEL_UNPACKED, IG_PIXEL_RLE.

Return Value:

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

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Example:

	Copy Code
HIGEAR hIGear; /* HIGEAR handle of image / AT_PIXEL cPixelValue[300]; / To hold 100 pixels, in case 24-bit/ AT_PIXPOS nRow; / Index for the loop below / AT_DIMENSION nRowLen; / How much of row to copy / AT_ERRCOUNT nErrcount; / Holds the returned error count / / Obtain leftmost 100 pixels of top raster of image: / nRowLen = 100; nErrcount = IG_DIB_row_get ( hIGear, 0, 0, nRowLen, &cPixelValue[0], IG_PIXEL_UNPACKED ); / Make leftmost 100 pixels of next 9 rows identical: */ for ( nRow = 1; nRow < 10; nRow++ ) nErrcount = IG_DIB_row_set (hIGear, 0, nRow, nRowLen, cPixelValue, IG_PIXEL_UNPACKED);

Copy Code

HIGEAR            hIGear;                /* HIGEAR handle of image                                                       */
AT_PIXEL                 cPixelValue[300];                      /* To hold 100 pixels, in case 24-bit*/
AT_PIXPOS                nRow;          /* Index for the loop below                                                     */
AT_DIMENSION             nRowLen;               /* How much of row to copy                                                      */
AT_ERRCOUNT              nErrcount;             /* Holds the returned error count                                                       */
/* Obtain leftmost 100 pixels of top raster of image:                                                                                   */
nRowLen = 100;
nErrcount = IG_DIB_row_get ( hIGear, 0, 0, nRowLen, &cPixelValue[0], IG_PIXEL_UNPACKED );
/* Make leftmost 100 pixels of next 9 rows identical:                   */
for ( nRow = 1; nRow < 10; nRow++ )
        nErrcount = IG_DIB_row_set (hIGear, 0, nRow, 
                nRowLen, cPixelValue, IG_PIXEL_UNPACKED);

Remarks:

If nFormat is set to IG_PIXEL_UNPACKED, and the image is 1 or 4-bit, the pixels obtained are stored right justified, one to a byte, beginning at your byte pointed to by lpPixel. The unused bits of the bytes are set to zero. If the pixels are 24-bit, 3 bytes per pixel are returned, ordered Blue-Green-Red. A total of nLength pixels is transferred. (See the section Device-Independent Bitmaps (DIB)Understanding Bitmap Images for more details on pixel storage in DIBs.)

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.