Actions

Difference between revisions of "EXIF"

From XnView Wiki

m
Line 77: Line 77:
::EXIF tag
::EXIF tag
:value
:value
::Pointer to a char array (string)
::Pointer to the first element of a char array (C string)
:value_length
:value_length
::Maximum length of the string
::Maximum length of the string
Line 238: Line 238:
::Tag to set
::Tag to set
:pq
:pq
::Array of numerator-denominator
::Pointer to the first element of an array of numerator-denominator
:count
:count
::Number of rational values
::Number of rational values


[[Category: GFLSDK Reference Manual]]
[[Category: GFLSDK Reference Manual]]

Revision as of 18:40, 1 August 2010

gflBitmapHasEXIF

The gflBitmapHasEXIF function is used to know if the picture has EXIF metadata.

GFL_BOOL gflBitmapHasEXIF(
  const GFL_BITMAP* bitmap
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.

Return value

The function returns GFL_TRUE if the bitmap has EXIF metadata.

See also

gflBitmapHasIPTC, gflBitmapHasICCProfile, gflBitmapGetEXIF, gflFreeEXIF, gflBitmapRemoveEXIFThumbnail, gflBitmapRemoveMetaData

gflBitmapGetEXIF

The gflBitmapGetEXIF function returns EXIF metadata in a readable form.

GFL_EXIF_DATA* gflBitmapGetEXIF(
  const GFL_BITMAP* bitmap,  
  GFL_UINT32  flags
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.
flags
GFL_EXIF_WANT_MAKERNOTES 0x0001

Return value

The function returns a pointer to a GFL_EXIF_DATA structure.

See also

gflBitmapHasEXIF, gflFreeEXIF

gflFreeEXIF

The gflFreeEXIF function frees memory allocated by gflBitmapGetEXIF function.

void gflFreeEXIF(
  GFL_EXIF_DATA* exif_data
);

Parameters

exif_data
Pointer to a GFL_EXIF_DATA structure.

See also

gflBitmapHasEXIF, gflBitmapGetEXIF


gflBitmapGetEXIFValue

The gflBitmapGetEXIFValue allows to get a tag from EXIF metadata.

GFL_ERROR gflBitmapGetEXIFValue(
  const GFL_BITMAP* bitmap, 
  GFL_UINT32 tag, 
  char* value, 
  GFL_INT32 value_length
); 

Parameters

bitmap
Pointer to a GFL_BITMAP structure
tag
EXIF tag
value
Pointer to the first element of a char array (C string)
value_length
Maximum length of the string

Return value

The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.

See also

gflBitmapHasEXIF

gflBitmapRemoveEXIFThumbnail

The gflBitmapRemoveEXIFThumbnail function removes thumbnail from EXIF metadata.

void gflBitmapRemoveEXIFThumbnail(
  GFL_BITMAP* bitmap
);

Parameters

bitmap
Pointer to a GFL_BITMAP structure.

See also

gflBitmapHasEXIF, gflBitmapRemoveMetaData

gflBitmapGetEXIF2

The gflBitmapGetEXIF2 function returns EXIF metadata in a readable form.

GFL_EXIF_DATAEX* gflBitmapGetEXIF2( 
  const GFL_BITMAP* bitmap 
); 

Parameters

bitmap
Pointer to a GFL_BITMAP structure.

Return value

The function returns a pointer to a GFL_EXIF_DATAEX structure.


gflFreeEXIF2

The gflFreeEXIF2 function frees memory allocated by gflBitmapGetEXIF2 function.

void gflFreeEXIF2( 
  GFL_EXIF_DATAEX* exif_data 
); 

Parameters

exif_data
Pointer to a GFL_EXIF_DATAEX structure.


gflBitmapSetEXIF2

The gflBitmapSetEXIF2 function sets EXIF metadata to a bitmap.

void gflBitmapSetEXIF2( 
  GFL_BITMAP* bitmap, 
  const GFL_EXIF_DATAEX* exif_data 
); 

Parameters

bitmap
Pointer to a GFL_BITMAP structure.
exif_data
Pointer to a GFL_EXIF_DATAEX structure.


gflBitmapSetEXIFValueString2

The gflBitmapSetEXIFValueString2 function sets a string for a tag.

void gflBitmapSetEXIFValueString2( 
  GFL_EXIF_DATAEX* exif_data, 
  GFL_UINT16 ifd, 
  GFL_UINT16 tag, 
  const char* value 
); 

Parameters

exif_data
Pointer to a GFL_EXIF_DATAEX structure.
ifd
IFD of the tag
tag
Tag to set
value
Pointer to a null-terminated string that contains the value.

gflBitmapSetEXIFValueInt2

void gflBitmapSetEXIFValueInt2( 
  GFL_EXIF_DATAEX* exif_data, 
  GFL_UINT16 ifd, 
  GFL_UINT16 tag, 
  GFL_UINT32 format, 
  GFL_UINT32 value 
); 

Parameters

exif_data
Pointer to a GFL_EXIF_DATAEX structure.
ifd
IFD of the tag
tag
Tag to set
format
Format of the int value
value
Integer value

gflBitmapSetEXIFValueRational2

void gflBitmapSetEXIFValueRational2( 
  GFL_EXIF_DATAEX* exif_data, 
  GFL_UINT16 ifd, 
  GFL_UINT16 tag, 
  GFL_UINT32 p, 
  GFL_UINT32 q 
); 

Parameters

exif_data
Pointer to a GFL_EXIF_DATAEX structure.
ifd
IFD of the tag
tag
Tag to set
p
Numerator
q
Denominator

gflBitmapSetEXIFValueRationalArray2

void gflBitmapSetEXIFValueRationalArray2( 
  GFL_EXIF_DATAEX* exif_data, 
  GFL_UINT16 ifd, 
  GFL_UINT16 tag, 
  const GFL_UINT32* pq, 
  GFL_INT32 count 
); 

Parameters

exif_data
Pointer to a GFL_EXIF_DATAEX structure.
ifd
IFD of the tag
tag
Tag to set
pq
Pointer to the first element of an array of numerator-denominator
count
Number of rational values