Exiv2 Namespace Reference

Class CrwImage to access Canon CRW images.
References:
The Canon RAW (CRW) File Format by Phil Harvey. More...

Namespaces
	Internal
	Helper structure for the Matroska tags lookup table.

Classes
class	AsfVideo
	Class to access ASF video files. More...
class	BasicIo
	An interface for simple binary IO. More...
class	IoCloser
	Utility class that closes a BasicIo instance upon destruction. Meant to be used as a stack variable in functions that need to ensure BasicIo instances get closed. Useful when functions return errors from many locations. More...
class	MemIo
	Provides binary IO on blocks of memory by implementing the BasicIo interface. A copy-on-write implementation ensures that the data passed in is only copied when necessary, i.e., as soon as data is written to the MemIo. The original data is only used for reading. If writes are performed, the changed data can be retrieved using the read methods (since the data used in construction is never modified). More...
class	RemoteIo
	Provides binary IO for the data from stdin and data uri path. More...
class	HttpIo
	Provides the http read/write access for the RemoteIo. More...
struct	Iloc
class	BmffImage
	Class to access BMFF images. More...
class	BmpImage
	Class to access Windows bitmaps. This is just a stub - we only read width and height. More...
class	Cr2Image
	Class to access raw Canon CR2 images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. More...
class	Cr2Parser
	Stateless parser class for data in CR2 format. Images use this class to decode and encode CR2 data. See class TiffParser for details. More...
class	CrwImage
	Class to access raw Canon CRW images. Only Exif metadata and a comment are supported. CRW format does not contain IPTC metadata. More...
class	CrwParser
struct	RecordInfo
	Details of an IPTC record. More...
struct	DataSet
	Details of an IPTC dataset. More...
class	IptcDataSets
	IPTC dataset reference, implemented as a static class. More...
class	IptcKey
	Concrete keys for IPTC metadata. More...
class	EpsImage
	Class to access EPS images. More...
class	LogMsg
	Class for a log message, used by the library. Applications can set the log level and provide a customer log message handler (callback function). More...
class	Error
	Simple error class used for exceptions. An output operator is provided to print errors to a stream. More...
class	Exifdatum
	An Exif metadatum, consisting of an ExifKey and a Value and methods to manipulate these. More...
class	ExifThumbC
	Access to a Exif thumbnail image. This class provides higher level accessors to the thumbnail image that is optionally embedded in IFD1 of the Exif data. These methods do not write to the Exif metadata. Manipulators are provided in subclass ExifThumb. More...
class	ExifThumb
	Access and modify an Exif thumbnail image. This class implements manipulators to set and erase the thumbnail image that is optionally embedded in IFD1 of the Exif data. Accessors are provided by the base class, ExifThumbC. More...
class	ExifData
	A container for Exif data. This is a top-level class of the Exiv2 library. The container holds Exifdatum objects. More...
class	ExifParser
	Stateless parser class for Exif data. Images use this class to decode and encode binary Exif data. More...
class	Uri
	A container for URL components. It also provides the method to parse a URL to get the protocol, host, path, port, querystring, username, password. More...
class	GifImage
	Class to access raw GIF images. Exif/IPTC metadata are supported directly. More...
struct	NativePreview
	Native preview information. This is meant to be used only by the PreviewManager. More...
class	Image
	Abstract base class defining the interface for an image. This is the top-level interface to the Exiv2 library. More...
class	ImageFactory
	Returns an Image instance of the specified type. More...
class	Iptcdatum
	An IPTC metadatum ("dataset"), consisting of an IptcKey and a Value and methods to manipulate these. More...
class	IptcData
	A container for IPTC data. This is a top-level class of the Exiv2 library. More...
class	IptcParser
	Stateless parser class for IPTC data. Images use this class to decode and encode binary IPTC data. More...
class	Jp2Image
	Class to access JPEG-2000 images. More...
class	JpegBase
	Abstract helper base class to access JPEG images. More...
class	JpegImage
	Class to access JPEG images. More...
class	ExvImage
	Helper class to access Exiv2 files. More...
class	MatroskaVideo
	Class to access Matroska video files. More...
class	Key
	Abstract base class defining the Key of a metadatum. Keys are used to identify and group metadata. More...
class	Metadatum
	Abstract base class defining the interface to access information related to one metadata tag. More...
class	MrwImage
	Class to access raw Minolta MRW images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. More...
class	OrfImage
	Class to access raw Olympus ORF images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. More...
class	OrfParser
	Stateless parser class for data in ORF format. Images use this class to decode and encode ORF data. See class TiffParser for details. More...
class	PgfImage
	Class to access PGF images. Exif and IPTC metadata are supported directly. More...
struct	Photoshop
	Helper class, has methods to deal with Photoshop "Information Resource Blocks" (IRBs). More...
class	PngImage
	Class to access PNG images. Exif and IPTC metadata are supported directly. More...
struct	PreviewProperties
	Preview image properties. More...
class	PreviewImage
	Class that holds preview image properties and data buffer. More...
class	PreviewManager
	Class for extracting preview images from image metadata. More...
struct	XmpPropertyInfo
	Information about one XMP property. More...
struct	XmpNsInfo
	Structure mapping XMP namespaces and (preferred) prefixes. More...
class	XmpProperties
	XMP property reference, implemented as a static class. More...
class	XmpKey
	Concrete keys for XMP metadata. More...
class	PsdImage
	Class to access raw Photoshop images. More...
class	QuickTimeVideo
	Class to access QuickTime video files. More...
class	RafImage
	Class to access raw Fujifilm RAF images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. More...
class	RiffVideo
	Class to access RIFF video files. More...
class	Rw2Image
	Class to access raw Panasonic RW2 images. Exif metadata is supported directly, IPTC and XMP are read from the Exif data, if present. More...
class	Rw2Parser
	Stateless parser class for data in RW2 format. Images use this class to decode and encode RW2 data. Only decoding is currently implemented. See class TiffParser for details. More...
struct	Slice
	Slice (= view) for STL containers. More...
struct	Slice< const container >
	Specialization of slices for constant containers. More...
struct	Slice< const T * >
struct	Slice< T * >
struct	GroupInfo
	The details of an Exif group. Groups include IFDs and binary arrays. More...
struct	TagInfo
	Tag information. More...
class	ExifTags
	Access to Exif group and tag lists and misc. tag reference methods, implemented as a static class. More...
class	ExifKey
	Concrete keys for Exif metadata and access to Exif tag reference data. More...
class	TgaImage
	Class to access raw TARGA images. This is just a stub - we only read width and height. More...
class	TiffImage
	Class to access TIFF images. Exif metadata is supported directly, IPTC is read from the Exif data, if present. More...
class	TiffParser
	Stateless parser class for data in TIFF format. Images use this class to decode and encode TIFF data. It is a wrapper of the internal class Internal::TiffParserWorker. More...
class	TypeInfo
	Type information lookup functions. Implemented as a static class. More...
struct	DataBuf
	Utility class containing a character array. All it does is to take care of memory allocation and deletion. Its primary use is meant to be as a stack variable in functions that need a temporary data buffer. More...
class	Value
	Common interface for all types of values used with metadata. More...
class	DataValue
	Value for an undefined data type. More...
class	StringValueBase
	Abstract base class for a string based Value type. More...
class	StringValue
	Value for string type. More...
class	AsciiValue
	Value for an Ascii string type. More...
class	CommentValue
	Value for an Exif comment. More...
class	XmpValue
	Base class for all Exiv2 values used to store XMP property values. More...
class	XmpTextValue
	Value type suitable for simple XMP properties and XMP nodes of complex types which are not parsed into specific values. More...
