2.50: svn merge https://svn.blender.org/svnroot/bf-blender/trunk/blender -r17853...
[blender.git] / source / blender / makesrna / intern / rna_internal_types.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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19  *
20  * Contributor(s): Blender Foundation (2008).
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #ifndef RNA_INTERNAL_TYPES
26 #define RNA_INTERNAL_TYPES
27
28 #include "DNA_listBase.h"
29
30 struct BlenderRNA;
31 struct StructRNA;
32 struct PropertyRNA;
33 struct PointerRNA;
34 struct CollectionPropertyIterator;
35 struct bContext;
36
37 /* Function Callbacks */
38
39 typedef void (*UpdateFunc)(struct bContext *C, struct PointerRNA *ptr);
40 typedef int (*EditableFunc)(struct PointerRNA *ptr);
41 typedef struct StructRNA *(*StructRefineFunc)(struct PointerRNA *ptr);
42
43 typedef int (*PropBooleanGetFunc)(struct PointerRNA *ptr);
44 typedef void (*PropBooleanSetFunc)(struct PointerRNA *ptr, int value);
45 typedef int (*PropBooleanArrayGetFunc)(struct PointerRNA *ptr, int index);
46 typedef void (*PropBooleanArraySetFunc)(struct PointerRNA *ptr, int index, int value);
47 typedef int (*PropIntGetFunc)(struct PointerRNA *ptr);
48 typedef void (*PropIntSetFunc)(struct PointerRNA *ptr, int value);
49 typedef int (*PropIntArrayGetFunc)(struct PointerRNA *ptr, int index);
50 typedef void (*PropIntArraySetFunc)(struct PointerRNA *ptr, int index, int value);
51 typedef void (*PropIntRangeFunc)(struct PointerRNA *ptr, int *min, int *max);
52 typedef float (*PropFloatGetFunc)(struct PointerRNA *ptr);
53 typedef void (*PropFloatSetFunc)(struct PointerRNA *ptr, float value);
54 typedef float (*PropFloatArrayGetFunc)(struct PointerRNA *ptr, int index);
55 typedef void (*PropFloatArraySetFunc)(struct PointerRNA *ptr, int index, float value);
56 typedef void (*PropFloatRangeFunc)(struct PointerRNA *ptr, float *min, float *max);
57 typedef void (*PropStringGetFunc)(struct PointerRNA *ptr, char *value);
58 typedef int (*PropStringLengthFunc)(struct PointerRNA *ptr);
59 typedef void (*PropStringSetFunc)(struct PointerRNA *ptr, const char *value);
60 typedef int (*PropEnumGetFunc)(struct PointerRNA *ptr);
61 typedef void (*PropEnumSetFunc)(struct PointerRNA *ptr, int value);
62 typedef void* (*PropPointerGetFunc)(struct PointerRNA *ptr);
63 typedef void (*PropPointerSetFunc)(struct PointerRNA *ptr, void *value);
64 typedef struct StructRNA* (*PropPointerTypeFunc)(struct PointerRNA *ptr);
65 typedef void (*PropCollectionBeginFunc)(struct CollectionPropertyIterator *iter, struct PointerRNA *ptr);
66 typedef void (*PropCollectionNextFunc)(struct CollectionPropertyIterator *iter);
67 typedef void (*PropCollectionEndFunc)(struct CollectionPropertyIterator *iter);
68 typedef void* (*PropCollectionGetFunc)(struct CollectionPropertyIterator *iter);
69 typedef struct StructRNA* (*PropCollectionTypeFunc)(struct CollectionPropertyIterator *iter);
70 typedef int (*PropCollectionLengthFunc)(struct PointerRNA *ptr);
71 typedef void* (*PropCollectionLookupIntFunc)(struct PointerRNA *ptr, int key, struct StructRNA **type);
72 typedef void* (*PropCollectionLookupStringFunc)(struct PointerRNA *ptr, const char *key, struct StructRNA **type);
73
74 struct PropertyRNA {
75         struct PropertyRNA *next, *prev;
76
77         /* magic bytes to distinguish with IDProperty */
78         int magic;
79
80         /* unique identifier */
81         const char *identifier;
82         /* various options */
83         int flag;
84
85         /* user readable name */
86         const char *name;
87         /* single line description, displayed in the tooltip for example */
88         const char *description;
89
90         /* property type as it appears to the outside */
91         PropertyType type;
92         /* subtype, 'interpretation' of the property */
93         PropertySubType subtype;
94         /* if an array this is > 0, specifying the length */
95         unsigned int arraylength;
96         
97         /* callback for updates on change */
98         UpdateFunc update;
99         int noteflag;
100
101         /* callback for testing if editable/evaluated */
102         EditableFunc editable;
103 };
104
105 /* Property Types */
106
107 typedef struct BooleanPropertyRNA {
108         PropertyRNA property;
109
110         PropBooleanGetFunc get;
111         PropBooleanSetFunc set;
112
113         PropBooleanArrayGetFunc getarray;
114         PropBooleanArraySetFunc setarray;
115
116         int defaultvalue;
117         const int *defaultarray;
118 } BooleanPropertyRNA;
119
120 typedef struct IntPropertyRNA {
121         PropertyRNA property;
122
123         PropIntGetFunc get;
124         PropIntSetFunc set;
125
126         PropIntArrayGetFunc getarray;
127         PropIntArraySetFunc setarray;
128
129         PropIntRangeFunc range;
130
131         int softmin, softmax;
132         int hardmin, hardmax;
133         int step;
134
135         int defaultvalue;
136         const int *defaultarray;
137 } IntPropertyRNA;
138
139 typedef struct FloatPropertyRNA {
140         PropertyRNA property;
141
142         PropFloatGetFunc get;
143         PropFloatSetFunc set;
144
145         PropFloatArrayGetFunc getarray;
146         PropFloatArraySetFunc setarray;
147
148         PropFloatRangeFunc range;
149
150         float softmin, softmax;
151         float hardmin, hardmax;
152         float step;
153         int precision;
154
155         float defaultvalue;
156         const float *defaultarray;
157 } FloatPropertyRNA;
158
159 typedef struct StringPropertyRNA {
160         PropertyRNA property;
161
162         PropStringGetFunc get;
163         PropStringLengthFunc length;
164         PropStringSetFunc set;
165
166         int maxlength;  /* includes string terminator! */
167
168         const char *defaultvalue;
169 } StringPropertyRNA;
170
171 typedef struct EnumPropertyRNA {
172         PropertyRNA property;
173
174         PropEnumGetFunc get;
175         PropEnumSetFunc set;
176
177         const EnumPropertyItem *item;
178         int totitem;
179
180         int defaultvalue;
181 } EnumPropertyRNA;
182
183 typedef struct PointerPropertyRNA {
184         PropertyRNA property;
185
186         PropPointerGetFunc get;
187         PropPointerSetFunc set;
188         PropPointerTypeFunc type;       /* optional */
189
190         struct StructRNA *structtype;
191 } PointerPropertyRNA;
192
193 typedef struct CollectionPropertyRNA {
194         PropertyRNA property;
195
196         PropCollectionBeginFunc begin;
197         PropCollectionNextFunc next;
198         PropCollectionEndFunc end;                                              /* optional */
199         PropCollectionGetFunc get;
200         PropCollectionTypeFunc type;                                    /* optional */
201         PropCollectionLengthFunc length;                                /* optional */
202         PropCollectionLookupIntFunc lookupint;                  /* optional */
203         PropCollectionLookupStringFunc lookupstring;    /* optional */
204
205         struct StructRNA *structtype;
206 } CollectionPropertyRNA;
207
208
209 /* changes to this struct require updating rna_generate_struct in makesrna.c */
210 struct StructRNA {
211         struct StructRNA *next, *prev;
212
213         /* unique identifier */
214         const char *identifier;
215         /* various options */
216         int flag;
217
218         /* user readable name */
219         const char *name;
220         /* single line description, displayed in the tooltip for example */
221         const char *description;
222         
223         /* property that defines the name */
224         PropertyRNA *nameproperty;
225
226         /* property to iterate over properties */
227         PropertyRNA *iteratorproperty;
228
229         /* struct this is derivedfrom */
230         struct StructRNA *base;
231
232         /* only use for nested structs, where both the parent and child access
233          * the same C Struct but nesting is used for grouping properties.
234          * The parent property is used so we know NULL checks are not needed,
235          * and that this struct will never exist without its parent */
236         struct StructRNA *nested;
237
238         /* function to give the more specific type */
239         StructRefineFunc refine; 
240
241         /* properties of this struct */
242         ListBase properties; 
243 };
244
245 /* Blender RNA
246  *
247  * Root RNA data structure that lists all struct types. */
248
249 struct BlenderRNA {
250         ListBase structs;
251 };
252
253 #endif /* RNA_INTERNAL_TYPES */
254