/* -*- Mode: C; indent-tabs-mode: t; c-basic-offset: 8; tab-width: 8 -*- */

/*

 * GData Client

 * Copyright (C) Richard Schwarting 2009 <aquarichy@gmail.com>

 * Copyright (C) Philip Withnall 2009–2010 <philip@tecnocode.co.uk>

 *

 * GData Client is free software; you can redistribute it and/or

 * modify it under the terms of the GNU Lesser General Public

 * License as published by the Free Software Foundation; either

 * version 2.1 of the License, or (at your option) any later version.

 *

 * GData Client is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU

 * Lesser General Public License for more details.

 *

 * You should have received a copy of the GNU Lesser General Public

 * License along with GData Client.  If not, see <http://www.gnu.org/licenses/>.

 */

/**

 * SECTION:gdata-picasaweb-file

 * @short_description: GData PicasaWeb file object

 * @stability: Stable

 * @include: gdata/services/picasaweb/gdata-picasaweb-file.h

 *

 * #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

 * <ulink type="http" url="http://code.google.com/apis/picasaweb/developers_guide_protocol.html">online documentation</ulink>.

 *

 * <example>

 *	<title>Getting Basic Photo Data</title>

 *	<programlisting>

 *	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);

 *	</programlisting>

 * </example>

 *

 * Since: 0.4.0

 */

#include <config.h>

#include <glib.h>

#include <glib/gi18n-lib.h>

#include <libxml/parser.h>

#include <string.h>

#include "gdata-picasaweb-file.h"

#include "gdata-private.h"

#include "gdata-service.h"

#include "gdata-parser.h"

#include "gdata-types.h"

#include "media/gdata-media-group.h"

#include "exif/gdata-exif-tags.h"

#include "georss/gdata-georss-where.h"

#include "gd/gdata-gd-feed-link.h"

#include "gdata-commentable.h"

#include "gdata-picasaweb-comment.h"

#include "gdata-picasaweb-service.h"

static GObject *gdata_picasaweb_file_constructor (GType type, guint n_construct_params, GObjectConstructParam *construct_params);

static void gdata_picasaweb_file_dispose (GObject *object);

static void gdata_picasaweb_file_finalize (GObject *object);

static void gdata_picasaweb_file_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec);

static void gdata_picasaweb_file_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec);

static void get_xml (GDataParsable *parsable, GString *xml_string);

static gboolean parse_xml (GDataParsable *parsable, xmlDoc *doc, xmlNode *node, gpointer user_data, GError **error);

static void get_namespaces (GDataParsable *parsable, GHashTable *namespaces);

static gchar *get_entry_uri (const gchar *id) G_GNUC_WARN_UNUSED_RESULT;

GDataAuthorizationDomain *get_authorization_domain (GDataCommentable *self) G_GNUC_CONST;

static gchar *get_query_comments_uri (GDataCommentable *self) G_GNUC_MALLOC G_GNUC_WARN_UNUSED_RESULT;

static gchar *get_insert_comment_uri (GDataCommentable *self, GDataComment *comment_) G_GNUC_MALLOC G_GNUC_WARN_UNUSED_RESULT;

static gboolean is_comment_deletable (GDataCommentable *self, GDataComment *comment_);

static void gdata_picasaweb_file_commentable_init (GDataCommentableInterface *iface);

struct _GDataPicasaWebFilePrivate {

	gchar *file_id;

	gint64 edited;

	gchar *version;

	gchar *album_id;

	guint width;

	guint height;

	gsize size;

	gchar *checksum;

	gint64 timestamp; /* in milliseconds! */

	gboolean is_commenting_enabled;

	guint comment_count;

	guint rotation;

	gchar *video_status;

	/* media:group */

	GDataMediaGroup *media_group;

	/* exif:tags */

	GDataExifTags *exif_tags;

	/* georss:where */

	GDataGeoRSSWhere *georss_where;

};

enum {

	PROP_EDITED = 1,

	PROP_VERSION,

	PROP_ALBUM_ID,

