gimp-item-transform-perspective

Michael Natterer <mitch@gimp.org>

Description

Perform a possibly non-affine transformation on the specified item.

Help

This procedure performs a possibly non-affine transformation on the specified item by allowing the corners of the original bounding box to be arbitrarily remapped to any values. The specified item is remapped if no selection exists or it is not a drawable. However, if a selection exists and the item is a drawable, 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 return value is the ID of the remapped item. If there was no selection or the item is not a drawable, this will be equal to the item 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 item will appear to have been projected via a perspective transform. This procedure is affected by the following context setters: 'gimp-context-set-interpolation', 'gimp-context-set-transform-direction', 'gimp-context-set-transform-resize'.


Type

unknown

Parameters

Type Name Description
unknown item The affected item
PF_FLOAT x0 The new x coordinate of upper-left corner of original bounding box
PF_FLOAT y0 The new y coordinate of upper-left corner of original bounding box
PF_FLOAT x1 The new x coordinate of upper-right corner of original bounding box
PF_FLOAT y1 The new y coordinate of upper-right corner of original bounding box
PF_FLOAT x2 The new x coordinate of lower-left corner of original bounding box
PF_FLOAT y2 The new y coordinate of lower-left corner of original bounding box
PF_FLOAT x3 The new x coordinate of lower-right corner of original bounding box
PF_FLOAT y3 The new y coordinate of lower-right corner of original bounding box

Return

Type Name Description
unknown item The newly mapped item