Loading...
Searching...
No Matches
properties.hpp
// SPDX-License-Identifier: GPL-2.0-or-later
#ifndef PROPERTIES_HPP_
#define PROPERTIES_HPP_
// *****************************************************************************
#include "exiv2lib_export.h"
// included header files
#include <mutex>
#include "datasets.hpp"
// *****************************************************************************
// namespace extensions
namespace Exiv2 {
// *****************************************************************************
// class declarations
class XmpKey;
// *****************************************************************************
// class definitions
enum XmpCategory { xmpInternal, xmpExternal };
struct EXIV2API XmpPropertyInfo {
bool operator==(const std::string& name) const;
const char* name_;
const char* title_;
const char* xmpValueType_;
TypeId typeId_;
XmpCategory xmpCategory_;
const char* desc_;
};
struct EXIV2API XmpNsInfo {
struct Prefix {
std::string prefix_;
};
struct Ns {
std::string ns_;
};
bool operator==(const Ns& ns) const;
bool operator==(const Prefix& prefix) const;
const char* ns_;
const char* prefix_;
const XmpPropertyInfo* xmpPropertyInfo_;
const char* desc_;
};
class EXIV2API XmpProperties {
private:
static const XmpNsInfo* nsInfoUnsafe(const std::string& prefix);
static void unregisterNsUnsafe(const std::string& ns);
static const XmpNsInfo* lookupNsRegistryUnsafe(const XmpNsInfo::Prefix& prefix);
public:
static const char* propertyTitle(const XmpKey& key);
static const char* propertyDesc(const XmpKey& key);
static TypeId propertyType(const XmpKey& key);
static const XmpPropertyInfo* propertyInfo(const XmpKey& key);
static std::string ns(const std::string& prefix);
static const char* nsDesc(const std::string& prefix);
static const XmpPropertyInfo* propertyList(const std::string& prefix);
static const XmpNsInfo* nsInfo(const std::string& prefix);
static std::string prefix(const std::string& ns);
static void printProperties(std::ostream& os, const std::string& prefix);
static std::ostream& printProperty(std::ostream& os, const std::string& key, const Value& value);
static void registerNs(const std::string& ns, const std::string& prefix);
static void unregisterNs(const std::string& ns);
static std::mutex mutex_;
static void unregisterNs();
using NsRegistry = std::map<std::string, XmpNsInfo>;
static const XmpNsInfo* lookupNsRegistry(const XmpNsInfo::Prefix& prefix);
// DATA
static NsRegistry nsRegistry_;
static void registeredNamespaces(Exiv2::Dictionary& nsDict);
}; // class XmpProperties
class EXIV2API XmpKey : public Key {
public:
using UniquePtr = std::unique_ptr<XmpKey>;
explicit XmpKey(const std::string& key);
XmpKey(const std::string& prefix, const std::string& property);
XmpKey(const XmpKey& rhs);
~XmpKey() override;
XmpKey& operator=(const XmpKey& rhs);
[[nodiscard]] std::string key() const override;
[[nodiscard]] const char* familyName() const override;
[[nodiscard]] std::string groupName() const override;
[[nodiscard]] std::string tagName() const override;
[[nodiscard]] std::string tagLabel() const override;
[[nodiscard]] std::string tagDesc() const override;
[[nodiscard]] uint16_t tag() const override;
[[nodiscard]] UniquePtr clone() const;
// Todo: Should this be removed? What about tagLabel then?
[[nodiscard]] std::string ns() const;
private:
[[nodiscard]] XmpKey* clone_() const override;
// Pimpl idiom
struct Impl;
std::unique_ptr<Impl> p_;
}; // class XmpKey
// *****************************************************************************
// free functions
EXIV2API std::ostream& operator<<(std::ostream& os, const XmpPropertyInfo& propertyInfo);
} // namespace Exiv2
#endif // #ifndef PROPERTIES_HPP_
Exiv2::Value
Common interface for all types of values used with metadata.
Definition value.hpp:33
Exiv2::XmpKey
Concrete keys for XMP metadata.
Definition properties.hpp:207
Exiv2::XmpKey::groupName
std::string groupName() const override
Return the name of the group (the second part of the key). For XMP keys, the group name is the schema...
Exiv2::XmpKey::tag
uint16_t tag() const override
Properties don't have a tag number. Return 0.
Exiv2::XmpKey::tagDesc
std::string tagDesc() const override
Return a description for the tag.
Exiv2::XmpKey::tagName
std::string tagName() const override
Return the name of the tag (which is also the third part of the key).
Exiv2::XmpKey::XmpKey
XmpKey(const XmpKey &rhs)
Copy constructor.
Exiv2::XmpKey::UniquePtr
std::unique_ptr< XmpKey > UniquePtr
Shortcut for an XmpKey auto pointer.
Definition properties.hpp:210
Exiv2::XmpKey::key
std::string key() const override
Return the key of the metadatum as a string. The key is of the form 'familyName.groupName....
Exiv2::XmpKey::tagLabel
std::string tagLabel() const override
Return a label for the tag.
Exiv2::XmpKey::ns
std::string ns() const
Return the schema namespace for the prefix of the key.
Exiv2::XmpKey::operator=
XmpKey & operator=(const XmpKey &rhs)
Assignment operator.
Exiv2::XmpKey::familyName
const char * familyName() const override
Return an identifier for the type of metadata (the first part of the key).
Exiv2::XmpKey::XmpKey
XmpKey(const std::string &key)
Constructor to create an XMP key from a key string.
Exiv2::XmpKey::XmpKey
XmpKey(const std::string &prefix, const std::string &property)
Constructor to create an XMP key from a schema prefix and a property name.
Exiv2::XmpKey::~XmpKey
~XmpKey() override
Virtual destructor.
Exiv2::XmpProperties
XMP property reference, implemented as a static class.
Definition properties.hpp:64
Exiv2::XmpProperties::nsDesc
static const char * nsDesc(const std::string &prefix)
Return the namespace description for the schema associated with prefix.
Exiv2::XmpProperties::NsRegistry
std::map< std::string, XmpNsInfo > NsRegistry
Type for the namespace registry.
Definition properties.hpp:188
Exiv2::XmpProperties::propertyType
static TypeId propertyType(const XmpKey &key)
Return the type for property key. The default for unknown keys is xmpText.
Exiv2::XmpProperties::propertyDesc
static const char * propertyDesc(const XmpKey &key)
Return the description of the property.
Exiv2::XmpProperties::mutex_
static std::mutex mutex_
Lock to be used while modifying properties.
Definition properties.hpp:176
Exiv2::XmpProperties::nsRegistry_
static NsRegistry nsRegistry_
Namespace registry.
Definition properties.hpp:195
Exiv2::XmpProperties::lookupNsRegistry
static const XmpNsInfo * lookupNsRegistry(const XmpNsInfo::Prefix &prefix)
Get the registered namespace for a specific prefix from the registry.
Exiv2::XmpProperties::unregisterNs
static void unregisterNs()
Unregister all custom namespaces.
Exiv2::XmpProperties::ns
static std::string ns(const std::string &prefix)
Return the namespace name for the schema associated with prefix.
Exiv2::XmpProperties::unregisterNs
static void unregisterNs(const std::string &ns)
Unregister a custom namespace ns.
Exiv2::XmpProperties::propertyInfo
static const XmpPropertyInfo * propertyInfo(const XmpKey &key)
Return information for the property for key.
Exiv2::XmpProperties::prefix
static std::string prefix(const std::string &ns)
Return the (preferred) prefix for schema namespace ns.
Exiv2::XmpProperties::propertyList
static const XmpPropertyInfo * propertyList(const std::string &prefix)
Return read-only list of built-in properties for prefix.
Exiv2::XmpProperties::printProperties
static void printProperties(std::ostream &os, const std::string &prefix)
Print a list of properties of a schema namespace to output stream os.
Exiv2::XmpProperties::registeredNamespaces
static void registeredNamespaces(Exiv2::Dictionary &nsDict)
Get all registered namespaces (for both Exiv2 and XMPsdk).
Exiv2::XmpProperties::printProperty
static std::ostream & printProperty(std::ostream &os, const std::string &key, const Value &value)
Interpret and print the value of an XMP property.
Exiv2::XmpProperties::propertyTitle
static const char * propertyTitle(const XmpKey &key)
Return the title (label) of the property.
Exiv2::XmpProperties::registerNs
static void registerNs(const std::string &ns, const std::string &prefix)
Register namespace ns with preferred prefix prefix.
Exiv2::XmpProperties::nsInfo
static const XmpNsInfo * nsInfo(const std::string &prefix)
Return information about a schema namespace for prefix. Always returns a valid pointer.
Exiv2
Class CrwImage to access Canon CRW images. References: The Canon RAW (CRW) File Format by Phil Harv...
Definition asfvideo.hpp:15
Exiv2::operator<<
EXIV2API std::ostream & operator<<(std::ostream &os, const DataSet &dataSet)
Output operator for dataSet.
Definition datasets.cpp:590
Exiv2::TypeId
TypeId
Exiv2 value type identifiers.
Definition types.hpp:70
Exiv2::Dictionary
std::map< std::string, std::string > Dictionary
typedef for string:string map
Definition datasets.hpp:312
Exiv2::XmpCategory
XmpCategory
Category of an XMP property.
Definition properties.hpp:25
Exiv2::XmpNsInfo::Ns
For comparison with namespace.
Definition properties.hpp:48
Exiv2::XmpNsInfo::Ns::ns_
std::string ns_
The namespace string.
Definition properties.hpp:50
Exiv2::XmpNsInfo::Prefix
For comparison with prefix.
Definition properties.hpp:43
Exiv2::XmpNsInfo::Prefix::prefix_
std::string prefix_
The prefix string.
Definition properties.hpp:45
Exiv2::XmpNsInfo
Structure mapping XMP namespaces and (preferred) prefixes.
Definition properties.hpp:41
Exiv2::XmpNsInfo::xmpPropertyInfo_
const XmpPropertyInfo * xmpPropertyInfo_
List of known properties.
Definition properties.hpp:59
Exiv2::XmpNsInfo::operator==
bool operator==(const Prefix &prefix) const
Comparison operator for prefix.
Exiv2::XmpNsInfo::desc_
const char * desc_
Brief description of the namespace.
Definition properties.hpp:60
Exiv2::XmpNsInfo::prefix_
const char * prefix_
(Preferred) prefix
Definition properties.hpp:58
Exiv2::XmpNsInfo::ns_
const char * ns_
Namespace.
Definition properties.hpp:57
Exiv2::XmpNsInfo::operator==
bool operator==(const Ns &ns) const
Comparison operator for namespace.
Exiv2::XmpPropertyInfo
Information about one XMP property.
Definition properties.hpp:28
Exiv2::XmpPropertyInfo::name_
const char * name_
Property name.
Definition properties.hpp:32
Exiv2::XmpPropertyInfo::desc_
const char * desc_
Property description.
Definition properties.hpp:37
Exiv2::XmpPropertyInfo::title_
const char * title_
Property title or label.
Definition properties.hpp:33
Exiv2::XmpPropertyInfo::operator==
bool operator==(const std::string &name) const
Comparison operator for name.
Exiv2::XmpPropertyInfo::xmpCategory_
XmpCategory xmpCategory_
Category (internal or external).
Definition properties.hpp:36
Exiv2::XmpPropertyInfo::xmpValueType_
const char * xmpValueType_
XMP value type (for info only).
Definition properties.hpp:34
Exiv2::XmpPropertyInfo::typeId_
TypeId typeId_
Exiv2 default type for the property.
Definition properties.hpp:35