better reporting for file i/o failier, use system error message in more places: Permi...
[blender-staging.git] / source / blender / makesrna / intern / rna_main_api.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  * The Original Code is Copyright (C) 2009 Blender Foundation.
21  * All rights reserved.
22  *
23  * 
24  * Contributor(s): Blender Foundation
25  *
26  * ***** END GPL LICENSE BLOCK *****
27  */
28
29 #include <stdlib.h>
30 #include <stdio.h>
31 #include <errno.h>
32
33 #include "RNA_define.h"
34 #include "RNA_access.h"
35 #include "RNA_enum_types.h"
36
37 #include "BKE_utildefines.h"
38
39 #ifdef RNA_RUNTIME
40
41 #include "BKE_main.h"
42 #include "BKE_curve.h"
43 #include "BKE_mesh.h"
44 #include "BKE_armature.h"
45 #include "BKE_library.h"
46 #include "BKE_object.h"
47 #include "BKE_material.h"
48 #include "BKE_image.h"
49 #include "BKE_texture.h"
50 #include "BKE_scene.h"
51 #include "BKE_text.h"
52 #include "BKE_action.h"
53 #include "BKE_group.h"
54 #include "BKE_brush.h"
55 #include "BKE_lattice.h"
56 #include "BKE_mball.h"
57 #include "BKE_world.h"
58 #include "BKE_particle.h"
59 #include "BKE_font.h"
60 #include "BKE_node.h"
61
62 #include "DNA_armature_types.h"
63 #include "DNA_camera_types.h"
64 #include "DNA_curve_types.h"
65 #include "DNA_lamp_types.h"
66 #include "DNA_material_types.h"
67 #include "DNA_mesh_types.h"
68 #include "DNA_object_types.h"
69 #include "DNA_text_types.h"
70 #include "DNA_texture_types.h"
71 #include "DNA_group_types.h"
72 #include "DNA_brush_types.h"
73 #include "DNA_lattice_types.h"
74 #include "DNA_meta_types.h"
75 #include "DNA_world_types.h"
76 #include "DNA_particle_types.h"
77 #include "DNA_vfont_types.h"
78 #include "DNA_node_types.h"
79
80 #include "ED_screen.h"
81
82 Tex *rna_Main_add_texture(Main *bmain, char *name)
83 {
84         return add_texture(name);
85 }
86
87 Camera *rna_Main_cameras_new(Main *bmain, char* name)
88 {
89         return add_camera(name);
90 }
91 void rna_Main_cameras_remove(Main *bmain, ReportList *reports, struct Camera *camera)
92 {
93         if(ID_REAL_USERS(camera) <= 0)
94                 free_libblock(&bmain->camera, camera);
95         else
96                 BKE_reportf(reports, RPT_ERROR, "Camera \"%s\" must have zero users to be removed, found %d.", camera->id.name+2, ID_REAL_USERS(camera));
97
98         /* XXX python now has invalid pointer? */
99 }
100
101 Scene *rna_Main_scenes_new(Main *bmain, char* name)
102 {
103         return add_scene(name);
104 }
105 void rna_Main_scenes_remove(Main *bmain, bContext *C, ReportList *reports, struct Scene *scene)
106 {
107         /* dont call free_libblock(...) directly */
108         Scene *newscene;
109
110         if(scene->id.prev)
111                 newscene= scene->id.prev;
112         else if(scene->id.next)
113                 newscene= scene->id.next;
114         else {
115                 BKE_reportf(reports, RPT_ERROR, "Scene \"%s\" is the last, cant ve removed.", scene->id.name+2);
116                 return;
117         }
118
119         ED_screen_set_scene(C, newscene);
120
121         unlink_scene(bmain, scene, newscene);
122 }
123
124 Object *rna_Main_objects_new(Main *bmain, ReportList *reports, char* name, ID *data)
125 {
126         Object *ob;
127         int type= OB_EMPTY;
128         if(data) {
129                 switch(GS(data->name)) {
130                         case ID_ME:
131                                 type= OB_MESH;
132                                 break;
133                         case ID_CU:
134                                 type= curve_type((struct Curve *)data);
135                                 break;
136                         case ID_MB:
137                                 type= OB_MBALL;
138                                 break;
139                         case ID_LA:
140                                 type= OB_LAMP;
141                                 break;
142                         case ID_CA:
143                                 type= OB_CAMERA;
144                                 break;
145                         case ID_LT:
146                                 type= OB_LATTICE;
147                                 break;
148                         case ID_AR:
149                                 type= OB_ARMATURE;
150                                 break;
151                         default:
152                         {
153                                 const char *idname;
154                                 if(RNA_enum_id_from_value(id_type_items, GS(data->name), &idname) == 0)
155                                         idname= "UNKNOWN";
156
157                                 BKE_reportf(reports, RPT_ERROR, "ID type '%s' is not valid for a object.", idname);
158                                 return NULL;
159                         }
160                 }
161
162                 data->us++;
163         }
164
165         ob= add_only_object(type, name);
166         ob->id.us--;
167
168         ob->data= data;
169         test_object_materials(ob->data);
170         
171         return ob;
172 }
173
174 void rna_Main_objects_remove(Main *bmain, ReportList *reports, struct Object *object)
175 {
176         /*
177           NOTE: the following example shows when this function should _not_ be called
178
179           ob = bpy.data.add_object()
180           scene.add_object(ob)
181
182           # ob is freed here
183           scene.remove_object(ob)
184
185           # don't do this since ob is already freed!
186           bpy.data.remove_object(ob)
187         */
188         if(ID_REAL_USERS(object) <= 0)
189                 free_libblock(&bmain->object, object);
190         else
191                 BKE_reportf(reports, RPT_ERROR, "Object \"%s\" must have zero users to be removed, found %d.", object->id.name+2, ID_REAL_USERS(object));
192 }
193
194 struct Material *rna_Main_materials_new(Main *bmain, char* name)
195 {
196         return add_material(name);
197 }
198 void rna_Main_materials_remove(Main *bmain, ReportList *reports, struct Material *material)
199 {
200         if(ID_REAL_USERS(material) <= 0)
201                 free_libblock(&bmain->mat, material);
202         else
203                 BKE_reportf(reports, RPT_ERROR, "Material \"%s\" must have zero users to be removed, found %d.", material->id.name+2, ID_REAL_USERS(material));
204
205         /* XXX python now has invalid pointer? */
206 }
207
208 // XXX, commended for now, need to see how this can be used with node groups.
209 struct bNodeTree *rna_Main_nodetree_new(Main *bmain, int type)
210 {
211         bNodeTree *tree = ntreeAddTree(type);
212         tree->id.us--;
213         return tree;
214 }
215 void rna_Main_nodetree_remove(Main *bmain, ReportList *reports, struct bNodeTree *tree)
216 {
217         if(ID_REAL_USERS(tree) <= 0)
218                 free_libblock(&bmain->nodetree, tree);
219         else
220                 BKE_reportf(reports, RPT_ERROR, "Node Tree \"%s\" must have zero users to be removed, found %d.", tree->id.name+2, ID_REAL_USERS(tree));
221
222         /* XXX python now has invalid pointer? */
223 }
224
225 Mesh *rna_Main_meshes_new(Main *bmain, char* name)
226 {
227         Mesh *me= add_mesh(name);
228         me->id.us--;
229         return me;
230 }
231 void rna_Main_meshes_remove(Main *bmain, ReportList *reports, Mesh *mesh)
232 {
233         if(ID_REAL_USERS(mesh) <= 0)
234                 free_libblock(&bmain->mesh, mesh);
235         else
236                 BKE_reportf(reports, RPT_ERROR, "Mesh \"%s\" must have zero users to be removed, found %d.", mesh->id.name+2, ID_REAL_USERS(mesh));
237
238         /* XXX python now has invalid pointer? */
239 }
240
241 Lamp *rna_Main_lamps_new(Main *bmain, char* name)
242 {
243         Lamp *lamp= add_lamp(name);
244         lamp->id.us--;
245         return lamp;
246 }
247 void rna_Main_lamps_remove(Main *bmain, ReportList *reports, Lamp *lamp)
248 {
249         if(ID_REAL_USERS(lamp) <= 0)
250                 free_libblock(&bmain->lamp, lamp);
251         else
252                 BKE_reportf(reports, RPT_ERROR, "Lamp \"%s\" must have zero users to be removed, found %d.", lamp->id.name+2, ID_REAL_USERS(lamp));
253
254         /* XXX python now has invalid pointer? */
255 }
256
257 Image *rna_Main_images_new(Main *bmain, char* name, int width, int height, int alpha, int float_buffer)
258 {
259         float color[4]= {0.0, 0.0, 0.0, 1.0};
260         Image *image= BKE_add_image_size(width, height, name, alpha ? 32:24, float_buffer, 0, color);
261         image->id.us--;
262         return image;
263 }
264 Image *rna_Main_images_load(Main *bmain, ReportList *reports, char *filepath)
265 {
266         Image *ima;
267
268         errno= 0;
269         ima= BKE_add_image_file(filepath, 0);
270
271         if(!ima)
272                 BKE_reportf(reports, RPT_ERROR, "Can't read: \"%s\", %s.", filepath, errno ? strerror(errno) : "Unsupported image format");
273
274         return ima;
275 }
276 void rna_Main_images_remove(Main *bmain, ReportList *reports, Image *image)
277 {
278         if(ID_REAL_USERS(image) <= 0)
279                 free_libblock(&bmain->image, image);
280         else
281                 BKE_reportf(reports, RPT_ERROR, "Image \"%s\" must have zero users to be removed, found %d.", image->id.name+2, ID_REAL_USERS(image));
282
283         /* XXX python now has invalid pointer? */
284 }
285
286 Lattice *rna_Main_lattices_new(Main *bmain, char* name)
287 {
288         Lattice *lt= add_lattice(name);
289         lt->id.us--;
290         return lt;
291 }
292 void rna_Main_lattices_remove(Main *bmain, ReportList *reports, struct Lattice *lt)
293 {
294         if(ID_REAL_USERS(lt) <= 0)
295                 free_libblock(&bmain->latt, lt);
296         else
297                 BKE_reportf(reports, RPT_ERROR, "Lattice \"%s\" must have zero users to be removed, found %d.", lt->id.name+2, ID_REAL_USERS(lt));
298 }
299
300 Curve *rna_Main_curves_new(Main *bmain, char* name, int type)
301 {
302         Curve *cu= add_curve(name, type);
303         cu->id.us--;
304         return cu;
305 }
306 void rna_Main_curves_remove(Main *bmain, ReportList *reports, struct Curve *cu)
307 {
308         if(ID_REAL_USERS(cu) <= 0)
309                 free_libblock(&bmain->curve, cu);
310         else
311                 BKE_reportf(reports, RPT_ERROR, "Curve \"%s\" must have zero users to be removed, found %d.", cu->id.name+2, ID_REAL_USERS(cu));
312 }
313
314 MetaBall *rna_Main_metaballs_new(Main *bmain, char* name)
315 {
316         MetaBall *mb= add_mball(name);
317         mb->id.us--;
318         return mb;
319 }
320 void rna_Main_metaballs_remove(Main *bmain, ReportList *reports, struct MetaBall *mb)
321 {
322         if(ID_REAL_USERS(mb) <= 0)
323                 free_libblock(&bmain->mball, mb);
324         else
325                 BKE_reportf(reports, RPT_ERROR, "MetaBall \"%s\" must have zero users to be removed, found %d.", mb->id.name+2, ID_REAL_USERS(mb));
326 }
327
328 VFont *rna_Main_fonts_load(Main *bmain, ReportList *reports, char *filepath)
329 {
330         VFont *font;
331
332         errno= 0;
333         font= load_vfont(filepath);
334
335         if(!font)
336                 BKE_reportf(reports, RPT_ERROR, "Can't read: \"%s\", %s.", filepath, errno ? strerror(errno) : "Unsupported font format");
337
338         return font;
339
340 }
341 void rna_Main_fonts_remove(Main *bmain, ReportList *reports, VFont *vfont)
342 {
343         if(ID_REAL_USERS(vfont) <= 0)
344                 free_libblock(&bmain->vfont, vfont);
345         else
346                 BKE_reportf(reports, RPT_ERROR, "Font \"%s\" must have zero users to be removed, found %d.", vfont->id.name+2, ID_REAL_USERS(vfont));
347
348         /* XXX python now has invalid pointer? */
349 }
350
351 Tex *rna_Main_textures_new(Main *bmain, char* name)
352 {
353         Tex *tex= add_texture(name);
354         tex->id.us--;
355         return tex;
356 }
357 void rna_Main_textures_remove(Main *bmain, ReportList *reports, struct Tex *tex)
358 {
359         if(ID_REAL_USERS(tex) <= 0)
360                 free_libblock(&bmain->tex, tex);
361         else
362                 BKE_reportf(reports, RPT_ERROR, "Texture \"%s\" must have zero users to be removed, found %d.", tex->id.name+2, ID_REAL_USERS(tex));
363 }
364
365 Brush *rna_Main_brushes_new(Main *bmain, char* name)
366 {
367         Brush *brush = add_brush(name);
368         brush->id.us--;
369         return brush;
370 }
371 void rna_Main_brushes_remove(Main *bmain, ReportList *reports, struct Brush *brush)
372 {
373         if(ID_REAL_USERS(brush) <= 0)
374                 free_libblock(&bmain->brush, brush);
375         else
376                 BKE_reportf(reports, RPT_ERROR, "Brush \"%s\" must have zero users to be removed, found %d.", brush->id.name+2, ID_REAL_USERS(brush));
377 }
378
379 World *rna_Main_worlds_new(Main *bmain, char* name)
380 {
381         World *world = add_world(name);
382         world->id.us--;
383         return world;
384 }
385 void rna_Main_worlds_remove(Main *bmain, ReportList *reports, struct World *world)
386 {
387         if(ID_REAL_USERS(world) <= 0)
388                 free_libblock(&bmain->world, world);
389         else
390                 BKE_reportf(reports, RPT_ERROR, "World \"%s\" must have zero users to be removed, found %d.", world->id.name+2, ID_REAL_USERS(world));
391 }
392
393 Group *rna_Main_groups_new(Main *bmain, char* name)
394 {
395         return add_group(name);
396 }
397 void rna_Main_groups_remove(Main *bmain, ReportList *reports, Group *group)
398 {
399         unlink_group(group);
400         group->id.us= 0;
401         free_libblock(&bmain->group, group);
402         /* XXX python now has invalid pointer? */
403 }
404
405 Text *rna_Main_texts_new(Main *bmain, char* name)
406 {
407         return add_empty_text(name);
408 }
409 void rna_Main_texts_remove(Main *bmain, ReportList *reports, Text *text)
410 {
411         unlink_text(bmain, text);
412         free_libblock(&bmain->text, text);
413         /* XXX python now has invalid pointer? */
414 }
415
416 Text *rna_Main_texts_load(Main *bmain, ReportList *reports, char* filepath)
417 {
418         Text *txt;
419
420         errno= 0;
421         txt= add_text(filepath, bmain->name);
422
423         if(!txt)
424                 BKE_reportf(reports, RPT_ERROR, "Can't read: \"%s\", %s.", filepath, errno ? strerror(errno) : "Unable to load text");
425
426         return txt;
427 }
428
429 bArmature *rna_Main_armatures_new(Main *bmain, char* name)
430 {
431         bArmature *arm= add_armature(name);
432         arm->id.us--;
433         return arm;
434 }
435 void rna_Main_armatures_remove(Main *bmain, ReportList *reports, bArmature *arm)
436 {
437         if(ID_REAL_USERS(arm) <= 0)
438                 free_libblock(&bmain->armature, arm);
439         else
440                 BKE_reportf(reports, RPT_ERROR, "Armature \"%s\" must have zero users to be removed, found %d.", arm->id.name+2, ID_REAL_USERS(arm));
441
442         /* XXX python now has invalid pointer? */
443 }
444
445 bAction *rna_Main_actions_new(Main *bmain, char* name)
446 {
447         bAction *act= add_empty_action(name);
448         act->id.us--;
449         act->id.flag &= ~LIB_FAKEUSER;
450         return act;
451 }
452 void rna_Main_actions_remove(Main *bmain, ReportList *reports, bAction *act)
453 {
454         if(ID_REAL_USERS(act) <= 0)
455                 free_libblock(&bmain->action, act);
456         else
457                 BKE_reportf(reports, RPT_ERROR, "Action \"%s\" must have zero users to be removed, found %d.", act->id.name+2, ID_REAL_USERS(act));
458
459         /* XXX python now has invalid pointer? */
460 }
461
462 ParticleSettings *rna_Main_particles_new(Main *bmain, char* name)
463 {
464         ParticleSettings *part = psys_new_settings(name, bmain);
465         part->id.us--;
466         return part;
467 }
468 void rna_Main_particles_remove(Main *bmain, ReportList *reports, ParticleSettings *part)
469 {
470         if(ID_REAL_USERS(part) <= 0)
471                 free_libblock(&bmain->particle, part);
472         else
473                 BKE_reportf(reports, RPT_ERROR, "Particle Settings \"%s\" must have zero users to be removed, found %d.", part->id.name+2, ID_REAL_USERS(part));
474
475         /* XXX python now has invalid pointer? */
476 }
477
478 #else
479
480 void RNA_api_main(StructRNA *srna)
481 {
482         /*
483         FunctionRNA *func;
484         PropertyRNA *parm;
485         */
486         /* maybe we want to add functions in 'bpy.data' still?
487          * for now they are all in collections bpy.data.images.new(...) */
488         /*
489         func= RNA_def_function(srna, "add_image", "rna_Main_add_image");
490         RNA_def_function_ui_description(func, "Add a new image.");
491         parm= RNA_def_string(func, "filepath", "", 0, "", "File path to load image from.");
492         RNA_def_property_flag(parm, PROP_REQUIRED);
493         parm= RNA_def_pointer(func, "image", "Image", "", "New image.");
494         RNA_def_function_return(func, parm);
495         */
496
497 }
498
499 void RNA_def_main_cameras(BlenderRNA *brna, PropertyRNA *cprop)
500 {
501         StructRNA *srna;
502         FunctionRNA *func;
503         PropertyRNA *parm;
504
505         RNA_def_property_srna(cprop, "MainCameras");
506         srna= RNA_def_struct(brna, "MainCameras", NULL);
507         RNA_def_struct_ui_text(srna, "Main Cameras", "Collection of cameras");
508
509         func= RNA_def_function(srna, "new", "rna_Main_cameras_new");
510         RNA_def_function_ui_description(func, "Add a new camera to the main database");
511         parm= RNA_def_string(func, "name", "Camera", 0, "", "New name for the datablock.");
512         RNA_def_property_flag(parm, PROP_REQUIRED);
513         /* return type */
514         parm= RNA_def_pointer(func, "camera", "Camera", "", "New camera datablock.");
515         RNA_def_function_return(func, parm);
516
517         func= RNA_def_function(srna, "remove", "rna_Main_cameras_remove");
518         RNA_def_function_flag(func, FUNC_USE_REPORTS);
519         RNA_def_function_ui_description(func, "Remove a camera from the current blendfile.");
520         parm= RNA_def_pointer(func, "camera", "Camera", "", "Camera to remove.");
521         RNA_def_property_flag(parm, PROP_REQUIRED);
522 }
523
524 void RNA_def_main_scenes(BlenderRNA *brna, PropertyRNA *cprop)
525 {
526         StructRNA *srna;
527         FunctionRNA *func;
528         PropertyRNA *parm;
529
530         RNA_def_property_srna(cprop, "MainScenes");
531         srna= RNA_def_struct(brna, "MainScenes", NULL);
532         RNA_def_struct_ui_text(srna, "Main Scenes", "Collection of scenes");
533
534         func= RNA_def_function(srna, "new", "rna_Main_scenes_new");
535         RNA_def_function_ui_description(func, "Add a new scene to the main database");
536         parm= RNA_def_string(func, "name", "Scene", 0, "", "New name for the datablock.");
537         RNA_def_property_flag(parm, PROP_REQUIRED);
538         /* return type */
539         parm= RNA_def_pointer(func, "scene", "Scene", "", "New scene datablock.");
540         RNA_def_function_return(func, parm);
541
542         func= RNA_def_function(srna, "remove", "rna_Main_scenes_remove");
543         RNA_def_function_flag(func, FUNC_USE_CONTEXT|FUNC_USE_REPORTS);
544         parm= RNA_def_pointer(func, "scene", "Scene", "", "Scene to remove.");
545         RNA_def_property_flag(parm, PROP_REQUIRED);
546         RNA_def_function_ui_description(func, "Remove a scene from the current blendfile.");
547         RNA_def_property_flag(parm, PROP_REQUIRED);
548 }
549
550 void RNA_def_main_objects(BlenderRNA *brna, PropertyRNA *cprop)
551 {
552         StructRNA *srna;
553         FunctionRNA *func;
554         PropertyRNA *parm;
555
556         RNA_def_property_srna(cprop, "MainObjects");
557         srna= RNA_def_struct(brna, "MainObjects", NULL);
558         RNA_def_struct_ui_text(srna, "Main Objects", "Collection of objects");
559
560         func= RNA_def_function(srna, "new", "rna_Main_objects_new");
561         RNA_def_function_flag(func, FUNC_USE_REPORTS);
562         RNA_def_function_ui_description(func, "Add a new object to the main database");
563         parm= RNA_def_string(func, "name", "Object", 0, "", "New name for the datablock.");
564         RNA_def_property_flag(parm, PROP_REQUIRED);
565         parm= RNA_def_pointer(func, "object_data", "ID", "", "Object data or None for an empty object.");
566         RNA_def_property_flag(parm, PROP_REQUIRED);
567
568         /* return type */
569         parm= RNA_def_pointer(func, "object", "Object", "", "New object datablock.");
570         RNA_def_function_return(func, parm);
571
572         func= RNA_def_function(srna, "remove", "rna_Main_objects_remove");
573         RNA_def_function_flag(func, FUNC_USE_REPORTS);
574         parm= RNA_def_pointer(func, "object", "Object", "", "Object to remove.");
575         RNA_def_property_flag(parm, PROP_REQUIRED);
576         RNA_def_function_ui_description(func, "Remove a object from the current blendfile.");
577 }
578
579 void RNA_def_main_materials(BlenderRNA *brna, PropertyRNA *cprop)
580 {
581         StructRNA *srna;
582         FunctionRNA *func;
583         PropertyRNA *parm;
584
585         RNA_def_property_srna(cprop, "MainMaterials");
586         srna= RNA_def_struct(brna, "MainMaterials", NULL);
587         RNA_def_struct_ui_text(srna, "Main Material", "Collection of materials");
588
589         func= RNA_def_function(srna, "new", "rna_Main_materials_new");
590         RNA_def_function_ui_description(func, "Add a new material to the main database");
591         parm= RNA_def_string(func, "name", "Material", 0, "", "New name for the datablock.");
592         RNA_def_property_flag(parm, PROP_REQUIRED);
593         /* return type */
594         parm= RNA_def_pointer(func, "material", "Material", "", "New material datablock.");
595         RNA_def_function_return(func, parm);
596
597         func= RNA_def_function(srna, "remove", "rna_Main_materials_remove");
598         RNA_def_function_flag(func, FUNC_USE_REPORTS);
599         RNA_def_function_ui_description(func, "Remove a material from the current blendfile.");
600         parm= RNA_def_pointer(func, "material", "Material", "", "Material to remove.");
601         RNA_def_property_flag(parm, PROP_REQUIRED);
602 }
603 void RNA_def_main_node_groups(BlenderRNA *brna, PropertyRNA *cprop)
604 {
605         StructRNA *srna;
606 //      FunctionRNA *func;
607 //      PropertyRNA *parm;
608
609 /*      static EnumPropertyItem node_nodetree_items[] = {
610         {0, "SHADER",       0,    "Shader",       ""},
611         {1, "COMPOSITE",    0,    "Composite",    ""},
612         {2, "TEXTURE",      0,    "Texture",      ""},
613         {0, NULL, 0, NULL, NULL}}; */
614
615         RNA_def_property_srna(cprop, "MainNodeTrees");
616         srna= RNA_def_struct(brna, "MainNodeTrees", NULL);
617         RNA_def_struct_ui_text(srna, "Main Node Trees", "Collection of node trees");
618
619 #if 0 // need to see some examples of using these functions before enabling.
620         func= RNA_def_function(srna, "new", "rna_Main_nodetree_new");
621         RNA_def_function_ui_description(func, "Add a new node tree to the main database");
622         parm= RNA_def_enum(func, "type", node_nodetree_items, 0, "Type", "The type of curve object to add");
623         RNA_def_property_flag(parm, PROP_REQUIRED);
624         /* return type */
625         parm= RNA_def_pointer(func, "tree", "NodeTree", "", "New node tree datablock.");
626         RNA_def_function_return(func, parm);
627
628         func= RNA_def_function(srna, "remove", "rna_Main_nodetree_remove");
629         RNA_def_function_flag(func, FUNC_USE_REPORTS);
630         RNA_def_function_ui_description(func, "Remove a node tree from the current blendfile.");
631         parm= RNA_def_pointer(func, "tree", "NodeTree", "", "Node tree to remove.");
632         RNA_def_property_flag(parm, PROP_REQUIRED);
633 #endif
634 }
635 void RNA_def_main_meshes(BlenderRNA *brna, PropertyRNA *cprop)
636 {
637         StructRNA *srna;
638         FunctionRNA *func;
639         PropertyRNA *parm;
640
641         RNA_def_property_srna(cprop, "MainMeshes");
642         srna= RNA_def_struct(brna, "MainMeshes", NULL);
643         RNA_def_struct_ui_text(srna, "Main Meshes", "Collection of meshes");
644
645         func= RNA_def_function(srna, "new", "rna_Main_meshes_new");
646         RNA_def_function_ui_description(func, "Add a new mesh to the main database");
647         parm= RNA_def_string(func, "name", "Mesh", 0, "", "New name for the datablock.");
648         RNA_def_property_flag(parm, PROP_REQUIRED);
649         /* return type */
650         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "New mesh datablock.");
651         RNA_def_function_return(func, parm);
652
653         func= RNA_def_function(srna, "remove", "rna_Main_meshes_remove");
654         RNA_def_function_flag(func, FUNC_USE_REPORTS);
655         RNA_def_function_ui_description(func, "Remove a mesh from the current blendfile.");
656         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "Mesh to remove.");
657         RNA_def_property_flag(parm, PROP_REQUIRED);
658 }
659 void RNA_def_main_lamps(BlenderRNA *brna, PropertyRNA *cprop)
660 {
661         StructRNA *srna;
662         FunctionRNA *func;
663         PropertyRNA *parm;
664
665         RNA_def_property_srna(cprop, "MainLamps");
666         srna= RNA_def_struct(brna, "MainLamps", NULL);
667         RNA_def_struct_ui_text(srna, "Main Lamps", "Collection of lamps");
668
669         func= RNA_def_function(srna, "new", "rna_Main_lamps_new");
670         RNA_def_function_ui_description(func, "Add a new lamp to the main database");
671         parm= RNA_def_string(func, "name", "Lamp", 0, "", "New name for the datablock.");
672         RNA_def_property_flag(parm, PROP_REQUIRED);
673         /* return type */
674         parm= RNA_def_pointer(func, "lamp", "Lamp", "", "New lamp datablock.");
675         RNA_def_function_return(func, parm);
676
677         func= RNA_def_function(srna, "remove", "rna_Main_lamps_remove");
678         RNA_def_function_flag(func, FUNC_USE_REPORTS);
679         RNA_def_function_ui_description(func, "Remove a lamp from the current blendfile.");
680         parm= RNA_def_pointer(func, "lamp", "Lamp", "", "Lamp to remove.");
681         RNA_def_property_flag(parm, PROP_REQUIRED);
682 }
683 void RNA_def_main_libraries(BlenderRNA *brna, PropertyRNA *cprop)
684 {
685
686 }
687 void RNA_def_main_screens(BlenderRNA *brna, PropertyRNA *cprop)
688 {
689
690 }
691 void RNA_def_main_window_managers(BlenderRNA *brna, PropertyRNA *cprop)
692 {
693     
694 }
695 void RNA_def_main_images(BlenderRNA *brna, PropertyRNA *cprop)
696 {
697         StructRNA *srna;
698         FunctionRNA *func;
699         PropertyRNA *parm;
700
701         RNA_def_property_srna(cprop, "MainImages");
702         srna= RNA_def_struct(brna, "MainImages", NULL);
703         RNA_def_struct_ui_text(srna, "Main Images", "Collection of images");
704
705         func= RNA_def_function(srna, "new", "rna_Main_images_new");
706         RNA_def_function_ui_description(func, "Add a new image to the main database");
707         parm= RNA_def_string(func, "name", "Image", 0, "", "New name for the datablock.");
708         RNA_def_property_flag(parm, PROP_REQUIRED);
709         parm= RNA_def_int(func, "width", 1024, 1, INT_MAX, "", "Width of the image.", 0, INT_MAX);
710         parm= RNA_def_int(func, "height", 1024, 1, INT_MAX, "", "Height of the image.", 0, INT_MAX);
711         parm= RNA_def_boolean(func, "alpha", 0, "Alpha", "Use alpha channel");
712         parm= RNA_def_boolean(func, "float_buffer", 0, "Float Buffer", "Create an image with floating point color");
713         /* return type */
714         parm= RNA_def_pointer(func, "image", "Image", "", "New image datablock.");
715         RNA_def_function_return(func, parm);
716
717         func= RNA_def_function(srna, "load", "rna_Main_images_load");
718         RNA_def_function_flag(func, FUNC_USE_REPORTS);
719         RNA_def_function_ui_description(func, "Load a new image into the main database");
720         parm= RNA_def_string(func, "filepath", "File Path", 0, "", "path of the file to load.");
721         RNA_def_property_flag(parm, PROP_REQUIRED);
722         /* return type */
723         parm= RNA_def_pointer(func, "image", "Image", "", "New image datablock.");
724         RNA_def_function_return(func, parm);
725
726         func= RNA_def_function(srna, "remove", "rna_Main_images_remove");
727         RNA_def_function_flag(func, FUNC_USE_REPORTS);
728         RNA_def_function_ui_description(func, "Remove an image from the current blendfile.");
729         parm= RNA_def_pointer(func, "image", "Image", "", "Image to remove.");
730         RNA_def_property_flag(parm, PROP_REQUIRED);
731 }
732
733 void RNA_def_main_lattices(BlenderRNA *brna, PropertyRNA *cprop)
734 {
735         StructRNA *srna;
736         FunctionRNA *func;
737         PropertyRNA *parm;
738
739         RNA_def_property_srna(cprop, "MainLattices");
740         srna= RNA_def_struct(brna, "MainLattices", NULL);
741         RNA_def_struct_ui_text(srna, "Main Lattices", "Collection of lattices");
742
743         func= RNA_def_function(srna, "new", "rna_Main_lattices_new");
744         RNA_def_function_ui_description(func, "Add a new lattice to the main database");
745         parm= RNA_def_string(func, "name", "Lattice", 0, "", "New name for the datablock.");
746         RNA_def_property_flag(parm, PROP_REQUIRED);
747         /* return type */
748         parm= RNA_def_pointer(func, "lattice", "Lattice", "", "New lattices datablock.");
749         RNA_def_function_return(func, parm);
750
751         func= RNA_def_function(srna, "remove", "rna_Main_lattices_remove");
752         RNA_def_function_flag(func, FUNC_USE_REPORTS);
753         RNA_def_function_ui_description(func, "Remove a lattice from the current blendfile.");
754         parm= RNA_def_pointer(func, "lattice", "Lattice", "", "Lattice to remove.");
755         RNA_def_property_flag(parm, PROP_REQUIRED);
756 }
757 void RNA_def_main_curves(BlenderRNA *brna, PropertyRNA *cprop)
758 {
759         StructRNA *srna;
760         FunctionRNA *func;
761         PropertyRNA *parm;
762
763         RNA_def_property_srna(cprop, "MainCurves");
764         srna= RNA_def_struct(brna, "MainCurves", NULL);
765         RNA_def_struct_ui_text(srna, "Main Curves", "Collection of curves");
766
767         func= RNA_def_function(srna, "new", "rna_Main_curves_new");
768         RNA_def_function_ui_description(func, "Add a new curve to the main database");
769         parm= RNA_def_string(func, "name", "Curve", 0, "", "New name for the datablock.");
770         RNA_def_property_flag(parm, PROP_REQUIRED);
771         parm= RNA_def_enum(func, "type", object_type_curve_items, 0, "Type", "The type of curve object to add");
772         RNA_def_property_flag(parm, PROP_REQUIRED);
773         /* return type */
774         parm= RNA_def_pointer(func, "curve", "Curve", "", "New curve datablock.");
775         RNA_def_function_return(func, parm);
776
777         func= RNA_def_function(srna, "remove", "rna_Main_curves_remove");
778         RNA_def_function_flag(func, FUNC_USE_REPORTS);
779         RNA_def_function_ui_description(func, "Remove a curve from the current blendfile.");
780         parm= RNA_def_pointer(func, "curve", "Curve", "", "Curve to remove.");
781         RNA_def_property_flag(parm, PROP_REQUIRED);
782 }
783 void RNA_def_main_metaballs(BlenderRNA *brna, PropertyRNA *cprop)
784 {
785         StructRNA *srna;
786         FunctionRNA *func;
787         PropertyRNA *parm;
788
789         RNA_def_property_srna(cprop, "MainMetaBalls");
790         srna= RNA_def_struct(brna, "MainMetaBalls", NULL);
791         RNA_def_struct_ui_text(srna, "Main MetaBall", "Collection of metaballs");
792
793         func= RNA_def_function(srna, "new", "rna_Main_metaballs_new");
794         RNA_def_function_ui_description(func, "Add a new metaball to the main database");
795         parm= RNA_def_string(func, "name", "MetaBall", 0, "", "New name for the datablock.");
796         RNA_def_property_flag(parm, PROP_REQUIRED);
797         /* return type */
798         parm= RNA_def_pointer(func, "metaball", "MetaBall", "", "New metaball datablock.");
799         RNA_def_function_return(func, parm);
800
801         func= RNA_def_function(srna, "remove", "rna_Main_metaballs_remove");
802         RNA_def_function_flag(func, FUNC_USE_REPORTS);
803         RNA_def_function_ui_description(func, "Remove a metaball from the current blendfile.");
804         parm= RNA_def_pointer(func, "metaball", "MetaBall", "", "MetaBall to remove.");
805         RNA_def_property_flag(parm, PROP_REQUIRED);
806 }
807 void RNA_def_main_fonts(BlenderRNA *brna, PropertyRNA *cprop)
808 {
809         StructRNA *srna;
810         FunctionRNA *func;
811         PropertyRNA *parm;
812
813         RNA_def_property_srna(cprop, "MainFonts");
814         srna= RNA_def_struct(brna, "MainFonts", NULL);
815         RNA_def_struct_ui_text(srna, "Main Fonts", "Collection of fonts");
816
817         func= RNA_def_function(srna, "load", "rna_Main_fonts_load");
818         RNA_def_function_flag(func, FUNC_USE_REPORTS);
819         RNA_def_function_ui_description(func, "Load a new font into the main database");
820         parm= RNA_def_string(func, "filepath", "File Path", 0, "", "path of the font to load.");
821         RNA_def_property_flag(parm, PROP_REQUIRED);
822         /* return type */
823         parm= RNA_def_pointer(func, "vfont", "VectorFont", "", "New font datablock.");
824         RNA_def_function_return(func, parm);
825
826         func= RNA_def_function(srna, "remove", "rna_Main_fonts_remove");
827         RNA_def_function_flag(func, FUNC_USE_REPORTS);
828         RNA_def_function_ui_description(func, "Remove a font from the current blendfile.");
829         parm= RNA_def_pointer(func, "vfont", "VectorFont", "", "Font to remove.");
830         RNA_def_property_flag(parm, PROP_REQUIRED);
831 }
832 void RNA_def_main_textures(BlenderRNA *brna, PropertyRNA *cprop)
833 {
834         StructRNA *srna;
835         FunctionRNA *func;
836         PropertyRNA *parm;
837
838         RNA_def_property_srna(cprop, "MainTextures");
839         srna= RNA_def_struct(brna, "MainTextures", NULL);
840         RNA_def_struct_ui_text(srna, "Main Textures", "Collection of groups");
841
842         func= RNA_def_function(srna, "new", "rna_Main_textures_new");
843         RNA_def_function_ui_description(func, "Add a new texture to the main database");
844         parm= RNA_def_string(func, "name", "Texture", 0, "", "New name for the datablock.");
845         RNA_def_property_flag(parm, PROP_REQUIRED);
846         /* return type */
847         parm= RNA_def_pointer(func, "texture", "Texture", "", "New texture datablock.");
848         RNA_def_function_return(func, parm);
849
850         func= RNA_def_function(srna, "remove", "rna_Main_textures_remove");
851         RNA_def_function_flag(func, FUNC_USE_REPORTS);
852         RNA_def_function_ui_description(func, "Remove a texture from the current blendfile.");
853         parm= RNA_def_pointer(func, "texture", "Texture", "", "Texture to remove.");
854         RNA_def_property_flag(parm, PROP_REQUIRED);
855 }
856 void RNA_def_main_brushes(BlenderRNA *brna, PropertyRNA *cprop)
857 {
858         StructRNA *srna;
859         FunctionRNA *func;
860         PropertyRNA *parm;
861
862         RNA_def_property_srna(cprop, "MainBrushes");
863         srna= RNA_def_struct(brna, "MainBrushes", NULL);
864         RNA_def_struct_ui_text(srna, "Main Brushes", "Collection of brushes");
865
866         func= RNA_def_function(srna, "new", "rna_Main_brushes_new");
867         RNA_def_function_ui_description(func, "Add a new brush to the main database");
868         parm= RNA_def_string(func, "name", "Brush", 0, "", "New name for the datablock.");
869         RNA_def_property_flag(parm, PROP_REQUIRED);
870         /* return type */
871         parm= RNA_def_pointer(func, "brush", "Brush", "", "New brush datablock.");
872         RNA_def_function_return(func, parm);
873
874         func= RNA_def_function(srna, "remove", "rna_Main_brushes_remove");
875         RNA_def_function_flag(func, FUNC_USE_REPORTS);
876         RNA_def_function_ui_description(func, "Remove a brush from the current blendfile.");
877         parm= RNA_def_pointer(func, "brush", "Brush", "", "Brush to remove.");
878         RNA_def_property_flag(parm, PROP_REQUIRED);
879 }
880
881 void RNA_def_main_worlds(BlenderRNA *brna, PropertyRNA *cprop)
882 {
883         StructRNA *srna;
884         FunctionRNA *func;
885         PropertyRNA *parm;
886
887         RNA_def_property_srna(cprop, "MainWorlds");
888         srna= RNA_def_struct(brna, "MainWorlds", NULL);
889         RNA_def_struct_ui_text(srna, "Main Worlds", "Collection of worlds");
890
891         func= RNA_def_function(srna, "new", "rna_Main_worlds_new");
892         RNA_def_function_ui_description(func, "Add a new world to the main database");
893         parm= RNA_def_string(func, "name", "World", 0, "", "New name for the datablock.");
894         RNA_def_property_flag(parm, PROP_REQUIRED);
895         /* return type */
896         parm= RNA_def_pointer(func, "world", "World", "", "New world datablock.");
897         RNA_def_function_return(func, parm);
898
899         func= RNA_def_function(srna, "remove", "rna_Main_worlds_remove");
900         RNA_def_function_flag(func, FUNC_USE_REPORTS);
901         RNA_def_function_ui_description(func, "Remove a world from the current blendfile.");
902         parm= RNA_def_pointer(func, "world", "World", "", "World to remove.");
903         RNA_def_property_flag(parm, PROP_REQUIRED);
904 }
905
906 void RNA_def_main_groups(BlenderRNA *brna, PropertyRNA *cprop)
907 {
908         StructRNA *srna;
909         FunctionRNA *func;
910         PropertyRNA *parm;
911
912         RNA_def_property_srna(cprop, "MainGroups");
913         srna= RNA_def_struct(brna, "MainGroups", NULL);
914         RNA_def_struct_ui_text(srna, "Main Groups", "Collection of groups");
915
916         func= RNA_def_function(srna, "new", "rna_Main_groups_new");
917         RNA_def_function_ui_description(func, "Add a new group to the main database");
918         parm= RNA_def_string(func, "name", "Group", 0, "", "New name for the datablock.");
919         RNA_def_property_flag(parm, PROP_REQUIRED);
920         /* return type */
921         parm= RNA_def_pointer(func, "group", "Group", "", "New group datablock.");
922         RNA_def_function_return(func, parm);
923
924         func= RNA_def_function(srna, "remove", "rna_Main_groups_remove");
925         RNA_def_function_flag(func, FUNC_USE_REPORTS);
926         RNA_def_function_ui_description(func, "Remove a group from the current blendfile.");
927         parm= RNA_def_pointer(func, "group", "Group", "", "Group to remove.");
928         RNA_def_property_flag(parm, PROP_REQUIRED);
929 }
930 void RNA_def_main_texts(BlenderRNA *brna, PropertyRNA *cprop)
931 {
932         StructRNA *srna;
933         FunctionRNA *func;
934         PropertyRNA *parm;
935
936         RNA_def_property_srna(cprop, "MainTexts");
937         srna= RNA_def_struct(brna, "MainTexts", NULL);
938         RNA_def_struct_ui_text(srna, "Main Texts", "Collection of texts");
939
940         func= RNA_def_function(srna, "new", "rna_Main_texts_new");
941         RNA_def_function_ui_description(func, "Add a new text to the main database");
942         parm= RNA_def_string(func, "name", "Text", 0, "", "New name for the datablock.");
943         RNA_def_property_flag(parm, PROP_REQUIRED);
944         /* return type */
945         parm= RNA_def_pointer(func, "text", "Text", "", "New text datablock.");
946         RNA_def_function_return(func, parm);
947
948         func= RNA_def_function(srna, "remove", "rna_Main_texts_remove");
949         RNA_def_function_flag(func, FUNC_USE_REPORTS);
950         RNA_def_function_ui_description(func, "Remove a text from the current blendfile.");
951         parm= RNA_def_pointer(func, "text", "Text", "", "Text to remove.");
952         RNA_def_property_flag(parm, PROP_REQUIRED);
953
954         /* load func */
955         func= RNA_def_function(srna, "load", "rna_Main_texts_load");
956         RNA_def_function_flag(func, FUNC_USE_REPORTS);
957         RNA_def_function_ui_description(func, "Add a new text to the main database from a file");
958         parm= RNA_def_string(func, "filepath", "Path", FILE_MAXDIR + FILE_MAXFILE, "", "path for the datablock.");
959         RNA_def_property_flag(parm, PROP_REQUIRED);
960         /* return type */
961         parm= RNA_def_pointer(func, "text", "Text", "", "New text datablock.");
962         RNA_def_function_return(func, parm);
963 }
964 void RNA_def_main_sounds(BlenderRNA *brna, PropertyRNA *cprop)
965 {
966
967 }
968 void RNA_def_main_armatures(BlenderRNA *brna, PropertyRNA *cprop)
969 {
970         StructRNA *srna;
971         FunctionRNA *func;
972         PropertyRNA *parm;
973
974         RNA_def_property_srna(cprop, "MainArmatures");
975         srna= RNA_def_struct(brna, "MainArmatures", NULL);
976         RNA_def_struct_ui_text(srna, "Main Armatures", "Collection of armatures");
977
978         func= RNA_def_function(srna, "new", "rna_Main_armatures_new");
979         RNA_def_function_ui_description(func, "Add a new armature to the main database");
980         parm= RNA_def_string(func, "name", "Armature", 0, "", "New name for the datablock.");
981         RNA_def_property_flag(parm, PROP_REQUIRED);
982         /* return type */
983         parm= RNA_def_pointer(func, "armature", "Armature", "", "New armature datablock.");
984         RNA_def_function_return(func, parm);
985
986         func= RNA_def_function(srna, "remove", "rna_Main_armatures_remove");
987         RNA_def_function_flag(func, FUNC_USE_REPORTS);
988         RNA_def_function_ui_description(func, "Remove a armature from the current blendfile.");
989         parm= RNA_def_pointer(func, "armature", "Armature", "", "Armature to remove.");
990         RNA_def_property_flag(parm, PROP_REQUIRED);
991 }
992 void RNA_def_main_actions(BlenderRNA *brna, PropertyRNA *cprop)
993 {
994         StructRNA *srna;
995         FunctionRNA *func;
996         PropertyRNA *parm;
997
998         RNA_def_property_srna(cprop, "MainActions");
999         srna= RNA_def_struct(brna, "MainActions", NULL);
1000         RNA_def_struct_ui_text(srna, "Main Actions", "Collection of actions");
1001
1002         func= RNA_def_function(srna, "new", "rna_Main_actions_new");
1003         RNA_def_function_ui_description(func, "Add a new action to the main database");
1004         parm= RNA_def_string(func, "name", "Action", 0, "", "New name for the datablock.");
1005         RNA_def_property_flag(parm, PROP_REQUIRED);
1006         /* return type */
1007         parm= RNA_def_pointer(func, "action", "Action", "", "New action datablock.");
1008         RNA_def_function_return(func, parm);
1009
1010         func= RNA_def_function(srna, "remove", "rna_Main_actions_remove");
1011         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1012         RNA_def_function_ui_description(func, "Remove a action from the current blendfile.");
1013         parm= RNA_def_pointer(func, "action", "Action", "", "Action to remove.");
1014         RNA_def_property_flag(parm, PROP_REQUIRED);
1015 }
1016 void RNA_def_main_particles(BlenderRNA *brna, PropertyRNA *cprop)
1017 {
1018         StructRNA *srna;
1019         FunctionRNA *func;
1020         PropertyRNA *parm;
1021
1022         RNA_def_property_srna(cprop, "MainParticles");
1023         srna= RNA_def_struct(brna, "MainParticles", NULL);
1024         RNA_def_struct_ui_text(srna, "Main Particle Settings", "Collection of particle settings");
1025
1026         func= RNA_def_function(srna, "new", "rna_Main_particles_new");
1027         RNA_def_function_ui_description(func, "Add a new particle settings instance to the main database");
1028         parm= RNA_def_string(func, "name", "ParticleSettings", 0, "", "New name for the datablock.");
1029         RNA_def_property_flag(parm, PROP_REQUIRED);
1030         /* return type */
1031         parm= RNA_def_pointer(func, "particle", "ParticleSettings", "", "New particle settings datablock.");
1032         RNA_def_function_return(func, parm);
1033
1034         func= RNA_def_function(srna, "remove", "rna_Main_particles_remove");
1035         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1036         RNA_def_function_ui_description(func, "Remove a particle settings instance from the current blendfile.");
1037         parm= RNA_def_pointer(func, "particle", "ParticleSettings", "", "Particle Settings to remove.");
1038         RNA_def_property_flag(parm, PROP_REQUIRED);
1039 }
1040 void RNA_def_main_gpencil(BlenderRNA *brna, PropertyRNA *cprop)
1041 {
1042
1043 }
1044
1045 #endif
1046