Actions

Difference between revisions of "EXIF"

From XnView Wiki
m (Reverted edits by Akajavim (Talk) to last revision by Newacct)
 
(11 intermediate revisions by 4 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 89: Line 89:
== gflBitmapRemoveEXIFThumbnail ==
== gflBitmapRemoveEXIFThumbnail ==


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


  GFL_ERROR <b>gflBitmapRemoveEXIFThumbnail</b>(
  void <b>gflBitmapRemoveEXIFThumbnail</b>(
   GFL_BITMAP* bitmap
   GFL_BITMAP* bitmap
  );
  );
Line 102: Line 102:
'''See also'''
'''See also'''
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]]
:[[#gflBitmapHasEXIF|gflBitmapHasEXIF]], [[#gflBitmapRemoveMetaData|gflBitmapRemoveMetaData]]


== gflBitmapGetEXIF2 ==
== gflBitmapGetEXIF2 ==
Line 154: Line 153:
== gflBitmapSetEXIFValueString2 ==
== gflBitmapSetEXIFValueString2 ==


The gflBitmapSetEXIFValueString2 function set a string for a tag.  
The gflBitmapSetEXIFValueString2 function sets a string for a tag.  


  void <b>gflBitmapSetEXIFValueString2</b>(  
  void <b>gflBitmapSetEXIFValueString2</b>(  
Line 189: Line 188:
::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
:format
:format
::[[Structures#GFL_EXIFDATAEX|Format]] of the int value
::[[Structures#GFL_EXIF_DATAEX|Format]] of the int value
:value  
:value  
::Integer value
::Integer value


== gflBitmapSetEXIFValueRational2 ==
== gflBitmapSetEXIFValueRational2 ==
Line 213: 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 220: Line 218:
:q
:q
::Denominator
::Denominator


== gflBitmapSetEXIFValueRationalArray2 ==
== gflBitmapSetEXIFValueRationalArray2 ==
Line 237: 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
::Array of numerator-denominator
::Pointer to the first element of an array of numerator-denominator
:count
:count
::Number of rational value
::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"