digiKam
Digikam::ItemCopyright Class Reference

Public Types

enum  ReplaceMode { ReplaceAllEntries , ReplaceLanguageEntry , AddEntryToExisting }
 

Public Member Functions

MetaEngine::AltLangMap allCopyrightNotices ()
 
MetaEngine::AltLangMap allRightsUsageTerms ()
 
QStringList author () const
 
QString authorsPosition () const
 
QStringList byLine () const
 
QString byLineTitle () const
 
IptcCoreContactInfo contactInfo ()
 
QString copyrightNotice (const QString &languageCode=QString())
 
QStringList creator () const
 
QString creatorJobTitle () const
 
QString credit () const
 
void fillTemplate (Template &t)
 
QString instructions ()
 
 ItemCopyright ()
 
 ItemCopyright (const ItemCopyright &other)
 
 ItemCopyright (qlonglong imageid)
 
ItemCopyrightoperator= (const ItemCopyright &other)
 
QString provider () const
 
void removeAll ()
 
void removeContactInfo ()
 
void removeCopyrightNotices ()
 
void removeCreatorJobTitle ()
 
void removeCreators ()
 
void removeInstructions ()
 
void removeProvider ()
 
void removeRightsUsageTerms ()
 
void removeSource ()
 
void replaceFrom (const ItemCopyright &source)
 
QString rights (const QString &languageCode=QString())
 
QString rightsUsageTerms (const QString &languageCode=QString())
 
void setAuthor (const QString &author, ReplaceMode mode=ReplaceAllEntries)
 
void setAuthorsPosition (const QString &position)
 
void setByLine (const QString &byline, ReplaceMode mode=ReplaceAllEntries)
 
void setByLineTitle (const QString &title)
 
void setContactInfo (const IptcCoreContactInfo &info)
 
void setCopyrightNotice (const QString &notice, const QString &languageCode=QString(), ReplaceMode mode=ReplaceLanguageEntry)
 
void setCreator (const QString &creator, ReplaceMode mode=ReplaceAllEntries)
 
void setCreatorJobTitle (const QString &title)
 
void setCredit (const QString &credit)
 
void setFromTemplate (const Template &t)
 
void setInstructions (const QString &instructions)
 
void setProvider (const QString &provider)
 
void setRights (const QString &notice, const QString &languageCode=QString(), ReplaceMode mode=ReplaceLanguageEntry)
 
void setRightsUsageTerms (const QString &term, const QString &languageCode=QString(), ReplaceMode mode=ReplaceLanguageEntry)
 
void setSource (const QString &source)
 
QString source ()
 
 ~ItemCopyright ()
 

Protected Member Functions

CopyrightInfo copyrightInfo (const QString &property) const
 
QList< CopyrightInfocopyrightInfos (const QString &property) const
 
int languageMatch (const QList< CopyrightInfo > &infos, const QString &languageCode) const
 
MetaEngine::AltLangMap readLanguageProperties (const QString &property)
 
QString readLanguageProperty (const QString &property, const QString &languageCode)
 
QString readSimpleProperty (const QString &property) const
 
void removeLanguageProperty (const QString &property, const QString &languageCode)
 
void removeProperties (const QString &property)
 
void setLanguageProperty (const QString &property, const QString &value, const QString &languageCode, ReplaceMode mode)
 
void setSimpleProperty (const QString &property, const QString &value)
 

Protected Attributes

ItemCopyrightCachem_cache
 
qlonglong m_id
 

Friends

class ItemCopyrightCache
 

Member Enumeration Documentation

◆ ReplaceMode

Enumerator
ReplaceAllEntries 

Remove entries for all languages and add one new entry.

ReplaceLanguageEntry 

Only replace the entry with the given language.

AddEntryToExisting 

No constraints on adding the entry.

Constructor & Destructor Documentation

◆ ItemCopyright() [1/3]

Digikam::ItemCopyright::ItemCopyright ( qlonglong  imageid)
explicit

◆ ItemCopyright() [2/3]

Digikam::ItemCopyright::ItemCopyright ( )

Create a null ItemCopyright object

◆ ItemCopyright() [3/3]

Digikam::ItemCopyright::ItemCopyright ( const ItemCopyright other)

◆ ~ItemCopyright()

Digikam::ItemCopyright::~ItemCopyright ( )

References m_cache.

Member Function Documentation

◆ allCopyrightNotices()

◆ allRightsUsageTerms()

◆ author()

QStringList Digikam::ItemCopyright::author ( ) const
inline

◆ authorsPosition()

QString Digikam::ItemCopyright::authorsPosition ( ) const
inline

Referenced by fillTemplate().

◆ byLine()

QStringList Digikam::ItemCopyright::byLine ( ) const
inline

◆ byLineTitle()

QString Digikam::ItemCopyright::byLineTitle ( ) const
inline

◆ contactInfo()

◆ copyrightInfo()

CopyrightInfo Digikam::ItemCopyright::copyrightInfo ( const QString &  property) const
protected

◆ copyrightInfos()

QList< CopyrightInfo > Digikam::ItemCopyright::copyrightInfos ( const QString &  property) const
protected

