## gimptransformtools

gimptransformtools — Access to toolbox transform tools.

## Synopsis

    gint32              gimp_flip                           (gint32 drawable_ID,
                                                             GimpOrientationType flip_type);
    gint32              gimp_perspective                    (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble x0,
                                                             gdouble y0,
                                                             gdouble x1,
                                                             gdouble y1,
                                                             gdouble x2,
                                                             gdouble y2,
                                                             gdouble x3,
                                                             gdouble y3);
    gint32              gimp_rotate                         (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble angle);
    gint32              gimp_scale                          (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble x0,
                                                             gdouble y0,
                                                             gdouble x1,
                                                             gdouble y1);
    gint32              gimp_shear                          (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             GimpOrientationType shear_type,
                                                             gdouble magnitude);
    gint32              gimp_transform_2d                   (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble source_x,
                                                             gdouble source_y,
                                                             gdouble scale_x,
                                                             gdouble scale_y,
                                                             gdouble angle,
                                                             gdouble dest_x,
                                                             gdouble dest_y);

## Description

Functions giving access to toolbox transform tools.

## Details

### gimp_flip ()

    gint32              gimp_flip                           (gint32 drawable_ID,
                                                             GimpOrientationType flip_type);

### Warning

`gimp_flip` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_flip_simple()` instead.

`drawable_ID` : | The affected drawable.
`flip_type` : | Type of flip.
Returns : | The flipped drawable.

### gimp_perspective ()

    gint32              gimp_perspective                    (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble x0,
                                                             gdouble y0,
                                                             gdouble x1,
                                                             gdouble y1,
                                                             gdouble x2,
                                                             gdouble y2,
                                                             gdouble x3,
                                                             gdouble y3);

### Warning

`gimp_perspective` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_perspective()` instead.

`drawable_ID` : | The affected drawable.
`interpolation` : | Whether to use interpolation.
`x0` : | The new x coordinate of upper-left corner of original bounding box.
`y0` : | The new y coordinate of upper-left corner of original bounding box.
`x1` : | The new x coordinate of upper-right corner of original bounding box.
`y1` : | The new y coordinate of upper-right corner of original bounding box.
`x2` : | The new x coordinate of lower-left corner of original bounding box.
`y2` : | The new y coordinate of lower-left corner of original bounding box.
`x3` : | The new x coordinate of lower-right corner of original bounding box.
`y3` : | The new y coordinate of lower-right corner of original bounding box.
Returns : | The newly mapped drawable.

### gimp_rotate ()

    gint32              gimp_rotate                         (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble angle);

### Warning

`gimp_rotate` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_rotate()` instead.

`drawable_ID` : | The affected drawable.
`interpolation` : | Whether to use interpolation.
`angle` : | The angle of rotation (radians).
Returns : | The rotated drawable.

### gimp_scale ()

    gint32              gimp_scale                          (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble x0,
                                                             gdouble y0,
                                                             gdouble x1,
                                                             gdouble y1);

### Warning

`gimp_scale` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_scale()` instead.

`drawable_ID` : | The affected drawable.
`interpolation` : | Whether to use interpolation.
`x0` : | The new x coordinate of the upper-left corner of the scaled region.
`y0` : | The new y coordinate of the upper-left corner of the scaled region.
`x1` : | The new x coordinate of the lower-right corner of the scaled region.
`y1` : | The new y coordinate of the lower-right corner of the scaled region.
Returns : | The scaled drawable.

### gimp_shear ()

    gint32              gimp_shear                          (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             GimpOrientationType shear_type,
                                                             gdouble magnitude);

### Warning

`gimp_shear` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_shear()` instead.

`drawable_ID` : | The affected drawable.
`interpolation` : | Whether to use interpolation.
`shear_type` : | Type of shear.
`magnitude` : | The magnitude of the shear.
Returns : | The sheared drawable.

### gimp_transform_2d ()

    gint32              gimp_transform_2d                   (gint32 drawable_ID,
                                                             gboolean interpolation,
                                                             gdouble source_x,
                                                             gdouble source_y,
                                                             gdouble scale_x,
                                                             gdouble scale_y,
                                                             gdouble angle,
                                                             gdouble dest_x,
                                                             gdouble dest_y);

### Warning

`gimp_transform_2d` is deprecated and should not be used in newly-written code. Use `gimp_item_transform_2d()` instead.

`drawable_ID` : | The affected drawable.
`interpolation` : | Whether to use interpolation.
`source_x` : | X coordinate of the transformation center.
`source_y` : | Y coordinate of the transformation center.
`scale_x` : | Amount to scale in x direction.
`scale_y` : | Amount to scale in y direction.
`angle` : | The angle of rotation (radians).
`dest_x` : | X coordinate of where the centre goes.
`dest_y` : | Y coordinate of where the centre goes.
Returns : | The transformed drawable.