RNA: correct callback type
[blender.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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool 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 bool rna_BrushCapabilities_has_spacing_get(PointerRNA *ptr)
281 {
282         Brush *br = (Brush *)ptr->data;
283         return (!(br->flag & BRUSH_ANCHORED));
284 }
285
286 static bool 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 bool 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 bool 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 bool 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 bool 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 bool 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_icon_changed(BKE_icon_id_ensure(&br->id));
434         }
435
436         WM_main_add_notifier(NC_BRUSH | NA_EDITED, br);
437 }
438
439 static void rna_TextureSlot_brush_angle_update(Main *bmain, Scene *scene, PointerRNA *ptr)
440 {
441         MTex *mtex = ptr->data;
442         /* skip invalidation of overlay for stencil mode */
443         if (mtex->mapping != MTEX_MAP_MODE_STENCIL)
444                 BKE_paint_invalidate_overlay_tex(scene, mtex->tex);
445
446         rna_TextureSlot_update(bmain, scene, ptr);
447 }
448
449 static void rna_Brush_set_size(PointerRNA *ptr, int value)
450 {
451         Brush *brush = ptr->data;
452
453         /* scale unprojected radius so it stays consistent with brush size */
454         BKE_brush_scale_unprojected_radius(&brush->unprojected_radius,
455                                            value, brush->size);
456         brush->size = value;
457 }
458
459 static void rna_Brush_use_gradient_set(PointerRNA *ptr, bool value)
460 {
461         Brush *br = (Brush *)ptr->data;
462
463         if (value) br->flag |= BRUSH_USE_GRADIENT;
464         else br->flag &= ~BRUSH_USE_GRADIENT;
465
466         if ((br->flag & BRUSH_USE_GRADIENT) && br->gradient == NULL)
467                 br->gradient = BKE_colorband_add(true);
468 }
469
470 static void rna_Brush_set_unprojected_radius(PointerRNA *ptr, float value)
471 {
472         Brush *brush = ptr->data;
473
474         /* scale brush size so it stays consistent with unprojected_radius */
475         BKE_brush_scale_size(&brush->size, value, brush->unprojected_radius);
476         brush->unprojected_radius = value;
477 }
478
479 static const EnumPropertyItem *rna_Brush_direction_itemf(bContext *C, PointerRNA *ptr,
480                                                    PropertyRNA *UNUSED(prop), bool *UNUSED(r_free))
481 {
482         ePaintMode mode = BKE_paintmode_get_active_from_context(C);
483
484         static const EnumPropertyItem prop_default_items[] = {
485                 {0, NULL, 0, NULL, NULL}
486         };
487
488         /* sculpt mode */
489         static const EnumPropertyItem prop_flatten_contrast_items[] = {
490                 {0, "FLATTEN", 0, "Flatten", "Add effect of brush"},
491                 {BRUSH_DIR_IN, "CONTRAST", 0, "Contrast", "Subtract effect of brush"},
492                 {0, NULL, 0, NULL, NULL}
493         };
494
495         static const EnumPropertyItem prop_fill_deepen_items[] = {
496                 {0, "FILL", 0, "Fill", "Add effect of brush"},
497                 {BRUSH_DIR_IN, "DEEPEN", 0, "Deepen", "Subtract effect of brush"},
498                 {0, NULL, 0, NULL, NULL}
499         };
500
501         static const EnumPropertyItem prop_scrape_peaks_items[] = {
502                 {0, "SCRAPE", 0, "Scrape", "Add effect of brush"},
503                 {BRUSH_DIR_IN, "PEAKS", 0, "Peaks", "Subtract effect of brush"},
504                 {0, NULL, 0, NULL, NULL}
505         };
506
507         static const EnumPropertyItem prop_pinch_magnify_items[] = {
508                 {0, "PINCH", 0, "Pinch", "Add effect of brush"},
509                 {BRUSH_DIR_IN, "MAGNIFY", 0, "Magnify", "Subtract effect of brush"},
510                 {0, NULL, 0, NULL, NULL}
511         };
512
513         static const EnumPropertyItem prop_inflate_deflate_items[] = {
514                 {0, "INFLATE", 0, "Inflate", "Add effect of brush"},
515                 {BRUSH_DIR_IN, "DEFLATE", 0, "Deflate", "Subtract effect of brush"},
516                 {0, NULL, 0, NULL, NULL}
517         };
518
519         /* texture paint mode */
520         static const EnumPropertyItem prop_soften_sharpen_items[] = {
521                 {0, "SOFTEN", 0, "Soften", "Blur effect of brush"},
522                 {BRUSH_DIR_IN, "SHARPEN", 0, "Sharpen", "Sharpen effect of brush"},
523                 {0, NULL, 0, NULL, NULL}
524         };
525
526         Brush *me = (Brush *)(ptr->data);
527
528         switch (mode) {
529                 case ePaintSculpt:
530                         switch (me->sculpt_tool) {
531                                 case SCULPT_TOOL_DRAW:
532                                 case SCULPT_TOOL_CREASE:
533                                 case SCULPT_TOOL_BLOB:
534                                 case SCULPT_TOOL_LAYER:
535                                 case SCULPT_TOOL_CLAY:
536                                 case SCULPT_TOOL_CLAY_STRIPS:
537                                         return prop_direction_items;
538
539                                 case SCULPT_TOOL_MASK:
540                                         switch ((BrushMaskTool)me->mask_tool) {
541                                                 case BRUSH_MASK_DRAW:
542                                                         return prop_direction_items;
543
544                                                 case BRUSH_MASK_SMOOTH:
545                                                         return prop_default_items;
546
547                                                 default:
548                                                         return prop_default_items;
549                                         }
550
551                                 case SCULPT_TOOL_FLATTEN:
552                                         return prop_flatten_contrast_items;
553
554                                 case SCULPT_TOOL_FILL:
555                                         return prop_fill_deepen_items;
556
557                                 case SCULPT_TOOL_SCRAPE:
558                                         return prop_scrape_peaks_items;
559
560                                 case SCULPT_TOOL_PINCH:
561                                         return prop_pinch_magnify_items;
562
563                                 case SCULPT_TOOL_INFLATE:
564                                         return prop_inflate_deflate_items;
565
566                                 default:
567                                         return prop_default_items;
568                         }
569
570                 case ePaintTexture2D:
571                 case ePaintTextureProjective:
572                         switch (me->imagepaint_tool) {
573                                 case PAINT_TOOL_SOFTEN:
574                                         return prop_soften_sharpen_items;
575
576                                 default:
577                                         return prop_default_items;
578                         }
579
580                 default:
581                         return prop_default_items;
582         }
583 }
584
585 static const EnumPropertyItem *rna_Brush_stroke_itemf(bContext *C, PointerRNA *UNUSED(ptr),
586                                                 PropertyRNA *UNUSED(prop), bool *UNUSED(r_free))
587 {
588         ePaintMode mode = BKE_paintmode_get_active_from_context(C);
589
590         static const EnumPropertyItem brush_stroke_method_items[] = {
591                 {0, "DOTS", 0, "Dots", "Apply paint on each mouse move step"},
592                 {BRUSH_SPACE, "SPACE", 0, "Space", "Limit brush application to the distance specified by spacing"},
593                 {BRUSH_AIRBRUSH, "AIRBRUSH", 0, "Airbrush", "Keep applying paint effect while holding mouse (spray)"},
594                 {BRUSH_LINE, "LINE", 0, "Line", "Drag a line with dabs separated according to spacing"},
595                 {BRUSH_CURVE, "CURVE", 0, "Curve", "Define the stroke curve with a bezier curve. Dabs are separated according to spacing"},
596                 {0, NULL, 0, NULL, NULL}
597         };
598
599         switch (mode) {
600                 case ePaintSculpt:
601                 case ePaintTexture2D:
602                 case ePaintTextureProjective:
603                         return sculpt_stroke_method_items;
604
605                 default:
606                         return brush_stroke_method_items;
607         }
608 }
609 #else
610
611 static void rna_def_brush_texture_slot(BlenderRNA *brna)
612 {
613         StructRNA *srna;
614         PropertyRNA *prop;
615
616         static const EnumPropertyItem prop_map_mode_items[] = {
617                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
618                 {MTEX_MAP_MODE_AREA, "AREA_PLANE", 0, "Area Plane", ""},
619                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
620                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
621                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
622                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
623                 {0, NULL, 0, NULL, NULL}
624         };
625
626         static const EnumPropertyItem prop_tex_paint_map_mode_items[] = {
627                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
628                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
629                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
630                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
631                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
632                 {0, NULL, 0, NULL, NULL}
633         };
634
635         static const EnumPropertyItem prop_mask_paint_map_mode_items[] = {
636                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
637                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
638                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
639                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
640                 {0, NULL, 0, NULL, NULL}
641         };
642
643 #define TEXTURE_CAPABILITY(prop_name_, ui_name_)                          \
644         prop = RNA_def_property(srna, #prop_name_,                          \
645                                 PROP_BOOLEAN, PROP_NONE);                   \
646         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
647         RNA_def_property_boolean_funcs(prop, "rna_TextureCapabilities_"      \
648                                        #prop_name_ "_get", NULL);           \
649         RNA_def_property_ui_text(prop, ui_name_, NULL)
650
651
652         srna = RNA_def_struct(brna, "BrushTextureSlot", "TextureSlot");
653         RNA_def_struct_sdna(srna, "MTex");
654         RNA_def_struct_ui_text(srna, "Brush Texture Slot", "Texture slot for textures in a Brush data-block");
655
656         prop = RNA_def_property(srna, "angle", PROP_FLOAT, PROP_ANGLE);
657         RNA_def_property_float_sdna(prop, NULL, "rot");
658         RNA_def_property_range(prop, 0, M_PI * 2);
659         RNA_def_property_ui_text(prop, "Angle", "Brush texture rotation");
660         RNA_def_property_update(prop, 0, "rna_TextureSlot_brush_angle_update");
661
662         prop = RNA_def_property(srna, "map_mode", PROP_ENUM, PROP_NONE);
663         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
664         RNA_def_property_enum_items(prop, prop_map_mode_items);
665         RNA_def_property_ui_text(prop, "Mode", "");
666         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
667
668         prop = RNA_def_property(srna, "tex_paint_map_mode", PROP_ENUM, PROP_NONE);
669         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
670         RNA_def_property_enum_items(prop, prop_tex_paint_map_mode_items);
671         RNA_def_property_ui_text(prop, "Mode", "");
672         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
673
674         prop = RNA_def_property(srna, "mask_map_mode", PROP_ENUM, PROP_NONE);
675         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
676         RNA_def_property_enum_items(prop, prop_mask_paint_map_mode_items);
677         RNA_def_property_ui_text(prop, "Mode", "");
678         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
679
680         prop = RNA_def_property(srna, "use_rake", PROP_BOOLEAN, PROP_NONE);
681         RNA_def_property_boolean_sdna(prop, NULL, "brush_angle_mode", MTEX_ANGLE_RAKE);
682         RNA_def_property_ui_text(prop, "Rake", "");
683         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
684
685         prop = RNA_def_property(srna, "use_random", PROP_BOOLEAN, PROP_NONE);
686         RNA_def_property_boolean_sdna(prop, NULL, "brush_angle_mode", MTEX_ANGLE_RANDOM);
687         RNA_def_property_ui_text(prop, "Random", "");
688         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
689
690         prop = RNA_def_property(srna, "random_angle", PROP_FLOAT, PROP_ANGLE);
691         RNA_def_property_range(prop, 0, M_PI * 2);
692         RNA_def_property_ui_text(prop, "Random Angle", "Brush texture random angle");
693         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
694
695         TEXTURE_CAPABILITY(has_texture_angle_source, "Has Texture Angle Source");
696         TEXTURE_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
697         TEXTURE_CAPABILITY(has_texture_angle, "Has Texture Angle Source");
698 }
699
700 static void rna_def_sculpt_capabilities(BlenderRNA *brna)
701 {
702         StructRNA *srna;
703         PropertyRNA *prop;
704
705         srna = RNA_def_struct(brna, "SculptToolCapabilities", NULL);
706         RNA_def_struct_sdna(srna, "Brush");
707         RNA_def_struct_nested(brna, srna, "Brush");
708         RNA_def_struct_ui_text(srna, "Sculpt Capabilities",
709                                "Read-only indications of which brush operations "
710                                "are supported by the current sculpt tool");
711
712 #define SCULPT_TOOL_CAPABILITY(prop_name_, ui_name_)                      \
713         prop = RNA_def_property(srna, #prop_name_,                          \
714                                 PROP_BOOLEAN, PROP_NONE);                   \
715         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
716         RNA_def_property_boolean_funcs(prop, "rna_SculptToolCapabilities_"      \
717                                        #prop_name_ "_get", NULL);           \
718         RNA_def_property_ui_text(prop, ui_name_, NULL)
719
720         SCULPT_TOOL_CAPABILITY(has_accumulate, "Has Accumulate");
721         SCULPT_TOOL_CAPABILITY(has_auto_smooth, "Has Auto Smooth");
722         SCULPT_TOOL_CAPABILITY(has_height, "Has Height");
723         SCULPT_TOOL_CAPABILITY(has_jitter, "Has Jitter");
724         SCULPT_TOOL_CAPABILITY(has_normal_weight, "Has Crease/Pinch Factor");
725         SCULPT_TOOL_CAPABILITY(has_rake_factor, "Has Rake Factor");
726         SCULPT_TOOL_CAPABILITY(has_persistence, "Has Persistence");
727         SCULPT_TOOL_CAPABILITY(has_pinch_factor, "Has Pinch Factor");
728         SCULPT_TOOL_CAPABILITY(has_plane_offset, "Has Plane Offset");
729         SCULPT_TOOL_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
730         SCULPT_TOOL_CAPABILITY(has_sculpt_plane, "Has Sculpt Plane");
731         SCULPT_TOOL_CAPABILITY(has_secondary_color, "Has Secondary Color");
732         SCULPT_TOOL_CAPABILITY(has_smooth_stroke, "Has Smooth Stroke");
733         SCULPT_TOOL_CAPABILITY(has_space_attenuation, "Has Space Attenuation");
734         SCULPT_TOOL_CAPABILITY(has_strength_pressure, "Has Strength Pressure");
735         SCULPT_TOOL_CAPABILITY(has_gravity, "Has Gravity");
736
737 #undef SCULPT_CAPABILITY
738 }
739
740 static void rna_def_brush_capabilities(BlenderRNA *brna)
741 {
742         StructRNA *srna;
743         PropertyRNA *prop;
744
745         srna = RNA_def_struct(brna, "BrushCapabilities", NULL);
746         RNA_def_struct_sdna(srna, "Brush");
747         RNA_def_struct_nested(brna, srna, "Brush");
748         RNA_def_struct_ui_text(srna, "Brush Capabilities",
749                                "Read-only indications of which brush operations "
750                                "are supported by the current brush");
751
752 #define BRUSH_CAPABILITY(prop_name_, ui_name_)                          \
753         prop = RNA_def_property(srna, #prop_name_,                          \
754                                 PROP_BOOLEAN, PROP_NONE);                   \
755         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
756         RNA_def_property_boolean_funcs(prop, "rna_BrushCapabilities_"      \
757                                        #prop_name_ "_get", NULL);           \
758         RNA_def_property_ui_text(prop, ui_name_, NULL)
759
760         BRUSH_CAPABILITY(has_overlay, "Has Overlay");
761         BRUSH_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
762         BRUSH_CAPABILITY(has_spacing, "Has Spacing");
763         BRUSH_CAPABILITY(has_smooth_stroke, "Has Smooth Stroke");
764
765
766 #undef BRUSH_CAPABILITY
767 }
768
769 static void rna_def_image_paint_capabilities(BlenderRNA *brna)
770 {
771         StructRNA *srna;
772         PropertyRNA *prop;
773
774         srna = RNA_def_struct(brna, "ImapaintToolCapabilities", NULL);
775         RNA_def_struct_sdna(srna, "Brush");
776         RNA_def_struct_nested(brna, srna, "Brush");
777         RNA_def_struct_ui_text(srna, "Image Paint Capabilities",
778                                "Read-only indications of which brush operations "
779                                "are supported by the current image paint brush");
780
781 #define IMAPAINT_TOOL_CAPABILITY(prop_name_, ui_name_)                       \
782         prop = RNA_def_property(srna, #prop_name_,                               \
783                                 PROP_BOOLEAN, PROP_NONE);                        \
784         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                        \
785         RNA_def_property_boolean_funcs(prop, "rna_ImapaintToolCapabilities_"     \
786                                        #prop_name_ "_get", NULL);                \
787         RNA_def_property_ui_text(prop, ui_name_, NULL)
788
789         IMAPAINT_TOOL_CAPABILITY(has_accumulate, "Has Accumulate");
790         IMAPAINT_TOOL_CAPABILITY(has_space_attenuation, "Has Space Attenuation");
791         IMAPAINT_TOOL_CAPABILITY(has_radius, "Has Radius");
792
793 #undef IMAPAINT_TOOL_CAPABILITY
794 }
795
796 static void rna_def_brush(BlenderRNA *brna)
797 {
798         StructRNA *srna;
799         PropertyRNA *prop;
800
801         static const EnumPropertyItem prop_blend_items[] = {
802                 {IMB_BLEND_MIX, "MIX", 0, "Mix", "Use mix blending mode while painting"},
803                 {IMB_BLEND_ADD, "ADD", 0, "Add", "Use add blending mode while painting"},
804                 {IMB_BLEND_SUB, "SUB", 0, "Subtract", "Use subtract blending mode while painting"},
805                 {IMB_BLEND_MUL, "MUL", 0, "Multiply", "Use multiply blending mode while painting"},
806                 {IMB_BLEND_LIGHTEN, "LIGHTEN", 0, "Lighten", "Use lighten blending mode while painting"},
807                 {IMB_BLEND_DARKEN, "DARKEN", 0, "Darken", "Use darken blending mode while painting"},
808                 {IMB_BLEND_ERASE_ALPHA, "ERASE_ALPHA", 0, "Erase Alpha", "Erase alpha while painting"},
809                 {IMB_BLEND_ADD_ALPHA, "ADD_ALPHA", 0, "Add Alpha", "Add alpha while painting"},
810                 {IMB_BLEND_OVERLAY, "OVERLAY", 0, "Overlay", "Use overlay blending mode while painting"},
811                 {IMB_BLEND_HARDLIGHT, "HARDLIGHT", 0, "Hard light", "Use hard light blending mode while painting"},
812                 {IMB_BLEND_COLORBURN, "COLORBURN", 0, "Color burn", "Use color burn blending mode while painting"},
813                 {IMB_BLEND_LINEARBURN, "LINEARBURN", 0, "Linear burn", "Use linear burn blending mode while painting"},
814                 {IMB_BLEND_COLORDODGE, "COLORDODGE", 0, "Color dodge", "Use color dodge blending mode while painting"},
815                 {IMB_BLEND_SCREEN, "SCREEN", 0, "Screen", "Use screen blending mode while painting"},
816                 {IMB_BLEND_SOFTLIGHT, "SOFTLIGHT", 0, "Soft light", "Use softlight blending mode while painting"},
817                 {IMB_BLEND_PINLIGHT, "PINLIGHT", 0, "Pin light", "Use pinlight blending mode while painting"},
818                 {IMB_BLEND_VIVIDLIGHT, "VIVIDLIGHT", 0, "Vivid light", "Use vividlight blending mode while painting"},
819                 {IMB_BLEND_LINEARLIGHT, "LINEARLIGHT", 0, "Linear light", "Use linearlight blending mode while painting"},
820                 {IMB_BLEND_DIFFERENCE, "DIFFERENCE", 0, "Difference", "Use difference blending mode while painting"},
821                 {IMB_BLEND_EXCLUSION, "EXCLUSION", 0, "Exclusion", "Use exclusion blending mode while painting"},
822                 {IMB_BLEND_HUE, "HUE", 0, "Hue", "Use hue blending mode while painting"},
823                 {IMB_BLEND_SATURATION, "SATURATION", 0, "Saturation", "Use saturation blending mode while painting"},
824                 {IMB_BLEND_LUMINOSITY, "LUMINOSITY", 0, "Luminosity", "Use luminosity blending mode while painting"},
825                 {IMB_BLEND_COLOR, "COLOR", 0, "Color", "Use color blending mode while painting"},
826                 {0, NULL, 0, NULL, NULL}
827         };
828
829         static const EnumPropertyItem brush_sculpt_plane_items[] = {
830                 {SCULPT_DISP_DIR_AREA, "AREA", 0, "Area Plane", ""},
831                 {SCULPT_DISP_DIR_VIEW, "VIEW", 0, "View Plane", ""},
832                 {SCULPT_DISP_DIR_X, "X", 0, "X Plane", ""},
833                 {SCULPT_DISP_DIR_Y, "Y", 0, "Y Plane", ""},
834                 {SCULPT_DISP_DIR_Z, "Z", 0, "Z Plane", ""},
835                 {0, NULL, 0, NULL, NULL}
836         };
837
838         static const EnumPropertyItem brush_mask_tool_items[] = {
839                 {BRUSH_MASK_DRAW, "DRAW", 0, "Draw", ""},
840                 {BRUSH_MASK_SMOOTH, "SMOOTH", 0, "Smooth", ""},
841                 {0, NULL, 0, NULL, NULL}
842         };
843
844         static const EnumPropertyItem brush_blur_mode_items[] = {
845                 {KERNEL_BOX, "BOX", 0, "Box", ""},
846                 {KERNEL_GAUSSIAN, "GAUSSIAN", 0, "Gaussian", ""},
847                 {0, NULL, 0, NULL, NULL}
848         };
849
850         static const EnumPropertyItem brush_gradient_items[] = {
851                 {BRUSH_GRADIENT_PRESSURE, "PRESSURE", 0, "Pressure", ""},
852                 {BRUSH_GRADIENT_SPACING_REPEAT, "SPACING_REPEAT", 0, "Repeat", ""},
853                 {BRUSH_GRADIENT_SPACING_CLAMP, "SPACING_CLAMP", 0, "Clamp", ""},
854                 {0, NULL, 0, NULL, NULL}
855         };
856
857         static const EnumPropertyItem brush_gradient_fill_items[] = {
858                 {BRUSH_GRADIENT_LINEAR, "LINEAR", 0, "Linear", ""},
859                 {BRUSH_GRADIENT_RADIAL, "RADIAL", 0, "Radial", ""},
860                 {0, NULL, 0, NULL, NULL}
861         };
862
863         static const EnumPropertyItem brush_mask_pressure_items[] = {
864                 {0, "NONE", 0, "Off", ""},
865                 {BRUSH_MASK_PRESSURE_RAMP, "RAMP", ICON_STYLUS_PRESSURE, "Ramp", ""},
866                 {BRUSH_MASK_PRESSURE_CUTOFF, "CUTOFF", ICON_STYLUS_PRESSURE, "Cutoff", ""},
867                 {0, NULL, 0, NULL, NULL}
868         };
869
870         srna = RNA_def_struct(brna, "Brush", "ID");
871         RNA_def_struct_ui_text(srna, "Brush", "Brush data-block for storing brush settings for painting and sculpting");
872         RNA_def_struct_ui_icon(srna, ICON_BRUSH_DATA);
873
874         /* enums */
875         prop = RNA_def_property(srna, "blend", PROP_ENUM, PROP_NONE);
876         RNA_def_property_enum_items(prop, prop_blend_items);
877         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
878         RNA_def_property_update(prop, 0, "rna_Brush_update");
879
880         prop = RNA_def_property(srna, "sculpt_tool", PROP_ENUM, PROP_NONE);
881         RNA_def_property_enum_items(prop, rna_enum_brush_sculpt_tool_items);
882         RNA_def_property_ui_text(prop, "Sculpt Tool", "");
883         RNA_def_property_update(prop, 0, "rna_Brush_sculpt_tool_update");
884
885         prop = RNA_def_property(srna, "vertex_tool", PROP_ENUM, PROP_NONE);
886         RNA_def_property_enum_sdna(prop, NULL, "vertexpaint_tool");
887         RNA_def_property_enum_items(prop, rna_enum_brush_vertex_tool_items);
888         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
889         RNA_def_property_update(prop, 0, "rna_Brush_vertex_tool_update");
890
891         prop = RNA_def_property(srna, "image_tool", PROP_ENUM, PROP_NONE);
892         RNA_def_property_enum_sdna(prop, NULL, "imagepaint_tool");
893         RNA_def_property_enum_items(prop, rna_enum_brush_image_tool_items);
894         RNA_def_property_ui_text(prop, "Image Paint Tool", "");
895         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_imagepaint_tool_update");
896
897         prop = RNA_def_property(srna, "direction", PROP_ENUM, PROP_NONE);
898         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
899         RNA_def_property_enum_items(prop, prop_direction_items);
900         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Brush_direction_itemf");
901         RNA_def_property_ui_text(prop, "Direction", "");
902         RNA_def_property_update(prop, 0, "rna_Brush_update");
903
904         prop = RNA_def_property(srna, "stroke_method", PROP_ENUM, PROP_NONE);
905         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
906         RNA_def_property_enum_items(prop, sculpt_stroke_method_items);
907         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Brush_stroke_itemf");
908         RNA_def_property_ui_text(prop, "Stroke Method", "");
909         RNA_def_property_update(prop, 0, "rna_Brush_stroke_update");
910
911         prop = RNA_def_property(srna, "sculpt_plane", PROP_ENUM, PROP_NONE);
912         RNA_def_property_enum_items(prop, brush_sculpt_plane_items);
913         RNA_def_property_ui_text(prop, "Sculpt Plane", "");
914         RNA_def_property_update(prop, 0, "rna_Brush_update");
915
916         prop = RNA_def_property(srna, "mask_tool", PROP_ENUM, PROP_NONE);
917         RNA_def_property_enum_items(prop, brush_mask_tool_items);
918         RNA_def_property_ui_text(prop, "Mask Tool", "");
919         RNA_def_property_update(prop, 0, "rna_Brush_update");
920
921         /* number values */
922         prop = RNA_def_property(srna, "size", PROP_INT, PROP_PIXEL);
923         RNA_def_property_int_funcs(prop, NULL, "rna_Brush_set_size", NULL);
924         RNA_def_property_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS * 10);
925         RNA_def_property_ui_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS, 1, -1);
926         RNA_def_property_ui_text(prop, "Radius", "Radius of the brush in pixels");
927         RNA_def_property_update(prop, 0, "rna_Brush_size_update");
928
929         prop = RNA_def_property(srna, "unprojected_radius", PROP_FLOAT, PROP_DISTANCE);
930         RNA_def_property_float_funcs(prop, NULL, "rna_Brush_set_unprojected_radius", NULL);
931         RNA_def_property_range(prop, 0.001, FLT_MAX);
932         RNA_def_property_ui_range(prop, 0.001, 1, 0, -1);
933         RNA_def_property_ui_text(prop, "Unprojected Radius", "Radius of brush in Blender units");
934         RNA_def_property_update(prop, 0, "rna_Brush_size_update");
935
936         prop = RNA_def_property(srna, "jitter", PROP_FLOAT, PROP_NONE);
937         RNA_def_property_float_sdna(prop, NULL, "jitter");
938         RNA_def_property_range(prop, 0.0f, 1000.0f);
939         RNA_def_property_ui_range(prop, 0.0f, 2.0f, 0.1, 4);
940         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush while painting");
941         RNA_def_property_update(prop, 0, "rna_Brush_update");
942
943         prop = RNA_def_property(srna, "jitter_absolute", PROP_INT, PROP_PIXEL);
944         RNA_def_property_int_sdna(prop, NULL, "jitter_absolute");
945         RNA_def_property_range(prop, 0, 1000000);
946         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush in pixels while painting");
947         RNA_def_property_update(prop, 0, "rna_Brush_update");
948
949         prop = RNA_def_property(srna, "spacing", PROP_INT, PROP_PERCENTAGE);
950         RNA_def_property_int_sdna(prop, NULL, "spacing");
951         RNA_def_property_range(prop, 1, 1000);
952         RNA_def_property_ui_range(prop, 1, 500, 5, -1);
953         RNA_def_property_ui_text(prop, "Spacing", "Spacing between brush daubs as a percentage of brush diameter");
954         RNA_def_property_update(prop, 0, "rna_Brush_update");
955
956         prop = RNA_def_property(srna, "grad_spacing", PROP_INT, PROP_NONE);
957         RNA_def_property_int_sdna(prop, NULL, "gradient_spacing");
958         RNA_def_property_range(prop, 1, 10000);
959         RNA_def_property_ui_range(prop, 1, 10000, 5, -1);
960         RNA_def_property_ui_text(prop, "Gradient Spacing", "Spacing before brush gradient goes full circle");
961         RNA_def_property_update(prop, 0, "rna_Brush_update");
962
963         prop = RNA_def_property(srna, "smooth_stroke_radius", PROP_INT, PROP_NONE);
964         RNA_def_property_range(prop, 10, 200);
965         RNA_def_property_ui_text(prop, "Smooth Stroke Radius", "Minimum distance from last point before stroke continues");
966         RNA_def_property_update(prop, 0, "rna_Brush_update");
967
968         prop = RNA_def_property(srna, "smooth_stroke_factor", PROP_FLOAT, PROP_FACTOR);
969         RNA_def_property_range(prop, 0.5, 0.99);
970         RNA_def_property_ui_text(prop, "Smooth Stroke Factor", "Higher values give a smoother stroke");
971         RNA_def_property_update(prop, 0, "rna_Brush_update");
972
973         prop = RNA_def_property(srna, "rate", PROP_FLOAT, PROP_NONE);
974         RNA_def_property_float_sdna(prop, NULL, "rate");
975         RNA_def_property_range(prop, 0.0001f, 10000.0f);
976         RNA_def_property_ui_range(prop, 0.01f, 1.0f, 1, 3);
977         RNA_def_property_ui_text(prop, "Rate", "Interval between paints for Airbrush");
978         RNA_def_property_update(prop, 0, "rna_Brush_update");
979
980         prop = RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR_GAMMA);
981         RNA_def_property_range(prop, 0.0, 1.0);
982         RNA_def_property_float_sdna(prop, NULL, "rgb");
983         RNA_def_property_ui_text(prop, "Color", "");
984         RNA_def_property_update(prop, 0, "rna_Brush_update");
985
986         prop = RNA_def_property(srna, "secondary_color", PROP_FLOAT, PROP_COLOR_GAMMA);
987         RNA_def_property_range(prop, 0.0, 1.0);
988         RNA_def_property_float_sdna(prop, NULL, "secondary_rgb");
989         RNA_def_property_ui_text(prop, "Secondary Color", "");
990         RNA_def_property_update(prop, 0, "rna_Brush_update");
991
992         prop = RNA_def_property(srna, "weight", PROP_FLOAT, PROP_FACTOR);
993         RNA_def_property_float_default(prop, 1.0f);
994         RNA_def_property_range(prop, 0.0f, 1.0f);
995         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
996         RNA_def_property_ui_text(prop, "Weight", "Vertex weight when brush is applied");
997         RNA_def_property_update(prop, 0, "rna_Brush_update");
998
999         prop = RNA_def_property(srna, "strength", PROP_FLOAT, PROP_FACTOR);
1000         RNA_def_property_float_sdna(prop, NULL, "alpha");
1001         RNA_def_property_float_default(prop, 0.5f);
1002         RNA_def_property_range(prop, 0.0f, 10.0f);
1003         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1004         RNA_def_property_ui_text(prop, "Strength", "How powerful the effect of the brush is when applied");
1005         RNA_def_property_update(prop, 0, "rna_Brush_update");
1006
1007         prop = RNA_def_property(srna, "plane_offset", PROP_FLOAT, PROP_DISTANCE);
1008         RNA_def_property_float_sdna(prop, NULL, "plane_offset");
1009         RNA_def_property_float_default(prop, 0);
1010         RNA_def_property_range(prop, -2.0f, 2.0f);
1011         RNA_def_property_ui_range(prop, -0.5f, 0.5f, 0.001, 3);
1012         RNA_def_property_ui_text(prop, "Plane Offset",
1013                                  "Adjust plane on which the brush acts towards or away from the object surface");
1014         RNA_def_property_update(prop, 0, "rna_Brush_update");
1015
1016         prop = RNA_def_property(srna, "plane_trim", PROP_FLOAT, PROP_DISTANCE);
1017         RNA_def_property_float_sdna(prop, NULL, "plane_trim");
1018         RNA_def_property_float_default(prop, 0.5f);
1019         RNA_def_property_range(prop, 0, 1.0f);
1020         RNA_def_property_ui_text(prop, "Plane Trim",
1021                                  "If a vertex is further away from offset plane than this, then it is not affected");
1022         RNA_def_property_update(prop, 0, "rna_Brush_update");
1023
1024         prop = RNA_def_property(srna, "height", PROP_FLOAT, PROP_DISTANCE);
1025         RNA_def_property_float_sdna(prop, NULL, "height");
1026         RNA_def_property_float_default(prop, 0.5f);
1027         RNA_def_property_range(prop, 0, 1.0f);
1028         RNA_def_property_ui_text(prop, "Brush Height", "Affectable height of brush (layer height for layer tool, i.e.)");
1029         RNA_def_property_update(prop, 0, "rna_Brush_update");
1030
1031         prop = RNA_def_property(srna, "texture_sample_bias", PROP_FLOAT, PROP_DISTANCE);
1032         RNA_def_property_float_sdna(prop, NULL, "texture_sample_bias");
1033         RNA_def_property_float_default(prop, 0);
1034         RNA_def_property_range(prop, -1, 1);
1035         RNA_def_property_ui_text(prop, "Texture Sample Bias", "Value added to texture samples");
1036         RNA_def_property_update(prop, 0, "rna_Brush_update");
1037
1038         prop = RNA_def_property(srna, "normal_weight", PROP_FLOAT, PROP_FACTOR);
1039         RNA_def_property_float_sdna(prop, NULL, "normal_weight");
1040         RNA_def_property_float_default(prop, 0);
1041         RNA_def_property_range(prop, 0.0f, 1.0f);
1042         RNA_def_property_ui_text(prop, "Normal Weight", "How much grab will pull vertexes out of surface during a grab");
1043         RNA_def_property_update(prop, 0, "rna_Brush_update");
1044
1045         prop = RNA_def_property(srna, "rake_factor", PROP_FLOAT, PROP_FACTOR);
1046         RNA_def_property_float_sdna(prop, NULL, "rake_factor");
1047         RNA_def_property_float_default(prop, 0);
1048         RNA_def_property_range(prop, 0.0f, 10.0f);
1049         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1050         RNA_def_property_ui_text(prop, "Rake", "How much grab will follow cursor rotation");
1051         RNA_def_property_update(prop, 0, "rna_Brush_update");
1052
1053         prop = RNA_def_property(srna, "crease_pinch_factor", PROP_FLOAT, PROP_FACTOR);
1054         RNA_def_property_float_sdna(prop, NULL, "crease_pinch_factor");
1055         RNA_def_property_float_default(prop, 2.0f / 3.0f);
1056         RNA_def_property_range(prop, 0.0f, 1.0f);
1057         RNA_def_property_ui_text(prop, "Crease Brush Pinch Factor", "How much the crease brush pinches");
1058         RNA_def_property_update(prop, 0, "rna_Brush_update");
1059
1060         prop = RNA_def_property(srna, "auto_smooth_factor", PROP_FLOAT, PROP_FACTOR);
1061         RNA_def_property_float_sdna(prop, NULL, "autosmooth_factor");
1062         RNA_def_property_float_default(prop, 0);
1063         RNA_def_property_range(prop, 0.0f, 1.0f);
1064         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
1065         RNA_def_property_ui_text(prop, "Autosmooth", "Amount of smoothing to automatically apply to each stroke");
1066         RNA_def_property_update(prop, 0, "rna_Brush_update");
1067
1068         prop = RNA_def_property(srna, "stencil_pos", PROP_FLOAT, PROP_XYZ);
1069         RNA_def_property_float_sdna(prop, NULL, "stencil_pos");
1070         RNA_def_property_array(prop, 2);
1071         RNA_def_property_ui_text(prop, "Stencil Position", "Position of stencil in viewport");
1072         RNA_def_property_update(prop, 0, "rna_Brush_update");
1073
1074         prop = RNA_def_property(srna, "stencil_dimension", PROP_FLOAT, PROP_XYZ);
1075         RNA_def_property_float_sdna(prop, NULL, "stencil_dimension");
1076         RNA_def_property_array(prop, 2);
1077         RNA_def_property_ui_text(prop, "Stencil Dimensions", "Dimensions of stencil in viewport");
1078         RNA_def_property_update(prop, 0, "rna_Brush_update");
1079
1080         prop = RNA_def_property(srna, "mask_stencil_pos", PROP_FLOAT, PROP_XYZ);
1081         RNA_def_property_float_sdna(prop, NULL, "mask_stencil_pos");
1082         RNA_def_property_array(prop, 2);
1083         RNA_def_property_ui_text(prop, "Mask Stencil Position", "Position of mask stencil in viewport");
1084         RNA_def_property_update(prop, 0, "rna_Brush_update");
1085
1086         prop = RNA_def_property(srna, "mask_stencil_dimension", PROP_FLOAT, PROP_XYZ);
1087         RNA_def_property_float_sdna(prop, NULL, "mask_stencil_dimension");
1088         RNA_def_property_array(prop, 2);
1089         RNA_def_property_ui_text(prop, "Mask Stencil Dimensions", "Dimensions of mask stencil in viewport");
1090         RNA_def_property_update(prop, 0, "rna_Brush_update");
1091
1092         prop = RNA_def_property(srna, "sharp_threshold", PROP_FLOAT, PROP_NONE);
1093         RNA_def_property_range(prop, 0.0, 100.0);
1094         RNA_def_property_ui_range(prop, 0.0, 1.0, 1, 3);
1095         RNA_def_property_float_sdna(prop, NULL, "sharp_threshold");
1096         RNA_def_property_ui_text(prop, "Sharp Threshold", "Threshold below which, no sharpening is done");
1097         RNA_def_property_update(prop, 0, "rna_Brush_update");
1098
1099         prop = RNA_def_property(srna, "fill_threshold", PROP_FLOAT, PROP_NONE);
1100         RNA_def_property_range(prop, 0.0, 100.0);
1101         RNA_def_property_ui_range(prop, 0.0, 1.0, 1, 3);
1102         RNA_def_property_float_sdna(prop, NULL, "fill_threshold");
1103         RNA_def_property_ui_text(prop, "Fill Threshold", "Threshold above which filling is not propagated");
1104         RNA_def_property_update(prop, 0, "rna_Brush_update");
1105
1106         prop = RNA_def_property(srna, "blur_kernel_radius", PROP_INT, PROP_NONE);
1107         RNA_def_property_int_sdna(prop, NULL, "blur_kernel_radius");
1108         RNA_def_property_range(prop, 1, 10000);
1109         RNA_def_property_ui_range(prop, 1, 50, 1, -1);
1110         RNA_def_property_ui_text(prop, "Kernel Radius", "Radius of kernel used for soften and sharpen in pixels");
1111         RNA_def_property_update(prop, 0, "rna_Brush_update");
1112
1113         prop = RNA_def_property(srna, "blur_mode", PROP_ENUM, PROP_NONE);
1114         RNA_def_property_enum_items(prop, brush_blur_mode_items);
1115         RNA_def_property_ui_text(prop, "Blur Mode", "");
1116         RNA_def_property_update(prop, 0, "rna_Brush_update");
1117
1118         prop = RNA_def_property(srna, "falloff_angle", PROP_FLOAT, PROP_ANGLE);
1119         RNA_def_property_float_sdna(prop, NULL, "falloff_angle");
1120         RNA_def_property_range(prop, 0, M_PI / 2);
1121         RNA_def_property_ui_text(prop, "Falloff Angle",
1122                                  "Paint most on faces pointing towards the view according to this angle");
1123         RNA_def_property_update(prop, 0, "rna_Brush_update");
1124
1125         /* flag */
1126         /* This is an enum but its unlikely we add other shapes, so expose as a boolean. */
1127         prop = RNA_def_property(srna, "use_projected", PROP_BOOLEAN, PROP_NONE);
1128         RNA_def_property_boolean_sdna(prop, NULL, "falloff_shape", BRUSH_AIRBRUSH);
1129         RNA_def_property_ui_text(prop, "2D Falloff", "Apply brush influence in 2D circle instead of a sphere");
1130         RNA_def_property_update(prop, 0, "rna_Brush_update");
1131
1132         prop = RNA_def_property(srna, "use_airbrush", PROP_BOOLEAN, PROP_NONE);
1133         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_AIRBRUSH);
1134         RNA_def_property_ui_text(prop, "Airbrush", "Keep applying paint effect while holding mouse (spray)");
1135         RNA_def_property_update(prop, 0, "rna_Brush_update");
1136
1137         prop = RNA_def_property(srna, "use_original_normal", PROP_BOOLEAN, PROP_NONE);
1138         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ORIGINAL_NORMAL);
1139         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1140         RNA_def_property_ui_text(prop, "Original Normal",
1141                                  "When locked keep using normal of surface where stroke was initiated");
1142         RNA_def_property_update(prop, 0, "rna_Brush_update");
1143
1144         prop = RNA_def_property(srna, "use_pressure_strength", PROP_BOOLEAN, PROP_NONE);
1145         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ALPHA_PRESSURE);
1146         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1147         RNA_def_property_ui_text(prop, "Strength Pressure", "Enable tablet pressure sensitivity for strength");
1148         RNA_def_property_update(prop, 0, "rna_Brush_update");
1149
1150         prop = RNA_def_property(srna, "use_offset_pressure", PROP_BOOLEAN, PROP_NONE);
1151         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_OFFSET_PRESSURE);
1152         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1153         RNA_def_property_ui_text(prop, "Plane Offset Pressure", "Enable tablet pressure sensitivity for offset");
1154         RNA_def_property_update(prop, 0, "rna_Brush_update");
1155
1156         prop = RNA_def_property(srna, "use_pressure_size", PROP_BOOLEAN, PROP_NONE);
1157         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SIZE_PRESSURE);
1158         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1159         RNA_def_property_ui_text(prop, "Size Pressure", "Enable tablet pressure sensitivity for size");
1160         RNA_def_property_update(prop, 0, "rna_Brush_update");
1161
1162         prop = RNA_def_property(srna, "use_gradient", PROP_BOOLEAN, PROP_NONE);
1163         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_USE_GRADIENT);
1164         RNA_def_property_boolean_funcs(prop, NULL, "rna_Brush_use_gradient_set");
1165         RNA_def_property_ui_text(prop, "Use Gradient", "Use Gradient by utilizing a sampling method");
1166         RNA_def_property_update(prop, 0, "rna_Brush_update");
1167
1168         prop = RNA_def_property(srna, "use_pressure_jitter", PROP_BOOLEAN, PROP_NONE);
1169         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_JITTER_PRESSURE);
1170         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1171         RNA_def_property_ui_text(prop, "Jitter Pressure", "Enable tablet pressure sensitivity for jitter");
1172         RNA_def_property_update(prop, 0, "rna_Brush_update");
1173
1174         prop = RNA_def_property(srna, "use_pressure_spacing", PROP_BOOLEAN, PROP_NONE);
1175         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACING_PRESSURE);
1176         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1177         RNA_def_property_ui_text(prop, "Spacing Pressure", "Enable tablet pressure sensitivity for spacing");
1178         RNA_def_property_update(prop, 0, "rna_Brush_update");
1179
1180         prop = RNA_def_property(srna, "use_pressure_masking", PROP_ENUM, PROP_NONE);
1181         RNA_def_property_enum_sdna(prop, NULL, "mask_pressure");
1182         RNA_def_property_enum_items(prop, brush_mask_pressure_items);
1183         RNA_def_property_ui_text(prop, "Mask Pressure Mode", "Pen pressure makes texture influence smaller");
1184         RNA_def_property_update(prop, 0, "rna_Brush_update");
1185
1186         prop = RNA_def_property(srna, "use_inverse_smooth_pressure", PROP_BOOLEAN, PROP_NONE);
1187         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_INVERSE_SMOOTH_PRESSURE);
1188         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
1189         RNA_def_property_ui_text(prop, "Inverse Smooth Pressure", "Lighter pressure causes more smoothing to be applied");
1190         RNA_def_property_update(prop, 0, "rna_Brush_update");
1191
1192         prop = RNA_def_property(srna, "use_relative_jitter", PROP_BOOLEAN, PROP_NONE);
1193         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_ABSOLUTE_JITTER);
1194         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1195         RNA_def_property_ui_text(prop, "Absolute Jitter", "Jittering happens in screen space, not relative to brush size");
1196         RNA_def_property_update(prop, 0, "rna_Brush_update");
1197
1198         prop = RNA_def_property(srna, "use_plane_trim", PROP_BOOLEAN, PROP_NONE);
1199         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PLANE_TRIM);
1200         RNA_def_property_ui_text(prop, "Use Plane Trim", "Enable Plane Trim");
1201         RNA_def_property_update(prop, 0, "rna_Brush_update");
1202
1203         prop = RNA_def_property(srna, "use_frontface", PROP_BOOLEAN, PROP_NONE);
1204         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FRONTFACE);
1205         RNA_def_property_ui_text(prop, "Use Front-Face", "Brush only affects vertexes that face the viewer");
1206         RNA_def_property_update(prop, 0, "rna_Brush_update");
1207
1208         prop = RNA_def_property(srna, "use_frontface_falloff", PROP_BOOLEAN, PROP_NONE);
1209         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FRONTFACE_FALLOFF);
1210         RNA_def_property_ui_text(prop, "Use Front-Face Falloff", "Blend brush influence by how much they face the front");
1211         RNA_def_property_update(prop, 0, "rna_Brush_update");
1212
1213         prop = RNA_def_property(srna, "use_anchor", PROP_BOOLEAN, PROP_NONE);
1214         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ANCHORED);
1215         RNA_def_property_ui_text(prop, "Anchored", "Keep the brush anchored to the initial location");
1216         RNA_def_property_update(prop, 0, "rna_Brush_update");
1217
1218         prop = RNA_def_property(srna, "use_space", PROP_BOOLEAN, PROP_NONE);
1219         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE);
1220         RNA_def_property_ui_text(prop, "Space", "Limit brush application to the distance specified by spacing");
1221         RNA_def_property_update(prop, 0, "rna_Brush_update");
1222
1223         prop = RNA_def_property(srna, "use_line", PROP_BOOLEAN, PROP_NONE);
1224         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_LINE);
1225         RNA_def_property_ui_text(prop, "Line", "Draw a line with dabs separated according to spacing");
1226         RNA_def_property_update(prop, 0, "rna_Brush_update");
1227
1228         prop = RNA_def_property(srna, "use_curve", PROP_BOOLEAN, PROP_NONE);
1229         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_CURVE);
1230         RNA_def_property_ui_text(prop, "Curve", "Define the stroke curve with a bezier curve. Dabs are separated according to spacing");
1231         RNA_def_property_update(prop, 0, "rna_Brush_update");
1232
1233         prop = RNA_def_property(srna, "use_smooth_stroke", PROP_BOOLEAN, PROP_NONE);
1234         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SMOOTH_STROKE);
1235         RNA_def_property_ui_text(prop, "Smooth Stroke", "Brush lags behind mouse and follows a smoother path");
1236         RNA_def_property_update(prop, 0, "rna_Brush_update");
1237
1238         prop = RNA_def_property(srna, "use_persistent", PROP_BOOLEAN, PROP_NONE);
1239         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PERSISTENT);
1240         RNA_def_property_ui_text(prop, "Persistent", "Sculpt on a persistent layer of the mesh");
1241         RNA_def_property_update(prop, 0, "rna_Brush_update");
1242
1243         prop = RNA_def_property(srna, "use_accumulate", PROP_BOOLEAN, PROP_NONE);
1244         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ACCUMULATE);
1245         RNA_def_property_ui_text(prop, "Accumulate", "Accumulate stroke daubs on top of each other");
1246         RNA_def_property_update(prop, 0, "rna_Brush_update");
1247
1248         prop = RNA_def_property(srna, "use_space_attenuation", PROP_BOOLEAN, PROP_NONE);
1249         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE_ATTEN);
1250         RNA_def_property_ui_icon(prop, ICON_UNLOCKED, true);
1251         RNA_def_property_ui_text(prop, "Use Automatic Strength Adjustment",
1252                                  "Automatically adjust strength to give consistent results for different spacings");
1253         RNA_def_property_update(prop, 0, "rna_Brush_update");
1254
1255         /* adaptive space is not implemented yet */
1256         prop = RNA_def_property(srna, "use_adaptive_space", PROP_BOOLEAN, PROP_NONE);
1257         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ADAPTIVE_SPACE);
1258         RNA_def_property_ui_text(prop, "Adaptive Spacing",
1259                                  "Space daubs according to surface orientation instead of screen space");
1260         RNA_def_property_update(prop, 0, "rna_Brush_update");
1261
1262         prop = RNA_def_property(srna, "use_locked_size", PROP_BOOLEAN, PROP_NONE);
1263         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_LOCK_SIZE);
1264         RNA_def_property_ui_text(prop, "Use Blender Units",
1265                                  "When locked brush stays same size relative to object; when unlocked brush size is "
1266                                  "given in pixels");
1267         RNA_def_property_update(prop, 0, "rna_Brush_update");
1268
1269         prop = RNA_def_property(srna, "use_edge_to_edge", PROP_BOOLEAN, PROP_NONE);
1270         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_EDGE_TO_EDGE);
1271         RNA_def_property_ui_text(prop, "Edge-to-edge", "Drag anchor brush from edge-to-edge");
1272         RNA_def_property_update(prop, 0, "rna_Brush_update");
1273
1274         prop = RNA_def_property(srna, "use_restore_mesh", PROP_BOOLEAN, PROP_NONE);
1275         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_DRAG_DOT);
1276         RNA_def_property_ui_text(prop, "Restore Mesh", "Allow a single dot to be carefully positioned");
1277         RNA_def_property_update(prop, 0, "rna_Brush_update");
1278
1279         /* only for projection paint & vertex paint, TODO, other paint modes */
1280         prop = RNA_def_property(srna, "use_alpha", PROP_BOOLEAN, PROP_NONE);
1281         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_LOCK_ALPHA);
1282         RNA_def_property_ui_text(prop, "Alpha", "When this is disabled, lock alpha while painting");
1283         RNA_def_property_update(prop, 0, "rna_Brush_update");
1284
1285         prop = RNA_def_property(srna, "curve", PROP_POINTER, PROP_NONE);
1286         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1287         RNA_def_property_ui_text(prop, "Curve", "Editable falloff curve");
1288         RNA_def_property_update(prop, 0, "rna_Brush_update");
1289
1290         prop = RNA_def_property(srna, "paint_curve", PROP_POINTER, PROP_NONE);
1291         RNA_def_property_flag(prop, PROP_EDITABLE);
1292         RNA_def_property_ui_text(prop, "Paint Curve", "Active Paint Curve");
1293         RNA_def_property_update(prop, 0, "rna_Brush_update");
1294
1295         prop = RNA_def_property(srna, "gradient", PROP_POINTER, PROP_NEVER_NULL);
1296         RNA_def_property_pointer_sdna(prop, NULL, "gradient");
1297         RNA_def_property_struct_type(prop, "ColorRamp");
1298         RNA_def_property_ui_text(prop, "Gradient", "");
1299         RNA_def_property_update(prop, 0, "rna_Brush_update");
1300
1301         /* gradient source */
1302         prop = RNA_def_property(srna, "gradient_stroke_mode", PROP_ENUM, PROP_NONE);
1303         RNA_def_property_enum_items(prop, brush_gradient_items);
1304         RNA_def_property_ui_text(prop, "Gradient Stroke Mode", "");
1305         RNA_def_property_update(prop, 0, "rna_Brush_update");
1306
1307         prop = RNA_def_property(srna, "gradient_fill_mode", PROP_ENUM, PROP_NONE);
1308         RNA_def_property_enum_items(prop, brush_gradient_fill_items);
1309         RNA_def_property_ui_text(prop, "Gradient Fill Mode", "");
1310         RNA_def_property_update(prop, 0, "rna_Brush_update");
1311
1312         /* overlay flags */
1313         prop = RNA_def_property(srna, "use_primary_overlay", PROP_BOOLEAN, PROP_NONE);
1314         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_PRIMARY);
1315         RNA_def_property_ui_text(prop, "Use Texture Overlay", "Show texture in viewport");
1316         RNA_def_property_update(prop, 0, "rna_Brush_update");
1317
1318         prop = RNA_def_property(srna, "use_secondary_overlay", PROP_BOOLEAN, PROP_NONE);
1319         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_SECONDARY);
1320         RNA_def_property_ui_text(prop, "Use Texture Overlay", "Show texture in viewport");
1321         RNA_def_property_update(prop, 0, "rna_Brush_update");
1322
1323         prop = RNA_def_property(srna, "use_cursor_overlay", PROP_BOOLEAN, PROP_NONE);
1324         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_CURSOR);
1325         RNA_def_property_ui_text(prop, "Use Cursor Overlay", "Show cursor in viewport");
1326         RNA_def_property_update(prop, 0, "rna_Brush_update");
1327
1328         prop = RNA_def_property(srna, "use_cursor_overlay_override", PROP_BOOLEAN, PROP_NONE);
1329         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_CURSOR_OVERRIDE_ON_STROKE);
1330         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1331         RNA_def_property_update(prop, 0, "rna_Brush_update");
1332
1333         prop = RNA_def_property(srna, "use_primary_overlay_override", PROP_BOOLEAN, PROP_NONE);
1334         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_PRIMARY_OVERRIDE_ON_STROKE);
1335         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1336         RNA_def_property_update(prop, 0, "rna_Brush_update");
1337
1338         prop = RNA_def_property(srna, "use_secondary_overlay_override", PROP_BOOLEAN, PROP_NONE);
1339         RNA_def_property_boolean_sdna(prop, NULL, "overlay_flags", BRUSH_OVERLAY_SECONDARY_OVERRIDE_ON_STROKE);
1340         RNA_def_property_ui_text(prop, "Override Overlay", "Don't show overlay during a stroke");
1341         RNA_def_property_update(prop, 0, "rna_Brush_update");
1342
1343         /* paint mode flags */
1344         prop = RNA_def_property(srna, "use_paint_sculpt", PROP_BOOLEAN, PROP_NONE);
1345         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_SCULPT);
1346         RNA_def_property_ui_text(prop, "Use Sculpt", "Use this brush in sculpt mode");
1347
1348         prop = RNA_def_property(srna, "use_paint_vertex", PROP_BOOLEAN, PROP_NONE);
1349         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_VERTEX_PAINT);
1350         RNA_def_property_ui_text(prop, "Use Vertex", "Use this brush in vertex paint mode");
1351
1352         prop = RNA_def_property(srna, "use_paint_weight", PROP_BOOLEAN, PROP_NONE);
1353         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_WEIGHT_PAINT);
1354         RNA_def_property_ui_text(prop, "Use Weight", "Use this brush in weight paint mode");
1355
1356         prop = RNA_def_property(srna, "use_paint_image", PROP_BOOLEAN, PROP_NONE);
1357         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_TEXTURE_PAINT);
1358         RNA_def_property_ui_text(prop, "Use Texture", "Use this brush in texture paint mode");
1359
1360         /* texture */
1361         prop = RNA_def_property(srna, "texture_slot", PROP_POINTER, PROP_NONE);
1362         RNA_def_property_struct_type(prop, "BrushTextureSlot");
1363         RNA_def_property_pointer_sdna(prop, NULL, "mtex");
1364         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1365         RNA_def_property_ui_text(prop, "Texture Slot", "");
1366
1367         prop = RNA_def_property(srna, "texture", PROP_POINTER, PROP_NONE);
1368         RNA_def_property_pointer_sdna(prop, NULL, "mtex.tex");
1369         RNA_def_property_flag(prop, PROP_EDITABLE);
1370         RNA_def_property_ui_text(prop, "Texture", "");
1371         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_main_tex_update");
1372
1373         prop = RNA_def_property(srna, "mask_texture_slot", PROP_POINTER, PROP_NONE);
1374         RNA_def_property_struct_type(prop, "BrushTextureSlot");
1375         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex");
1376         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
1377         RNA_def_property_ui_text(prop, "Mask Texture Slot", "");
1378
1379         prop = RNA_def_property(srna, "mask_texture", PROP_POINTER, PROP_NONE);
1380         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex.tex");
1381         RNA_def_property_flag(prop, PROP_EDITABLE);
1382         RNA_def_property_ui_text(prop, "Mask Texture", "");
1383         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_secondary_tex_update");
1384
1385         prop = RNA_def_property(srna, "texture_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1386         RNA_def_property_int_sdna(prop, NULL, "texture_overlay_alpha");
1387         RNA_def_property_range(prop, 0, 100);
1388         RNA_def_property_ui_text(prop, "Texture Overlay Alpha", "");
1389         RNA_def_property_update(prop, 0, "rna_Brush_update");
1390
1391         prop = RNA_def_property(srna, "mask_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1392         RNA_def_property_int_sdna(prop, NULL, "mask_overlay_alpha");
1393         RNA_def_property_range(prop, 0, 100);
1394         RNA_def_property_ui_text(prop, "Mask Texture Overlay Alpha", "");
1395         RNA_def_property_update(prop, 0, "rna_Brush_update");
1396
1397         prop = RNA_def_property(srna, "cursor_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1398         RNA_def_property_int_sdna(prop, NULL, "cursor_overlay_alpha");
1399         RNA_def_property_range(prop, 0, 100);
1400         RNA_def_property_ui_text(prop, "Mask Texture Overlay Alpha", "");
1401         RNA_def_property_update(prop, 0, "rna_Brush_update");
1402
1403         prop = RNA_def_property(srna, "cursor_color_add", PROP_FLOAT, PROP_COLOR);
1404         RNA_def_property_float_sdna(prop, NULL, "add_col");
1405         RNA_def_property_array(prop, 3);
1406         RNA_def_property_ui_text(prop, "Add Color", "Color of cursor when adding");
1407         RNA_def_property_update(prop, 0, "rna_Brush_update");
1408
1409         prop = RNA_def_property(srna, "cursor_color_subtract", PROP_FLOAT, PROP_COLOR);
1410         RNA_def_property_float_sdna(prop, NULL, "sub_col");
1411         RNA_def_property_array(prop, 3);
1412         RNA_def_property_ui_text(prop, "Subtract Color", "Color of cursor when subtracting");
1413         RNA_def_property_update(prop, 0, "rna_Brush_update");
1414
1415         prop = RNA_def_property(srna, "use_custom_icon", PROP_BOOLEAN, PROP_NONE);
1416         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_CUSTOM_ICON);
1417         RNA_def_property_ui_text(prop, "Custom Icon", "Set the brush icon from an image file");
1418         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1419
1420         prop = RNA_def_property(srna, "icon_filepath", PROP_STRING, PROP_FILEPATH);
1421         RNA_def_property_string_sdna(prop, NULL, "icon_filepath");
1422         RNA_def_property_ui_text(prop, "Brush Icon Filepath", "File path to brush icon");
1423         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1424
1425         /* clone tool */
1426         prop = RNA_def_property(srna, "clone_image", PROP_POINTER, PROP_NONE);
1427         RNA_def_property_pointer_sdna(prop, NULL, "clone.image");
1428         RNA_def_property_flag(prop, PROP_EDITABLE);
1429         RNA_def_property_ui_text(prop, "Clone Image", "Image for clone tool");
1430         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1431
1432         prop = RNA_def_property(srna, "clone_alpha", PROP_FLOAT, PROP_NONE);
1433         RNA_def_property_float_sdna(prop, NULL, "clone.alpha");
1434         RNA_def_property_range(prop, 0.0f, 1.0f);
1435         RNA_def_property_ui_text(prop, "Clone Alpha", "Opacity of clone image display");
1436         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1437
1438         prop = RNA_def_property(srna, "clone_offset", PROP_FLOAT, PROP_XYZ);
1439         RNA_def_property_float_sdna(prop, NULL, "clone.offset");
1440         RNA_def_property_ui_text(prop, "Clone Offset", "");
1441         RNA_def_property_ui_range(prop, -1.0f, 1.0f, 10.0f, 3);
1442         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1443
1444         prop = RNA_def_property(srna, "brush_capabilities", PROP_POINTER, PROP_NONE);
1445         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1446         RNA_def_property_struct_type(prop, "BrushCapabilities");
1447         RNA_def_property_pointer_funcs(prop, "rna_Brush_capabilities_get", NULL, NULL, NULL);
1448         RNA_def_property_ui_text(prop, "Brush Capabilities", "Brush's capabilities");
1449
1450         /* brush capabilities (mode-dependent) */
1451         prop = RNA_def_property(srna, "sculpt_capabilities", PROP_POINTER, PROP_NONE);
1452         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1453         RNA_def_property_struct_type(prop, "SculptToolCapabilities");
1454         RNA_def_property_pointer_funcs(prop, "rna_Sculpt_tool_capabilities_get", NULL, NULL, NULL);
1455         RNA_def_property_ui_text(prop, "Sculpt Capabilities", "Brush's capabilities in sculpt mode");
1456
1457         prop = RNA_def_property(srna, "image_paint_capabilities", PROP_POINTER, PROP_NONE);
1458         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1459         RNA_def_property_struct_type(prop, "ImapaintToolCapabilities");
1460         RNA_def_property_pointer_funcs(prop, "rna_Imapaint_tool_capabilities_get", NULL, NULL, NULL);
1461         RNA_def_property_ui_text(prop, "Image Painting Capabilities", "Brush's capabilities in image paint mode");
1462 }
1463
1464
1465 /* A brush stroke is a list of changes to the brush that
1466  * can occur during a stroke
1467  *
1468  *  o 3D location of the brush
1469  *  o 2D mouse location
1470  *  o Tablet pressure
1471  *  o Direction flip
1472  *  o Tool switch
1473  *  o Time
1474  */
1475 static void rna_def_operator_stroke_element(BlenderRNA *brna)
1476 {
1477         StructRNA *srna;
1478         PropertyRNA *prop;
1479
1480         srna = RNA_def_struct(brna, "OperatorStrokeElement", "PropertyGroup");
1481         RNA_def_struct_ui_text(srna, "Operator Stroke Element", "");
1482
1483         prop = RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
1484         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1485         RNA_def_property_array(prop, 3);
1486         RNA_def_property_ui_text(prop, "Location", "");
1487
1488         prop = RNA_def_property(srna, "mouse", PROP_FLOAT, PROP_XYZ);
1489         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1490         RNA_def_property_array(prop, 2);
1491         RNA_def_property_ui_text(prop, "Mouse", "");
1492
1493         prop = RNA_def_property(srna, "pressure", PROP_FLOAT, PROP_NONE);
1494         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1495         RNA_def_property_range(prop, 0.0f, 1.0f);
1496         RNA_def_property_ui_text(prop, "Pressure", "Tablet pressure");
1497
1498         prop = RNA_def_property(srna, "size", PROP_FLOAT, PROP_NONE);
1499         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1500         RNA_def_property_range(prop, 0.0f, FLT_MAX);
1501         RNA_def_property_ui_text(prop, "Brush Size", "Brush Size in screen space");
1502
1503         prop = RNA_def_property(srna, "pen_flip", PROP_BOOLEAN, PROP_NONE);
1504         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1505         RNA_def_property_ui_text(prop, "Flip", "");
1506
1507         /* used in uv painting */
1508         prop = RNA_def_property(srna, "time", PROP_FLOAT, PROP_UNSIGNED);
1509         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1510         RNA_def_property_ui_text(prop, "Time", "");
1511
1512         /* used for Grease Pencil sketching sessions */
1513         prop = RNA_def_property(srna, "is_start", PROP_BOOLEAN, PROP_NONE);
1514         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1515         RNA_def_property_ui_text(prop, "Is Stroke Start", "");
1516
1517         /* XXX: Tool (this will be for pressing a modifier key for a different brush,
1518          *      e.g. switching to a Smooth brush in the middle of the stroke */
1519
1520         /* XXX: i don't think blender currently supports the ability to properly do a remappable modifier
1521          *      in the middle of a stroke */
1522 }
1523
1524 void RNA_def_brush(BlenderRNA *brna)
1525 {
1526         rna_def_brush(brna);
1527         rna_def_brush_capabilities(brna);
1528         rna_def_sculpt_capabilities(brna);
1529         rna_def_image_paint_capabilities(brna);
1530         rna_def_brush_texture_slot(brna);
1531         rna_def_operator_stroke_element(brna);
1532 }
1533
1534 #endif