gimp_layer_create_mask - Create a layer mask for the specified specified layer.
SYNOPSIS
mask = gimp_layer_create_mask (layer,mask_type)
DESCRIPTION
This procedure creates a layer mask for the specified layer. Layer masks serve as an additional alpha channel for a layer. Three different types of masks are allowed initially: completely white masks (which will leave the layer fully visible), completely black masks (which will give the layer complete transparency, and the layer's already existing alpha channel (which will leave the layer fully visible, but which may be more useful than a white mask). The layer mask still needs to be added to the layer. This can be done with a call to 'gimage_add_layer_mask'.
INPUT ARGUMENTS
TYPE
NAME
DESCRIPTION
LAYER
layer
The layer to which to add the mask
INT32
mask_type
The type of mask: { WHITE_MASK (0), BLACK_MASK (1), ALPHA_MASK (2) }
RETURN VALUES
TYPE
NAME
DESCRIPTION
CHANNEL
mask
The newly created mask
SOME SYNTAX ALTERNATIVES
mask = $layer->create_mask (mask_type)
AUTHOR
Spencer Kimball & Peter Mattis (c)1995-1996 Spencer Kimball & Peter Mattis