gimp-edit-paste

Spencer Kimball & Peter Mattis

Description

Paste buffer to the specified drawable.

Help

This procedure pastes a copy of the internal GIMP edit buffer to the specified drawable. The GIMP edit buffer will be empty unless a call was previously made to either 'gimp-edit-cut' or 'gimp-edit-copy'. The "paste_into" option specifies whether to clear the current image selection, or to paste the buffer "behind" the selection. This allows the selection to act as a mask for the pasted buffer. Anywhere that the selection mask is non-zero, the pasted buffer will show through. The pasted buffer will be a new layer in the image which is designated as the image floating selection. If the image has a floating selection at the time of pasting, the old floating selection will be anchored to it's drawable before the new floating selection is added. This procedure returns the new floating layer. The resulting floating selection will already be attached to the specified drawable, and a subsequent call to floating_sel_attach is not needed.


Type

unknown

Parameters

Type Name Description
PF_DRAWABLE drawable The drawable to paste to
PF_INT paste-into Clear selection, or paste behind it? (TRUE or FALSE)

Return

Type Name Description
PF_LAYER floating-sel The new floating selection