High-level functions for specific information: gexiv2 Reference Manual

## High-level functions for specific information High-level functions for specific information — A set of helper functions to simplify accessing specific information |

## Functions

GExiv2Orientation | gexiv2_metadata_try_get_orientation ()
void | gexiv2_metadata_try_set_orientation ()
gint | gexiv2_metadata_try_get_metadata_pixel_width ()
gint | gexiv2_metadata_try_get_metadata_pixel_height ()
void | gexiv2_metadata_try_set_metadata_pixel_width ()
void | gexiv2_metadata_try_set_metadata_pixel_height ()
gchar * | gexiv2_metadata_try_get_comment ()
void | gexiv2_metadata_try_set_comment ()
void | gexiv2_metadata_clear_comment ()
gboolean | gexiv2_metadata_try_get_exposure_time ()
gdouble | gexiv2_metadata_try_get_fnumber ()
gdouble | gexiv2_metadata_try_get_focal_length ()
gint | gexiv2_metadata_try_get_iso_speed ()
gboolean | gexiv2_metadata_try_get_gps_latitude ()
gboolean | gexiv2_metadata_try_get_gps_longitude ()
gboolean | gexiv2_metadata_try_get_gps_altitude ()
gboolean | gexiv2_metadata_try_get_gps_info ()
gboolean | gexiv2_metadata_try_set_gps_info ()
gboolean | gexiv2_metadata_try_update_gps_info ()
void | gexiv2_metadata_try_delete_gps_info ()
GExiv2PreviewProperties ** | gexiv2_metadata_get_preview_properties ()
GExiv2PreviewImage * | gexiv2_metadata_try_get_preview_image ()
GExiv2Orientation | gexiv2_metadata_get_orientation ()
void | gexiv2_metadata_set_orientation ()
gint | gexiv2_metadata_get_metadata_pixel_width ()
gint | gexiv2_metadata_get_metadata_pixel_height ()
void | gexiv2_metadata_set_metadata_pixel_width ()
void | gexiv2_metadata_set_metadata_pixel_height ()
gchar * | gexiv2_metadata_get_comment ()
void | gexiv2_metadata_set_comment ()
gboolean | gexiv2_metadata_get_exposure_time ()
gdouble | gexiv2_metadata_get_fnumber ()
gdouble | gexiv2_metadata_get_focal_length ()
gint | gexiv2_metadata_get_iso_speed ()
void | gexiv2_metadata_delete_gps_info ()
gboolean | gexiv2_metadata_get_gps_info ()
gboolean | gexiv2_metadata_get_gps_latitude ()
gboolean | gexiv2_metadata_get_gps_longitude ()
gboolean | gexiv2_metadata_get_gps_altitude ()
gboolean | gexiv2_metadata_set_gps_info ()
gboolean | gexiv2_metadata_update_gps_info ()
GExiv2PreviewImage * | gexiv2_metadata_get_preview_image ()

## Description

The functions in this section will use several individual tags to provide or set the required information while trying to follow the MWG recommendations

## Functions

### gexiv2_metadata_try_get_orientation ()

    GExiv2Orientation
    gexiv2_metadata_try_get_orientation (GExiv2Metadata *self,
                                         GError **error);

The EXIF Orientation field

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

A GExiv2Orientation value representing the EXIF orientation value.

Since: 0.14.0

### gexiv2_metadata_try_set_orientation ()

    void
    gexiv2_metadata_try_set_orientation (GExiv2Metadata *self,
                                         GExiv2Orientation orientation,
                                         GError **error);

The orientation must be valid and cannot be GEXIV2_ORIENTATION_UNSPECIFIED.

#### Parameters

self | An instance of GExiv2Metadata |
orientation | The new GExiv2Orientation for the image. |
error | A return location for a GError or `NULL`. | [allow-none]

Since: 0.14.0

### gexiv2_metadata_try_get_metadata_pixel_width ()

    gint
    gexiv2_metadata_try_get_metadata_pixel_width
                                   (GExiv2Metadata *self,
                                    GError **error);

Composite accessor to query the pixel with stored in the metadata. This might differ from the width of image that is available through `gexiv2_metadata_get_pixel_width()`

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Width of images in pixels as stored in the metadata

Since: 0.14.0

### gexiv2_metadata_try_get_metadata_pixel_height ()

    gint
    gexiv2_metadata_try_get_metadata_pixel_height
                                   (GExiv2Metadata *self,
                                    GError **error);

Composite accessor to query the pixel with stored in the metadata. This might differ from the height of image that is available through `gexiv2_metadata_get_pixel_height()`

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Height of images in pixels as stored in the metadata