class	XmpArrayValue
	Value type for simple arrays. Each item in the array is a simple value, without qualifiers. The array may be an ordered (seq), unordered (bag) or alternative array (alt). The array items must not contain qualifiers. For language alternatives use LangAltValue. More...
struct	LangAltValueComparator
	LangAltValueComparator More...
class	LangAltValue
	Value type for XMP language alternative properties. More...
class	DateValue
	Value for simple ISO 8601 dates More...
class	TimeValue
	Value for simple ISO 8601 times. More...
class	ValueType
	Template for a Value of a basic type. This is used for unsigned and signed short, long and rationals. More...
class	WebPImage
	Class to access WEBP video files. More...
class	Xmpdatum
	Information related to an XMP property. An XMP metadatum consists of an XmpKey and a Value and provides methods to manipulate these. More...
class	XmpData
	A container for XMP data. This is a top-level class of the Exiv2 library. More...
class	XmpParser
	Stateless parser class for XMP packets. Images use this class to parse and serialize XMP packets. The parser uses the XMP toolkit to do the job. More...
class	XmpSidecar
	Class to access XMP sidecar files. They contain only XMP metadata. More...

Typedefs
using	Dictionary = std::map< std::string, std::string >
	typedef for string:string map
using	ExifMetadata = std::list< Exifdatum >
	Container type to hold all metadata.
using	NativePreviewList = std::vector< NativePreview >
	List of native previews. This is meant to be used only by the PreviewManager.
using	NewInstanceFct = Image::UniquePtr(*)(BasicIo::UniquePtr io, bool create)
	Type for function pointer that creates new Image instances.
using	IsThisTypeFct = bool(*)(BasicIo &iIo, bool advance)
	Type for function pointer that checks image types.
using	IptcMetadata = std::vector< Iptcdatum >
	Container type to hold all metadata.
using	PreviewId = int
	Type of preview image.
using	PreviewPropertiesList = std::vector< PreviewProperties >
	Container type to hold all preview images metadata.
using	PrintFct = std::ostream &(*)(std::ostream &, const Value &, const ExifData *pExifData)
	Type for a function pointer for functions interpreting the tag value.
using	TagListFct = const TagInfo *(*)()
	A function returning a tag list.
using	byte = uint8_t
	1 byte unsigned integer type.
using	URational = std::pair< uint32_t, uint32_t >
	8 byte unsigned rational type.
using	Rational = std::pair< int32_t, int32_t >
	8 byte signed rational type.
using	Blob = std::vector< byte >
	Container for binary data.
using	UShortValue = ValueType< uint16_t >
	Unsigned short value type.
using	ULongValue = ValueType< uint32_t >
	Unsigned long value type.
using	URationalValue = ValueType< URational >
	Unsigned rational value type.
using	ShortValue = ValueType< int16_t >
	Signed short value type.
using	LongValue = ValueType< int32_t >
	Signed long value type.
using	RationalValue = ValueType< Rational >
	Signed rational value type.
using	FloatValue = ValueType< float >
	Float value type.
using	DoubleValue = ValueType< double >
	Double value type.
using	XmpMetadata = std::vector< Xmpdatum >
	Container type to hold all metadata.

Enumerations
enum class	ErrorCode {   kerSuccess = 0 , kerGeneralError , kerErrorMessage , kerCallFailed ,   kerNotAnImage , kerInvalidDataset , kerInvalidRecord , kerInvalidKey ,   kerInvalidTag , kerValueNotSet , kerDataSourceOpenFailed , kerFileOpenFailed ,   kerFileContainsUnknownImageType , kerMemoryContainsUnknownImageType , kerUnsupportedImageType , kerFailedToReadImageData ,   kerNotAJpeg , kerFailedToMapFileForReadWrite , kerFileRenameFailed , kerTransferFailed ,   kerMemoryTransferFailed , kerInputDataReadFailed , kerImageWriteFailed , kerNoImageInInputData ,   kerInvalidIfdId , kerValueTooLarge , kerDataAreaValueTooLarge , kerOffsetOutOfRange ,   kerUnsupportedDataAreaOffsetType , kerInvalidCharset , kerUnsupportedDateFormat , kerUnsupportedTimeFormat ,   kerWritingImageFormatUnsupported , kerInvalidSettingForImage , kerNotACrwImage , kerFunctionNotSupported ,   kerNoNamespaceInfoForXmpPrefix , kerNoPrefixForNamespace , kerTooLargeJpegSegment , kerUnhandledXmpdatum ,   kerUnhandledXmpNode , kerXMPToolkitError , kerDecodeLangAltPropertyFailed , kerDecodeLangAltQualifierFailed ,   kerEncodeLangAltPropertyFailed , kerPropertyNameIdentificationFailed , kerSchemaNamespaceNotRegistered , kerNoNamespaceForPrefix ,   kerAliasesNotSupported , kerInvalidXmpText , kerTooManyTiffDirectoryEntries , kerMultipleTiffArrayElementTagsInDirectory ,   kerWrongTiffArrayElementTagType , kerInvalidKeyXmpValue , kerInvalidIccProfile , kerInvalidXMP ,   kerTiffDirectoryTooLarge , kerInvalidTypeValue , kerInvalidLangAltValue , kerInvalidMalloc ,   kerCorruptedMetadata , kerArithmeticOverflow , kerMallocFailed , kerInvalidIconvEncoding ,   kerErrorCount }
	Complete list of all Exiv2 error codes.
enum	EnVar { envHTTPPOST = 0 , envTIMEOUT = 1 }
	the name of environmental variables.
enum	Protocol {   pFile = 0 , pHttp , pFtp , pHttps ,   pSftp , pFileUri , pDataUri , pStdin }
	the collection of protocols.
enum	PrintStructureOption {   kpsNone , kpsBasic , kpsXMP , kpsRecursive ,   kpsIccProfile , kpsIptcErase }
	Options for printStructure.
enum class	ImageType {   none , arw , asf , bigtiff ,   bmff , bmp , cr2 , crw ,   dng , eps , exv , gif ,   jp2 , jpeg , mrw , nef ,   orf , pef , png , pgf ,   psd , raf , rw2 , sr2 ,   srw , tga , tiff , webp ,   xmp , qtime , riff , mkv }
	Supported Image Formats. More...
enum	XmpCategory { xmpInternal , xmpExternal }
	Category of an XMP property.
enum class	IfdId : uint32_t {   ifdIdNotSet , ifd0Id , ifd1Id , ifd2Id ,   ifd3Id , exifId , gpsId , iopId ,   mpfId , subImage1Id , subImage2Id , subImage3Id ,   subImage4Id , subImage5Id , subImage6Id , subImage7Id ,   subImage8Id , subImage9Id , subThumb1Id , panaRawId ,   mnId , canonId , canonAfCId , canonAfMiAdjId ,   canonAmId , canonAsId , canonCbId , canonCiId ,   canonCsId , canonFilId , canonFlId , canonHdrId ,   canonLeId , canonMeId , canonMoID , canonMvId ,   canonRawBId , canonSiId , canonCfId , canonContrastId ,   canonFcd1Id , canonFcd2Id , canonFcd3Id , canonLiOpId ,   canonMyColorID , canonPiId , canonPaId , canonTiId ,   canonFiId , canonPrId , canonPreID , canonVigCorId ,   canonVigCor2Id , canonWbId , casioId , casio2Id ,   fujiId , minoltaId , minoltaCs5DId , minoltaCs7DId ,   minoltaCsOldId , minoltaCsNewId , nikon1Id , nikon2Id ,   nikon3Id , nikonPvId , nikonVrId , nikonPcId ,   nikonWtId , nikonIiId , nikonAfId , nikonAf21Id ,   nikonAf22Id , nikonAFTId , nikonFiId , nikonMeId ,   nikonFl1Id , nikonFl2Id , nikonFl3Id , nikonFl6Id ,   nikonFl7Id , nikonSi1Id , nikonSi2Id , nikonSi3Id ,   nikonSi4Id , nikonSi5Id , nikonSi6Id , nikonLd1Id ,   nikonLd2Id , nikonLd3Id , nikonLd4Id , nikonCb1Id ,   nikonCb2Id , nikonCb2aId , nikonCb2bId , nikonCb3Id ,   nikonCb4Id , olympusId , olympus2Id , olympusCsId ,   olympusEqId , olympusRdId , olympusRd2Id , olympusIpId ,   olympusFiId , olympusFe1Id , olympusFe2Id , olympusFe3Id ,   olympusFe4Id , olympusFe5Id , olympusFe6Id , olympusFe7Id ,   olympusFe8Id , olympusFe9Id , olympusRiId , panasonicId ,   pentaxId , pentaxDngId , samsung2Id , samsungPvId ,   samsungPwId , sigmaId , sony1Id , sony2Id ,   sonyMltId , sony1CsId , sony1Cs2Id , sony2CsId ,   sony2Cs2Id , sony2FpId , sonyMisc1Id , sonyMisc2bId ,   sonyMisc3cId , sonySInfo1Id , sony2010eId , sony1MltCs7DId ,   sony1MltCsOldId , sony1MltCsNewId , sony1MltCsA100Id , tagInfoMvId ,   lastId , ignoreId = lastId }
	Type to specify the IFD to which a metadata belongs.
