|
|
|
GIMP Library Reference Manual | |
|---|---|---|---|---|
gint32 gimp_drawable_transform_flip_simple (gint32 drawable_ID, GimpOrientationType flip_type, gboolean auto_center, gdouble axis, gboolean clip_result); 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); gint32 gimp_drawable_transform_flip_default (gint32 drawable_ID, gdouble x0, gdouble y0, gdouble x1, gdouble y1, gboolean interpolate, gboolean clip_result); 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); 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); gint32 gimp_drawable_transform_rotate_simple (gint32 drawable_ID, GimpRotationType rotate_type, gboolean auto_center, gint center_x, gint center_y, gboolean clip_result); 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); 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); 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); gint32 gimp_drawable_transform_scale_default (gint32 drawable_ID, gdouble x0, gdouble y0, gdouble x1, gdouble y1, gboolean interpolate, gboolean clip_result); 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); gint32 gimp_drawable_transform_shear_default (gint32 drawable_ID, GimpOrientationType shear_type, gdouble magnitude, gboolean interpolate, gboolean clip_result); 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); 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); 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); 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);
gint32 gimp_drawable_transform_flip_simple
(gint32 drawable_ID,
GimpOrientationType flip_type,
gboolean auto_center,
gdouble axis,
gboolean clip_result);
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.
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. |
| 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The flipped 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The newly mapped 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);
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.
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. |
| 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The rotated 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The scaled 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The sheared 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);
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.
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. |
| 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);
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).
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. |
| 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);
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.
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. |
| 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);
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).
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. |
| Returns : | The transformed drawable. |
Since GIMP 2.2