gimp_transform_2d (1995-1996)

NAME

gimp_transform_2d - Transform the specified drawable in 2d.

SYNOPSIS

drawable = gimp_transform_2d (drawable,interpolation,source_x,source_y,scale_x,scale_y,angle,dest_x,dest_y)

DESCRIPTION

This tool transforms the specified drawable if no selection exists. If a selection exists, the portion of the drawable which lies under the selection is cut from the drawable and made into a floating selection which is then transformed. The interpolation parameter can be set to TRUE to indicate that either linear or cubic interpolation should be used to smooth the resulting drawable. The transformation is done by scaling the image by the x and y scale factors about the point (source_x, source_y), then rotating around the same point, then translating that point to the new position (dest_x, dest_y). The return value is the ID of the rotated drawable. If there was no selection, this will be equal to the drawable ID supplied as input. Otherwise, this will be the newly created and transformed drawable.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
INT32	interpolation	Whether to use interpolation
FLOAT	source_x	X coordinate of the transformation center
FLOAT	source_y	Y coordinate of the transformation center
FLOAT	scale_x	Amount to scale in x direction
FLOAT	scale_y	Amount to scale in y direction
FLOAT	angle	The angle of rotation (radians)
FLOAT	dest_x	X coordinate of where the centre goes
FLOAT	dest_y	Y coordinate of where the centre goes

RETURN VALUES

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The transformed drawable

SOME SYNTAX ALTERNATIVES

drawable = $drawable->transform_2d (interpolation,source_x,source_y,scale_x,scale_y,angle,dest_x,dest_y)

AUTHOR

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