Constructor

GimpLayernew_from_drawable

Declaration [src]

GimpLayer*
gimp_layer_new_from_drawable (
  GimpDrawable* drawable,
  GimpImage* dest_image
)

Description [src]

Create a new layer by copying an existing drawable.

This procedure creates a new layer as a copy of the specified drawable. The new layer still needs to be added to the image, as this is not automatic. Add the new layer with the gimp_image_insert_layer() command. Other attributes such as layer mask modes, and offsets should be set with explicit procedure calls.

Parameters

drawable GimpDrawable
 

The source drawable from where the new layer is copied.

 The data is owned by the caller of the function.
dest_image GimpImage
 

The destination image to which to add the layer.

 The data is owned by the caller of the function.

Return value

Returns: GimpLayer
 

The newly copied layer.

 The data is owned by the called function.