qevercloud::Thumbnail Class Reference

The class is for downloading thumbnails for notes and resources from Evernote servers. More...

Classes
struct	ImageType
	Specifies image type of the returned thumbnail. More...

Public Member Functions
	Thumbnail ()
	Default constructor. More...
	Thumbnail (QString host, QString shardId, QString authenticationToken, int size=300, ImageType::type imageType=ImageType::PNG)
	Constructs Thumbnail. More...
QPair< QNetworkRequest, QByteArray >	createPostRequest (qevercloud::Guid guid, bool isPublic=false, bool isResourceGuid=false)
	Prepares a POST request for a thumbnail download. More...
QByteArray	download (Guid guid, bool isPublic=false, bool isResourceGuid=false)
	Downloads the thumbnail for a resource or a note. More...
AsyncResult *	downloadAsync (Guid guid, bool isPublic=false, bool isResourceGuid=false)
	Asynchronous version of download function.
Thumbnail &	setAuthenticationToken (QString authenticationToken)
Thumbnail &	setHost (QString host)
Thumbnail &	setImageType (ImageType::type imageType)
Thumbnail &	setShardId (QString shardId)
Thumbnail &	setSize (int size)

Detailed Description

The class is for downloading thumbnails for notes and resources from Evernote servers.

This thumbnails are available not with general EDAM Thrift interface as explained in the documentation.

Usage:

Thumbnail thumb("www.evernote.com", sharId, authenticationToken);
QByteArray pngImage = thumb.download(noteGuid);

By defualt 300x300 PNG images are requested.

Constructor & Destructor Documentation

qevercloud::Thumbnail::Thumbnail ( )

inline

Default constructor.

host, shardId, authenticationToken have to be specified before calling download or createPostRequest

qevercloud::Thumbnail::Thumbnail ( QString  host, QString  shardId, QString  authenticationToken, int  size = 300, ImageType::type  imageType = ImageType::PNG  )

inline

Constructs Thumbnail.

Parameters

host	www.evernote.com or sandbox.evernote.com
shardId	You can get the value from UserStore service or as a result of an authentication.
authenticationToken	For working privite notes/resources you must supply a valid authentication token. For public resources the value specified is not used.
size	The size of the thumbnail. Evernote supports values from from 1 to 300. By defualt 300 is used.
imageType	Thumbnail image type. See ImageType. By default PNG is used.

Member Function Documentation

QPair<QNetworkRequest, QByteArray> qevercloud::Thumbnail::createPostRequest	(	qevercloud::Guid	guid,
		bool	isPublic = false,
		bool	isResourceGuid = false
	)

Prepares a POST request for a thumbnail download.

Parameters

guid	The note or resource guid
isPublic	Specify true for public notes/resources. In this case authentication token is not sent to with the request as it shoud be according to the docs.
isResourceGuid	true if guid denotes a resource and false if it denotes a note.

Returns

a pair of QNetworkRequest for the POST request and data that must be posted with the request.

QByteArray qevercloud::Thumbnail::download	(	Guid	guid,
		bool	isPublic = false,
		bool	isResourceGuid = false
	)

Downloads the thumbnail for a resource or a note.

Parameters

guid	The note or resource guid
isPublic	Specify true for public notes/resources. In this case authentication token is not sent to with the request as it shoud be according to the docs.
isResourceGuid	true if guid denotes a resource and false if it denotes a note.

Returns

downloaded data.

Thumbnail& qevercloud::Thumbnail::setAuthenticationToken

(

QString

authenticationToken

)

Parameters

authenticationToken

For working privite notes/resources you must supply a valid authentication token. For public resources the value specified is not used.

Thumbnail& qevercloud::Thumbnail::setHost

(

QString

host

)

Parameters

host	www.evernote.com or sandbox.evernote.com

Thumbnail& qevercloud::Thumbnail::setImageType

(

ImageType::type

imageType

)

Parameters

imageType

Thumbnail image type. See ImageType. By default PNG is used.

Thumbnail& qevercloud::Thumbnail::setShardId

(

QString

shardId

)

Parameters

shardId

You can get the value from UserStore service or as a result of an authentication.

Thumbnail& qevercloud::Thumbnail::setSize

(

int

size

)

Parameters

size	The size of the thumbnail. Evernote supports values from from 1 to 300. By defualt 300 is used.