6a67e036c5d3ca78b4cab635f4cc753038b98cb7
[blender-staging.git] / source / blender / makesrna / intern / rna_brush.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  * Contributor(s): Blender Foundation (2008), Juho Veps�l�inen
19  *
20  * ***** END GPL LICENSE BLOCK *****
21  */
22
23 /** \file blender/makesrna/intern/rna_brush.c
24  *  \ingroup RNA
25  */
26
27 #include <stdlib.h>
28 #include <assert.h>
29
30 #include "DNA_brush_types.h"
31 #include "DNA_texture_types.h"
32 #include "DNA_scene_types.h"
33 #include "DNA_object_types.h"
34
35 #include "BLI_math.h"
36
37 #include "RNA_define.h"
38 #include "RNA_enum_types.h"
39
40 #include "rna_internal.h"
41
42 #include "IMB_imbuf.h"
43
44 #include "WM_types.h"
45
46 static const EnumPropertyItem prop_direction_items[] = {
47         {0, "ADD", 0, "Add", "Add effect of brush"},
48         {BRUSH_DIR_IN, "SUBTRACT", 0, "Subtract", "Subtract effect of brush"},
49         {0, NULL, 0, NULL, NULL}
50 };
51
52 static const EnumPropertyItem sculpt_stroke_method_items[] = {
53         {0, "DOTS", 0, "Dots", "Apply paint on each mouse move step"},
54         {BRUSH_DRAG_DOT, "DRAG_DOT", 0, "Drag Dot", "Allows a single dot to be carefully positioned"},
55         {BRUSH_SPACE, "SPACE", 0, "Space", "Limit brush application to the distance specified by spacing"},
56         {BRUSH_AIRBRUSH, "AIRBRUSH", 0, "Airbrush", "Keep applying paint effect while holding mouse (spray)"},
57         {BRUSH_ANCHORED, "ANCHORED", 0, "Anchored", "Keep the brush anchored to the initial location"},
58         {BRUSH_LINE, "LINE", 0, "Line", "Draw a line with dabs separated according to spacing"},
59         {BRUSH_CURVE, "CURVE", 0, "Curve",
60                       "Define the stroke curve with a bezier curve (dabs are separated according to spacing)"},
61         {0, NULL, 0, NULL, NULL}
62 };
63
64
65 const EnumPropertyItem rna_enum_brush_sculpt_tool_items[] = {
66         {SCULPT_TOOL_BLOB, "BLOB", ICON_BRUSH_BLOB, "Blob", ""},
67         {SCULPT_TOOL_CLAY, "CLAY", ICON_BRUSH_CLAY, "Clay", ""},
68         {SCULPT_TOOL_CLAY_STRIPS, "CLAY_STRIPS", ICON_BRUSH_CLAY_STRIPS, "Clay Strips", ""},
69         {SCULPT_TOOL_CREASE, "CREASE", ICON_BRUSH_CREASE, "Crease", ""},
70         {SCULPT_TOOL_DRAW, "DRAW", ICON_BRUSH_SCULPT_DRAW, "Draw", ""},
71         {SCULPT_TOOL_FILL, "FILL", ICON_BRUSH_FILL, "Fill", ""},
72         {SCULPT_TOOL_FLATTEN, "FLATTEN", ICON_BRUSH_FLATTEN, "Flatten", ""},
73         {SCULPT_TOOL_GRAB, "GRAB", ICON_BRUSH_GRAB, "Grab", ""},
74         {SCULPT_TOOL_INFLATE, "INFLATE", ICON_BRUSH_INFLATE, "Inflate", ""},
75         {SCULPT_TOOL_LAYER, "LAYER", ICON_BRUSH_LAYER, "Layer", ""},
76         {SCULPT_TOOL_MASK, "MASK", ICON_BRUSH_MASK, "Mask", ""},
77         {SCULPT_TOOL_NUDGE, "NUDGE", ICON_BRUSH_NUDGE, "Nudge", ""},
78         {SCULPT_TOOL_PINCH, "PINCH", ICON_BRUSH_PINCH, "Pinch", ""},
79         {SCULPT_TOOL_ROTATE, "ROTATE", ICON_BRUSH_ROTATE, "Rotate", ""},
80         {SCULPT_TOOL_SCRAPE, "SCRAPE", ICON_BRUSH_SCRAPE, "Scrape", ""},
81         {SCULPT_TOOL_SIMPLIFY, "SIMPLIFY", ICON_BRUSH_SUBTRACT /* icon TODO */, "Simplify", ""},
82         {SCULPT_TOOL_SMOOTH, "SMOOTH", ICON_BRUSH_SMOOTH, "Smooth", ""},
83         {SCULPT_TOOL_SNAKE_HOOK, "SNAKE_HOOK", ICON_BRUSH_SNAKE_HOOK, "Snake Hook", ""},
84         {SCULPT_TOOL_THUMB, "THUMB", ICON_BRUSH_THUMB, "Thumb", ""},
85         {0, NULL, 0, NULL, NULL}
86 };
87
88
89 const EnumPropertyItem rna_enum_brush_vertex_tool_items[] = {
90         {PAINT_BLEND_MIX, "MIX", ICON_BRUSH_MIX, "Mix", "Use mix blending mode while painting"},
91         {PAINT_BLEND_ADD, "ADD", ICON_BRUSH_ADD, "Add", "Use add blending mode while painting"},
92         {PAINT_BLEND_SUB, "SUB", ICON_BRUSH_SUBTRACT, "Subtract", "Use subtract blending mode while painting"},
93         {PAINT_BLEND_MUL, "MUL", ICON_BRUSH_MULTIPLY, "Multiply", "Use multiply blending mode while painting"},
94         {PAINT_BLEND_BLUR, "BLUR", ICON_BRUSH_BLUR, "Blur", "Blur the color with surrounding values"},
95         {PAINT_BLEND_LIGHTEN, "LIGHTEN", ICON_BRUSH_LIGHTEN, "Lighten", "Use lighten blending mode while painting"},
96         {PAINT_BLEND_DARKEN, "DARKEN", ICON_BRUSH_DARKEN, "Darken", "Use darken blending mode while painting"},
97         {PAINT_BLEND_AVERAGE, "AVERAGE", ICON_BRUSH_BLUR, "Average", "Use average blending mode while painting"},
98         {PAINT_BLEND_SMEAR, "SMEAR", ICON_BRUSH_BLUR, "Smear", "Use smear blending mode while painting"},
99         {PAINT_BLEND_COLORDODGE, "COLORDODGE", ICON_BRUSH_BLUR, "Color Dodge", "Use color dodge blending mode while painting" },
100         {PAINT_BLEND_DIFFERENCE, "DIFFERENCE", ICON_BRUSH_BLUR, "Difference", "Use difference blending mode while painting"},
101         {PAINT_BLEND_SCREEN, "SCREEN", ICON_BRUSH_BLUR, "Screen", "Use screen blending mode while painting"},
102         {PAINT_BLEND_HARDLIGHT, "HARDLIGHT", ICON_BRUSH_BLUR, "Hardlight", "Use hardlight blending mode while painting"},
103         {PAINT_BLEND_OVERLAY, "OVERLAY", ICON_BRUSH_BLUR, "Overlay", "Use overlay blending mode while painting"},
104         {PAINT_BLEND_SOFTLIGHT, "SOFTLIGHT", ICON_BRUSH_BLUR, "Softlight", "Use softlight blending mode while painting"},
105         {PAINT_BLEND_EXCLUSION, "EXCLUSION", ICON_BRUSH_BLUR, "Exclusion", "Use exclusion blending mode while painting"},
106         {PAINT_BLEND_LUMINOCITY, "LUMINOCITY", ICON_BRUSH_BLUR, "Luminocity", "Use luminocity blending mode while painting"},
107         {PAINT_BLEND_SATURATION, "SATURATION", ICON_BRUSH_BLUR, "Saturation", "Use saturation blending mode while painting"},
108         {PAINT_BLEND_HUE, "HUE", ICON_BRUSH_BLUR, "Hue", "Use hue blending mode while painting"},
109         {PAINT_BLEND_ALPHA_SUB, "ERASE_ALPHA", 0, "Erase Alpha", "Erase alpha while painting"},
110         {PAINT_BLEND_ALPHA_ADD, "ADD_ALPHA", 0, "Add Alpha", "Add alpha while painting"},
111
112         {0, NULL, 0, NULL, NULL}
113 };
114         
115 const EnumPropertyItem rna_enum_brush_image_tool_items[] = {
116         {PAINT_TOOL_DRAW, "DRAW", ICON_BRUSH_TEXDRAW, "Draw", ""},
117         {PAINT_TOOL_SOFTEN, "SOFTEN", ICON_BRUSH_SOFTEN, "Soften", ""},
118         {PAINT_TOOL_SMEAR, "SMEAR", ICON_BRUSH_SMEAR, "Smear", ""},
119         {PAINT_TOOL_CLONE, "CLONE", ICON_BRUSH_CLONE, "Clone", ""},
120         {PAINT_TOOL_FILL, "FILL", ICON_BRUSH_TEXFILL, "Fill", ""},
121         {PAINT_TOOL_MASK, "MASK", ICON_BRUSH_TEXMASK, "Mask", ""},
122         {0, NULL, 0, NULL, NULL}
123 };
124
125 #ifdef RNA_RUNTIME
126
127 #include "MEM_guardedalloc.h"
128
129 #include "RNA_access.h"
130
131 #include "BKE_colorband.h"
132 #include "BKE_brush.h"
133 #include "BKE_icons.h"
134 #include "BKE_paint.h"
135
136 #include "WM_api.h"
137
138 static int rna_SculptToolCapabilities_has_accumulate_get(PointerRNA *ptr)
139 {
140         Brush *br = (Brush *)ptr->data;
141         return SCULPT_TOOL_HAS_ACCUMULATE(br->sculpt_tool);
142 }
143
144 static int rna_SculptToolCapabilities_has_auto_smooth_get(PointerRNA *ptr)
145 {
146         Brush *br = (Brush *)ptr->data;
147         return !ELEM(br->sculpt_tool, SCULPT_TOOL_MASK, SCULPT_TOOL_SMOOTH);
148 }
149
150 static int rna_SculptToolCapabilities_has_height_get(PointerRNA *ptr)
151 {
152         Brush *br = (Brush *)ptr->data;
153         return br->sculpt_tool == SCULPT_TOOL_LAYER;
154 }
155
156 static int rna_SculptToolCapabilities_has_jitter_get(PointerRNA *ptr)
157 {
158         Brush *br = (Brush *)ptr->data;
159         return (!(br->flag & BRUSH_ANCHORED) &&
160                 !(br->flag & BRUSH_DRAG_DOT) &&
161                 !ELEM(br->sculpt_tool,
162                       SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
163                       SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
164 }
165
166 static int rna_SculptToolCapabilities_has_normal_weight_get(PointerRNA *ptr)
167 {
168         Brush *br = (Brush *)ptr->data;
169         return SCULPT_TOOL_HAS_NORMAL_WEIGHT(br->sculpt_tool);
170 }
171
172 static int rna_SculptToolCapabilities_has_rake_factor_get(PointerRNA *ptr)
173 {
174         Brush *br = (Brush *)ptr->data;
175         return SCULPT_TOOL_HAS_RAKE(br->sculpt_tool);
176 }
177
178 static int rna_BrushCapabilities_has_overlay_get(PointerRNA *ptr)
179 {
180         Brush *br = (Brush *)ptr->data;
181         return ELEM(br->mtex.brush_map_mode,
182                     MTEX_MAP_MODE_VIEW,
183                     MTEX_MAP_MODE_TILED,
184                     MTEX_MAP_MODE_STENCIL);
185 }
186
187 static int rna_SculptToolCapabilities_has_persistence_get(PointerRNA *ptr)
188 {
189         Brush *br = (Brush *)ptr->data;
190         return br->sculpt_tool == SCULPT_TOOL_LAYER;
191 }
192
193 static int rna_SculptToolCapabilities_has_pinch_factor_get(PointerRNA *ptr)
194 {
195         Brush *br = (Brush *)ptr->data;
196         return ELEM(br->sculpt_tool, SCULPT_TOOL_BLOB, SCULPT_TOOL_CREASE, SCULPT_TOOL_SNAKE_HOOK);
197 }
198
199 static int rna_SculptToolCapabilities_has_plane_offset_get(PointerRNA *ptr)
200 {
201         Brush *br = (Brush *)ptr->data;
202         return ELEM(br->sculpt_tool, SCULPT_TOOL_CLAY, SCULPT_TOOL_CLAY_STRIPS,
203                     SCULPT_TOOL_FILL, SCULPT_TOOL_FLATTEN, SCULPT_TOOL_SCRAPE);
204 }
205
206 static int rna_SculptToolCapabilities_has_random_texture_angle_get(PointerRNA *ptr)
207 {
208         Brush *br = (Brush *)ptr->data;
209         return (!ELEM(br->sculpt_tool,
210                       SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
211                       SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
212 }
213
214 static int rna_TextureCapabilities_has_random_texture_angle_get(PointerRNA *ptr)
215 {
216         MTex *mtex = (MTex *)ptr->data;
217         return ELEM(mtex->brush_map_mode,
218                      MTEX_MAP_MODE_VIEW,
219                      MTEX_MAP_MODE_AREA,
220                      MTEX_MAP_MODE_RANDOM);
221 }
222
223
224 static int rna_BrushCapabilities_has_random_texture_angle_get(PointerRNA *ptr)
225 {
226         Brush *br = (Brush *)ptr->data;
227         return !(br->flag & BRUSH_ANCHORED);
228 }
229
230 static int rna_SculptToolCapabilities_has_sculpt_plane_get(PointerRNA *ptr)
231 {
232         Brush *br = (Brush *)ptr->data;
233         return !ELEM(br->sculpt_tool, SCULPT_TOOL_INFLATE,
234                      SCULPT_TOOL_MASK, SCULPT_TOOL_PINCH,
235                      SCULPT_TOOL_SMOOTH);
236 }
237
238 static int rna_SculptToolCapabilities_has_secondary_color_get(PointerRNA *ptr)
239 {
240         Brush *br = (Brush *)ptr->data;
241         return BKE_brush_sculpt_has_secondary_color(br);
242 }
243
244 static int rna_SculptToolCapabilities_has_smooth_stroke_get(PointerRNA *ptr)
245 {
246         Brush *br = (Brush *)ptr->data;
247         return (!(br->flag & BRUSH_ANCHORED) &&
248                 !(br->flag & BRUSH_DRAG_DOT) &&
249                 !(br->flag & BRUSH_LINE) &&
250                 !(br->flag & BRUSH_CURVE) &&
251                 !ELEM(br->sculpt_tool,
252                        SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
253                        SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
254 }
255
256 static int rna_BrushCapabilities_has_smooth_stroke_get(PointerRNA *ptr)
257 {
258         Brush *br = (Brush *)ptr->data;
259         return (!(br->flag & BRUSH_ANCHORED) &&
260                 !(br->flag & BRUSH_DRAG_DOT) &&
261                 !(br->flag & BRUSH_LINE) &&
262                 !(br->flag & BRUSH_CURVE));
263 }
264
265 static int rna_SculptToolCapabilities_has_space_attenuation_get(PointerRNA *ptr)
266 {
267         Brush *br = (Brush *)ptr->data;
268         return ((br->flag & (BRUSH_SPACE | BRUSH_LINE | BRUSH_CURVE)) &&
269                 !ELEM(br->sculpt_tool, SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
270                        SCULPT_TOOL_SMOOTH, SCULPT_TOOL_SNAKE_HOOK));
271 }
272
273 static int rna_ImapaintToolCapabilities_has_space_attenuation_get(PointerRNA *ptr)
274 {
275         Brush *br = (Brush *)ptr->data;
276         return (br->flag & (BRUSH_SPACE | BRUSH_LINE | BRUSH_CURVE)) &&
277                 br->imagepaint_tool != PAINT_TOOL_FILL;
278 }
279
280 static int rna_BrushCapabilities_has_spacing_get(PointerRNA *ptr)
281 {
282         Brush *br = (Brush *)ptr->data;
283         return (!(br->flag & BRUSH_ANCHORED));
284 }
285
286 static int rna_SculptToolCapabilities_has_strength_pressure_get(PointerRNA *ptr)
287 {
288         Brush *br = (Brush *)ptr->data;
289         return !ELEM(br->sculpt_tool, SCULPT_TOOL_GRAB, SCULPT_TOOL_SNAKE_HOOK);
290 }
291
292 static int rna_TextureCapabilities_has_texture_angle_get(PointerRNA *ptr)
293 {
294         MTex *mtex = (MTex *)ptr->data;
295         return mtex->brush_map_mode != MTEX_MAP_MODE_3D;
296 }
297
298 static int rna_SculptToolCapabilities_has_gravity_get(PointerRNA *ptr)
299 {
300         Brush *br = (Brush *)ptr->data;
301         return !ELEM(br->sculpt_tool, SCULPT_TOOL_MASK, SCULPT_TOOL_SMOOTH);
302 }
303
304 static int rna_TextureCapabilities_has_texture_angle_source_get(PointerRNA *ptr)
305 {
306         MTex *mtex = (MTex *)ptr->data;
307         return ELEM(mtex->brush_map_mode,
308                     MTEX_MAP_MODE_VIEW,
309                     MTEX_MAP_MODE_AREA,
310                     MTEX_MAP_MODE_RANDOM);
311 }
312
313 static int rna_ImapaintToolCapabilities_has_accumulate_get(PointerRNA *ptr)
314 {
315         /* only support for draw tool */
316         Brush *br = (Brush *)ptr->data;
317
318         return ((br->flag & BRUSH_AIRBRUSH) ||
319                 (br->flag & BRUSH_DRAG_DOT) ||
320                 (br->flag & BRUSH_ANCHORED) ||
321                 (br->imagepaint_tool == PAINT_TOOL_SOFTEN) ||
322                 (br->imagepaint_tool == PAINT_TOOL_SMEAR) ||
323                 (br->imagepaint_tool == PAINT_TOOL_FILL) ||
324                 (br->mtex.tex && !ELEM(br->mtex.brush_map_mode, MTEX_MAP_MODE_TILED, MTEX_MAP_MODE_STENCIL, MTEX_MAP_MODE_3D))
325                 ) ? false : true;
326 }
327
328 static int rna_ImapaintToolCapabilities_has_radius_get(PointerRNA *ptr)
329 {
330         /* only support for draw tool */
331         Brush *br = (Brush *)ptr->data;
332
333         return (br->imagepaint_tool != PAINT_TOOL_FILL);
334 }
335
336
337 static PointerRNA rna_Sculpt_tool_capabilities_get(PointerRNA *ptr)
338 {
339         return rna_pointer_inherit_refine(ptr, &RNA_SculptToolCapabilities, ptr->id.data);
340 }
341
342 static PointerRNA rna_Imapaint_tool_capabilities_get(PointerRNA *ptr)
343 {
344         return rna_pointer_inherit_refine(ptr, &RNA_ImapaintToolCapabilities, ptr->id.data);
345 }
346
347 static PointerRNA rna_Brush_capabilities_get(PointerRNA *ptr)
348 {
349         return rna_pointer_inherit_refine(ptr, &RNA_BrushCapabilities, ptr->id.data);
350 }
351
352 static void rna_Brush_reset_icon(Brush *br, const char *UNUSED(type))
353 {
354         ID *id = &br->id;
355
356         if (br->flag & BRUSH_CUSTOM_ICON)
357                 return;
358
359         if (id->icon_id >= BIFICONID_LAST) {
360                 BKE_icon_id_delete(id);
361                 BKE_previewimg_id_free(id);
362         }
363
364         id->icon_id = 0;
365 }
366
367 static void rna_Brush_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
368 {
369         Brush *br = (Brush *)ptr->data;
370         WM_main_add_notifier(NC_BRUSH | NA_EDITED, br);
371         /*WM_main_add_notifier(NC_SPACE|ND_SPACE_VIEW3D, NULL); */
372 }
373
374 static void rna_Brush_main_tex_update(Main *bmain, Scene *scene, PointerRNA *ptr)
375 {
376         Brush *br = (Brush *)ptr->data;
377         BKE_paint_invalidate_overlay_tex(scene, br->mtex.tex);
378         rna_Brush_update(bmain, scene, ptr);
379 }
380
381 static void rna_Brush_secondary_tex_update(Main *bmain, Scene *scene, PointerRNA *ptr)
382 {
383         Brush *br = (Brush *)ptr->data;
384         BKE_paint_invalidate_overlay_tex(scene, br->mask_mtex.tex);
385         rna_Brush_update(bmain, scene, ptr);
386 }
387
388 static void rna_Brush_size_update(Main *bmain, Scene *scene, PointerRNA *ptr)
389 {
390         BKE_paint_invalidate_overlay_all();
391         rna_Brush_update(bmain, scene, ptr);
392 }
393
394 static void rna_Brush_sculpt_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
395 {
396         Brush *br = (Brush *)ptr->data;
397         rna_Brush_reset_icon(br, "sculpt");
398         rna_Brush_update(bmain, scene, ptr);
399 }
400  
401 static void rna_Brush_vertex_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
402 {
403         Brush *br = (Brush *)ptr->data;
404         rna_Brush_reset_icon(br, "vertex_paint");
405         rna_Brush_update(bmain, scene, ptr);
406 }
407  
408 static void rna_Brush_imagepaint_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
409 {
410         Brush *br = (Brush *)ptr->data;
411         rna_Brush_reset_icon(br, "image_paint");
412         rna_Brush_update(bmain, scene, ptr);
413 }
414
415 static void rna_Brush_stroke_update(Main *bmain, Scene *scene, PointerRNA *ptr)
416 {
417         WM_main_add_notifier(NC_SCENE | ND_TOOLSETTINGS, scene);
418         rna_Brush_update(bmain, scene, ptr);
419 }
420
421 static void rna_Brush_icon_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
422 {
423         Brush *br = (Brush *)ptr->data;
424
425         if (br->icon_imbuf) {
426                 IMB_freeImBuf(br->icon_imbuf);
427                 br->icon_imbuf = NULL;
428         }
429
430         br->id.icon_id = 0;
431
432         if (br->flag & BRUSH_CUSTOM_ICON) {
433                 BKE_previewimg_id_ensure(&br->id);
434                 BKE_icon_changed(BKE_icon_id_ensure(&br->id));
435         }
436
437         WM_main_add_notifier(NC_BRUSH | NA_EDITED, br);
438 }
439
440 static void rna_TextureSlot_brush_angle_update(Main *bmain, Scene *scene, PointerRNA *ptr)
441 {
442         MTex *mtex = ptr->data;
443         /* skip invalidation of overlay for stencil mode */
444         if (mtex->mapping != MTEX_MAP_MODE_STENCIL)
445                 BKE_paint_invalidate_overlay_tex(scene, mtex->tex);
446
447         rna_TextureSlot_update(bmain, scene, ptr);
448 }
449
450 static void rna_Brush_set_size(PointerRNA *ptr, int value)
451 {
452         Brush *brush = ptr->data;
453
454         /* scale unprojected radius so it stays consistent with brush size */
455         BKE_brush_scale_unprojected_radius(&brush->unprojected_radius,
456                                            value, brush->size);
457         brush->size = value;
458 }
459
460 static void rna_Brush_use_gradient_set(PointerRNA *ptr, int value)
461 {
462         Brush *br = (Brush *)ptr->data;
463
464         if (value) br->flag |= BRUSH_USE_GRADIENT;
465         else br->flag &= ~BRUSH_USE_GRADIENT;
466
467         if ((br->flag & BRUSH_USE_GRADIENT) && br->gradient == NULL)
468                 br->gradient = BKE_colorband_add(true);
469 }
470
471 static void rna_Brush_set_unprojected_radius(PointerRNA *ptr, float value)
472 {
473         Brush *brush = ptr->data;
474
475         /* scale brush size so it stays consistent with unprojected_radius */
476         BKE_brush_scale_size(&brush->size, value, brush->unprojected_radius);
477         brush->unprojected_radius = value;
478 }
479
480 static const EnumPropertyItem *rna_Brush_direction_itemf(bContext *C, PointerRNA *ptr,
481                                                    PropertyRNA *UNUSED(prop), bool *UNUSED(r_free))
482 {
483         ePaintMode mode = BKE_paintmode_get_active_from_context(C);
484
485         static const EnumPropertyItem prop_default_items[] = {
486                 {0, NULL, 0, NULL, NULL}
487         };
488
489         /* sculpt mode */
490         static const EnumPropertyItem prop_flatten_contrast_items[] = {
491                 {0, "FLATTEN", 0, "Flatten", "Add effect of brush"},
492                 {BRUSH_DIR_IN, "CONTRAST", 0, "Contrast", "Subtract effect of brush"},
493                 {0, NULL, 0, NULL, NULL}
494         };
495
496         static const EnumPropertyItem prop_fill_deepen_items[] = {
497                 {0, "FILL", 0, "Fill", "Add effect of brush"},
498                 {BRUSH_DIR_IN, "DEEPEN", 0, "Deepen", "Subtract effect of brush"},
499                 {0, NULL, 0, NULL, NULL}
500         };
501
502         static const EnumPropertyItem prop_scrape_peaks_items[] = {
503                 {0, "SCRAPE", 0, "Scrape", "Add effect of brush"},
504                 {BRUSH_DIR_IN, "PEAKS", 0, "Peaks", "Subtract effect of brush"},
505                 {0, NULL, 0, NULL, NULL}
506         };
507
508         static const EnumPropertyItem prop_pinch_magnify_items[] = {
509                 {0, "PINCH", 0, "Pinch", "Add effect of brush"},
510                 {BRUSH_DIR_IN, "MAGNIFY", 0, "Magnify", "Subtract effect of brush"},
511                 {0, NULL, 0, NULL, NULL}
512         };
513
514         static const EnumPropertyItem prop_inflate_deflate_items[] = {
515                 {0, "INFLATE", 0, "Inflate", "Add effect of brush"},
516                 {BRUSH_DIR_IN, "DEFLATE", 0, "Deflate", "Subtract effect of brush"},
517                 {0, NULL, 0, NULL, NULL}
518         };
519
520         /* texture paint mode */
521         static const EnumPropertyItem prop_soften_sharpen_items[] = {
522                 {0, "SOFTEN", 0, "Soften", "Blur effect of brush"},
523                 {BRUSH_DIR_IN, "SHARPEN", 0, "Sharpen", "Sharpen effect of brush"},
524                 {0, NULL, 0, NULL, NULL}
525         };
526
527         Brush *me = (Brush *)(ptr->data);
528
529         switch (mode) {
530                 case ePaintSculpt:
531                         switch (me->sculpt_tool) {
532                                 case SCULPT_TOOL_DRAW:
533                                 case SCULPT_TOOL_CREASE:
534                                 case SCULPT_TOOL_BLOB:
535                                 case SCULPT_TOOL_LAYER:
536                                 case SCULPT_TOOL_CLAY:
537                                 case SCULPT_TOOL_CLAY_STRIPS:
538                                         return prop_direction_items;
539
540                                 case SCULPT_TOOL_MASK:
541                                         switch ((BrushMaskTool)me->mask_tool) {
542                                                 case BRUSH_MASK_DRAW:
543                                                         return prop_direction_items;
544
545                                                 case BRUSH_MASK_SMOOTH:
546                                                         return prop_default_items;
547
548                                                 default:
549                                                         return prop_default_items;
550                                         }
551
552                                 case SCULPT_TOOL_FLATTEN:
553                                         return prop_flatten_contrast_items;
554
555                                 case SCULPT_TOOL_FILL:
556                                         return prop_fill_deepen_items;
557
558                                 case SCULPT_TOOL_SCRAPE:
559                                         return prop_scrape_peaks_items;
560
561                                 case SCULPT_TOOL_PINCH:
562                                         return prop_pinch_magnify_items;
563
564                                 case SCULPT_TOOL_INFLATE:
565                                         return prop_inflate_deflate_items;
566
567                                 default:
568                                         return prop_default_items;
569                         }
570
571                 case ePaintTexture2D:
572                 case ePaintTextureProjective:
573                         switch (me->imagepaint_tool) {
574                                 case PAINT_TOOL_SOFTEN:
575                                         return prop_soften_sharpen_items;
576
577                                 default:
578                                         return prop_default_items;
579                         }
580
581                 default:
582                         return prop_default_items;
583         }
584 }
585
586 static const EnumPropertyItem *rna_Brush_stroke_itemf(bContext *C, PointerRNA *UNUSED(ptr),
587                                                 PropertyRNA *UNUSED(prop), bool *UNUSED(r_free))
588 {
589         ePaintMode mode = BKE_paintmode_get_active_from_context(C);
590
591         static const EnumPropertyItem brush_stroke_method_items[] = {
592                 {0, "DOTS", 0, "Dots", "Apply paint on each mouse move step"},
593                 {BRUSH_SPACE, "SPACE", 0, "Space", "Limit brush application to the distance specified by spacing"},
594                 {BRUSH_AIRBRUSH, "AIRBRUSH", 0, "Airbrush", "Keep applying paint effect while holding mouse (spray)"},
595                 {BRUSH_LINE, "LINE", 0, "Line", "Drag a line with dabs separated according to spacing"},
596                 {BRUSH_CURVE, "CURVE", 0, "Curve", "Define the stroke curve with a bezier curve. Dabs are separated according to spacing"},
597                 {0, NULL, 0, NULL, NULL}
598         };
599
600         switch (mode) {
601                 case ePaintSculpt:
602                 case ePaintTexture2D:
603                 case ePaintTextureProjective:
604                         return sculpt_stroke_method_items;
605
606                 default:
607                         return brush_stroke_method_items;
608         }
609 }
610 #else
611
612 static void rna_def_brush_texture_slot(BlenderRNA *brna)
613 {
614         StructRNA *srna;
615         PropertyRNA *prop;
616
617         static const EnumPropertyItem prop_map_mode_items[] = {
618                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
619                 {MTEX_MAP_MODE_AREA, "AREA_PLANE", 0, "Area Plane", ""},
620                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
621                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
622                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
623                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
624                 {0, NULL, 0, NULL, NULL}
625         };
626
627         static const EnumPropertyItem prop_tex_paint_map_mode_items[] = {
628                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
629                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
630                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
631                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
632                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
633                 {0, NULL, 0, NULL, NULL}
634         };
635
636         static const EnumPropertyItem prop_mask_paint_map_mode_items[] = {
637                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
638                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
639                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
640                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
641                 {0, NULL, 0, NULL, NULL}
642         };
643
644 #define TEXTURE_CAPABILITY(prop_name_, ui_name_)                          \
645         prop = RNA_def_property(srna, #prop_name_,                          \
646                                 PROP_BOOLEAN, PROP_NONE);                   \
647         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
648         RNA_def_property_boolean_funcs(prop, "rna_TextureCapabilities_"      \
649                                        #prop_name_ "_get", NULL);           \
650         RNA_def_property_ui_text(prop, ui_name_, NULL)
651         
652         
653         srna = RNA_def_struct(brna, "BrushTextureSlot", "TextureSlot");
654         RNA_def_struct_sdna(srna, "MTex");
655         RNA_def_struct_ui_text(srna, "Brush Texture Slot", "Texture slot for textures in a Brush data-block");
656
657         prop = RNA_def_property(srna, "angle", PROP_FLOAT, PROP_ANGLE);
658         RNA_def_property_float_sdna(prop, NULL, "rot");
659         RNA_def_property_range(prop, 0, M_PI * 2);
660         RNA_def_property_ui_text(prop, "Angle", "Brush texture rotation");
661         RNA_def_property_update(prop, 0, "rna_TextureSlot_brush_angle_update");
662
663         prop = RNA_def_property(srna, "map_mode", PROP_ENUM, PROP_NONE);
664         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
665         RNA_def_property_enum_items(prop, prop_map_mode_items);
666         RNA_def_property_ui_text(prop, "Mode", "");
667         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
668
669         prop = RNA_def_property(srna, "tex_paint_map_mode", PROP_ENUM, PROP_NONE);
670         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
671         RNA_def_property_enum_items(prop, prop_tex_paint_map_mode_items);
672         RNA_def_property_ui_text(prop, "Mode", "");
673         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
674
675         prop = RNA_def_property(srna, "mask_map_mode", PROP_ENUM, PROP_NONE);
676         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
677         RNA_def_property_enum_items(prop, prop_mask_paint_map_mode_items);
678         RNA_def_property_ui_text(prop, "Mode", "");
679         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
680
681         prop = RNA_def_property(srna, "use_rake", PROP_BOOLEAN, PROP_NONE);
682         RNA_def_property_boolean_sdna(prop, NULL, "brush_angle_mode", MTEX_ANGLE_RAKE);
683         RNA_def_property_ui_text(prop, "Rake", "");
684         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
685
686         prop = RNA_def_property(srna, "use_random", PROP_BOOLEAN, PROP_NONE);
687         RNA_def_property_boolean_sdna(prop, NULL, "brush_angle_mode", MTEX_ANGLE_RANDOM);
688         RNA_def_property_ui_text(prop, "Random", "");
689         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
690
691         prop = RNA_def_property(srna, "random_angle", PROP_FLOAT, PROP_ANGLE);
692         RNA_def_property_range(prop, 0, M_PI * 2);
693         RNA_def_property_ui_text(prop, "Random Angle", "Brush texture random angle");
694         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
695         
696         TEXTURE_CAPABILITY(has_texture_angle_source, "Has Texture Angle Source");
697         TEXTURE_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
698         TEXTURE_CAPABILITY(has_texture_angle, "Has Texture Angle Source");      
699 }
700
701 static void rna_def_sculpt_capabilities(BlenderRNA *brna)
702 {
703         StructRNA *srna;
704         PropertyRNA *prop;
705
706         srna = RNA_def_struct(brna, "SculptToolCapabilities", NULL);
707         RNA_def_struct_sdna(srna, "Brush");
708         RNA_def_struct_nested(brna, srna, "Brush");
709         RNA_def_struct_ui_text(srna, "Sculpt Capabilities",
710                                "Read-only indications of which brush operations "
711                                "are supported by the current sculpt tool");
712
713 #define SCULPT_TOOL_CAPABILITY(prop_name_, ui_name_)                      \
714         prop = RNA_def_property(srna, #prop_name_,                          \
715                                 PROP_BOOLEAN, PROP_NONE);                   \
716         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
717         RNA_def_property_boolean_funcs(prop, "rna_SculptToolCapabilities_"      \
718                                        #prop_name_ "_get", NULL);           \
719         RNA_def_property_ui_text(prop, ui_name_, NULL)
720
721         SCULPT_TOOL_CAPABILITY(has_accumulate, "Has Accumulate");
722         SCULPT_TOOL_CAPABILITY(has_auto_smooth, "Has Auto Smooth");
723         SCULPT_TOOL_CAPABILITY(has_height, "Has Height");
724         SCULPT_TOOL_CAPABILITY(has_jitter, "Has Jitter");
725         SCULPT_TOOL_CAPABILITY(has_normal_weight, "Has Crease/Pinch Factor");
726         SCULPT_TOOL_CAPABILITY(has_rake_factor, "Has Rake Factor");
727         SCULPT_TOOL_CAPABILITY(has_persistence, "Has Persistence");
728         SCULPT_TOOL_CAPABILITY(has_pinch_factor, "Has Pinch Factor");
729         SCULPT_TOOL_CAPABILITY(has_plane_offset, "Has Plane Offset");
730         SCULPT_TOOL_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
731         SCULPT_TOOL_CAPABILITY(has_sculpt_plane, "Has Sculpt Plane");
732         SCULPT_TOOL_CAPABILITY(has_secondary_color, "Has Secondary Color");
733         SCULPT_TOOL_CAPABILITY(has_smooth_stroke, "Has Smooth Stroke");
734         SCULPT_TOOL_CAPABILITY(has_space_attenuation, "Has Space Attenuation");
735         SCULPT_TOOL_CAPABILITY(has_strength_pressure, "Has Strength Pressure");
736         SCULPT_TOOL_CAPABILITY(has_gravity, "Has Gravity");
737
738 #undef SCULPT_CAPABILITY
739 }
740
741 static void rna_def_brush_capabilities(BlenderRNA *brna)
742 {
743         StructRNA *srna;
744         PropertyRNA *prop;
745
746         srna = RNA_def_struct(brna, "BrushCapabilities", NULL);
747         RNA_def_struct_sdna(srna, "Brush");
748         RNA_def_struct_nested(brna, srna, "Brush");
749         RNA_def_struct_ui_text(srna, "Brush Capabilities",
750                                "Read-only indications of which brush operations "
751                                "are supported by the current brush");
752
753 #define BRUSH_CAPABILITY(prop_name_, ui_name_)                          \
754         prop = RNA_def_property(srna, #prop_name_,                          \
755                                 PROP_BOOLEAN, PROP_NONE);                   \
756         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
757         RNA_def_property_boolean_funcs(prop, "rna_BrushCapabilities_"      \
758                                        #prop_name_ "_get", NULL);           \
759         RNA_def_property_ui_text(prop, ui_name_, NULL)
760
761         BRUSH_CAPABILITY(has_overlay, "Has Overlay");
762         BRUSH_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
763         BRUSH_CAPABILITY(has_spacing, "Has Spacing");
764         BRUSH_CAPABILITY(has_smooth_stroke, "Has Smooth Stroke");
765
766
767 #undef BRUSH_CAPABILITY
768 }
769
770 static void rna_def_image_paint_capabilities(BlenderRNA *brna)
771 {
772         StructRNA *srna;
773         PropertyRNA *prop;
774
775         srna = RNA_def_struct(brna, "ImapaintToolCapabilities", NULL);
776         RNA_def_struct_sdna(srna, "Brush");
777         RNA_def_struct_nested(brna, srna, "Brush");
778         RNA_def_struct_ui_text(srna, "Image Paint Capabilities",
779                                "Read-only indications of which brush operations "
780                                "are supported by the current image paint brush");
781
782 #define IMAPAINT_TOOL_CAPABILITY(prop_name_, ui_name_)                       \
783         prop = RNA_def_property(srna, #prop_name_,                               \
784                                 PROP_BOOLEAN, PROP_NONE);                        \
785         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                        \
786         RNA_def_property_boolean_funcs(prop, "rna_ImapaintToolCapabilities_"     \
787                                        #prop_name_ "_get", NULL);                \
788         RNA_def_property_ui_text(prop, ui_name_, NULL)
789
790         IMAPAINT_TOOL_CAPABILITY(has_accumulate, "Has Accumulate");
791         IMAPAINT_TOOL_CAPABILITY(has_space_attenuation, "Has Space Attenuation");
792         IMAPAINT_TOOL_CAPABILITY(has_radius, "Has Radius");
793
794 #undef IMAPAINT_TOOL_CAPABILITY
795 }
796
797 static void rna_def_brush(BlenderRNA *brna)
798 {
799         StructRNA *srna;
800         PropertyRNA *prop;
801         
802         static const EnumPropertyItem prop_blend_items[] = {
803                 {IMB_BLEND_MIX, "MIX", 0, "Mix", "Use mix blending mode while painting"},
804                 {IMB_BLEND_ADD, "ADD", 0, "Add", "Use add blending mode while painting"},
805                 {IMB_BLEND_SUB, "SUB", 0, "Subtract", "Use subtract blending mode while painting"},
806                 {IMB_BLEND_MUL, "MUL", 0, "Multiply", "Use multiply blending mode while painting"},
807                 {IMB_BLEND_LIGHTEN, "LIGHTEN", 0, "Lighten", "Use lighten blending mode while painting"},
808                 {IMB_BLEND_DARKEN, "DARKEN", 0, "Darken", "Use darken blending mode while painting"},
809                 {IMB_BLEND_ERASE_ALPHA, "ERASE_ALPHA", 0, "Erase Alpha", "Erase alpha while painting"},
810                 {IMB_BLEND_ADD_ALPHA, "ADD_ALPHA", 0, "Add Alpha", "Add alpha while painting"},
811                 {IMB_BLEND_OVERLAY, "OVERLAY", 0, "Overlay", "Use overlay blending mode while painting"},
812                 {IMB_BLEND_HARDLIGHT, "HARDLIGHT", 0, "Hard light", "Use hard light blending mode while painting"},
813                 {IMB_BLEND_COLORBURN, "COLORBURN", 0, "Color burn", "Use color burn blending mode while painting"},
814                 {IMB_BLEND_LINEARBURN, "LINEARBURN", 0, "Linear burn", "Use linear burn blending mode while painting"},
815                 {IMB_BLEND_COLORDODGE, "COLORDODGE", 0, "Color dodge", "Use color dodge blending mode while painting"},
816                 {IMB_BLEND_SCREEN, "SCREEN", 0, "Screen", "Use screen blending mode while painting"},
817                 {IMB_BLEND_SOFTLIGHT, "SOFTLIGHT", 0, "Soft light", "Use softlight blending mode while painting"},
818                 {IMB_BLEND_PINLIGHT, "PINLIGHT", 0, "Pin light", "Use pinlight blending mode while painting"},
819                 {IMB_BLEND_VIVIDLIGHT, "VIVIDLIGHT", 0, "Vivid light", "Use vividlight blending mode while painting"},
820                 {IMB_BLEND_LINEARLIGHT, "LINEARLIGHT", 0, "Linear light", "Use linearlight blending mode while painting"},
821                 {IMB_BLEND_DIFFERENCE, "DIFFERENCE", 0, "Difference", "Use difference blending mode while painting"},
822                 {IMB_BLEND_EXCLUSION, "EXCLUSION", 0, "Exclusion", "Use exclusion blending mode while painting"},
823                 {IMB_BLEND_HUE, "HUE", 0, "Hue", "Use hue blending mode while painting"},
824                 {IMB_BLEND_SATURATION, "SATURATION", 0, "Saturation", "Use saturation blending mode while painting"},
825                 {IMB_BLEND_LUMINOSITY, "LUMINOSITY", 0, "Luminosity", "Use luminosity blending mode while painting"},
826                 {IMB_BLEND_COLOR, "COLOR", 0, "Color", "Use color blending mode while painting"},
827                 {0, NULL, 0, NULL, NULL}
828         };
829         
830         static const EnumPropertyItem brush_sculpt_plane_items[] = {
831                 {SCULPT_DISP_DIR_AREA, "AREA", 0, "Area Plane", ""},
832                 {SCULPT_DISP_DIR_VIEW, "VIEW", 0, "View Plane", ""},
833                 {SCULPT_DISP_DIR_X, "X", 0, "X Plane", ""},
834                 {SCULPT_DISP_DIR_Y, "Y", 0, "Y Plane", ""},
835                 {SCULPT_DISP_DIR_Z, "Z", 0, "Z Plane", ""},
836                 {0, NULL, 0, NULL, NULL}
837         };
838
839         static const EnumPropertyItem brush_mask_tool_items[] = {
840                 {BRUSH_MASK_DRAW, "DRAW", 0, "Draw", ""},
841                 {BRUSH_MASK_SMOOTH, "SMOOTH", 0, "Smooth", ""},
842                 {0, NULL, 0, NULL, NULL}
843         };
844
845         static const EnumPropertyItem brush_blur_mode_items[] = {
846                 {KERNEL_BOX, "BOX", 0, "Box", ""},
847                 {KERNEL_GAUSSIAN, "GAUSSIAN", 0, "Gaussian", ""},
848                 {0, NULL, 0, NULL, NULL}
849         };
850
851         static const EnumPropertyItem brush_gradient_items[] = {
852                 {BRUSH_GRADIENT_PRESSURE, "PRESSURE", 0, "Pressure", ""},
853                 {BRUSH_GRADIENT_SPACING_REPEAT, "SPACING_REPEAT", 0, "Repeat", ""},
854                 {BRUSH_GRADIENT_SPACING_CLAMP, "SPACING_CLAMP", 0, "Clamp", ""},
855                 {0, NULL, 0, NULL, NULL}
856         };
857
858         static const EnumPropertyItem brush_gradient_fill_items[] = {
859                 {BRUSH_GRADIENT_LINEAR, "LINEAR", 0, "Linear", ""},
860                 {BRUSH_GRADIENT_RADIAL, "RADIAL", 0, "Radial", ""},
861                 {0, NULL, 0, NULL, NULL}
862         };
863
864         static const EnumPropertyItem brush_mask_pressure_items[] = {
865                 {0, "NONE", 0, "Off", ""},
866                 {BRUSH_MASK_PRESSURE_RAMP, "RAMP", ICON_STYLUS_PRESSURE, "Ramp", ""},
867                 {BRUSH_MASK_PRESSURE_CUTOFF, "CUTOFF", ICON_STYLUS_PRESSURE, "Cutoff", ""},
868                 {0, NULL, 0, NULL, NULL}
869         };
870
871         srna = RNA_def_struct(brna, "Brush", "ID");
872         RNA_def_struct_ui_text(srna, "Brush", "Brush data-block for storing brush settings for painting and sculpting");
873         RNA_def_struct_ui_icon(srna, ICON_BRUSH_DATA);
874
875         /* enums */
876         prop = RNA_def_property(srna, "blend", PROP_ENUM, PROP_NONE);
877         RNA_def_property_enum_items(prop, prop_blend_items);
878         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
879         RNA_def_property_update(prop, 0, "rna_Brush_update");
880
881         prop = RNA_def_property(srna, "sculpt_tool", PROP_ENUM, PROP_NONE);
882         RNA_def_property_enum_items(prop, rna_enum_brush_sculpt_tool_items);
883         RNA_def_property_ui_text(prop, "Sculpt Tool", "");
884         RNA_def_property_update(prop, 0, "rna_Brush_sculpt_tool_update");
885
886         prop = RNA_def_property(srna, "vertex_tool", PROP_ENUM, PROP_NONE);
887         RNA_def_property_enum_sdna(prop, NULL, "vertexpaint_tool");
888         RNA_def_property_enum_items(prop, rna_enum_brush_vertex_tool_items);
889         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
890         RNA_def_property_update(prop, 0, "rna_Brush_vertex_tool_update");
891         
892         prop = RNA_def_property(srna, "image_tool", PROP_ENUM, PROP_NONE);
893         RNA_def_property_enum_sdna(prop, NULL, "imagepaint_tool");
894         RNA_def_property_enum_items(prop, rna_enum_brush_image_tool_items);
895         RNA_def_property_ui_text(prop, "Image Paint Tool", "");
896         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_imagepaint_tool_update");
897
898         prop = RNA_def_property(srna, "direction", PROP_ENUM, PROP_NONE);
899         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
900         RNA_def_property_enum_items(prop, prop_direction_items);
901         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Brush_direction_itemf");
902         RNA_def_property_ui_text(prop, "Direction", "");
903         RNA_def_property_update(prop, 0, "rna_Brush_update");
904
905         prop = RNA_def_property(srna, "stroke_method", PROP_ENUM, PROP_NONE);
906         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
907         RNA_def_property_enum_items(prop, sculpt_stroke_method_items);
908         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Brush_stroke_itemf");
909         RNA_def_property_ui_text(prop, "Stroke Method", "");
910         RNA_def_property_update(prop, 0, "rna_Brush_stroke_update");
911
912         prop = RNA_def_property(srna, "sculpt_plane", PROP_ENUM, PROP_NONE);
913         RNA_def_property_enum_items(prop, brush_sculpt_plane_items);
914         RNA_def_property_ui_text(prop, "Sculpt Plane", "");
915         RNA_def_property_update(prop, 0, "rna_Brush_update");
916
917         prop = RNA_def_property(srna, "mask_tool", PROP_ENUM, PROP_NONE);
918         RNA_def_property_enum_items(prop, brush_mask_tool_items);
919         RNA_def_property_ui_text(prop, "Mask Tool", "");
920         RNA_def_property_update(prop, 0, "rna_Brush_update");
921         
922         /* number values */
923         prop = RNA_def_property(srna, "size", PROP_INT, PROP_PIXEL);
924         RNA_def_property_int_funcs(prop, NULL, "rna_Brush_set_size", NULL);
925         RNA_def_property_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS * 10);
926         RNA_def_property_ui_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS, 1, -1);
927         RNA_def_property_ui_text(prop, "Radius", "Radius of the brush in pixels");
928         RNA_def_property_update(prop, 0, "rna_Brush_size_update");
929         
930         prop = RNA_def_property(srna, "unprojected_radius", PROP_FLOAT, PROP_DISTANCE);
931         RNA_def_property_float_funcs(prop, NULL, "rna_Brush_set_unprojected_radius", NULL);
932         RNA_def_property_range(prop, 0.001, FLT_MAX);
933         RNA_def_property_ui_range(prop, 0.001, 1, 0, -1);
934         RNA_def_property_ui_text(prop, "Unprojected Radius", "Radius of brush in Blender units");
935         RNA_def_property_update(prop, 0, "rna_Brush_size_update");
936
937         prop = RNA_def_property(srna, "jitter", PROP_FLOAT, PROP_NONE);
938         RNA_def_property_float_sdna(prop, NULL, "jitter");
939         RNA_def_property_range(prop, 0.0f, 1000.0f);
940         RNA_def_property_ui_range(prop, 0.0f, 2.0f, 0.1, 4);
941         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush while painting");
942         RNA_def_property_update(prop, 0, "rna_Brush_update");
943
944         prop = RNA_def_property(srna, "jitter_absolute", PROP_INT, PROP_PIXEL);
945         RNA_def_property_int_sdna(prop, NULL, "jitter_absolute");
946         RNA_def_property_range(prop, 0, 1000000);
947         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush in pixels while painting");
948         RNA_def_property_update(prop, 0, "rna_Brush_update");
949
950         prop = RNA_def_property(srna, "spacing", PROP_INT, PROP_PERCENTAGE);
951         RNA_def_property_int_sdna(prop, NULL, "spacing");
952         RNA_def_property_range(prop, 1, 1000);
953         RNA_def_property_ui_range(prop, 1, 500, 5, -1);
954         RNA_def_property_ui_text(prop, "Spacing", "Spacing between brush daubs as a percentage of brush diameter");
955         RNA_def_property_update(prop, 0, "rna_Brush_update");
956
957         prop = RNA_def_property(srna, "grad_spacing", PROP_INT, PROP_NONE);
958         RNA_def_property_int_sdna(prop, NULL, "gradient_spacing");
959         RNA_def_property_range(prop, 1, 10000);
960         RNA_def_property_ui_range(prop, 1, 10000, 5, -1);
961         RNA_def_property_ui_text(prop, "Gradient Spacing", "Spacing before brush gradient goes full circle");
962         RNA_def_property_update(prop, 0, "rna_Brush_update");
963
964         prop = RNA_def_property(srna, "smooth_stroke_radius", PROP_INT, PROP_NONE);
965         RNA_def_property_range(prop, 10, 200);
966         RNA_def_property_ui_text(prop, "Smooth Stroke Radius", "Minimum distance from last point before stroke continues");
967         RNA_def_property_update(prop, 0, "rna_Brush_update");
968
969         prop = RNA_def_property(srna, "smooth_stroke_factor", PROP_FLOAT, PROP_FACTOR);
970         RNA_def_property_range(prop, 0.5, 0.99);
971         RNA_def_property_ui_text(prop, "Smooth Stroke Factor", "Higher values give a smoother stroke");
972         RNA_def_property_update(prop, 0, "rna_Brush_update");
973         
974         prop = RNA_def_property(srna, "rate", PROP_FLOAT, PROP_NONE);
975         RNA_def_property_float_sdna(prop, NULL, "rate");
976         RNA_def_property_range(prop, 0.0001f, 10000.0f);
977         RNA_def_property_ui_range(prop, 0.01f, 1.0f, 1, 3);
978         RNA_def_property_ui_text(prop, "Rate", "Interval between paints for Airbrush");
979         RNA_def_property_update(prop, 0, "rna_Brush_update");
980         
981         prop = RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR_GAMMA);
982         RNA_def_property_range(prop, 0.0, 1.0);
983         RNA_def_property_float_sdna(prop, NULL, "rgb");
984         RNA_def_property_ui_text(prop, "Color", "");
985         RNA_def_property_update(prop, 0, "rna_Brush_update");
986
987         prop = RNA_def_property(srna, "secondary_color", PROP_FLOAT, PROP_COLOR_GAMMA);
988         RNA_def_property_range(prop, 0.0, 1.0);
989         RNA_def_property_float_sdna(prop, NULL, "secondary_rgb");
990         RNA_def_property_ui_text(prop, "Secondary Color", "");
991         RNA_def_property_update(prop, 0, "rna_Brush_update");
992
993         prop = RNA_def_property(srna, "weight", PROP_FLOAT, PROP_FACTOR);
994         RNA_def_property_float_default(prop, 1.0f);
995         RNA_def_property_range(prop, 0.0f, 1.0f);
996         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
997         RNA_def_property_ui_text(prop, "Weight", "Vertex weight when brush is applied");
998         RNA_def_property_update(prop, 0, "rna_Brush_update");
999
1000         prop = RNA_def_property(srna, "strength", PROP_FLOAT, PROP_FACTOR);
1001         RNA_def_property_float_sdna(prop, NULL, "alpha");
1002         RNA_def_property_float_default(prop, 0.5f);
1003         RNA_def_property_range(prop, 0.0f, 10.0f);
1004         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1005         RNA_def_property_ui_text(prop, "Strength", "How powerful the effect of the brush is when applied");
1006         RNA_def_property_update(prop, 0, "rna_Brush_update");
1007
1008         prop = RNA_def_property(srna, "plane_offset", PROP_FLOAT, PROP_DISTANCE);
1009         RNA_def_property_float_sdna(prop, NULL, "plane_offset");
1010         RNA_def_property_float_default(prop, 0);
1011         RNA_def_property_range(prop, -2.0f, 2.0f);
1012         RNA_def_property_ui_range(prop, -0.5f, 0.5f, 0.001, 3);
1013         RNA_def_property_ui_text(prop, "Plane Offset",
1014                                  "Adjust plane on which the brush acts towards or away from the object surface");
1015         RNA_def_property_update(prop, 0, "rna_Brush_update");
1016
1017         prop = RNA_def_property(srna, "plane_trim", PROP_FLOAT, PROP_DISTANCE);
1018         RNA_def_property_float_sdna(prop, NULL, "plane_trim");
1019         RNA_def_property_float_default(prop, 0.5f);
1020         RNA_def_property_range(prop, 0, 1.0f);
1021         RNA_def_property_ui_text(prop, "Plane Trim",
1022                                  "If a vertex is further away from offset plane than this, then it is not affected");
1023         RNA_def_property_update(prop, 0, "rna_Brush_update");
1024
1025         prop = RNA_def_property(srna, "height", PROP_FLOAT, PROP_DISTANCE);
1026         RNA_def_property_float_sdna(prop, NULL, "height");
1027         RNA_def_property_float_default(prop, 0.5f);
1028         RNA_def_property_range(prop, 0, 1.0f);
1029         RNA_def_property_ui_text(prop, "Brush Height", "Affectable height of brush (layer height for layer tool, i.e.)");
1030         RNA_def_property_update(prop, 0, "rna_Brush_update");
1031
1032         prop = RNA_def_property(srna, "texture_sample_bias", PROP_FLOAT, PROP_DISTANCE);
1033         RNA_def_property_float_sdna(prop, NULL, "texture_sample_bias");
1034         RNA_def_property_float_default(prop, 0);
1035         RNA_def_property_range(prop, -1, 1);
1036         RNA_def_property_ui_text(prop, "Texture Sample Bias", "Value added to texture samples");
1037         RNA_def_property_update(prop, 0, "rna_Brush_update");
1038
1039         prop = RNA_def_property(srna, "normal_weight", PROP_FLOAT, PROP_FACTOR);
1040         RNA_def_property_float_sdna(prop, NULL, "normal_weight");
1041         RNA_def_property_float_default(prop, 0);
1042         RNA_def_property_range(prop, 0.0f, 1.0f);
1043         RNA_def_property_ui_text(prop, "Normal Weight", "How much grab will pull vertexes out of surface during a grab");
1044         RNA_def_property_update(prop, 0, "rna_Brush_update");
1045
1046         prop = RNA_def_property(srna, "rake_factor", PROP_FLOAT, PROP_FACTOR);
1047         RNA_def_property_float_sdna(prop, NULL, "rake_factor");
1048         RNA_def_property_float_default(prop, 0);
1049         RNA_def_property_range(prop, 0.0f, 10.0f);
1050         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1051         RNA_def_property_ui_text(prop, "Rake", "How much grab will follow cursor rotation");
1052         RNA_def_property_update(prop, 0, "rna_Brush_update");
1053
1054         prop = RNA_def_property(srna, "crease_pinch_factor", PROP_FLOAT, PROP_FACTOR);
1055         RNA_def_property_float_sdna(prop, NULL, "crease_pinch_factor");
1056         RNA_def_property_float_default(prop, 2.0f / 3.0f);
1057         RNA_def_property_range(prop, 0.0f, 1.0f);
1058         RNA_def_property_ui_text(prop, "Crease Brush Pinch Factor", "How much the crease brush pinches");
1059         RNA_def_property_update(prop, 0, "rna_Brush_update");
1060
1061         prop = RNA_def_property(srna, "auto_smooth_factor", PROP_FLOAT, PROP_FACTOR);
1062         RNA_def_property_float_sdna(prop, NULL, "autosmooth_factor");
1063         RNA_def_property_float_default(prop, 0);
1064         RNA_def_property_range(prop, 0.0f, 1.0f);
1065         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1066         RNA_def_property_ui_text(prop, "Autosmooth", "Amount of smoothing to automatically apply to each stroke");
1067         RNA_def_property_update(prop, 0, "rna_Brush_update");
1068
1069         prop = RNA_def_property(srna, "stencil_pos", PROP_FLOAT, PROP_XYZ);
1070         RNA_def_property_float_sdna(prop, NULL, "stencil_pos");
1071         RNA_def_property_array(prop, 2);
1072         RNA_def_property_ui_text(prop, "Stencil Position", "Position of stencil in viewport");
1073         RNA_def_property_update(prop, 0, "rna_Brush_update");
1074
1075         prop = RNA_def_property(srna, "stencil_dimension", PROP_FLOAT, PROP_XYZ);
1076         RNA_def_property_float_sdna(prop, NULL, "stencil_dimension");
1077         RNA_def_property_array(prop, 2);
1078         RNA_def_property_ui_text(prop, "Stencil Dimensions", "Dimensions of stencil in viewport");
1079         RNA_def_property_update(prop, 0, "rna_Brush_update");
1080
1081         prop = RNA_def_property(srna, "mask_stencil_pos", PROP_FLOAT, PROP_XYZ);
1082         RNA_def_property_float_sdna(prop, NULL, "mask_stencil_pos");
1083         RNA_def_property_array(prop, 2);
1084         RNA_def_property_ui_text(prop, "Mask Stencil Position", "Position of mask stencil in viewport");
1085         RNA_def_property_update(prop, 0, "rna_Brush_update");
1086
1087         prop = RNA_def_property(srna, "mask_stencil_dimension", PROP_FLOAT, PROP_XYZ);
1088         RNA_def_property_float_sdna(prop, NULL, "mask_stencil_dimension");
1089         RNA_def_property_array(prop, 2);
1090         RNA_def_property_ui_text(prop, "Mask Stencil Dimensions", "Dimensions of mask stencil in viewport");
1091         RNA_def_property_update(prop, 0, "rna_Brush_update");
1092
1093         prop = RNA_def_property(srna, "sharp_threshold", PROP_FLOAT, PROP_NONE);
1094         RNA_def_property_range(prop, 0.0, 100.0);
1095         RNA_def_property_ui_range(prop, 0.0, 1.0, 1, 3);
1096         RNA_def_property_float_sdna(prop, NULL, "sharp_threshold");
1097         RNA_def_property_ui_text(prop, "Sharp Threshold", "Threshold below which, no sharpening is done");
1098         RNA_def_property_update(prop, 0, "rna_Brush_update");
1099
1100         prop = RNA_def_property(srna, "fill_threshold", PROP_FLOAT, PROP_NONE);
1101         RNA_def_property_range(prop, 0.0, 100.0);
1102         RNA_def_property_ui_range(prop, 0.0, 1.0, 1, 3);
1103         RNA_def_property_float_sdna(prop, NULL, "fill_threshold");
1104         RNA_def_property_ui_text(prop, "Fill Threshold", "Threshold above which filling is not propagated");
1105         RNA_def_property_update(prop, 0, "rna_Brush_update");
1106
1107         prop = RNA_def_property(srna, "blur_kernel_radius", PROP_INT, PROP_NONE);
1108         RNA_def_property_int_sdna(prop, NULL, "blur_kernel_radius");
1109         RNA_def_property_range(prop, 1, 10000);
1110         RNA_def_property_ui_range(prop, 1, 50, 1, -1);
1111         RNA_def_property_ui_text(prop, "Kernel Radius", "Radius of kernel used for soften and sharpen in pixels");
1112         RNA_def_property_update(prop, 0, "rna_Brush_update");
1113
1114         prop = RNA_def_property(srna, "blur_mode", PROP_ENUM, PROP_NONE);
1115         RNA_def_property_enum_items(prop, brush_blur_mode_items);
1116         RNA_def_property_ui_text(prop, "Blur Mode", "");
1117         RNA_def_property_update(prop, 0, "rna_Brush_update");
1118
1119         prop = RNA_def_property(srna, "falloff_angle", PROP_FLOAT, PROP_ANGLE);
1120         RNA_def_property_float_sdna(prop, NULL, "falloff_angle");
1121         RNA_def_property_range(prop, 0, M_PI / 2);
1122         RNA_def_property_ui_text(prop, "Falloff Angle",
1123                                  "Paint most on faces pointing towards the view according to this angle");
1124         RNA_def_property_update(prop, 0, "rna_Brush_update");
1125
1126         /* flag */
1127         /* This is an enum but its unlikely we add other shapes, so expose as a boolean. */
1128         prop = RNA_def_property(srna, "use_projected", PROP_BOOLEAN, PROP_NONE);
1129         RNA_def_property_boolean_sdna(prop, NULL, "falloff_shape", BRUSH_AIRBRUSH);
1130         RNA_def_property_ui_text(prop, "2D Falloff", "Apply brush influence in 2D circle instead of a sphere");
1131         RNA_def_property_update(prop, 0, "rna_Brush_update");
1132
1133         prop = RNA_def_property(srna, "use_airbrush", PROP_BOOLEAN, PROP_NONE);
1134         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_AIRBRUSH);
1135         RNA_def_property_ui_text(prop, "Airbrush", "Keep applying paint effect while holding mouse (spray)");
1136         RNA_def_property_update(prop, 0, "rna_Brush_update");
1137         
1138         prop = RNA_def_property(srna, "use_original_normal", PROP_BOOLEAN, PROP_NONE);
1139         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ORIGINAL_NORMAL);
1140         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1141         RNA_def_property_ui_text(prop, "Original Normal",
1142                                  "When locked keep using normal of surface where stroke was initiated");
1143         RNA_def_property_update(prop, 0, "rna_Brush_update");
1144                 
1145         prop = RNA_def_property(srna, "use_pressure_strength", PROP_BOOLEAN, PROP_NONE);
1146         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ALPHA_PRESSURE);
1147         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1148         RNA_def_property_ui_text(prop, "Strength Pressure", "Enable tablet pressure sensitivity for strength");
1149         RNA_def_property_update(prop, 0, "rna_Brush_update");
1150         
1151         prop = RNA_def_property(srna, "use_offset_pressure", PROP_BOOLEAN, PROP_NONE);
1152         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_OFFSET_PRESSURE);
1153         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1154         RNA_def_property_ui_text(prop, "Plane Offset Pressure", "Enable tablet pressure sensitivity for offset");
1155         RNA_def_property_update(prop, 0, "rna_Brush_update");
1156
1157         prop = RNA_def_property(srna, "use_pressure_size", PROP_BOOLEAN, PROP_NONE);
1158         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SIZE_PRESSURE);
1159         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1160         RNA_def_property_ui_text(prop, "Size Pressure", "Enable tablet pressure sensitivity for size");
1161         RNA_def_property_update(prop, 0, "rna_Brush_update");
1162
1163         prop = RNA_def_property(srna, "use_gradient", PROP_BOOLEAN, PROP_NONE);
1164         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_USE_GRADIENT);
1165         RNA_def_property_boolean_funcs(prop, NULL, "rna_Brush_use_gradient_set");
1166         RNA_def_property_ui_text(prop, "Use Gradient", "Use Gradient by utilizing a sampling method");
1167         RNA_def_property_update(prop, 0, "rna_Brush_update");
1168
1169         prop = RNA_def_property(srna, "use_pressure_jitter", PROP_BOOLEAN, PROP_NONE);
1170         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_JITTER_PRESSURE);
1171         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1172         RNA_def_property_ui_text(prop, "Jitter Pressure", "Enable tablet pressure sensitivity for jitter");
1173         RNA_def_property_update(prop, 0, "rna_Brush_update");
1174
1175         prop = RNA_def_property(srna, "use_pressure_spacing", PROP_BOOLEAN, PROP_NONE);
1176         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACING_PRESSURE);
1177         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1178         RNA_def_property_ui_text(prop, "Spacing Pressure", "Enable tablet pressure sensitivity for spacing");
1179         RNA_def_property_update(prop, 0, "rna_Brush_update");
1180
1181         prop = RNA_def_property(srna, "use_pressure_masking", PROP_ENUM, PROP_NONE);
1182         RNA_def_property_enum_sdna(prop, NULL, "mask_pressure");
1183         RNA_def_property_enum_items(prop, brush_mask_pressure_items);
1184         RNA_def_property_ui_text(prop, "Mask Pressure Mode", "Pen pressure makes texture influence smaller");
1185         RNA_def_property_update(prop, 0, "rna_Brush_update");
1186
1187         prop = RNA_def_property(srna, "use_inverse_smooth_pressure", PROP_BOOLEAN, PROP_NONE);
1188         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_INVERSE_SMOOTH_PRESSURE);
1189         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1190         RNA_def_property_ui_text(prop, "Inverse Smooth Pressure", "Lighter pressure causes more smoothing to be applied");
1191         RNA_def_property_update(prop, 0, "rna_Brush_update");
1192         
1193         prop = RNA_def_property(srna, "use_relative_jitter", PROP_BOOLEAN, PROP_NONE);
1194         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_ABSOLUTE_JITTER);
1195         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1196         RNA_def_property_ui_text(prop, "Absolute Jitter", "Jittering happens in screen space, not relative to brush size");
1197         RNA_def_property_update(prop, 0, "rna_Brush_update");
1198
1199         prop = RNA_def_property(srna, "use_plane_trim", PROP_BOOLEAN, PROP_NONE);
1200         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PLANE_TRIM);
1201         RNA_def_property_ui_text(prop, "Use Plane Trim", "Enable Plane Trim");
1202         RNA_def_property_update(prop, 0, "rna_Brush_update");
1203
1204         prop = RNA_def_property(srna, "use_frontface", PROP_BOOLEAN, PROP_NONE);
1205         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FRONTFACE);
1206         RNA_def_property_ui_text(prop, "Use Front-Face", "Brush only affects vertexes that face the viewer");
1207         RNA_def_property_update(prop, 0, "rna_Brush_update");
1208
1209         prop = RNA_def_property(srna, "use_frontface_falloff", PROP_BOOLEAN, PROP_NONE);
1210         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FRONTFACE_FALLOFF);
1211         RNA_def_property_ui_text(prop, "Use Front-Face Falloff", "Blend brush influence by how much they face the front");
1212         RNA_def_property_update(prop, 0, "rna_Brush_update");
1213
1214         prop = RNA_def_property(srna, "use_anchor", PROP_BOOLEAN, PROP_NONE);
1215         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ANCHORED);
1216         RNA_def_property_ui_text(prop, "Anchored", "Keep the brush anchored to the initial location");
1217         RNA_def_property_update(prop, 0, "rna_Brush_update");
1218
1219         prop = RNA_def_property(srna, "use_space", PROP_BOOLEAN, PROP_NONE);
1220         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE);
1221         RNA_def_property_ui_text(prop, "Space", "Limit brush application to the distance specified by spacing");
1222         RNA_def_property_update(prop, 0, "rna_Brush_update");
1223
1224         prop = RNA_def_property(srna, "use_line", PROP_BOOLEAN, PROP_NONE);
1225         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_LINE);
1226         RNA_def_property_ui_text(prop, "Line", "Draw a line with dabs separated according to spacing");
1227         RNA_def_property_update(prop, 0, "rna_Brush_update");
1228
1229         prop = RNA_def_property(srna, "use_curve", PROP_BOOLEAN, PROP_NONE);
1230         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_CURVE);
1231         RNA_def_property_ui_text(prop, "Curve", "Define the stroke curve with a bezier curve. Dabs are separated according to spacing");
1232         RNA_def_property_update(prop, 0, "rna_Brush_update");
1233
1234         prop = RNA_def_property(srna, "use_smooth_stroke", PROP_BOOLEAN, PROP_NONE);
1235         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SMOOTH_STROKE);
1236         RNA_def_property_ui_text(prop, "Smooth Stroke", "Brush lags behind mouse and follows a smoother path");
1237         RNA_def_property_update(prop, 0, "rna_Brush_update");
1238
1239         prop = RNA_def_property(srna, "use_persistent", PROP_BOOLEAN, PROP_NONE);
1240         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PERSISTENT);
1241         RNA_def_property_ui_text(prop, "Persistent", "Sculpt on a persistent layer of the mesh");
1242         RNA_def_property_update(prop, 0, "rna_Brush_update");
1243
1244         prop = RNA_def_property(srna, "use_accumulate", PROP_BOOLEAN, PROP_NONE);
1245         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ACCUMULATE);
1246         RNA_def_property_ui_text(prop, "Accumulate", "Accumulate stroke daubs on top of each other");
1247         RNA_def_property_update(prop, 0, "rna_Brush_update");
1248         
1249         prop = RNA_def_property(srna, "use_space_attenuation", PROP_BOOLEAN, PROP_NONE);
1250         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE_ATTEN);
1251         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1252         RNA_def_property_ui_text(prop, "Use Automatic Strength Adjustment",
1253                                  "Automatically adjust strength to give consistent results for different spacings");
1254         RNA_def_property_update(prop, 0, "rna_Brush_update");
1255
1256         /* adaptive space is not implemented yet */
1257         prop = RNA_def_property(srna, "use_adaptive_space", PROP_BOOLEAN, PROP_NONE);
1258         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ADAPTIVE_SPACE);
1259         RNA_def_property_ui_text(prop, "Adaptive Spacing",
1260                                  "Space daubs according to surface orientation instead of screen space");
1261         RNA_def_property_update(prop, 0, "rna_Brush_update");
1262
1263         prop = RNA_def_property(srna, "use_locked_size", PROP_BOOLEAN, PROP_NONE);
1264         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_LOCK_SIZE);
1265         RNA_def_property_ui_text(prop, "Use Blender Units",
1266                                  "When locked brush stays same size relative to object; when unlocked brush size is "
1267                                  "given in pixels");
1268         RNA_def_property_update(prop, 0, "rna_Brush_update");
1269
1270         prop = RNA_def_property(srna, "use_edge_to_edge", PROP_BOOLEAN, PROP_NONE);
1271         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_EDGE_TO_EDGE);
1272         RNA_def_property_ui_text(prop, "Edge-to-edge", "Drag anchor brush from edge-to-edge");
1273         RNA_def_property_update(prop, 0, "rna_Brush_update");
1274
1275         prop = RNA_def_property(srna, "use_restore_mesh", PROP_BOOLEAN, PROP_NONE);
1276         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_DRAG_DOT);
1277         RNA_def_property_ui_text(prop, "Restore Mesh", "Allow a single dot to be carefully positioned");
1278         RNA_def_property_update(prop, 0, "rna_Brush_update");
1279
1280         /* only for projection paint & vertex paint, TODO, other paint modes */
1281         prop = RNA_def_property(srna, "use_alpha", PROP_BOOLEAN, PROP_NONE);
1282         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_LOCK_ALPHA);
1283         RNA_def_property_ui_text(prop, "Alpha", "When this is disabled, lock alpha while painting");
1284         RNA_def_property_update(prop, 0, "rna_Brush_update");
1285
1286         prop = RNA_def_property(srna, "curve", PROP_POINTER, PROP_NONE);
1287         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1288         RNA_def_property_ui_text(prop, "Curve", "Editable falloff curve");
1289         RNA_def_property_update(prop, 0, "rna_Brush_update");
1290
1291         prop = RNA_def_property(srna, "paint_curve", PROP_POINTER, PROP_NONE);
1292         RNA_def_property_flag(prop, PROP_EDITABLE);
1293         RNA_def_property_ui_text(prop, "Paint Curve", "Active Paint Curve");
1294         RNA_def_property_update(prop, 0, "rna_Brush_update");
1295
1296         prop = RNA_def_property(srna, "gradient", PROP_POINTER, PROP_NEVER_NULL);
1297         RNA_def_property_pointer_sdna(prop, NULL, "gradient");
1298         RNA_def_property_struct_type(prop, "ColorRamp");
1299         RNA_def_property_ui_text(prop, "Gradient", "");
1300         RNA_def_property_update(prop, 0, "rna_Brush_update");
1301
1302         /* gradient source */
1303         prop = RNA_def_property(srna, "gradient_stroke_mode", PROP_ENUM, PROP_NONE);
1304         RNA_def_property_enum_items(prop, brush_gradient_items);
1305         RNA_def_property_ui_text(prop, "Gradient Stroke Mode", "");
1306         RNA_def_property_update(prop, 0, "rna_Brush_update");
1307
1308         prop = RNA_def_property(srna, "gradient_fill_mode", PROP_ENUM, PROP_NONE);
1309         RNA_def_property_enum_items(prop, brush_gradient_fill_items);
1310         RNA_def_property_ui_text(prop, "Gradient Fill Mode", "");
1311         RNA_def_property_update(prop, 0, "rna_Brush_update");
1312
1313         /* overlay flags */
1314         prop = RNA_def_property(srna, "use_primary_overlay", PROP_BOOLEAN, PROP_NONE);
1315         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_PRIMARY);
1316         RNA_def_property_ui_text(prop, "Use Texture Overlay", "Show texture in viewport");
1317         RNA_def_property_update(prop, 0, "rna_Brush_update");
1318
1319         prop = RNA_def_property(srna, "use_secondary_overlay", PROP_BOOLEAN, PROP_NONE);
1320         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_SECONDARY);
1321         RNA_def_property_ui_text(prop, "Use Texture Overlay", "Show texture in viewport");
1322         RNA_def_property_update(prop, 0, "rna_Brush_update");
1323
1324         prop = RNA_def_property(srna, "use_cursor_overlay", PROP_BOOLEAN, PROP_NONE);
1325         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_CURSOR);
1326         RNA_def_property_ui_text(prop, "Use Cursor Overlay", "Show cursor in viewport");
1327         RNA_def_property_update(prop, 0, "rna_Brush_update");
1328
1329         prop = RNA_def_property(srna, "use_cursor_overlay_override", PROP_BOOLEAN, PROP_NONE);
1330         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_CURSOR_OVERRIDE_ON_STROKE);
1331         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1332         RNA_def_property_update(prop, 0, "rna_Brush_update");
1333
1334         prop = RNA_def_property(srna, "use_primary_overlay_override", PROP_BOOLEAN, PROP_NONE);
1335         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_PRIMARY_OVERRIDE_ON_STROKE);
1336         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1337         RNA_def_property_update(prop, 0, "rna_Brush_update");
1338
1339         prop = RNA_def_property(srna, "use_secondary_overlay_override", PROP_BOOLEAN, PROP_NONE);
1340         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_SECONDARY_OVERRIDE_ON_STROKE);
1341         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1342         RNA_def_property_update(prop, 0, "rna_Brush_update");
1343
1344         /* paint mode flags */
1345         prop = RNA_def_property(srna, "use_paint_sculpt", PROP_BOOLEAN, PROP_NONE);
1346         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_SCULPT);
1347         RNA_def_property_ui_text(prop, "Use Sculpt", "Use this brush in sculpt mode");
1348
1349         prop = RNA_def_property(srna, "use_paint_vertex", PROP_BOOLEAN, PROP_NONE);
1350         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_VERTEX_PAINT);
1351         RNA_def_property_ui_text(prop, "Use Vertex", "Use this brush in vertex paint mode");
1352
1353         prop = RNA_def_property(srna, "use_paint_weight", PROP_BOOLEAN, PROP_NONE);
1354         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_WEIGHT_PAINT);
1355         RNA_def_property_ui_text(prop, "Use Weight", "Use this brush in weight paint mode");
1356
1357         prop = RNA_def_property(srna, "use_paint_image", PROP_BOOLEAN, PROP_NONE);
1358         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_TEXTURE_PAINT);
1359         RNA_def_property_ui_text(prop, "Use Texture", "Use this brush in texture paint mode");
1360
1361         /* texture */
1362         prop = RNA_def_property(srna, "texture_slot", PROP_POINTER, PROP_NONE);
1363         RNA_def_property_struct_type(prop, "BrushTextureSlot");
1364         RNA_def_property_pointer_sdna(prop, NULL, "mtex");
1365         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1366         RNA_def_property_ui_text(prop, "Texture Slot", "");
1367         
1368         prop = RNA_def_property(srna, "texture", PROP_POINTER, PROP_NONE);
1369         RNA_def_property_pointer_sdna(prop, NULL, "mtex.tex");
1370         RNA_def_property_flag(prop, PROP_EDITABLE);
1371         RNA_def_property_ui_text(prop, "Texture", "");
1372         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_main_tex_update");
1373
1374         prop = RNA_def_property(srna, "mask_texture_slot", PROP_POINTER, PROP_NONE);
1375         RNA_def_property_struct_type(prop, "BrushTextureSlot");
1376         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex");
1377         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1378         RNA_def_property_ui_text(prop, "Mask Texture Slot", "");
1379
1380         prop = RNA_def_property(srna, "mask_texture", PROP_POINTER, PROP_NONE);
1381         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex.tex");
1382         RNA_def_property_flag(prop, PROP_EDITABLE);
1383         RNA_def_property_ui_text(prop, "Mask Texture", "");
1384         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_secondary_tex_update");
1385
1386         prop = RNA_def_property(srna, "texture_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1387         RNA_def_property_int_sdna(prop, NULL, "texture_overlay_alpha");
1388         RNA_def_property_range(prop, 0, 100);
1389         RNA_def_property_ui_text(prop, "Texture Overlay Alpha", "");
1390         RNA_def_property_update(prop, 0, "rna_Brush_update");
1391
1392         prop = RNA_def_property(srna, "mask_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1393         RNA_def_property_int_sdna(prop, NULL, "mask_overlay_alpha");
1394         RNA_def_property_range(prop, 0, 100);
1395         RNA_def_property_ui_text(prop, "Mask Texture Overlay Alpha", "");
1396         RNA_def_property_update(prop, 0, "rna_Brush_update");
1397
1398         prop = RNA_def_property(srna, "cursor_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1399         RNA_def_property_int_sdna(prop, NULL, "cursor_overlay_alpha");
1400         RNA_def_property_range(prop, 0, 100);
1401         RNA_def_property_ui_text(prop, "Mask Texture Overlay Alpha", "");
1402         RNA_def_property_update(prop, 0, "rna_Brush_update");
1403
1404         prop = RNA_def_property(srna, "cursor_color_add", PROP_FLOAT, PROP_COLOR);
1405         RNA_def_property_float_sdna(prop, NULL, "add_col");
1406         RNA_def_property_array(prop, 3);
1407         RNA_def_property_ui_text(prop, "Add Color", "Color of cursor when adding");
1408         RNA_def_property_update(prop, 0, "rna_Brush_update");
1409
1410         prop = RNA_def_property(srna, "cursor_color_subtract", PROP_FLOAT, PROP_COLOR);
1411         RNA_def_property_float_sdna(prop, NULL, "sub_col");
1412         RNA_def_property_array(prop, 3);
1413         RNA_def_property_ui_text(prop, "Subtract Color", "Color of cursor when subtracting");
1414         RNA_def_property_update(prop, 0, "rna_Brush_update");
1415
1416         prop = RNA_def_property(srna, "use_custom_icon", PROP_BOOLEAN, PROP_NONE);
1417         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_CUSTOM_ICON);
1418         RNA_def_property_ui_text(prop, "Custom Icon", "Set the brush icon from an image file");
1419         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1420
1421         prop = RNA_def_property(srna, "icon_filepath", PROP_STRING, PROP_FILEPATH);
1422         RNA_def_property_string_sdna(prop, NULL, "icon_filepath");
1423         RNA_def_property_ui_text(prop, "Brush Icon Filepath", "File path to brush icon");
1424         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1425
1426         /* clone tool */
1427         prop = RNA_def_property(srna, "clone_image", PROP_POINTER, PROP_NONE);
1428         RNA_def_property_pointer_sdna(prop, NULL, "clone.image");
1429         RNA_def_property_flag(prop, PROP_EDITABLE);
1430         RNA_def_property_ui_text(prop, "Clone Image", "Image for clone tool");
1431         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1432         
1433         prop = RNA_def_property(srna, "clone_alpha", PROP_FLOAT, PROP_NONE);
1434         RNA_def_property_float_sdna(prop, NULL, "clone.alpha");
1435         RNA_def_property_range(prop, 0.0f, 1.0f);
1436         RNA_def_property_ui_text(prop, "Clone Alpha", "Opacity of clone image display");
1437         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1438
1439         prop = RNA_def_property(srna, "clone_offset", PROP_FLOAT, PROP_XYZ);
1440         RNA_def_property_float_sdna(prop, NULL, "clone.offset");
1441         RNA_def_property_ui_text(prop, "Clone Offset", "");
1442         RNA_def_property_ui_range(prop, -1.0f, 1.0f, 10.0f, 3);
1443         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1444
1445         prop = RNA_def_property(srna, "brush_capabilities", PROP_POINTER, PROP_NONE);
1446         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1447         RNA_def_property_struct_type(prop, "BrushCapabilities");
1448         RNA_def_property_pointer_funcs(prop, "rna_Brush_capabilities_get", NULL, NULL, NULL);
1449         RNA_def_property_ui_text(prop, "Brush Capabilities", "Brush's capabilities");
1450
1451         /* brush capabilities (mode-dependent) */
1452         prop = RNA_def_property(srna, "sculpt_capabilities", PROP_POINTER, PROP_NONE);
1453         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1454         RNA_def_property_struct_type(prop, "SculptToolCapabilities");
1455         RNA_def_property_pointer_funcs(prop, "rna_Sculpt_tool_capabilities_get", NULL, NULL, NULL);
1456         RNA_def_property_ui_text(prop, "Sculpt Capabilities", "Brush's capabilities in sculpt mode");
1457
1458         prop = RNA_def_property(srna, "image_paint_capabilities", PROP_POINTER, PROP_NONE);
1459         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1460         RNA_def_property_struct_type(prop, "ImapaintToolCapabilities");
1461         RNA_def_property_pointer_funcs(prop, "rna_Imapaint_tool_capabilities_get", NULL, NULL, NULL);
1462         RNA_def_property_ui_text(prop, "Image Painting Capabilities", "Brush's capabilities in image paint mode");
1463 }
1464
1465
1466 /* A brush stroke is a list of changes to the brush that
1467  * can occur during a stroke
1468  *
1469  *  o 3D location of the brush
1470  *  o 2D mouse location
1471  *  o Tablet pressure
1472  *  o Direction flip
1473  *  o Tool switch
1474  *  o Time
1475  */
1476 static void rna_def_operator_stroke_element(BlenderRNA *brna)
1477 {
1478         StructRNA *srna;
1479         PropertyRNA *prop;
1480
1481         srna = RNA_def_struct(brna, "OperatorStrokeElement", "PropertyGroup");
1482         RNA_def_struct_ui_text(srna, "Operator Stroke Element", "");
1483
1484         prop = RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
1485         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1486         RNA_def_property_array(prop, 3);
1487         RNA_def_property_ui_text(prop, "Location", "");
1488
1489         prop = RNA_def_property(srna, "mouse", PROP_FLOAT, PROP_XYZ);
1490         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1491         RNA_def_property_array(prop, 2);
1492         RNA_def_property_ui_text(prop, "Mouse", "");
1493
1494         prop = RNA_def_property(srna, "pressure", PROP_FLOAT, PROP_NONE);
1495         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1496         RNA_def_property_range(prop, 0.0f, 1.0f);
1497         RNA_def_property_ui_text(prop, "Pressure", "Tablet pressure");
1498
1499         prop = RNA_def_property(srna, "size", PROP_FLOAT, PROP_NONE);
1500         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1501         RNA_def_property_range(prop, 0.0f, FLT_MAX);
1502         RNA_def_property_ui_text(prop, "Brush Size", "Brush Size in screen space");
1503
1504         prop = RNA_def_property(srna, "pen_flip", PROP_BOOLEAN, PROP_NONE);
1505         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1506         RNA_def_property_ui_text(prop, "Flip", "");
1507
1508         /* used in uv painting */
1509         prop = RNA_def_property(srna, "time", PROP_FLOAT, PROP_UNSIGNED);
1510         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1511         RNA_def_property_ui_text(prop, "Time", "");
1512         
1513         /* used for Grease Pencil sketching sessions */
1514         prop = RNA_def_property(srna, "is_start", PROP_BOOLEAN, PROP_NONE);
1515         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1516         RNA_def_property_ui_text(prop, "Is Stroke Start", "");
1517
1518         /* XXX: Tool (this will be for pressing a modifier key for a different brush,
1519          *      e.g. switching to a Smooth brush in the middle of the stroke */
1520
1521         /* XXX: i don't think blender currently supports the ability to properly do a remappable modifier
1522          *      in the middle of a stroke */
1523 }
1524
1525 void RNA_def_brush(BlenderRNA *brna)
1526 {
1527         rna_def_brush(brna);
1528         rna_def_brush_capabilities(brna);
1529         rna_def_sculpt_capabilities(brna);
1530         rna_def_image_paint_capabilities(brna);
1531         rna_def_brush_texture_slot(brna);
1532         rna_def_operator_stroke_element(brna);
1533 }
1534
1535 #endif