Move allocation of imbuf from array to allocimbuf.
[blender.git] / source / blender / imbuf / intern / IMB_metadata.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version. 
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2005 Blender Foundation
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): Austin Benesh. Ton Roosendaal.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file blender/imbuf/intern/IMB_metadata.h
29  *  \ingroup imbuf
30  */
31
32
33 #ifndef __IMB_METADATA_H__
34 #define __IMB_METADATA_H__
35
36 struct ImBuf;
37
38 /** The metadata is a list of key/value pairs (both char *) that can me
39  * saved in the header of several image formats.
40  * Apart from some common keys like
41  * 'Software' and 'Description' (png standard) we'll use keys within the
42  * Blender namespace, so should be called 'Blender::StampInfo' or 'Blender::FrameNum'
43  * etc...
44  */
45
46
47 /* free blender ImMetaData struct */
48 void IMB_metadata_free(struct ImBuf *img);
49
50 /** read the field from the image info into the field 
51  *  \param img - the ImBuf that contains the image data
52  *  \param key - the key of the field
53  *  \param value - the data in the field, first one found with key is returned, 
54  *                 memory has to be allocated by user.
55  *  \param len - length of value buffer allocated by user.
56  *  \return    - 1 (true) if ImageInfo present and value for the key found, 0 (false) otherwise
57  */
58 bool IMB_metadata_get_field(struct ImBuf *img, const char *key, char *value, const size_t len);
59
60 /** set user data in the ImMetaData struct, which has to be allocated with IMB_metadata_create
61  *  before calling this function.
62  *  \param img - the ImBuf that contains the image data
63  *  \param key - the key of the field
64  *  \param value - the data to be written to the field. zero terminated string
65  *  \return    - 1 (true) if ImageInfo present, 0 (false) otherwise
66  */
67 bool IMB_metadata_add_field(struct ImBuf *img, const char *key, const char *value);
68
69 /** delete the key/field par in the ImMetaData struct.
70  * \param img - the ImBuf that contains the image data
71  * \param key - the key of the field
72  * \return - 1 (true) if delete the key/field, 0 (false) otherwise
73  */
74 bool IMB_metadata_del_field(struct ImBuf *img, const char *key);
75
76 #endif /* __IMB_METADATA_H__ */