enum class	SectionId {   sectionIdNotSet , imgStruct , recOffset , imgCharacter ,   otherTags , exifFormat , exifVersion , imgConfig ,   userInfo , relatedFile , dateTime , captureCond ,   gpsTags , iopTags , mpfTags , makerTags ,   dngTags , panaRaw , tiffEp , tiffPm6 ,   adobeOpi , lastSectionId }
	Section identifiers to logically group tags. A section consists of nothing more than a name, based on the Exif standard.
enum	ByteOrder { invalidByteOrder , littleEndian , bigEndian }
	Type to express the byte order (little or big endian)
enum	WriteMethod { wmIntrusive , wmNonIntrusive }
	Type to indicate write method used by TIFF parsers.
enum	MetadataId {   mdNone = 0 , mdExif = 1 , mdIptc = 2 , mdComment = 4 ,   mdXmp = 8 , mdIccProfile = 16 }
	An identifier for each type of metadata.
enum	AccessMode { amNone = 0 , amRead = 1 , amWrite = 2 , amReadWrite = 3 }
	An identifier for each mode of metadata support.
enum	TypeId {   unsignedByte = 1 , asciiString = 2 , unsignedShort = 3 , unsignedLong = 4 ,   unsignedRational = 5 , signedByte = 6 , undefined = 7 , signedShort = 8 ,   signedLong = 9 , signedRational = 10 , tiffFloat = 11 , tiffDouble = 12 ,   tiffIfd = 13 , unsignedLongLong = 16 , signedLongLong = 17 , tiffIfd8 = 18 ,   string = 0x10000 , date = 0x10001 , time = 0x10002 , comment = 0x10003 ,   directory = 0x10004 , xmpText = 0x10005 , xmpAlt = 0x10006 , xmpBag = 0x10007 ,   xmpSeq = 0x10008 , langAlt = 0x10009 , invalidTypeId = 0x1fffe , lastTypeId = 0x1ffff }
	Exiv2 value type identifiers. More...

Functions
EXIV2API Image::UniquePtr	newAsfInstance (BasicIo::UniquePtr io, bool create)
	Create a new AsfVideo instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isAsfType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Windows Asf Video.
EXIV2API DataBuf	readFile (const std::string &path)
	Read file path into a DataBuf, which is returned. More...
EXIV2API size_t	writeFile (const DataBuf &buf, const std::string &path)
	Write DataBuf buf to file path. More...
EXIV2API bool	enableBMFF (bool enable=true)
EXIV2API Image::UniquePtr	newBmffInstance (BasicIo::UniquePtr io, bool create)
	Create a new BMFF instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isBmffType (BasicIo &iIo, bool advance)
	Check if the file iIo is a BMFF image.
EXIV2API Image::UniquePtr	newBmpInstance (BasicIo::UniquePtr io, bool create)
	Create a new BmpImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isBmpType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Windows Bitmap image.
EXIV2API void	copyExifToXmp (const ExifData &exifData, XmpData &xmpData)
	Convert (copy) Exif tags to XMP properties.
EXIV2API void	moveExifToXmp (ExifData &exifData, XmpData &xmpData)
	Convert (move) Exif tags to XMP properties, remove converted Exif tags.
EXIV2API void	copyXmpToExif (const XmpData &xmpData, ExifData &exifData)
	Convert (copy) XMP properties to Exif tags.
EXIV2API void	moveXmpToExif (XmpData &xmpData, ExifData &exifData)
	Convert (move) XMP properties to Exif tags, remove converted XMP properties.
EXIV2API void	syncExifWithXmp (ExifData &exifData, XmpData &xmpData)
	Detect which metadata are newer and perform a copy in appropriate direction.
EXIV2API void	copyIptcToXmp (const IptcData &iptcData, XmpData &xmpData, const char *iptcCharset=nullptr)
	Convert (copy) IPTC datasets to XMP properties.
EXIV2API void	moveIptcToXmp (IptcData &iptcData, XmpData &xmpData, const char *iptcCharset=nullptr)
	Convert (move) IPTC datasets to XMP properties, remove converted IPTC datasets.
EXIV2API void	copyXmpToIptc (const XmpData &xmpData, IptcData &iptcData)
	Convert (copy) XMP properties to IPTC datasets.
EXIV2API void	moveXmpToIptc (XmpData &xmpData, IptcData &iptcData)
	Convert (move) XMP properties to IPTC tags, remove converted XMP properties.
EXIV2API bool	convertStringCharset (std::string &str, const char *from, const char *to)
	Convert character encoding of str from from to to. If the function succeeds, str contains the result string. More...
EXIV2API Image::UniquePtr	newCr2Instance (BasicIo::UniquePtr io, bool create)
	Create a new Cr2Image instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isCr2Type (BasicIo &iIo, bool advance)
	Check if the file iIo is a CR2 image.
EXIV2API Image::UniquePtr	newCrwInstance (BasicIo::UniquePtr io, bool create)
	Create a new CrwImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isCrwType (BasicIo &iIo, bool advance)
	Check if the file iIo is a CRW image.
EXIV2API std::ostream &	operator<< (std::ostream &os, const DataSet &dataSet)
	Output operator for dataSet.
