gimp_layer_new (1995-1996)

NAME

gimp_layer_new - Create a new layer.

SYNOPSIS

layer = gimp_layer_new (image,width,height,type,name,opacity,mode)

DESCRIPTION

This procedure creates a new layer with the specified width, height, and type. Name, opacity, and mode are also supplied parameters. The new layer still needs to be added to the image, as this is not automatic. Add the new layer with the 'gimp_image_add_layer' command. Other attributes such as layer mask modes, and offsets should be set with explicit procedure calls.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
IMAGE	image	The image to which to add the layer
INT32	width	The layer width: (0 < width)
INT32	height	The layer height: (0 < height)
INT32	type	The layer type: { RGB_IMAGE (0), RGBA_IMAGE (1), GRAY_IMAGE (2), GRAYA_IMAGE (3), INDEXED_IMAGE (4), INDEXEDA_IMAGE (5) }
STRING	name	The layer name
FLOAT	opacity	The layer opacity: (0 <= opacity <= 100)
INT32	mode	The layer combination mode: { NORMAL_MODE (0), DISSOLVE_MODE (1), BEHIND_MODE (2), MULTIPLY_MODE (3), SCREEN_MODE (4), OVERLAY_MODE (5), DIFFERENCE_MODE (6), ADDITION_MODE (7), SUBTRACT_MODE (8), DARKEN_ONLY_MODE (9), LIGHTEN_ONLY_MODE (10), HUE_MODE (11), SATURATION_MODE (12), COLOR_MODE (13), VALUE_MODE (14), DIVIDE_MODE (15) }

RETURN VALUES

TYPE	NAME	DESCRIPTION
LAYER	layer	The newly created layer

SOME SYNTAX ALTERNATIVES

layer = $image->layer_new (width,height,type,name,opacity,mode)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1995-1996 Spencer Kimball & Peter Mattis