/**
 * @file	smfpicture.h
 * @author  Nalina Hariharan, Sasken Communication Technologies Ltd - Initial contribution
 * @version 1.0
 *
 * @section LICENSE
 *
 * Copyright (c) 2010 Sasken Communication Technologies Ltd. 
 * All rights reserved.
 * This component and the accompanying materials are made available 
 * under the terms of the "{License}" 
 * which accompanies  this distribution, and is available 
 * at the URL "{LicenseUrl}".
 * 
 * @section DESCRIPTION
 *
 * The picture class represents an instance of a picture
 */

#ifndef SMFPICTURE_H_
#define SMFPICTURE_H_

#include <QDateTime>
#include <QStringList>
#include <QUrl>
#include <qdatastream.h>
#include "SmfClientGlobal.h"
/**
 * SmfPictureVisibility enumeration
 */
enum SmfPictureVisibility
	{
	SMFVisibilityFriend,
	SMFVisibilityPersonal,
	SMFVisibilityFamily,
	SMFVisibilityGroup,
	SMFVisibilityPublic
	};
/**
 * The picture class represents an instance of a picture
 */
class SMFCLIENT_EXPORT SmfPicture : public QObject
	{
	Q_OBJECT
public:
	/**
	 * Constructor with default argument
	 * @param aParent The parent object
	 */
	SmfPicture( QObject *aParent = 0 );
	
	/**
	 * Destructor
	 */
	~SmfPicture( );
	
	
	/**
	 * Method to get the id of the picture
	 * @param aId The ID value 
	 */
	void getId( QString &aId );
	
	/**
	 * Method to get a picture owner
	 * @param aOwner The owner of the picture
	 */
	void getOwner( QString &aOwner );
	
	/**
	 * Method to get a picture title
	 * @param aTitle The title of the picture
	 */
	void getTitle( QString &aTitle );
	
	/**
	 * Method to get a picture description
	 * @param aDescription The description of the picture
	 */
	void getDescription( QString &aDescription );
	
	/**
	 * Method to get a visibility of a picture for public
	 * @param aVisibility The visibility mode of 
	 * this picture for others
	 */
	void getVisibility( SmfPictureVisibility &aVisibility );
	
	/**
	 * Method to get the date of posting the picture
	 * @param aPostedOn The posted date of the picture
	 */
	void getPostedDate( QDateTime &aPostedOn );
	
	/**
	 * Method to get the comments for the picture
	 * @param aComments The comments for the picture
	 */
	void getComments( QStringList &aComments );
	
	/**
	 * Method to get the tags for the picture
	 * @param aTags The tags for the picture
	 */
	void getTags( QStringList &aTags );
	
	/**
	 * Method to get the url of the picture
	 * @param aUrl The url of the picture
	 */
	void getUrl( QUrl &aUrl );
	
	/**
	 * Method to get the picture data as a byte array
	 * @param aData The picture as a byte array
	 */
	void getPicture( QByteArray &aData );
		
	/**
	 * Method to set a picture owner
	 * @param aOwner The owner of the picture
	 */
	void setOwner( const QString &aOwner );
	
	/**
	 * Method to set a picture title
	 * @param aTitle The title of the picture
	 */
	void setTitle( const QString &aTitle );
	
	/**
	 * Method to set a picture description
	 * @param aDescription The description of the picture
	 */
	void setDescription( const QString &aDescription );
	
	/**
	 * Method to set a visibility of a picture for public
	 * @param aVisibility aVisibility The visibility mode of 
	 * this picture for others
	 */
	void setVisibility( const SmfPictureVisibility &aVisibility );
	
	/**
	 * Method to set the date of posting the picture
	 * @param aPostedOn The posted date of the picture
	 */
	void setPostedDate( const QDateTime &aPostedOn );
	
	/**
	 * Method to set the comments for the picture
	 * @param aComment The comment for the picture
	 */
	void setComment( const QString &aComment );
	
	/**
	 * Method to set the tags for the picture
	 * @param aTag The tag for the picture
	 */
	void setTag( const QString &aTag );
	
	/**
	 * Method to set the picture data as a byte array
	 * @param aData The picture as a byte array
	 */
	void setPicture( const QByteArray &aData );
	
private:
	QString m_photoid;		// unique ID of the picture, service provider specific
	QString m_owner;	// owner of the picture
	QString m_title;	// picture title
	QString m_descrition;// description
	bool m_ispublic;// visibility for public, Set to 0 for no, 1 for yes.
	bool m_isfriend;// visilibility for friends Set to 0 for no, 1 for yes.
	bool m_isfamily;// visilibility for family Set to 0 for no, 1 for yes.
	QDateTime m_postedon;// date posted
	QStringList m_comments;// comments
	QStringList m_tags;	// tags
	QUrl m_url;			// url
	QByteArray* m_picture;	// picture data as bytearray
	QString m_caption;	// caption
	
	};
/**
* Externalization
*/
QDataStream &operator<<(QDataStream &, const SmfPicture&);
/**
 * Internalization
 */
QDataStream &operator>>(QDataStream &, SmfPicture&);
#endif /* SMFPICTURE_H_ */