Constructor
GimpGroupLayernew
since: 3.0
Declaration [src]
GimpGroupLayer*
gimp_group_layer_new (
GimpImage* image,
const gchar* name
)
Description [src]
Create a new group layer.
This procedure creates a new group layer with a given name. If name is
NULL, GIMP will choose a name using its default layer name algorithm.
The new group layer still needs to be added to the image, as this is
not automatic. Add the new layer with the gimp_image_insert_layer() method.
Other attributes such as layer mask modes, and offsets should be set with explicit procedure calls.
Available since: 3.0
Parameters
image-
Type:
GimpImageThe image to which to add the layer.
The data is owned by the caller of the function. name-
Type:
const gchar*The group layer name.
The argument can be NULL.The data is owned by the caller of the function. The value is a NUL terminated UTF-8 string.
Return value
Type: GimpGroupLayer
The newly created group layer. The object belongs to libgimp and you should not free it.
| The data is owned by the called function. |