EXIV2API ExifData::const_iterator	orientation (const ExifData &ed)
EXIV2API ExifData::const_iterator	isoSpeed (const ExifData &ed)
EXIV2API ExifData::const_iterator	dateTimeOriginal (const ExifData &ed)
EXIV2API ExifData::const_iterator	flashBias (const ExifData &ed)
EXIV2API ExifData::const_iterator	exposureMode (const ExifData &ed)
EXIV2API ExifData::const_iterator	sceneMode (const ExifData &ed)
EXIV2API ExifData::const_iterator	macroMode (const ExifData &ed)
EXIV2API ExifData::const_iterator	imageQuality (const ExifData &ed)
EXIV2API ExifData::const_iterator	whiteBalance (const ExifData &ed)
EXIV2API ExifData::const_iterator	lensName (const ExifData &ed)
EXIV2API ExifData::const_iterator	saturation (const ExifData &ed)
EXIV2API ExifData::const_iterator	sharpness (const ExifData &ed)
EXIV2API ExifData::const_iterator	contrast (const ExifData &ed)
EXIV2API ExifData::const_iterator	sceneCaptureType (const ExifData &ed)
EXIV2API ExifData::const_iterator	meteringMode (const ExifData &ed)
EXIV2API ExifData::const_iterator	make (const ExifData &ed)
EXIV2API ExifData::const_iterator	model (const ExifData &ed)
EXIV2API ExifData::const_iterator	exposureTime (const ExifData &ed)
EXIV2API ExifData::const_iterator	fNumber (const ExifData &ed)
EXIV2API ExifData::const_iterator	shutterSpeedValue (const ExifData &ed)
EXIV2API ExifData::const_iterator	apertureValue (const ExifData &ed)
EXIV2API ExifData::const_iterator	brightnessValue (const ExifData &ed)
EXIV2API ExifData::const_iterator	exposureBiasValue (const ExifData &ed)
EXIV2API ExifData::const_iterator	maxApertureValue (const ExifData &ed)
EXIV2API ExifData::const_iterator	subjectDistance (const ExifData &ed)
EXIV2API ExifData::const_iterator	lightSource (const ExifData &ed)
EXIV2API ExifData::const_iterator	flash (const ExifData &ed)
EXIV2API ExifData::const_iterator	serialNumber (const ExifData &ed)
EXIV2API ExifData::const_iterator	focalLength (const ExifData &ed)
EXIV2API ExifData::const_iterator	subjectArea (const ExifData &ed)
EXIV2API ExifData::const_iterator	flashEnergy (const ExifData &ed)
EXIV2API ExifData::const_iterator	exposureIndex (const ExifData &ed)
EXIV2API ExifData::const_iterator	sensingMethod (const ExifData &ed)
EXIV2API ExifData::const_iterator	afPoint (const ExifData &ed)
EXIV2API Image::UniquePtr	newEpsInstance (BasicIo::UniquePtr io, bool create)
	Create a new EpsImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isEpsType (BasicIo &iIo, bool advance)
	Check if the file iIo is a EPS image.
template<typename charT , typename T >
std::basic_string< charT >	toBasicString (const T &arg)
	Generalised toString function.
std::ostream &	operator<< (std::ostream &os, const Error &error)
	Error output operator
EXIV2API std::string	getEnv (int env_var)
	Return the value of environmental variable. More...
EXIV2API std::string	urlencode (const std::string &str)
	Encode the input url. More...
EXIV2API void	urldecode (std::string &str)
	Like urlencode(char* str) but accept the input url in the std::string and modify it. More...
EXIV2API int	base64encode (const void *data_buf, size_t dataLength, char *result, size_t resultSize)
	Encode in base64 the data in data_buf and put the resulting string in result. More...
EXIV2API size_t	base64decode (const char *in, char *out, size_t out_size)
	Decode base64 data and put the resulting string in out. More...
EXIV2API Protocol	fileProtocol (const std::string &path)
	Return the protocol of the path. More...
EXIV2API bool	fileExists (const std::string &path)
	Test if a file exists. More...
EXIV2API std::string	strError ()
	Return a system error message and the error code (errno). See strerror(3).
EXIV2API std::string	getProcessPath ()
	Return the path of the current process.
EXIV2API Image::UniquePtr	newGifInstance (BasicIo::UniquePtr io, bool create)
	Create a new GifImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isGifType (BasicIo &iIo, bool advance)
	Check if the file iIo is a GIF image.
EXIV2API int	http (Exiv2::Dictionary &request, Exiv2::Dictionary &response, std::string &errors)
	execute an HTTP request More...
EXIV2API void	append (Exiv2::Blob &blob, const byte *buf, size_t len)
	Append len bytes pointed to by buf to blob.
EXIV2API Image::UniquePtr	newJp2Instance (BasicIo::UniquePtr io, bool create)
	Create a new Jp2Image instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isJp2Type (BasicIo &iIo, bool advance)
	Check if the file iIo is a JPEG-2000 image.
EXIV2API Image::UniquePtr	newJpegInstance (BasicIo::UniquePtr io, bool create)
	Create a new JpegImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isJpegType (BasicIo &iIo, bool advance)
	Check if the file iIo is a JPEG image.
EXIV2API Image::UniquePtr	newExvInstance (BasicIo::UniquePtr io, bool create)
	Create a new ExvImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isExvType (BasicIo &iIo, bool advance)
	Check if the file iIo is an EXV file.
EXIV2API Image::UniquePtr	newMkvInstance (BasicIo::UniquePtr io, bool create)
	Create a new MatroskaVideo instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isMkvType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Matroska Video.
std::ostream &	operator<< (std::ostream &os, const Key &key)
	Output operator for Key types.
std::ostream &	operator<< (std::ostream &os, const Metadatum &md)
	Output operator for Metadatum types, writing the interpreted tag value.
EXIV2API bool	cmpMetadataByTag (const Metadatum &lhs, const Metadatum &rhs)
	Compare two metadata by tag. Return true if the tag of metadatum lhs is less than that of rhs.
EXIV2API bool	cmpMetadataByKey (const Metadatum &lhs, const Metadatum &rhs)
	Compare two metadata by key. Return true if the key of metadatum lhs is less than that of rhs.
EXIV2API Image::UniquePtr	newMrwInstance (BasicIo::UniquePtr io, bool create)
	Create a new MrwImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isMrwType (BasicIo &iIo, bool advance)
	Check if the file iIo is a MRW image.
EXIV2API Image::UniquePtr	newOrfInstance (BasicIo::UniquePtr io, bool create)
	Create a new OrfImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isOrfType (BasicIo &iIo, bool advance)
	Check if the file iIo is an ORF image.
EXIV2API Image::UniquePtr	newPgfInstance (BasicIo::UniquePtr io, bool create)
	Create a new PgfImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isPgfType (BasicIo &iIo, bool advance)
	Check if the file iIo is a PGF image.
EXIV2API Image::UniquePtr	newPngInstance (BasicIo::UniquePtr io, bool create)
	Create a new PngImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isPngType (BasicIo &iIo, bool advance)
	Check if the file iIo is a PNG image.
EXIV2API std::ostream &	operator<< (std::ostream &os, const XmpPropertyInfo &propertyInfo)
	Output operator for property info.
EXIV2API Image::UniquePtr	newPsdInstance (BasicIo::UniquePtr io, bool create)
	Create a new PsdImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isPsdType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Photoshop image.
EXIV2API Image::UniquePtr	newQTimeInstance (BasicIo::UniquePtr io, bool create)
	Create a new QuicktimeVideo instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isQTimeType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Quick Time Video.
EXIV2API Image::UniquePtr	newRafInstance (BasicIo::UniquePtr io, bool create)
	Create a new RafImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isRafType (BasicIo &iIo, bool advance)
	Check if the file iIo is a RAF image.
EXIV2API Image::UniquePtr	newRiffInstance (BasicIo::UniquePtr io, bool create)
EXIV2API bool	isRiffType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Riff Video.
EXIV2API Image::UniquePtr	newRw2Instance (BasicIo::UniquePtr io, bool create)
	Create a new Rw2Image instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isRw2Type (BasicIo &iIo, bool advance)
	Check if the file iIo is a RW2 image.
template<typename T >
Slice< T >	makeSlice (T &cont, size_t begin, size_t end)
	Return a new slice with the given bounds. More...
template<typename T >
Slice< T * >	makeSlice (T *ptr, size_t begin, size_t end)
template<typename container >
Slice< container >	makeSlice (container &cont)
	Return a new slice spanning the whole container.
template<typename container >
Slice< container >	makeSliceFrom (container &cont, size_t begin)
	Return a new slice spanning from begin until the end of the container.
template<typename container >
Slice< container >	makeSliceUntil (container &cont, size_t end)
	Return a new slice spanning until end.
