gimpimageguides

gimpimageguides — Functions for manipulating an image's guides.

Functions

Description

Functions for manipulating an image's guides.

Functions

gimp_image_add_hguide ()

guint
gimp_image_add_hguide (GimpImage *image,
                       gint yposition);

Add a horizontal guide to an image.

This procedure adds a horizontal guide to an image. It takes the input image and the y-position of the new guide as parameters. It returns the guide ID of the new guide.

Parameters

image

The image.

 

yposition

The guide's y-offset from top of image.

 

Returns

The new guide.


gimp_image_add_vguide ()

guint
gimp_image_add_vguide (GimpImage *image,
                       gint xposition);

Add a vertical guide to an image.

This procedure adds a vertical guide to an image. It takes the input image and the x-position of the new guide as parameters. It returns the guide ID of the new guide.

Parameters

image

The image.

 

xposition

The guide's x-offset from left of image.

 

Returns

The new guide.


gimp_image_delete_guide ()

gboolean
gimp_image_delete_guide (GimpImage *image,
                         guint guide);

Deletes a guide from an image.

This procedure takes an image and a guide ID as input and removes the specified guide from the specified image.

Parameters

image

The image.

 

guide

The ID of the guide to be removed.

 

Returns

TRUE on success.


gimp_image_find_next_guide ()

guint
gimp_image_find_next_guide (GimpImage *image,
                            guint guide);

Find next guide on an image.

This procedure takes an image and a guide ID as input and finds the guide ID of the successor of the given guide ID in the image's guide list. If the supplied guide ID is 0, the procedure will return the first Guide. The procedure will return 0 if given the final guide ID as an argument or the image has no guides.

Parameters

image

The image.

 

guide

The ID of the current guide (0 if first invocation).

 

Returns

The next guide's ID.


gimp_image_get_guide_orientation ()

GimpOrientationType
gimp_image_get_guide_orientation (GimpImage *image,
                                  guint guide);

Get orientation of a guide on an image.

This procedure takes an image and a guide ID as input and returns the orientations of the guide.

Parameters

image

The image.

 

guide

The guide.

 

Returns

The guide's orientation.


gimp_image_get_guide_position ()

gint
gimp_image_get_guide_position (GimpImage *image,
                               guint guide);

Get position of a guide on an image.

This procedure takes an image and a guide ID as input and returns the position of the guide relative to the top or left of the image.

Parameters

image

The image.

 

guide

The guide.

 

Returns

The guide's position relative to top or left of image.

Types and Values