Since: 0.14.0

### gexiv2_metadata_try_set_metadata_pixel_width ()

    void
    gexiv2_metadata_try_set_metadata_pixel_width
                                   (GExiv2Metadata *self,
                                    gint width,
                                    GError **error);

Composite setter to update the image's metadata with `width`

#### Parameters

self | An instance of GExiv2Metadata |
width | The width of the image as it should be put into the metadata |
error | A return location for a GError or `NULL`. | [allow-none]

Since: 0.14.0

### gexiv2_metadata_try_set_metadata_pixel_height ()

    void
    gexiv2_metadata_try_set_metadata_pixel_height
                                   (GExiv2Metadata *self,
                                    gint height,
                                    GError **error);

Update the image's metadata with `height`

#### Parameters

self | An instance of GExiv2Metadata |
height | The width of the image as it should be put into the metadata. |
error | A return location for a GError or `NULL`. | [allow-none]

Since: 0.14.0

### gexiv2_metadata_try_get_comment ()

    gchar *
    gexiv2_metadata_try_get_comment (GExiv2Metadata *self,
                                     GError **error);

A composite accessor that uses the first available metadata field from a list of well-known locations to find the photo's comment (or description).

MWG guidelines refer to these as Description: a textual description of a resource's content.

These fields are:

- Exif.Image.ImageDescription (MWG Guidelines)

- Exif.Photo.UserComment

- Exif.Image.XPComment

- Iptc.Application2.Caption (MWG Guidelines)

- Xmp.dc.description (MWG Guidelines)

- Xmp.acdsee.notes (Commonly requested, read only)

Note that in the EXIF specification Exif.Image.ImageDescription is described as "the title of the image". Also, it does not support two-byte character codes for encoding. However, it's still used here for legacy reasons.

For fine-grained control, it's recommended to use Exiv2 tags directly rather than this method, which is more useful for quick or casual use.

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

The photo's comment field.

[transfer full][allow-none]

Since: 0.14.0

### gexiv2_metadata_try_set_comment ()

    void
    gexiv2_metadata_try_set_comment (GExiv2Metadata *self,
                                     const gchar *comment,
                                     GError **error);

This is a composite setter that will set a number of fields to the supplied value. See gexiv2_metadata_get_comment for more information.

#### Parameters

self | An instance of GExiv2Metadata |
comment | Comment string to set. Must not be `NULL` |
error | A return location for a GError or `NULL`. | [allow-none]

Since: 0.14.0

### gexiv2_metadata_clear_comment ()

    void
    gexiv2_metadata_clear_comment (GExiv2Metadata *self);

This is a composite clear method that will clear a number of fields. See gexiv2_metadata_get_comment for more information.

#### Parameters

self | An instance of GExiv2Metadata |

### gexiv2_metadata_try_get_exposure_time ()

    gboolean
    gexiv2_metadata_try_get_exposure_time (GExiv2Metadata *self,
                                           gint *nom,
                                           gint *den,
                                           GError **error);

Returns the exposure time in seconds (shutter speed, not date-time of exposure) as a rational. See https://en.wikipedia.org/wiki/Shutter_speed for more information.

#### Parameters

self | An instance of GExiv2Metadata |
nom | The numerator. | [out]
den | The denominator. | [out]
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.14.0

### gexiv2_metadata_try_get_fnumber ()

    gdouble
    gexiv2_metadata_try_get_fnumber (GExiv2Metadata *self,
                                     GError **error);

See https://en.wikipedia.org/wiki/F-number for more information. If Exif.Photo.FNumber does not exist, it will fall back to calculating the FNumber from Exif.Photo.ApertureValue (if available);

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

The exposure Fnumber as a gdouble, or -1.0 if tag is not present or invalid.

Since: 0.14.0

### gexiv2_metadata_try_get_focal_length ()

    gdouble
    gexiv2_metadata_try_get_focal_length (GExiv2Metadata *self,
                                          GError **error);

See https://en.wikipedia.org/wiki/Flange_focal_distance for more information.

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

The focal length as a gdouble, or -1.0 if tag is not present or invalid.

Since: 0.14.0

### gexiv2_metadata_try_get_iso_speed ()

    gint
    gexiv2_metadata_try_get_iso_speed (GExiv2Metadata *self,
                                       GError **error);

See https://en.wikipedia.org/wiki/Iso_speed for more information.

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

The ISO speed rating as a gint, or 0 if tag is not present or invalid.

Since: 0.14.0

