digiKam Developer Documentation
Professional Photo Management with the Power of Open Source
Loading...
Searching...
No Matches
Digikam::DItemInfo Class Reference

DItemInfo is a class to get item information from host application (Showfoto or digiKam) The interface is re-implemented in host and depend how item information must be retrieved (from a database or by file metadata). More...

Public Member Functions

 DItemInfo (const DInfoInterface::DInfoMap &)
 
int albumId () const
 
double altitude () const
 
QString aperture () const
 
CaptionsMap captions () const
 
int colorLabel () const
 
QString comment () const
 
MetaEngine::AltLangMap copyrightNotices () const
 
MetaEngine::AltLangMap copyrights () const
 
QStringList creators () const
 
QString credit () const
 
QDateTime dateTime () const
 
QSize dimensions () const
 
QString exposureTime () const
 
qlonglong fileSize () const
 
QString focalLength () const
 
QString focalLength35mm () const
 
bool hasGeolocationInfo () const
 
DInfoInterface::DInfoMap infoMap () const
 
QStringList keywords () const
 
double latitude () const
 
QString lens () const
 
double longitude () const
 
QString make () const
 
QString model () const
 
QString name () const
 
int orientation () const
 
int pickLabel () const
 
int rating () const
 
QString rights () const
 
QString sensitivity () const
 
void setCaptions (const CaptionsMap &)
 
void setColorLabel (int)
 
void setCopyrightNotices (const MetaEngine::AltLangMap &map)
 
void setCopyrights (const MetaEngine::AltLangMap &map)
 
void setOrientation (int)
 
void setPickLabel (int)
 
void setRating (int)
 
void setTitles (const CaptionsMap &)
 
QString source () const
 
QStringList tagsPath () const
 
QString title () const
 
CaptionsMap titles () const
 
QString videoCodec () const
 

Detailed Description

The easy way to use this container is given below:

// READ INFO FROM HOST ------------------------------------------—

QUrl itemUrl; // The item url that you want to retrieve information. DInfoInterface* hostIface; // The host application interface instance.

DInfoInterface::DInfoMap info = hostIface->itemInfo(itemUrl); // First stage is to get the information map from host application. DItemInfo item(info); // Second stage, is to create the DIntenInfo instance for this item by url. QString title = item.name(); // Now you can retrieve the title, QString description = item.comment(); // The comment, QDateTime time = item.dateTime(); // The time stamp, etc.

// WRITE INFO TO HOST -------------------------------------------—

QUrl itemUrl; // The item url that you want to retrieve information. DInfoInterface* hostIface; // The host application interface instance.

DItemInfo item; // Create the DIntenInfo instance for this item with an empty internal info map. item.setRating(3); // Store rating to internal info map. item.setColorLabel(1); // Store color label to internal info map. hostIface->setItemInfo(url, item.infoMap()); // Update item information to host using internal info map.