gimp_perspective (1995-1996)

NAME

gimp_perspective - Perform a possibly non-affine transformation on the specified drawable.

SYNOPSIS

drawable = gimp_perspective (drawable,interpolation,x0,y0,x1,y1,x2,y2,x3,y3)

DESCRIPTION

This tool performs a possibly non-affine transformation on the specified drawable by allowing the corners of the original bounding box to be arbitrarily remapped to any values. The specified drawable is remapped if no selection exists. However, 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 remapped as specified. The interpolation parameter can be set to TRUE to indicate that either linear or cubic interpolation should be used to smooth the resulting remapped drawable. The return value is the ID of the remapped 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 remapped drawable. The 4 coordinates specify the new locations of each corner of the original bounding box. By specifying these values, any affine transformation (rotation, scaling, translation) can be affected. Additionally,these values can be specified such that the resulting transformed drawable will appear to have been projected via a perspective transform.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
INT32	interpolation	Whether to use interpolation
FLOAT	x0	The new x coordinate of upper-left corner of original bounding box
FLOAT	y0	The new y coordinate of upper-left corner of original bounding box
FLOAT	x1	The new x coordinate of upper-right corner of original bounding box
FLOAT	y1	The new y coordinate of upper-right corner of original bounding box
FLOAT	x2	The new x coordinate of lower-left corner of original bounding box
FLOAT	y2	The new y coordinate of lower-left corner of original bounding box
FLOAT	x3	The new x coordinate of lower-right corner of original bounding box
FLOAT	y3	The new y coordinate of lower-right corner of original bounding box

RETURN VALUES

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The newly mapped drawable

SOME SYNTAX ALTERNATIVES

drawable = $drawable->perspective (interpolation,x0,y0,x1,y1,x2,y2,x3,y3)

AUTHOR

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