Actions

Difference between revisions of "EXIF"

From XnView Wiki
m (Reverted edits by Akajavim (Talk) to last revision by Newacct)
 
(22 intermediate revisions by 4 users not shown)
Line 3: Line 3:
The gflBitmapHasEXIF function is used to know if the picture has EXIF metadata.  
The gflBitmapHasEXIF function is used to know if the picture has EXIF metadata.  


  GFL_BOOL gflBitmapHasEXIF(
  GFL_BOOL <b>gflBitmapHasEXIF</b>(
&nbsp;GFL_BITMAP* bitmap
  const GFL_BITMAP* bitmap
  );
  );


Line 16: Line 16:


'''See also'''
'''See also'''
:[[IPTC#gflBitmapHasIPTC|gflBitmapHasIPTC]], [[#gflBitmapGetEXIF|gflBitmapGetEXIF]], [[#gflFreeEXIF|gflFreeEXIF]], [[#gflBitmapRemoveEXIFThumbnail|gflBitmapRemoveEXIFThumbnail]], [[#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]]
:[[IPTC#gflBitmapHasIPTC|gflBitmapHasIPTC]], [[ICC#gflBitmapHasICCProfile|gflBitmapHasICCProfile]], [[#gflBitmapGetEXIF|gflBitmapGetEXIF]], [[#gflFreeEXIF|gflFreeEXIF]], [[#gflBitmapRemoveEXIFThumbnail|gflBitmapRemoveEXIFThumbnail]], [[Misc#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]]
 


== gflBitmapGetEXIF ==
== gflBitmapGetEXIF ==
Line 23: Line 22:
The gflBitmapGetEXIF function returns EXIF metadata in a readable form.  
The gflBitmapGetEXIF function returns EXIF metadata in a readable form.  


  GFL_EXIF_DATA* gflBitmapGetEXIF(
  GFL_EXIF_DATA* <b>gflBitmapGetEXIF</b>(
&nbsp;GFL_BITMAP* bitmap,   
  const GFL_BITMAP* bitmap,   
&nbsp;GFL_UINT32  flags
  GFL_UINT32  flags
  );
  );


Line 33: Line 32:
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.  
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.  
:flags  
:flags  
::Not used.
::{|
|GFL_EXIF_WANT_MAKERNOTES||0x0001
|}


'''Return value'''
'''Return value'''
Line 40: Line 41:
'''See also'''
'''See also'''
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflFreeEXIF|gflFreeEXIF]]
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflFreeEXIF|gflFreeEXIF]]


== gflFreeEXIF ==
== gflFreeEXIF ==
Line 46: Line 46:
The gflFreeEXIF function frees memory allocated by gflBitmapGetEXIF function.  
The gflFreeEXIF function frees memory allocated by gflBitmapGetEXIF function.  


  void gflFreeEXIF(
  void <b>gflFreeEXIF</b>(
&nbsp;GFL_EXIF_DATA* exif_data
  GFL_EXIF_DATA* exif_data
  );
  );


Line 58: Line 58:
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapGetEXIF|gflBitmapGetEXIF]]
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapGetEXIF|gflBitmapGetEXIF]]


== gflBitmapGetEXIFValue ==
The gflBitmapGetEXIFValue allows to get a tag from EXIF metadata.
GFL_ERROR <b>gflBitmapGetEXIFValue</b>(
  const GFL_BITMAP* bitmap,
  GFL_UINT32 tag,
  char* value,
  GFL_INT32 value_length
);
'''Parameters'''
:bitmap
::Pointer to a [[Structures#GFL_BITMAP|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 [[Error|GFL_ERROR]].
'''See also'''
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]]


== gflBitmapRemoveEXIFThumbnail ==
== gflBitmapRemoveEXIFThumbnail ==


The gflBitmapRemoveEXIFThumbnail function remove thumbnail from EXIF metadata.  
The gflBitmapRemoveEXIFThumbnail function removes thumbnail from EXIF metadata.  


  GFL_ERROR gflBitmapRemoveEXIFThumbnail(
  void <b>gflBitmapRemoveEXIFThumbnail</b>(
&nbsp;GFL_BITMAP* bitmap
  GFL_BITMAP* bitmap
  );
  );


Line 74: Line 102:
'''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 sets 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
::[[Structures#GFL_EXIF_DATA|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
::[[Structures#GFL_EXIF_DATA|IFD]] of the tag
:tag
::Tag to set
:format
::[[Structures#GFL_EXIF_DATAEX|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
::[[Structures#GFL_EXIF_DATA|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
::[[Structures#GFL_EXIF_DATA|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
[[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

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
Retrieved from "https://www.xnview.com/wiki/index.php?title=EXIF&oldid=553"