Actions

Difference between revisions of "EXIF"

From XnView Wiki

Line 192: Line 192:
::Tag to set
::Tag to set
:format
:format
::[[Structures#GFL_EXIFDATAEX|Format]] of the int value
::[[Structures#GFL_EXIF_DATAEX|Format]] of the int value
:value  
:value  
::Integer value
::Integer value


== gflBitmapSetEXIFValueRational2 ==
== gflBitmapSetEXIFValueRational2 ==

Revision as of 10:16, 2 October 2009

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 a char array (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
Array of numerator-denominator
count
Number of rational values