ImageGear for C and C++ on Windows v19.5 - Updated
IG_dspl_ROP_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Display Functions > IG_dspl_ROP_set

This function sets the ROP (raster-operation) code to use when displaying images on Windows platforms.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI IG_dspl_ROP_set(
        HIGEAR hIGear,
        DWORD dwGrpID,
        DWORD dwROP
);

Arguments:

Name Type Description
hIGear HIGEAR ImageGear handle of image.
dwGrpID DWORD Identifier of group in which to set ROP code.
dwROP DWORD ROP code to set.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

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

Sample:

None

Example:

 
Copy Code
HIGEAR       hIGear;      /* HIGEAR handle of image  */  
DWORD        nGrpID;      /* display group identifier  */ 
 ... 
/* image will be XOR'd with destination contents */ 
IG_dspl_ROP_set( hIGear, nGrpID, SRCINVERT ); 
 ... 

Remarks:

This code determines how the source image pixels are combined with the destination area pixels. The default ROP is SRCCOPY, which overwrites the destination area with the source image. Other codes are described in the documentation for the Windows GDI function BitBlt.