Difference between revisions of "EXIF"
From XnView Wiki
Line 169: | Line 169: | ||
::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 | ||
:value | :value | ||
::Pointer to a null-terminated string that contains the value. | ::Pointer to a null-terminated string that contains the value. | ||
== gflBitmapSetEXIFValueInt2 == | == gflBitmapSetEXIFValueInt2 == |
Revision as of 16:29, 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