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.