Overlay

CATResult CATImage::Overlay ( const CATImage *  srcImg, CATInt32  dstOffsetX, CATInt32  dstOffsetY, CATInt32  srcOffsetX, CATInt32  srcOffsetY, CATInt32  width = 0, CATInt32  height = 0   ) Overlay() merges from another image over the current image at the specified offsets for the specified width and height. If no width/height parameters are given, the entire width and/or height are used. Clipping is not performed. However, if the copy would go out of bounds, an error will be returned and the copy will not be performed. The alpha channel is used for the merge operation from the source image only. The destination's alpha remains unaffected - the alpha is used for merging the colors only. Parameters: srcImg  - source image to copy from dstOffsetX  - offset in dest image to copy to dstOffsetY  - offset in dest image to copy to srcOffsetX  - offset in src image to copy from srcOffsetY  - offset in src image to copy from width  - width to copy in height  - height to copy in Returns: CATResult - CAT_SUCCESS on success. Definition at line 1069 of file CATImage.cpp. References AbsWidth(), CAT_ERR_IMAGE_MUST_INITIALIZE, CAT_ERR_IMAGE_NULL, CAT_ERR_IMAGE_OVERLAY_OUT_OF_BOUNDS, CAT_SUCCESS, CATASSERT, CATRESULT, fData, fHeight, fWidth, Height(), kBytesPerPixel, Width(), XOffsetAbs(), and YOffsetAbs(). Referenced by CATSwitchMulti::Draw(), CATSwitch::Draw(), CATSlider::Draw(), CATRadioButton::Draw(), CATProgress::Draw(), CATPictureMulti::Draw(), CATPicture::Draw(), CATKnob::Draw(), and CATControl::Draw().

---