remove unused rna includes
[blender.git] / source / blender / makesrna / intern / rna_brush.c
1 /**
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * Contributor(s): Blender Foundation (2008), Juho Veps�l�inen
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <stdlib.h>
26
27 #include "RNA_define.h"
28
29 #include "rna_internal.h"
30
31 #include "DNA_brush_types.h"
32 #include "DNA_texture_types.h"
33
34 #include "BLI_math.h"
35
36 #include "IMB_imbuf.h"
37
38 #include "WM_types.h"
39
40 #ifdef RNA_RUNTIME
41
42 #include "MEM_guardedalloc.h"
43
44 #include "BKE_texture.h"
45
46 #include "WM_api.h"
47
48 static void rna_Brush_update(Main *bmain, Scene *scene, PointerRNA *ptr)
49 {
50         Brush *br= (Brush*)ptr->data;
51         WM_main_add_notifier(NC_BRUSH|NA_EDITED, br);
52 }
53
54 #else
55
56 static void rna_def_brush_texture_slot(BlenderRNA *brna)
57 {
58         StructRNA *srna;
59         PropertyRNA *prop;
60
61         static EnumPropertyItem prop_map_mode_items[] = {
62                 {MTEX_MAP_MODE_FIXED, "FIXED", 0, "Fixed", ""},
63                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
64                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
65                 {0, NULL, 0, NULL, NULL}};
66
67         srna= RNA_def_struct(brna, "BrushTextureSlot", "TextureSlot");
68         RNA_def_struct_sdna(srna, "MTex");
69         RNA_def_struct_ui_text(srna, "Brush Texture Slot", "Texture slot for textures in a Brush datablock");
70
71         prop= RNA_def_property(srna, "angle", PROP_FLOAT, PROP_ANGLE);
72         RNA_def_property_float_sdna(prop, NULL, "rot");
73         RNA_def_property_range(prop, 0, M_PI*2);
74         RNA_def_property_ui_text(prop, "Angle", "Defines brush texture rotation");
75         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
76
77         prop= RNA_def_property(srna, "map_mode", PROP_ENUM, PROP_NONE);
78         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
79         RNA_def_property_enum_items(prop, prop_map_mode_items);
80         RNA_def_property_ui_text(prop, "Mode", "");
81         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
82 }
83
84 static void rna_def_brush(BlenderRNA *brna)
85 {
86         StructRNA *srna;
87         PropertyRNA *prop;
88         
89         static EnumPropertyItem prop_blend_items[] = {
90                 {IMB_BLEND_MIX, "MIX", 0, "Mix", "Use mix blending mode while painting"},
91                 {IMB_BLEND_ADD, "ADD", 0, "Add", "Use add blending mode while painting"},
92                 {IMB_BLEND_SUB, "SUB", 0, "Subtract", "Use subtract blending mode while painting"},
93                 {IMB_BLEND_MUL, "MUL", 0, "Multiply", "Use multiply blending mode while painting"},
94                 {IMB_BLEND_LIGHTEN, "LIGHTEN", 0, "Lighten", "Use lighten blending mode while painting"},
95                 {IMB_BLEND_DARKEN, "DARKEN", 0, "Darken", "Use darken blending mode while painting"},
96                 {IMB_BLEND_ERASE_ALPHA, "ERASE_ALPHA", 0, "Erase Alpha", "Erase alpha while painting"},
97                 {IMB_BLEND_ADD_ALPHA, "ADD_ALPHA", 0, "Add Alpha", "Add alpha while painting"},
98                 {0, NULL, 0, NULL, NULL}};
99         
100         static EnumPropertyItem brush_sculpt_tool_items[] = {
101                 {SCULPT_TOOL_DRAW, "DRAW", 0, "Draw", ""},
102                 {SCULPT_TOOL_SMOOTH, "SMOOTH", 0, "Smooth", ""},
103                 {SCULPT_TOOL_PINCH, "PINCH", 0, "Pinch", ""},
104                 {SCULPT_TOOL_INFLATE, "INFLATE", 0, "Inflate", ""},
105                 {SCULPT_TOOL_GRAB, "GRAB", 0, "Grab", ""},
106                 {SCULPT_TOOL_LAYER, "LAYER", 0, "Layer", ""},
107                 {SCULPT_TOOL_FLATTEN, "FLATTEN", 0, "Flatten", ""},
108                 {SCULPT_TOOL_CLAY, "CLAY", 0, "Clay", ""},
109                 {0, NULL, 0, NULL, NULL}};
110         
111         static EnumPropertyItem brush_vertexpaint_tool_items[] = {
112                 {0, "MIX", 0, "Mix", "Use mix blending mode while painting"},
113                 {1, "ADD", 0, "Add", "Use add blending mode while painting"},
114                 {2, "SUB", 0, "Subtract", "Use subtract blending mode while painting"},
115                 {3, "MUL", 0, "Multiply", "Use multiply blending mode while painting"},
116                 {4, "BLUR", 0, "Blur", "Blur the color with surrounding values"},
117                 {5, "LIGHTEN", 0, "Lighten", "Use lighten blending mode while painting"},
118                 {6, "DARKEN", 0, "Darken", "Use darken blending mode while painting"},
119                 {0, NULL, 0, NULL, NULL}};
120         
121         static EnumPropertyItem brush_imagepaint_tool_items[] = {
122                 {PAINT_TOOL_DRAW, "DRAW", 0, "Draw", ""},
123                 {PAINT_TOOL_SOFTEN, "SOFTEN", 0, "Soften", ""},
124                 {PAINT_TOOL_SMEAR, "SMEAR", 0, "Smear", ""},
125                 {PAINT_TOOL_CLONE, "CLONE", 0, "Clone", ""},
126                 {0, NULL, 0, NULL, NULL}};
127         
128         static const EnumPropertyItem prop_flip_direction_items[]= {
129                 {0, "ADD", 0, "Add", "Add effect of brush"},
130                 {BRUSH_DIR_IN, "SUBTRACT", 0, "Subtract", "Subtract effect of brush"},
131                 {0, NULL, 0, NULL, NULL}};
132                 
133         srna= RNA_def_struct(brna, "Brush", "ID");
134         RNA_def_struct_ui_text(srna, "Brush", "Brush datablock for storing brush settings for painting and sculpting");
135         RNA_def_struct_ui_icon(srna, ICON_BRUSH_DATA);
136         
137         /* enums */
138         prop= RNA_def_property(srna, "blend", PROP_ENUM, PROP_NONE);
139         RNA_def_property_enum_items(prop, prop_blend_items);
140         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
141         RNA_def_property_update(prop, 0, "rna_Brush_update");
142
143         prop= RNA_def_property(srna, "sculpt_tool", PROP_ENUM, PROP_NONE);
144         RNA_def_property_enum_items(prop, brush_sculpt_tool_items);
145         RNA_def_property_ui_text(prop, "Sculpt Tool", "");
146         RNA_def_property_update(prop, 0, "rna_Brush_update");
147         
148         prop= RNA_def_property(srna, "vertexpaint_tool", PROP_ENUM, PROP_NONE);
149         RNA_def_property_enum_items(prop, brush_vertexpaint_tool_items);
150         RNA_def_property_ui_text(prop, "Vertex/Weight Paint Tool", "");
151         RNA_def_property_update(prop, 0, "rna_Brush_update");
152         
153         prop= RNA_def_property(srna, "imagepaint_tool", PROP_ENUM, PROP_NONE);
154         RNA_def_property_enum_items(prop, brush_imagepaint_tool_items);
155         RNA_def_property_ui_text(prop, "Image Paint Tool", "");
156         RNA_def_property_update(prop, NC_SPACE|ND_SPACE_IMAGE, "rna_Brush_update");
157
158         prop= RNA_def_property(srna, "direction", PROP_ENUM, PROP_NONE);
159         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
160         RNA_def_property_enum_items(prop, prop_flip_direction_items);
161         RNA_def_property_ui_text(prop, "Direction", "Mapping type to use for this image in the game engine");
162         RNA_def_property_update(prop, 0, "rna_Brush_update");
163         
164         /* number values */
165         prop= RNA_def_property(srna, "size", PROP_INT, PROP_NONE);
166         RNA_def_property_range(prop, 1, 200);
167         RNA_def_property_ui_text(prop, "Size", "Diameter of the brush");
168         RNA_def_property_update(prop, 0, "rna_Brush_update");
169         
170         prop= RNA_def_property(srna, "jitter", PROP_FLOAT, PROP_NONE);
171         RNA_def_property_float_sdna(prop, NULL, "jitter");
172         RNA_def_property_range(prop, 0.0f, 1.0f);
173         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush while painting");
174         RNA_def_property_update(prop, 0, "rna_Brush_update");
175
176         prop= RNA_def_property(srna, "spacing", PROP_FLOAT, PROP_NONE);
177         RNA_def_property_float_sdna(prop, NULL, "spacing");
178         RNA_def_property_range(prop, 1.0f, 100.0f);
179         RNA_def_property_ui_text(prop, "Spacing", "Spacing between brush stamps");
180         RNA_def_property_update(prop, 0, "rna_Brush_update");
181
182         prop= RNA_def_property(srna, "smooth_stroke_radius", PROP_INT, PROP_NONE);
183         RNA_def_property_range(prop, 10, 200);
184         RNA_def_property_ui_text(prop, "Smooth Stroke Radius", "Minimum distance from last point before stroke continues");
185         RNA_def_property_update(prop, 0, "rna_Brush_update");
186
187         prop= RNA_def_property(srna, "smooth_stroke_factor", PROP_FLOAT, PROP_NONE);
188         RNA_def_property_range(prop, 0.5, 0.99);
189         RNA_def_property_ui_text(prop, "Smooth Stroke Factor", "Higher values give a smoother stroke");
190         RNA_def_property_update(prop, 0, "rna_Brush_update");
191         
192         prop= RNA_def_property(srna, "rate", PROP_FLOAT, PROP_NONE);
193         RNA_def_property_float_sdna(prop, NULL, "rate");
194         RNA_def_property_range(prop, 0.0001f , 10000.0f);
195         RNA_def_property_ui_range(prop, 0.01f, 1.0f, 1, 3);
196         RNA_def_property_ui_text(prop, "Rate", "Interval between paints for Airbrush");
197         RNA_def_property_update(prop, 0, "rna_Brush_update");
198         
199         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR_GAMMA);
200         RNA_def_property_range(prop, 0.0, 1.0);
201         RNA_def_property_float_sdna(prop, NULL, "rgb");
202         RNA_def_property_ui_text(prop, "Color", "");
203         RNA_def_property_update(prop, 0, "rna_Brush_update");
204         
205         prop= RNA_def_property(srna, "strength", PROP_FLOAT, PROP_NONE);
206         RNA_def_property_float_sdna(prop, NULL, "alpha");
207         RNA_def_property_range(prop, 0.0f, 1.0f);
208         RNA_def_property_ui_text(prop, "Strength", "The amount of pressure on the brush");
209         RNA_def_property_update(prop, 0, "rna_Brush_update");
210
211         /* flag */
212         prop= RNA_def_property(srna, "use_airbrush", PROP_BOOLEAN, PROP_NONE);
213         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_AIRBRUSH);
214         RNA_def_property_ui_text(prop, "Airbrush", "Keep applying paint effect while holding mouse (spray)");
215         RNA_def_property_update(prop, 0, "rna_Brush_update");
216         
217         prop= RNA_def_property(srna, "use_wrap", PROP_BOOLEAN, PROP_NONE);
218         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_TORUS);
219         RNA_def_property_ui_text(prop, "Wrap", "Enable torus wrapping while painting");
220         RNA_def_property_update(prop, 0, "rna_Brush_update");
221         
222         prop= RNA_def_property(srna, "use_strength_pressure", PROP_BOOLEAN, PROP_NONE);
223         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ALPHA_PRESSURE);
224         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
225         RNA_def_property_ui_text(prop, "Strength Pressure", "Enable tablet pressure sensitivity for strength");
226         RNA_def_property_update(prop, 0, "rna_Brush_update");
227         
228         prop= RNA_def_property(srna, "use_size_pressure", PROP_BOOLEAN, PROP_NONE);
229         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SIZE_PRESSURE);
230         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
231         RNA_def_property_ui_text(prop, "Size Pressure", "Enable tablet pressure sensitivity for size");
232         RNA_def_property_update(prop, 0, "rna_Brush_update");
233         
234         prop= RNA_def_property(srna, "use_jitter_pressure", PROP_BOOLEAN, PROP_NONE);
235         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_JITTER_PRESSURE);
236         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
237         RNA_def_property_ui_text(prop, "Jitter Pressure", "Enable tablet pressure sensitivity for jitter");
238         RNA_def_property_update(prop, 0, "rna_Brush_update");
239
240         prop= RNA_def_property(srna, "use_spacing_pressure", PROP_BOOLEAN, PROP_NONE);
241         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACING_PRESSURE);
242         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
243         RNA_def_property_ui_text(prop, "Spacing Pressure", "Enable tablet pressure sensitivity for spacing");
244         RNA_def_property_update(prop, 0, "rna_Brush_update");
245
246         prop= RNA_def_property(srna, "use_rake", PROP_BOOLEAN, PROP_NONE);
247         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RAKE);
248         RNA_def_property_ui_text(prop, "Rake", "Rotate the brush texture to match the stroke direction");
249         RNA_def_property_update(prop, 0, "rna_Brush_update");
250
251         prop= RNA_def_property(srna, "use_anchor", PROP_BOOLEAN, PROP_NONE);
252         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ANCHORED);
253         RNA_def_property_ui_text(prop, "Anchored", "Keep the brush anchored to the initial location");
254         RNA_def_property_update(prop, 0, "rna_Brush_update");
255
256         prop= RNA_def_property(srna, "use_space", PROP_BOOLEAN, PROP_NONE);
257         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE);
258         RNA_def_property_ui_text(prop, "Space", "Limit brush application to the distance specified by spacing");
259         RNA_def_property_update(prop, 0, "rna_Brush_update");
260
261         prop= RNA_def_property(srna, "use_smooth_stroke", PROP_BOOLEAN, PROP_NONE);
262         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SMOOTH_STROKE);
263         RNA_def_property_ui_text(prop, "Smooth Stroke", "Brush lags behind mouse and follows a smoother path");
264         RNA_def_property_update(prop, 0, "rna_Brush_update");
265
266         prop= RNA_def_property(srna, "use_persistent", PROP_BOOLEAN, PROP_NONE);
267         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PERSISTENT);
268         RNA_def_property_ui_text(prop, "Persistent", "Sculpts on a persistent layer of the mesh");
269         RNA_def_property_update(prop, 0, "rna_Brush_update");
270
271         prop= RNA_def_property(srna, "use_accumulate", PROP_BOOLEAN, PROP_NONE);
272         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ACCUMULATE);
273         RNA_def_property_ui_text(prop, "Accumulate", "Accumulate stroke dabs on top of each other");
274         RNA_def_property_update(prop, 0, "rna_Brush_update");
275         
276         /* not exposed in the interface yet
277         prop= RNA_def_property(srna, "fixed_tex", PROP_BOOLEAN, PROP_NONE);
278         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FIXED_TEX);
279         RNA_def_property_ui_text(prop, "Fixed Texture", "Keep texture origin in fixed position");
280         RNA_def_property_update(prop, 0, "rna_Brush_update"); */
281         
282         /* only for projection paint, TODO, other paint modes */
283         prop= RNA_def_property(srna, "use_alpha", PROP_BOOLEAN, PROP_NONE);
284         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_LOCK_ALPHA);
285         RNA_def_property_ui_text(prop, "Alpha", "When this is disabled, lock alpha while painting");
286         RNA_def_property_update(prop, 0, "rna_Brush_update");
287
288         prop= RNA_def_property(srna, "curve", PROP_POINTER, PROP_NONE);
289         RNA_def_property_flag(prop, PROP_NEVER_NULL);
290         RNA_def_property_ui_text(prop, "Curve", "Editable falloff curve");
291         RNA_def_property_update(prop, 0, "rna_Brush_update");
292
293         /* texture */
294         prop= RNA_def_property(srna, "texture_slot", PROP_POINTER, PROP_NONE);
295         RNA_def_property_struct_type(prop, "BrushTextureSlot");
296         RNA_def_property_pointer_sdna(prop, NULL, "mtex");
297         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
298         RNA_def_property_ui_text(prop, "Texture Slot", "");
299         
300         prop= RNA_def_property(srna, "texture", PROP_POINTER, PROP_NONE);
301         RNA_def_property_pointer_sdna(prop, NULL, "mtex.tex");
302         RNA_def_property_flag(prop, PROP_EDITABLE);
303         RNA_def_property_ui_text(prop, "Texture", "");
304         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_update");
305
306         /* clone tool */
307         prop= RNA_def_property(srna, "clone_image", PROP_POINTER, PROP_NONE);
308         RNA_def_property_pointer_sdna(prop, NULL, "clone.image");
309         RNA_def_property_flag(prop, PROP_EDITABLE);
310         RNA_def_property_ui_text(prop, "Clone Image", "Image for clone tool");
311         RNA_def_property_update(prop, NC_SPACE|ND_SPACE_IMAGE, "rna_Brush_update");
312         
313         prop= RNA_def_property(srna, "clone_alpha", PROP_FLOAT, PROP_NONE);
314         RNA_def_property_float_sdna(prop, NULL, "clone.alpha");
315         RNA_def_property_range(prop, 0.0f, 1.0f);
316         RNA_def_property_ui_text(prop, "Clone Alpha", "Opacity of clone image display");
317         RNA_def_property_update(prop, NC_SPACE|ND_SPACE_IMAGE, "rna_Brush_update");
318
319         prop= RNA_def_property(srna, "clone_offset", PROP_FLOAT, PROP_XYZ);
320         RNA_def_property_float_sdna(prop, NULL, "clone.offset");
321         RNA_def_property_ui_text(prop, "Clone Offset", "");
322         RNA_def_property_ui_range(prop, -1.0f , 1.0f, 10.0f, 3);
323         RNA_def_property_update(prop, NC_SPACE|ND_SPACE_IMAGE, "rna_Brush_update");
324 }
325
326
327 /* A brush stroke is a list of changes to the brush that
328  * can occur during a stroke
329  *
330  *  o 3D location of the brush
331  *  o 2D mouse location
332  *  o Tablet pressure
333  *  o Direction flip
334  *  o Tool switch
335  *  o Time
336  */
337 static void rna_def_operator_stroke_element(BlenderRNA *brna)
338 {
339         StructRNA *srna;
340         PropertyRNA *prop;
341
342         srna= RNA_def_struct(brna, "OperatorStrokeElement", "IDPropertyGroup");
343         RNA_def_struct_ui_text(srna, "Operator Stroke Element", "");
344
345         prop= RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
346         RNA_def_property_flag(prop, PROP_IDPROPERTY);
347         RNA_def_property_array(prop, 3);
348         RNA_def_property_ui_text(prop, "Location", "");
349
350         prop= RNA_def_property(srna, "mouse", PROP_FLOAT, PROP_XYZ);
351         RNA_def_property_flag(prop, PROP_IDPROPERTY);
352         RNA_def_property_array(prop, 2);
353         RNA_def_property_ui_text(prop, "Mouse", "");
354
355         prop= RNA_def_property(srna, "pressure", PROP_FLOAT, PROP_NONE);
356         RNA_def_property_flag(prop, PROP_IDPROPERTY);
357         RNA_def_property_range(prop, 0.0f, 1.0f);
358         RNA_def_property_ui_text(prop, "Pressure", "Tablet pressure");
359
360         prop= RNA_def_property(srna, "time", PROP_FLOAT, PROP_UNSIGNED);
361         RNA_def_property_flag(prop, PROP_IDPROPERTY);
362         RNA_def_property_ui_text(prop, "Time", "");
363
364         prop= RNA_def_property(srna, "flip", PROP_BOOLEAN, PROP_NONE);
365         RNA_def_property_flag(prop, PROP_IDPROPERTY);
366         RNA_def_property_ui_text(prop, "Flip", "");
367
368         /* XXX: Tool (this will be for pressing a modifier key for a different brush,
369                         e.g. switching to a Smooth brush in the middle of the stroke */
370 }
371
372 void RNA_def_brush(BlenderRNA *brna)
373 {
374         rna_def_brush(brna);
375         rna_def_brush_texture_slot(brna);
376         rna_def_operator_stroke_element(brna);
377 }
378
379 #endif