template<typename T >
Slice< T * >	makeSliceUntil (T *ptr, size_t end)
std::ostream &	operator<< (std::ostream &os, IfdId id)
EXIV2API std::ostream &	operator<< (std::ostream &os, const TagInfo &ti)
	Output operator for TagInfo.
EXIV2API Image::UniquePtr	newTgaInstance (BasicIo::UniquePtr io, bool create)
	Create a new TgaImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isTgaType (BasicIo &iIo, bool advance)
	Check if the file iIo is a Targa v2 image.
EXIV2API Image::UniquePtr	newTiffInstance (BasicIo::UniquePtr io, bool create)
	Create a new TiffImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isTiffType (BasicIo &iIo, bool advance)
	Check if the file iIo is a TIFF image.
EXIV2API Slice< byte * >	makeSlice (DataBuf &buf, size_t begin, size_t end)
	Create a new Slice from a DataBuf given the bounds. More...
EXIV2API Slice< const byte * >	makeSlice (const DataBuf &buf, size_t begin, size_t end)
	Overload of makeSlice for const DataBuf, returning an immutable Slice.
EXIV2API uint16_t	getUShort (const byte *buf, ByteOrder byteOrder)
	Read a 2 byte unsigned short value from the data buffer.
template<typename T >
uint16_t	getUShort (const Slice< T > &buf, ByteOrder byteOrder)
	Read a 2 byte unsigned short value from a Slice.
EXIV2API uint32_t	getULong (const byte *buf, ByteOrder byteOrder)
	Read a 4 byte unsigned long value from the data buffer.
EXIV2API uint64_t	getULongLong (const byte *buf, ByteOrder byteOrder)
	Read a 8 byte unsigned long value from the data buffer.
EXIV2API URational	getURational (const byte *buf, ByteOrder byteOrder)
	Read an 8 byte unsigned rational value from the data buffer.
EXIV2API int16_t	getShort (const byte *buf, ByteOrder byteOrder)
	Read a 2 byte signed short value from the data buffer.
EXIV2API int32_t	getLong (const byte *buf, ByteOrder byteOrder)
	Read a 4 byte signed long value from the data buffer.
EXIV2API Rational	getRational (const byte *buf, ByteOrder byteOrder)
	Read an 8 byte signed rational value from the data buffer.
EXIV2API float	getFloat (const byte *buf, ByteOrder byteOrder)
	Read a 4 byte single precision floating point value (IEEE 754 binary32) from the data buffer.
EXIV2API double	getDouble (const byte *buf, ByteOrder byteOrder)
	Read an 8 byte double precision floating point value (IEEE 754 binary64) from the data buffer.
EXIV2API std::ostream &	operator<< (std::ostream &os, const Rational &r)
	Output operator for our fake rational.
EXIV2API std::istream &	operator>> (std::istream &is, Rational &r)
	Input operator for our fake rational.
EXIV2API std::ostream &	operator<< (std::ostream &os, const URational &r)
	Output operator for our fake unsigned rational.
EXIV2API std::istream &	operator>> (std::istream &is, URational &r)
	Input operator for our fake unsigned rational.
EXIV2API size_t	us2Data (byte *buf, uint16_t s, ByteOrder byteOrder)
	Convert an unsigned short to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	ul2Data (byte *buf, uint32_t l, ByteOrder byteOrder)
	Convert an unsigned long to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	ull2Data (byte *buf, uint64_t l, ByteOrder byteOrder)
	Convert an uint64_t to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	ur2Data (byte *buf, URational l, ByteOrder byteOrder)
	Convert an unsigned rational to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	s2Data (byte *buf, int16_t s, ByteOrder byteOrder)
	Convert a signed short to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	l2Data (byte *buf, int32_t l, ByteOrder byteOrder)
	Convert a signed long to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	r2Data (byte *buf, Rational l, ByteOrder byteOrder)
	Convert a signed rational to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	f2Data (byte *buf, float f, ByteOrder byteOrder)
	Convert a single precision floating point (IEEE 754 binary32) float to data, write the data to the buffer, return number of bytes written.
EXIV2API size_t	d2Data (byte *buf, double d, ByteOrder byteOrder)
	Convert a double precision floating point (IEEE 754 binary64) double to data, write the data to the buffer, return number of bytes written.
EXIV2API void	hexdump (std::ostream &os, const byte *buf, size_t len, size_t offset=0)
	Print len bytes from buf in hex and ASCII format to the given stream, prefixed with the position in the buffer adjusted by offset.
EXIV2API bool	isHex (const std::string &str, size_t size=0, const std::string &prefix="")
	Return true if str is a hex number starting with prefix followed by size hex digits, false otherwise. If size is 0, any number of digits is allowed and all are checked.
EXIV2API int	exifTime (const char *buf, tm *tm)
	Converts a string in the form "%Y:%m:%d %H:%M:%S", e.g., "2007:05:24 12:31:55" to broken down time format, returns 0 if successful, else 1.
EXIV2API const char *	exvGettext (const char *str)
	Translate a string using the gettext framework. This wrapper hides all the implementation details from the interface.
EXIV2API int64_t	parseInt64 (const std::string &s, bool &ok)
	Return a int64_t set to the value represented by s. More...
EXIV2API uint32_t	parseUint32 (const std::string &s, bool &ok)
	Return a uint32_t set to the value represented by s. More...
EXIV2API float	parseFloat (const std::string &s, bool &ok)
	Return a float set to the value represented by s. More...
EXIV2API Rational	parseRational (const std::string &s, bool &ok)
	Return a Rational set to the value represented by s. More...
EXIV2API Rational	floatToRationalCast (float f)
	Very simple conversion of a float to a Rational. More...
template<typename T , typename K , int N>
const T *	find (T(&src)[N], const K &key)
	Find an element that matches key in the array src. More...
template<typename T >
std::string	toStringHelper (const T &arg, std::true_type)
	Utility function to convert the argument of any type to a string.
template<typename T >
std::string	toStringHelper (const T &arg, std::false_type)
template<typename T >
std::string	toString (const T &arg)
template<typename T >
T	stringTo (const std::string &s, bool &ok)
	Utility function to convert a string to a value of type T. More...
template<>
bool	stringTo< bool > (const std::string &s, bool &ok)
	Specialization of stringTo(const std::string& s, bool& ok) for bool. More...
std::ostream &	operator<< (std::ostream &os, const Value &value)
	Output operator for Value types.
template<typename T >
TypeId	getType ()
	Template to determine the TypeId for a type T.
template<>
TypeId	getType< uint16_t > ()
	Specialization for an unsigned short.
template<>
TypeId	getType< uint32_t > ()
	Specialization for an unsigned long.
template<>
TypeId	getType< URational > ()
	Specialization for an unsigned rational.
template<>
TypeId	getType< int16_t > ()
	Specialization for a signed short.
template<>
TypeId	getType< int32_t > ()
	Specialization for a signed long.
template<>
TypeId	getType< Rational > ()
	Specialization for a signed rational.
template<>
TypeId	getType< float > ()
	Specialization for a float.
template<>
TypeId	getType< double > ()
	Specialization for a double.
template<typename T >
T	getValue (const byte *buf, ByteOrder byteOrder)
	Read a value of type T from the data buffer. More...
template<>
uint16_t	getValue (const byte *buf, ByteOrder byteOrder)
	Read a value of type T from the data buffer. More...
template<typename T >
size_t	toData (byte *buf, T t, ByteOrder byteOrder)
	Convert a value of type T to data, write the data to the data buffer. More...
