- gcx:blitMode(mode)
- mode = gcx:blitMode()
SYNOPSIS
DESCRIPTION
If specified, selects mode as the new blitting mode for this graphics context.
With no arguments, returns the mode currently used by gcx.
The blitting mode indicates how raster copy operations (blitting) are done when this context is used as a source.
Values for mode are "blend", "mask" and "store".
In "blend" mode, full alpha blending is performed for any blitting operation.
In "mask" mode, the source alpha value is used only for transparency masking. Any alpha value which is less than 128 causes the source pixel to be written to the destination. Alpha values above 128 will leave the destination pixel as is. Faster than "blend" mode.
In "store" mode, the source pixels are copied verbatim to the destination. Neither alpha blending nor masking are performed. This is the fastest mode.
If this context does not have an alpha channel, the mode is fixed at "store" and cannot be changed.