Home  Contents

gcx:alphaMode

Graphics Core4 Lua Commands

SYNOPSIS

  1. gcx:alphaMode(mode)
  2. mode = gcx:alphaMode()

DESCRIPTION

If specified, selects mode as the new alpha blending mode for this graphics context.
With no arguments, returns the mode currently used by gcx.

Values for mode are "blend" and "store".

In "blend" mode, alpha blending is performed for any graphics operation on this context.

In "store" mode, the source alpha information is copied to this context verbatim, overwriting any alpha information already stored.

Note: The commands gcx:blit and gcx:blitframe are an exception, as their behaviour is selected using gcx:blitMode.

RETURN VALUE

A string indicating the alpha blending mode which is currently used by gcx.

ERRORS

Raises an error if gcx is not a graphics context or if mode is not a valid value.

EXAMPLE

>  > 
fb = gfx.open() print (fb:alphaMode())
blend

SEE ALSO