### gexiv2_metadata_try_get_gps_latitude ()

    gboolean
    gexiv2_metadata_try_get_gps_latitude (GExiv2Metadata *self,
                                          gdouble *latitude,
                                          GError **error);

Query the latitude stored in the GPS tags of `self`

#### Parameters

self | An instance of GExiv2Metadata |
latitude | Variable to store the latitude value. | [out]
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_get_gps_longitude ()

    gboolean
    gexiv2_metadata_try_get_gps_longitude (GExiv2Metadata *self,
                                           gdouble *longitude,
                                           GError **error);

Query the longitude stored in the GPS tags of `self`

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Variable to store the longitude value. | [out]
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_get_gps_altitude ()

    gboolean
    gexiv2_metadata_try_get_gps_altitude (GExiv2Metadata *self,
                                          gdouble *altitude,
                                          GError **error);

Convenience function to query the altitude stored in the GPS tags of the image

#### Parameters

self | An instance of GExiv2Metadata |
altitude | Variable to store the altitude value. | [out]
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_get_gps_info ()

    gboolean
    gexiv2_metadata_try_get_gps_info (GExiv2Metadata *self,
                                      gdouble *longitude,
                                      gdouble *latitude,
                                      gdouble *altitude,
                                      GError **error);

Convenience function to query all available GPS information at once.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Storage for longitude value. | [out]
latitude | Storage for latitude value. | [out]
altitude | Storage for altitude value. | [out]
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_set_gps_info ()

    gboolean
    gexiv2_metadata_try_set_gps_info (GExiv2Metadata *self,
                                      gdouble longitude,
                                      gdouble latitude,
                                      gdouble altitude,
                                      GError **error);

Convenience function to create a new set of simple GPS data. Warning: Will remove any other GPS information that is currently set. See `gexiv2_metadata_update_gps_info()` for just modifying the GPS data.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Longitude value to set or replace current value |
latitude | Latitude value to set or replace current value |
altitude | Altitude value to set or replace current value |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_update_gps_info ()

    gboolean
    gexiv2_metadata_try_update_gps_info (GExiv2Metadata *self,
                                         gdouble longitude,
                                         gdouble latitude,
                                         gdouble altitude,
                                         GError **error);

Convenience function to update longitude, latitude and altitude at once.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Longitude value to set or replace current value |
latitude | Latitude value to set or replace current value |
altitude | Altitude value to set or replace current value |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

Boolean success value.

[skip]

Since: 0.12.2

### gexiv2_metadata_try_delete_gps_info ()

    void
    gexiv2_metadata_try_delete_gps_info (GExiv2Metadata *self,
                                         GError **error);

Removes all GPS metadata from the loaded image

#### Parameters

self | An instance of GExiv2Metadata |
error | A return location for a GError or `NULL`. | [allow-none]

Since: 0.12.2

### gexiv2_metadata_get_preview_properties ()

    GExiv2PreviewProperties **
    gexiv2_metadata_get_preview_properties
                                   (GExiv2Metadata *self);

An image may have stored one or more previews, often of different qualities, sometimes of different image formats than the containing image. This call returns the properties of all previews Exiv2 finds within the loaded image. Use gexiv2_metadata_get_preview_image to load a particular preview into memory.

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

An array of GExiv2PreviewProperties instances, one for each preview present in the loaded image.

[transfer none][allow-none][array zero-terminated=1]

### gexiv2_metadata_try_get_preview_image ()

    GExiv2PreviewImage *
    gexiv2_metadata_try_get_preview_image (GExiv2Metadata *self,
                                           GExiv2PreviewProperties *props,
                                           GError **error);

#### Parameters

self | An instance of GExiv2Metadata |
props | A GExiv2PreviewProperties instance |
error | A return location for a GError or `NULL`. | [allow-none]

#### Returns

A GExiv2PreviewImage instance for the particular GExiv2PreviewProperties.

[transfer full]

Since: 0.14.0

### gexiv2_metadata_get_orientation ()

    GExiv2Orientation
    gexiv2_metadata_get_orientation (GExiv2Metadata *self);

`gexiv2_metadata_get_orientation` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_orientation()` instead.

The EXIF Orientation field

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

A GExiv2Orientation value representing the EXIF orientation value.

### gexiv2_metadata_set_orientation ()

    void
    gexiv2_metadata_set_orientation (GExiv2Metadata *self,
                                     GExiv2Orientation orientation);

`gexiv2_metadata_set_orientation` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_set_orientation()` instead.

The orientation must be valid and cannot be GEXIV2_ORIENTATION_UNSPECIFIED.

#### Parameters

self | An instance of GExiv2Metadata |
orientation | The new GExiv2Orientation for the image. |