◆ copyrightNotice()

QString Digikam::ItemCopyright::copyrightNotice ( const QString &  languageCode = QString())

Returns the copyright notice. This is Photoshop Copyright Notice. This is IPTC Copyright Notice. This is DC Rights. This is dc:rights in XMP. Contains any necessary copyright notice for claiming the intellectual property for this news object and should identify the current owner of the copyright for the news object. Other entities like the creator of the news object may be added. Notes on usage rights should be provided in Rights usage terms. Note on language matching: You can specify a language code. If the requested language is not available, the entry with default language code is returned. If a default-language entry is not available, the first entry is returned. If you pass a null string as languageCode, the local language is returned.

References Digikam::MetadataInfo::IptcCoreCopyrightNotice, Digikam::ItemScanner::iptcCorePropertyName(), and readLanguageProperty().

◆ creator()

QStringList Digikam::ItemCopyright::creator ( ) const

Returns the author/creator/byline. This is Photoshop Author. This is IPTC By-line. This is DC creator. This is dc:creator in XMP. Contains preferably the name of the person who created the content of this news object, a photographer for photos, a graphic artist for graphics, or a writer for textual news. If it is not appropriate to add the name of a person the name of a company or organization could be applied as well. Aligning with IIM notions IPTC Core intents to have only one creator for this news object despite the underlying XMP property dc:creator allows for more than one item to be included. If there are more than one item in this array the first one should be considered as the IPTC Core Creator value.

References copyrightInfos(), Digikam::MetadataInfo::IptcCoreCreator, Digikam::ItemScanner::iptcCorePropertyName(), and Digikam::CopyrightInfo::value.

Referenced by Digikam::DBInfoIface::itemInfo(), and setCreator().

◆ creatorJobTitle()

QString Digikam::ItemCopyright::creatorJobTitle ( ) const

Returns the creator's job title. This is Photoshop AuthorsPosition. This is IPTC By-line Title. This is photoshop:AuthorsPosition in XMP. Contains the job title of the person who created the content of this news object. As this is sort of a qualifier the Creator element has to be filled in as mandatory prerequisite for using Creator's Jobtitle.

References Digikam::MetadataInfo::IptcCoreCreatorJobTitle, Digikam::ItemScanner::iptcCorePropertyName(), and readSimpleProperty().

◆ credit()

QString Digikam::ItemCopyright::credit ( ) const
inline

◆ fillTemplate()

◆ instructions()

QString Digikam::ItemCopyright::instructions ( )

Returns the instructions. This is Photoshop Instructions. This is IPTC Special Instruction. This is photoshop:Instructions in XMP. Any of a number of instructions from the provider or creator to the receiver of the news object which might include any of the following: embargoes (NewsMagazines OUT) and other restrictions not covered by the Rights Usage Terms field; information regarding the original means of capture (scanning notes, colorspace info) or other specific text information that the user may need for accurate reproduction; additional permissions or credits required when publishing.

References Digikam::MetadataInfo::IptcCoreInstructions, Digikam::ItemScanner::iptcCorePropertyName(), and readSimpleProperty().

Referenced by fillTemplate(), and setInstructions().

◆ languageMatch()

int Digikam::ItemCopyright::languageMatch ( const QList< CopyrightInfo > &  infos,
const QString &  languageCode 
) const
protected

◆ operator=()

ItemCopyright & Digikam::ItemCopyright::operator= ( const ItemCopyright other)

References m_cache, and m_id.

◆ provider()

QString Digikam::ItemCopyright::provider ( ) const

Returns the credit/provider. This is Photoshop Credit. This is IPTC Credit. This is photoshop:Credit in XMP Identifies the provider of the news object, who is not necessarily the owner/creator.

References Digikam::ItemScanner::iptcCorePropertyName(), Digikam::MetadataInfo::IptcCoreProvider, and readSimpleProperty().

Referenced by setProvider().

◆ readLanguageProperties()

MetaEngine::AltLangMap Digikam::ItemCopyright::readLanguageProperties ( const QString &  property)
protected

◆ readLanguageProperty()

QString Digikam::ItemCopyright::readLanguageProperty ( const QString &  property,
const QString &  languageCode 
)
protected

◆ readSimpleProperty()

QString Digikam::ItemCopyright::readSimpleProperty ( const QString &  property) const
protected

◆ removeAll()

◆ removeContactInfo()

◆ removeCopyrightNotices()

void Digikam::ItemCopyright::removeCopyrightNotices ( )

◆ removeCreatorJobTitle()

void Digikam::ItemCopyright::removeCreatorJobTitle ( )

◆ removeCreators()

void Digikam::ItemCopyright::removeCreators ( )

◆ removeInstructions()

void Digikam::ItemCopyright::removeInstructions ( )

◆ removeLanguageProperty()

void Digikam::ItemCopyright::removeLanguageProperty ( const QString &  property,
const QString &  languageCode 
)
protected

◆ removeProperties()

◆ removeProvider()

void Digikam::ItemCopyright::removeProvider ( )

◆ removeRightsUsageTerms()

