exif-mnote-data.h File Reference

Handling EXIF MakerNote tags. More...

`#include <libexif/exif-log.h>`

Go to the source code of this file.

## Typedefs

typedef struct _ExifMnoteData | ExifMnoteData
| Data found in the MakerNote tag.

## Functions

void | exif_mnote_data_ref (ExifMnoteData *)
void | exif_mnote_data_unref (ExifMnoteData *)
void | exif_mnote_data_load (ExifMnoteData *d, const unsigned char *buf, unsigned int buf_siz)
| Load the MakerNote data from a memory buffer. More...
void | exif_mnote_data_save (ExifMnoteData *d, unsigned char **buf, unsigned int *buf_siz)
| Save the raw MakerNote data into a memory buffer. More...
unsigned int | exif_mnote_data_count (ExifMnoteData *d)
| Return the number of tags in the MakerNote. More...
unsigned int | exif_mnote_data_get_id (ExifMnoteData *d, unsigned int n)
| Return the MakerNote tag number for the tag at the specified index within the MakerNote. More...
const char * | exif_mnote_data_get_name (ExifMnoteData *d, unsigned int n)
| Returns textual name of the given MakerNote tag. More...
const char * | exif_mnote_data_get_title (ExifMnoteData *d, unsigned int n)
| Returns textual title of the given MakerNote tag. More...
const char * | exif_mnote_data_get_description (ExifMnoteData *d, unsigned int n)
| Returns verbose textual description of the given MakerNote tag. More...
char * | exif_mnote_data_get_value (ExifMnoteData *d, unsigned int n, char *val, unsigned int maxlen)
| Return a textual representation of the value of the MakerNote entry. More...
void | exif_mnote_data_log (ExifMnoteData *, ExifLog *)

## Detailed Description

Handling EXIF MakerNote tags.

## Function Documentation

## exif_mnote_data_count()

unsigned int exif_mnote_data_count | ( | ExifMnoteData * | d | ) |

Return the number of tags in the MakerNote.

Parameters

  [in] | d | MakerNote data

Returns
  number of tags, or 0 if no MakerNote or the type is not supported

## exif_mnote_data_get_description()

const char* exif_mnote_data_get_description | ( | ExifMnoteData * | d,
|  | unsigned int | n
| ) |  |

Returns verbose textual description of the given MakerNote tag.

Parameters

  [in] | d | MakerNote data
  [in] | n | index of the entry within the MakerNote data

Returns
  textual description of the tag

## exif_mnote_data_get_id()

unsigned int exif_mnote_data_get_id | ( | ExifMnoteData * | d,
|  | unsigned int | n
| ) |  |

Return the MakerNote tag number for the tag at the specified index within the MakerNote.

Parameters

  [in] | d | MakerNote data
  [in] | n | index of the entry within the MakerNote data

Returns
  MakerNote tag number

## exif_mnote_data_get_name()

const char* exif_mnote_data_get_name | ( | ExifMnoteData * | d,
|  | unsigned int | n
| ) |  |

Returns textual name of the given MakerNote tag.

The name is a short, unique (within this type of MakerNote), non-localized text string containing only US-ASCII alphanumeric characters.

Parameters

  [in] | d | MakerNote data
  [in] | n | index of the entry within the MakerNote data

Returns
  textual name of the tag

## exif_mnote_data_get_title()

const char* exif_mnote_data_get_title | ( | ExifMnoteData * | d,
|  | unsigned int | n
| ) |  |

Returns textual title of the given MakerNote tag.

The title is a short, localized textual description of the tag.

Parameters

  [in] | d | MakerNote data
  [in] | n | index of the entry within the MakerNote data

Returns
  textual name of the tag

## exif_mnote_data_get_value()

char* exif_mnote_data_get_value | ( | ExifMnoteData * | d,
|  | unsigned int | n,
|  | char * | val,
|  | unsigned int | maxlen
| ) |  |

Return a textual representation of the value of the MakerNote entry.

Warning
  The character set of the returned string may be in the encoding of the current locale or the native encoding of the camera.

Parameters

  [in] | d | MakerNote data
  [in] | n | index of the entry within the MakerNote data
  [out] | val | buffer in which to store value
  [in] | maxlen | length of the buffer val

Returns
  val pointer, or NULL on error

## exif_mnote_data_load()

void exif_mnote_data_load | ( | ExifMnoteData * | d,
|  | const unsigned char * | buf,
|  | unsigned int | buf_siz
| ) |  |

Load the MakerNote data from a memory buffer.

Parameters

  [in] | d | MakerNote data
  [in] | buf | pointer to raw MakerNote tag data
  [in] | buf_siz | number of bytes of data at buf

## exif_mnote_data_save()

void exif_mnote_data_save | ( | ExifMnoteData * | d,
|  | unsigned char ** | buf,
|  | unsigned int * | buf_siz
| ) |  |

Save the raw MakerNote data into a memory buffer.

The buffer is allocated by this function and must subsequently be freed by the caller.

Parameters

  [in,out] | d | extract the data from this structure
  [out] | buf | pointer to buffer pointer containing MakerNote data on return
  [out] | buf_siz | pointer to the size of the buffer