### gexiv2_metadata_get_metadata_pixel_width ()

    gint
    gexiv2_metadata_get_metadata_pixel_width
                                   (GExiv2Metadata *self);

`gexiv2_metadata_get_metadata_pixel_width` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_metadata_pixel_width()` instead.

Composite accessor to query the pixel with stored in the metadata. This might differ from the width of image that is available through `gexiv2_metadata_get_pixel_width()`

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

Width of images in pixels as stored in the metadata

### gexiv2_metadata_get_metadata_pixel_height ()

    gint
    gexiv2_metadata_get_metadata_pixel_height
                                   (GExiv2Metadata *self);

`gexiv2_metadata_get_metadata_pixel_height` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_metadata_pixel_height()` instead.

Composite accessor to query the pixel with stored in the metadata. This might differ from the height of image that is available through `gexiv2_metadata_get_pixel_height()`

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

Height of images in pixels as stored in the metadata

### gexiv2_metadata_set_metadata_pixel_width ()

    void
    gexiv2_metadata_set_metadata_pixel_width
                                   (GExiv2Metadata *self,
                                    gint width);

`gexiv2_metadata_set_metadata_pixel_width` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_set_metadata_pixel_width()` instead.

Composite setter to update the image's metadata with `width`

#### Parameters

self | An instance of GExiv2Metadata |
width | The width of the image as it should be put into the metadata |

### gexiv2_metadata_set_metadata_pixel_height ()

    void
    gexiv2_metadata_set_metadata_pixel_height
                                   (GExiv2Metadata *self,
                                    gint height);

`gexiv2_metadata_set_metadata_pixel_height` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_set_metadata_pixel_height()` instead.

Update the image's metadata with `height`

#### Parameters

self | An instance of GExiv2Metadata |
height | The width of the image as it should be put into the metadata. |

### gexiv2_metadata_get_comment ()

    gchar *
    gexiv2_metadata_get_comment (GExiv2Metadata *self);

`gexiv2_metadata_get_comment` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_comment()` instead.

A composite accessor that uses the first available metadata field from a list of well-known locations to find the photo's comment (or description).

MWG guidelines refer to these as Description: a textual description of a resource's content.

These fields are:

- Exif.Image.ImageDescription (MWG Guidelines)

- Exif.Photo.UserComment

- Exif.Image.XPComment

- Iptc.Application2.Caption (MWG Guidelines)

- Xmp.dc.description (MWG Guidelines)

- Xmp.acdsee.notes (Commonly requested, read only)

Note that in the EXIF specification Exif.Image.ImageDescription is described as "the title of the image". Also, it does not support two-byte character codes for encoding. However, it's still used here for legacy reasons.

For fine-grained control, it's recommended to use Exiv2 tags directly rather than this method, which is more useful for quick or casual use.

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

The photo's comment field.

[transfer full][allow-none]

### gexiv2_metadata_set_comment ()

    void
    gexiv2_metadata_set_comment (GExiv2Metadata *self,
                                 const gchar *comment);

`gexiv2_metadata_set_comment` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_set_comment()` instead.

This is a composite setter that will set a number of fields to the supplied value. See gexiv2_metadata_get_comment for more information.

#### Parameters

self | An instance of GExiv2Metadata |
comment | Comment string to set. Must not be `NULL` |

### gexiv2_metadata_get_exposure_time ()

    gboolean
    gexiv2_metadata_get_exposure_time (GExiv2Metadata *self,
                                       gint *nom,
                                       gint *den);

`gexiv2_metadata_get_exposure_time` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_exposure_time()` instead.

Returns the exposure time in seconds (shutter speed, not date-time of exposure) as a rational. See https://en.wikipedia.org/wiki/Shutter_speed for more information.

#### Parameters

self | An instance of GExiv2Metadata |
nom | The numerator. | [out]
den | The denominator. | [out]

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_get_fnumber ()

    gdouble
    gexiv2_metadata_get_fnumber (GExiv2Metadata *self);

`gexiv2_metadata_get_fnumber` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_fnumber()` instead.

See https://en.wikipedia.org/wiki/F-number for more information. If Exif.Photo.FNumber does not exist, it will fall back to calculating the FNumber from Exif.Photo.ApertureValue (if available);

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

The exposure Fnumber as a gdouble, or -1.0 if tag is not present or invalid.

### gexiv2_metadata_get_focal_length ()

    gdouble
    gexiv2_metadata_get_focal_length (GExiv2Metadata *self);

