Metadata API

Access to the metadata. More...

Macros
#define	META_NS_MASKOUT(x)   (x & 0xffff)
	Mask the namespace out.
#define	META_INDEX_MASKOUT(x)   (x & (0xffff<<16))
	Mask the index out.

Typedefs
typedef struct _MetadataIterator *	ORMetadataIteratorRef
	A metadata iterator.
typedef struct _MetaValue *	ORMetaValueRef
	A metadata value.
typedef const struct _MetaValue *	ORConstMetaValueRef
	A const metadata value.

Enumerations
enum	{ META_NS_EXIF = (1 << 16) , META_NS_TIFF = (2 << 16) }

Functions
const char *	or_metavalue_get_string (ORConstMetaValueRef value, uint32_t idx)
	Get the string out of the MetaValue. More...
const char *	or_metavalue_get_as_string (ORConstMetaValueRef value, bool full)
	Convert the MetaValue to a string. More...
uint32_t	or_metavalue_get_count (ORMetaValueRef value)
	Get the value count. More...
void	or_metavalue_release (ORMetaValueRef value)
	Free the MetaValue.
int	or_metadata_iterator_next (ORMetadataIteratorRef iterator)
	Move to the next metadata value. More...
int	or_metadata_iterator_get_entry (ORMetadataIteratorRef iterator, ORIfdDirRef *ifd, uint16_t *id, ExifTagType *type, ORMetaValueRef *value)
	Get the metadata entry from the iterator. More...
void	or_metadata_iterator_free (ORMetadataIteratorRef iterator)
	Free the iterator. More...

Detailed Description

Access to the metadata.

Enumeration Type Documentation

anonymous enum

anonymous enum

The meta data namespaces, 16 MSB of the index

Enumerator
META_NS_EXIF	EXIF namespace
META_NS_TIFF	TIFF namespace

Definition at line 50 of file metadata.h.

Function Documentation

or_metadata_iterator_free()

void or_metadata_iterator_free

(

ORMetadataIteratorRef

iterator

)

Free the iterator.

Parameters

iterator

The iterator to free.

Definition at line 133 of file metadata.cpp.

or_metadata_iterator_get_entry()

int or_metadata_iterator_get_entry	(	ORMetadataIteratorRef	iterator,
		ORIfdDirRef *	ifd,
		uint16_t *	id,
		ExifTagType *	type,
		ORMetaValueRef *	value
	)

Get the metadata entry from the iterator.

Parameters

iterator	The iterator.
ifd	Pointer to the IfdDirRef.
id	Pointer to id (nullable)
type	Pointer to exif tag type (nullable)
value	Pointer to store a newly allocated ORConstMetaValue (nullable)

Returns

0 if error. In that case none of the values are valid.

Definition at line 88 of file metadata.cpp.

References OpenRaw::MetadataIterator::getIfd().

or_metadata_iterator_next()

int or_metadata_iterator_next

(

ORMetadataIteratorRef

iterator

)

Move to the next metadata value.

Parameters

iterator

The metadata iterator.

Returns

0 if no more.

Definition at line 76 of file metadata.cpp.

or_metavalue_get_as_string()

const char* or_metavalue_get_as_string	(	ORConstMetaValueRef	value,
		bool	full
	)

Convert the MetaValue to a string.

Parameters

full	FALSE if the conversion should abridge the result.

Returns

A NUL terminated string. NULL if not found. The pointer is owned by the MetaValue.

Definition at line 50 of file metadata.cpp.

or_metavalue_get_count()

uint32_t or_metavalue_get_count

(

ORMetaValueRef

value

)

Get the value count.

Returns

The value count.

Definition at line 57 of file metadata.cpp.

or_metavalue_get_string()

const char* or_metavalue_get_string	(	ORConstMetaValueRef	value,
		uint32_t	idx
	)

Get the string out of the MetaValue.

Parameters

idx

Pass 0.

Todo:

Remove the idx parameter.

Returns

A NUL terminated string. NULL if not found. The pointer is owned by the MetaValue.

Definition at line 39 of file metadata.cpp.