![]() | ![]() | ![]() | GIMP Library Reference Manual | ![]() |
---|
gimpdrawabletransform —
gint32 gimp_drawable_transform_flip (gint32 drawable_ID, GimpOrientationType flip_type, gboolean center, gdouble axis, GimpTransformDirection transform_direction, GimpInterpolationType interpolation, gboolean supersample, gint recursion_level, gboolean clip_result); gint32 gimp_drawable_transform_flip_free (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_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_rotate (gint32 drawable_ID, gdouble angle, gint center_x, gint center_y, GimpTransformDirection transform_direction, GimpInterpolationType interpolation, gboolean supersample, gint recursion_level, 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_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_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_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_flip (gint32 drawable_ID, GimpOrientationType flip_type, gboolean center, gdouble axis, GimpTransformDirection transform_direction, GimpInterpolationType interpolation, gboolean supersample, gint recursion_level, 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 center is set to true, the flip is around the image 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. |
center : | Whether to automatically position the axis in the image center. |
axis : | coord. of flip 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_free (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_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_rotate (gint32 drawable_ID, gdouble angle, 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). |
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_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_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_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_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
<< gimpdrawable | gimpedit >> |