`gexiv2_metadata_get_focal_length` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_focal_length()` instead.

See https://en.wikipedia.org/wiki/Flange_focal_distance for more information.

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

The focal length as a gdouble, or -1.0 if tag is not present or invalid.

### gexiv2_metadata_get_iso_speed ()

    gint
    gexiv2_metadata_get_iso_speed (GExiv2Metadata *self);

`gexiv2_metadata_get_iso_speed` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_iso_speed()` instead.

See https://en.wikipedia.org/wiki/Iso_speed for more information.

#### Parameters

self | An instance of GExiv2Metadata |

#### Returns

The ISO speed rating as a gint, or 0 if tag is not present or invalid.

### gexiv2_metadata_delete_gps_info ()

    void
    gexiv2_metadata_delete_gps_info (GExiv2Metadata *self);

`gexiv2_metadata_delete_gps_info` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_delete_gps_info()` instead.

Removes all GPS metadata from the loaded image

#### Parameters

self | An instance of GExiv2Metadata |

### gexiv2_metadata_get_gps_info ()

    gboolean
    gexiv2_metadata_get_gps_info (GExiv2Metadata *self,
                                  gdouble *longitude,
                                  gdouble *latitude,
                                  gdouble *altitude);

`gexiv2_metadata_get_gps_info` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_gps_info()` instead.

Convenience function to query all available GPS information at once.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Storage for longitude value. | [out]
latitude | Storage for latitude value. | [out]
altitude | Storage for altitude value. | [out]

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_get_gps_latitude ()

    gboolean
    gexiv2_metadata_get_gps_latitude (GExiv2Metadata *self,
                                      gdouble *latitude);

`gexiv2_metadata_get_gps_latitude` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_gps_latitude()` instead.

Query the latitude stored in the GPS tags of `self`

#### Parameters

self | An instance of GExiv2Metadata |
latitude | Variable to store the latitude value. | [out]

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_get_gps_longitude ()

    gboolean
    gexiv2_metadata_get_gps_longitude (GExiv2Metadata *self,
                                       gdouble *longitude);

`gexiv2_metadata_get_gps_longitude` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_gps_longitude()` instead.

Query the longitude stored in the GPS tags of `self`

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Variable to store the longitude value. | [out]

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_get_gps_altitude ()

    gboolean
    gexiv2_metadata_get_gps_altitude (GExiv2Metadata *self,
                                      gdouble *altitude);

`gexiv2_metadata_get_gps_altitude` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_gps_altitude()` instead.

Convenience function to query the altitude stored in the GPS tags of the image

#### Parameters

self | An instance of GExiv2Metadata |
altitude | Variable to store the altitude value. | [out]

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_set_gps_info ()

    gboolean
    gexiv2_metadata_set_gps_info (GExiv2Metadata *self,
                                  gdouble longitude,
                                  gdouble latitude,
                                  gdouble altitude);

`gexiv2_metadata_set_gps_info` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_set_gps_info()` instead.

Convenience function to create a new set of simple GPS data. Warning: Will remove any other GPS information that is currently set. See `gexiv2_metadata_update_gps_info()` for just modifying the GPS data.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Longitude value to set or replace current value |
latitude | Latitude value to set or replace current value |
altitude | Altitude value to set or replace current value |

#### Returns

Boolean success value.

[skip]

### gexiv2_metadata_update_gps_info ()

    gboolean
    gexiv2_metadata_update_gps_info (GExiv2Metadata *self,
                                     gdouble longitude,
                                     gdouble latitude,
                                     gdouble altitude);

`gexiv2_metadata_update_gps_info` has been deprecated since version 0.12.2 and should not be used in newly-written code.

Use `gexiv2_metadata_try_update_gps_info()` instead.

Convenience function to update longitude, latitude and altitude at once.

#### Parameters

self | An instance of GExiv2Metadata |
longitude | Longitude value to set or replace current value |
latitude | Latitude value to set or replace current value |
altitude | Altitude value to set or replace current value |

#### Returns

Boolean success value.

[skip]

Since: 0.12.1

### gexiv2_metadata_get_preview_image ()

    GExiv2PreviewImage *
    gexiv2_metadata_get_preview_image (GExiv2Metadata *self,
                                       GExiv2PreviewProperties *props);

`gexiv2_metadata_get_preview_image` has been deprecated since version 0.14.0 and should not be used in newly-written code.

Use `gexiv2_metadata_try_get_preview_image()` instead.

#### Parameters

self | An instance of GExiv2Metadata |
props | A GExiv2PreviewProperties instance |

#### Returns

A GExiv2PreviewImage instance for the particular GExiv2PreviewProperties.

[transfer full]