Function

Gimpclone

Declaration [src]

gboolean
gimp_clone (
  GimpDrawable* drawable,
  GimpDrawable* src_drawable,
  GimpCloneType clone_type,
  gdouble src_x,
  gdouble src_y,
  gint num_strokes,
  const gdouble* strokes
)

Description [src]

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

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.

Parameters

drawable

Type: GimpDrawable

The affected drawable.

The data is owned by the caller of the function.

src_drawable

Type: GimpDrawable

The source drawable.

The data is owned by the caller of the function.

clone_type

Type: GimpCloneType

The type of clone.

src_x

Type: gdouble

The x coordinate in the source image.

src_y

Type: gdouble

The y coordinate in the source image.

num_strokes

Type: gint

Number of stroke control points (count each coordinate as 2 points).

strokes

Type: An array of double

Array of stroke coordinates: { s1.x, s1.y, s2.x, s2.y, …, sn.x, sn.y }.

The length of the array is specified in the num_strokes argument.

The data is owned by the caller of the function.

Return value

Type: gboolean

TRUE on success.