gimp_image_merge_down (1998)

NAME

gimp_image_merge_down - Merge the layer passed and the first visible layer below.

SYNOPSIS

layer = gimp_image_merge_down (image,merge_layer,merge_type)

DESCRIPTION

This procedure combines the passed layer and the first visible layer below it using the specified merge type. A merge type of EXPAND_AS_NECESSARY expands the final layer to encompass the areas of the visible layers. A merge type of CLIP_TO_IMAGE clips the final layer to the extents of the image. A merge type of CLIP_TO_BOTTOM_LAYER clips the final layer to the size of the bottommost layer.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
IMAGE	image	The image
LAYER	merge_layer	The layer to merge down from
INT32	merge_type	The type of merge: { EXPAND_AS_NECESSARY (0), CLIP_TO_IMAGE (1), CLIP_TO_BOTTOM_LAYER (2) }

RETURN VALUES

TYPE	NAME	DESCRIPTION
LAYER	layer	The resulting layer

SOME SYNTAX ALTERNATIVES

layer = $image->merge_down (merge_layer,merge_type)

AUTHOR

Larry Ewing
(c)1998 Larry Ewing