/* LIBGIMP - The GIMP Library
 * Copyright (C) 1995-2003 Peter Mattis and Spencer Kimball
 *
 * gimpdrawabletransform_pdb.c
 *
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2 of the License, or (at your option) any later version.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the
 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
 * Boston, MA 02111-1307, USA.
 */

/* NOTE: This file is autogenerated by pdbgen.pl */

#include "config.h"

#include "gimp.h"

/**
 * gimp_drawable_transform_flip_simple:
 * @drawable_ID: The affected drawable.
 * @flip_type: Type of flip.
 * @auto_center: Whether to automatically position the axis in the selection center.
 * @axis: coord. of flip axis.
 * @clip_result: Whether to clip results.
 *
 * Flip the specified drawable either vertically or horizontally.
 *
 * This procedure flips 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 flipped. If auto_center is set to true, the
 * flip is around the selection's center. Otherwise, the coordinate of
 * the axis needs to be specified. The return value is the ID of the
 * flipped 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 flipped drawable.
 *
 * Returns: The flipped drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_flip_simple (gint32              drawable_ID,
				     GimpOrientationType flip_type,
				     gboolean            auto_center,
				     gdouble             axis,
				     gboolean            clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_flip_simple",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_INT32, flip_type,
				    GIMP_PDB_INT32, auto_center,
				    GIMP_PDB_FLOAT, axis,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_flip:
 * @drawable_ID: The affected drawable.
 * @x0: horz. coord. of one end of axis.
 * @y0: vert. coord. of one end of axis.
 * @x1: horz. coord. of other end of axis.
 * @y1: vert. coord. of other end of axis.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Flip the specified drawable around a given line.
 *
 * This procedure flips 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 flipped. The axis to flip around is
 * specified by specifying two points from that line. The return value
 * is the ID of the flipped 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 flipped drawable. The clip results
 * parameter specifies wheter current selection will affect the
 * transform.
 *
 * Returns: The flipped drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_flip (gint32                 drawable_ID,
			      gdouble                x0,
			      gdouble                y0,
			      gdouble                x1,
			      gdouble                y1,
			      GimpTransformDirection transform_direction,
			      GimpInterpolationType  interpolation,
			      gboolean               supersample,
			      gint                   recursion_level,
			      gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_flip",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_flip_default:
 * @drawable_ID: The affected drawable.
 * @x0: horz. coord. of one end of axis.
 * @y0: vert. coord. of one end of axis.
 * @x1: horz. coord. of other end of axis.
 * @y1: vert. coord. of other end of axis.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Flip the specified drawable around a given line.
 *
 * This procedure is a variant of gimp_drawable_transform_flip() which
 * uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The flipped drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_flip_default (gint32   drawable_ID,
				      gdouble  x0,
				      gdouble  y0,
				      gdouble  x1,
				      gdouble  y1,
				      gboolean interpolate,
				      gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_flip_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_perspective:
 * @drawable_ID: The affected drawable.
 * @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.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Perform a possibly non-affine transformation on the specified
 * drawable, with extra parameters.
 *
 * This procedure 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 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.
 *
 * Returns: The newly mapped drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_perspective (gint32                 drawable_ID,
				     gdouble                x0,
				     gdouble                y0,
				     gdouble                x1,
				     gdouble                y1,
				     gdouble                x2,
				     gdouble                y2,
				     gdouble                x3,
				     gdouble                y3,
				     GimpTransformDirection transform_direction,
				     GimpInterpolationType  interpolation,
				     gboolean               supersample,
				     gint                   recursion_level,
				     gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_perspective",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_FLOAT, x2,
				    GIMP_PDB_FLOAT, y2,
				    GIMP_PDB_FLOAT, x3,
				    GIMP_PDB_FLOAT, y3,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_perspective_default:
 * @drawable_ID: The affected drawable.
 * @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.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Perform a possibly non-affine transformation on the specified
 * drawable, with extra parameters.
 *
 * This procedure is a variant of gimp_drawable_transform_perspective()
 * which uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The newly mapped drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_perspective_default (gint32   drawable_ID,
					     gdouble  x0,
					     gdouble  y0,
					     gdouble  x1,
					     gdouble  y1,
					     gdouble  x2,
					     gdouble  y2,
					     gdouble  x3,
					     gdouble  y3,
					     gboolean interpolate,
					     gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_perspective_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_FLOAT, x2,
				    GIMP_PDB_FLOAT, y2,
				    GIMP_PDB_FLOAT, x3,
				    GIMP_PDB_FLOAT, y3,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_rotate_simple:
 * @drawable_ID: The affected drawable.
 * @rotate_type: Type of rotation.
 * @auto_center: Whether to automatically rotate around the selection center.
 * @center_x: The hor. coordinate of the center of rotation.
 * @center_y: The vert. coordinate of the center of rotation.
 * @clip_result: Whether to clip results.
 *
 * Rotate the specified drawable about given coordinates through the
 * specified angle.
 *
 * This function rotates 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 rotated by the specified amount. 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 rotated drawable.
 *
 * Returns: The rotated drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_rotate_simple (gint32           drawable_ID,
				       GimpRotationType rotate_type,
				       gboolean         auto_center,
				       gint             center_x,
				       gint             center_y,
				       gboolean         clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_rotate_simple",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_INT32, rotate_type,
				    GIMP_PDB_INT32, auto_center,
				    GIMP_PDB_INT32, center_x,
				    GIMP_PDB_INT32, center_y,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_rotate:
 * @drawable_ID: The affected drawable.
 * @angle: The angle of rotation (radians).
 * @auto_center: Whether to automatically rotate around the selection center.
 * @center_x: The hor. coordinate of the center of rotation.
 * @center_y: The vert. coordinate of the center of rotation.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Rotate the specified drawable about given coordinates through the
 * specified angle.
 *
 * This function rotates 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 rotated by the specified amount. 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 rotated drawable.
 *
 * Returns: The rotated drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_rotate (gint32                 drawable_ID,
				gdouble                angle,
				gboolean               auto_center,
				gint                   center_x,
				gint                   center_y,
				GimpTransformDirection transform_direction,
				GimpInterpolationType  interpolation,
				gboolean               supersample,
				gint                   recursion_level,
				gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_rotate",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, angle,
				    GIMP_PDB_INT32, auto_center,
				    GIMP_PDB_INT32, center_x,
				    GIMP_PDB_INT32, center_y,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_rotate_default:
 * @drawable_ID: The affected drawable.
 * @angle: The angle of rotation (radians).
 * @auto_center: Whether to automatically rotate around the selection center.
 * @center_x: The hor. coordinate of the center of rotation.
 * @center_y: The vert. coordinate of the center of rotation.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Rotate the specified drawable about given coordinates through the
 * specified angle.
 *
 * This procedure is a variant of gimp_drawable_transform_rotate()
 * which uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The rotated drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_rotate_default (gint32   drawable_ID,
					gdouble  angle,
					gboolean auto_center,
					gint     center_x,
					gint     center_y,
					gboolean interpolate,
					gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_rotate_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, angle,
				    GIMP_PDB_INT32, auto_center,
				    GIMP_PDB_INT32, center_x,
				    GIMP_PDB_INT32, center_y,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_scale:
 * @drawable_ID: The affected drawable.
 * @x0: The new x coordinate of upper-left corner of newly scaled region.
 * @y0: The new y coordinate of upper-left corner of newly scaled region.
 * @x1: The new x coordinate of lower-right corner of newly scaled region.
 * @y1: The new y coordinate of lower-right corner of newly scaled region.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Scale the specified drawable with extra parameters
 *
 * This procedure scales 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 scaled by the specified amount. The return
 * value is the ID of the scaled 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 scaled drawable.
 *
 * Returns: The scaled drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_scale (gint32                 drawable_ID,
			       gdouble                x0,
			       gdouble                y0,
			       gdouble                x1,
			       gdouble                y1,
			       GimpTransformDirection transform_direction,
			       GimpInterpolationType  interpolation,
			       gboolean               supersample,
			       gint                   recursion_level,
			       gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_scale",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_scale_default:
 * @drawable_ID: The affected drawable.
 * @x0: The new x coordinate of upper-left corner of newly scaled region.
 * @y0: The new y coordinate of upper-left corner of newly scaled region.
 * @x1: The new x coordinate of lower-right corner of newly scaled region.
 * @y1: The new y coordinate of lower-right corner of newly scaled region.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Scale the specified drawable with extra parameters
 *
 * This procedure is a variant of gimp_drawable_transform_scale() which
 * uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The scaled drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_scale_default (gint32   drawable_ID,
				       gdouble  x0,
				       gdouble  y0,
				       gdouble  x1,
				       gdouble  y1,
				       gboolean interpolate,
				       gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_scale_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, x0,
				    GIMP_PDB_FLOAT, y0,
				    GIMP_PDB_FLOAT, x1,
				    GIMP_PDB_FLOAT, y1,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_shear:
 * @drawable_ID: The affected drawable.
 * @shear_type: Type of shear.
 * @magnitude: The magnitude of the shear.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Shear the specified drawable about its center by the specified
 * magnitude, with extra parameters.
 *
 * This procedure 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 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.
 *
 * Returns: The sheared drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_shear (gint32                 drawable_ID,
			       GimpOrientationType    shear_type,
			       gdouble                magnitude,
			       GimpTransformDirection transform_direction,
			       GimpInterpolationType  interpolation,
			       gboolean               supersample,
			       gint                   recursion_level,
			       gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_shear",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_INT32, shear_type,
				    GIMP_PDB_FLOAT, magnitude,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_shear_default:
 * @drawable_ID: The affected drawable.
 * @shear_type: Type of shear.
 * @magnitude: The magnitude of the shear.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Shear the specified drawable about its center by the specified
 * magnitude, with extra parameters.
 *
 * This procedure is a variant of gimp_drawable_transform_shear() which
 * uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The sheared drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_shear_default (gint32              drawable_ID,
				       GimpOrientationType shear_type,
				       gdouble             magnitude,
				       gboolean            interpolate,
				       gboolean            clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_shear_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_INT32, shear_type,
				    GIMP_PDB_FLOAT, magnitude,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_2d:
 * @drawable_ID: The affected drawable.
 * @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 center goes.
 * @dest_y: Y coordinate of where the center goes.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Transform the specified drawable in 2d, with extra parameters.
 *
 * This procedure 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 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.
 *
 * Returns: The transformed drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_2d (gint32                 drawable_ID,
			    gdouble                source_x,
			    gdouble                source_y,
			    gdouble                scale_x,
			    gdouble                scale_y,
			    gdouble                angle,
			    gdouble                dest_x,
			    gdouble                dest_y,
			    GimpTransformDirection transform_direction,
			    GimpInterpolationType  interpolation,
			    gboolean               supersample,
			    gint                   recursion_level,
			    gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_2d",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, source_x,
				    GIMP_PDB_FLOAT, source_y,
				    GIMP_PDB_FLOAT, scale_x,
				    GIMP_PDB_FLOAT, scale_y,
				    GIMP_PDB_FLOAT, angle,
				    GIMP_PDB_FLOAT, dest_x,
				    GIMP_PDB_FLOAT, dest_y,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_2d_default:
 * @drawable_ID: The affected drawable.
 * @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 center goes.
 * @dest_y: Y coordinate of where the center goes.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Transform the specified drawable in 2d, with extra parameters.
 *
 * This procedure is a variant of gimp_drawable_transform_2d() which
 * uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The transformed drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_2d_default (gint32   drawable_ID,
				    gdouble  source_x,
				    gdouble  source_y,
				    gdouble  scale_x,
				    gdouble  scale_y,
				    gdouble  angle,
				    gdouble  dest_x,
				    gdouble  dest_y,
				    gboolean interpolate,
				    gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_2d_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, source_x,
				    GIMP_PDB_FLOAT, source_y,
				    GIMP_PDB_FLOAT, scale_x,
				    GIMP_PDB_FLOAT, scale_y,
				    GIMP_PDB_FLOAT, angle,
				    GIMP_PDB_FLOAT, dest_x,
				    GIMP_PDB_FLOAT, dest_y,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_matrix:
 * @drawable_ID: The affected drawable.
 * @coeff_0_0: coefficient (0,0) of the transformation matrix.
 * @coeff_0_1: coefficient (0,1) of the transformation matrix.
 * @coeff_0_2: coefficient (0,2) of the transformation matrix.
 * @coeff_1_0: coefficient (1,0) of the transformation matrix.
 * @coeff_1_1: coefficient (1,1) of the transformation matrix.
 * @coeff_1_2: coefficient (1,2) of the transformation matrix.
 * @coeff_2_0: coefficient (2,0) of the transformation matrix.
 * @coeff_2_1: coefficient (2,1) of the transformation matrix.
 * @coeff_2_2: coefficient (2,2) of the transformation matrix.
 * @transform_direction: Direction of Transformation.
 * @interpolation: Type of interpolation.
 * @supersample: Whether to perform supersample.
 * @recursion_level: Level of recursion (3 is a nice default).
 * @clip_result: Whether to clip results.
 *
 * Transform the specified drawable in 2d, with extra parameters.
 *
 * This procedure 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 transformation is
 * done by assembling a 3x3 matrix from the coefficients passed. 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.
 *
 * Returns: The transformed drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_matrix (gint32                 drawable_ID,
				gdouble                coeff_0_0,
				gdouble                coeff_0_1,
				gdouble                coeff_0_2,
				gdouble                coeff_1_0,
				gdouble                coeff_1_1,
				gdouble                coeff_1_2,
				gdouble                coeff_2_0,
				gdouble                coeff_2_1,
				gdouble                coeff_2_2,
				GimpTransformDirection transform_direction,
				GimpInterpolationType  interpolation,
				gboolean               supersample,
				gint                   recursion_level,
				gboolean               clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_matrix",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, coeff_0_0,
				    GIMP_PDB_FLOAT, coeff_0_1,
				    GIMP_PDB_FLOAT, coeff_0_2,
				    GIMP_PDB_FLOAT, coeff_1_0,
				    GIMP_PDB_FLOAT, coeff_1_1,
				    GIMP_PDB_FLOAT, coeff_1_2,
				    GIMP_PDB_FLOAT, coeff_2_0,
				    GIMP_PDB_FLOAT, coeff_2_1,
				    GIMP_PDB_FLOAT, coeff_2_2,
				    GIMP_PDB_INT32, transform_direction,
				    GIMP_PDB_INT32, interpolation,
				    GIMP_PDB_INT32, supersample,
				    GIMP_PDB_INT32, recursion_level,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}

/**
 * gimp_drawable_transform_matrix_default:
 * @drawable_ID: The affected drawable.
 * @coeff_0_0: coefficient (0,0) of the transformation matrix.
 * @coeff_0_1: coefficient (0,1) of the transformation matrix.
 * @coeff_0_2: coefficient (0,2) of the transformation matrix.
 * @coeff_1_0: coefficient (1,0) of the transformation matrix.
 * @coeff_1_1: coefficient (1,1) of the transformation matrix.
 * @coeff_1_2: coefficient (1,2) of the transformation matrix.
 * @coeff_2_0: coefficient (2,0) of the transformation matrix.
 * @coeff_2_1: coefficient (2,1) of the transformation matrix.
 * @coeff_2_2: coefficient (2,2) of the transformation matrix.
 * @interpolate: Whether to use interpolation and supersampling.
 * @clip_result: Whether to clip results.
 *
 * Transform the specified drawable in 2d, with extra parameters.
 *
 * This procedure is a variant of gimp_drawable_transform_matrix()
 * which uses no interpolation/supersampling at all, or default values
 * (depending on the 'interpolate' parameter).
 *
 * Returns: The transformed drawable.
 *
 * Since: GIMP 2.2
 */