template<>
size_t	toData (byte *buf, uint16_t t, ByteOrder byteOrder)
	Specialization to write an unsigned short to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, uint32_t t, ByteOrder byteOrder)
	Specialization to write an unsigned long to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, URational t, ByteOrder byteOrder)
	Specialization to write an unsigned rational to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, int16_t t, ByteOrder byteOrder)
	Specialization to write a signed short to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, int32_t t, ByteOrder byteOrder)
	Specialization to write a signed long to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, Rational t, ByteOrder byteOrder)
	Specialization to write a signed rational to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, float t, ByteOrder byteOrder)
	Specialization to write a float to the data buffer. Return the number of bytes written.
template<>
size_t	toData (byte *buf, double t, ByteOrder byteOrder)
	Specialization to write a double to the data buffer. Return the number of bytes written.
EXIV2API uint32_t	versionNumber ()
	Return the version of Exiv2 available at runtime as a uint32_t.
EXIV2API std::string	versionString ()
	Return the version string Example: "0.25.0" (major.minor.patch)
EXIV2API std::string	versionNumberHexString ()
	Return the version of Exiv2 as hex string of fixed length 6.
EXIV2API const char *	version ()
	Return the version of Exiv2 as "C" string eg "0.27.0.2".
EXIV2API bool	testVersion (uint32_t major, uint32_t minor, uint32_t patch)
	Test the version of the available Exiv2 library at runtime. Return true if it is the same as or newer than the passed-in version. More...
EXIV2API void	dumpLibraryInfo (std::ostream &os, const std::vector< std::regex > &keys)
	dumpLibraryInfo implements the exiv2 option –version –verbose used by exiv2 test suite to inspect libraries loaded at run-time
EXIV2API Image::UniquePtr	newWebPInstance (BasicIo::UniquePtr io, bool create)
	Create a new WebPImage instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isWebPType (BasicIo &iIo, bool advance)
	Check if the file iIo is a WebP Video.
EXIV2API Image::UniquePtr	newXmpInstance (BasicIo::UniquePtr io, bool create)
	Create a new XmpSidecar instance and return an auto-pointer to it. Caller owns the returned object and the auto-pointer ensures that it will be deleted.
EXIV2API bool	isXmpType (BasicIo &iIo, bool advance)
	Check if the file iIo is an XMP sidecar file.

Detailed Description

Class CrwImage to access Canon CRW images.
References:
The Canon RAW (CRW) File Format by Phil Harvey.

Provides classes and functions to encode and decode Exif and Iptc data. The libexiv2 API consists of the objects of this namespace.

Provides easy (high-level) access to some Exif meta data.
Please keep in mind that these accessors are provided for convenience only and will return expected/desired metadata most of the time. The accessors check several Exif tags and/or MakerNote fields, but in rare cases this list of fields checked may not be complete (e.g. if a maker writes a new tag) and then nothing is returned. So there might be specific cases where you will want to use lower level Exiv2 API functions to access targeted Exif tags and/or MakerNote fields for more specific processing.
Please note also that lens name function uses some heuristics to reconstruct the lens name, which might involve combinig information from multiple tags and interpreting numeric codes. While the heuristics try to cover most cases, they can't be perfect and might fail in some circumstances, leading to imprecise results.

IPTC dataset and type information.

Author

Marco Piovanelli, Ovolab (marco) marco.piovanelli@pobox.com

Date

05-Mar-2007, marco: created

Author

Andreas Huggel (ahu) ahuggel@gmx.net

Date

22-Apr-06, ahu: created

Author

Andreas Huggel (ahu) ahuggel@gmx.net

Date

28-Aug-05, ahu: created

Author

Brad Schick (brad) brad@.nosp@m.robo.nosp@m.tbatt.nosp@m.le.c.nosp@m.om

Date

24-Jul-04, brad: created

Author

Carsten Pfeiffer pfeif.nosp@m.fer@.nosp@m.kde.o.nosp@m.rg

Date

28-Feb-09, gis: created

Enumeration Type Documentation

ImageType

enum Exiv2::ImageType

strong

Supported Image Formats.

Enumerator
bmp	Windows bitmap.
gif	GIF.
jp2	JPEG-2000.
psd	Photoshop (PSD)
xmp	XMP sidecar files.

TypeId

enum Exiv2::TypeId

Exiv2 value type identifiers.

Used primarily as identifiers when creating Exiv2 Value instances. See Value::create. 0x0000 to 0xffff are reserved for TIFF (Exif) types.

Enumerator
unsignedByte	Exif BYTE type, 8-bit unsigned integer.
asciiString	Exif ASCII type, 8-bit byte.
unsignedShort	Exif SHORT type, 16-bit (2-byte) unsigned integer.
unsignedLong	Exif LONG type, 32-bit (4-byte) unsigned integer.
unsignedRational	Exif RATIONAL type, two LONGs: numerator and denominator of a fraction.
signedByte	Exif SBYTE type, an 8-bit signed (twos-complement) integer.
undefined	Exif UNDEFINED type, an 8-bit byte that may contain anything.
signedShort	Exif SSHORT type, a 16-bit (2-byte) signed (twos-complement) integer.
signedLong	Exif SLONG type, a 32-bit (4-byte) signed (twos-complement) integer.
signedRational	Exif SRATIONAL type, two SLONGs: numerator and denominator of a fraction.
tiffFloat	TIFF FLOAT type, single precision (4-byte) IEEE format.
tiffDouble	TIFF DOUBLE type, double precision (8-byte) IEEE format.
tiffIfd	TIFF IFD type, 32-bit (4-byte) unsigned integer.
unsignedLongLong	Exif LONG LONG type, 64-bit (8-byte) unsigned integer.
signedLongLong	Exif LONG LONG type, 64-bit (8-byte) signed integer.
tiffIfd8	TIFF IFD type, 64-bit (8-byte) unsigned integer.
string	IPTC string type.
date	IPTC date type.
time	IPTC time type.
comment	Exiv2 type for the Exif user comment.
directory	Exiv2 type for a CIFF directory.
xmpText	XMP text type.
xmpAlt	XMP alternative type.
xmpBag	XMP bag type.
xmpSeq	XMP sequence type.
langAlt	XMP language alternative type.
invalidTypeId	Invalid type id.
lastTypeId	Last type id.

Function Documentation

afPoint()

EXIV2API ExifData::const_iterator Exiv2::afPoint

(

const ExifData &

ed

)

Return the AF point. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

apertureValue()

EXIV2API ExifData::const_iterator Exiv2::apertureValue

(

const ExifData &

ed

)

Return the aperture value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

base64decode()

EXIV2API size_t Exiv2::base64decode	(	const char *	in,
		char *	out,
		size_t	out_size
	)

Decode base64 data and put the resulting string in out.

Parameters

in	The data need to decode.
out	The container for the result, it should be large enough to contain the result.
out_size	The size of out in bytes.

Returns

the size of the resulting string. If it fails, return -1.

Note

Source: https://github.com/davidgaleano/libwebsockets/blob/master/lib/base64-decode.c

base64encode()

EXIV2API int Exiv2::base64encode	(	const void *	data_buf,
		size_t	dataLength,
		char *	result,
		size_t	resultSize
	)

Encode in base64 the data in data_buf and put the resulting string in result.

Parameters

data_buf	The data need to encode
dataLength	Size in bytes of the in buffer
result	The container for the result, NULL if it fails
resultSize	Size in bytes of the out string, it should be at least ((dataLength + 2) / 3) * 4 + 1

Returns

1 indicate success

Note

Source: http://en.wikibooks.org/wiki/Algorithm_Implementation/Miscellaneous/Base64

brightnessValue()

EXIV2API ExifData::const_iterator Exiv2::brightnessValue

(

const ExifData &

ed

)

Return the brightness value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

contrast()

EXIV2API ExifData::const_iterator Exiv2::contrast

(

const ExifData &

ed

)

Return the contrast level. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

convertStringCharset()

