gimpdrawabletransform: GIMP Library Reference Manual

+ + +

gimpdrawabletransform

gimpdrawabletransform — Functions to perform transformatrions on drawables.

Functions

++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

+gint32 +	+gimp_drawable_transform_flip_simple () +
+gint32 +	+gimp_drawable_transform_flip () +
+gint32 +	+gimp_drawable_transform_flip_default () +
+gint32 +	+gimp_drawable_transform_perspective () +
+gint32 +	+gimp_drawable_transform_perspective_default () +
+gint32 +	+gimp_drawable_transform_rotate_simple () +
+gint32 +	+gimp_drawable_transform_rotate () +
+gint32 +	+gimp_drawable_transform_rotate_default () +
+gint32 +	+gimp_drawable_transform_scale () +
+gint32 +	+gimp_drawable_transform_scale_default () +
+gint32 +	+gimp_drawable_transform_shear () +
+gint32 +	+gimp_drawable_transform_shear_default () +
+gint32 +	+gimp_drawable_transform_2d () +
+gint32 +	+gimp_drawable_transform_2d_default () +
+gint32 +	+gimp_drawable_transform_matrix () +
+gint32 +	+gimp_drawable_transform_matrix_default () +

Description

Functions to perform transformatrions on drawables.

Functions

gimp_drawable_transform_flip_simple ()

gint32
+gimp_drawable_transform_flip_simple (gint32 drawable_ID,
+                                     GimpOrientationType flip_type,
+                                     gboolean auto_center,
+                                     gdouble axis,
+                                     gboolean clip_result);

gimp_drawable_transform_flip_simple is deprecated and should not be used in newly-written code.

Use gimp_item_transform_flip_simple() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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: 2.2

gimp_drawable_transform_flip ()

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);

gimp_drawable_transform_flip is deprecated and should not be used in newly-written code.

Use gimp_item_transform_flip() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	Whether to clip results.

Returns

The flipped drawable.

Since: 2.2

gimp_drawable_transform_flip_default ()

gint32
+gimp_drawable_transform_flip_default (gint32 drawable_ID,
+                                      gdouble x0,
+                                      gdouble y0,
+                                      gdouble x1,
+                                      gdouble y1,
+                                      gboolean interpolate,
+                                      gboolean clip_result);

gimp_drawable_transform_flip_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_flip() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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: 2.2

gimp_drawable_transform_perspective ()

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,
+                                     GimpTransformResize clip_result);

gimp_drawable_transform_perspective is deprecated and should not be used in newly-written code.

Use gimp_item_transform_perspective() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The newly mapped drawable.

Since: 2.2

gimp_drawable_transform_perspective_default ()

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,
+                                GimpTransformResize clip_result);

gimp_drawable_transform_perspective_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_perspective() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	How to clip results.

Returns

The newly mapped drawable.

Since: 2.2

gimp_drawable_transform_rotate_simple ()

gint32
+gimp_drawable_transform_rotate_simple (gint32 drawable_ID,
+                                       GimpRotationType rotate_type,
+                                       gboolean auto_center,
+                                       gint center_x,
+                                       gint center_y,
+                                       gboolean clip_result);

gimp_drawable_transform_rotate_simple is deprecated and should not be used in newly-written code.

Use gimp_item_transform_rotate_simple() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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: 2.2

gimp_drawable_transform_rotate ()

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,
+                                GimpTransformResize clip_result);

gimp_drawable_transform_rotate is deprecated and should not be used in newly-written code.

Use gimp_item_transform_rotate() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The rotated drawable.

Since: 2.2

gimp_drawable_transform_rotate_default ()

gint32
+gimp_drawable_transform_rotate_default
+                               (gint32 drawable_ID,
+                                gdouble angle,
+                                gboolean auto_center,
+                                gint center_x,
+                                gint center_y,
+                                gboolean interpolate,
+                                GimpTransformResize clip_result);

gimp_drawable_transform_rotate_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_rotate() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	How to clip results.

Returns

The rotated drawable.

Since: 2.2

gimp_drawable_transform_scale ()

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,
+                               GimpTransformResize clip_result);

gimp_drawable_transform_scale is deprecated and should not be used in newly-written code.

Use gimp_item_transform_scale() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

drawable_ID	The affected drawable.
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.
transform_direction	Direction of transformation.
interpolation	Type of interpolation.
supersample	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The scaled drawable.

Since: 2.2

gimp_drawable_transform_scale_default ()

gint32
+gimp_drawable_transform_scale_default (gint32 drawable_ID,
+                                       gdouble x0,
+                                       gdouble y0,
+                                       gdouble x1,
+                                       gdouble y1,
+                                       gboolean interpolate,
+                                       GimpTransformResize clip_result);

gimp_drawable_transform_scale_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_scale() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

drawable_ID	The affected drawable.
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.
interpolate	Whether to use interpolation and supersampling.
clip_result	How to clip results.

Returns

The scaled drawable.

Since: 2.2

gimp_drawable_transform_shear ()

gint32
+gimp_drawable_transform_shear (gint32 drawable_ID,
+                               GimpOrientationType shear_type,
+                               gdouble magnitude,
+                               GimpTransformDirection transform_direction,
+                               GimpInterpolationType interpolation,
+                               gboolean supersample,
+                               gint recursion_level,
+                               GimpTransformResize clip_result);

gimp_drawable_transform_shear is deprecated and should not be used in newly-written code.

Use gimp_item_transform_shear() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The sheared drawable.

Since: 2.2

gimp_drawable_transform_shear_default ()

gint32
+gimp_drawable_transform_shear_default (gint32 drawable_ID,
+                                       GimpOrientationType shear_type,
+                                       gdouble magnitude,
+                                       gboolean interpolate,
+                                       GimpTransformResize clip_result);

gimp_drawable_transform_shear_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_shear() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	How to clip results.

Returns

The sheared drawable.

Since: 2.2

gimp_drawable_transform_2d ()

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,
+                            GimpTransformResize clip_result);

gimp_drawable_transform_2d is deprecated and should not be used in newly-written code.

Use gimp_item_transform_2d() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The transformed drawable.

Since: 2.2

gimp_drawable_transform_2d_default ()

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,
+                                    GimpTransformResize clip_result);

gimp_drawable_transform_2d_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_2d() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	How to clip results.

Returns

The transformed drawable.

Since: 2.2

gimp_drawable_transform_matrix ()

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,
+                                GimpTransformResize clip_result);

gimp_drawable_transform_matrix is deprecated and should not be used in newly-written code.

Use gimp_item_transform_matrix() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	This parameter is ignored.
recursion_level	This parameter is ignored.
clip_result	How to clip results.

Returns

The transformed drawable.

Since: 2.2

gimp_drawable_transform_matrix_default ()

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,
+                                GimpTransformResize clip_result);

gimp_drawable_transform_matrix_default is deprecated and should not be used in newly-written code.

Use gimp_item_transform_matrix() instead.

Parameters

+++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

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	How to clip results.

Returns

The transformed drawable.

Since: 2.2