	PROP_WIDTH,

	PROP_HEIGHT,

	PROP_SIZE,

	PROP_CHECKSUM,

	PROP_TIMESTAMP,

	PROP_IS_COMMENTING_ENABLED,

	PROP_COMMENT_COUNT,

	PROP_ROTATION,

	PROP_VIDEO_STATUS,

	PROP_CREDIT,

	PROP_CAPTION,

	PROP_TAGS,

	PROP_DISTANCE,

	PROP_EXPOSURE,

	PROP_FLASH,

	PROP_FOCAL_LENGTH,

	PROP_FSTOP,

	PROP_IMAGE_UNIQUE_ID,

	PROP_ISO,

	PROP_MAKE,

	PROP_MODEL,

	PROP_LATITUDE,

	PROP_LONGITUDE,

	PROP_FILE_ID

};

G_DEFINE_TYPE_WITH_CODE (GDataPicasaWebFile, gdata_picasaweb_file, GDATA_TYPE_ENTRY,

                         G_IMPLEMENT_INTERFACE (GDATA_TYPE_COMMENTABLE, gdata_picasaweb_file_commentable_init))

static void

gdata_picasaweb_file_class_init (GDataPicasaWebFileClass *klass)

{

	GObjectClass *gobject_class = G_OBJECT_CLASS (klass);

	GDataParsableClass *parsable_class = GDATA_PARSABLE_CLASS (klass);

	GDataEntryClass *entry_class = GDATA_ENTRY_CLASS (klass);

	g_type_class_add_private (klass, sizeof (GDataPicasaWebFilePrivate));

	gobject_class->constructor = gdata_picasaweb_file_constructor;

	gobject_class->get_property = gdata_picasaweb_file_get_property;

	gobject_class->set_property = gdata_picasaweb_file_set_property;

	gobject_class->dispose = gdata_picasaweb_file_dispose;

	gobject_class->finalize = gdata_picasaweb_file_finalize;

	parsable_class->get_xml = get_xml;

	parsable_class->parse_xml = parse_xml;

	parsable_class->get_namespaces = get_namespaces;

	entry_class->get_entry_uri = get_entry_uri;

	entry_class->kind_term = "http://schemas.google.com/photos/2007#photo";

	/**

	 * GDataPicasaWebFile:file-id:

	 *

	 * 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 #GDataPicasaWebFile:file-id property would be "5328890138794566386".

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_id">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.7.0

	 */

	g_object_class_install_property (gobject_class, PROP_FILE_ID,

	                                 g_param_spec_string ("file-id",

	                                                      "File ID", "The ID of the file.",

	                                                      NULL,

	                                                      G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:version:

	 *

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

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_version">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_VERSION,

	                                 g_param_spec_string ("version",

	                                                      "Version", "The version number of the file.",

	                                                      NULL,

	                                                      G_PARAM_READWRITE | G_PARAM_CONSTRUCT_ONLY | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:album-id:

	 *

	 * 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 <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_albumid">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_ALBUM_ID,

	                                 g_param_spec_string ("album-id",

	                                                      "Album ID", "The ID for the file's album.",

	                                                      NULL,

	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:checksum:

	 *

	 * A checksum of the file, useful for duplicate detection.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_checksum">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_CHECKSUM,

	                                 g_param_spec_string ("checksum",

	                                                      "Checksum", "A checksum of the file, useful for duplicate detection.",

	                                                      NULL,

	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:video-status:

	 *

	 * 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 <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_videostatus">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_VIDEO_STATUS,

	                                 g_param_spec_string ("video-status",

	                                                      "Video Status", "The status of the file, if it is a video.",

	                                                      NULL,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:width:

	 *

	 * The width of the photo or video, in pixels.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_width">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_WIDTH,

	                                 g_param_spec_uint ("width",

	                                                    "Width", "The width of the photo or video, in pixels.",

	                                                    0, G_MAXUINT, 0,

	                                                    G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:height:

	 *

	 * The height of the photo or video, in pixels.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_height">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_HEIGHT,

	                                 g_param_spec_uint ("height",

	                                                    "Height", "The height of the photo or video, in pixels.",

	                                                    0, G_MAXUINT, 0,

	                                                    G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:size:

	 *

	 * The size of the file, in bytes.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_size">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_SIZE,

	                                 g_param_spec_ulong ("size",

	                                                     "Size", "The size of the file, in bytes.",

	                                                     0, G_MAXULONG, 0,

	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:edited:

	 *

	 * 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 <ulink type="http" url="http://www.atomenabled.org/developers/protocol/#appEdited">

	 * Atom Publishing Protocol specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_EDITED,

	                                 g_param_spec_int64 ("edited",

	                                                     "Edited", "The time this file was last edited.",

	                                                     -1, G_MAXINT64, -1,

	                                                     G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:timestamp:

	 *

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

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_timestamp">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_TIMESTAMP,

	                                 g_param_spec_int64 ("timestamp",

	                                                     "Timestamp", "The time the file was purportedly taken.",

	                                                     -1, G_MAXINT64, -1,

	                                                     G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:comment-count:

	 *

	 * The number of comments on the file.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_commentCount">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_COMMENT_COUNT,

	                                 g_param_spec_uint ("comment-count",

	                                                    "Comment Count", "The number of comments on the file.",

	                                                    0, G_MAXUINT, 0,

	                                                    G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:rotation:

	 *

	 * 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 <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#gphoto_rotation">

	 * gphoto specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_ROTATION,

	                                 g_param_spec_uint ("rotation",

	                                                    "Rotation", "The rotation of the photo, in degrees.",

	                                                    0, 359, 0,

	                                                    G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:is-commenting-enabled:

	 *

	 * Whether commenting is enabled for this file.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_IS_COMMENTING_ENABLED,

	                                 g_param_spec_boolean ("is-commenting-enabled",

	                                                       "Commenting enabled?", "Indicates whether comments are enabled.",

	                                                       TRUE,

	                                                       G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:credit:

	 *

	 * The nickname of the user credited with this file.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#media_credit">Media RSS

	 * specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_CREDIT,

	                                 g_param_spec_string ("credit",

	                                                      "Credit", "The nickname of the user credited with this file.",

	                                                      NULL,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:caption:

	 *

	 * The file's descriptive caption.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_CAPTION,

	                                 g_param_spec_string ("caption",

	                                                      "Caption", "The file's descriptive caption.",

	                                                      NULL,

	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:tags:

	 *

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

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#media_keywords">

	 * Media RSS specification</ulink>.

	 *

	 * Since: 0.4.0

	 */

	g_object_class_install_property (gobject_class, PROP_TAGS,

	                                 g_param_spec_boxed ("tags",

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

	                                                     G_TYPE_STRV,

	                                                     G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:distance:

	 *

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

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_DISTANCE,

	                                 g_param_spec_double ("distance",

	                                                      "Distance", "The distance to the subject.",

	                                                      -1.0, G_MAXDOUBLE, -1.0,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:exposure:

	 *

	 * The exposure time.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_EXPOSURE,

	                                 g_param_spec_double ("exposure",

	                                                      "Exposure", "The exposure time.",

	                                                      0.0, G_MAXDOUBLE, 0.0,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:flash:

	 *

	 * Indicates whether the flash was used.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_FLASH,

	                                 g_param_spec_boolean ("flash",

	                                                       "Flash", "Indicates whether the flash was used.",

	                                                       FALSE,

	                                                       G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:focal-length:

	 *

	 * The focal length for the shot.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_FOCAL_LENGTH,

	                                 g_param_spec_double ("focal-length",

	                                                      "Focal Length", "The focal length used in the shot.",

	                                                      -1.0, G_MAXDOUBLE, -1.0,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/* TODO: Rename to f-stop */

	/**

	 * GDataPicasaWebFile:fstop:

	 *

	 * The F-stop value.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_FSTOP,

	                                 g_param_spec_double ("fstop",

	                                                      "F-stop", "The F-stop used.",

	                                                      0.0, G_MAXDOUBLE, 0.0,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:image-unique-id:

	 *

	 * An unique ID for the image found in the EXIF.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_IMAGE_UNIQUE_ID,

	                                 g_param_spec_string ("image-unique-id",

	                                                      "Image Unique ID", "An unique ID for the image.",

	                                                      NULL,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:iso:

	 *

	 * The ISO speed.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink> and ISO 5800:1987.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_ISO,

	                                 g_param_spec_long ("iso",

	                                                    "ISO", "The ISO speed.",

	                                                    -1, G_MAXLONG, -1,

	                                                    G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:make:

	 *

	 * The name of the manufacturer of the camera.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_MAKE,

	                                 g_param_spec_string ("make",

	                                                      "Make", "The name of the manufacturer.",

	                                                      NULL,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:model:

	 *

	 * The model of the camera.

	 *

	 * For more information, see the <ulink type="http" url="http://code.google.com/apis/picasaweb/reference.html#exif_reference">

	 * EXIF element reference</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_MODEL,

	                                 g_param_spec_string ("model",

	                                                      "Model", "The model of the camera.",

	                                                      NULL,

	                                                      G_PARAM_READABLE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:latitude:

	 *

	 * 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 <ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where">

	 * GeoRSS specification</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_LATITUDE,

	                                 g_param_spec_double ("latitude",

	                                                      "Latitude", "The location as a latitude coordinate associated with this file.",

	                                                      -90.0, 90.0, 0.0,

	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

	/**

	 * GDataPicasaWebFile:longitude:

	 *

	 * 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 <ulink type="http" url="http://code.google.com/apis/picasaweb/docs/2.0/reference.html#georss_where">

	 * GeoRSS specification</ulink>.

	 *

	 * Since: 0.5.0

	 */

	g_object_class_install_property (gobject_class, PROP_LONGITUDE,

	                                 g_param_spec_double ("longitude",

	                                                      "Longitude", "The location as a longitude coordinate associated with this file.",

	                                                      -180.0, 180.0, 0.0,

	                                                      G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS));

}

static void

gdata_picasaweb_file_commentable_init (GDataCommentableInterface *iface)

{

	iface->comment_type = GDATA_TYPE_PICASAWEB_COMMENT;

	iface->get_authorization_domain = get_authorization_domain;

	iface->get_query_comments_uri = get_query_comments_uri;

	iface->get_insert_comment_uri = get_insert_comment_uri;

	iface->is_comment_deletable = is_comment_deletable;

}

static void

notify_title_cb (GDataPicasaWebFile *self, GParamSpec *pspec, gpointer user_data)

{

	/* Keep the atom:title and media:group/media:title in sync */

	if (self->priv->media_group != NULL)

		gdata_media_group_set_title (self->priv->media_group, gdata_entry_get_title (GDATA_ENTRY (self)));

}

static void

notify_summary_cb (GDataPicasaWebFile *self, GParamSpec *pspec, gpointer user_data)

{

	/* Keep the atom:summary and media:group/media:description in sync */

	if (self->priv->media_group != NULL)

		gdata_media_group_set_description (self->priv->media_group, gdata_entry_get_summary (GDATA_ENTRY (self)));

}

static void

gdata_picasaweb_file_init (GDataPicasaWebFile *self)

{

	self->priv = G_TYPE_INSTANCE_GET_PRIVATE (self, GDATA_TYPE_PICASAWEB_FILE, GDataPicasaWebFilePrivate);

	self->priv->media_group = g_object_new (GDATA_TYPE_MEDIA_GROUP, NULL);

	self->priv->exif_tags = g_object_new (GDATA_TYPE_EXIF_TAGS, NULL);

	self->priv->georss_where = g_object_new (GDATA_TYPE_GEORSS_WHERE, NULL);

	self->priv->is_commenting_enabled = TRUE;

	self->priv->edited = -1;

	self->priv->timestamp = -1;

	/* We need to keep atom:title (the canonical title for the file) in sync with media:group/media:title */

	g_signal_connect (self, "notify::title", G_CALLBACK (notify_title_cb), NULL);

	/* atom:summary (the canonical summary/caption for the file) in sync with media:group/media:description */

	g_signal_connect (self, "notify::summary", G_CALLBACK (notify_summary_cb), NULL);

}

static GObject *

gdata_picasaweb_file_constructor (GType type, guint n_construct_params, GObjectConstructParam *construct_params)

{

	GObject *object;

	/* Chain up to the parent class */

	object = G_OBJECT_CLASS (gdata_picasaweb_file_parent_class)->constructor (type, n_construct_params, construct_params);

	if (_gdata_parsable_is_constructed_from_xml (GDATA_PARSABLE (object)) == FALSE) {

		GDataPicasaWebFilePrivate *priv = GDATA_PICASAWEB_FILE (object)->priv;

		GTimeVal time_val;

		/* Set the edited and timestamp properties to the current time (creation time). bgo#599140

		 * We don't do this in *_init() since that would cause setting it from parse_xml() to fail (duplicate element). */

		g_get_current_time (&time_val);

		priv->timestamp = (gint64) time_val.tv_sec * 1000;

		priv->edited = time_val.tv_sec;

	}

	return object;

}

static void

gdata_picasaweb_file_dispose (GObject *object)

{

	GDataPicasaWebFilePrivate *priv = GDATA_PICASAWEB_FILE (object)->priv;

	if (priv->media_group != NULL)

		g_object_unref (priv->media_group);

	priv->media_group = NULL;

	if (priv->exif_tags != NULL)

		g_object_unref (priv->exif_tags);

	priv->exif_tags = NULL;

	if (priv->georss_where != NULL)

		g_object_unref (priv->georss_where);

	priv->georss_where = NULL;

	/* Chain up to the parent class */

	G_OBJECT_CLASS (gdata_picasaweb_file_parent_class)->dispose (object);

}

static void

gdata_picasaweb_file_finalize (GObject *object)

{

	GDataPicasaWebFilePrivate *priv = GDATA_PICASAWEB_FILE (object)->priv;

	g_free (priv->file_id);

	g_free (priv->version);

	g_free (priv->album_id);

	g_free (priv->checksum);

	g_free (priv->video_status);

	/* Chain up to the parent class */

	G_OBJECT_CLASS (gdata_picasaweb_file_parent_class)->finalize (object);

}

static void

gdata_picasaweb_file_get_property (GObject *object, guint property_id, GValue *value, GParamSpec *pspec)

{

	GDataPicasaWebFilePrivate *priv = GDATA_PICASAWEB_FILE (object)->priv;

	switch (property_id) {

		case PROP_FILE_ID:

			g_value_set_string (value, priv->file_id);

			break;

		case PROP_EDITED:

			g_value_set_int64 (value, priv->edited);

			break;

		case PROP_VERSION:

			g_value_set_string (value, priv->version);

			break;

		case PROP_ALBUM_ID:

			g_value_set_string (value, priv->album_id);

			break;

		case PROP_WIDTH:

			g_value_set_uint (value, priv->width);

			break;

		case PROP_HEIGHT:

			g_value_set_uint (value, priv->height);

			break;

		case PROP_SIZE:

			g_value_set_ulong (value, priv->size);

			break;

		case PROP_CHECKSUM:

			g_value_set_string (value, priv->checksum);

			break;

		case PROP_TIMESTAMP:

			g_value_set_int64 (value, priv->timestamp);

			break;

		case PROP_IS_COMMENTING_ENABLED:

			g_value_set_boolean (value, priv->is_commenting_enabled);

			break;

		case PROP_COMMENT_COUNT:

			g_value_set_uint (value, priv->comment_count);

			break;

		case PROP_ROTATION:

			g_value_set_uint (value, priv->rotation);

			break;

		case PROP_VIDEO_STATUS:

			g_value_set_string (value, priv->video_status);

			break;

		case PROP_CREDIT: {

			GDataMediaCredit *credit = gdata_media_group_get_credit (priv->media_group);

			g_value_set_string (value, gdata_media_credit_get_credit (credit));

			break; }

		case PROP_CAPTION:

			g_value_set_string (value, gdata_entry_get_summary (GDATA_ENTRY (object)));

			break;

		case PROP_TAGS:

			g_value_set_boxed (value, gdata_media_group_get_keywords (priv->media_group));

			break;

		case PROP_DISTANCE:

			g_value_set_double (value, gdata_exif_tags_get_distance (priv->exif_tags));

			break;

		case PROP_EXPOSURE:

			g_value_set_double (value, gdata_exif_tags_get_exposure (priv->exif_tags));

			break;

		case PROP_FLASH:

			g_value_set_boolean (value, gdata_exif_tags_get_flash (priv->exif_tags));

			break;

		case PROP_FOCAL_LENGTH:

			g_value_set_double (value, gdata_exif_tags_get_focal_length (priv->exif_tags));

			break;

		case PROP_FSTOP:

			g_value_set_double (value, gdata_exif_tags_get_fstop (priv->exif_tags));

			break;

		case PROP_IMAGE_UNIQUE_ID:

			g_value_set_string (value, gdata_exif_tags_get_image_unique_id (priv->exif_tags));

			break;

		case PROP_ISO:

			g_value_set_long (value, gdata_exif_tags_get_iso (priv->exif_tags));

			break;

		case PROP_MAKE:

			g_value_set_string (value, gdata_exif_tags_get_make (priv->exif_tags));

			break;

		case PROP_MODEL:

			g_value_set_string (value, gdata_exif_tags_get_model (priv->exif_tags));

			break;

		case PROP_LATITUDE:

			g_value_set_double (value, gdata_georss_where_get_latitude (priv->georss_where));

			break;

		case PROP_LONGITUDE:

			g_value_set_double (value, gdata_georss_where_get_longitude (priv->georss_where));

			break;

		default:

			/* We don't have any other property... */

			G_OBJECT_WARN_INVALID_PROPERTY_ID (object, property_id, pspec);

			break;

	}

}

static void

gdata_picasaweb_file_set_property (GObject *object, guint property_id, const GValue *value, GParamSpec *pspec)

{

	GDataPicasaWebFile *self = GDATA_PICASAWEB_FILE (object);

	switch (property_id) {

		case PROP_FILE_ID:

			/* Construct only */

			g_free (self->priv->file_id);

			self->priv->file_id = g_value_dup_string (value);

			break;

		case PROP_VERSION:

			/* Construct only */

			g_free (self->priv->version);

			self->priv->version = g_value_dup_string (value);

			break;

		case PROP_ALBUM_ID:

			/* TODO: do we allow this to change albums? I think that's how pictures are moved. */

			gdata_picasaweb_file_set_album_id (self, g_value_get_string (value));

			break;

		case PROP_CHECKSUM:

			gdata_picasaweb_file_set_checksum (self, g_value_get_string (value));

			break;

		case PROP_TIMESTAMP:

			gdata_picasaweb_file_set_timestamp (self, g_value_get_int64 (value));

			break;

		case PROP_IS_COMMENTING_ENABLED: /* TODO I don't think we can change this on a per file basis */

			gdata_picasaweb_file_set_is_commenting_enabled (self, g_value_get_boolean (value));

			break;

		case PROP_ROTATION:

			gdata_picasaweb_file_set_rotation (self, g_value_get_uint (value));

			break;

		case PROP_CAPTION:

			gdata_picasaweb_file_set_caption (self, g_value_get_string (value));

			break;

		case PROP_TAGS:

			gdata_picasaweb_file_set_tags (self, g_value_get_boxed (value));

			break;

		case PROP_LATITUDE:

			gdata_picasaweb_file_set_coordinates (self, g_value_get_double (value),

			                                      gdata_georss_where_get_longitude (self->priv->georss_where));

			break;

		case PROP_LONGITUDE: