Merged changes in the trunk up to revision 44039.
[blender-staging.git] / source / blender / makesrna / intern / rna_ID.c
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  * Contributor(s): Blender Foundation (2008).
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/makesrna/intern/rna_ID.c
24  *  \ingroup RNA
25  */
26
27
28 #include <stdlib.h>
29 #include <stdio.h>
30
31 #include "RNA_access.h"
32 #include "RNA_define.h"
33
34 #include "DNA_ID.h"
35 #include "DNA_vfont_types.h"
36 #include "DNA_material_types.h"
37 #include "DNA_object_types.h"
38
39 #include "WM_types.h"
40
41 #include "rna_internal.h"
42
43 /* enum of ID-block types 
44  * NOTE: need to keep this in line with the other defines for these
45  */
46 EnumPropertyItem id_type_items[] = {
47         {ID_AC, "ACTION", ICON_ACTION, "Action", ""},
48         {ID_AR, "ARMATURE", ICON_ARMATURE_DATA, "Armature", ""},
49         {ID_BR, "BRUSH", ICON_BRUSH_DATA, "Brush", ""},
50         {ID_CA, "CAMERA", ICON_CAMERA_DATA, "Camera", ""},
51         {ID_CU, "CURVE", ICON_CURVE_DATA, "Curve", ""},
52         {ID_VF, "FONT", ICON_FONT_DATA, "Font", ""},
53         {ID_GD, "GREASEPENCIL", ICON_GREASEPENCIL, "Grease Pencil", ""},
54         {ID_GR, "GROUP", ICON_GROUP, "Group", ""},
55         {ID_IM, "IMAGE", ICON_IMAGE_DATA, "Image", ""},
56         {ID_KE, "KEY", ICON_SHAPEKEY_DATA, "Key", ""},
57         {ID_LA, "LAMP", ICON_LAMP_DATA, "Lamp", ""},
58         {ID_LI, "LIBRARY", ICON_LIBRARY_DATA_DIRECT, "Library", ""},
59         {ID_LS, "LINESTYLE", ICON_PARTICLE_DATA, "FreestyleLineStyle", ""}, /* FIXME proper icon */
60         {ID_LT, "LATTICE", ICON_LATTICE_DATA, "Lattice", ""},
61         {ID_MA, "MATERIAL", ICON_MATERIAL_DATA, "Material", ""},
62         {ID_MB, "META", ICON_META_DATA, "MetaBall", ""},
63         {ID_ME, "MESH", ICON_MESH_DATA, "Mesh", ""},
64         {ID_NT, "NODETREE", ICON_NODETREE, "NodeTree", ""},
65         {ID_OB, "OBJECT", ICON_OBJECT_DATA, "Object", ""},
66         {ID_PA, "PARTICLE", ICON_PARTICLE_DATA, "Particle", ""},
67         {ID_SCE, "SCENE", ICON_SCENE_DATA, "Scene", ""},
68         {ID_SCR, "SCREEN", ICON_SPLITSCREEN, "Screen", ""},
69         {ID_SPK, "SPEAKER", ICON_SPEAKER, "Speaker", ""},
70         {ID_SO, "SOUND", ICON_PLAY_AUDIO, "Sound", ""},
71         {ID_TXT, "TEXT", ICON_TEXT, "Text", ""},
72         {ID_TE, "TEXTURE", ICON_TEXTURE_DATA, "Texture", ""},
73         {ID_WO, "WORLD", ICON_WORLD_DATA, "World", ""},
74         {ID_WM, "WINDOWMANAGER", ICON_FULLSCREEN, "Window Manager", ""},
75         {0, NULL, 0, NULL, NULL}};
76
77 #ifdef RNA_RUNTIME
78
79 #include "BKE_idprop.h"
80 #include "BKE_library.h"
81 #include "BKE_animsys.h"
82 #include "BKE_material.h"
83 #include "BKE_depsgraph.h"
84
85 /* name functions that ignore the first two ID characters */
86 void rna_ID_name_get(PointerRNA *ptr, char *value)
87 {
88         ID *id= (ID*)ptr->data;
89         BLI_strncpy(value, id->name+2, sizeof(id->name)-2);
90 }
91
92 int rna_ID_name_length(PointerRNA *ptr)
93 {
94         ID *id= (ID*)ptr->data;
95         return strlen(id->name+2);
96 }
97
98 void rna_ID_name_set(PointerRNA *ptr, const char *value)
99 {
100         ID *id= (ID*)ptr->data;
101         BLI_strncpy_utf8(id->name+2, value, sizeof(id->name)-2);
102         test_idbutton(id->name+2);
103 }
104
105 static int rna_ID_name_editable(PointerRNA *ptr)
106 {
107         ID *id= (ID*)ptr->data;
108         
109         if (GS(id->name) == ID_VF) {
110                 VFont *vf= (VFont *)id;
111                 if (strcmp(vf->name, FO_BUILTIN_NAME)==0)
112                         return 0;
113         }
114         
115         return 1;
116 }
117
118 short RNA_type_to_ID_code(StructRNA *type)
119 {
120         if(RNA_struct_is_a(type, &RNA_Action)) return ID_AC;
121         if(RNA_struct_is_a(type, &RNA_Armature)) return ID_AR;
122         if(RNA_struct_is_a(type, &RNA_Brush)) return ID_BR;
123         if(RNA_struct_is_a(type, &RNA_Camera)) return ID_CA;
124         if(RNA_struct_is_a(type, &RNA_Curve)) return ID_CU;
125         if(RNA_struct_is_a(type, &RNA_GreasePencil)) return ID_GD;
126         if(RNA_struct_is_a(type, &RNA_Group)) return ID_GR;
127         if(RNA_struct_is_a(type, &RNA_Image)) return ID_IM;
128         if(RNA_struct_is_a(type, &RNA_Key)) return ID_KE;
129         if(RNA_struct_is_a(type, &RNA_Lamp)) return ID_LA;
130         if(RNA_struct_is_a(type, &RNA_Library)) return ID_LI;
131         if(RNA_struct_is_a(type, &RNA_FreestyleLineStyle)) return ID_LS;
132         if(RNA_struct_is_a(type, &RNA_Lattice)) return ID_LT;
133         if(RNA_struct_is_a(type, &RNA_Material)) return ID_MA;
134         if(RNA_struct_is_a(type, &RNA_MetaBall)) return ID_MB;
135         if(RNA_struct_is_a(type, &RNA_NodeTree)) return ID_NT;
136         if(RNA_struct_is_a(type, &RNA_Mesh)) return ID_ME;
137         if(RNA_struct_is_a(type, &RNA_Object)) return ID_OB;
138         if(RNA_struct_is_a(type, &RNA_ParticleSettings)) return ID_PA;
139         if(RNA_struct_is_a(type, &RNA_Scene)) return ID_SCE;
140         if(RNA_struct_is_a(type, &RNA_Screen)) return ID_SCR;
141         if(RNA_struct_is_a(type, &RNA_Speaker)) return ID_SPK;
142         if(RNA_struct_is_a(type, &RNA_Sound)) return ID_SO;
143         if(RNA_struct_is_a(type, &RNA_Text)) return ID_TXT;
144         if(RNA_struct_is_a(type, &RNA_Texture)) return ID_TE;
145         if(RNA_struct_is_a(type, &RNA_VectorFont)) return ID_VF;
146         if(RNA_struct_is_a(type, &RNA_World)) return ID_WO;
147         if(RNA_struct_is_a(type, &RNA_WindowManager)) return ID_WM;
148         if(RNA_struct_is_a(type, &RNA_MovieClip)) return ID_MC;
149
150         return 0;
151 }
152
153 StructRNA *ID_code_to_RNA_type(short idcode)
154 {
155         switch(idcode) {
156                 case ID_AC: return &RNA_Action;
157                 case ID_AR: return &RNA_Armature;
158                 case ID_BR: return &RNA_Brush;
159                 case ID_CA: return &RNA_Camera;
160                 case ID_CU: return &RNA_Curve;
161                 case ID_GD: return &RNA_GreasePencil;
162                 case ID_GR: return &RNA_Group;
163                 case ID_IM: return &RNA_Image;
164                 case ID_KE: return &RNA_Key;
165                 case ID_LA: return &RNA_Lamp;
166                 case ID_LI: return &RNA_Library;
167                 case ID_LS: return &RNA_FreestyleLineStyle;
168                 case ID_LT: return &RNA_Lattice;
169                 case ID_MA: return &RNA_Material;
170                 case ID_MB: return &RNA_MetaBall;
171                 case ID_NT: return &RNA_NodeTree;
172                 case ID_ME: return &RNA_Mesh;
173                 case ID_OB: return &RNA_Object;
174                 case ID_PA: return &RNA_ParticleSettings;
175                 case ID_SCE: return &RNA_Scene;
176                 case ID_SCR: return &RNA_Screen;
177                 case ID_SPK: return &RNA_Speaker;
178                 case ID_SO: return &RNA_Sound;
179                 case ID_TXT: return &RNA_Text;
180                 case ID_TE: return &RNA_Texture;
181                 case ID_VF: return &RNA_VectorFont;
182                 case ID_WO: return &RNA_World;
183                 case ID_WM: return &RNA_WindowManager;
184                 case ID_MC: return &RNA_MovieClip;
185                 default: return &RNA_ID;
186         }
187 }
188
189 StructRNA *rna_ID_refine(PointerRNA *ptr)
190 {
191         ID *id= (ID*)ptr->data;
192
193         return ID_code_to_RNA_type(GS(id->name));
194 }
195
196 IDProperty *rna_ID_idprops(PointerRNA *ptr, int create)
197 {
198         return IDP_GetProperties(ptr->data, create);
199 }
200
201 void rna_ID_fake_user_set(PointerRNA *ptr, int value)
202 {
203         ID *id= (ID*)ptr->data;
204
205         if(value && !(id->flag & LIB_FAKEUSER)) {
206                 id->flag |= LIB_FAKEUSER;
207                 id_us_plus(id);
208         }
209         else if(!value && (id->flag & LIB_FAKEUSER)) {
210                 id->flag &= ~LIB_FAKEUSER;
211                 id_us_min(id);
212         }
213 }
214
215 IDProperty *rna_PropertyGroup_idprops(PointerRNA *ptr, int UNUSED(create))
216 {
217         return ptr->data;
218 }
219
220 void rna_PropertyGroup_unregister(Main *UNUSED(bmain), StructRNA *type)
221 {
222         RNA_struct_free(&BLENDER_RNA, type);
223 }
224
225 StructRNA *rna_PropertyGroup_register(Main *UNUSED(bmain), ReportList *reports, void *data, const char *identifier, StructValidateFunc validate, StructCallbackFunc UNUSED(call), StructFreeFunc UNUSED(free))
226 {
227         PointerRNA dummyptr;
228
229         /* create dummy pointer */
230         RNA_pointer_create(NULL, &RNA_PropertyGroup, NULL, &dummyptr);
231
232         /* validate the python class */
233         if(validate(&dummyptr, data, NULL) != 0)
234                 return NULL;
235
236         /* note: it looks like there is no length limit on the srna id since its
237          * just a char pointer, but take care here, also be careful that python
238          * owns the string pointer which it could potentially free while blender
239          * is running. */
240         if(BLI_strnlen(identifier, MAX_IDPROP_NAME) == MAX_IDPROP_NAME) {
241                 BKE_reportf(reports, RPT_ERROR, "registering id property class: '%s' is too long, maximum length is " STRINGIFY(MAX_IDPROP_NAME), identifier);
242                 return NULL;
243         }
244
245         return RNA_def_struct(&BLENDER_RNA, identifier, "PropertyGroup");  // XXX
246 }
247
248 StructRNA* rna_PropertyGroup_refine(PointerRNA *ptr)
249 {
250         return ptr->type;
251 }
252
253 ID *rna_ID_copy(ID *id)
254 {
255         ID *newid;
256
257         if(id_copy(id, &newid, 0)) {
258                 if(newid) id_us_min(newid);
259                 return newid;
260         }
261         
262         return NULL;
263 }
264
265 static void rna_ID_update_tag(ID *id, ReportList *reports, int flag)
266 {
267         /* XXX, new function for this! */
268         /*if (ob->type == OB_FONT) {
269                 Curve *cu = ob->data;
270                 freedisplist(&cu->disp);
271                 BKE_text_to_curve(sce, ob, CU_LEFT);
272         }*/
273
274         if(flag == 0) {
275                 /* pass */
276         }
277         else {
278                 /* ensure flag us correct for the type */
279                 switch(GS(id->name)) {
280                 case ID_OB:
281                         if(flag & ~(OB_RECALC_ALL)) {
282                                 BKE_report(reports, RPT_ERROR, "'refresh' incompatible with Object ID type");
283                                 return;
284                         }
285                         break;
286                 /* Could add particle updates later */
287 /*              case ID_PA:
288                         if(flag & ~(OB_RECALC_ALL|PSYS_RECALC)) {
289                                 BKE_report(reports, RPT_ERROR, "'refresh' incompatible with ParticleSettings ID type");
290                                 return;
291                         }
292                         break; */
293                 default:
294                         BKE_report(reports, RPT_ERROR, "This ID type is not compatible with any 'refresh' options");
295                         return;
296                 }
297         }
298
299         DAG_id_tag_update(id, flag);
300 }
301
302 void rna_ID_user_clear(ID *id)
303 {
304         id->us= 0; /* dont save */
305         id->flag &= ~LIB_FAKEUSER;
306 }
307
308 static void rna_IDPArray_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
309 {
310         IDProperty *prop= (IDProperty *)ptr->data;
311         rna_iterator_array_begin(iter, IDP_IDPArray(prop), sizeof(IDProperty), prop->len, 0, NULL);
312 }
313
314 static int rna_IDPArray_length(PointerRNA *ptr)
315 {
316         IDProperty *prop= (IDProperty *)ptr->data;
317         return prop->len;
318 }
319
320 int rna_IDMaterials_assign_int(PointerRNA *ptr, int key, const PointerRNA *assign_ptr)
321 {
322         ID *id=           ptr->id.data;
323         short *totcol= give_totcolp_id(id);
324         Material *mat_id= assign_ptr->id.data;
325         if(totcol && (key >= 0 && key < *totcol)) {
326                 assign_material_id(id, mat_id, key + 1);
327                 return 1;
328         }
329         else {
330                 return 0;
331         }
332 }
333
334 void rna_Library_filepath_set(PointerRNA *ptr, const char *value)
335 {
336         Library *lib= (Library*)ptr->data;
337         BKE_library_filepath_set(lib, value);
338 }
339
340 #else
341
342 static void rna_def_ID_properties(BlenderRNA *brna)
343 {
344         StructRNA *srna;
345         PropertyRNA *prop;
346
347         /* this is struct is used for holding the virtual
348          * PropertyRNA's for ID properties */
349         srna= RNA_def_struct(brna, "PropertyGroupItem", NULL);
350         RNA_def_struct_sdna(srna, "IDProperty");
351         RNA_def_struct_ui_text(srna, "ID Property", "Property that stores arbitrary, user defined properties");
352         
353         /* IDP_STRING */
354         prop= RNA_def_property(srna, "string", PROP_STRING, PROP_NONE);
355         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
356
357         /* IDP_INT */
358         prop= RNA_def_property(srna, "int", PROP_INT, PROP_NONE);
359         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
360
361         prop= RNA_def_property(srna, "int_array", PROP_INT, PROP_NONE);
362         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
363         RNA_def_property_array(prop, 1);
364
365         /* IDP_FLOAT */
366         prop= RNA_def_property(srna, "float", PROP_FLOAT, PROP_NONE);
367         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
368
369         prop= RNA_def_property(srna, "float_array", PROP_FLOAT, PROP_NONE);
370         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
371         RNA_def_property_array(prop, 1);
372
373         /* IDP_DOUBLE */
374         prop= RNA_def_property(srna, "double", PROP_FLOAT, PROP_NONE);
375         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
376
377         prop= RNA_def_property(srna, "double_array", PROP_FLOAT, PROP_NONE);
378         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
379         RNA_def_property_array(prop, 1);
380
381         /* IDP_GROUP */
382         prop= RNA_def_property(srna, "group", PROP_POINTER, PROP_NONE);
383         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
384         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
385         RNA_def_property_struct_type(prop, "PropertyGroup");
386
387         prop= RNA_def_property(srna, "collection", PROP_COLLECTION, PROP_NONE);
388         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
389         RNA_def_property_struct_type(prop, "PropertyGroup");
390
391         prop= RNA_def_property(srna, "idp_array", PROP_COLLECTION, PROP_NONE);
392         RNA_def_property_struct_type(prop, "PropertyGroup");
393         RNA_def_property_collection_funcs(prop, "rna_IDPArray_begin", "rna_iterator_array_next", "rna_iterator_array_end", "rna_iterator_array_get", "rna_IDPArray_length", NULL, NULL, NULL);
394         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
395
396         // never tested, maybe its useful to have this?
397 #if 0
398         prop= RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
399         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
400         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
401         RNA_def_property_ui_text(prop, "Name", "Unique name used in the code and scripting");
402         RNA_def_struct_name_property(srna, prop);
403 #endif
404
405         /* IDP_ID -- not implemented yet in id properties */
406
407         /* ID property groups > level 0, since level 0 group is merged
408          * with native RNA properties. the builtin_properties will take
409          * care of the properties here */
410         srna= RNA_def_struct(brna, "PropertyGroup", NULL);
411         RNA_def_struct_sdna(srna, "IDPropertyGroup");
412         RNA_def_struct_ui_text(srna, "ID Property Group", "Group of ID properties");
413         RNA_def_struct_idprops_func(srna, "rna_PropertyGroup_idprops");
414         RNA_def_struct_register_funcs(srna, "rna_PropertyGroup_register", "rna_PropertyGroup_unregister", NULL);
415         RNA_def_struct_refine_func(srna, "rna_PropertyGroup_refine");
416
417         /* important so python types can have their name used in list views
418          * however this isnt prefect because it overrides how python would set the name
419          * when we only really want this so RNA_def_struct_name_property() is set to something useful */
420         prop= RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
421         RNA_def_property_flag(prop, PROP_EXPORT|PROP_IDPROPERTY);
422         //RNA_def_property_clear_flag(prop, PROP_EDITABLE);
423         RNA_def_property_ui_text(prop, "Name", "Unique name used in the code and scripting");
424         RNA_def_struct_name_property(srna, prop);
425 }
426
427
428 static void rna_def_ID_materials(BlenderRNA *brna)
429 {
430         StructRNA *srna;
431         FunctionRNA *func;
432         PropertyRNA *parm;
433         
434         /* for mesh/mball/curve materials */
435         srna= RNA_def_struct(brna, "IDMaterials", NULL);
436         RNA_def_struct_sdna(srna, "ID");
437         RNA_def_struct_ui_text(srna, "ID Materials", "Collection of materials");
438
439         func= RNA_def_function(srna, "append", "material_append_id");
440         RNA_def_function_ui_description(func, "Add a new material to the data block");
441         parm= RNA_def_pointer(func, "material", "Material", "", "Material to add");
442         RNA_def_property_flag(parm, PROP_REQUIRED);
443         
444         func= RNA_def_function(srna, "pop", "material_pop_id");
445         RNA_def_function_ui_description(func, "Remove a material from the data block");
446         parm= RNA_def_int(func, "index", 0, 0, MAXMAT, "", "Index of material to remove", 0, MAXMAT);
447         RNA_def_property_flag(parm, PROP_REQUIRED);
448         RNA_def_boolean(func, "update_data", 0, "", "Update data by re-adjusting the material slots assigned");
449         parm= RNA_def_pointer(func, "material", "Material", "", "Material to remove");
450         RNA_def_function_return(func, parm);
451 }
452
453 static void rna_def_ID(BlenderRNA *brna)
454 {
455         StructRNA *srna;
456         FunctionRNA *func;
457         PropertyRNA *prop, *parm;
458
459         static EnumPropertyItem update_flag_items[] = {
460                 {OB_RECALC_OB, "OBJECT", 0, "Object", ""},
461                 {OB_RECALC_DATA, "DATA", 0, "Data", ""},
462                 {OB_RECALC_TIME, "TIME", 0, "Time", ""},
463                 {0, NULL, 0, NULL, NULL}};
464
465         srna= RNA_def_struct(brna, "ID", NULL);
466         RNA_def_struct_ui_text(srna, "ID", "Base type for datablocks, defining a unique name, linking from other libraries and garbage collection");
467         RNA_def_struct_flag(srna, STRUCT_ID|STRUCT_ID_REFCOUNT);
468         RNA_def_struct_refine_func(srna, "rna_ID_refine");
469         RNA_def_struct_idprops_func(srna, "rna_ID_idprops");
470
471         prop= RNA_def_property(srna, "name", PROP_STRING, PROP_NONE);
472         RNA_def_property_ui_text(prop, "Name", "Unique datablock ID name");
473         RNA_def_property_string_funcs(prop, "rna_ID_name_get", "rna_ID_name_length", "rna_ID_name_set");
474         RNA_def_property_string_maxlength(prop, MAX_ID_NAME-2);
475         RNA_def_property_editable_func(prop, "rna_ID_name_editable");
476         RNA_def_property_update(prop, NC_ID|NA_RENAME, NULL);
477         RNA_def_struct_name_property(srna, prop);
478
479         prop= RNA_def_property(srna, "users", PROP_INT, PROP_UNSIGNED);
480         RNA_def_property_int_sdna(prop, NULL, "us");
481         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
482         RNA_def_property_ui_text(prop, "Users", "Number of times this datablock is referenced");
483
484         prop= RNA_def_property(srna, "use_fake_user", PROP_BOOLEAN, PROP_NONE);
485         RNA_def_property_boolean_sdna(prop, NULL, "flag", LIB_FAKEUSER);
486         RNA_def_property_ui_text(prop, "Fake User", "Save this datablock even if it has no users");
487         RNA_def_property_boolean_funcs(prop, NULL, "rna_ID_fake_user_set");
488
489         prop= RNA_def_property(srna, "tag", PROP_BOOLEAN, PROP_NONE);
490         RNA_def_property_boolean_sdna(prop, NULL, "flag", LIB_DOIT);
491         RNA_def_property_flag(prop, PROP_LIB_EXCEPTION);
492         RNA_def_property_ui_text(prop, "Tag", "Tools can use this to tag data (initial state is undefined)");
493
494         prop= RNA_def_property(srna, "is_updated", PROP_BOOLEAN, PROP_NONE);
495         RNA_def_property_boolean_sdna(prop, NULL, "flag", LIB_ID_RECALC);
496         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
497         RNA_def_property_ui_text(prop, "Is Updated", "Datablock is tagged for recalculation");
498
499         prop= RNA_def_property(srna, "is_updated_data", PROP_BOOLEAN, PROP_NONE);
500         RNA_def_property_boolean_sdna(prop, NULL, "flag", LIB_ID_RECALC_DATA);
501         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
502         RNA_def_property_ui_text(prop, "Is Updated Data", "Datablock data is tagged for recalculation");
503
504         prop= RNA_def_property(srna, "library", PROP_POINTER, PROP_NONE);
505         RNA_def_property_pointer_sdna(prop, NULL, "lib");
506         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
507         RNA_def_property_ui_text(prop, "Library", "Library file the datablock is linked from");
508
509         /* functions */
510         func= RNA_def_function(srna, "copy", "rna_ID_copy");
511         RNA_def_function_ui_description(func, "Create a copy of this datablock (not supported for all datablocks)");
512         parm= RNA_def_pointer(func, "id", "ID", "", "New copy of the ID");
513         RNA_def_function_return(func, parm);
514
515         func= RNA_def_function(srna, "user_clear", "rna_ID_user_clear");
516         RNA_def_function_ui_description(func, "Clear the user count of a datablock so its not saved, "
517                                               "on reload the data will be removed");
518
519         func= RNA_def_function(srna, "animation_data_create", "BKE_id_add_animdata");
520         RNA_def_function_ui_description(func, "Create animation data to this ID, note that not all ID types support this");
521         parm= RNA_def_pointer(func, "anim_data", "AnimData", "", "New animation data or NULL");
522         RNA_def_function_return(func, parm);
523
524         func= RNA_def_function(srna, "animation_data_clear", "BKE_free_animdata");
525         RNA_def_function_ui_description(func, "Clear animation on this this ID");
526
527         func= RNA_def_function(srna, "update_tag", "rna_ID_update_tag");
528         RNA_def_function_flag(func, FUNC_USE_REPORTS);
529         RNA_def_function_ui_description(func, "Tag the ID to update its display data");
530         RNA_def_enum_flag(func, "refresh", update_flag_items, 0, "", "Type of updates to perform");
531 }
532
533 static void rna_def_library(BlenderRNA *brna)
534 {
535         StructRNA *srna;
536         PropertyRNA *prop;
537
538         srna= RNA_def_struct(brna, "Library", "ID");
539         RNA_def_struct_ui_text(srna, "Library", "External .blend file from which data is linked");
540         RNA_def_struct_ui_icon(srna, ICON_LIBRARY_DATA_DIRECT);
541
542         prop= RNA_def_property(srna, "filepath", PROP_STRING, PROP_FILEPATH);
543         RNA_def_property_string_sdna(prop, NULL, "name");
544         RNA_def_property_ui_text(prop, "File Path", "Path to the library .blend file");
545         RNA_def_property_string_funcs(prop, NULL, NULL, "rna_Library_filepath_set");
546         
547         prop= RNA_def_property(srna, "parent", PROP_POINTER, PROP_NONE);
548         RNA_def_property_struct_type(prop, "Library");
549         RNA_def_property_ui_text(prop, "Parent", "");   
550 }
551 void RNA_def_ID(BlenderRNA *brna)
552 {
553         StructRNA *srna;
554
555         /* built-in unknown type */
556         srna= RNA_def_struct(brna, "UnknownType", NULL);
557         RNA_def_struct_ui_text(srna, "Unknown Type", "Stub RNA type used for pointers to unknown or internal data");
558
559         /* built-in any type */
560         srna= RNA_def_struct(brna, "AnyType", NULL);
561         RNA_def_struct_ui_text(srna, "Any Type", "RNA type used for pointers to any possible data");
562
563         rna_def_ID(brna);
564         rna_def_ID_properties(brna);
565         rna_def_ID_materials(brna);
566         rna_def_library(brna);
567 }
568
569 #endif
570