Difference between revisions of "IPTC"
From XnView Wiki
| Line 25: | Line 25: | ||
GFL_IPTC_DATA* <b>gflBitmapGetIPTC</b>( | GFL_IPTC_DATA* <b>gflBitmapGetIPTC</b>( | ||
GFL_BITMAP* bitmap | const GFL_BITMAP* bitmap | ||
); | ); | ||
| Line 38: | Line 38: | ||
'''See also''' | '''See also''' | ||
:[[#gflBitmapHasIPTC|gflBitmapHasIPTC]], [[#gflBitmapSetIPTC|gflBitmapSetIPTC]], [[#gflFreeIPTC|gflFreeIPTC]], [[#gflSetIPTCValue|gflSetIPTCValue]], [[#gflRemoveIPTCValue|gflRemoveIPTCValue]] | :[[#gflBitmapHasIPTC|gflBitmapHasIPTC]], [[#gflBitmapSetIPTC|gflBitmapSetIPTC]], [[#gflFreeIPTC|gflFreeIPTC]], [[#gflSetIPTCValue|gflSetIPTCValue]], [[#gflRemoveIPTCValue|gflRemoveIPTCValue]] | ||
== gflNewIPTC == | == gflNewIPTC == | ||
Revision as of 14:42, 23 September 2009
gflBitmapHasIPTC
The gflBitmapHasIPTC function is used to know if the picture has IPTC metadata.
GFL_BOOL gflBitmapHasIPTC( const GFL_BITMAP* bitmap );
Parameters
- bitmap
- Pointer to a GFL_BITMAP structure.
- comment
- Pointer to a null-terminated string that contains the comment.
Return value
- The function returns GFL_TRUE if the bitmap has IPTC metadata.
See also
gflBitmapGetIPTC
The gflBitmapGetIPTC function returns IPTC metadata in a readable form.
GFL_IPTC_DATA* gflBitmapGetIPTC( const GFL_BITMAP* bitmap );
Parameters
- bitmap
- Pointer to a GFL_BITMAP structure.
Return value
- The function returns a pointer to a GFL_IPTC_DATA structure.
See also
gflNewIPTC
The gflNewIPTC function returns IPTC metadata in a readable form.
GFL_IPTC_DATA* gflNewIPTC( void );
Return value
- The function returns a pointer to a GFL_IPTC_DATA structure.
See also
gflFreeIPTC
The gflFreeIPTC function frees memory allocated by gflBitmapGetIPTC function.
void gflFreeIPTC( GFL_IPTC_DATA* iptc_data );
Parameters
- iptc_data
- Pointer to a GFL_IPTC_DATA structure.
See also
gflSetIPTCValue
The gflSetIPTCValue function set an IPTC value.
GFL_ERROR gflSetIPTCValue( GFL_IPTC_DATA* iptc_data, GFL_UINT32 id, const char* value );
Parameters
- iptc_data
- Pointer to a GFL_IPTC_DATA structure.
- id
- IPTC id to change.
- value
- Pointer to a null-terminated string that contains the new value.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also
gflRemoveIPTCValue
The gflRemoveIPTCValue function remove an IPTC value.
GFL_IPTC_DATA* gflRemoveIPTCValue( GFL_IPTC_DATA* iptc_data, GFL_UINT32 id );
Parameters
- iptc_data
- Pointer to a GFL_IPTC_DATA structure.
- id
- IPTC id to remove.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also
gflLoadIPTC
The gflLoadIPTC allows to load IPTC data from a picture file, without loading it.
GFL_IPTC_DATA* gflLoadIPTC( const char* filename, );
Parameters
- filename
- Pointer to a null-terminated string that contains the filename to extract IPTC. Must be a JPEG file.
Return value
- The function returns a pointer to a GFL_IPTC_DATA structure.
See also
gflSaveIPTC
The gflSaveIPTC allows to save IPTC data into a picture file, without loading it.
GFL_ERROR gflSaveIPTC( const char* filename, const GFL_IPTC_DATA* iptc_data, );
Parameters
- filename
- Pointer to a null-terminated string that contains the filename to save. Must be a JPEG file.
- iptc_data
- Pointer to a GFL_IPTC_DATA structure.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also
gflBitmapSetIPTC
The gflBitmapSetIPTC function sets IPTC metadata to a bitmap.
GFL_ERROR gflBitmapSetIPTC( GFL_BITMAP* bitmap, const GFL_IPTC_DATA* iptc_data );
Parameters
- bitmap
- Pointer to a GFL_BITMAP structure.
- iptc_data
- Pointer to a GFL_IPTC_DATA structure.
Return value
- The function returns GFL_NO_ERROR if it is successful or a value of GFL_ERROR.
See also