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.
INPUT ARGUMENTS
TYPE
NAME
DESCRIPTION
DRAWABLE
drawable
The drawable to paste to
INT32
paste_into
Clear selection, or paste behind it?
RETURN VALUES
TYPE
NAME
DESCRIPTION
LAYER
floating_sel
The new floating selection
SOME SYNTAX ALTERNATIVES
floating_sel = $drawable->edit_paste (paste_into)
AUTHOR
Spencer Kimball & Peter Mattis (c)1995-1996 Spencer Kimball & Peter Mattis