gint32
gimp_drawable_transform_matrix_default (gint32   drawable_ID,
					gdouble  coeff_0_0,
					gdouble  coeff_0_1,
					gdouble  coeff_0_2,
					gdouble  coeff_1_0,
					gdouble  coeff_1_1,
					gdouble  coeff_1_2,
					gdouble  coeff_2_0,
					gdouble  coeff_2_1,
					gdouble  coeff_2_2,
					gboolean interpolate,
					gboolean clip_result)
{
  GimpParam *return_vals;
  gint nreturn_vals;
  gint32 ret_drawable_ID = -1;

  return_vals = gimp_run_procedure ("gimp_drawable_transform_matrix_default",
				    &nreturn_vals,
				    GIMP_PDB_DRAWABLE, drawable_ID,
				    GIMP_PDB_FLOAT, coeff_0_0,
				    GIMP_PDB_FLOAT, coeff_0_1,
				    GIMP_PDB_FLOAT, coeff_0_2,
				    GIMP_PDB_FLOAT, coeff_1_0,
				    GIMP_PDB_FLOAT, coeff_1_1,
				    GIMP_PDB_FLOAT, coeff_1_2,
				    GIMP_PDB_FLOAT, coeff_2_0,
				    GIMP_PDB_FLOAT, coeff_2_1,
				    GIMP_PDB_FLOAT, coeff_2_2,
				    GIMP_PDB_INT32, interpolate,
				    GIMP_PDB_INT32, clip_result,
				    GIMP_PDB_END);

  if (return_vals[0].data.d_status == GIMP_PDB_SUCCESS)
    ret_drawable_ID = return_vals[1].data.d_drawable;

  gimp_destroy_params (return_vals, nreturn_vals);

  return ret_drawable_ID;
}