Developer

API Reference

IWidget_SetROP()

Brew Release
Brew MP 1.0.2
See Also
- IWidget
- IWidget_SetImageParm()
Description
This function is used to specify the raster operation for an image widget's bitmap. The raster operation specifies how the pixels of a bitmap will be transformed when they are transferred to the display. For example, a raster operation of AEE_RO_COPY would copy the pixels of the source bitmap directly to the screen, regardless of the pixels in the destination graphics port. More complex behaviors can be performed by specifying various raster operations, each of which identifies the logical relation between the source image and its destination. Illustrating, again, a raster operation of AEE_RO_OR would logically 'or' each pixel of the source bitmap with the corresponding pixel of the destination.
See the description of IPARM_ROP in AEEImage.h for a full description of the available transfer modes and constants that can be used as raster ops.
Parameters
  • pif
    []:
    [in] Pointer to the IWidget object.
  • rop
    []:
    [in] Identifies the raster operation to be applied when transferring the pixels of the image widget's bitmap to those in the destination graphics port.
Interface
Prototype
   int IWidget_SetROP(IWidget *pif, uint32 rop);
Return
   AEE_SUCCESS - If BREW was able to successfully set the raster operation.
   AEE_EFAILED - If the raster operation could not be set.
Side Effect
IWidget_SetROP() calls IWidget_SetImageParm() to access the IPARM_ROP image attribute. This has the net effect of processing an EVT_WDG_SETPROPERTY event through the widget hierarchy.
Comment
None
  • Follow