Actions

Difference between revisions of "EXIF"

From XnView Wiki

(Created page with 'gflBitmapHasEXIF The gflBitmapHasEXIF function is used to know if the picture has EXIF metadata. GFL_BOOL gflBitmapHasEXIF( GFL_BITMAP * bitmap ); Parameters bitmap Poi…')
 
m (Reverted edits by Akajavim (Talk) to last revision by Newacct)
 
(23 intermediate revisions by 4 users not shown)
Line 1: Line 1:
gflBitmapHasEXIF
== gflBitmapHasEXIF ==


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 <b>gflBitmapHasEXIF</b>(
  const GFL_BITMAP* bitmap
);


GFL_BOOL gflBitmapHasEXIF(
'''Parameters'''
  GFL_BITMAP * bitmap
);


Parameters
:bitmap
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.


bitmap  
'''Return value'''
Pointer to a GFL_BITMAP structure.  
:The function returns GFL_TRUE if the bitmap has EXIF metadata.  


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


The function returns GFL_TRUE if the bitmap has EXIF metadata.
== gflBitmapGetEXIF ==


The gflBitmapGetEXIF function returns EXIF metadata in a readable form.
GFL_EXIF_DATA* <b>gflBitmapGetEXIF</b>(
  const GFL_BITMAP* bitmap, 
  GFL_UINT32  flags
);
'''Parameters'''
:bitmap
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.
:flags
::{|
|GFL_EXIF_WANT_MAKERNOTES||0x0001
|}
'''Return value'''
:The function returns a pointer to a [[Structures#GFL_EXIF_DATA|GFL_EXIF_DATA]] structure.
'''See also'''
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflFreeEXIF|gflFreeEXIF]]
== gflFreeEXIF ==
The gflFreeEXIF function frees memory allocated by gflBitmapGetEXIF function.
void <b>gflFreeEXIF</b>(
  GFL_EXIF_DATA* exif_data
);
'''Parameters'''
:exif_data
::Pointer to a [[Structures#GFL_EXIF_DATA|GFL_EXIF_DATA]] structure.
'''See also'''
:[[#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'''


See also
: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


gflBitmapSetComment, gflBitmapRemoveMetaData, gflBitmapRemoveEXIFThumbnail, gflBitmapGetEXIF, gflFreeEXIF, gflBitmapHasIPTC, gflBitmapGetIPTC, gflBitmapSetIPTC, gflFreeIPTC, gflNewIPTC, gflSetIPTCValue, gflRemoveIPTCValue, gflLoadIPTC, gflSaveIPTC
'''Return value'''
:The function returns GFL_NO_ERROR if it is successful or a value of [[Error|GFL_ERROR]].


'''See also'''
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]]


gflBitmapGetEXIF
== gflBitmapRemoveEXIFThumbnail ==


The gflBitmapGetEXIF function returns EXIF metadata in a readable form.  
The gflBitmapRemoveEXIFThumbnail function removes thumbnail from EXIF metadata.
 
void <b>gflBitmapRemoveEXIFThumbnail</b>(
  GFL_BITMAP* bitmap
);
 
'''Parameters'''
 
:bitmap
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.
 
'''See also'''
:[[#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'''


GFL_EXIF_DATA * gflBitmapGetEXIF(
:exif_data
  GFL_BITMAP * bitmap, 
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure.
  GFL_UINT32  flags
);


Parameters


bitmap
== gflBitmapSetEXIF2 ==
Pointer to a GFL_BITMAP structure.
flags
Not used.


Return value
The gflBitmapSetEXIF2 function sets EXIF metadata to a bitmap.


The function returns a pointer to a GFL_EXIF_DATA structure.
void <b>gflBitmapSetEXIF2</b>(
  GFL_BITMAP* bitmap,
  const GFL_EXIF_DATAEX* exif_data
);


'''Parameters'''


See also
:bitmap
::Pointer to a [[Structures#GFL_BITMAP|GFL_BITMAP]] structure.
:exif_data
::Pointer to a [[Structures#GFL_EXIF_DATAEX|GFL_EXIF_DATAEX]] structure.


gflBitmapSetComment, gflBitmapRemoveMetaData, gflBitmapHasEXIF, gflBitmapRemoveEXIFThumbnail, gflFreeEXIF, gflBitmapHasIPTC, gflBitmapGetIPTC, gflBitmapSetIPTC, gflFreeIPTC, gflNewIPTC, gflSetIPTCValue, gflRemoveIPTCValue, gflLoadIPTC, gflSaveIPTC


== gflBitmapSetEXIFValueString2 ==


gflFreeEXIF
The gflBitmapSetEXIFValueString2 function sets a string for a tag.


The gflFreeEXIF function frees memory allocated by gflBitmapGetEXIF function.
void <b>gflBitmapSetEXIFValueString2</b>(
  GFL_EXIF_DATAEX* exif_data,
  GFL_UINT16 ifd,
  GFL_UINT16 tag,
  const char* value
);


'''Parameters'''


void gflFreeEXIF(
:exif_data
  GFL_EXIF_DATA * 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.


Parameters
== gflBitmapSetEXIFValueInt2 ==


exif_data  
void <b>gflBitmapSetEXIFValueInt2</b>(
Pointer to a GFL_EXIF_DATA structure.
  GFL_EXIF_DATAEX* exif_data,
  GFL_UINT16 ifd,
  GFL_UINT16 tag,
  GFL_UINT32 format,
  GFL_UINT32 value
);


See also
'''Parameters'''


gflBitmapSetComment, gflBitmapRemoveMetaData, gflBitmapHasEXIF, gflBitmapRemoveEXIFThumbnail, gflBitmapGetEXIF, gflBitmapHasIPTC, gflBitmapGetIPTC, gflBitmapSetIPTC, gflFreeIPTC, gflNewIPTC, gflSetIPTCValue, gflRemoveIPTCValue, gflLoadIPTC, gflSaveIPTC
: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 ==


gflBitmapRemoveEXIFThumbnail
void <b>gflBitmapSetEXIFValueRational2</b>(
  GFL_EXIF_DATAEX* exif_data,
  GFL_UINT16 ifd,
  GFL_UINT16 tag,
  GFL_UINT32 p,
  GFL_UINT32 q
);


The gflBitmapRemoveEXIFThumbnail function remove thumbnail from EXIF metadata.
'''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


GFL_ERROR gflBitmapRemoveEXIFThumbnail(
== gflBitmapSetEXIFValueRationalArray2 ==
  GFL_BITMAP * bitmap
);


Parameters
void <b>gflBitmapSetEXIFValueRationalArray2</b>(
  GFL_EXIF_DATAEX* exif_data,
  GFL_UINT16 ifd,
  GFL_UINT16 tag,
  const GFL_UINT32* pq,
  GFL_INT32 count
);


bitmap
'''Parameters'''
Pointer to a GFL_BITMAP structure.


See also
: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


gflBitmapSetComment, gflBitmapRemoveMetaData, gflBitmapHasEXIF, gflBitmapGetEXIF, gflFreeEXIF, gflBitmapHasIPTC, gflBitmapGetIPTC, gflFreeIPTC
[[Category: GFLSDK Reference Manual]]

Latest revision as of 16: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"