Merge branch 'master' into blender2.8
[blender.git] / source / blender / makesrna / intern / rna_main_api.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  * The Original Code is Copyright (C) 2009 Blender Foundation.
19  * All rights reserved.
20  *
21  *
22  * Contributor(s): Blender Foundation
23  *
24  * ***** END GPL LICENSE BLOCK *****
25  */
26
27 /** \file blender/makesrna/intern/rna_main_api.c
28  *  \ingroup RNA
29  */
30
31
32 #include <stdlib.h>
33 #include <stdio.h>
34 #include <errno.h>
35
36 #include "DNA_ID.h"
37 #include "DNA_modifier_types.h"
38 #include "DNA_space_types.h"
39 #include "DNA_object_types.h"
40
41 #include "BLI_utildefines.h"
42 #include "BLI_path_util.h"
43
44 #include "RNA_define.h"
45 #include "RNA_access.h"
46 #include "RNA_enum_types.h"
47
48 #include "rna_internal.h"
49
50 #ifdef RNA_RUNTIME
51
52 #include "BKE_main.h"
53 #include "BKE_camera.h"
54 #include "BKE_collection.h"
55 #include "BKE_curve.h"
56 #include "BKE_DerivedMesh.h"
57 #include "BKE_displist.h"
58 #include "BKE_mesh.h"
59 #include "BKE_armature.h"
60 #include "BKE_lamp.h"
61 #include "BKE_library.h"
62 #include "BKE_library_remap.h"
63 #include "BKE_object.h"
64 #include "BKE_material.h"
65 #include "BKE_icons.h"
66 #include "BKE_idcode.h"
67 #include "BKE_image.h"
68 #include "BKE_texture.h"
69 #include "BKE_scene.h"
70 #include "BKE_sound.h"
71 #include "BKE_text.h"
72 #include "BKE_action.h"
73 #include "BKE_brush.h"
74 #include "BKE_lattice.h"
75 #include "BKE_mball.h"
76 #include "BKE_world.h"
77 #include "BKE_particle.h"
78 #include "BKE_paint.h"
79 #include "BKE_font.h"
80 #include "BKE_node.h"
81 #include "BKE_speaker.h"
82 #include "BKE_lightprobe.h"
83 #include "BKE_movieclip.h"
84 #include "BKE_mask.h"
85 #include "BKE_gpencil.h"
86 #include "BKE_linestyle.h"
87 #include "BKE_workspace.h"
88
89 #include "DEG_depsgraph_build.h"
90 #include "DEG_depsgraph_query.h"
91
92 #include "DNA_armature_types.h"
93 #include "DNA_camera_types.h"
94 #include "DNA_curve_types.h"
95 #include "DNA_lamp_types.h"
96 #include "DNA_material_types.h"
97 #include "DNA_mesh_types.h"
98 #include "DNA_speaker_types.h"
99 #include "DNA_sound_types.h"
100 #include "DNA_lightprobe_types.h"
101 #include "DNA_text_types.h"
102 #include "DNA_texture_types.h"
103 #include "DNA_group_types.h"
104 #include "DNA_brush_types.h"
105 #include "DNA_lattice_types.h"
106 #include "DNA_meta_types.h"
107 #include "DNA_world_types.h"
108 #include "DNA_particle_types.h"
109 #include "DNA_vfont_types.h"
110 #include "DNA_node_types.h"
111 #include "DNA_movieclip_types.h"
112 #include "DNA_mask_types.h"
113 #include "DNA_gpencil_types.h"
114
115 #include "ED_screen.h"
116
117 #include "BLT_translation.h"
118
119 #ifdef WITH_PYTHON
120 #  include "BPY_extern.h"
121 #endif
122
123 #include "WM_api.h"
124
125
126 static void rna_idname_validate(const char *name, char *r_name)
127 {
128         BLI_strncpy(r_name, name, MAX_ID_NAME - 2);
129         BLI_utf8_invalid_strip(r_name, strlen(r_name));
130 }
131
132
133 static void rna_Main_ID_remove(Main *bmain, ReportList *reports, PointerRNA *id_ptr,
134                                int do_unlink, int do_id_user, int do_ui_user)
135 {
136         ID *id = id_ptr->data;
137         if (do_unlink) {
138                 BKE_libblock_delete(bmain, id);
139                 RNA_POINTER_INVALIDATE(id_ptr);
140         }
141         else if (ID_REAL_USERS(id) <= 0) {
142                 BKE_libblock_free_ex(bmain, id, do_id_user, do_ui_user);
143                 RNA_POINTER_INVALIDATE(id_ptr);
144         }
145         else {
146                 BKE_reportf(reports, RPT_ERROR,
147                             "%s '%s' must have zero users to be removed, found %d (try with do_unlink=True parameter)",
148                             BKE_idcode_to_name(GS(id->name)), id->name + 2, ID_REAL_USERS(id));
149         }
150 }
151
152
153 static Camera *rna_Main_cameras_new(Main *bmain, const char *name)
154 {
155         char safe_name[MAX_ID_NAME - 2];
156         rna_idname_validate(name, safe_name);
157
158         ID *id = BKE_camera_add(bmain, safe_name);
159         id_us_min(id);
160         return (Camera *)id;
161 }
162
163 static Scene *rna_Main_scenes_new(Main *bmain, const char *name)
164 {
165         char safe_name[MAX_ID_NAME - 2];
166         rna_idname_validate(name, safe_name);
167
168         return BKE_scene_add(bmain, safe_name);
169 }
170 static void rna_Main_scenes_remove(Main *bmain, bContext *C, ReportList *reports, PointerRNA *scene_ptr, int do_unlink)
171 {
172         /* don't call BKE_libblock_free(...) directly */
173         Scene *scene = scene_ptr->data;
174         Scene *scene_new;
175
176         if ((scene_new = scene->id.prev) ||
177             (scene_new = scene->id.next))
178         {
179                 if (do_unlink) {
180                         wmWindow *win = CTX_wm_window(C);
181
182                         if (WM_window_get_active_scene(win) == scene) {
183
184 #ifdef WITH_PYTHON
185                                 BPy_BEGIN_ALLOW_THREADS;
186 #endif
187
188                                 WM_window_change_active_scene(bmain, C, win, scene_new);
189
190 #ifdef WITH_PYTHON
191                                 BPy_END_ALLOW_THREADS;
192 #endif
193
194                         }
195                 }
196                 rna_Main_ID_remove(bmain, reports, scene_ptr, do_unlink, true, true);
197         }
198         else {
199                 BKE_reportf(reports, RPT_ERROR, "Scene '%s' is the last, cannot be removed", scene->id.name + 2);
200         }
201 }
202
203 static Object *rna_Main_objects_new(Main *bmain, ReportList *reports, const char *name, ID *data)
204 {
205         char safe_name[MAX_ID_NAME - 2];
206         rna_idname_validate(name, safe_name);
207
208         Object *ob;
209         int type = OB_EMPTY;
210         if (data) {
211                 /* keep in sync with OB_DATA_SUPPORT_ID() macro */
212                 switch (GS(data->name)) {
213                         case ID_ME:
214                                 type = OB_MESH;
215                                 break;
216                         case ID_CU:
217                                 type = BKE_curve_type_get((Curve *)data);
218                                 break;
219                         case ID_MB:
220                                 type = OB_MBALL;
221                                 break;
222                         case ID_LA:
223                                 type = OB_LAMP;
224                                 break;
225                         case ID_SPK:
226                                 type = OB_SPEAKER;
227                                 break;
228                         case ID_CA:
229                                 type = OB_CAMERA;
230                                 break;
231                         case ID_LT:
232                                 type = OB_LATTICE;
233                                 break;
234                         case ID_AR:
235                                 type = OB_ARMATURE;
236                                 break;
237                         default:
238                         {
239                                 const char *idname;
240                                 if (RNA_enum_id_from_value(rna_enum_id_type_items, GS(data->name), &idname) == 0)
241                                         idname = "UNKNOWN";
242
243                                 BKE_reportf(reports, RPT_ERROR, "ID type '%s' is not valid for an object", idname);
244                                 return NULL;
245                         }
246                 }
247
248                 id_us_plus(data);
249         }
250
251         ob = BKE_object_add_only_object(bmain, type, safe_name);
252
253         ob->data = data;
254         test_object_materials(bmain, ob, ob->data);
255
256         return ob;
257 }
258
259 static Material *rna_Main_materials_new(Main *bmain, const char *name)
260 {
261         char safe_name[MAX_ID_NAME - 2];
262         rna_idname_validate(name, safe_name);
263
264         ID *id = (ID *)BKE_material_add(bmain, safe_name);
265         id_us_min(id);
266         return (Material *)id;
267 }
268
269 static const EnumPropertyItem *rna_Main_nodetree_type_itemf(bContext *UNUSED(C), PointerRNA *UNUSED(ptr), PropertyRNA *UNUSED(prop), bool *r_free)
270 {
271         return rna_node_tree_type_itemf(NULL, NULL, r_free);
272 }
273 static struct bNodeTree *rna_Main_nodetree_new(Main *bmain, const char *name, int type)
274 {
275         char safe_name[MAX_ID_NAME - 2];
276         rna_idname_validate(name, safe_name);
277
278         bNodeTreeType *typeinfo = rna_node_tree_type_from_enum(type);
279         if (typeinfo) {
280                 bNodeTree *ntree = ntreeAddTree(bmain, safe_name, typeinfo->idname);
281
282                 id_us_min(&ntree->id);
283                 return ntree;
284         }
285         else {
286                 return NULL;
287         }
288 }
289
290 static Mesh *rna_Main_meshes_new(Main *bmain, const char *name)
291 {
292         char safe_name[MAX_ID_NAME - 2];
293         rna_idname_validate(name, safe_name);
294
295         Mesh *me = BKE_mesh_add(bmain, safe_name);
296         id_us_min(&me->id);
297         return me;
298 }
299
300 /* copied from Mesh_getFromObject and adapted to RNA interface */
301 Mesh *rna_Main_meshes_new_from_object(
302         Main *bmain, ReportList *reports, Depsgraph *depsgraph,
303         Object *ob, int apply_modifiers, int calc_tessface, int calc_undeformed)
304 {
305         Scene *sce = DEG_get_evaluated_scene(depsgraph);
306
307         switch (ob->type) {
308                 case OB_FONT:
309                 case OB_CURVE:
310                 case OB_SURF:
311                 case OB_MBALL:
312                 case OB_MESH:
313                         break;
314                 default:
315                         BKE_report(reports, RPT_ERROR, "Object does not have geometry data");
316                         return NULL;
317         }
318
319         return BKE_mesh_new_from_object(depsgraph, bmain, sce, ob, apply_modifiers, calc_tessface, calc_undeformed);
320 }
321
322 static Lamp *rna_Main_lamps_new(Main *bmain, const char *name, int type)
323 {
324         char safe_name[MAX_ID_NAME - 2];
325         rna_idname_validate(name, safe_name);
326
327         Lamp *lamp = BKE_lamp_add(bmain, safe_name);
328         lamp->type = type;
329         id_us_min(&lamp->id);
330         return lamp;
331 }
332
333 static Image *rna_Main_images_new(Main *bmain, const char *name, int width, int height, int alpha, int float_buffer, int stereo3d)
334 {
335         char safe_name[MAX_ID_NAME - 2];
336         rna_idname_validate(name, safe_name);
337
338         float color[4] = {0.0, 0.0, 0.0, 1.0};
339         Image *image = BKE_image_add_generated(bmain, width, height, safe_name, alpha ? 32 : 24, float_buffer, 0, color, stereo3d);
340         id_us_min(&image->id);
341         return image;
342 }
343 static Image *rna_Main_images_load(Main *bmain, ReportList *reports, const char *filepath, int check_existing)
344 {
345         Image *ima;
346
347         errno = 0;
348         if (check_existing) {
349                 ima = BKE_image_load_exists(bmain, filepath);
350         }
351         else {
352                 ima = BKE_image_load(bmain, filepath);
353         }
354
355         if (!ima) {
356                 BKE_reportf(reports, RPT_ERROR, "Cannot read '%s': %s", filepath,
357                             errno ? strerror(errno) : TIP_("unsupported image format"));
358         }
359
360         id_us_min((ID *)ima);
361         return ima;
362 }
363
364 static Lattice *rna_Main_lattices_new(Main *bmain, const char *name)
365 {
366         char safe_name[MAX_ID_NAME - 2];
367         rna_idname_validate(name, safe_name);
368
369         Lattice *lt = BKE_lattice_add(bmain, safe_name);
370         id_us_min(&lt->id);
371         return lt;
372 }
373
374 static Curve *rna_Main_curves_new(Main *bmain, const char *name, int type)
375 {
376         char safe_name[MAX_ID_NAME - 2];
377         rna_idname_validate(name, safe_name);
378
379         Curve *cu = BKE_curve_add(bmain, safe_name, type);
380         id_us_min(&cu->id);
381         return cu;
382 }
383
384 static MetaBall *rna_Main_metaballs_new(Main *bmain, const char *name)
385 {
386         char safe_name[MAX_ID_NAME - 2];
387         rna_idname_validate(name, safe_name);
388
389         MetaBall *mb = BKE_mball_add(bmain, safe_name);
390         id_us_min(&mb->id);
391         return mb;
392 }
393
394 static VFont *rna_Main_fonts_load(Main *bmain, ReportList *reports, const char *filepath, int check_existing)
395 {
396         VFont *font;
397         errno = 0;
398
399         if (check_existing) {
400                 font = BKE_vfont_load_exists(bmain, filepath);
401         }
402         else {
403                 font = BKE_vfont_load(bmain, filepath);
404         }
405
406         if (!font)
407                 BKE_reportf(reports, RPT_ERROR, "Cannot read '%s': %s", filepath,
408                             errno ? strerror(errno) : TIP_("unsupported font format"));
409
410         id_us_min((ID *)font);
411         return font;
412
413 }
414
415 static Tex *rna_Main_textures_new(Main *bmain, const char *name, int type)
416 {
417         char safe_name[MAX_ID_NAME - 2];
418         rna_idname_validate(name, safe_name);
419
420         Tex *tex = BKE_texture_add(bmain, safe_name);
421         BKE_texture_type_set(tex, type);
422         id_us_min(&tex->id);
423         return tex;
424 }
425
426 static Brush *rna_Main_brushes_new(Main *bmain, const char *name, int mode)
427 {
428         char safe_name[MAX_ID_NAME - 2];
429         rna_idname_validate(name, safe_name);
430
431         Brush *brush = BKE_brush_add(bmain, safe_name, mode);
432         id_us_min(&brush->id);
433         return brush;
434 }
435
436 static World *rna_Main_worlds_new(Main *bmain, const char *name)
437 {
438         char safe_name[MAX_ID_NAME - 2];
439         rna_idname_validate(name, safe_name);
440
441         World *world = BKE_world_add(bmain, safe_name);
442         id_us_min(&world->id);
443         return world;
444 }
445
446 static Collection *rna_Main_collections_new(Main *bmain, const char *name)
447 {
448         char safe_name[MAX_ID_NAME - 2];
449         rna_idname_validate(name, safe_name);
450
451         return BKE_collection_add(bmain, NULL, safe_name);
452 }
453
454 static Speaker *rna_Main_speakers_new(Main *bmain, const char *name)
455 {
456         char safe_name[MAX_ID_NAME - 2];
457         rna_idname_validate(name, safe_name);
458
459         Speaker *speaker = BKE_speaker_add(bmain, safe_name);
460         id_us_min(&speaker->id);
461         return speaker;
462 }
463
464 static bSound *rna_Main_sounds_load(Main *bmain, const char *name, int check_existing)
465 {
466         bSound *sound;
467
468         if (check_existing) {
469                 sound = BKE_sound_new_file_exists(bmain, name);
470         }
471         else {
472                 sound = BKE_sound_new_file(bmain, name);
473         }
474
475         id_us_min(&sound->id);
476         return sound;
477 }
478
479 static Text *rna_Main_texts_new(Main *bmain, const char *name)
480 {
481         char safe_name[MAX_ID_NAME - 2];
482         rna_idname_validate(name, safe_name);
483
484         return BKE_text_add(bmain, safe_name);
485 }
486
487 static Text *rna_Main_texts_load(Main *bmain, ReportList *reports, const char *filepath, int is_internal)
488 {
489         Text *txt;
490
491         errno = 0;
492         txt = BKE_text_load_ex(bmain, filepath, BKE_main_blendfile_path(bmain), is_internal);
493
494         if (!txt)
495                 BKE_reportf(reports, RPT_ERROR, "Cannot read '%s': %s", filepath,
496                             errno ? strerror(errno) : TIP_("unable to load text"));
497
498         return txt;
499 }
500
501 static bArmature *rna_Main_armatures_new(Main *bmain, const char *name)
502 {
503         char safe_name[MAX_ID_NAME - 2];
504         rna_idname_validate(name, safe_name);
505
506         bArmature *arm = BKE_armature_add(bmain, safe_name);
507         id_us_min(&arm->id);
508         return arm;
509 }
510
511 static bAction *rna_Main_actions_new(Main *bmain, const char *name)
512 {
513         char safe_name[MAX_ID_NAME - 2];
514         rna_idname_validate(name, safe_name);
515
516         bAction *act = BKE_action_add(bmain, safe_name);
517         id_fake_user_clear(&act->id);
518         return act;
519 }
520
521 static ParticleSettings *rna_Main_particles_new(Main *bmain, const char *name)
522 {
523         char safe_name[MAX_ID_NAME - 2];
524         rna_idname_validate(name, safe_name);
525
526         ParticleSettings *part = BKE_particlesettings_add(bmain, safe_name);
527         id_us_min(&part->id);
528         return part;
529 }
530
531 static Palette *rna_Main_palettes_new(Main *bmain, const char *name)
532 {
533         char safe_name[MAX_ID_NAME - 2];
534         rna_idname_validate(name, safe_name);
535
536         Palette *palette = BKE_palette_add(bmain, safe_name);
537         id_us_min(&palette->id);
538         return (Palette *)palette;
539 }
540
541 static MovieClip *rna_Main_movieclip_load(Main *bmain, ReportList *reports, const char *filepath, int check_existing)
542 {
543         MovieClip *clip;
544
545         errno = 0;
546
547         if (check_existing) {
548                 clip = BKE_movieclip_file_add_exists(bmain, filepath);
549         }
550         else {
551                 clip = BKE_movieclip_file_add(bmain, filepath);
552         }
553
554         if (clip != NULL) {
555                 DEG_relations_tag_update(bmain);
556         }
557         else {
558                 BKE_reportf(reports, RPT_ERROR, "Cannot read '%s': %s", filepath,
559                             errno ? strerror(errno) : TIP_("unable to load movie clip"));
560         }
561
562         id_us_min((ID *)clip);
563         return clip;
564 }
565
566 static Mask *rna_Main_mask_new(Main *bmain, const char *name)
567 {
568         char safe_name[MAX_ID_NAME - 2];
569         rna_idname_validate(name, safe_name);
570
571         return BKE_mask_new(bmain, safe_name);
572 }
573
574 static FreestyleLineStyle *rna_Main_linestyles_new(Main *bmain, const char *name)
575 {
576         char safe_name[MAX_ID_NAME - 2];
577         rna_idname_validate(name, safe_name);
578
579         FreestyleLineStyle *linestyle = BKE_linestyle_new(bmain, safe_name);
580         id_us_min(&linestyle->id);
581         return linestyle;
582 }
583
584 static LightProbe *rna_Main_lightprobe_new(Main *bmain, const char *name)
585 {
586         char safe_name[MAX_ID_NAME - 2];
587         rna_idname_validate(name, safe_name);
588
589         LightProbe *probe = BKE_lightprobe_add(bmain, safe_name);
590         id_us_min(&probe->id);
591         return probe;
592 }
593
594 /* tag functions, all the same */
595 #define RNA_MAIN_ID_TAG_FUNCS_DEF(_func_name, _listbase_name, _id_type)            \
596         static void rna_Main_##_func_name##_tag(Main *bmain, int value) {              \
597                 BKE_main_id_tag_listbase(&bmain->_listbase_name, LIB_TAG_DOIT, value);     \
598         }                                                                              \
599
600 RNA_MAIN_ID_TAG_FUNCS_DEF(cameras, camera, ID_CA)
601 RNA_MAIN_ID_TAG_FUNCS_DEF(scenes, scene, ID_SCE)
602 RNA_MAIN_ID_TAG_FUNCS_DEF(objects, object, ID_OB)
603 RNA_MAIN_ID_TAG_FUNCS_DEF(materials, mat, ID_MA)
604 RNA_MAIN_ID_TAG_FUNCS_DEF(node_groups, nodetree, ID_NT)
605 RNA_MAIN_ID_TAG_FUNCS_DEF(meshes, mesh, ID_ME)
606 RNA_MAIN_ID_TAG_FUNCS_DEF(lamps, lamp, ID_LA)
607 RNA_MAIN_ID_TAG_FUNCS_DEF(libraries, library, ID_LI)
608 RNA_MAIN_ID_TAG_FUNCS_DEF(screens, screen, ID_SCR)
609 RNA_MAIN_ID_TAG_FUNCS_DEF(window_managers, wm, ID_WM)
610 RNA_MAIN_ID_TAG_FUNCS_DEF(images, image, ID_IM)
611 RNA_MAIN_ID_TAG_FUNCS_DEF(lattices, latt, ID_LT)
612 RNA_MAIN_ID_TAG_FUNCS_DEF(curves, curve, ID_CU)
613 RNA_MAIN_ID_TAG_FUNCS_DEF(metaballs, mball, ID_MB)
614 RNA_MAIN_ID_TAG_FUNCS_DEF(fonts, vfont, ID_VF)
615 RNA_MAIN_ID_TAG_FUNCS_DEF(textures, tex, ID_TE)
616 RNA_MAIN_ID_TAG_FUNCS_DEF(brushes, brush, ID_BR)
617 RNA_MAIN_ID_TAG_FUNCS_DEF(worlds, world, ID_WO)
618 RNA_MAIN_ID_TAG_FUNCS_DEF(collections, collection, ID_GR)
619 //RNA_MAIN_ID_TAG_FUNCS_DEF(shape_keys, key, ID_KE)
620 RNA_MAIN_ID_TAG_FUNCS_DEF(texts, text, ID_TXT)
621 RNA_MAIN_ID_TAG_FUNCS_DEF(speakers, speaker, ID_SPK)
622 RNA_MAIN_ID_TAG_FUNCS_DEF(sounds, sound, ID_SO)
623 RNA_MAIN_ID_TAG_FUNCS_DEF(armatures, armature, ID_AR)
624 RNA_MAIN_ID_TAG_FUNCS_DEF(actions, action, ID_AC)
625 RNA_MAIN_ID_TAG_FUNCS_DEF(particles, particle, ID_PA)
626 RNA_MAIN_ID_TAG_FUNCS_DEF(palettes, palettes, ID_PAL)
627 RNA_MAIN_ID_TAG_FUNCS_DEF(gpencil, gpencil, ID_GD)
628 RNA_MAIN_ID_TAG_FUNCS_DEF(movieclips, movieclip, ID_MC)
629 RNA_MAIN_ID_TAG_FUNCS_DEF(masks, mask, ID_MSK)
630 RNA_MAIN_ID_TAG_FUNCS_DEF(linestyle, linestyle, ID_LS)
631 RNA_MAIN_ID_TAG_FUNCS_DEF(cachefiles, cachefiles, ID_CF)
632 RNA_MAIN_ID_TAG_FUNCS_DEF(paintcurves, paintcurves, ID_PC)
633 RNA_MAIN_ID_TAG_FUNCS_DEF(workspaces, workspaces, ID_WS)
634 RNA_MAIN_ID_TAG_FUNCS_DEF(lightprobes, lightprobe, ID_LP)
635
636 #undef RNA_MAIN_ID_TAG_FUNCS_DEF
637
638 #else
639
640 void RNA_api_main(StructRNA *UNUSED(srna))
641 {
642 #if 0
643         FunctionRNA *func;
644         PropertyRNA *parm;
645
646         /* maybe we want to add functions in 'bpy.data' still?
647          * for now they are all in collections bpy.data.images.new(...) */
648         func = RNA_def_function(srna, "add_image", "rna_Main_add_image");
649         RNA_def_function_ui_description(func, "Add a new image");
650         parm = RNA_def_string_file_path(func, "filepath", NULL, 0, "", "File path to load image from");
651         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
652         parm = RNA_def_pointer(func, "image", "Image", "", "New image");
653         RNA_def_function_return(func, parm);
654 #endif
655 }
656
657 void RNA_def_main_cameras(BlenderRNA *brna, PropertyRNA *cprop)
658 {
659         StructRNA *srna;
660         FunctionRNA *func;
661         PropertyRNA *parm;
662
663         RNA_def_property_srna(cprop, "BlendDataCameras");
664         srna = RNA_def_struct(brna, "BlendDataCameras", NULL);
665         RNA_def_struct_sdna(srna, "Main");
666         RNA_def_struct_ui_text(srna, "Main Cameras", "Collection of cameras");
667
668         func = RNA_def_function(srna, "new", "rna_Main_cameras_new");
669         RNA_def_function_ui_description(func, "Add a new camera to the main database");
670         parm = RNA_def_string(func, "name", "Camera", 0, "", "New name for the data-block");
671         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
672         /* return type */
673         parm = RNA_def_pointer(func, "camera", "Camera", "", "New camera data-block");
674         RNA_def_function_return(func, parm);
675
676         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
677         RNA_def_function_flag(func, FUNC_USE_REPORTS);
678         RNA_def_function_ui_description(func, "Remove a camera from the current blendfile");
679         parm = RNA_def_pointer(func, "camera", "Camera", "", "Camera to remove");
680         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
681         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
682         RNA_def_boolean(func, "do_unlink", true, "",
683                         "Unlink all usages of this camera before deleting it "
684                         "(WARNING: will also delete objects instancing that camera data)");
685         RNA_def_boolean(func, "do_id_user", true, "",
686                         "Decrement user counter of all datablocks used by this camera");
687         RNA_def_boolean(func, "do_ui_user", true, "",
688                         "Make sure interface does not reference this camera");
689
690         func = RNA_def_function(srna, "tag", "rna_Main_cameras_tag");
691         parm = RNA_def_boolean(func, "value", 0, "Value", "");
692         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
693 }
694
695 void RNA_def_main_scenes(BlenderRNA *brna, PropertyRNA *cprop)
696 {
697         StructRNA *srna;
698         FunctionRNA *func;
699         PropertyRNA *parm;
700
701         RNA_def_property_srna(cprop, "BlendDataScenes");
702         srna = RNA_def_struct(brna, "BlendDataScenes", NULL);
703         RNA_def_struct_sdna(srna, "Main");
704         RNA_def_struct_ui_text(srna, "Main Scenes", "Collection of scenes");
705
706         func = RNA_def_function(srna, "new", "rna_Main_scenes_new");
707         RNA_def_function_ui_description(func, "Add a new scene to the main database");
708         parm = RNA_def_string(func, "name", "Scene", 0, "", "New name for the data-block");
709         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
710         /* return type */
711         parm = RNA_def_pointer(func, "scene", "Scene", "", "New scene data-block");
712         RNA_def_function_return(func, parm);
713
714         func = RNA_def_function(srna, "remove", "rna_Main_scenes_remove");
715         RNA_def_function_flag(func, FUNC_USE_CONTEXT | FUNC_USE_REPORTS);
716         RNA_def_function_ui_description(func, "Remove a scene from the current blendfile");
717         parm = RNA_def_pointer(func, "scene", "Scene", "", "Scene to remove");
718         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
719         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
720         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this scene before deleting it");
721
722         func = RNA_def_function(srna, "tag", "rna_Main_scenes_tag");
723         parm = RNA_def_boolean(func, "value", 0, "Value", "");
724         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
725 }
726
727 void RNA_def_main_objects(BlenderRNA *brna, PropertyRNA *cprop)
728 {
729         StructRNA *srna;
730         FunctionRNA *func;
731         PropertyRNA *parm;
732
733         RNA_def_property_srna(cprop, "BlendDataObjects");
734         srna = RNA_def_struct(brna, "BlendDataObjects", NULL);
735         RNA_def_struct_sdna(srna, "Main");
736         RNA_def_struct_ui_text(srna, "Main Objects", "Collection of objects");
737
738         func = RNA_def_function(srna, "new", "rna_Main_objects_new");
739         RNA_def_function_flag(func, FUNC_USE_REPORTS);
740         RNA_def_function_ui_description(func, "Add a new object to the main database");
741         parm = RNA_def_string(func, "name", "Object", 0, "", "New name for the data-block");
742         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
743         parm = RNA_def_pointer(func, "object_data", "ID", "", "Object data or None for an empty object");
744         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
745
746         /* return type */
747         parm = RNA_def_pointer(func, "object", "Object", "", "New object data-block");
748         RNA_def_function_return(func, parm);
749
750         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
751         RNA_def_function_ui_description(func, "Remove a object from the current blendfile");
752         RNA_def_function_flag(func, FUNC_USE_REPORTS);
753         parm = RNA_def_pointer(func, "object", "Object", "", "Object to remove");
754         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
755         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
756         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this object before deleting it");
757         RNA_def_boolean(func, "do_id_user", true, "",
758                         "Decrement user counter of all datablocks used by this object");
759         RNA_def_boolean(func, "do_ui_user", true, "",
760                         "Make sure interface does not reference this object");
761
762         func = RNA_def_function(srna, "tag", "rna_Main_objects_tag");
763         parm = RNA_def_boolean(func, "value", 0, "Value", "");
764         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
765 }
766
767 void RNA_def_main_materials(BlenderRNA *brna, PropertyRNA *cprop)
768 {
769         StructRNA *srna;
770         FunctionRNA *func;
771         PropertyRNA *parm;
772
773         RNA_def_property_srna(cprop, "BlendDataMaterials");
774         srna = RNA_def_struct(brna, "BlendDataMaterials", NULL);
775         RNA_def_struct_sdna(srna, "Main");
776         RNA_def_struct_ui_text(srna, "Main Materials", "Collection of materials");
777
778         func = RNA_def_function(srna, "new", "rna_Main_materials_new");
779         RNA_def_function_ui_description(func, "Add a new material to the main database");
780         parm = RNA_def_string(func, "name", "Material", 0, "", "New name for the data-block");
781         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
782         /* return type */
783         parm = RNA_def_pointer(func, "material", "Material", "", "New material data-block");
784         RNA_def_function_return(func, parm);
785
786         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
787         RNA_def_function_flag(func, FUNC_USE_REPORTS);
788         RNA_def_function_ui_description(func, "Remove a material from the current blendfile");
789         parm = RNA_def_pointer(func, "material", "Material", "", "Material to remove");
790         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
791         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
792         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this material before deleting it");
793         RNA_def_boolean(func, "do_id_user", true, "",
794                         "Decrement user counter of all datablocks used by this material");
795         RNA_def_boolean(func, "do_ui_user", true, "",
796                         "Make sure interface does not reference this material");
797
798         func = RNA_def_function(srna, "tag", "rna_Main_materials_tag");
799         parm = RNA_def_boolean(func, "value", 0, "Value", "");
800         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
801 }
802 void RNA_def_main_node_groups(BlenderRNA *brna, PropertyRNA *cprop)
803 {
804         StructRNA *srna;
805         FunctionRNA *func;
806         PropertyRNA *parm;
807
808         static const EnumPropertyItem dummy_items[] = {
809                 {0, "DUMMY", 0, "", ""},
810                 {0, NULL, 0, NULL, NULL}
811         };
812
813         RNA_def_property_srna(cprop, "BlendDataNodeTrees");
814         srna = RNA_def_struct(brna, "BlendDataNodeTrees", NULL);
815         RNA_def_struct_sdna(srna, "Main");
816         RNA_def_struct_ui_text(srna, "Main Node Trees", "Collection of node trees");
817
818         func = RNA_def_function(srna, "new", "rna_Main_nodetree_new");
819         RNA_def_function_ui_description(func, "Add a new node tree to the main database");
820         parm = RNA_def_string(func, "name", "NodeGroup", 0, "", "New name for the data-block");
821         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
822         parm = RNA_def_enum(func, "type", dummy_items, 0, "Type", "The type of node_group to add");
823         RNA_def_property_enum_funcs(parm, NULL, NULL, "rna_Main_nodetree_type_itemf");
824         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
825         /* return type */
826         parm = RNA_def_pointer(func, "tree", "NodeTree", "", "New node tree data-block");
827         RNA_def_function_return(func, parm);
828
829         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
830         RNA_def_function_flag(func, FUNC_USE_REPORTS);
831         RNA_def_function_ui_description(func, "Remove a node tree from the current blendfile");
832         parm = RNA_def_pointer(func, "tree", "NodeTree", "", "Node tree to remove");
833         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
834         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
835         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this node tree before deleting it");
836         RNA_def_boolean(func, "do_id_user", true, "",
837                         "Decrement user counter of all datablocks used by this node tree");
838         RNA_def_boolean(func, "do_ui_user", true, "",
839                         "Make sure interface does not reference this node tree");
840
841         func = RNA_def_function(srna, "tag", "rna_Main_node_groups_tag");
842         parm = RNA_def_boolean(func, "value", 0, "Value", "");
843         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
844 }
845 void RNA_def_main_meshes(BlenderRNA *brna, PropertyRNA *cprop)
846 {
847         StructRNA *srna;
848         FunctionRNA *func;
849         PropertyRNA *parm;
850
851         RNA_def_property_srna(cprop, "BlendDataMeshes");
852         srna = RNA_def_struct(brna, "BlendDataMeshes", NULL);
853         RNA_def_struct_sdna(srna, "Main");
854         RNA_def_struct_ui_text(srna, "Main Meshes", "Collection of meshes");
855
856         func = RNA_def_function(srna, "new", "rna_Main_meshes_new");
857         RNA_def_function_ui_description(func, "Add a new mesh to the main database");
858         parm = RNA_def_string(func, "name", "Mesh", 0, "", "New name for the data-block");
859         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
860         /* return type */
861         parm = RNA_def_pointer(func, "mesh", "Mesh", "", "New mesh data-block");
862         RNA_def_function_return(func, parm);
863
864         func = RNA_def_function(srna, "new_from_object", "rna_Main_meshes_new_from_object");
865         RNA_def_function_ui_description(func, "Add a new mesh created from object with modifiers applied");
866         RNA_def_function_flag(func, FUNC_USE_REPORTS);
867         parm = RNA_def_pointer(func, "depsgraph", "Depsgraph", "Dependency Graph", "Evaluated dependency graph within wich to evaluate modifiers");
868         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED);
869         parm = RNA_def_pointer(func, "object", "Object", "", "Object to create mesh from");
870         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED);
871         parm = RNA_def_boolean(func, "apply_modifiers", 0, "", "Apply modifiers");
872         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
873         RNA_def_boolean(func, "calc_tessface", true, "Calculate Tessellation", "Calculate tessellation faces");
874         RNA_def_boolean(func, "calc_undeformed", false, "Calculate Undeformed", "Calculate undeformed vertex coordinates");
875         parm = RNA_def_pointer(func, "mesh", "Mesh", "",
876                                "Mesh created from object, remove it if it is only used for export");
877         RNA_def_function_return(func, parm);
878
879         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
880         RNA_def_function_flag(func, FUNC_USE_REPORTS);
881         RNA_def_function_ui_description(func, "Remove a mesh from the current blendfile");
882         parm = RNA_def_pointer(func, "mesh", "Mesh", "", "Mesh to remove");
883         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
884         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
885         RNA_def_boolean(func, "do_unlink", true, "",
886                         "Unlink all usages of this mesh before deleting it "
887                         "(WARNING: will also delete objects instancing that mesh data)");
888         RNA_def_boolean(func, "do_id_user", true, "",
889                         "Decrement user counter of all datablocks used by this mesh data");
890         RNA_def_boolean(func, "do_ui_user", true, "",
891                         "Make sure interface does not reference this mesh data");
892
893         func = RNA_def_function(srna, "tag", "rna_Main_meshes_tag");
894         parm = RNA_def_boolean(func, "value", 0, "Value", "");
895         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
896 }
897 void RNA_def_main_lamps(BlenderRNA *brna, PropertyRNA *cprop)
898 {
899         StructRNA *srna;
900         FunctionRNA *func;
901         PropertyRNA *parm;
902
903         RNA_def_property_srna(cprop, "BlendDataLamps");
904         srna = RNA_def_struct(brna, "BlendDataLamps", NULL);
905         RNA_def_struct_sdna(srna, "Main");
906         RNA_def_struct_ui_text(srna, "Main Lamps", "Collection of lamps");
907
908         func = RNA_def_function(srna, "new", "rna_Main_lamps_new");
909         RNA_def_function_ui_description(func, "Add a new lamp to the main database");
910         parm = RNA_def_string(func, "name", "Lamp", 0, "", "New name for the data-block");
911         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
912         parm = RNA_def_enum(func, "type", rna_enum_lamp_type_items, 0, "Type", "The type of texture to add");
913         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
914         /* return type */
915         parm = RNA_def_pointer(func, "lamp", "Lamp", "", "New lamp data-block");
916         RNA_def_function_return(func, parm);
917
918         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
919         RNA_def_function_flag(func, FUNC_USE_REPORTS);
920         RNA_def_function_ui_description(func, "Remove a lamp from the current blendfile");
921         parm = RNA_def_pointer(func, "lamp", "Lamp", "", "Lamp to remove");
922         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
923         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
924         RNA_def_boolean(func, "do_unlink", true, "",
925                         "Unlink all usages of this lamp before deleting it "
926                         "(WARNING: will also delete objects instancing that lamp data)");
927         RNA_def_boolean(func, "do_id_user", true, "",
928                         "Decrement user counter of all datablocks used by this lamp data");
929         RNA_def_boolean(func, "do_ui_user", true, "",
930                         "Make sure interface does not reference this lamp data");
931
932         func = RNA_def_function(srna, "tag", "rna_Main_lamps_tag");
933         parm = RNA_def_boolean(func, "value", 0, "Value", "");
934         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
935 }
936
937 void RNA_def_main_libraries(BlenderRNA *brna, PropertyRNA *cprop)
938 {
939         StructRNA *srna;
940         FunctionRNA *func;
941         PropertyRNA *parm;
942
943         RNA_def_property_srna(cprop, "BlendDataLibraries");
944         srna = RNA_def_struct(brna, "BlendDataLibraries", NULL);
945         RNA_def_struct_sdna(srna, "Main");
946         RNA_def_struct_ui_text(srna, "Main Libraries", "Collection of libraries");
947
948         func = RNA_def_function(srna, "tag", "rna_Main_libraries_tag");
949         parm = RNA_def_boolean(func, "value", 0, "Value", "");
950         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
951 }
952
953 void RNA_def_main_screens(BlenderRNA *brna, PropertyRNA *cprop)
954 {
955         StructRNA *srna;
956         FunctionRNA *func;
957         PropertyRNA *parm;
958
959         RNA_def_property_srna(cprop, "BlendDataScreens");
960         srna = RNA_def_struct(brna, "BlendDataScreens", NULL);
961         RNA_def_struct_sdna(srna, "Main");
962         RNA_def_struct_ui_text(srna, "Main Screens", "Collection of screens");
963
964         func = RNA_def_function(srna, "tag", "rna_Main_screens_tag");
965         parm = RNA_def_boolean(func, "value", 0, "Value", "");
966         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
967 }
968
969 void RNA_def_main_window_managers(BlenderRNA *brna, PropertyRNA *cprop)
970 {
971         StructRNA *srna;
972         FunctionRNA *func;
973         PropertyRNA *parm;
974
975         RNA_def_property_srna(cprop, "BlendDataWindowManagers");
976         srna = RNA_def_struct(brna, "BlendDataWindowManagers", NULL);
977         RNA_def_struct_sdna(srna, "Main");
978         RNA_def_struct_ui_text(srna, "Main Window Managers", "Collection of window managers");
979
980         func = RNA_def_function(srna, "tag", "rna_Main_window_managers_tag");
981         parm = RNA_def_boolean(func, "value", 0, "Value", "");
982         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
983 }
984 void RNA_def_main_images(BlenderRNA *brna, PropertyRNA *cprop)
985 {
986         StructRNA *srna;
987         FunctionRNA *func;
988         PropertyRNA *parm;
989
990         RNA_def_property_srna(cprop, "BlendDataImages");
991         srna = RNA_def_struct(brna, "BlendDataImages", NULL);
992         RNA_def_struct_sdna(srna, "Main");
993         RNA_def_struct_ui_text(srna, "Main Images", "Collection of images");
994
995         func = RNA_def_function(srna, "new", "rna_Main_images_new");
996         RNA_def_function_ui_description(func, "Add a new image to the main database");
997         parm = RNA_def_string(func, "name", "Image", 0, "", "New name for the data-block");
998         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
999         parm = RNA_def_int(func, "width", 1024, 1, INT_MAX, "", "Width of the image", 1, INT_MAX);
1000         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1001         parm = RNA_def_int(func, "height", 1024, 1, INT_MAX, "", "Height of the image", 1, INT_MAX);
1002         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1003         RNA_def_boolean(func, "alpha", 0, "Alpha", "Use alpha channel");
1004         RNA_def_boolean(func, "float_buffer", 0, "Float Buffer", "Create an image with floating point color");
1005         RNA_def_boolean(func, "stereo3d", 0, "Stereo 3D", "Create left and right views");
1006         /* return type */
1007         parm = RNA_def_pointer(func, "image", "Image", "", "New image data-block");
1008         RNA_def_function_return(func, parm);
1009
1010         func = RNA_def_function(srna, "load", "rna_Main_images_load");
1011         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1012         RNA_def_function_ui_description(func, "Load a new image into the main database");
1013         parm = RNA_def_string_file_path(func, "filepath", "File Path", 0, "", "path of the file to load");
1014         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1015         RNA_def_boolean(func, "check_existing", false, "", "Using existing data-block if this file is already loaded");
1016         /* return type */
1017         parm = RNA_def_pointer(func, "image", "Image", "", "New image data-block");
1018         RNA_def_function_return(func, parm);
1019
1020         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1021         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1022         RNA_def_function_ui_description(func, "Remove an image from the current blendfile");
1023         parm = RNA_def_pointer(func, "image", "Image", "", "Image to remove");
1024         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1025         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1026         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this image before deleting it");
1027         RNA_def_boolean(func, "do_id_user", true, "",
1028                         "Decrement user counter of all datablocks used by this image");
1029         RNA_def_boolean(func, "do_ui_user", true, "",
1030                         "Make sure interface does not reference this image");
1031
1032         func = RNA_def_function(srna, "tag", "rna_Main_images_tag");
1033         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1034         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1035 }
1036
1037 void RNA_def_main_lattices(BlenderRNA *brna, PropertyRNA *cprop)
1038 {
1039         StructRNA *srna;
1040         FunctionRNA *func;
1041         PropertyRNA *parm;
1042
1043         RNA_def_property_srna(cprop, "BlendDataLattices");
1044         srna = RNA_def_struct(brna, "BlendDataLattices", NULL);
1045         RNA_def_struct_sdna(srna, "Main");
1046         RNA_def_struct_ui_text(srna, "Main Lattices", "Collection of lattices");
1047
1048         func = RNA_def_function(srna, "new", "rna_Main_lattices_new");
1049         RNA_def_function_ui_description(func, "Add a new lattice to the main database");
1050         parm = RNA_def_string(func, "name", "Lattice", 0, "", "New name for the data-block");
1051         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1052         /* return type */
1053         parm = RNA_def_pointer(func, "lattice", "Lattice", "", "New lattices data-block");
1054         RNA_def_function_return(func, parm);
1055
1056         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1057         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1058         RNA_def_function_ui_description(func, "Remove a lattice from the current blendfile");
1059         parm = RNA_def_pointer(func, "lattice", "Lattice", "", "Lattice to remove");
1060         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1061         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1062         RNA_def_boolean(func, "do_unlink", true, "",
1063                         "Unlink all usages of this lattice before deleting it "
1064                         "(WARNING: will also delete objects instancing that lattice data)");
1065         RNA_def_boolean(func, "do_id_user", true, "",
1066                         "Decrement user counter of all datablocks used by this lattice data");
1067         RNA_def_boolean(func, "do_ui_user", true, "",
1068                         "Make sure interface does not reference this lattice data");
1069
1070         func = RNA_def_function(srna, "tag", "rna_Main_lattices_tag");
1071         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1072         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1073 }
1074 void RNA_def_main_curves(BlenderRNA *brna, PropertyRNA *cprop)
1075 {
1076         StructRNA *srna;
1077         FunctionRNA *func;
1078         PropertyRNA *parm;
1079
1080         RNA_def_property_srna(cprop, "BlendDataCurves");
1081         srna = RNA_def_struct(brna, "BlendDataCurves", NULL);
1082         RNA_def_struct_sdna(srna, "Main");
1083         RNA_def_struct_ui_text(srna, "Main Curves", "Collection of curves");
1084
1085         func = RNA_def_function(srna, "new", "rna_Main_curves_new");
1086         RNA_def_function_ui_description(func, "Add a new curve to the main database");
1087         parm = RNA_def_string(func, "name", "Curve", 0, "", "New name for the data-block");
1088         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1089         parm = RNA_def_enum(func, "type", rna_enum_object_type_curve_items, 0, "Type", "The type of curve to add");
1090         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1091         /* return type */
1092         parm = RNA_def_pointer(func, "curve", "Curve", "", "New curve data-block");
1093         RNA_def_function_return(func, parm);
1094
1095         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1096         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1097         RNA_def_function_ui_description(func, "Remove a curve from the current blendfile");
1098         parm = RNA_def_pointer(func, "curve", "Curve", "", "Curve to remove");
1099         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1100         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1101         RNA_def_boolean(func, "do_unlink", true, "",
1102                         "Unlink all usages of this curve before deleting it "
1103                         "(WARNING: will also delete objects instancing that curve data)");
1104         RNA_def_boolean(func, "do_id_user", true, "",
1105                         "Decrement user counter of all datablocks used by this curve data");
1106         RNA_def_boolean(func, "do_ui_user", true, "",
1107                         "Make sure interface does not reference this curve data");
1108
1109         func = RNA_def_function(srna, "tag", "rna_Main_curves_tag");
1110         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1111         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1112 }
1113 void RNA_def_main_metaballs(BlenderRNA *brna, PropertyRNA *cprop)
1114 {
1115         StructRNA *srna;
1116         FunctionRNA *func;
1117         PropertyRNA *parm;
1118
1119         RNA_def_property_srna(cprop, "BlendDataMetaBalls");
1120         srna = RNA_def_struct(brna, "BlendDataMetaBalls", NULL);
1121         RNA_def_struct_sdna(srna, "Main");
1122         RNA_def_struct_ui_text(srna, "Main Metaballs", "Collection of metaballs");
1123
1124         func = RNA_def_function(srna, "new", "rna_Main_metaballs_new");
1125         RNA_def_function_ui_description(func, "Add a new metaball to the main database");
1126         parm = RNA_def_string(func, "name", "MetaBall", 0, "", "New name for the data-block");
1127         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1128         /* return type */
1129         parm = RNA_def_pointer(func, "metaball", "MetaBall", "", "New metaball data-block");
1130         RNA_def_function_return(func, parm);
1131
1132         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1133         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1134         RNA_def_function_ui_description(func, "Remove a metaball from the current blendfile");
1135         parm = RNA_def_pointer(func, "metaball", "MetaBall", "", "Metaball to remove");
1136         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1137         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1138         RNA_def_boolean(func, "do_unlink", true, "",
1139                         "Unlink all usages of this metaball before deleting it "
1140                         "(WARNING: will also delete objects instancing that metaball data)");
1141         RNA_def_boolean(func, "do_id_user", true, "",
1142                         "Decrement user counter of all datablocks used by this metaball data");
1143         RNA_def_boolean(func, "do_ui_user", true, "",
1144                         "Make sure interface does not reference this metaball data");
1145
1146         func = RNA_def_function(srna, "tag", "rna_Main_metaballs_tag");
1147         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1148         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1149 }
1150 void RNA_def_main_fonts(BlenderRNA *brna, PropertyRNA *cprop)
1151 {
1152         StructRNA *srna;
1153         FunctionRNA *func;
1154         PropertyRNA *parm;
1155
1156         RNA_def_property_srna(cprop, "BlendDataFonts");
1157         srna = RNA_def_struct(brna, "BlendDataFonts", NULL);
1158         RNA_def_struct_sdna(srna, "Main");
1159         RNA_def_struct_ui_text(srna, "Main Fonts", "Collection of fonts");
1160
1161         func = RNA_def_function(srna, "load", "rna_Main_fonts_load");
1162         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1163         RNA_def_function_ui_description(func, "Load a new font into the main database");
1164         parm = RNA_def_string_file_path(func, "filepath", "File Path", 0, "", "path of the font to load");
1165         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1166         RNA_def_boolean(func, "check_existing", false, "", "Using existing data-block if this file is already loaded");
1167         /* return type */
1168         parm = RNA_def_pointer(func, "vfont", "VectorFont", "", "New font data-block");
1169         RNA_def_function_return(func, parm);
1170
1171         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1172         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1173         RNA_def_function_ui_description(func, "Remove a font from the current blendfile");
1174         parm = RNA_def_pointer(func, "vfont", "VectorFont", "", "Font to remove");
1175         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1176         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1177         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this font before deleting it");
1178         RNA_def_boolean(func, "do_id_user", true, "",
1179                         "Decrement user counter of all datablocks used by this font");
1180         RNA_def_boolean(func, "do_ui_user", true, "",
1181                         "Make sure interface does not reference this font");
1182
1183         func = RNA_def_function(srna, "tag", "rna_Main_fonts_tag");
1184         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1185         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1186 }
1187 void RNA_def_main_textures(BlenderRNA *brna, PropertyRNA *cprop)
1188 {
1189         StructRNA *srna;
1190         FunctionRNA *func;
1191         PropertyRNA *parm;
1192
1193         RNA_def_property_srna(cprop, "BlendDataTextures");
1194         srna = RNA_def_struct(brna, "BlendDataTextures", NULL);
1195         RNA_def_struct_sdna(srna, "Main");
1196         RNA_def_struct_ui_text(srna, "Main Textures", "Collection of textures");
1197
1198         func = RNA_def_function(srna, "new", "rna_Main_textures_new");
1199         RNA_def_function_ui_description(func, "Add a new texture to the main database");
1200         parm = RNA_def_string(func, "name", "Texture", 0, "", "New name for the data-block");
1201         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1202         parm = RNA_def_enum(func, "type", rna_enum_texture_type_items, 0, "Type", "The type of texture to add");
1203         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1204         /* return type */
1205         parm = RNA_def_pointer(func, "texture", "Texture", "", "New texture data-block");
1206         RNA_def_function_return(func, parm);
1207
1208         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1209         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1210         RNA_def_function_ui_description(func, "Remove a texture from the current blendfile");
1211         parm = RNA_def_pointer(func, "texture", "Texture", "", "Texture to remove");
1212         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1213         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1214         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this texture before deleting it");
1215         RNA_def_boolean(func, "do_id_user", true, "",
1216                         "Decrement user counter of all datablocks used by this texture");
1217         RNA_def_boolean(func, "do_ui_user", true, "",
1218                         "Make sure interface does not reference this texture");
1219
1220         func = RNA_def_function(srna, "tag", "rna_Main_textures_tag");
1221         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1222         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1223 }
1224 void RNA_def_main_brushes(BlenderRNA *brna, PropertyRNA *cprop)
1225 {
1226         StructRNA *srna;
1227         FunctionRNA *func;
1228         PropertyRNA *parm;
1229
1230         RNA_def_property_srna(cprop, "BlendDataBrushes");
1231         srna = RNA_def_struct(brna, "BlendDataBrushes", NULL);
1232         RNA_def_struct_sdna(srna, "Main");
1233         RNA_def_struct_ui_text(srna, "Main Brushes", "Collection of brushes");
1234
1235         func = RNA_def_function(srna, "new", "rna_Main_brushes_new");
1236         RNA_def_function_ui_description(func, "Add a new brush to the main database");
1237         parm = RNA_def_string(func, "name", "Brush", 0, "", "New name for the data-block");
1238         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1239         parm = RNA_def_enum(func, "mode", rna_enum_object_mode_items, OB_MODE_TEXTURE_PAINT, "", "Paint Mode for the new brush");
1240         /* return type */
1241         parm = RNA_def_pointer(func, "brush", "Brush", "", "New brush data-block");
1242         RNA_def_function_return(func, parm);
1243
1244         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1245         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1246         RNA_def_function_ui_description(func, "Remove a brush from the current blendfile");
1247         parm = RNA_def_pointer(func, "brush", "Brush", "", "Brush to remove");
1248         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1249         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1250         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this brush before deleting it");
1251         RNA_def_boolean(func, "do_id_user", true, "",
1252                         "Decrement user counter of all datablocks used by this brush");
1253         RNA_def_boolean(func, "do_ui_user", true, "",
1254                         "Make sure interface does not reference this brush");
1255
1256         func = RNA_def_function(srna, "tag", "rna_Main_brushes_tag");
1257         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1258         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1259 }
1260
1261 void RNA_def_main_worlds(BlenderRNA *brna, PropertyRNA *cprop)
1262 {
1263         StructRNA *srna;
1264         FunctionRNA *func;
1265         PropertyRNA *parm;
1266
1267         RNA_def_property_srna(cprop, "BlendDataWorlds");
1268         srna = RNA_def_struct(brna, "BlendDataWorlds", NULL);
1269         RNA_def_struct_sdna(srna, "Main");
1270         RNA_def_struct_ui_text(srna, "Main Worlds", "Collection of worlds");
1271
1272         func = RNA_def_function(srna, "new", "rna_Main_worlds_new");
1273         RNA_def_function_ui_description(func, "Add a new world to the main database");
1274         parm = RNA_def_string(func, "name", "World", 0, "", "New name for the data-block");
1275         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1276         /* return type */
1277         parm = RNA_def_pointer(func, "world", "World", "", "New world data-block");
1278         RNA_def_function_return(func, parm);
1279
1280         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1281         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1282         RNA_def_function_ui_description(func, "Remove a world from the current blendfile");
1283         parm = RNA_def_pointer(func, "world", "World", "", "World to remove");
1284         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1285         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1286         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this world before deleting it");
1287         RNA_def_boolean(func, "do_id_user", true, "",
1288                         "Decrement user counter of all datablocks used by this world");
1289         RNA_def_boolean(func, "do_ui_user", true, "",
1290                         "Make sure interface does not reference this world");
1291
1292         func = RNA_def_function(srna, "tag", "rna_Main_worlds_tag");
1293         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1294         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1295 }
1296
1297 void RNA_def_main_collections(BlenderRNA *brna, PropertyRNA *cprop)
1298 {
1299         StructRNA *srna;
1300         FunctionRNA *func;
1301         PropertyRNA *parm;
1302
1303         RNA_def_property_srna(cprop, "BlendDataCollections");
1304         srna = RNA_def_struct(brna, "BlendDataCollections", NULL);
1305         RNA_def_struct_sdna(srna, "Main");
1306         RNA_def_struct_ui_text(srna, "Main Collections", "Collection of collections");
1307
1308         func = RNA_def_function(srna, "new", "rna_Main_collections_new");
1309         RNA_def_function_ui_description(func, "Add a new collection to the main database");
1310         parm = RNA_def_string(func, "name", "Collection", 0, "", "New name for the data-block");
1311         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1312         /* return type */
1313         parm = RNA_def_pointer(func, "collection", "Collection", "", "New collection data-block");
1314         RNA_def_function_return(func, parm);
1315
1316         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1317         RNA_def_function_ui_description(func, "Remove a collection from the current blendfile");
1318         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1319         parm = RNA_def_pointer(func, "collection", "Collection", "", "Collection to remove");
1320         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1321         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1322         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this collection before deleting it");
1323         RNA_def_boolean(func, "do_id_user", true, "",
1324                         "Decrement user counter of all datablocks used by this collection");
1325         RNA_def_boolean(func, "do_ui_user", true, "",
1326                         "Make sure interface does not reference this collection");
1327
1328         func = RNA_def_function(srna, "tag", "rna_Main_collections_tag");
1329         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1330         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1331 }
1332
1333 void RNA_def_main_speakers(BlenderRNA *brna, PropertyRNA *cprop)
1334 {
1335         StructRNA *srna;
1336         FunctionRNA *func;
1337         PropertyRNA *parm;
1338
1339         RNA_def_property_srna(cprop, "BlendDataSpeakers");
1340         srna = RNA_def_struct(brna, "BlendDataSpeakers", NULL);
1341         RNA_def_struct_sdna(srna, "Main");
1342         RNA_def_struct_ui_text(srna, "Main Speakers", "Collection of speakers");
1343
1344         func = RNA_def_function(srna, "new", "rna_Main_speakers_new");
1345         RNA_def_function_ui_description(func, "Add a new speaker to the main database");
1346         parm = RNA_def_string(func, "name", "Speaker", 0, "", "New name for the data-block");
1347         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1348         /* return type */
1349         parm = RNA_def_pointer(func, "speaker", "Speaker", "", "New speaker data-block");
1350         RNA_def_function_return(func, parm);
1351
1352         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1353         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1354         RNA_def_function_ui_description(func, "Remove a speaker from the current blendfile");
1355         parm = RNA_def_pointer(func, "speaker", "Speaker", "", "Speaker to remove");
1356         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1357         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1358         RNA_def_boolean(func, "do_unlink", true, "",
1359                         "Unlink all usages of this speaker before deleting it "
1360                         "(WARNING: will also delete objects instancing that speaker data)");
1361         RNA_def_boolean(func, "do_id_user", true, "",
1362                         "Decrement user counter of all datablocks used by this speaker data");
1363         RNA_def_boolean(func, "do_ui_user", true, "",
1364                         "Make sure interface does not reference this speaker data");
1365
1366         func = RNA_def_function(srna, "tag", "rna_Main_speakers_tag");
1367         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1368         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1369 }
1370
1371 void RNA_def_main_texts(BlenderRNA *brna, PropertyRNA *cprop)
1372 {
1373         StructRNA *srna;
1374         FunctionRNA *func;
1375         PropertyRNA *parm;
1376
1377         RNA_def_property_srna(cprop, "BlendDataTexts");
1378         srna = RNA_def_struct(brna, "BlendDataTexts", NULL);
1379         RNA_def_struct_sdna(srna, "Main");
1380         RNA_def_struct_ui_text(srna, "Main Texts", "Collection of texts");
1381
1382         func = RNA_def_function(srna, "new", "rna_Main_texts_new");
1383         RNA_def_function_ui_description(func, "Add a new text to the main database");
1384         parm = RNA_def_string(func, "name", "Text", 0, "", "New name for the data-block");
1385         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1386         /* return type */
1387         parm = RNA_def_pointer(func, "text", "Text", "", "New text data-block");
1388         RNA_def_function_return(func, parm);
1389
1390         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1391         RNA_def_function_ui_description(func, "Remove a text from the current blendfile");
1392         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1393         parm = RNA_def_pointer(func, "text", "Text", "", "Text to remove");
1394         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1395         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1396         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this text before deleting it");
1397         RNA_def_boolean(func, "do_id_user", true, "",
1398                         "Decrement user counter of all datablocks used by this text");
1399         RNA_def_boolean(func, "do_ui_user", true, "",
1400                         "Make sure interface does not reference this text");
1401
1402         /* load func */
1403         func = RNA_def_function(srna, "load", "rna_Main_texts_load");
1404         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1405         RNA_def_function_ui_description(func, "Add a new text to the main database from a file");
1406         parm = RNA_def_string_file_path(func, "filepath", "Path", FILE_MAX, "", "path for the data-block");
1407         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1408         parm = RNA_def_boolean(func, "internal", 0, "Make internal", "Make text file internal after loading");
1409         /* return type */
1410         parm = RNA_def_pointer(func, "text", "Text", "", "New text data-block");
1411         RNA_def_function_return(func, parm);
1412
1413         func = RNA_def_function(srna, "tag", "rna_Main_texts_tag");
1414         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1415         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1416 }
1417
1418 void RNA_def_main_sounds(BlenderRNA *brna, PropertyRNA *cprop)
1419 {
1420         StructRNA *srna;
1421         FunctionRNA *func;
1422         PropertyRNA *parm;
1423
1424         RNA_def_property_srna(cprop, "BlendDataSounds");
1425         srna = RNA_def_struct(brna, "BlendDataSounds", NULL);
1426         RNA_def_struct_sdna(srna, "Main");
1427         RNA_def_struct_ui_text(srna, "Main Sounds", "Collection of sounds");
1428
1429         /* load func */
1430         func = RNA_def_function(srna, "load", "rna_Main_sounds_load");
1431         RNA_def_function_ui_description(func, "Add a new sound to the main database from a file");
1432         parm = RNA_def_string_file_path(func, "filepath", "Path", FILE_MAX, "", "path for the data-block");
1433         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1434         RNA_def_boolean(func, "check_existing", false, "", "Using existing data-block if this file is already loaded");
1435         /* return type */
1436         parm = RNA_def_pointer(func, "sound", "Sound", "", "New text data-block");
1437         RNA_def_function_return(func, parm);
1438
1439         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1440         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1441         RNA_def_function_ui_description(func, "Remove a sound from the current blendfile");
1442         parm = RNA_def_pointer(func, "sound", "Sound", "", "Sound to remove");
1443         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1444         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1445         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this sound before deleting it");
1446         RNA_def_boolean(func, "do_id_user", true, "",
1447                         "Decrement user counter of all datablocks used by this sound");
1448         RNA_def_boolean(func, "do_ui_user", true, "",
1449                         "Make sure interface does not reference this sound");
1450
1451         func = RNA_def_function(srna, "tag", "rna_Main_sounds_tag");
1452         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1453         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1454 }
1455
1456 void RNA_def_main_armatures(BlenderRNA *brna, PropertyRNA *cprop)
1457 {
1458         StructRNA *srna;
1459         FunctionRNA *func;
1460         PropertyRNA *parm;
1461
1462         RNA_def_property_srna(cprop, "BlendDataArmatures");
1463         srna = RNA_def_struct(brna, "BlendDataArmatures", NULL);
1464         RNA_def_struct_sdna(srna, "Main");
1465         RNA_def_struct_ui_text(srna, "Main Armatures", "Collection of armatures");
1466
1467         func = RNA_def_function(srna, "new", "rna_Main_armatures_new");
1468         RNA_def_function_ui_description(func, "Add a new armature to the main database");
1469         parm = RNA_def_string(func, "name", "Armature", 0, "", "New name for the data-block");
1470         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1471         /* return type */
1472         parm = RNA_def_pointer(func, "armature", "Armature", "", "New armature data-block");
1473         RNA_def_function_return(func, parm);
1474
1475         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1476         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1477         RNA_def_function_ui_description(func, "Remove a armature from the current blendfile");
1478         parm = RNA_def_pointer(func, "armature", "Armature", "", "Armature to remove");
1479         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1480         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1481         RNA_def_boolean(func, "do_unlink", true, "",
1482                         "Unlink all usages of this armature before deleting it "
1483                         "(WARNING: will also delete objects instancing that armature data)");
1484         RNA_def_boolean(func, "do_id_user", true, "",
1485                         "Decrement user counter of all datablocks used by this armature data");
1486         RNA_def_boolean(func, "do_ui_user", true, "",
1487                         "Make sure interface does not reference this armature data");
1488
1489         func = RNA_def_function(srna, "tag", "rna_Main_armatures_tag");
1490         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1491         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1492 }
1493 void RNA_def_main_actions(BlenderRNA *brna, PropertyRNA *cprop)
1494 {
1495         StructRNA *srna;
1496         FunctionRNA *func;
1497         PropertyRNA *parm;
1498
1499         RNA_def_property_srna(cprop, "BlendDataActions");
1500         srna = RNA_def_struct(brna, "BlendDataActions", NULL);
1501         RNA_def_struct_sdna(srna, "Main");
1502         RNA_def_struct_ui_text(srna, "Main Actions", "Collection of actions");
1503
1504         func = RNA_def_function(srna, "new", "rna_Main_actions_new");
1505         RNA_def_function_ui_description(func, "Add a new action to the main database");
1506         parm = RNA_def_string(func, "name", "Action", 0, "", "New name for the data-block");
1507         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1508         /* return type */
1509         parm = RNA_def_pointer(func, "action", "Action", "", "New action data-block");
1510         RNA_def_function_return(func, parm);
1511
1512         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1513         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1514         RNA_def_function_ui_description(func, "Remove a action from the current blendfile");
1515         parm = RNA_def_pointer(func, "action", "Action", "", "Action to remove");
1516         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1517         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1518         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this action before deleting it");
1519         RNA_def_boolean(func, "do_id_user", true, "",
1520                         "Decrement user counter of all datablocks used by this action");
1521         RNA_def_boolean(func, "do_ui_user", true, "",
1522                         "Make sure interface does not reference this action");
1523
1524         func = RNA_def_function(srna, "tag", "rna_Main_actions_tag");
1525         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1526         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1527 }
1528 void RNA_def_main_particles(BlenderRNA *brna, PropertyRNA *cprop)
1529 {
1530         StructRNA *srna;
1531         FunctionRNA *func;
1532         PropertyRNA *parm;
1533
1534         RNA_def_property_srna(cprop, "BlendDataParticles");
1535         srna = RNA_def_struct(brna, "BlendDataParticles", NULL);
1536         RNA_def_struct_sdna(srna, "Main");
1537         RNA_def_struct_ui_text(srna, "Main Particle Settings", "Collection of particle settings");
1538
1539         func = RNA_def_function(srna, "new", "rna_Main_particles_new");
1540         RNA_def_function_ui_description(func, "Add a new particle settings instance to the main database");
1541         parm = RNA_def_string(func, "name", "ParticleSettings", 0, "", "New name for the data-block");
1542         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1543         /* return type */
1544         parm = RNA_def_pointer(func, "particle", "ParticleSettings", "", "New particle settings data-block");
1545         RNA_def_function_return(func, parm);
1546
1547         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1548         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1549         RNA_def_function_ui_description(func, "Remove a particle settings instance from the current blendfile");
1550         parm = RNA_def_pointer(func, "particle", "ParticleSettings", "", "Particle Settings to remove");
1551         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1552         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1553         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of those particle settings before deleting them");
1554         RNA_def_boolean(func, "do_id_user", true, "",
1555                         "Decrement user counter of all datablocks used by this particle settings");
1556         RNA_def_boolean(func, "do_ui_user", true, "",
1557                         "Make sure interface does not reference this particle settings");
1558
1559         func = RNA_def_function(srna, "tag", "rna_Main_particles_tag");
1560         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1561         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1562 }
1563
1564 void RNA_def_main_palettes(BlenderRNA *brna, PropertyRNA *cprop)
1565 {
1566         StructRNA *srna;
1567         FunctionRNA *func;
1568         PropertyRNA *parm;
1569
1570         RNA_def_property_srna(cprop, "BlendDataPalettes");
1571         srna = RNA_def_struct(brna, "BlendDataPalettes", NULL);
1572         RNA_def_struct_sdna(srna, "Main");
1573         RNA_def_struct_ui_text(srna, "Main Palettes", "Collection of palettes");
1574
1575         func = RNA_def_function(srna, "new", "rna_Main_palettes_new");
1576         RNA_def_function_ui_description(func, "Add a new palette to the main database");
1577         parm = RNA_def_string(func, "name", "Palette", 0, "", "New name for the data-block");
1578         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1579         /* return type */
1580         parm = RNA_def_pointer(func, "palette", "Palette", "", "New palette data-block");
1581         RNA_def_function_return(func, parm);
1582
1583         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1584         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1585         RNA_def_function_ui_description(func, "Remove a palette from the current blendfile");
1586         parm = RNA_def_pointer(func, "palette", "Palette", "", "Palette to remove");
1587         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1588         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1589         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this palette before deleting it");
1590         RNA_def_boolean(func, "do_id_user", true, "",
1591                         "Decrement user counter of all datablocks used by this palette");
1592         RNA_def_boolean(func, "do_ui_user", true, "",
1593                         "Make sure interface does not reference this palette");
1594
1595         func = RNA_def_function(srna, "tag", "rna_Main_palettes_tag");
1596         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1597         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1598 }
1599 void RNA_def_main_cachefiles(BlenderRNA *brna, PropertyRNA *cprop)
1600 {
1601         StructRNA *srna;
1602         FunctionRNA *func;
1603         PropertyRNA *parm;
1604
1605         RNA_def_property_srna(cprop, "BlendDataCacheFiles");
1606         srna = RNA_def_struct(brna, "BlendDataCacheFiles", NULL);
1607         RNA_def_struct_sdna(srna, "Main");
1608         RNA_def_struct_ui_text(srna, "Main Cache Files", "Collection of cache files");
1609
1610         func = RNA_def_function(srna, "tag", "rna_Main_cachefiles_tag");
1611         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1612         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1613 }
1614 void RNA_def_main_paintcurves(BlenderRNA *brna, PropertyRNA *cprop)
1615 {
1616         StructRNA *srna;
1617         FunctionRNA *func;
1618         PropertyRNA *parm;
1619
1620         RNA_def_property_srna(cprop, "BlendDataPaintCurves");
1621         srna = RNA_def_struct(brna, "BlendDataPaintCurves", NULL);
1622         RNA_def_struct_sdna(srna, "Main");
1623         RNA_def_struct_ui_text(srna, "Main Paint Curves", "Collection of paint curves");
1624
1625         func = RNA_def_function(srna, "tag", "rna_Main_paintcurves_tag");
1626         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1627         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1628 }
1629 void RNA_def_main_gpencil(BlenderRNA *brna, PropertyRNA *cprop)
1630 {
1631         StructRNA *srna;
1632         FunctionRNA *func;
1633         PropertyRNA *parm;
1634
1635         RNA_def_property_srna(cprop, "BlendDataGreasePencils");
1636         srna = RNA_def_struct(brna, "BlendDataGreasePencils", NULL);
1637         RNA_def_struct_sdna(srna, "Main");
1638         RNA_def_struct_ui_text(srna, "Main Grease Pencils", "Collection of grease pencils");
1639
1640         func = RNA_def_function(srna, "tag", "rna_Main_gpencil_tag");
1641         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1642         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1643
1644         func = RNA_def_function(srna, "new", "BKE_gpencil_data_addnew");
1645         RNA_def_function_flag(func, FUNC_NO_SELF);
1646         parm = RNA_def_string(func, "name", "GreasePencil", 0, "", "New name for the data-block");
1647         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1648         /* return type */
1649         parm = RNA_def_pointer(func, "grease_pencil", "GreasePencil", "", "New grease pencil data-block");
1650         RNA_def_function_return(func, parm);
1651
1652         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1653         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1654         RNA_def_function_ui_description(func, "Remove a grease pencil instance from the current blendfile");
1655         parm = RNA_def_pointer(func, "grease_pencil", "GreasePencil", "", "Grease Pencil to remove");
1656         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1657         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1658         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this grease pencil before deleting it");
1659         RNA_def_boolean(func, "do_id_user", true, "",
1660                         "Decrement user counter of all datablocks used by this grease pencil");
1661         RNA_def_boolean(func, "do_ui_user", true, "",
1662                         "Make sure interface does not reference this grease pencil");
1663 }
1664
1665 void RNA_def_main_movieclips(BlenderRNA *brna, PropertyRNA *cprop)
1666 {
1667         StructRNA *srna;
1668         FunctionRNA *func;
1669         PropertyRNA *parm;
1670
1671         RNA_def_property_srna(cprop, "BlendDataMovieClips");
1672         srna = RNA_def_struct(brna, "BlendDataMovieClips", NULL);
1673         RNA_def_struct_sdna(srna, "Main");
1674         RNA_def_struct_ui_text(srna, "Main Movie Clips", "Collection of movie clips");
1675
1676         func = RNA_def_function(srna, "tag", "rna_Main_movieclips_tag");
1677         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1678         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1679
1680         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1681         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1682         RNA_def_function_ui_description(func, "Remove a movie clip from the current blendfile.");
1683         parm = RNA_def_pointer(func, "clip", "MovieClip", "", "Movie clip to remove");
1684         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1685         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1686         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this movie clip before deleting it");
1687         RNA_def_boolean(func, "do_id_user", true, "",
1688                         "Decrement user counter of all datablocks used by this movie clip");
1689         RNA_def_boolean(func, "do_ui_user", true, "",
1690                         "Make sure interface does not reference this movie clip");
1691
1692         /* load func */
1693         func = RNA_def_function(srna, "load", "rna_Main_movieclip_load");
1694         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1695         RNA_def_function_ui_description(
1696                 func, "Add a new movie clip to the main database from a file "
1697                 "(while ``check_existing`` is disabled for consistency with other load functions, "
1698                 "behavior with multiple movie-clips using the same file may incorrectly generate proxies)");
1699         parm = RNA_def_string_file_path(func, "filepath", "Path", FILE_MAX, "", "path for the data-block");
1700         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1701         RNA_def_boolean(func, "check_existing", false, "", "Using existing data-block if this file is already loaded");
1702         /* return type */
1703         parm = RNA_def_pointer(func, "clip", "MovieClip", "", "New movie clip data-block");
1704         RNA_def_function_return(func, parm);
1705 }
1706
1707 void RNA_def_main_masks(BlenderRNA *brna, PropertyRNA *cprop)
1708 {
1709         StructRNA *srna;
1710         FunctionRNA *func;
1711         PropertyRNA *parm;
1712
1713         RNA_def_property_srna(cprop, "BlendDataMasks");
1714         srna = RNA_def_struct(brna, "BlendDataMasks", NULL);
1715         RNA_def_struct_sdna(srna, "Main");
1716         RNA_def_struct_ui_text(srna, "Main Masks", "Collection of masks");
1717
1718         func = RNA_def_function(srna, "tag", "rna_Main_masks_tag");
1719         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1720         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1721
1722         /* new func */
1723         func = RNA_def_function(srna, "new", "rna_Main_mask_new");
1724         RNA_def_function_ui_description(func, "Add a new mask with a given name to the main database");
1725         RNA_def_string_file_path(func, "name", NULL, MAX_ID_NAME - 2, "Mask", "Name of new mask data-block");
1726         /* return type */
1727         parm = RNA_def_pointer(func, "mask", "Mask", "", "New mask data-block");
1728         RNA_def_function_return(func, parm);
1729
1730         /* remove func */
1731         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1732         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1733         RNA_def_function_ui_description(func, "Remove a masks from the current blendfile.");
1734         parm = RNA_def_pointer(func, "mask", "Mask", "", "Mask to remove");
1735         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1736         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1737         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this mask before deleting it");
1738         RNA_def_boolean(func, "do_id_user", true, "",
1739                         "Decrement user counter of all datablocks used by this mask");
1740         RNA_def_boolean(func, "do_ui_user", true, "",
1741                         "Make sure interface does not reference this mask");
1742 }
1743
1744 void RNA_def_main_linestyles(BlenderRNA *brna, PropertyRNA *cprop)
1745 {
1746         StructRNA *srna;
1747         FunctionRNA *func;
1748         PropertyRNA *parm;
1749
1750         RNA_def_property_srna(cprop, "BlendDataLineStyles");
1751         srna = RNA_def_struct(brna, "BlendDataLineStyles", NULL);
1752         RNA_def_struct_sdna(srna, "Main");
1753         RNA_def_struct_ui_text(srna, "Main Line Styles", "Collection of line styles");
1754
1755         func = RNA_def_function(srna, "tag", "rna_Main_linestyle_tag");
1756         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1757         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1758
1759         func = RNA_def_function(srna, "new", "rna_Main_linestyles_new");
1760         RNA_def_function_ui_description(func, "Add a new line style instance to the main database");
1761         parm = RNA_def_string(func, "name", "FreestyleLineStyle", 0, "", "New name for the data-block");
1762         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1763         /* return type */
1764         parm = RNA_def_pointer(func, "linestyle", "FreestyleLineStyle", "", "New line style data-block");
1765         RNA_def_function_return(func, parm);
1766
1767         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1768         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1769         RNA_def_function_ui_description(func, "Remove a line style instance from the current blendfile");
1770         parm = RNA_def_pointer(func, "linestyle", "FreestyleLineStyle", "", "Line style to remove");
1771         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1772         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1773         RNA_def_boolean(func, "do_unlink", true, "", "Unlink all usages of this line style before deleting it");
1774         RNA_def_boolean(func, "do_id_user", true, "",
1775                         "Decrement user counter of all datablocks used by this line style");
1776         RNA_def_boolean(func, "do_ui_user", true, "",
1777                         "Make sure interface does not reference this line style");
1778 }
1779
1780 void RNA_def_main_workspaces(BlenderRNA *brna, PropertyRNA *cprop)
1781 {
1782         StructRNA *srna;
1783         FunctionRNA *func;
1784         PropertyRNA *parm;
1785
1786         RNA_def_property_srna(cprop, "BlendDataWorkSpaces");
1787         srna = RNA_def_struct(brna, "BlendDataWorkSpaces", NULL);
1788         RNA_def_struct_sdna(srna, "Main");
1789         RNA_def_struct_ui_text(srna, "Main Workspaces", "Collection of workspaces");
1790
1791         func = RNA_def_function(srna, "tag", "rna_Main_workspaces_tag");
1792         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1793         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1794 }
1795
1796 void RNA_def_main_lightprobes(BlenderRNA *brna, PropertyRNA *cprop)
1797 {
1798         StructRNA *srna;
1799         FunctionRNA *func;
1800         PropertyRNA *parm;
1801
1802         RNA_def_property_srna(cprop, "BlendDataProbes");
1803         srna = RNA_def_struct(brna, "BlendDataProbes", NULL);
1804         RNA_def_struct_sdna(srna, "Main");
1805         RNA_def_struct_ui_text(srna, "Main Light Probes", "Collection of light probes");
1806
1807         func = RNA_def_function(srna, "new", "rna_Main_lightprobe_new");
1808         RNA_def_function_ui_description(func, "Add a new probe to the main database");
1809         parm = RNA_def_string(func, "name", "Probe", 0, "", "New name for the data-block");
1810         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1811         /* return type */
1812         parm = RNA_def_pointer(func, "lightprobe", "LightProbe", "", "New light probe data-block");
1813         RNA_def_function_return(func, parm);
1814
1815         func = RNA_def_function(srna, "remove", "rna_Main_ID_remove");
1816         RNA_def_function_flag(func, FUNC_USE_REPORTS);
1817         RNA_def_function_ui_description(func, "Remove a probe from the current blendfile");
1818         parm = RNA_def_pointer(func, "lightprobe", "LightProbe", "", "Probe to remove");
1819         RNA_def_parameter_flags(parm, PROP_NEVER_NULL, PARM_REQUIRED | PARM_RNAPTR);
1820         RNA_def_parameter_clear_flags(parm, PROP_THICK_WRAP, 0);
1821         RNA_def_boolean(func, "do_unlink", true, "",
1822                         "Unlink all usages of this probe before deleting it "
1823                         "(WARNING: will also delete objects instancing that light probe data)");
1824         RNA_def_boolean(func, "do_id_user", true, "",
1825                         "Decrement user counter of all datablocks used by this light probe");
1826         RNA_def_boolean(func, "do_ui_user", true, "",
1827                         "Make sure interface does not reference this light probe");
1828
1829         func = RNA_def_function(srna, "tag", "rna_Main_lightprobes_tag");
1830         parm = RNA_def_boolean(func, "value", 0, "Value", "");
1831         RNA_def_parameter_flags(parm, 0, PARM_REQUIRED);
1832 }
1833
1834 #endif