Method

GimpItemtransform_rotate

Declaration [src]

GimpItem*
gimp_item_transform_rotate (
  GimpItem* item,
  gdouble angle,
  gboolean auto_center,
  gdouble center_x,
  gdouble center_y
)

Description [src]

Rotate the specified item about given coordinates through the specified angle.

This function rotates the specified item.

If a selection exists and the item is a drawable, 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. If auto_center is set to TRUE, the rotation is around the selection’s center. Otherwise, the coordinate of the center point needs to be specified. The return value is the ID of the rotated floating selection.

If there is no selection or the item is not a drawable, the entire item will be rotated around its center if auto_center is set to TRUE, otherwise the coordinate of the center point needs to be specified. The return value will be equal to the item ID supplied as input.

This procedure is affected by the following context setters: gimp_context_set_interpolation(), gimp_context_set_transform_direction(), gimp_context_set_transform_resize().

Available since:2.8

Parameters

angle gdouble
 

The angle of rotation (radians).

auto_center gboolean
 

Whether to automatically rotate around the selection center.

center_x gdouble
 

The hor. coordinate of the center of rotation.

center_y gdouble
 

The vert. coordinate of the center of rotation.

Return value

Returns: GimpItem
 

The rotated item.

 The data is owned by the instance.