Difference between revisions of "EXIF"
From XnView Wiki
Line 103: | Line 103: | ||
'''See also''' | '''See also''' | ||
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]] | :[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]] | ||
== gflBitmapGetEXIF2 == | |||
The gflBitmapGetEXIF2 function returns EXIF metadata in a readable form. | |||
GFL_EXIF_DATAEX* <b>gflBitmapGetEXIF2</b>( | |||
const GFL_BITMAP* bitmap | |||
); | |||
'''Parameters''' | |||
:bitmap | |||
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure. | |||
'''Return value''' | |||
:The function returns a pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
== gflFreeEXIF2 == | |||
The gflFreeEXIF2 function frees memory allocated by gflBitmapGetEXIF2 function. | |||
void <b>gflFreeEXIF2</b>( | |||
GFL_EXIF_DATAEX* exif_data | |||
); | |||
'''Parameters''' | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
== gflBitmapSetEXIF2 == | |||
The gflBitmapSetEXIF2 function sets EXIF metadata to a bitmap. | |||
void <b>gflBitmapSetEXIF2</b>( | |||
GFL_BITMAP* bitmap, | |||
const GFL_EXIF_DATAEX* exif_data | |||
); | |||
'''Parameters''' | |||
:bitmap | |||
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure. | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
== gflBitmapSetEXIFValueString2 == | |||
The gflBitmapSetEXIFValueString2 function set a string for a tag. | |||
void <b>gflBitmapSetEXIFValueString2</b>( | |||
GFL_EXIF_DATAEX* exif_data, | |||
GFL_UINT16 ifd, | |||
GFL_UINT16 tag, | |||
const char* value | |||
); | |||
'''Parameters''' | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|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 <b>gflBitmapSetEXIFValueInt2</b>( | |||
GFL_EXIF_DATAEX* exif_data, | |||
GFL_UINT16 ifd, | |||
GFL_UINT16 tag, | |||
GFL_UINT32 format, | |||
GFL_UINT32 value | |||
); | |||
'''Parameters''' | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
:ifd | |||
::IFD of the tag | |||
:tag | |||
::Tag to set | |||
:format | |||
::[[Structures#GFL_EXIFDATAEX|Format]] of the int value | |||
:value | |||
::Integer value | |||
== gflBitmapSetEXIFValueRational2 == | |||
void <b>gflBitmapSetEXIFValueRational2</b>( | |||
GFL_EXIF_DATAEX* exif_data, | |||
GFL_UINT16 ifd, | |||
GFL_UINT16 tag, | |||
GFL_UINT32 p, | |||
GFL_UINT32 q | |||
); | |||
'''Parameters''' | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
:ifd | |||
::IFD of the tag | |||
:tag | |||
::Tag to set | |||
:p | |||
::Numerator | |||
:q | |||
::Denominator | |||
== gflBitmapSetEXIFValueRationalArray2 == | |||
void <b>gflBitmapSetEXIFValueRationalArray2</b>( | |||
GFL_EXIF_DATAEX* exif_data, | |||
GFL_UINT16 ifd, | |||
GFL_UINT16 tag, | |||
const GFL_UINT32* pq, | |||
GFL_INT32 count | |||
); | |||
'''Parameters''' | |||
:exif_data | |||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | |||
:ifd | |||
::IFD of the tag | |||
:tag | |||
::Tag to set | |||
:pq | |||
::Array of numerator-denominator | |||
:count | |||
::Number of rational value |
Revision as of 16:17, 23 September 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
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
gflBitmapGetEXIFValue
The gflBitmapGetEXIFValue allow 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
gflBitmapRemoveEXIFThumbnail
The gflBitmapRemoveEXIFThumbnail function remove thumbnail from EXIF metadata.
GFL_ERROR gflBitmapRemoveEXIFThumbnail( GFL_BITMAP* bitmap );
Parameters
- bitmap
- Pointer to a GFL_BITMAP structure.
See also
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 set 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 value