copy

Copy a layer.

This procedure copies the specified layer and returns the copy. The newly copied layer is for use within the original layer's image. It should not be subsequently added to any other image.

The new layer still needs to be added to the image as this is not automatic. Add the new layer with the [method@Image.insert_layer] method.

Other attributes such as layer mask and offsets should be set with explicit procedure calls.

Parameters:

this	The layer to copy.

Returns:

The newly copied layer. The object belongs to libgimp and you should not free it.