Manual merge of soc-2009-kazanbas branch:
[blender.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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, 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
32 #include "RNA_define.h"
33 #include "RNA_types.h"
34
35 #include "DNA_object_types.h"
36 #include "DNA_material_types.h"
37 #include "DNA_mesh_types.h"
38
39 #ifdef RNA_RUNTIME
40
41 #include "BKE_main.h"
42 #include "BKE_mesh.h"
43 #include "BKE_library.h"
44 #include "BKE_object.h"
45 #include "BKE_material.h"
46 #include "BKE_image.h"
47 #include "BKE_texture.h"
48
49 #include "DNA_lamp_types.h"
50
51 static Mesh *rna_Main_add_mesh(Main *main, char *name)
52 {
53         Mesh *me= add_mesh(name);
54         me->id.us--;
55         return me;
56 }
57
58 static void rna_Main_remove_mesh(Main *main, ReportList *reports, Mesh *me)
59 {
60         if(me->id.us == 0)
61                 free_libblock(&main->mesh, me);
62         else
63                 BKE_report(reports, RPT_ERROR, "Mesh must have zero users to be removed.");
64         
65         /* XXX python now has invalid pointer? */
66 }
67
68 static Lamp *rna_Main_add_lamp(Main *main, char *name)
69 {
70         Lamp *la= add_lamp(name);
71         la->id.us--;
72         return la;
73 }
74
75 /*
76 static void rna_Main_remove_lamp(Main *main, ReportList *reports, Lamp *la)
77 {
78         if(la->id.us == 0)
79                 free_libblock(&main->lamp, la);
80         else
81                 BKE_report(reports, RPT_ERROR, "Lamp must have zero users to be removed.");
82 }
83 */
84
85 static Object* rna_Main_add_object(Main *main, int type, char *name)
86 {
87         Object *ob= add_only_object(type, name);
88         ob->id.us--;
89         return ob;
90 }
91
92 /*
93   NOTE: the following example shows when this function should _not_ be called
94
95   ob = bpy.data.add_object()
96   scene.add_object(ob)
97
98   # ob is freed here
99   scene.remove_object(ob)
100
101   # don't do this since ob is already freed!
102   bpy.data.remove_object(ob)
103 */
104 static void rna_Main_remove_object(Main *main, ReportList *reports, Object *ob)
105 {
106         if(ob->id.us == 0)
107                 free_libblock(&main->object, ob);
108         else
109                 BKE_report(reports, RPT_ERROR, "Object must have zero users to be removed.");
110 }
111
112 static Material *rna_Main_add_material(Main *main, char *name)
113 {
114         return add_material(name);
115 }
116
117 /* TODO: remove material? */
118
119 struct Tex *rna_Main_add_texture(Main *main, char *name)
120 {
121         return add_texture(name);
122 }
123
124 /* TODO: remove texture? */
125
126 struct Image *rna_Main_add_image(Main *main, char *filename)
127 {
128         return BKE_add_image_file(filename, 0);
129 }
130
131 #else
132
133 void RNA_api_main(StructRNA *srna)
134 {
135         FunctionRNA *func;
136         PropertyRNA *parm;
137
138         /* copied from rna_def_object */
139         static EnumPropertyItem object_type_items[] = {
140                 {OB_EMPTY, "EMPTY", 0, "Empty", ""},
141                 {OB_MESH, "MESH", 0, "Mesh", ""},
142                 {OB_CURVE, "CURVE", 0, "Curve", ""},
143                 {OB_SURF, "SURFACE", 0, "Surface", ""},
144                 {OB_FONT, "TEXT", 0, "Text", ""},
145                 {OB_MBALL, "META", 0, "Meta", ""},
146                 {OB_LAMP, "LAMP", 0, "Lamp", ""},
147                 {OB_CAMERA, "CAMERA", 0, "Camera", ""},
148                 {OB_WAVE, "WAVE", 0, "Wave", ""},
149                 {OB_LATTICE, "LATTICE", 0, "Lattice", ""},
150                 {OB_ARMATURE, "ARMATURE", 0, "Armature", ""},
151                 {0, NULL, 0, NULL, NULL}};
152
153         func= RNA_def_function(srna, "add_object", "rna_Main_add_object");
154         RNA_def_function_ui_description(func, "Add a new object.");
155         parm= RNA_def_enum(func, "type", object_type_items, 0, "", "Type of Object.");
156         RNA_def_property_flag(parm, PROP_REQUIRED);
157         parm= RNA_def_string(func, "name", "Object", 0, "", "New name for the datablock.");
158         RNA_def_property_flag(parm, PROP_REQUIRED);
159         parm= RNA_def_pointer(func, "object", "Object", "", "New object.");
160         RNA_def_function_return(func, parm);
161
162         func= RNA_def_function(srna, "remove_object", "rna_Main_remove_object");
163         RNA_def_function_flag(func, FUNC_USE_REPORTS);
164         RNA_def_function_ui_description(func, "Remove an object if it has zero users.");
165         parm= RNA_def_pointer(func, "object", "Object", "", "Object to remove.");
166         RNA_def_property_flag(parm, PROP_REQUIRED);
167
168         func= RNA_def_function(srna, "add_mesh", "rna_Main_add_mesh");
169         RNA_def_function_ui_description(func, "Add a new mesh.");
170         parm= RNA_def_string(func, "name", "Mesh", 0, "", "New name for the datablock.");
171         RNA_def_property_flag(parm, PROP_REQUIRED);
172         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "New mesh.");
173         RNA_def_function_return(func, parm);
174
175         func= RNA_def_function(srna, "remove_mesh", "rna_Main_remove_mesh");
176         RNA_def_function_flag(func, FUNC_USE_REPORTS);
177         RNA_def_function_ui_description(func, "Remove a mesh if it has zero users.");
178         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "Mesh to remove.");
179         RNA_def_property_flag(parm, PROP_REQUIRED);
180
181         func= RNA_def_function(srna, "add_lamp", "rna_Main_add_lamp");
182         RNA_def_function_ui_description(func, "Add a new lamp.");
183         parm= RNA_def_string(func, "name", "Lamp", 0, "", "New name for the datablock.");
184         RNA_def_property_flag(parm, PROP_REQUIRED);
185         parm= RNA_def_pointer(func, "mesh", "Lamp", "", "New lamp.");
186         RNA_def_function_return(func, parm);
187
188         func= RNA_def_function(srna, "add_material", "rna_Main_add_material");
189         RNA_def_function_ui_description(func, "Add a new material.");
190         parm= RNA_def_string(func, "name", "Material", 0, "", "New name for the datablock."); /* optional */
191         parm= RNA_def_pointer(func, "material", "Material", "", "New material.");
192         RNA_def_function_return(func, parm);
193
194         func= RNA_def_function(srna, "add_texture", "rna_Main_add_texture");
195         RNA_def_function_ui_description(func, "Add a new texture.");
196         parm= RNA_def_string(func, "name", "Tex", 0, "", "New name for the datablock."); /* optional */
197         parm= RNA_def_pointer(func, "texture", "Texture", "", "New texture.");
198         RNA_def_function_return(func, parm);
199
200         func= RNA_def_function(srna, "add_image", "rna_Main_add_image");
201         RNA_def_function_ui_description(func, "Add a new image.");
202         parm= RNA_def_string(func, "filename", "", 0, "", "Filename to load image from.");
203         RNA_def_property_flag(parm, PROP_REQUIRED);
204         parm= RNA_def_pointer(func, "image", "Image", "", "New image.");
205         RNA_def_function_return(func, parm);
206
207 }
208
209 #endif
210