gimp_image_add_layer_mask - Add a layer mask to the specified layer.
SYNOPSIS
gimp_image_add_layer_mask (image,layer,mask)
DESCRIPTION
This procedure adds a layer mask to the specified layer. Layer masks serve as an additional alpha channel for a layer. This procedure will fail if a number of prerequisites aren't met. The layer cannot already have a layer mask. The specified mask must exist and have the same dimensions as the layer. Both the mask and the layer must have been created for use with the specified image.
INPUT ARGUMENTS
TYPE
NAME
DESCRIPTION
IMAGE
image
The image
LAYER
layer
The layer to receive the mask
CHANNEL
mask
The mask to add to the layer
SOME SYNTAX ALTERNATIVES
$image->add_layer_mask (layer,mask)
AUTHOR
Spencer Kimball & Peter Mattis (c)1995-1996 Spencer Kimball & Peter Mattis