gimp_shear (1995-1996)

NAME

gimp_shear - Shear the specified drawable about its center by the specified magnitude.

SYNOPSIS

drawable = gimp_shear (drawable,interpolation,shear_type,magnitude)

DESCRIPTION

This tool shears 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 sheard by the specified amount. The interpolation parameter can be set to TRUE to indicate that either linear or cubic interpolation should be used to smooth the resulting sheared drawable. The return value is the ID of the sheard 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 sheard drawable. The shear type parameter indicates whether the shear will be applied horizontally or vertically. The magnitude can be either positive or negative and indicates the extent (in pixels) to shear by.

INPUT ARGUMENTS

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The affected drawable
INT32	interpolation	Whether to use interpolation
INT32	shear_type	Type of shear: HORIZONTAL (0) or VERTICAL (1)
FLOAT	magnitude	The magnitude of the shear

RETURN VALUES

TYPE	NAME	DESCRIPTION
DRAWABLE	drawable	The sheared drawable

SOME SYNTAX ALTERNATIVES

drawable = $drawable->shear (interpolation,shear_type,magnitude)

AUTHOR

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