void Digikam::ItemCopyright::removeRightsUsageTerms ( )

◆ removeSource()

void Digikam::ItemCopyright::removeSource ( )

◆ replaceFrom()

◆ rights()

QString Digikam::ItemCopyright::rights ( const QString &  languageCode = QString())
inline

◆ rightsUsageTerms()

QString Digikam::ItemCopyright::rightsUsageTerms ( const QString &  languageCode = QString())

Returns the right usage terms. This has no equivalent in Photoshop, IPTC, or DC. This is xmpRights:UsageTerms in XMP. Language matching is done as with copyrightNotice(). Free text instructions on how this news object can be legally used.

References Digikam::ItemScanner::iptcCorePropertyName(), Digikam::MetadataInfo::IptcCoreRightsUsageTerms, and readLanguageProperty().

◆ setAuthor()

void Digikam::ItemCopyright::setAuthor ( const QString &  author,
ReplaceMode  mode = ReplaceAllEntries 
)
inline

Referenced by setFromTemplate().

◆ setAuthorsPosition()

void Digikam::ItemCopyright::setAuthorsPosition ( const QString &  position)
inline

Referenced by setFromTemplate().

◆ setByLine()

void Digikam::ItemCopyright::setByLine ( const QString &  byline,
ReplaceMode  mode = ReplaceAllEntries 
)
inline

◆ setByLineTitle()

void Digikam::ItemCopyright::setByLineTitle ( const QString &  title)
inline

◆ setContactInfo()

◆ setCopyrightNotice()

void Digikam::ItemCopyright::setCopyrightNotice ( const QString &  notice,
const QString &  languageCode = QString(),
ReplaceMode  mode = ReplaceLanguageEntry 
)

Sets the copyright notice. If you supply a null QString as language code, this is regarded as an entry for the default language (“x-default”). The ReplaceMode determines how existing entries are handled.

References Digikam::MetadataInfo::IptcCoreCopyrightNotice, Digikam::ItemScanner::iptcCorePropertyName(), and setLanguageProperty().

◆ setCreator()

void Digikam::ItemCopyright::setCreator ( const QString &  creator,
ReplaceMode  mode = ReplaceAllEntries 
)

Sets the creator. If you want to specify only one creator, set the replace mode to ReplaceAllEntries. If you want to add it to a list of existing entries, pass AddEntryToExisting. You shall not use ReplaceLanguageEntry for this method, creators have no language associated.

References creator(), Digikam::CoreDbAccess::db(), Digikam::MetadataInfo::IptcCoreCreator, Digikam::ItemScanner::iptcCorePropertyName(), m_id, Digikam::CoreDB::PropertyNoConstraint, Digikam::CoreDB::PropertyUnique, ReplaceAllEntries, and Digikam::CoreDB::setItemCopyrightProperty().

◆ setCreatorJobTitle()

void Digikam::ItemCopyright::setCreatorJobTitle ( const QString &  title)

◆ setCredit()

void Digikam::ItemCopyright::setCredit ( const QString &  credit)
inline

Referenced by setFromTemplate().

◆ setFromTemplate()

◆ setInstructions()

void Digikam::ItemCopyright::setInstructions ( const QString &  instructions)

◆ setLanguageProperty()

void Digikam::ItemCopyright::setLanguageProperty ( const QString &  property,
const QString &  value,
const QString &  languageCode,
ReplaceMode  mode 
)
protected

◆ setProvider()

void Digikam::ItemCopyright::setProvider ( const QString &  provider)

◆ setRights()

void Digikam::ItemCopyright::setRights ( const QString &  notice,
const QString &  languageCode = QString(),
ReplaceMode  mode = ReplaceLanguageEntry 
)
inline

Referenced by setFromTemplate().

◆ setRightsUsageTerms()

void Digikam::ItemCopyright::setRightsUsageTerms ( const QString &  term,
const QString &  languageCode = QString(),
ReplaceMode  mode = ReplaceLanguageEntry 
)

◆ setSimpleProperty()

void Digikam::ItemCopyright::setSimpleProperty ( const QString &  property,
const QString &  value 
)
protected

◆ setSource()

void Digikam::ItemCopyright::setSource ( const QString &  source)

◆ source()

QString Digikam::ItemCopyright::source ( )

Returns the source. This is Photoshop Source. This is IPTC Source. This is photoshop::Source in XMP. Identifies the original owner of the copyright for the intellectual content of the news object. This could be an agency, a member of an agency or an individual. Source could be different from Creator and from the entities in the CopyrightNotice. As the original owner can not change the content of this property should never be changed or deleted after the information is entered following the news object's initial creation.

References Digikam::ItemScanner::iptcCorePropertyName(), Digikam::MetadataInfo::IptcCoreSource, and readSimpleProperty().

Referenced by fillTemplate(), Digikam::DBInfoIface::itemInfo(), replaceFrom(), and setSource().

Friends And Related Function Documentation

◆ ItemCopyrightCache

friend class ItemCopyrightCache
friend

Referenced by fillTemplate(), and removeAll().

Member Data Documentation

◆ m_cache

◆ m_id


The documentation for this class was generated from the following files: