![]() |
digiKam Developer Documentation
Professional Photo Management with the Power of Open Source
|
Public Member Functions | |
CoreDB (CoreDbBackend *const backend) | |
Constructor. | |
~CoreDB () | |
Destructor. | |
int | addAlbum (int albumRootId, const QString &relativePath, const QString &caption, const QDate &date, const QString &collection) const |
Add a new album to the database with the given attributes. | |
int | addAlbumRoot (CollectionLocation::Type type, const QString &identifier, const QString &specificPath, const QString &label) const |
Add a new album to the database with the given attributes. | |
void | addImageMetadata (qlonglong imageID, const QVariantList &infos, DatabaseFields::ImageMetadata fields=DatabaseFields::ImageMetadataAll) |
Add (or replace) the ImageMetadata of the specified item. | |
void | addImageRelation (const ImageRelation &relation) |
void | addImageRelation (qlonglong subjectId, qlonglong objectId, DatabaseRelation::Type type) |
Adds an image relation entry. | |
void | addImageRelations (const QList< qlonglong > &subjectIds, const QList< qlonglong > &objectIds, DatabaseRelation::Type type) |
This method requires two lists of same size and will add list1[0]->list2[0],...,list1[n]->list2[n]. | |
void | addImageTagProperty (const ImageTagProperty &property) |
void | addImageTagProperty (qlonglong imageId, int tagId, const QString &property, const QString &value) |
Adds a tag property. | |
qlonglong | addItem (int albumID, const QString &name, DatabaseItem::Status status, DatabaseItem::Category category, const QDateTime &modificationDate, qlonglong fileSize, const QString &uniqueHash) const |
Put a new item in the database or replace an existing one. | |
void | addItemInformation (qlonglong imageID, const QVariantList &infos, DatabaseFields::ItemInformation fields=DatabaseFields::ItemInformationAll) |
Add (or replace) the ItemInformation of the specified item. | |
void | addItemPosition (qlonglong imageID, const QVariantList &infos, DatabaseFields::ItemPositions fields=DatabaseFields::ItemPositionsAll) |
Add (or replace) the ItemPosition of the specified item. | |
void | addItemTag (int albumID, const QString &name, int tagID) |
Add a tag for the item. | |
void | addItemTag (qlonglong imageID, int tagID, bool newTag=false) |
Add a tag for the item. | |
int | addSearch (DatabaseSearch::Type type, const QString &name, const QString &query) const |
Add a new search to the database with the given attributes. | |
int | addTag (int parentTagID, const QString &name, const QString &iconKDE, qlonglong iconID) const |
Adds a new tag to the database with given name, icon and parent id. | |
void | addTagProperty (const TagProperty &property) |
void | addTagProperty (int tagId, const QString &property, const QString &value) |
Adds a tag property. | |
void | addTagsToItems (const QList< qlonglong > &imageIDs, const QList< int > &tagIDs) |
Add each tag of a list of tags to each member of a list of items. | |
int | addToDownloadHistory (const QString &identifier, const QString &name, qlonglong fileSize, const QDateTime &date) const |
Add the specified fingerprint to the download history table. | |
void | addVideoMetadata (qlonglong imageID, const QVariantList &infos, DatabaseFields::VideoMetadata fields=DatabaseFields::VideoMetadataAll) |
Add (or replace) the VideoMetadata of the specified item. | |
void | changeImageComment (int commentId, qlonglong imageID, const QVariantList &infos, DatabaseFields::ItemComments fields=DatabaseFields::ItemCommentsAll) |
Changes the properties of a comment. | |
void | changeImageMetadata (qlonglong imageID, const QVariantList &infos, DatabaseFields::ImageMetadata fields=DatabaseFields::ImageMetadataAll) |
Change the indicated fields of the image information for the specified item. | |
void | changeItemInformation (qlonglong imageID, const QVariantList &infos, DatabaseFields::ItemInformation fields=DatabaseFields::ItemInformationAll) |
Change the indicated fields of the image information for the specified item. | |
void | changeItemPosition (qlonglong imageID, const QVariantList &infos, DatabaseFields::ItemPositions fields=DatabaseFields::ItemPositionsAll) |
Change the indicated fields of the image information for the specified item. | |
void | changeVideoMetadata (qlonglong imageID, const QVariantList &infos, DatabaseFields::VideoMetadata fields=DatabaseFields::VideoMetadataAll) |
Change the indicated fields of the video information for the specified item. | |
bool | copyAlbumProperties (int srcAlbumID, int dstAlbumID) const |
Copy the properties of the given srcAlbum to the dstAlbum. | |
void | copyImageAttributes (qlonglong srcId, qlonglong destId) |
Copies all image-specific information, in all tables, from image srcId to destId. | |
void | copyImageProperties (qlonglong srcId, qlonglong dstId) |
Copies all entries in the ImageProperties table. | |
void | copyImageTags (qlonglong srcId, qlonglong dstId) |
Copies all entries in the ImageTags table. | |
qlonglong | copyItem (int srcAlbumID, const QString &srcName, int dstAlbumID, const QString &dstName) |
Copy the attributes of an item to a different item. | |
QUuid | databaseUuid () |
Returns a UUID for the database file. | |
void | deleteAlbum (int albumID) |
Deletes an album from the database. | |
void | deleteAlbumRoot (int rootId) |
Deletes an album root from the database. | |
void | deleteItem (int albumID, const QString &file) |
Deletes an item from the database. | |
void | deleteItem (qlonglong imageId) |
Deletes an item from the database if it does not belong to an album. | |
void | deleteObsoleteItem (qlonglong imageId) |
Deletes an item from the database without checking the album. | |
void | deleteRemovedItems () |
Delete all items from the database that are marked as removed. | |
void | deleteSearch (int searchID) |
Delete a search from the database. | |
void | deleteSearches (DatabaseSearch::Type type) |
Delete all search with the given type. | |
void | deleteStaleAlbums () |
Deletes albums from the database that were previously removed with makeStaleAlbum() | |
void | deleteTag (int tagID) |
Deletes a tag from the database. | |
QList< qlonglong > | findByNameAndCreationDate (const QString &fileName, const QDateTime &creationDate) const |
Returns all items with the given file name and creation date. | |
qlonglong | findImageId (int albumID, const QString &name, DatabaseItem::Status status, DatabaseItem::Category category, qlonglong fileSize, const QString &uniqueHash) const |
Find the imageId fitting to the information given for the item. | |
int | findInDownloadHistory (const QString &identifier, const QString &name, qlonglong fileSize, const QDateTime &date) const |
Search for the specified fingerprint in the download history table. | |
QList< int > | getAlbumAndSubalbumsForPath (int albumRootId, const QString &relativePath) const |
Find out the album ids for a given relative path, including the subalbums. | |
QDate | getAlbumAverageDate (int albumID) const |
Returns the average date of all images for that album. | |
int | getAlbumForPath (int albumRootId, const QString &relativePath, bool create=true) const |
Find out the album for a given folder. | |
QDate | getAlbumHighestDate (int albumID) const |
Returns the highest/newest date of all images for that album. | |
QDate | getAlbumLowestDate (int albumID) const |
Returns the lowest/oldest date of all images for that album. | |
QDateTime | getAlbumModificationDate (int albumID) const |
Returns the QDateTime of the album modification date. | |
QMap< QString, QDateTime > | getAlbumModificationMap (int albumRootId) const |
Returns a QMap with relative path and the album modification date. | |
QString | getAlbumRelativePath (int albumID) const |
Given an albumid, this returns the relative path for that album (the path below the album root, starting with a slash) | |
int | getAlbumRootId (int albumID) const |
Given an albumid, this returns the album root id for that album. | |
QList< AlbumRootInfo > | getAlbumRoots () const |
Returns all albums and their attributes in the database. | |
QList< AlbumShortInfo > | getAlbumShortInfos () const |
Returns all albums in the database with their albumRoot and ID, ordered by id. | |
QList< int > | getAlbumsOnAlbumRoot (int albumRootId) const |
Find out all album ids of a given album root. | |
QVariantList | getAllCreationDates () const |
Returns a QVariantList of creationDate of all items. | |
QStringList | getAllImagePropertiesByName (const QString &property) const |
QList< qlonglong > | getAllItems () const |
Returns all ids of items in images table. | |
QHash< qlonglong, QPair< int, int > > | getAllItemsWithAlbum () const |
Returns all ids of items with album ids in images table. | |
QString | getDatabaseEncoding () const |
Returns database encoding. | |
QStringList | getDirtyOrMissingFaceImageUrls () const |
Returns a list of all images where the Faces have either not been detected yet, or is outdated because the file is identified as changed since the generation of the fingerprint. | |
void | getFilterSettings (QStringList *imageFilter, QStringList *videoFilter, QStringList *audioFilter) |
Get the settings for the file name filters of this database. | |
qlonglong | getFirstItemWithFaceTag (int tagId) const |
Returns the first item that has a confirmed face with the tag. | |
QMap< QString, int > | getFormatStatistics () const |
Returns a QMap<QString,int> of ItemInformation.format corresponding to count of items with that format. | |
QMap< QString, int > | getFormatStatistics (DatabaseItem::Category category) const |
QList< ItemScanInfo > | getIdenticalFiles (const QString &uniqueHash, qlonglong fileSize, qlonglong sourceId=-1) const |
QList< ItemScanInfo > | getIdenticalFiles (qlonglong id) const |
Find items that are, with reasonable certainty, identical to the file pointed to by id. | |
void | getIgnoreDirectoryFilterSettings (QStringList *ignoreDirectoryFilter) |
qlonglong | getImageId (int albumID, const QString &name) const |
Get the imageId of the item. | |
QList< qlonglong > | getImageIds (DatabaseItem::Status status) const |
Returns all image ids with the given status. | |
QList< qlonglong > | getImageIds (DatabaseItem::Status status, DatabaseItem::Category category) const |
Returns all image ids with the given status and category. | |
QList< qlonglong > | getImageIds (int albumID, const QString &name, DatabaseItem::Status status) const |
Get the imageId fitting to the information given for the item. | |
QList< qlonglong > | getImageIds (int albumID, DatabaseItem::Status status, bool scanned=true) const |
Get the imageId fitting to the information given for the item. | |
QList< QVariant > | getImageIdsFromArea (qreal lat1, qreal lat2, qreal lng1, qreal lng2, int sortMode, const QString &sortBy) const |
QVariantList | getImageMetadata (qlonglong imageID, DatabaseFields::ImageMetadata metadataFields=DatabaseFields::ImageMetadataAll) const |
Read image metadata. | |
QString | getImageProperty (qlonglong imageID, const QString &property) const |
Returns the property with the specified name for the specified image. | |
QVariantList | getImagesFields (qlonglong imageID, DatabaseFields::Images imagesFields) const |
Returns the requested fields from the Images table. | |
QVector< QList< qlonglong > > | getImagesRelatedFrom (const QList< qlonglong > &subjectIds, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
QList< qlonglong > | getImagesRelatedFrom (qlonglong subjectId, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
Retrieves all images that the given image is related to (retrieves objects, given image is subject) If type is given, filters by type, otherwise returns all types. | |
QVector< QList< qlonglong > > | getImagesRelatingTo (const QList< qlonglong > &objectIds, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
QList< qlonglong > | getImagesRelatingTo (qlonglong objectId, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
Retrieves all images that relate to the given image (retrieves subject, given image is object) If type is given, filters by type, otherwise returns all types. | |
QList< qlonglong > | getImagesWithImageTagProperty (int tagId, const QString &property) const |
Returns all image ids that are associated to the tag with the given property. | |
QList< qlonglong > | getImagesWithProperty (const QString &property) const |
Returns all image ids that are associated to the given property. | |
QList< ImageTagProperty > | getImageTagProperties (qlonglong imageId, int tagId=-1) const |
Get the properties for the given image/tag pair. | |
QString | getImageUuid (qlonglong imageId) const |
Retrieves the image UUID. | |
int | getItemAlbum (qlonglong imageID) const |
Find the album of an item. | |
QList< CommentInfo > | getItemComments (qlonglong imageID) const |
Retrieves all available comments for the specified item. | |
QList< int > | getItemCommonTagIDs (const QList< qlonglong > &imageIDList) const |
Given a set of items (identified by their IDs), get a list of ID of all common tags. | |
QList< CopyrightInfo > | getItemCopyright (qlonglong imageID, const QString &property=QString()) const |
Returns the copyright properties of the specified image. | |
qlonglong | getItemFromAlbum (int albumID, const QString &fileName) const |
Returns the id of the item with the given filename in the album with the given id. | |
ImageHistoryEntry | getItemHistory (qlonglong imageId) const |
Retrieves the history entry for the given image. | |
QMap< qlonglong, QString > | getItemIDsAndURLsInAlbum (int albumID) const |
Given a albumID, get a map of Ids and urls of all items in the album. | |
QList< qlonglong > | getItemIDsInAlbum (int albumID) const |
Given a albumID, get a list of Ids of all items in the album. | |
QList< qlonglong > | getItemIDsInTag (int tagID, bool recursive=false) const |
Given a tagID, get a list of Ids of all items in the tag. | |
QVariantList | getItemInformation (qlonglong imageID, DatabaseFields::ItemInformation infoFields=DatabaseFields::ItemInformationAll) const |
Read image information. | |
QString | getItemName (qlonglong imageID) const |
Retrieve the name of the item. | |
QStringList | getItemNamesInAlbum (int albumID, bool recursive=false) const |
Returns all items for a given albumid. | |
QVariantList | getItemPosition (qlonglong imageID, DatabaseFields::ItemPositions positionFields=DatabaseFields::ItemPositionsAll) const |
Read image metadata. | |
QVariantList | getItemPositions (const QList< qlonglong > &imageIDs, DatabaseFields::ItemPositions fields) const |
ItemScanInfo | getItemScanInfo (qlonglong imageID) const |
Get scan info from the image ID. | |
QList< ItemScanInfo > | getItemScanInfos (int albumID) const |
Returns an ItemScanInfo object for each item in the album with the specified album id. | |
QList< qlonglong > | getItemsForUuid (const QString &uuid) const |
Retrieves the images with the given UUID. | |
ItemShortInfo | getItemShortInfo (int albumRootId, const QString &relativePath, const QString &name) const |
Get item and album if from albumRootId, album path and file name. | |
ItemShortInfo | getItemShortInfo (qlonglong imageID) const |
Get item and album info from the image ID. | |
QVector< QList< int > > | getItemsTagIDs (const QList< qlonglong > &imageIds) const |
For a list of items, return the tag ids associated with the item. | |
QStringList | getItemsURLsWithTag (int tagId) const |
Returns a list of all images where tagId is assigned Return item URLs. | |
QList< int > | getItemTagIDs (qlonglong imageID) const |
Get a list of IDs of all the tags for the item. | |
QStringList | getItemTagNames (qlonglong imageID) const |
Get a list of names of all the tags for the item. | |
QStringList | getItemURLsInAlbum (int albumID, ItemSortOrder order=NoItemSorting) const |
Given a albumID, get a list of the url of all items in the album. | |
QStringList | getItemURLsInTag (int tagID, bool recursive=false) const |
Given a tagid, get a list of the url of all items in the tag. | |
QStringList | getListFromImageMetadata (DatabaseFields::ImageMetadata field) const |
Return a list from a field from imageMetadata. | |
QPair< int, int > | getNumberOfAllItemsAndAlbums (int albumID) const |
Returns the QPair<int, int> of all items (first) and albums (second) as a counter in the album. | |
QHash< int, int > | getNumberOfImagesInAlbums () const |
Returns a QHash<int, int> of album id -> count of items in the album. | |
QHash< int, int > | getNumberOfImagesInTagProperties (const QString &property) const |
Returns a QHash<int, int> of tag id -> count of items with the given tag property. | |
int | getNumberOfImagesInTagProperties (int tagId, const QString &property) const |
Returns the count of images that have a tag property for the given tag. | |
QHash< int, int > | getNumberOfImagesInTags () const |
Returns a QHash<int, int> of tag id -> count of items with the tag. | |
int | getNumberOfItemsInAlbum (int albumID) const |
Returns the number of items in the album. | |
QList< qlonglong > | getObsoleteItemIds () const |
Get obsolete item Ids. | |
QList< qlonglong > | getOneRelatedImageEach (const QList< qlonglong > &ids, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
For each of the given ids, find one single related image (direction does not matter). | |
QList< int > | getRecentlyAssignedTags () const |
Get a list of recently assigned tags (only last 6 tags are listed) | |
QList< qlonglong > | getRelatedImagesToByType (DatabaseRelation::Type type) const |
Retrieves all images that related to (retrieves objects) by given type. | |
QList< QPair< qlonglong, qlonglong > > | getRelationCloud (qlonglong imageId, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
For the given image id, retrieves all relations of all related images: Each pair (a,b) means "a is related to b". | |
SearchInfo | getSearchInfo (int searchId) const |
Get information about the specified search. | |
QString | getSearchQuery (int searchId) const |
Get the query for the search specified by its id. | |
QString | getSetting (const QString &keyword) const |
This function returns the value which is stored in the database (table Settings). | |
QList< int > | getTagIdsWithProperties (qlonglong imageId) const |
Get all tagIds for which ImageTagProperties exist for the given image. | |
TagInfo | getTagInfo (int tagId) const |
QList< TagProperty > | getTagProperties () const |
Returns the list of all tag properties (ordered by tag id, then property). | |
QList< TagProperty > | getTagProperties (const QString &property) const |
Returns the list of tag properties with the given attribute. | |
QList< TagProperty > | getTagProperties (int tagID) const |
Returns the list of tag properties of the given tag. | |
QList< TagShortInfo > | getTagShortInfos () const |
Returns all tags in the database with their parent id and name, ordered by id. | |
QList< int > | getTagsWithProperty (const QString &property) const |
Returns a list of tag ids with the specified property. | |
int | getUniqueHashVersion () const |
Returns the version used for the unique hash in this database. | |
void | getUserFilterSettings (QString *imageFilterString, QString *videoFilterString, QString *audioFilterString) |
Returns the user-configurable filter settings. | |
void | getUserIgnoreDirectoryFilterSettings (QString *ignoreDirectoryFilterString) |
QVariantList | getVideoMetadata (qlonglong imageID, DatabaseFields::VideoMetadata metadataFields=DatabaseFields::VideoMetadataAll) const |
Read video metadata. | |
bool | hasImageHistory (qlonglong imageId) const |
Returns true if the image has a history stored in DB If not, it returns false. | |
bool | hasImagesRelatedFrom (qlonglong subjectId, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
bool | hasImagesRelatingTo (qlonglong objectId, DatabaseRelation::Type type=DatabaseRelation::UndefinedType) const |
bool | hasTags (const QList< qlonglong > &imageIDList) const |
Given a set of items (identified by their IDs), this will see if any of the items has a tag. | |
bool | integrityCheck () const |
Returns true if the integrity of the database is preserved. | |
void | makeStaleAlbum (int albumID) |
Makes the album a stale entry by setting the albumRoot to 0. | |
void | migrateAlbumRoot (int rootId, const QString &identifier) |
Migrates a given album root to a new disk location. | |
void | moveItem (int srcAlbumID, const QString &srcName, int dstAlbumID, const QString &dstName) |
Move the attributes of an item to a different item. | |
void | removeAllImageComments (qlonglong imageID) |
Remove all ItemComments. | |
void | removeAllImageProperties (qlonglong imageID) |
QList< qlonglong > | removeAllImageRelationsFrom (qlonglong subjectId, DatabaseRelation::Type type) const |
QList< qlonglong > | removeAllImageRelationsTo (qlonglong objectId, DatabaseRelation::Type type) const |
void | removeAllItemCopyrightProperties (qlonglong imageID) |
Removes all copyright properties for the given image id. | |
void | removeImageComment (int commentId, qlonglong imageID) |
Remove the specified entry in ItemComments. | |
void | removeImageProperty (qlonglong imageID, const QString &property) |
void | removeImagePropertyByName (const QString &property) |
void | removeImageRelation (const ImageRelation &relation) |
void | removeImageRelation (qlonglong subjectId, qlonglong objectId, DatabaseRelation::Type type) |
Removes image relations. | |
void | removeImageTagProperties (qlonglong imageId, int tagId=-1, const QString &property=QString(), const QString &value=QString()) |
Removes properties for the given tag. | |
void | removeItemAllTags (qlonglong imageID, const QList< int > ¤tTagIds) |
Remove all tags for the item. | |
void | removeItemCopyrightProperties (qlonglong imageID, const QString &property=QString(), const QString &extraValue=QString(), const QString &value=QString()) |
Removes copyright properties for the given image id. | |
void | removeItemPosition (qlonglong imageid) |
Remove the entry in ItemPositions for the given image. | |
void | removeItemPositionAltitude (qlonglong imageid) |
Remove the altitude in ItemPositions for the given image. | |
void | removeItems (const QList< qlonglong > &itemIDs, const QList< int > &albumIDs=QList< int >()) |
Marks all items in the list as removed, resets their dirids. | |
void | removeItemsFromAlbum (int albumID, const QList< qlonglong > &ids_forInformation=QList< qlonglong >()) |
Marks all items in the specified album as removed, resets their dirids. | |
void | removeItemsPermanently (const QList< qlonglong > &itemIDs, const QList< int > &albumIDs=QList< int >()) |
Marks all items in the list as obsolete, resets their dirids. | |
void | removeItemTag (qlonglong imageID, int tagID) |
Remove a specific tag for the item. | |
void | removeTagProperties (int tagId, const QString &property=QString(), const QString &value=QString()) |
Removes properties for the given tag. | |
void | removeTagsFromItems (const QList< qlonglong > &imageIDs, const QList< int > &tagIDs) |
Remove each tag from a list of tags from a each member of a list of items. | |
void | renameAlbum (int albumID, int newAlbumRootId, const QString &newRelativePath) |
Give an existing album a new relativePath and a newAlbumRootId. | |
void | renameItem (qlonglong imageID, const QString &newName) |
Rename the item. | |
AlbumInfo::List | scanAlbums () const |
Returns all albums and their attributes in the database. | |
SearchInfo::List | scanSearches () const |
Returns all searches from the database. | |
TagInfo::List | scanTags () const |
Returns all tags and their attributes in the database. | |
void | setAlbumCaption (int albumID, const QString &caption) |
Set a caption for the album. | |
void | setAlbumCategory (int albumID, const QString &category) |
Set a category for the album. | |
void | setAlbumDate (int albumID, const QDate &date) |
Set a date for the album. | |
void | setAlbumIcon (int albumID, qlonglong iconID) |
Set the icon for the album. | |
void | setAlbumModificationDate (int albumID, const QDateTime &modificationDate) |
Set the modification date time for the album. | |
void | setAlbumRootCaseSensitivity (int rootId, CollectionLocation::CaseSensitivity caseSensitivity) |
Sets the case sensitivity of the specified album root to a new value. | |
void | setAlbumRootLabel (int rootId, const QString &newLabel) |
Changes the label of the specified album root. | |
void | setAlbumRootPath (int rootId, const QString &newPath) |
Changes the specificPath of the specified album root. | |
void | setAlbumRootType (int rootId, CollectionLocation::Type newType) |
Sets the type of the specified album root to a new value. | |
void | setFilterSettings (const QStringList &imageFilter, const QStringList &videoFilter, const QStringList &audioFilter) |
Sets the main filter settings of the database. | |
void | setIgnoreDirectoryFilterSettings (const QStringList &ignoreDirectoryFilter) |
int | setImageComment (qlonglong imageID, const QString &comment, DatabaseComment::Type type, const QString &language=QString(), const QString &author=QString(), const QDateTime &date=QDateTime()) const |
Sets the comments for the image. | |
void | setImageProperty (qlonglong imageID, const QString &property, const QString &value) |
Sets the property with the given name for the given image to the specified value. | |
void | setImageUuid (qlonglong imageId, const QString &uuid) |
void | setItemAlbum (qlonglong imageID, qlonglong albumId) |
Updates the album field for the item. | |
void | setItemCopyrightProperty (qlonglong imageID, const QString &property, const QString &value, const QString &extraValue=QString(), CopyrightPropertyUnique uniqueness=PropertyUnique) |
Sets the property with the given name for the given image to the specified value and extraValue. | |
void | setItemHistory (qlonglong imageId, const QString &history) |
Changes (adds or updates) the image history. | |
void | setItemManualOrder (qlonglong imageID, qlonglong value) |
Updates the manualOrder field for the item. | |
void | setItemModificationDate (qlonglong imageID, const QDateTime &modificationDate) |
Updates the modification date field for the item. | |
void | setItemStatus (qlonglong imageID, DatabaseItem::Status status) |
Updates the status field for the item. | |
void | setSetting (const QString &keyword, const QString &value) |
This adds a keyword-value combination to the database Settings table if the keyword already exists, the value will be replaced with the new value. | |
void | setTagIcon (int tagID, const QString &iconKDE, qlonglong iconID) |
Set the icon for the tag. | |
void | setTagName (int tagID, const QString &name) |
Set a new name for the tag. | |
void | setTagParentID (int tagID, int newParentTagID) |
Set the parent tagid for the tag. | |
void | setUniqueHashVersion (int version) |
void | setUserFilterSettings (const QStringList &imageFilter, const QStringList &videoFilter, const QStringList &audioFilter) |
Sets the user-configurable filter settings. | |
void | setUserIgnoreDirectoryFilterSettings (const QStringList &ignoreDirectoryFilters) |
void | updateItem (qlonglong imageID, DatabaseItem::Category category, const QDateTime &modificationDate, qlonglong fileSize, const QString &uniqueHash) |
Update the fields of the Images table that have changed when the file has been modified on disk. | |
void | updateSearch (int searchID, DatabaseSearch::Type type, const QString &name, const QString &query) |
Updates Search with new attributes. | |
void | vacuum () |
Shrinks the database. | |
Friends | |
class | Digikam::CoreDbAccess |
int Digikam::CoreDB::addAlbum | ( | int | albumRootId, |
const QString & | relativePath, | ||
const QString & | caption, | ||
const QDate & | date, | ||
const QString & | collection | ||
) | const |
albumRootId | id of the album root of the new album |
relativePath | url of the album |
caption | the album caption |
date | the date for the album |
collection | the album collection |
int Digikam::CoreDB::addAlbumRoot | ( | CollectionLocation::Type | type, |
const QString & | identifier, | ||
const QString & | specificPath, | ||
const QString & | label | ||
) | const |
type | The type of the album root |
identifier | The album root identifier |
specificPath | The path specific to volume |
label | An (optional) user-visible label |
void Digikam::CoreDB::addImageMetadata | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ImageMetadata | fields = DatabaseFields::ImageMetadataAll |
||
) |
If there is already an entry, it will be discarded. The QVariantList shall have at most 16 entries, of types as defined in the DBSCHEMA and in metadatainfo.h, in this order:
0) String make 1) String model 2) String lens 3) Double aperture 4) Double focalLength 5) Double focalLength35 6) Double exposureTime 7) Int exposureProgram 8) Int exposureMode 9) Int sensitivity 10) Int flash 11) Int WhiteBalance 12) Int WhiteBalanceColorTemperature 13) Int meteringMode 14) Double subjectDistance 15) Double subjectDistanceCategory
void Digikam::CoreDB::addImageTagProperty | ( | qlonglong | imageId, |
int | tagId, | ||
const QString & | property, | ||
const QString & | value | ||
) |
Note that this never replaces existing entries. It is also all right to add multiple entries for a tag with the same property. To replace an existing entry, remove the entry before.
qlonglong Digikam::CoreDB::addItem | ( | int | albumID, |
const QString & | name, | ||
DatabaseItem::Status | status, | ||
DatabaseItem::Category | category, | ||
const QDateTime & | modificationDate, | ||
qlonglong | fileSize, | ||
const QString & | uniqueHash | ||
) | const |
void Digikam::CoreDB::addItemInformation | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ItemInformation | fields = DatabaseFields::ItemInformationAll |
||
) |
If there is already an entry, it will be discarded. The QVariantList shall have 9 entries, of types in this order:
0) Int rating 1) DateTime* creationDate 2) DateTime* digitizationDate 3) Int orientation 4) Int width 5) Int height 6) String format 7) Int colorDepth 8) Int colorModel
void Digikam::CoreDB::addItemPosition | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ItemPositions | fields = DatabaseFields::ItemPositionsAll |
||
) |
If there is already an entry, it will be discarded. The QVariantList shall have at most 10 entries, of types in this order:
0) String Latitude 1) Double LatitudeNumber 2) String Longitude 3) Double LongitudeNumber 4) Double Altitude 5) Double Orientation 6) Double Tilt 7) Double Roll 8) Double Accuracy 9) String Description
void Digikam::CoreDB::addItemTag | ( | int | albumID, |
const QString & | name, | ||
int | tagID | ||
) |
albumID | the albumID of the item |
name | the name of the item |
tagID | the tagID for the tag |
void Digikam::CoreDB::addItemTag | ( | qlonglong | imageID, |
int | tagID, | ||
bool | newTag = false |
||
) |
imageID | the ID of the item |
tagID | the tagID for the tag |
newTag | add to last assigned tag list |
int Digikam::CoreDB::addSearch | ( | DatabaseSearch::Type | type, |
const QString & | name, | ||
const QString & | query | ||
) | const |
type | search type |
name | name of the search |
query | search query to use |
int Digikam::CoreDB::addTag | ( | int | parentTagID, |
const QString & | name, | ||
const QString & | iconKDE, | ||
qlonglong | iconID | ||
) | const |
parentTagID | the id of the tag which will become the new tags parent |
name | the name of the tag |
iconKDE | the name of the icon file (this is filename which kde iconloader can load up) |
iconID | the id of the icon file Note: if the iconKDE parameter is empty, then the iconID parameter is used |
void Digikam::CoreDB::addTagProperty | ( | int | tagId, |
const QString & | property, | ||
const QString & | value | ||
) |
Note that this never replaces existing entries. It is also all right to add multiple entries for a tag with the same property. To replace an existing entry, remove the entry before.
int Digikam::CoreDB::addToDownloadHistory | ( | const QString & | identifier, |
const QString & | name, | ||
qlonglong | fileSize, | ||
const QDateTime & | date | ||
) | const |
Returns the id of the entry.
void Digikam::CoreDB::addVideoMetadata | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::VideoMetadata | fields = DatabaseFields::VideoMetadataAll |
||
) |
If there is already an entry, it will be discarded. The QVariantList shall have 8 entries, of types in this order:
0) String AspectRatio 1) String AudioBitRate 2) String AudioChannelType 3) String AudioCodec 4) String Duration 5) String FrameRate 6) String VideoCodec
void Digikam::CoreDB::changeImageComment | ( | int | commentId, |
qlonglong | imageID, | ||
const QVariantList & | infos, | ||
DatabaseFields::ItemComments | fields = DatabaseFields::ItemCommentsAll |
||
) |
The QVariantList shall have at most 5 entries, of types in this order:
0) Int Type 1) String Language 2) String Author 3) DateTime Date 4) String Comment
void Digikam::CoreDB::changeImageMetadata | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ImageMetadata | fields = DatabaseFields::ImageMetadataAll |
||
) |
This method does nothing if the item does not yet have an entry in the ItemInformation table. The parameters are as for the method above.
void Digikam::CoreDB::changeItemInformation | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ItemInformation | fields = DatabaseFields::ItemInformationAll |
||
) |
Fields not indicated by the fields parameter will not be touched. This method does nothing if the item does not yet have an entry in the ItemInformation table. The parameters are as for the method above.
void Digikam::CoreDB::changeItemPosition | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::ItemPositions | fields = DatabaseFields::ItemPositionsAll |
||
) |
This method does nothing if the item does not yet have an entry in the ItemInformation table. The parameters are as for the method above.
void Digikam::CoreDB::changeVideoMetadata | ( | qlonglong | imageID, |
const QVariantList & | infos, | ||
DatabaseFields::VideoMetadata | fields = DatabaseFields::VideoMetadataAll |
||
) |
This method does nothing if the item does not yet have an entry in the ItemInformation table. The parameters are as for the method above.
bool Digikam::CoreDB::copyAlbumProperties | ( | int | srcAlbumID, |
int | dstAlbumID | ||
) | const |
Both albums must exist.
qlonglong Digikam::CoreDB::copyItem | ( | int | srcAlbumID, |
const QString & | srcName, | ||
int | dstAlbumID, | ||
const QString & | dstName | ||
) |
Useful when say a file is copied. The operation fails (returns -1) of src and dest are identical.
srcAlbumID | the id of the source album |
dstAlbumID | the id of the destination album |
srcName | the name of the source file |
dstName | the name of the destination file |
QUuid Digikam::CoreDB::databaseUuid | ( | ) |
This UUID is kept stable over schema updates.
void Digikam::CoreDB::deleteAlbum | ( | int | albumID | ) |
This will not delete the subalbums of the album.
albumID | the id of the album |
void Digikam::CoreDB::deleteAlbumRoot | ( | int | rootId | ) |
rootId | the id of the album root |
void Digikam::CoreDB::deleteItem | ( | int | albumID, |
const QString & | file | ||
) |
albumID | The id of the album. |
file | The filename of the file to delete. |
void Digikam::CoreDB::deleteItem | ( | qlonglong | imageId | ) |
This method can only be used if the album of the image is null!
imageId | The id of the image. |
void Digikam::CoreDB::deleteObsoleteItem | ( | qlonglong | imageId | ) |
imageId | The id of the image. |
void Digikam::CoreDB::deleteRemovedItems | ( | ) |
void Digikam::CoreDB::deleteSearch | ( | int | searchID | ) |
searchID | the id of the search |
void Digikam::CoreDB::deleteTag | ( | int | tagID | ) |
This will not delete the subtags of the tag.
tagID | the id of the tag |
qlonglong Digikam::CoreDB::findImageId | ( | int | albumID, |
const QString & | name, | ||
DatabaseItem::Status | status, | ||
DatabaseItem::Category | category, | ||
qlonglong | fileSize, | ||
const QString & | uniqueHash | ||
) | const |
albumID | the albumID of the item (-1 means null) |
name | the name of the item |
status | the status of the item |
category | the category of the item |
fileSize | the file size |
uniqueHash | the unique hash |
int Digikam::CoreDB::findInDownloadHistory | ( | const QString & | identifier, |
const QString & | name, | ||
qlonglong | fileSize, | ||
const QDateTime & | date | ||
) | const |
Returns the id of the entry, or -1 if not found.
QList< int > Digikam::CoreDB::getAlbumAndSubalbumsForPath | ( | int | albumRootId, |
const QString & | relativePath | ||
) | const |
albumRootId | id of the album root of the album |
relativePath | The path for which you want the albumIDs relative to the album root |
QDate Digikam::CoreDB::getAlbumAverageDate | ( | int | albumID | ) | const |
albumID | the id of the album to calculate |
int Digikam::CoreDB::getAlbumForPath | ( | int | albumRootId, |
const QString & | relativePath, | ||
bool | create = true |
||
) | const |
albumRootId | id of the album root of the album |
relativePath | The relative path for which you want the albumID relative to the album root |
create | If true, an album is newly created if it does not yet exist. If false, -1 is returned if no album exists. |
QDate Digikam::CoreDB::getAlbumHighestDate | ( | int | albumID | ) | const |
albumID | the id of the album to calculate |
QDate Digikam::CoreDB::getAlbumLowestDate | ( | int | albumID | ) | const |
albumID | the id of the album to calculate |
QDateTime Digikam::CoreDB::getAlbumModificationDate | ( | int | albumID | ) | const |
albumID | the id of the album |
QMap< QString, QDateTime > Digikam::CoreDB::getAlbumModificationMap | ( | int | albumRootId | ) | const |
albumRootId | id of the album root of the album |
QString Digikam::CoreDB::getAlbumRelativePath | ( | int | albumID | ) | const |
albumID | the id of the album |
int Digikam::CoreDB::getAlbumRootId | ( | int | albumID | ) | const |
albumID | the id of the albumdb |
QList< AlbumRootInfo > Digikam::CoreDB::getAlbumRoots | ( | ) | const |
QList< int > Digikam::CoreDB::getAlbumsOnAlbumRoot | ( | int | albumRootId | ) | const |
QHash< qlonglong, QPair< int, int > > Digikam::CoreDB::getAllItemsWithAlbum | ( | ) | const |
QPair.first == albumRootID QPair.second == albumID
QString Digikam::CoreDB::getDatabaseEncoding | ( | ) | const |
For SQLite should UTF-8. For MySQL like UTF8MB4.
QStringList Digikam::CoreDB::getDirtyOrMissingFaceImageUrls | ( | ) | const |
Return image ids or item URLs.
void Digikam::CoreDB::getFilterSettings | ( | QStringList * | imageFilter, |
QStringList * | videoFilter, | ||
QStringList * | audioFilter | ||
) |
Returns a list with lowercase suffixes only, no wildcards added ("png", not "*.png") Returned is a joint result of main and user settings. If you are not interested in a specific value, pass 0.
QList< ItemScanInfo > Digikam::CoreDB::getIdenticalFiles | ( | qlonglong | id | ) | const |
Criteria: Unique Hash, file size and album non-null. The first variant will not return an ItemScanInfo for id. The second allows to pass one id as source id for exclusion from the list. If this is -1, no id is excluded.
qlonglong Digikam::CoreDB::getImageId | ( | int | albumID, |
const QString & | name | ||
) | const |
albumID | the albumID of the item |
name | the name of the item |
QList< qlonglong > Digikam::CoreDB::getImageIds | ( | DatabaseItem::Status | status | ) | const |
status | The status. |
QList< qlonglong > Digikam::CoreDB::getImageIds | ( | DatabaseItem::Status | status, |
DatabaseItem::Category | category | ||
) | const |
status | The status. |
category | The category. |
QList< qlonglong > Digikam::CoreDB::getImageIds | ( | int | albumID, |
const QString & | name, | ||
DatabaseItem::Status | status | ||
) | const |
albumID | the albumID of the item (-1 means NULL) |
name | the name of the item |
status | the status of the item |
QList< qlonglong > Digikam::CoreDB::getImageIds | ( | int | albumID, |
DatabaseItem::Status | status, | ||
bool | scanned = true |
||
) | const |
albumID | the albumID of the item (-1 means NULL) |
status | the status of the item |
scanned | return scanned/unscanned items |
QVariantList Digikam::CoreDB::getImageMetadata | ( | qlonglong | imageID, |
DatabaseFields::ImageMetadata | metadataFields = DatabaseFields::ImageMetadataAll |
||
) | const |
Parameters as above.
QVariantList Digikam::CoreDB::getImagesFields | ( | qlonglong | imageID, |
DatabaseFields::Images | imagesFields | ||
) | const |
Choose the fields with the mask. The fields will be returned in the following order and type: 0) Int Album 1) String Name 2) Int Status 3) Int Category 4) DateTime ModificationDate 5) int FileSize 6) String uniqueHash
QList< qlonglong > Digikam::CoreDB::getImagesRelatedFrom | ( | qlonglong | subjectId, |
DatabaseRelation::Type | type = DatabaseRelation::UndefinedType |
||
) | const |
"Get images related to from this"
QList< qlonglong > Digikam::CoreDB::getImagesRelatingTo | ( | qlonglong | objectId, |
DatabaseRelation::Type | type = DatabaseRelation::UndefinedType |
||
) | const |
"Get images this image is relating to"
QList< ImageTagProperty > Digikam::CoreDB::getImageTagProperties | ( | qlonglong | imageId, |
int | tagId = -1 |
||
) | const |
If the tagID is -1, returns the ImageTagProperties for all tagIds of the given image.
int Digikam::CoreDB::getItemAlbum | ( | qlonglong | imageID | ) | const |
imageID | The ID of the item |
QList< int > Digikam::CoreDB::getItemCommonTagIDs | ( | const QList< qlonglong > & | imageIDList | ) | const |
imageIDList | a list of IDs of the items |
QList< CopyrightInfo > Digikam::CoreDB::getItemCopyright | ( | qlonglong | imageID, |
const QString & | property = QString() |
||
) | const |
If property is not null, only the given property is returned.
qlonglong Digikam::CoreDB::getItemFromAlbum | ( | int | albumID, |
const QString & | fileName | ||
) | const |
albumID | The albumId in which we search the item. |
fileName | The name of the item file. |
QMap< qlonglong, QString > Digikam::CoreDB::getItemIDsAndURLsInAlbum | ( | int | albumID | ) | const |
albumID | the id of the album |
QList< qlonglong > Digikam::CoreDB::getItemIDsInAlbum | ( | int | albumID | ) | const |
albumID | the id of the album |
QList< qlonglong > Digikam::CoreDB::getItemIDsInTag | ( | int | tagID, |
bool | recursive = false |
||
) | const |
tagID | the id of the tag |
recursive | perform a recursive folder hierarchy parsing |
QVariantList Digikam::CoreDB::getItemInformation | ( | qlonglong | imageID, |
DatabaseFields::ItemInformation | infoFields = DatabaseFields::ItemInformationAll |
||
) | const |
Parameters as above.
QString Digikam::CoreDB::getItemName | ( | qlonglong | imageID | ) | const |
imageID | The ID of the item |
QStringList Digikam::CoreDB::getItemNamesInAlbum | ( | int | albumID, |
bool | recursive = false |
||
) | const |
This is used to verify if all items on disk are consistent with the database in the CollectionScanner class.
albumID | The albumID for which you want all items. |
recursive | perform a recursive folder hierarchy parsing |
QVariantList Digikam::CoreDB::getItemPosition | ( | qlonglong | imageID, |
DatabaseFields::ItemPositions | positionFields = DatabaseFields::ItemPositionsAll |
||
) | const |
Parameters as above.
QVector< QList< int > > Digikam::CoreDB::getItemsTagIDs | ( | const QList< qlonglong > & | imageIds | ) | const |
Amounts to calling getItemTagIDs for each id in imageIds, but is optimized.
QList< int > Digikam::CoreDB::getItemTagIDs | ( | qlonglong | imageID | ) | const |
imageID | the ID of the item |
QStringList Digikam::CoreDB::getItemTagNames | ( | qlonglong | imageID | ) | const |
imageID | the ID of the item |
QStringList Digikam::CoreDB::getItemURLsInAlbum | ( | int | albumID, |
ItemSortOrder | order = NoItemSorting |
||
) | const |
albumID | the id of the album |
order | order for the returned items to use |
QStringList Digikam::CoreDB::getItemURLsInTag | ( | int | tagID, |
bool | recursive = false |
||
) | const |
tagID | the id of the tag |
recursive | perform a recursive folder hierarchy parsing |
QPair< int, int > Digikam::CoreDB::getNumberOfAllItemsAndAlbums | ( | int | albumID | ) | const |
albumID | the id of the album |
int Digikam::CoreDB::getNumberOfItemsInAlbum | ( | int | albumID | ) | const |
albumID | the id of the album |
QList< qlonglong > Digikam::CoreDB::getOneRelatedImageEach | ( | const QList< qlonglong > & | ids, |
DatabaseRelation::Type | type = DatabaseRelation::UndefinedType |
||
) | const |
Ids are unique in the returned list, and do not correspond by index to the given list.
QList< int > Digikam::CoreDB::getRecentlyAssignedTags | ( | ) | const |
QList< QPair< qlonglong, qlonglong > > Digikam::CoreDB::getRelationCloud | ( | qlonglong | imageId, |
DatabaseRelation::Type | type = DatabaseRelation::UndefinedType |
||
) | const |
Each a and b in the list will have a direct or indirect relation to the initial imageId. If type is given, filters by type, otherwise returns all types.
QString Digikam::CoreDB::getSetting | ( | const QString & | keyword | ) | const |
keyword | The keyword for which the value has to be returned. |
QList< int > Digikam::CoreDB::getTagsWithProperty | ( | const QString & | property | ) | const |
int Digikam::CoreDB::getUniqueHashVersion | ( | ) | const |
The value is cached.
void Digikam::CoreDB::getUserFilterSettings | ( | QString * | imageFilterString, |
QString * | videoFilterString, | ||
QString * | audioFilterString | ||
) |
If you are not interested in a specific value, pass 0.
QVariantList Digikam::CoreDB::getVideoMetadata | ( | qlonglong | imageID, |
DatabaseFields::VideoMetadata | metadataFields = DatabaseFields::VideoMetadataAll |
||
) | const |
Parameters as above.
bool Digikam::CoreDB::hasTags | ( | const QList< qlonglong > & | imageIDList | ) | const |
imageIDList | a list of IDs of the items |
void Digikam::CoreDB::makeStaleAlbum | ( | int | albumID | ) |
Emits the same changeset as deleteAlbum()
void Digikam::CoreDB::migrateAlbumRoot | ( | int | rootId, |
const QString & | identifier | ||
) |
This only changes the values in the AlbumRoots table. It is expected that this merely reflects underlying partition changes, still pointing to the same data.
void Digikam::CoreDB::moveItem | ( | int | srcAlbumID, |
const QString & | srcName, | ||
int | dstAlbumID, | ||
const QString & | dstName | ||
) |
Useful when say a file is renamed
srcAlbumID | the id of the source album |
dstAlbumID | the id of the destination album |
srcName | the name of the source file |
dstName | the name of the destination file |
void Digikam::CoreDB::removeImageRelation | ( | qlonglong | subjectId, |
qlonglong | objectId, | ||
DatabaseRelation::Type | type | ||
) |
The batch methods return all removed partners.
void Digikam::CoreDB::removeImageTagProperties | ( | qlonglong | imageId, |
int | tagId = -1 , |
||
const QString & | property = QString() , |
||
const QString & | value = QString() |
||
) |
If the value is given, removes only the entries with the given property/value pair. If only property is given, removes all properties with the given name. If property is null, removes all properties for the given tag. If tagId is -1, removes all image tag properties for the given image.
void Digikam::CoreDB::removeItemAllTags | ( | qlonglong | imageID, |
const QList< int > & | currentTagIds | ||
) |
imageID | the ID of the item |
currentTagIds | the current tags ids assigned to the item |
void Digikam::CoreDB::removeItemCopyrightProperties | ( | qlonglong | imageID, |
const QString & | property = QString() , |
||
const QString & | extraValue = QString() , |
||
const QString & | value = QString() |
||
) |
All values after the first null value, in order of parameters, are treated as wild cards (you can give value as wildcard; value and extraValue; or property, extraValue and value).
void Digikam::CoreDB::removeItems | ( | const QList< qlonglong > & | itemIDs, |
const QList< int > & | albumIDs = QList<int>() |
||
) |
The items can later be removed by deleteRemovedItems().
itemIDs | a list of item IDs to be marked |
albumIDs | this parameter is purely informational. it shall contain the albums that the items are removed from. |
void Digikam::CoreDB::removeItemsFromAlbum | ( | int | albumID, |
const QList< qlonglong > & | ids_forInformation = QList<qlonglong>() |
||
) |
The album can be deleted afterwards without removing the entries for the items, which can later be removed by deleteRemovedItems().
albumID | The id of the album |
ids_forInformation | Fully optional: The image ids in the album, if you know them anyway. This parameter is only used for distributing the change notification. |
void Digikam::CoreDB::removeItemsPermanently | ( | const QList< qlonglong > & | itemIDs, |
const QList< int > & | albumIDs = QList<int>() |
||
) |
The items can later be removed by deleteRemovedItems().
itemIDs | a list of item IDs to be marked |
albumIDs | this parameter is purely informational. it shall contain the albums that the items are removed from. |
void Digikam::CoreDB::removeItemTag | ( | qlonglong | imageID, |
int | tagID | ||
) |
imageID | the ID of the item |
tagID | the tagID for the tag |
void Digikam::CoreDB::removeTagProperties | ( | int | tagId, |
const QString & | property = QString() , |
||
const QString & | value = QString() |
||
) |
If the value is given, removes only the entries with the given property/value pair. If only property is given, removes all properties with the given name. If property is null, removes all properties for the given tag.
void Digikam::CoreDB::renameItem | ( | qlonglong | imageID, |
const QString & | newName | ||
) |
Note: we not use here ImageChangeset.
AlbumInfo::List Digikam::CoreDB::scanAlbums | ( | ) | const |
SearchInfo::List Digikam::CoreDB::scanSearches | ( | ) | const |
TagInfo::List Digikam::CoreDB::scanTags | ( | ) | const |
void Digikam::CoreDB::setAlbumCaption | ( | int | albumID, |
const QString & | caption | ||
) |
albumID | the id of the album |
caption | the new caption for the album |
void Digikam::CoreDB::setAlbumCategory | ( | int | albumID, |
const QString & | category | ||
) |
albumID | the id of the album |
category | the new category for the album |
void Digikam::CoreDB::setAlbumDate | ( | int | albumID, |
const QDate & | date | ||
) |
albumID | the id of the album |
date | the date for the album |
void Digikam::CoreDB::setAlbumIcon | ( | int | albumID, |
qlonglong | iconID | ||
) |
albumID | the id of the album |
iconID | the id of the icon file |
void Digikam::CoreDB::setAlbumModificationDate | ( | int | albumID, |
const QDateTime & | modificationDate | ||
) |
albumID | the id of the album |
modificationDate | the modification date time for the album |
void Digikam::CoreDB::setAlbumRootLabel | ( | int | rootId, |
const QString & | newLabel | ||
) |
rootId | the id of the album root |
newLabel | new label for the album root |
void Digikam::CoreDB::setAlbumRootPath | ( | int | rootId, |
const QString & | newPath | ||
) |
rootId | the id of the album root |
newPath | new path for the album root |
void Digikam::CoreDB::setFilterSettings | ( | const QStringList & | imageFilter, |
const QStringList & | videoFilter, | ||
const QStringList & | audioFilter | ||
) |
Should only be called at schema update.
int Digikam::CoreDB::setImageComment | ( | qlonglong | imageID, |
const QString & | comment, | ||
DatabaseComment::Type | type, | ||
const QString & | language = QString() , |
||
const QString & | author = QString() , |
||
const QDateTime & | date = QDateTime() |
||
) | const |
A comment for the image with the same source, language and author will be overwritten.
imageID | The imageID of the image |
comment | The comment string |
type | The type of the comment |
language | Information about the language of the comment. A null string shall be used if language information is not available from the source, or if the comment is in the default language. |
author | Optional information about the author who wrote the comment. If not supported by the source, pass a null string. |
date | Optional information about the date when the comment was written If not supported by the source, pass a null string. |
void Digikam::CoreDB::setItemAlbum | ( | qlonglong | imageID, |
qlonglong | albumId | ||
) |
void Digikam::CoreDB::setItemStatus | ( | qlonglong | imageID, |
DatabaseItem::Status | status | ||
) |
void Digikam::CoreDB::setSetting | ( | const QString & | keyword, |
const QString & | value | ||
) |
keyword | The keyword |
value | The value |
void Digikam::CoreDB::setTagIcon | ( | int | tagID, |
const QString & | iconKDE, | ||
qlonglong | iconID | ||
) |
tagID | the id of the tag |
iconKDE | the filename for the kde icon file |
iconID | the id of the icon file Note: Only one of the iconKDE or iconID parameters is used. if the iconKDE parameter is empty, then the iconID parameter is used |
void Digikam::CoreDB::setTagName | ( | int | tagID, |
const QString & | name | ||
) |
tagID | the id of the tag |
name | the new name for the tag |
void Digikam::CoreDB::setTagParentID | ( | int | tagID, |
int | newParentTagID | ||
) |
This is equivalent to reparenting the tag
tagID | the id of the tag |
newParentTagID | the new parentid for the tag |
void Digikam::CoreDB::setUserFilterSettings | ( | const QStringList & | imageFilter, |
const QStringList & | videoFilter, | ||
const QStringList & | audioFilter | ||
) |
The lists shall be as specified for getFilterSettings. They may include entries starting with "-", which indicates that this format shall be removed from the list, if it is included in the main settings list.
void Digikam::CoreDB::updateItem | ( | qlonglong | imageID, |
DatabaseItem::Category | category, | ||
const QDateTime & | modificationDate, | ||
qlonglong | fileSize, | ||
const QString & | uniqueHash | ||
) |
imageID | the image that has been modified |
category | the image category that has been modified |
modificationDate | the image time-stamp that has been modified |
fileSize | the image file size that has been modified |
uniqueHash | the image hash that has been modified |
void Digikam::CoreDB::updateSearch | ( | int | searchID, |
DatabaseSearch::Type | type, | ||
const QString & | name, | ||
const QString & | query | ||
) |
searchID | the id of the search |
type | type of the search |
name | name of the search |
query | database query of the search |