## gimpguides

gimpguides — Functions for manipulating guides.

## Synopsis

    gint32      gimp_image_add_hguide           (gint32 image_ID,
                                                 gint yposition);
    gint32      gimp_image_add_vguide           (gint32 image_ID,
                                                 gint xposition);
    gboolean    gimp_image_delete_guide         (gint32 image_ID,
                                                 gint32 guide_ID);
    gint32      gimp_image_find_next_guide      (gint32 image_ID,
                                                 gint32 guide_ID);
    GimpOrientationType gimp_image_get_guide_orientation
                                                (gint32 image_ID,
                                                 gint32 guide_ID);
    gint        gimp_image_get_guide_position   (gint32 image_ID,
                                                 gint32 guide_ID);

## Description

Functions for manipulating guides.

## Details

### gimp_image_add_hguide ()

    gint32      gimp_image_add_hguide           (gint32 image_ID,
                                                 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.

`image_ID` : | The image.
`yposition` : | The guide's y-offset from top of image.
Returns : | The new guide.

### gimp_image_add_vguide ()

    gint32      gimp_image_add_vguide           (gint32 image_ID,
                                                 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.

`image_ID` : | 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         (gint32 image_ID,
                                                 gint32 guide_ID);

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.

`image_ID` : | The image.
`guide_ID` : | The ID of the guide to be removed.
Returns : | TRUE on success.

### gimp_image_find_next_guide ()

    gint32      gimp_image_find_next_guide      (gint32 image_ID,
                                                 gint32 guide_ID);

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.

`image_ID` : | The image.
`guide_ID` : | 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
                                                (gint32 image_ID,
                                                 gint32 guide_ID);

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.

`image_ID` : | The image.
`guide_ID` : | The guide.
Returns : | The guide's orientation.

### gimp_image_get_guide_position ()

    gint        gimp_image_get_guide_position   (gint32 image_ID,
                                                 gint32 guide_ID);

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.

`image_ID` : | The image.
`guide_ID` : | The guide.
Returns : | The guide's position relative to top or left of image.