gimpimagetransform: GIMP Library Reference Manual

+ + +

gimpimagetransform

gimpimagetransform — Transformations on images.

Functions

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

+gboolean +	+gimp_image_resize () +
+gboolean +	+gimp_image_resize_to_layers () +
+gboolean +	+gimp_image_scale () +
+gboolean +	+gimp_image_scale_full () +
+gboolean +	+gimp_image_crop () +
+gboolean +	+gimp_image_flip () +
+gboolean +	+gimp_image_rotate () +

Description

Operations to scale, resize, crop, flip and rotate images.

Functions

gimp_image_resize ()

gboolean
+gimp_image_resize (gint32 image_ID,
+                   gint new_width,
+                   gint new_height,
+                   gint offx,
+                   gint offy);

Resize the image to the specified extents.

This procedure resizes the image so that it's new width and height +are equal to the supplied parameters. Offsets are also provided +which describe the position of the previous image's content. All +channels within the image are resized according to the specified +parameters; this includes the image selection mask. All layers +within the image are repositioned according to the specified +offsets.

Parameters

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

image_ID	The image.
new_width	New image width.
new_height	New image height.
offx	x offset between upper left corner of old and new images: (new - old).
offy	y offset between upper left corner of old and new images: (new - old).

Returns

TRUE on success.

gimp_image_resize_to_layers ()

gboolean
+gimp_image_resize_to_layers (gint32 image_ID);

Resize the image to fit all layers.

This procedure resizes the image to the bounding box of all layers +of the image. All channels within the image are resized to the new +size; this includes the image selection mask. All layers within the +image are repositioned to the new image area.

Parameters

+++++ + + + + + +

image_ID

The image.

Returns

TRUE on success.

Since: 2.2

gimp_image_scale ()

gboolean
+gimp_image_scale (gint32 image_ID,
+                  gint new_width,
+                  gint new_height);

Scale the image using the default interpolation method.

This procedure scales the image so that its new width and height are +equal to the supplied parameters. All layers and channels within the +image are scaled according to the specified parameters; this +includes the image selection mask. The interpolation method used can +be set with gimp_context_set_interpolation().

Parameters

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

image_ID	The image.
new_width	New image width.
new_height	New image height.

Returns

TRUE on success.

gimp_image_scale_full ()

gboolean
+gimp_image_scale_full (gint32 image_ID,
+                       gint new_width,
+                       gint new_height,
+                       GimpInterpolationType interpolation);

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

Use gimp_image_scale() instead.

Parameters

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

image_ID	The image.
new_width	New image width.
new_height	New image height.
interpolation	Type of interpolation.

Returns

TRUE on success.

Since: 2.6

gimp_image_crop ()

gboolean
+gimp_image_crop (gint32 image_ID,
+                 gint new_width,
+                 gint new_height,
+                 gint offx,
+                 gint offy);

Crop the image to the specified extents.

This procedure crops the image so that it's new width and height are +equal to the supplied parameters. Offsets are also provided which +describe the position of the previous image's content. All channels +and layers within the image are cropped to the new image extents; +this includes the image selection mask. If any parameters are out of +range, an error is returned.

Parameters

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

image_ID	The image.
new_width	New image width: (0 < new_width <= width).
new_height	New image height: (0 < new_height <= height).
offx	X offset: (0 <= offx <= (width - new_width)).
offy	Y offset: (0 <= offy <= (height - new_height)).

Returns

TRUE on success.

gimp_image_flip ()

gboolean
+gimp_image_flip (gint32 image_ID,
+                 GimpOrientationType flip_type);

Flips the image horizontally or vertically.

This procedure flips (mirrors) the image.

Parameters

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

image_ID	The image.
flip_type	Type of flip.

Returns

TRUE on success.

gimp_image_rotate ()

gboolean
+gimp_image_rotate (gint32 image_ID,
+                   GimpRotationType rotate_type);

Rotates the image by the specified degrees.

This procedure rotates the image.

Parameters

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

image_ID	The image.
rotate_type	Angle of rotation.

Returns

TRUE on success.