Function

Gimpedit_named_cut

since: 2.4

Declaration [src] 

gchar*
gimp_edit_named_cut (
  gint num_drawables,
  const GimpItem** drawables,
  const gchar* buffer_name
)

Description [src]

Cut into a named buffer.

This procedure works like gimp_edit_cut(), but additionally stores the cut buffer into a named buffer that will stay available for later pasting, regardless of any intermediate copy or cut operations.

Available since: 2.4

Parameters

num_drawables

Type: gint

The number of drawables.

drawables

Type: An array of None

The drawables to cut from.

The length of the array is specified in the num_drawables argument.
The data is owned by the caller of the function.
buffer_name

Type: const gchar*

The name of the buffer to create.

The data is owned by the caller of the function.
The value is a NUL terminated UTF-8 string.

Return value

Type: gchar*

     The real name given to the buffer, or NULL if the cut failed.
     The returned value must be freed with g_free().
The caller of the function takes ownership of the data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.