Gimp.GroupLayer.new
Description: Reference for Gimp.GroupLayer.new

### Constructor

# Gimp GroupLayernew

since: 2.8

#### 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.

Other procedures useful with group layers: `gimp_image_reorder_item()`, `gimp_item_get_parent()`, `gimp_item_get_children()`, `gimp_item_is_group()`.

Available since: 2.8

#### Parameters

`image`

  Type: `GimpImage`

  The image to which to add the group 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 data is owned by the called function.