TGopBitBltAlphaBitmap Class Reference

#include <graphicsaccelerator.h>

class TGopBitBltAlphaBitmap : public TGraphicsOperation

Inherits from

Detailed Description

An accelerated graphics operation that copies a rectangular region of one bitmap into another using alpha blending values provided in a third bitmap.

The way alpha blending works is as follows: if the alpha value is the maximum, the source pixel is opaque, in other words, the full colour of the pixel is written to the destination. If the alpha value is zero, the source pixel is fully transparent, and the destination is left unaltered. Values in-between cause blending with the following formula:

Destination = Source*Alpha/max_Alpha + Destination*(max_Alpha-Alpha)/max_Alpha

Colour alpha-bitmaps specify red, green and blue alpha values for each pixel, greyscale bitmaps specify a single alpha value for each pixel. The maximum alpha value depends on the bitmap's display mode. For example, 255 is the maximum for an EGray256 or EColor16M bitmap. The maximum is less for bitmaps which use fewer bits per colour component.

Supported bitmap formats than can be used as alpha bitmaps are given in TGraphicsAcceleratorCaps::iAlphaBitmap.

Objects of this class can be passed to a graphics accelerator's Operation() function either individually, or in a buffer.

See also: TGraphicsAcceleratorCaps::iAlphaBitmap

Member Attribute Documentation

iAlphaBitmap

A handle to the alpha bitmap, the bitmap that contains alpha blending values.

iDestination

TPoint iDestination

The destination for the top left hand corner of the portion of the source bitmap.

iSourceBitmap

TAcceleratedBitmapSpec iSourceBitmap

A handle to the source bitmap, and other information needed to access it.

iSourceRect

TRect iSourceRect

A rectangle defining the part of the source bitmap to be copied.

Constructor & Destructor Documentation

TGopBitBltAlphaBitmap ( const TPoint &, TAcceleratedBitmapSpec, TRect &, TAcceleratedBitmapSpec )

TGopBitBltAlphaBitmap(const TPoint &aDestination,
TAcceleratedBitmapSpecaSourceBitmap,
TRect &aSourceRect,
TAcceleratedBitmapSpecaAlphaBitmap
)[inline]

Constructor with a position, two bitmap specs and a rectangle.

ParameterDescription
aDestinationThe destination for the top left hand corner of the portion of the source bitmap.
aSourceBitmapA handle to the source bitmap, and other information needed to draw it.
aSourceRectA rectangle within the source bitmap. Its coordinates are relative to the top left of the source bitmap. Defines the part of the source bitmap to be copied.
aAlphaBitmapA handle to the alpha bitmap, the bitmap that contains alpha blending values.