Difference between revisions of "EXIF"
From XnView Wiki
| (6 intermediate revisions by 3 users not shown) | |||
| 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 211: | Line 211: | ||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | ::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | ||
:ifd | :ifd | ||
::IFD of the tag | ::[[Structures#GFL_EXIF_DATA|IFD]] of the tag | ||
:tag | :tag | ||
::Tag to set | ::Tag to set | ||
| Line 218: | Line 218: | ||
:q | :q | ||
::Denominator | ::Denominator | ||
== gflBitmapSetEXIFValueRationalArray2 == | == gflBitmapSetEXIFValueRationalArray2 == | ||
| Line 235: | Line 234: | ||
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | ::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure. | ||
:ifd | :ifd | ||
::IFD of the tag | ::[[Structures#GFL_EXIF_DATA|IFD]] of the tag | ||
:tag | :tag | ||
::Tag to set | ::Tag to set | ||
:pq | :pq | ||
:: | ::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]] | |||
Latest revision as of 15:23, 22 November 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
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 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
gflBitmapRemoveEXIFThumbnail
The gflBitmapRemoveEXIFThumbnail function removes thumbnail from EXIF metadata.
void 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 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