transform_flip_simple

Flip the specified item either vertically or horizontally.

This procedure flips 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 flipped. If auto_center is set to TRUE, the flip is around the selection's center. Otherwise, the coordinate of the axis needs to be specified. The return value is the ID of the flipped floating selection.

If there is no selection or the item is not a drawable, the entire item will be flipped around its center if auto_center is set to TRUE, otherwise the coordinate of the axis 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: context_set_transform_resize.

Parameters:

this	The affected item.
flip_type	Type of flip.
auto_center	Whether to automatically position the axis in the selection center.
axis	coord. of flip axis.

Returns:

The flipped item.