GDataPicasaWebFile

GDataPicasaWebFile — GData PicasaWeb file object

Stability Level

Unstable, unless otherwise indicated

Synopsis

#include <gdata/services/picasaweb/gdata-picasaweb-file.h>

#define             GDATA_PICASAWEB_VIDEO_STATUS_PENDING
#define             GDATA_PICASAWEB_VIDEO_STATUS_READY
#define             GDATA_PICASAWEB_VIDEO_STATUS_FINAL
#define             GDATA_PICASAWEB_VIDEO_STATUS_FAILED
                    GDataPicasaWebFile;
                    GDataPicasaWebFileClass;
GDataPicasaWebFile * gdata_picasaweb_file_new           (const gchar *id);
const gchar *       gdata_picasaweb_file_get_id         (GDataPicasaWebFile *self);
gint64              gdata_picasaweb_file_get_edited     (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_version    (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_album_id   (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_album_id   (GDataPicasaWebFile *self,
                                                         const gchar *album_id);
guint               gdata_picasaweb_file_get_width      (GDataPicasaWebFile *self);
guint               gdata_picasaweb_file_get_height     (GDataPicasaWebFile *self);
gsize               gdata_picasaweb_file_get_size       (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_checksum   (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_checksum   (GDataPicasaWebFile *self,
                                                         const gchar *checksum);
gint64              gdata_picasaweb_file_get_timestamp  (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_timestamp  (GDataPicasaWebFile *self,
                                                         gint64 timestamp);
gboolean            gdata_picasaweb_file_is_commenting_enabled
                                                        (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_is_commenting_enabled
                                                        (GDataPicasaWebFile *self,
                                                         gboolean is_commenting_enabled);
guint               gdata_picasaweb_file_get_comment_count
                                                        (GDataPicasaWebFile *self);
guint               gdata_picasaweb_file_get_rotation   (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_rotation   (GDataPicasaWebFile *self,
                                                         guint rotation);
const gchar *       gdata_picasaweb_file_get_video_status
                                                        (GDataPicasaWebFile *self);
const gchar * const * gdata_picasaweb_file_get_tags     (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_tags       (GDataPicasaWebFile *self,
                                                         const gchar * const *tags);
const gchar *       gdata_picasaweb_file_get_credit     (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_caption    (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_set_caption    (GDataPicasaWebFile *self,
                                                         const gchar *caption);
GList *             gdata_picasaweb_file_get_contents   (GDataPicasaWebFile *self);
GList *             gdata_picasaweb_file_get_thumbnails (GDataPicasaWebFile *self);
gdouble             gdata_picasaweb_file_get_distance   (GDataPicasaWebFile *self);
gdouble             gdata_picasaweb_file_get_exposure   (GDataPicasaWebFile *self);
gboolean            gdata_picasaweb_file_get_flash      (GDataPicasaWebFile *self);
gdouble             gdata_picasaweb_file_get_focal_length
                                                        (GDataPicasaWebFile *self);
gdouble             gdata_picasaweb_file_get_fstop      (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_image_unique_id
                                                        (GDataPicasaWebFile *self);
gint                gdata_picasaweb_file_get_iso        (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_make       (GDataPicasaWebFile *self);
const gchar *       gdata_picasaweb_file_get_model      (GDataPicasaWebFile *self);
void                gdata_picasaweb_file_get_coordinates
                                                        (GDataPicasaWebFile *self,
                                                         gdouble *latitude,
                                                         gdouble *longitude);
void                gdata_picasaweb_file_set_coordinates
                                                        (GDataPicasaWebFile *self,
                                                         gdouble latitude,
                                                         gdouble longitude);

Object Hierarchy

  GObject
   +----GDataParsable
         +----GDataEntry
               +----GDataPicasaWebFile

Implemented Interfaces

GDataPicasaWebFile implements GDataCommentable.

Properties

  "album-id"                 gchar*                : Read / Write
  "caption"                  gchar*                : Read / Write
  "checksum"                 gchar*                : Read / Write
  "comment-count"            guint                 : Read
  "credit"                   gchar*                : Read
  "distance"                 gdouble               : Read
  "edited"                   gint64                : Read
  "exposure"                 gdouble               : Read
  "file-id"                  gchar*                : Read / Write / Construct Only
  "flash"                    gboolean              : Read
  "focal-length"             gdouble               : Read
  "fstop"                    gdouble               : Read
  "height"                   guint                 : Read
  "image-unique-id"          gchar*                : Read
  "is-commenting-enabled"    gboolean              : Read / Write
  "iso"                      glong                 : Read
  "latitude"                 gdouble               : Read / Write
  "longitude"                gdouble               : Read / Write
  "make"                     gchar*                : Read
  "model"                    gchar*                : Read
  "rotation"                 guint                 : Read / Write
  "size"                     gulong                : Read
  "tags"                     GStrv                 : Read / Write
  "timestamp"                gint64                : Read / Write
  "version"                  gchar*                : Read / Write / Construct Only
  "video-status"             gchar*                : Read
  "width"                    guint                 : Read

Description

GDataPicasaWebFile is a subclass of GDataEntry to represent a file (photo or video) in an album on Google PicasaWeb.

GDataPicasaWebFile implements GDataCommentable, allowing comments on files to be queried using gdata_commentable_query_comments(), new comments to be added to files using gdata_commentable_insert_comment() and existing comments to be deleted from files using gdata_commentable_delete_comment().

For more details of Google PicasaWeb's GData API, see the online documentation.

Example 36. Getting Basic Photo Data

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
GDataFeed *photo_feed;
GList *photo_entries;

/* Query for a feed of GDataPicasaWebFiles belonging to the given GDataPicasaWebAlbum album */
photo_feed = gdata_picasaweb_service_query_files (service, album, NULL, NULL, NULL, NULL, NULL);

/* Get a list of GDataPicasaWebFiles from the query's feed */
for (photo_entries = gdata_feed_get_entries (photo_feed); photo_entries != NULL; photo_entries = photo_entries->next) {
    GDataPicasaWebFile *photo;
    guint height, width;
    gsize file_size;
    gint64 timestamp;
    const gchar *title, *summary;
    GList *contents;

    photo = GDATA_PICASAWEB_FILE (photo_entries->data);

    /* Get various bits of information about the photo */
    height = gdata_picasaweb_file_get_height (photo);
    width = gdata_picasaweb_file_get_width (photo);
    file_size = gdata_picasaweb_file_get_size (photo);
    timestamp = gdata_picasaweb_file_get_timestamp (photo);
    title = gdata_entry_get_title (GDATA_ENTRY (photo));
    summary = gdata_entry_get_summary (GDATA_ENTRY (photo));

    /* Obtain the image data at various sizes */
    for (contents = gdata_picasaweb_file_get_contents (photo); contents != NULL; contents = contents->next) {
        GDataMediaContent *content;
        GDataDownloadStream *download_stream;
        GFileOutputStream *file_stream;
        GFile *new_file;

        content = GDATA_MEDIA_CONTENT (contents->data);
        /* Do something fun with the actual images, like download them to a file.
         * Note that this is a blocking operation. */
        download_stream = gdata_media_content_download (content, GDATA_SERVICE (service), NULL, NULL);
        new_file = g_file_new_for_path (file_path);
        file_stream = g_file_create (new_file, G_FILE_CREATE_NONE, NULL, NULL);
        g_output_stream_splice (G_OUTPUT_STREAM (file_stream), G_INPUT_STREAM (download_stream),
                                G_OUTPUT_STREAM_SPLICE_CLOSE_SOURCE | G_OUTPUT_STREAM_SPLICE_CLOSE_TARGET, NULL, NULL);
        g_object_unref (file_stream);
        g_object_unref (download_stream);
        /* ... */
        g_object_unref (new_file);
    }

    /* Do something worthwhile with your image data */
}

g_object_unref (photo_feed);


Details

GDATA_PICASAWEB_VIDEO_STATUS_PENDING

#define GDATA_PICASAWEB_VIDEO_STATUS_PENDING "pending"

The video is still being processed.

Since 0.7.0


GDATA_PICASAWEB_VIDEO_STATUS_READY

#define GDATA_PICASAWEB_VIDEO_STATUS_READY "ready"

The video has been processed, but still needs thumbnailing.

Since 0.7.0


GDATA_PICASAWEB_VIDEO_STATUS_FINAL

#define GDATA_PICASAWEB_VIDEO_STATUS_FINAL "final"

The video has been processed and thumbnailed.

Since 0.7.0


GDATA_PICASAWEB_VIDEO_STATUS_FAILED

#define GDATA_PICASAWEB_VIDEO_STATUS_FAILED "failed"

There was an error while processing or thumbnailing the video and it should be deleted.

Since 0.7.0


GDataPicasaWebFile

typedef struct _GDataPicasaWebFile GDataPicasaWebFile;

All the fields in the GDataPicasaWebFile structure are private and should never be accessed directly.

Since 0.4.0


GDataPicasaWebFileClass

typedef struct {
} GDataPicasaWebFileClass;

All the fields in the GDataPicasaWebFileClass structure are private and should never be accessed directly.

Since 0.4.0


gdata_picasaweb_file_new ()

GDataPicasaWebFile * gdata_picasaweb_file_new           (const gchar *id);

Creates a new GDataPicasaWebFile with the given ID and default properties.

id :

the file's ID, or NULL. [allow-none]

Returns :

a new GDataPicasaWebFile; unref with g_object_unref()

Since 0.4.0


gdata_picasaweb_file_get_id ()

const gchar *       gdata_picasaweb_file_get_id         (GDataPicasaWebFile *self);

Gets the "file-id" property.

self :

a GDataPicasaWebFile

Returns :

the file's ID

Since 0.7.0


gdata_picasaweb_file_get_edited ()

gint64              gdata_picasaweb_file_get_edited     (GDataPicasaWebFile *self);

Gets the "edited" property. If the property is unset, -1 will be returned.

self :

a GDataPicasaWebFile

Returns :

the UNIX timestamp for the time the file was last edited, or -1

Since 0.4.0


gdata_picasaweb_file_get_version ()

const gchar *       gdata_picasaweb_file_get_version    (GDataPicasaWebFile *self);

Gets the "version" property.

self :

a GDataPicasaWebFile

Returns :

the file's version number, or NULL

Since 0.4.0


gdata_picasaweb_file_get_album_id ()

const gchar *       gdata_picasaweb_file_get_album_id   (GDataPicasaWebFile *self);

Gets the "album-id" property. This is in the same form as returned by gdata_picasaweb_album_get_id().

self :

a GDataPicasaWebFile

Returns :

the ID of the album containing the GDataPicasaWebFile

Since 0.4.0


gdata_picasaweb_file_set_album_id ()

void                gdata_picasaweb_file_set_album_id   (GDataPicasaWebFile *self,
                                                         const gchar *album_id);

Sets the "album-id" property, effectively moving the file to the album.

self :

a GDataPicasaWebFile

album_id :

the ID of the new album for this file

Since 0.4.0


gdata_picasaweb_file_get_width ()

guint               gdata_picasaweb_file_get_width      (GDataPicasaWebFile *self);

Gets the "width" property.

self :

a GDataPicasaWebFile

Returns :

the width of the image or video, in pixels

Since 0.4.0


gdata_picasaweb_file_get_height ()

guint               gdata_picasaweb_file_get_height     (GDataPicasaWebFile *self);

Gets the "height" property.

self :

a GDataPicasaWebFile

Returns :

the height of the image or video, in pixels

Since 0.4.0


gdata_picasaweb_file_get_size ()

gsize               gdata_picasaweb_file_get_size       (GDataPicasaWebFile *self);

Gets the "size" property.

self :

a GDataPicasaWebFile

Returns :

the size of the file, in bytes

Since 0.4.0


gdata_picasaweb_file_get_checksum ()

const gchar *       gdata_picasaweb_file_get_checksum   (GDataPicasaWebFile *self);

Gets the "checksum" property.

self :

a GDataPicasaWebFile

Returns :

the checksum assigned to this file, or NULL

Since 0.4.0


gdata_picasaweb_file_set_checksum ()

void                gdata_picasaweb_file_set_checksum   (GDataPicasaWebFile *self,
                                                         const gchar *checksum);

Sets the "checksum" property to checksum.

Set checksum to NULL to unset the property.

self :

a GDataPicasaWebFile

checksum :

the new checksum for this file, or NULL. [allow-none]

Since 0.4.0


gdata_picasaweb_file_get_timestamp ()

gint64              gdata_picasaweb_file_get_timestamp  (GDataPicasaWebFile *self);

Gets the "timestamp" property. It's a UNIX timestamp in milliseconds (not seconds) since the epoch. If the property is unset, -1 will be returned.

self :

a GDataPicasaWebFile

Returns :

the UNIX timestamp for the timestamp property in milliseconds, or -1

Since 0.4.0


gdata_picasaweb_file_set_timestamp ()

void                gdata_picasaweb_file_set_timestamp  (GDataPicasaWebFile *self,
                                                         gint64 timestamp);

Sets the "timestamp" property from timestamp. This should be a UNIX timestamp in milliseconds (not seconds) since the epoch. If timestamp is -1, the property will be unset.

self :

a GDataPicasaWebFile

timestamp :

a UNIX timestamp, or -1

Since 0.4.0


gdata_picasaweb_file_is_commenting_enabled ()

gboolean            gdata_picasaweb_file_is_commenting_enabled
                                                        (GDataPicasaWebFile *self);

Gets the "is-commenting-enabled" property.

self :

a GDataPicasaWebFile

Returns :

TRUE if commenting is enabled, FALSE otherwise

Since 0.4.0


gdata_picasaweb_file_set_is_commenting_enabled ()

void                gdata_picasaweb_file_set_is_commenting_enabled
                                                        (GDataPicasaWebFile *self,
                                                         gboolean is_commenting_enabled);

Sets the "is-commenting-enabled" property to is_commenting_enabled.

self :

a GDataPicasaWebFile

is_commenting_enabled :

TRUE if commenting should be enabled for the file, FALSE otherwise

Since 0.4.0


gdata_picasaweb_file_get_comment_count ()

guint               gdata_picasaweb_file_get_comment_count
                                                        (GDataPicasaWebFile *self);

Gets the "comment-count" property.

self :

a GDataPicasaWebFile

Returns :

the number of comments on the file

Since 0.4.0


gdata_picasaweb_file_get_rotation ()

guint               gdata_picasaweb_file_get_rotation   (GDataPicasaWebFile *self);

Gets the "rotation" property.

self :

a GDataPicasaWebFile

Returns :

the image's rotation, in degrees

Since 0.4.0


gdata_picasaweb_file_set_rotation ()

void                gdata_picasaweb_file_set_rotation   (GDataPicasaWebFile *self,
                                                         guint rotation);

Sets the "rotation" property to rotation.

The rotation is absolute, rather than cumulative, through successive calls to gdata_picasaweb_file_set_rotation(), so calling it with 90° then 20° will result in a final rotation of 20°.

self :

a GDataPicasaWebFile

rotation :

the new rotation for the image, in degrees

Since 0.4.0


gdata_picasaweb_file_get_video_status ()

const gchar *       gdata_picasaweb_file_get_video_status
                                                        (GDataPicasaWebFile *self);

Gets the "video-status" property.

self :

a GDataPicasaWebFile

Returns :

the status of this video ("pending", "ready", "final" or "failed"), or NULL

Since 0.4.0


gdata_picasaweb_file_get_tags ()

const gchar * const * gdata_picasaweb_file_get_tags     (GDataPicasaWebFile *self);

Gets the "tags" property.

self :

a GDataPicasaWebFile

Returns :

a NULL-terminated array of tags associated with the file, or NULL. [array zero-terminated=1][transfer none]

Since 0.4.0


gdata_picasaweb_file_set_tags ()

void                gdata_picasaweb_file_set_tags       (GDataPicasaWebFile *self,
                                                         const gchar * const *tags);

Sets the "tags" property to tags.

Set tags to NULL to unset the property.

self :

a GDataPicasaWebFile

tags :

a new NULL-terminated array of tags, or NULL. [array zero-terminated=1][allow-none]

Since 0.4.0


gdata_picasaweb_file_get_credit ()

const gchar *       gdata_picasaweb_file_get_credit     (GDataPicasaWebFile *self);

Gets the "credit" property.

self :

a GDataPicasaWebFile

Returns :

the nickname of the user credited with this file

Since 0.4.0


gdata_picasaweb_file_get_caption ()

const gchar *       gdata_picasaweb_file_get_caption    (GDataPicasaWebFile *self);

Gets the "caption" property.

self :

a GDataPicasaWebFile

Returns :

the file's descriptive caption, or NULL

Since 0.4.0


gdata_picasaweb_file_set_caption ()

void                gdata_picasaweb_file_set_caption    (GDataPicasaWebFile *self,
                                                         const gchar *caption);

Sets the "caption" property to caption.

Set caption to NULL to unset the file's caption.

self :

a GDataPicasaWebFile

caption :

the file's new caption, or NULL. [allow-none]

Since 0.4.0


gdata_picasaweb_file_get_contents ()

GList *             gdata_picasaweb_file_get_contents   (GDataPicasaWebFile *self);

Returns a list of media content, e.g. the actual photo or video.

self :

a GDataPicasaWebFile

Returns :

a GList of GDataMediaContent items. [element-type GData.MediaContent][transfer none]

Since 0.4.0


gdata_picasaweb_file_get_thumbnails ()

GList *             gdata_picasaweb_file_get_thumbnails (GDataPicasaWebFile *self);

Returns a list of thumbnails, often at different sizes, for this file. Currently, PicasaWeb usually returns three thumbnails, with widths in pixels of 72, 144, and 288. However, the thumbnail will not be larger than the actual image, so thumbnails may be smaller than the widths listed above.

self :

a GDataPicasaWebFile

Returns :

a GList of GDataMediaThumbnails, or NULL. [element-type GData.MediaThumbnail][transfer none]

Since 0.4.0


gdata_picasaweb_file_get_distance ()

gdouble             gdata_picasaweb_file_get_distance   (GDataPicasaWebFile *self);

Gets the "distance" property.

self :

a GDataPicasaWebFile

Returns :

the distance recorded in the photo's EXIF, or -1 if unknown

Since 0.5.0


gdata_picasaweb_file_get_exposure ()

gdouble             gdata_picasaweb_file_get_exposure   (GDataPicasaWebFile *self);

Gets the "exposure" property.

self :

a GDataPicasaWebFile

Returns :

the exposure value, or 0 if unknown

Since 0.5.0


gdata_picasaweb_file_get_flash ()

gboolean            gdata_picasaweb_file_get_flash      (GDataPicasaWebFile *self);

Gets the "flash" property.

self :

a GDataPicasaWebFile

Returns :

TRUE if flash was used, FALSE otherwise

Since 0.5.0


gdata_picasaweb_file_get_focal_length ()

gdouble             gdata_picasaweb_file_get_focal_length
                                                        (GDataPicasaWebFile *self);

Gets the "focal-length" property.

self :

a GDataPicasaWebFile

Returns :

the focal-length value, or -1 if unknown

Since 0.5.0


gdata_picasaweb_file_get_fstop ()

gdouble             gdata_picasaweb_file_get_fstop      (GDataPicasaWebFile *self);

Gets the "fstop" property.

self :

a GDataPicasaWebFile

Returns :

the F-stop value, or 0 if unknown

Since 0.5.0


gdata_picasaweb_file_get_image_unique_id ()

const gchar *       gdata_picasaweb_file_get_image_unique_id
                                                        (GDataPicasaWebFile *self);

Gets the "image-unique-id" property.

self :

a GDataPicasaWebFile

Returns :

the photo's unique EXIF identifier, or NULL

Since 0.5.0


gdata_picasaweb_file_get_iso ()

gint                gdata_picasaweb_file_get_iso        (GDataPicasaWebFile *self);

Gets the "iso" property.

self :

a GDataPicasaWebFile

Returns :

the ISO speed, or -1 if unknown

Since 0.5.0


gdata_picasaweb_file_get_make ()

const gchar *       gdata_picasaweb_file_get_make       (GDataPicasaWebFile *self);

Gets the "make" property.

self :

a GDataPicasaWebFile

Returns :

the name of the manufacturer of the camera, or NULL if unknown

Since 0.5.0


gdata_picasaweb_file_get_model ()

const gchar *       gdata_picasaweb_file_get_model      (GDataPicasaWebFile *self);

Gets the "model" property.

self :

a GDataPicasaWebFile

Returns :

the model name of the camera, or NULL if unknown

Since 0.5.0


gdata_picasaweb_file_get_coordinates ()

void                gdata_picasaweb_file_get_coordinates
                                                        (GDataPicasaWebFile *self,
                                                         gdouble *latitude,
                                                         gdouble *longitude);

Gets the "latitude" and "longitude" properties, setting the out parameters to them. If either latitude or longitude is NULL, that parameter will not be set. If the coordinates are unset, latitude and longitude will be set to G_MAXDOUBLE.

self :

a GDataPicasaWebFile

latitude :

return location for the latitude, or NULL. [out caller-allocates][allow-none]

longitude :

return location for the longitude, or NULL. [out caller-allocates][allow-none]

Since 0.5.0


gdata_picasaweb_file_set_coordinates ()

void                gdata_picasaweb_file_set_coordinates
                                                        (GDataPicasaWebFile *self,
                                                         gdouble latitude,
                                                         gdouble longitude);

Sets the "latitude" and "longitude" properties to latitude and longitude respectively.

self :

a GDataPicasaWebFile

latitude :

the file's new latitude coordinate, or G_MAXDOUBLE

longitude :

the file's new longitude coordinate, or G_MAXDOUBLE

Since 0.5.0

Property Details

The "album-id" property

  "album-id"                 gchar*                : Read / Write

The ID for the file's album. This is in the same form as returned by gdata_picasaweb_album_get_id().

For more information, see the gphoto specification.

Default value: NULL

Since 0.4.0


The "caption" property

  "caption"                  gchar*                : Read / Write

The file's descriptive caption.

Default value: NULL

Since 0.4.0


The "checksum" property

  "checksum"                 gchar*                : Read / Write

A checksum of the file, useful for duplicate detection.

For more information, see the gphoto specification.

Default value: NULL

Since 0.4.0


The "comment-count" property

  "comment-count"            guint                 : Read

The number of comments on the file.

For more information, see the gphoto specification.

Default value: 0

Since 0.4.0


The "credit" property

  "credit"                   gchar*                : Read

The nickname of the user credited with this file.

For more information, see the Media RSS specification.

Default value: NULL

Since 0.4.0


The "distance" property

  "distance"                 gdouble               : Read

The distance to the subject reported in the image's EXIF.

For more information, see the EXIF element reference.

Allowed values: >= -1

Default value: -1

Since 0.5.0


The "edited" property

  "edited"                   gint64                : Read

The time this file was last edited. If the file has not been edited yet, the content indicates the time it was created.

For more information, see the Atom Publishing Protocol specification.

Allowed values: >= -1

Default value: -1

Since 0.4.0


The "exposure" property

  "exposure"                 gdouble               : Read

The exposure time.

For more information, see the EXIF element reference.

Allowed values: >= 0

Default value: 0

Since 0.5.0


The "file-id" property

  "file-id"                  gchar*                : Read / Write / Construct Only

The ID of the file. This is a substring of the ID returned by gdata_entry_get_id() for GDataPicasaWebFiles; for example, if gdata_entry_get_id() returned "http://picasaweb.google.com/data/entry/user/libgdata.picasaweb/albumid/5328889949261497249/photoid/5328890138794566386" for a particular GDataPicasaWebFile, the "file-id" property would be "5328890138794566386".

For more information, see the gphoto specification.

Default value: NULL

Since 0.7.0


The "flash" property

  "flash"                    gboolean              : Read

Indicates whether the flash was used.

For more information, see the EXIF element reference.

Default value: FALSE

Since 0.5.0


The "focal-length" property

  "focal-length"             gdouble               : Read

The focal length for the shot.

For more information, see the EXIF element reference.

Allowed values: >= -1

Default value: -1

Since 0.5.0


The "fstop" property

  "fstop"                    gdouble               : Read

The F-stop value.

For more information, see the EXIF element reference.

Allowed values: >= 0

Default value: 0

Since 0.5.0


The "height" property

  "height"                   guint                 : Read

The height of the photo or video, in pixels.

For more information, see the gphoto specification.

Default value: 0

Since 0.4.0


The "image-unique-id" property

  "image-unique-id"          gchar*                : Read

An unique ID for the image found in the EXIF.

For more information, see the EXIF element reference.

Default value: NULL

Since 0.5.0


The "is-commenting-enabled" property

  "is-commenting-enabled"    gboolean              : Read / Write

Whether commenting is enabled for this file.

Default value: TRUE

Since 0.4.0


The "iso" property

  "iso"                      glong                 : Read

The ISO speed.

For more information, see the EXIF element reference and ISO 5800:1987.

Allowed values: >= -1

Default value: -1

Since 0.5.0


The "latitude" property

  "latitude"                 gdouble               : Read / Write

The location as a latitude coordinate associated with this file. Valid latitudes range from -90.0 to 90.0 inclusive.

For more information, see the GeoRSS specification.

Allowed values: [-90,90]

Default value: 0

Since 0.5.0


The "longitude" property

  "longitude"                gdouble               : Read / Write

The location as a longitude coordinate associated with this file. Valid longitudes range from -180.0 to 180.0 inclusive.

For more information, see the GeoRSS specification.

Allowed values: [-180,180]

Default value: 0

Since 0.5.0


The "make" property

  "make"                     gchar*                : Read

The name of the manufacturer of the camera.

For more information, see the EXIF element reference.

Default value: NULL

Since 0.5.0


The "model" property

  "model"                    gchar*                : Read

The model of the camera.

For more information, see the EXIF element reference.

Default value: NULL

Since 0.5.0


The "rotation" property

  "rotation"                 guint                 : Read / Write

The rotation of the photo, in degrees. This will only be non-zero for files which are pending rotation, and haven't yet been permanently modified. For files which have already been rotated, this will be 0.

For more information, see the gphoto specification.

Allowed values: <= 359

Default value: 0

Since 0.4.0


The "size" property

  "size"                     gulong                : Read

The size of the file, in bytes.

For more information, see the gphoto specification.

Since 0.4.0


The "tags" property

  "tags"                     GStrv                 : Read / Write

A NULL-terminated array of tags associated with the file.

For more information, see the Media RSS specification.

Since 0.4.0


The "timestamp" property

  "timestamp"                gint64                : Read / Write

The time the file was purportedly taken. This a UNIX timestamp in milliseconds (not seconds) since the epoch.

For more information, see the gphoto specification.

Allowed values: >= -1

Default value: -1

Since 0.4.0


The "version" property

  "version"                  gchar*                : Read / Write / Construct Only

The version number of the file. Version numbers are based on modification time, so they don't increment linearly.

For more information, see the gphoto specification.

Default value: NULL

Since 0.4.0


The "video-status" property

  "video-status"             gchar*                : Read

The status of the file, if it is a video. For example: GDATA_PICASAWEB_VIDEO_STATUS_PENDING or GDATA_PICASAWEB_VIDEO_STATUS_FAILED.

For more information, see the gphoto specification.

Default value: NULL

Since 0.4.0


The "width" property

  "width"                    guint                 : Read

The width of the photo or video, in pixels.

For more information, see the gphoto specification.

Default value: 0

Since 0.4.0