clone and stencil layer access added, renamed mask to stencil layer internally
[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 #include "RNA_enum_types.h"
35
36 #ifdef RNA_RUNTIME
37
38 #include "BKE_main.h"
39 #include "BKE_mesh.h"
40 #include "BKE_armature.h"
41 #include "BKE_library.h"
42 #include "BKE_object.h"
43 #include "BKE_material.h"
44 #include "BKE_image.h"
45 #include "BKE_texture.h"
46
47 #include "DNA_armature_types.h"
48 #include "DNA_lamp_types.h"
49 #include "DNA_material_types.h"
50 #include "DNA_mesh_types.h"
51 #include "DNA_object_types.h"
52
53 static Mesh *rna_Main_add_mesh(Main *bmain, char *name)
54 {
55         Mesh *me= add_mesh(name);
56         me->id.us--;
57         return me;
58 }
59
60 static void rna_Main_remove_mesh(Main *bmain, ReportList *reports, Mesh *me)
61 {
62         if(me->id.us == 0)
63                 free_libblock(&bmain->mesh, me);
64         else
65                 BKE_report(reports, RPT_ERROR, "Mesh must have zero users to be removed.");
66         
67         /* XXX python now has invalid pointer? */
68 }
69
70 static void rna_Main_remove_armature(Main *bmain, ReportList *reports, bArmature *arm)
71 {
72         if(arm->id.us == 0)
73                 free_libblock(&bmain->armature, arm);
74         else
75                 BKE_report(reports, RPT_ERROR, "Armature must have zero users to be removed.");
76
77         /* XXX python now has invalid pointer? */
78 }
79
80 static bArmature *rna_Main_add_armature(Main *bmain, char *name)
81 {
82         bArmature *arm= add_armature(name);
83         arm->id.us--;
84         return arm;
85 }
86
87 static Lamp *rna_Main_add_lamp(Main *bmain, char *name)
88 {
89         Lamp *la= add_lamp(name);
90         la->id.us--;
91         return la;
92 }
93
94 /*
95 static void rna_Main_remove_lamp(Main *bmain, ReportList *reports, Lamp *la)
96 {
97         if(la->id.us == 0)
98                 free_libblock(&main->lamp, la);
99         else
100                 BKE_report(reports, RPT_ERROR, "Lamp must have zero users to be removed.");
101 }
102 */
103
104 static Object* rna_Main_add_object(Main *bmain, int type, char *name)
105 {
106         Object *ob= add_only_object(type, name);
107         ob->id.us--;
108         return ob;
109 }
110
111 /*
112   NOTE: the following example shows when this function should _not_ be called
113
114   ob = bpy.data.add_object()
115   scene.add_object(ob)
116
117   # ob is freed here
118   scene.remove_object(ob)
119
120   # don't do this since ob is already freed!
121   bpy.data.remove_object(ob)
122 */
123 static void rna_Main_remove_object(Main *bmain, ReportList *reports, Object *ob)
124 {
125         if(ob->id.us == 0)
126                 free_libblock(&bmain->object, ob);
127         else
128                 BKE_report(reports, RPT_ERROR, "Object must have zero users to be removed.");
129 }
130
131 static Material *rna_Main_add_material(Main *bmain, char *name)
132 {
133         return add_material(name);
134 }
135
136 /* TODO: remove material? */
137
138 struct Tex *rna_Main_add_texture(Main *bmain, char *name)
139 {
140         return add_texture(name);
141 }
142
143 /* TODO: remove texture? */
144
145 struct Image *rna_Main_add_image(Main *bmain, char *filename)
146 {
147         return BKE_add_image_file(filename, 0);
148 }
149
150 #else
151
152 void RNA_api_main(StructRNA *srna)
153 {
154         FunctionRNA *func;
155         PropertyRNA *parm;
156
157         func= RNA_def_function(srna, "add_object", "rna_Main_add_object");
158         RNA_def_function_ui_description(func, "Add a new object.");
159         parm= RNA_def_enum(func, "type", object_type_items, 0, "", "Type of Object.");
160         RNA_def_property_flag(parm, PROP_REQUIRED);
161         parm= RNA_def_string(func, "name", "Object", 0, "", "New name for the datablock.");
162         RNA_def_property_flag(parm, PROP_REQUIRED);
163         parm= RNA_def_pointer(func, "object", "Object", "", "New object.");
164         RNA_def_function_return(func, parm);
165
166         func= RNA_def_function(srna, "remove_object", "rna_Main_remove_object");
167         RNA_def_function_flag(func, FUNC_USE_REPORTS);
168         RNA_def_function_ui_description(func, "Remove an object if it has zero users.");
169         parm= RNA_def_pointer(func, "object", "Object", "", "Object to remove.");
170         RNA_def_property_flag(parm, PROP_REQUIRED);
171
172         func= RNA_def_function(srna, "add_mesh", "rna_Main_add_mesh");
173         RNA_def_function_ui_description(func, "Add a new mesh.");
174         parm= RNA_def_string(func, "name", "Mesh", 0, "", "New name for the datablock.");
175         RNA_def_property_flag(parm, PROP_REQUIRED);
176         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "New mesh.");
177         RNA_def_function_return(func, parm);
178
179         func= RNA_def_function(srna, "remove_mesh", "rna_Main_remove_mesh");
180         RNA_def_function_flag(func, FUNC_USE_REPORTS);
181         RNA_def_function_ui_description(func, "Remove a mesh if it has zero users.");
182         parm= RNA_def_pointer(func, "mesh", "Mesh", "", "Mesh to remove.");
183         RNA_def_property_flag(parm, PROP_REQUIRED);
184
185         func= RNA_def_function(srna, "add_armature", "rna_Main_add_armature");
186         RNA_def_function_ui_description(func, "Add a new armature.");
187         parm= RNA_def_string(func, "name", "Armature", 0, "", "New name for the datablock.");
188         RNA_def_property_flag(parm, PROP_REQUIRED);
189         parm= RNA_def_pointer(func, "armature", "Armature", "", "New armature.");
190         RNA_def_function_return(func, parm);
191
192         func= RNA_def_function(srna, "remove_armature", "rna_Main_remove_armature");
193         RNA_def_function_flag(func, FUNC_USE_REPORTS);
194         RNA_def_function_ui_description(func, "Remove an armature if it has zero users.");
195         parm= RNA_def_pointer(func, "armature", "Armature", "", "Armature to remove.");
196         RNA_def_property_flag(parm, PROP_REQUIRED);
197
198         func= RNA_def_function(srna, "add_lamp", "rna_Main_add_lamp");
199         RNA_def_function_ui_description(func, "Add a new lamp.");
200         parm= RNA_def_string(func, "name", "Lamp", 0, "", "New name for the datablock.");
201         RNA_def_property_flag(parm, PROP_REQUIRED);
202         parm= RNA_def_pointer(func, "mesh", "Lamp", "", "New lamp.");
203         RNA_def_function_return(func, parm);
204
205         func= RNA_def_function(srna, "add_material", "rna_Main_add_material");
206         RNA_def_function_ui_description(func, "Add a new material.");
207         parm= RNA_def_string(func, "name", "Material", 0, "", "New name for the datablock."); /* optional */
208         parm= RNA_def_pointer(func, "material", "Material", "", "New material.");
209         RNA_def_function_return(func, parm);
210
211         func= RNA_def_function(srna, "add_texture", "rna_Main_add_texture");
212         RNA_def_function_ui_description(func, "Add a new texture.");
213         parm= RNA_def_string(func, "name", "Tex", 0, "", "New name for the datablock."); /* optional */
214         parm= RNA_def_pointer(func, "texture", "Texture", "", "New texture.");
215         RNA_def_function_return(func, parm);
216
217         func= RNA_def_function(srna, "add_image", "rna_Main_add_image");
218         RNA_def_function_ui_description(func, "Add a new image.");
219         parm= RNA_def_string(func, "filename", "", 0, "", "Filename to load image from.");
220         RNA_def_property_flag(parm, PROP_REQUIRED);
221         parm= RNA_def_pointer(func, "image", "Image", "", "New image.");
222         RNA_def_function_return(func, parm);
223
224 }
225
226 #endif
227