gimp_channel_new (1995-1996)

NAME

gimp_channel_new - Create a new channel.

SYNOPSIS

channel = gimp_channel_new (image,width,height,name,opacity,color)

DESCRIPTION

This procedure creates a new channel with the specified width and height. Name, opacity, and color are also supplied parameters. The new channel still needs to be added to the image, as this is not automatic. Add the new channel with the 'gimp_image_add_channel' command. Other attributes such as channel show masked, should be set with explicit procedure calls. The channel's contents are undefined initially.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
IMAGE	image	The image to which to add the channel
INT32	width	The channel width: (0 < width)
INT32	height	The channel height: (0 < height)
STRING	name	The channel name
FLOAT	opacity	The channel opacity: (0 <= opacity <= 100)
COLOUR	color	The channel compositing color

RETURN VALUES

TYPE	NAME	DESCRIPTION
CHANNEL	channel	The newly created channel

SOME SYNTAX ALTERNATIVES

channel = $image->channel_new (width,height,name,opacity,color)

AUTHOR

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