5404402718dc2c55fcd011228111c715b3b55f22
[blender.git] / source / blender / blenkernel / BKE_icons.h
1 /*
2 * $Id$
3 *
4 * ***** BEGIN GPL LICENSE BLOCK *****
5 *
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License
8 * as published by the Free Software Foundation; either version 2
9 * of the License, or (at your option) any later version. 
10 *
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 * GNU General Public License for more details.
15
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software Foundation,
18 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19
20 * The Original Code is Copyright (C) 2006-2007 Blender Foundation.
21 * All rights reserved.
22
23 * The Original Code is: all of this file.
24
25 * Contributor(s): none yet.
26
27 * ***** END GPL LICENSE BLOCK *****
28 *
29 */
30
31 #ifndef BKE_ICONS_H
32 #define BKE_ICONS_H
33
34 /** \file BKE_icons.h
35  *  \ingroup bke
36  */
37
38 /*
39  Resizable Icons for Blender
40 */
41
42 typedef void (*DrawInfoFreeFP) (void *drawinfo);
43
44 struct Icon
45 {
46         void *drawinfo;
47         void *obj;
48         short type;
49         DrawInfoFreeFP drawinfo_free;
50 };
51
52 typedef struct Icon Icon;
53
54 struct PreviewImage;
55
56 void BKE_icons_init(int first_dyn_id);
57
58 /* return icon id for library object or create new icon if not found */
59 int     BKE_icon_getid(struct ID* id);
60
61 /* retrieve icon for id */
62 struct Icon* BKE_icon_get(int icon_id);
63
64 /* set icon for id if not already defined */
65 /* used for inserting the internal icons */
66 void BKE_icon_set(int icon_id, struct Icon* icon);
67
68 /* remove icon and free date if library object becomes invalid */
69 void BKE_icon_delete(struct ID* id);
70
71 /* report changes - icon needs to be recalculated */
72 void BKE_icon_changed(int icon_id);
73
74 /* free all icons */
75 void BKE_icons_free(void);
76
77 /* free the preview image */
78 void BKE_previewimg_free(struct PreviewImage **prv);
79
80 /* free the preview image belonging to the id */
81 void BKE_previewimg_free_id(ID *id);
82
83 /* create a new preview image */
84 struct PreviewImage* BKE_previewimg_create(void) ;
85
86 /* create a copy of the preview image */
87 struct PreviewImage* BKE_previewimg_copy(struct PreviewImage *prv);
88
89 /* retrieve existing or create new preview image */
90 PreviewImage* BKE_previewimg_get(ID *id);
91
92 #endif /*  BKE_ICONS_H */