Gimp.Channel.new
Description: Reference for Gimp.Channel.new

### Constructor

# Gimp Channelnew

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