EXIV2API bool Exiv2::convertStringCharset	(	std::string &	str,
		const char *	from,
		const char *	to
	)

Convert character encoding of str from from to to. If the function succeeds, str contains the result string.

This function uses the iconv library, if the Exiv2 library was compiled with iconv support. Otherwise, on Windows, it uses Windows functions to support a limited number of conversions and fails with a warning if an unsupported conversion is attempted. If the function is called but Exiv2 was not compiled with iconv support and can't use Windows functions, it fails with a warning.

The conversions supported on Windows without iconv are:

from	to
UTF-8	UCS-2BE
UTF-8	UCS-2LE
UCS-2BE	UTF-8
UCS-2BE	UCS-2LE
UCS-2LE	UTF-8
UCS-2LE	UCS-2BE
ISO-8859-1	UTF-8
ASCII	UTF-8

Parameters

str	The string to convert. It is updated to the converted string, which may have a different size. If the function call fails, the string is not modified.
from	Charset in which the input string is encoded as a name understood by iconv_open(3).
to	Charset to convert the string to as a name understood by iconv_open(3).

Returns

Return true if the conversion was successful, else false.

dateTimeOriginal()

EXIV2API ExifData::const_iterator Exiv2::dateTimeOriginal

(

const ExifData &

ed

)

Return the date and time when the original image data was generated. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

exposureBiasValue()

EXIV2API ExifData::const_iterator Exiv2::exposureBiasValue

(

const ExifData &

ed

)

Return the exposure bias value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

exposureIndex()

EXIV2API ExifData::const_iterator Exiv2::exposureIndex

(

const ExifData &

ed

)

Return the exposure index. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

exposureMode()

EXIV2API ExifData::const_iterator Exiv2::exposureMode

(

const ExifData &

ed

)

Return the exposure mode setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

exposureTime()

EXIV2API ExifData::const_iterator Exiv2::exposureTime

(

const ExifData &

ed

)

Return the exposure time. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

fileExists()

EXIV2API bool Exiv2::fileExists

(

const std::string &

path

)

Test if a file exists.

Parameters

path	Name of file to verify.

Returns

true if path exists and, if ct is set, is a regular file, else false.

Note

The function calls stat() test for path and its type, see stat(2). errno is left unchanged in case of an error.

fileProtocol()

EXIV2API Protocol Exiv2::fileProtocol

(

const std::string &

path

)

Return the protocol of the path.

Parameters

path	The path of file to extract the protocol.

Returns

the protocol of the path.

find()

template<typename T , typename K , int N>

const T* Exiv2::find	(	T(&)	src[N],
		const K &	key
	)

Find an element that matches key in the array src.

Designed to be used with lookup tables as shown in the example below. Requires a Key structure (ideally in the array) and a comparison operator to compare a key with an array element. The size of the array is determined automagically. Thanks to Stephan Broennimann for this nifty implementation.

struct Bar {
    int i;
    int k;
    const char* data;
 
    struct Key;
    bool operator==(const Bar::Key& rhs) const;
};
 
struct Bar::Key {
    Key(int a, int b) : i(a), k(b) {}
    int i;
    int k;
};
 
bool Bar::operator==(const Bar::Key& key) const // definition
{
    return i == key.i && k == key.k;
}
 
const Bar bars[] = {
    { 1, 1, "bar data 1" },
    { 1, 2, "bar data 2" },
    { 1, 3, "bar data 3" }
};
 
int main ( void ) {
    const Bar* bar = find(bars, Bar::Key(1, 3));
    if (bar) std::cout << bar->data << "\n";
    else std::cout << "Key not found.\n";
    return 0;
}

flash()

EXIV2API ExifData::const_iterator Exiv2::flash

(

const ExifData &

ed

)

Return the status of flash. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

flashBias()

EXIV2API ExifData::const_iterator Exiv2::flashBias

(

const ExifData &

ed

)

Return the flash bias value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

flashEnergy()

EXIV2API ExifData::const_iterator Exiv2::flashEnergy

(

const ExifData &

ed

)

Return the flash energy. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

floatToRationalCast()

EXIV2API Rational Exiv2::floatToRationalCast

(

float

f

)

Very simple conversion of a float to a Rational.

Test it with the values that you expect and check the implementation to see if this is really what you want!

Referenced by Exiv2::ValueType< T >::toRational().

fNumber()

EXIV2API ExifData::const_iterator Exiv2::fNumber

(

const ExifData &

ed

)

Return the F number. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

focalLength()

EXIV2API ExifData::const_iterator Exiv2::focalLength

(

const ExifData &

ed

)

Return the focal length setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

getEnv()

EXIV2API std::string Exiv2::getEnv

(

int

env_var

)

Return the value of environmental variable.

Parameters

[in]

env_var

The name of environmental variable. Must be a member of the enumeration EnVar.

Returns

the value of environmental variable. If it's empty, the default value is returned.

Exceptions

std::out_of_range

when an unexpected EnVar is given as input.

getValue() [1/2]

template<typename T >

T Exiv2::getValue ( const byte *  buf, ByteOrder  byteOrder  )

inline

Read a value of type T from the data buffer.

We need this template function for the ValueType template classes. There are only specializations of this function available; no default implementation is provided.

Parameters

buf	Pointer to the data buffer to read from.
byteOrder	Applicable byte order (little or big endian).

Returns

A value of type T.

References getUShort().

getValue() [2/2]

template<>

double Exiv2::getValue ( const byte *  buf, ByteOrder  byteOrder  )

inline

Read a value of type T from the data buffer.

We need this template function for the ValueType template classes. There are only specializations of this function available; no default implementation is provided.

Parameters

buf	Pointer to the data buffer to read from.
byteOrder	Applicable byte order (little or big endian).

Returns

A value of type T.

References getUShort().

http()

EXIV2API int Exiv2::http	(	Exiv2::Dictionary &	request,
		Exiv2::Dictionary &	response,
		std::string &	errors
	)

execute an HTTP request

Parameters

request	- a Dictionary of headers to send to server
response	- a Dictionary of response headers (dictionary is filled by the response)
errors	- a String with an error

Returns

Server response 200 = OK, 404 = Not Found etc...

imageQuality()

EXIV2API ExifData::const_iterator Exiv2::imageQuality

(

const ExifData &

ed

)

Return the image quality setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

isoSpeed()

EXIV2API ExifData::const_iterator Exiv2::isoSpeed

(

const ExifData &

ed

)

Return the ISO speed used to shoot the image. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time. Please note also that ISO speed function uses some computations, which might involve combining information from multiple tags and interpreting numeric codes. While the computations try to cover most cases, they can't be perfect and might fail in some circumstances, leading to imprecise results.

lensName()

EXIV2API ExifData::const_iterator Exiv2::lensName

(

const ExifData &

ed

)

Return the name of the lens used. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time. Please note also that lens name function uses some heuristics to reconstruct the lens name, which might involve combining information from multiple tags and interpreting numeric codes. While the heuristics try to cover most cases, they can't be perfect and might fail in some circumstances, leading to imprecise results.

lightSource()

EXIV2API ExifData::const_iterator Exiv2::lightSource

(

const ExifData &

ed

)

Return the kind of light source. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

macroMode()

EXIV2API ExifData::const_iterator Exiv2::macroMode

(

const ExifData &

ed

)

Return the macro mode setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

make()

EXIV2API ExifData::const_iterator Exiv2::make

(

const ExifData &

ed

)

Return the camera make. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

makeSlice() [1/3]

EXIV2API Slice<byte*> Exiv2::makeSlice	(	DataBuf &	buf,
		size_t	begin,
		size_t	end
	)

Create a new Slice from a DataBuf given the bounds.

Parameters

