gimp_clone (1995-1996)

NAME

gimp_clone - Clone from the source to the dest drawable using the current brush

SYNOPSIS

gimp_clone (drawable,src_drawable,clone_type,src_x,src_y,num_strokes,strokes)

DESCRIPTION

This tool clones (copies) from the source drawable starting at the specified source coordinates to the dest drawable. If the "clone_type" argument is set to PATTERN-CLONE, then the current pattern is used as the source and the "src_drawable" argument is ignored. Pattern cloning assumes a tileable pattern and mods the sum of the src coordinates and subsequent stroke offsets with the width and height of the pattern. For image cloning, if the sum of the src coordinates and subsequent stroke offsets exceeds the extents of the src drawable, then no paint is transferred. The clone tool is capable of transforming between any image types including RGB->Indexed--although converting from any type to indexed is significantly slower.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
DRAWABLE	src_drawable	The source drawable
INT32	clone_type	The type of clone: { IMAGE_CLONE (0), PATTERN_CLONE (1) }
FLOAT	src_x	The x coordinate in the source image
FLOAT	src_y	The y coordinate in the source image
INT32	num_strokes	Number of stroke control points (count each coordinate as 2 points)
FLOATARRAY	strokes	Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, ..., sn.x, sn.y }

SOME SYNTAX ALTERNATIVES

$drawable->clone (src_drawable,clone_type,src_x,src_y,strokes)

AUTHOR

Spencer Kimball & Peter Mattis
(c)1995-1996 Spencer Kimball & Peter Mattis