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