[in]	buf	The DataBuf from which' data the Slice will be constructed
[in]	begin	Beginning bound of the new Slice. Must be smaller than end and both must not be larger than LONG_MAX.
[in]	end	End bound of the new Slice. Must be smaller than end and both must not be larger than LONG_MAX.

Exceptions

std::invalid_argument

when end is larger than LONG_MAX or anything that the constructor of Slice throws

makeSlice() [2/3]

template<typename T >

Slice<T> Exiv2::makeSlice ( T &  cont, size_t  begin, size_t  end  )

inline

Return a new slice with the given bounds.

Convenience wrapper around the slice's constructor for automatic template parameter deduction.

makeSlice() [3/3]

template<typename T >

Slice<T*> Exiv2::makeSlice ( T *  ptr, size_t  begin, size_t  end  )

inline

Overload of makeSlice for slices of C-arrays.

makeSliceUntil()

template<typename T >

Slice<T*> Exiv2::makeSliceUntil ( T *  ptr, size_t  end  )

inline

Overload of makeSliceUntil for pointer based slices.

maxApertureValue()

EXIV2API ExifData::const_iterator Exiv2::maxApertureValue

(

const ExifData &

ed

)

Return the max aperture value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

meteringMode()

EXIV2API ExifData::const_iterator Exiv2::meteringMode

(

const ExifData &

ed

)

Return the metering mode setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

model()

EXIV2API ExifData::const_iterator Exiv2::model

(

const ExifData &

ed

)

Return the camera model. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

orientation()

EXIV2API ExifData::const_iterator Exiv2::orientation

(

const ExifData &

ed

)

Return the orientation of the image. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

parseFloat()

EXIV2API float Exiv2::parseFloat	(	const std::string &	s,
		bool &	ok
	)

Return a float set to the value represented by s.

Besides strings that represent float values, the function also handles long, Rational and boolean (see also: stringTo(const std::string& s, bool& ok)).

Parameters

s	String to parse
ok	Output variable indicating the success of the operation.

Returns

Returns the float value represented by s and sets ok to true if the conversion was successful or false if not.

parseInt64()

EXIV2API int64_t Exiv2::parseInt64	(	const std::string &	s,
		bool &	ok
	)

Return a int64_t set to the value represented by s.

Besides strings that represent int64_t values, the function also handles float, Rational and boolean (see also: stringTo(const std::string& s, bool& ok)).

Parameters

s	String to parse
ok	Output variable indicating the success of the operation.

Returns

Returns the int64_t value represented by s and sets ok to true if the conversion was successful or false if not.

parseRational()

EXIV2API Rational Exiv2::parseRational	(	const std::string &	s,
		bool &	ok
	)

Return a Rational set to the value represented by s.

Besides strings that represent Rational values, the function also handles long, float and boolean (see also: stringTo(const std::string& s, bool& ok)). Uses floatToRationalCast(float f) if the string can be parsed into a float.

Parameters

s	String to parse
ok	Output variable indicating the success of the operation.

Returns

Returns the Rational value represented by s and sets ok to true if the conversion was successful or false if not.

parseUint32()

EXIV2API uint32_t Exiv2::parseUint32	(	const std::string &	s,
		bool &	ok
	)

Return a uint32_t set to the value represented by s.

Besides strings that represent uint32_t values, the function also handles float, Rational and boolean (see also: stringTo(const std::string& s, bool& ok)).

Parameters

s	String to parse
ok	Output variable indicating the success of the operation.

Returns

Returns the uint32_t value represented by s and sets ok to true if the conversion was successful or false if not.

readFile()

EXIV2API DataBuf Exiv2::readFile

(

const std::string &

path

)

Read file path into a DataBuf, which is returned.

Returns

Buffer containing the file.

Exceptions

Error

In case of failure.

Examples

xmpparse.cpp.

saturation()

EXIV2API ExifData::const_iterator Exiv2::saturation

(

const ExifData &

ed

)

Return the saturation level. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

sceneCaptureType()

EXIV2API ExifData::const_iterator Exiv2::sceneCaptureType

(

const ExifData &

ed

)

Return the scene capture type. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

sceneMode()

EXIV2API ExifData::const_iterator Exiv2::sceneMode

(

const ExifData &

ed

)

Return the scene mode setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

sensingMethod()

EXIV2API ExifData::const_iterator Exiv2::sensingMethod

(

const ExifData &

ed

)

Return the image sensor type. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

serialNumber()

EXIV2API ExifData::const_iterator Exiv2::serialNumber

(

const ExifData &

ed

)

Return the camera serial number. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

sharpness()

EXIV2API ExifData::const_iterator Exiv2::sharpness

(

const ExifData &

ed

)

Return the sharpness level. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

shutterSpeedValue()

EXIV2API ExifData::const_iterator Exiv2::shutterSpeedValue

(

const ExifData &

ed

)

Return the shutter speed value. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

stringTo()

template<typename T >

T Exiv2::stringTo	(	const std::string &	s,
		bool &	ok
	)

Utility function to convert a string to a value of type T.

The string representation of the value must match that recognized by the input operator for T for this function to succeed.

Parameters

s	String to convert
ok	Output variable indicating the success of the operation.

Returns

Returns the converted value and sets ok to true if the conversion was successful or false if not.

stringTo< bool >()

template<>

bool Exiv2::stringTo< bool >	(	const std::string &	s,
		bool &	ok
	)

Specialization of stringTo(const std::string& s, bool& ok) for bool.

Handles the same string values as the XMP SDK. Converts the string to lowercase and returns true if it is "true", "t" or "1", and false if it is "false", "f" or "0".

subjectArea()

EXIV2API ExifData::const_iterator Exiv2::subjectArea

(

const ExifData &

ed

)

Return the subject location and area. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

subjectDistance()

EXIV2API ExifData::const_iterator Exiv2::subjectDistance

(

const ExifData &

ed

)

Return the subject distance. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

testVersion()

EXIV2API bool Exiv2::testVersion	(	uint32_t	major,
		uint32_t	minor,
		uint32_t	patch
	)

Test the version of the available Exiv2 library at runtime. Return true if it is the same as or newer than the passed-in version.

Versions are denoted using a triplet of integers: major.minor.patch . The fourth version number is designated a "tweak" an used by Release Candidates

Examples

exifprint.cpp.

toData()

template<typename T >

size_t Exiv2::toData	(	byte *	buf,
		T	t,
		ByteOrder	byteOrder
	)

Convert a value of type T to data, write the data to the data buffer.

We need this template function for the ValueType template classes. There are only specializations of this function available; no default implementation is provided.

Parameters

buf	Pointer to the data buffer to write to.
t	Value to be converted.
byteOrder	Applicable byte order (little or big endian).

Returns

The number of bytes written to the buffer.

Referenced by Exiv2::ValueType< T >::copy().

urldecode()

EXIV2API void Exiv2::urldecode

(

std::string &

str

)

Like urlencode(char* str) but accept the input url in the std::string and modify it.

Todo:

This function can probably be hidden into the implementation details

urlencode()

EXIV2API std::string Exiv2::urlencode

(

const std::string &

str

)

Encode the input url.

Parameters

str	The url needs encoding.

Returns

the url-encoded version of str.

Note

Source: http://www.geekhideout.com/urlcode.shtml

Todo:

This function can probably be hidden into the implementation details

whiteBalance()

EXIV2API ExifData::const_iterator Exiv2::whiteBalance

(

const ExifData &

ed

)

Return the white balance setting. Please keep in mind that this accessor is provided for convenience only and will return expected/desired metadata most of the time.

writeFile()

EXIV2API size_t Exiv2::writeFile	(	const DataBuf &	buf,
		const std::string &	path
	)

Write DataBuf buf to file path.

Returns

Return the number of bytes written.

Exceptions

Error

In case of failure.