More radial control work.
[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., 59 Temple Place - Suite 330, Boston, MA  02111-1307, 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 #include "RNA_types.h"
29
30 #include "rna_internal.h"
31
32 #include "DNA_brush_types.h"
33 #include "DNA_texture_types.h"
34
35 #ifdef RNA_RUNTIME
36
37 static void rna_Brush_mtex_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
38 {
39         Brush *brush= (Brush*)ptr->data;
40         rna_iterator_array_begin(iter, (void*)brush->mtex, sizeof(MTex*), MAX_MTEX, NULL);
41 }
42
43 static void *rna_Brush_active_texture_get(PointerRNA *ptr)
44 {
45         Brush *brush= (Brush*)ptr->data;
46         return brush->mtex[(int)brush->texact];
47 }
48
49 static float rna_Brush_rotation_get(PointerRNA *ptr)
50 {
51         Brush *brush= (Brush*)ptr->data;
52         const float conv = 57.295779506;
53         return brush->rot * conv;
54 }
55
56 static void rna_Brush_rotation_set(PointerRNA *ptr, float v)
57 {
58         Brush *brush= (Brush*)ptr->data;
59         const float conv = 0.017453293;
60         brush->rot = v * conv;
61 }
62
63 #else
64
65 void rna_def_brush(BlenderRNA *brna)
66 {
67         StructRNA *srna;
68         PropertyRNA *prop;
69         static EnumPropertyItem prop_blend_items[] = {
70                 {BRUSH_BLEND_MIX, "MIX", "Mix", "Use mix blending mode while painting."},
71                 {BRUSH_BLEND_ADD, "ADD", "Add", "Use add blending mode while painting."},
72                 {BRUSH_BLEND_SUB, "SUB", "Subtract", "Use subtract blending mode while painting."},
73                 {BRUSH_BLEND_MUL, "MUL", "Multiply", "Use multiply blending mode while painting."},
74                 {BRUSH_BLEND_LIGHTEN, "LIGHTEN", "Lighten", "Use lighten blending mode while painting."},
75                 {BRUSH_BLEND_DARKEN, "DARKEN", "Darken", "Use darken blending mode while painting."},
76                 {BRUSH_BLEND_ERASE_ALPHA, "ERASE_ALPHA", "Erase Alpha", "Erase alpha while painting."},
77                 {BRUSH_BLEND_ADD_ALPHA, "ADD_ALPHA", "Add Alpha", "Add alpha while painting."},
78                 {0, NULL, NULL, NULL}};
79         static EnumPropertyItem prop_texture_mode_items[] = {
80                 {BRUSH_TEX_DRAG, "TEX_DRAG", "Drag", ""},
81                 {BRUSH_TEX_TILE, "TEX_TILE", "Tile", ""},
82                 {BRUSH_TEX_3D, "TEX_3D", "3D", ""},
83                 {0, NULL, NULL, NULL}};
84         static EnumPropertyItem prop_sculpt_tool_items[] = {
85                 {SCULPT_TOOL_DRAW, "DRAW", "Draw", ""},
86                 {SCULPT_TOOL_SMOOTH, "SMOOTH", "Smooth", ""},
87                 {SCULPT_TOOL_PINCH, "PINCH", "Pinch", ""},
88                 {SCULPT_TOOL_INFLATE, "INFLATE", "Inflate", ""},
89                 {SCULPT_TOOL_GRAB, "GRAB", "Grab", ""},
90                 {SCULPT_TOOL_LAYER, "LAYER", "Layer", ""},
91                 {SCULPT_TOOL_FLATTEN, "FLATTEN", "Flatten", ""},
92                 {0, NULL, NULL, NULL}};
93         
94         srna= RNA_def_struct(brna, "Brush", "ID");
95         RNA_def_struct_ui_text(srna, "Brush", "Brush datablock for storing brush settings for painting and sculpting.");
96         
97         /* enums */
98         prop= RNA_def_property(srna, "blend", PROP_ENUM, PROP_NONE);
99         RNA_def_property_enum_items(prop, prop_blend_items);
100         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode.");
101
102         prop= RNA_def_property(srna, "texture_mode", PROP_ENUM, PROP_NONE);
103         RNA_def_property_enum_sdna(prop, NULL, "tex_mode");
104         RNA_def_property_enum_items(prop, prop_texture_mode_items);
105         RNA_def_property_ui_text(prop, "Texture Mode", "");
106
107         prop= RNA_def_property(srna, "sculpt_tool", PROP_ENUM, PROP_NONE);
108         RNA_def_property_enum_items(prop, prop_sculpt_tool_items);
109         RNA_def_property_ui_text(prop, "Sculpt Tool", "");
110         
111         /* number values */
112         prop= RNA_def_property(srna, "size", PROP_INT, PROP_NONE);
113         RNA_def_property_range(prop, 1, 200);
114         RNA_def_property_ui_text(prop, "Size", "Diameter of the brush.");
115         
116         prop= RNA_def_property(srna, "falloff", PROP_FLOAT, PROP_NONE);
117         RNA_def_property_float_sdna(prop, NULL, "innerradius");
118         RNA_def_property_range(prop, 0.0f, 1.0f);
119         RNA_def_property_ui_text(prop, "Falloff", "Falloff radius of the brush.");
120         
121         prop= RNA_def_property(srna, "spacing", PROP_FLOAT, PROP_NONE);
122         RNA_def_property_float_sdna(prop, NULL, "spacing");
123         RNA_def_property_range(prop, 1.0f, 100.0f);
124         RNA_def_property_ui_text(prop, "Spacing", "Spacing between brush stamps.");
125         
126         prop= RNA_def_property(srna, "rate", PROP_FLOAT, PROP_NONE);
127         RNA_def_property_float_sdna(prop, NULL, "rate");
128         RNA_def_property_range(prop, 0.010f, 1.0f);
129         RNA_def_property_ui_text(prop, "Rate", "Number of paints per second for Airbrush.");
130         
131         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
132         RNA_def_property_float_sdna(prop, NULL, "rgb");
133         RNA_def_property_ui_text(prop, "Color", "");
134         
135         prop= RNA_def_property(srna, "strength", PROP_FLOAT, PROP_NONE);
136         RNA_def_property_float_sdna(prop, NULL, "alpha");
137         RNA_def_property_range(prop, 0.0f, 1.0f);
138         RNA_def_property_ui_text(prop, "Strength", "The amount of pressure on the brush.");
139
140         prop= RNA_def_property(srna, "rotation", PROP_FLOAT, PROP_NONE);
141         RNA_def_property_float_sdna(prop, NULL, "rot");
142         RNA_def_property_range(prop, 0, 360);
143         RNA_def_property_float_funcs(prop, "rna_Brush_rotation_get", "rna_Brush_rotation_set", NULL);
144         RNA_def_property_ui_text(prop, "Rotation", "Angle of the brush texture.");
145         
146         /* flag */
147         prop= RNA_def_property(srna, "airbrush", PROP_BOOLEAN, PROP_NONE);
148         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_AIRBRUSH);
149         RNA_def_property_ui_text(prop, "Airbrush", "Keep applying paint effect while holding mouse (spray).");
150         
151         prop= RNA_def_property(srna, "wrap", PROP_BOOLEAN, PROP_NONE);
152         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_TORUS);
153         RNA_def_property_ui_text(prop, "Wrap", "Enable torus wrapping while painting.");
154         
155         prop= RNA_def_property(srna, "alpha_pressure", PROP_BOOLEAN, PROP_NONE);
156         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ALPHA_PRESSURE);
157         RNA_def_property_ui_text(prop, "Opacity Pressure", "Enable tablet pressure sensitivity for opacity.");
158         
159         prop= RNA_def_property(srna, "size_pressure", PROP_BOOLEAN, PROP_NONE);
160         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SIZE_PRESSURE);
161         RNA_def_property_ui_text(prop, "Size Pressure", "Enable tablet pressure sensitivity for size.");
162         
163         prop= RNA_def_property(srna, "falloff_pressure", PROP_BOOLEAN, PROP_NONE);
164         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RAD_PRESSURE);
165         RNA_def_property_ui_text(prop, "Falloff Pressure", "Enable tablet pressure sensitivity for falloff.");
166         
167         prop= RNA_def_property(srna, "spacing_pressure", PROP_BOOLEAN, PROP_NONE);
168         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACING_PRESSURE);
169         RNA_def_property_ui_text(prop, "Spacing Pressure", "Enable tablet pressure sensitivity for spacing.");
170
171         prop= RNA_def_property(srna, "rake", PROP_BOOLEAN, PROP_NONE);
172         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RAKE);
173         RNA_def_property_ui_text(prop, "Rake", "Rotate the brush texture to match the stroke direction.");
174
175         prop= RNA_def_property(srna, "anchored", PROP_BOOLEAN, PROP_NONE);
176         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ANCHORED);
177         RNA_def_property_ui_text(prop, "Anchored", "Keep the brush anchored to the initial location.");
178
179         prop= RNA_def_property(srna, "flip_direction", PROP_BOOLEAN, PROP_NONE);
180         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_DIR_IN);
181         RNA_def_property_ui_text(prop, "Flip Direction", "Move vertices in the opposite direction.");
182
183         prop= RNA_def_property(srna, "space", PROP_BOOLEAN, PROP_NONE);
184         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE);
185         RNA_def_property_ui_text(prop, "Space", "Limit brush application to the distance specified by spacing.");
186         
187         /* not exposed in the interface yet
188         prop= RNA_def_property(srna, "fixed_tex", PROP_BOOLEAN, PROP_NONE);
189         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FIXED_TEX);
190         RNA_def_property_ui_text(prop, "Fixed Texture", "Keep texture origin in fixed position.");*/
191
192         prop= RNA_def_property(srna, "curve", PROP_POINTER, PROP_NONE);
193         RNA_def_property_ui_text(prop, "Curve", "Editable falloff curve.");
194
195         /* texture */
196         rna_def_mtex_common(srna, "rna_Brush_mtex_begin", "rna_Brush_active_texture_get", "TextureSlot");
197
198         /* clone tool */
199         prop= RNA_def_property(srna, "clone_image", PROP_POINTER, PROP_NONE);
200         RNA_def_property_pointer_sdna(prop, NULL, "clone.image");
201         RNA_def_property_flag(prop, PROP_NOT_EDITABLE);
202         RNA_def_property_ui_text(prop, "Clone Image", "Image for clone tool.");
203         
204         prop= RNA_def_property(srna, "clone_opacity", PROP_FLOAT, PROP_NONE);
205         RNA_def_property_float_sdna(prop, NULL, "clone.alpha");
206         RNA_def_property_range(prop, 0.0f, 1.0f);
207         RNA_def_property_ui_text(prop, "Clone Opacity", "Opacity of clone image display.");
208
209         prop= RNA_def_property(srna, "clone_offset", PROP_FLOAT, PROP_VECTOR);
210         RNA_def_property_float_sdna(prop, NULL, "clone.offset");
211         RNA_def_property_ui_text(prop, "Clone Offset", "");
212         RNA_def_property_ui_range(prop, -1.0f , 1.0f, 10.0f, 3);
213 }
214
215
216 /* A brush stroke is a list of changes to the brush that
217  * can occur during a stroke
218  *
219  *  o 3D location of the brush
220  *  o 2D mouse location
221  *  o Tablet pressure
222  *  o Direction flip
223  *  o Tool switch
224  *  o Time
225  */
226 static void rna_def_operator_stroke_element(BlenderRNA *brna)
227 {
228         StructRNA *srna;
229         PropertyRNA *prop;
230
231         srna= RNA_def_struct(brna, "OperatorStrokeElement", "IDPropertyGroup");
232         RNA_def_struct_ui_text(srna, "Operator Stroke Element", "");
233
234         prop= RNA_def_property(srna, "location", PROP_FLOAT, PROP_VECTOR);
235         RNA_def_property_flag(prop, PROP_IDPROPERTY);
236         RNA_def_property_array(prop, 3);
237         RNA_def_property_ui_text(prop, "Location", "");
238
239         prop= RNA_def_property(srna, "mouse", PROP_INT, PROP_VECTOR);
240         RNA_def_property_flag(prop, PROP_IDPROPERTY);
241         RNA_def_property_array(prop, 2);
242         RNA_def_property_ui_text(prop, "Mouse", "");
243
244         /*prop= RNA_def_property(srna, "pressure", PROP_FLOAT, PROP_NONE);
245         RNA_def_property_flag(prop, PROP_IDPROPERTY);
246         RNA_def_property_range(prop, 0, 1);
247         RNA_def_property_ui_text(prop, "Pressure", "");*/
248
249         prop= RNA_def_property(srna, "flip", PROP_BOOLEAN, PROP_NONE);
250         RNA_def_property_flag(prop, PROP_IDPROPERTY);
251         RNA_def_property_ui_text(prop, "Flip", "");
252
253         /* XXX: Tool (this will be for pressing a modifier key for a different brush,
254                 e.g. switching to a Smooth brush in the middle of the stroke */
255
256         /* XXX: Time (should be useful for airbrush mode) */
257 }
258
259 void RNA_def_brush(BlenderRNA *brna)
260 {
261         rna_def_brush(brna);
262         rna_def_operator_stroke_element(brna);
263 }
264
265 #endif