ImageGear Professional DLL v17.1 for Windows Accusoft
IG_DIB_raster_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_raster_get

Glossary Item Box

This function obtains an entire horizontal raster line of pixels from the DIB image bitmap.

Declaration:

  Copy Code
AT_ERRCOUNT ACCUAPI IG_DIB_raster_get (
        HIGEAR hIGear, 
        AT_PIXPOS nYpos, 
        LPAT_PIXEL lpPixel, 
        AT_MODE nFormat 
); 

Arguments:

hIGear HIGEAR handle of image.
nYpos Raster line number (0 is top line).
lpPixel Far pointer to first byte of area to receive the raster row of pixel values.
nFormat A variable of type AT_MODE (see accucnst.h) that tells whether the data being read in packed, unpacked, or RLE-compressed.

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 Professional.

Sample:

Pixel Access

Example:

  Copy Code
HIGEAR            hIGear;                        /* HIGEAR handle of image                                       */
AT_PIXEL                 cPixelValue[64];                       /* Needed to hold 500 1-bit pixels                                      */
AT_PIXPOS                nRaster;                       /* Index for the loop below                                     */
AT_ERRCOUNT              nErrcount;                     /* Hold the returned error count                                        */
AT_MODE         nFormat;
/* Obtain the top raster of a 1-bit image that's 500 pixels wide:               */
/* The pixels occupy 500/8 = 62.5 bytes.                                                */
nErrcount = IG_DIB_raster_get ( hIGear, 0, &cPixelValue[0], IG_PIXEL_PACKED);
/* Make the next 9 rows identical to the top row: */
for ( nRaster = 1; nRaster < 10; nRaster++ )
        nErrcount = IG_DIB_raster_set ( hIGear, nRaster, &cPixelValue[0], IG_PIXEL_PACKED );

Remarks:

You may first make a call to IG_DIB_raster_size_get() in order to determine the size of buffer that you will need to hold the raster data. The format in which the data is returned, nFormat, tells ImageGear whether the data is packed, unpacked, or RLE-compressed. The values that nFormat may be set to are: IG_PIXEL_PACKED, IG_PIXEL_UNPACKED, and IG_PIXEL_RLE. IG_PIXEL_PACKED gives the storage format of a standard uncompressed DIB, which includes padding to a multiple of 4 bytes length. (If 1-bit or 4-bit, the pixels are packed 8 or 2 to a byte respectively, stored most-significant-bit-first.) 24-bit pixels are returned 3 bytes each, ordered Blue-Green-Red, with the row padded to a multiple of 4 bytes length.

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.
©2012. Accusoft Corporation. All Rights Reserved.