Constructor
GimpChannelnew
Declaration [src]
GimpChannel*
gimp_channel_new (
GimpImage* image,
const gchar* name,
gint width,
gint height,
gdouble opacity,
GeglColor* color
)
Description [src]
Create a new channel.
This procedure creates a new channel with the specified width
,
height
, name
, opacity
and color
.
Other attributes, such as channel visibility, should be set with explicit procedure calls.
The new channel still needs to be added to the image, as this is not
automatic. Add the new channel with
gimp_image_insert_channel()
.
The channel’s contents are undefined initially.
Parameters
image
-
Type:
GimpImage
The image to which to add the channel.
The data is owned by the caller of the function. name
-
Type:
const gchar*
The channel name.
The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string. width
-
Type:
gint
The channel width.
height
-
Type:
gint
The channel height.
opacity
-
Type:
gdouble
The channel opacity.
color
-
Type:
GeglColor
The channel compositing color.
The data is owned by the caller of the function.
Return value
Type: GimpChannel
The newly created channel.
The data is owned by the called function. |