First fix for install_deps and ubuntu 10.04 (no libtiff5, only libtiff4, wonder why...
[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 "RNA_define.h"
31
32 #include "DNA_brush_types.h"
33 #include "DNA_texture_types.h"
34 #include "DNA_scene_types.h"
35 #include "DNA_object_types.h"
36
37 #include "BLI_math.h"
38
39 #include "rna_internal.h"
40
41 #include "IMB_imbuf.h"
42
43 #include "WM_types.h"
44
45 static EnumPropertyItem prop_direction_items[] = {
46         {0, "ADD", 0, "Add", "Add effect of brush"},
47         {BRUSH_DIR_IN, "SUBTRACT", 0, "Subtract", "Subtract effect of brush"},
48         {0, NULL, 0, NULL, NULL}
49 };
50
51 EnumPropertyItem brush_sculpt_tool_items[] = {
52         {SCULPT_TOOL_BLOB, "BLOB", ICON_BRUSH_BLOB, "Blob", ""},
53         {SCULPT_TOOL_CLAY, "CLAY", ICON_BRUSH_CLAY, "Clay", ""},
54         {SCULPT_TOOL_CLAY_STRIPS, "CLAY_STRIPS", ICON_BRUSH_CLAY_STRIPS, "Clay Strips", ""},
55         {SCULPT_TOOL_CREASE, "CREASE", ICON_BRUSH_CREASE, "Crease", ""},
56         {SCULPT_TOOL_DRAW, "DRAW", ICON_BRUSH_SCULPT_DRAW, "Draw", ""},
57         {SCULPT_TOOL_FILL, "FILL", ICON_BRUSH_FILL, "Fill", ""},
58         {SCULPT_TOOL_FLATTEN, "FLATTEN", ICON_BRUSH_FLATTEN, "Flatten", ""},
59         {SCULPT_TOOL_GRAB, "GRAB", ICON_BRUSH_GRAB, "Grab", ""},
60         {SCULPT_TOOL_INFLATE, "INFLATE", ICON_BRUSH_INFLATE, "Inflate", ""},
61         {SCULPT_TOOL_LAYER, "LAYER", ICON_BRUSH_LAYER, "Layer", ""},
62         {SCULPT_TOOL_MASK, "MASK", ICON_BRUSH_MASK, "Mask", ""},
63         {SCULPT_TOOL_NUDGE, "NUDGE", ICON_BRUSH_NUDGE, "Nudge", ""},
64         {SCULPT_TOOL_PINCH, "PINCH", ICON_BRUSH_PINCH, "Pinch", ""},
65         {SCULPT_TOOL_ROTATE, "ROTATE", ICON_BRUSH_ROTATE, "Rotate", ""},
66         {SCULPT_TOOL_SCRAPE, "SCRAPE", ICON_BRUSH_SCRAPE, "Scrape", ""},
67         {SCULPT_TOOL_SIMPLIFY, "SIMPLIFY", ICON_BRUSH_SUBTRACT /* icon TODO */, "Simplify", ""},
68         {SCULPT_TOOL_SMOOTH, "SMOOTH", ICON_BRUSH_SMOOTH, "Smooth", ""},
69         {SCULPT_TOOL_SNAKE_HOOK, "SNAKE_HOOK", ICON_BRUSH_SNAKE_HOOK, "Snake Hook", ""},
70         {SCULPT_TOOL_THUMB, "THUMB", ICON_BRUSH_THUMB, "Thumb", ""},
71         {0, NULL, 0, NULL, NULL}
72 };
73
74
75 EnumPropertyItem brush_vertex_tool_items[] = {
76         {PAINT_BLEND_MIX, "MIX", ICON_BRUSH_MIX, "Mix", "Use mix blending mode while painting"},
77         {PAINT_BLEND_ADD, "ADD", ICON_BRUSH_ADD, "Add", "Use add blending mode while painting"},
78         {PAINT_BLEND_SUB, "SUB", ICON_BRUSH_SUBTRACT, "Subtract", "Use subtract blending mode while painting"},
79         {PAINT_BLEND_MUL, "MUL", ICON_BRUSH_MULTIPLY, "Multiply", "Use multiply blending mode while painting"},
80         {PAINT_BLEND_BLUR, "BLUR", ICON_BRUSH_BLUR, "Blur", "Blur the color with surrounding values"},
81         {PAINT_BLEND_LIGHTEN, "LIGHTEN", ICON_BRUSH_LIGHTEN, "Lighten", "Use lighten blending mode while painting"},
82         {PAINT_BLEND_DARKEN, "DARKEN", ICON_BRUSH_DARKEN, "Darken", "Use darken blending mode while painting"},
83         {0, NULL, 0, NULL, NULL}
84 };
85         
86 EnumPropertyItem brush_image_tool_items[] = {
87         {PAINT_TOOL_DRAW, "DRAW", ICON_BRUSH_TEXDRAW, "Draw", ""},
88         {PAINT_TOOL_SOFTEN, "SOFTEN", ICON_BRUSH_SOFTEN, "Soften", ""},
89         {PAINT_TOOL_SMEAR, "SMEAR", ICON_BRUSH_SMEAR, "Smear", ""},
90         {PAINT_TOOL_CLONE, "CLONE", ICON_BRUSH_CLONE, "Clone", ""},
91         {0, NULL, 0, NULL, NULL}
92 };
93
94 #ifdef RNA_RUNTIME
95
96 #include "MEM_guardedalloc.h"
97
98 #include "DNA_object_types.h"
99
100 #include "RNA_access.h"
101
102 #include "BKE_texture.h"
103 #include "BKE_brush.h"
104 #include "BKE_icons.h"
105 #include "BKE_paint.h"
106
107 #include "WM_api.h"
108
109 static int rna_SculptToolCapabilities_has_accumulate_get(PointerRNA *ptr)
110 {
111         Brush *br = (Brush *)ptr->data;
112         return ELEM6(br->sculpt_tool,
113                      SCULPT_TOOL_BLOB, SCULPT_TOOL_CLAY, SCULPT_TOOL_CREASE,
114                      SCULPT_TOOL_DRAW, SCULPT_TOOL_INFLATE, SCULPT_TOOL_LAYER);
115 }
116
117 static int rna_SculptToolCapabilities_has_auto_smooth_get(PointerRNA *ptr)
118 {
119         Brush *br = (Brush *)ptr->data;
120         return !ELEM(br->sculpt_tool, SCULPT_TOOL_MASK, SCULPT_TOOL_SMOOTH);
121 }
122
123 static int rna_SculptToolCapabilities_has_height_get(PointerRNA *ptr)
124 {
125         Brush *br = (Brush *)ptr->data;
126         return br->sculpt_tool == SCULPT_TOOL_LAYER;
127 }
128
129 static int rna_SculptToolCapabilities_has_jitter_get(PointerRNA *ptr)
130 {
131         Brush *br = (Brush *)ptr->data;
132         return (!(br->flag & BRUSH_ANCHORED) &&
133                 !(br->flag & BRUSH_RESTORE_MESH) &&
134                 !ELEM4(br->sculpt_tool,
135                        SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
136                        SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
137 }
138
139 static int rna_SculptToolCapabilities_has_normal_weight_get(PointerRNA *ptr)
140 {
141         Brush *br = (Brush *)ptr->data;
142         return ELEM(br->sculpt_tool, SCULPT_TOOL_GRAB, SCULPT_TOOL_SNAKE_HOOK);
143 }
144
145 static int rna_BrushCapabilities_has_overlay_get(PointerRNA *ptr)
146 {
147         Brush *br = (Brush *)ptr->data;
148         return ELEM3(br->mtex.brush_map_mode,
149                     MTEX_MAP_MODE_VIEW,
150                     MTEX_MAP_MODE_TILED,
151                     MTEX_MAP_MODE_STENCIL);
152 }
153
154 static int rna_SculptToolCapabilities_has_persistence_get(PointerRNA *ptr)
155 {
156         Brush *br = (Brush *)ptr->data;
157         return br->sculpt_tool == SCULPT_TOOL_LAYER;
158 }
159
160 static int rna_SculptToolCapabilities_has_pinch_factor_get(PointerRNA *ptr)
161 {
162         Brush *br = (Brush *)ptr->data;
163         return ELEM(br->sculpt_tool, SCULPT_TOOL_BLOB, SCULPT_TOOL_CREASE);
164 }
165
166 static int rna_SculptToolCapabilities_has_plane_offset_get(PointerRNA *ptr)
167 {
168         Brush *br = (Brush *)ptr->data;
169         return ELEM5(br->sculpt_tool, SCULPT_TOOL_CLAY, SCULPT_TOOL_CLAY_STRIPS,
170                      SCULPT_TOOL_FILL, SCULPT_TOOL_FLATTEN, SCULPT_TOOL_SCRAPE);
171 }
172
173 static int rna_SculptToolCapabilities_has_random_texture_angle_get(PointerRNA *ptr)
174 {
175         Brush *br = (Brush *)ptr->data;
176         return (!ELEM4(br->sculpt_tool,
177                        SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
178                        SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
179 }
180
181 static int rna_BrushCapabilities_has_random_texture_angle_get(PointerRNA *ptr)
182 {
183         Brush *br = (Brush *)ptr->data;
184         return (ELEM(br->mtex.brush_map_mode,
185                      MTEX_MAP_MODE_VIEW,
186                      MTEX_MAP_MODE_AREA) &&
187                 !(br->flag & BRUSH_ANCHORED));
188 }
189
190 static int rna_SculptToolCapabilities_has_sculpt_plane_get(PointerRNA *ptr)
191 {
192         Brush *br = (Brush *)ptr->data;
193         return !ELEM4(br->sculpt_tool, SCULPT_TOOL_INFLATE,
194                       SCULPT_TOOL_MASK, SCULPT_TOOL_PINCH,
195                       SCULPT_TOOL_SMOOTH);
196 }
197
198 static int rna_SculptToolCapabilities_has_secondary_color_get(PointerRNA *ptr)
199 {
200         Brush *br = (Brush *)ptr->data;
201         return ELEM10(br->sculpt_tool,
202                       SCULPT_TOOL_BLOB, SCULPT_TOOL_CLAY, SCULPT_TOOL_CLAY_STRIPS,
203                       SCULPT_TOOL_CREASE, SCULPT_TOOL_DRAW, SCULPT_TOOL_FILL,
204                       SCULPT_TOOL_FLATTEN, SCULPT_TOOL_INFLATE, SCULPT_TOOL_PINCH,
205                       SCULPT_TOOL_SCRAPE);
206 }
207
208 static int rna_SculptToolCapabilities_has_smooth_stroke_get(PointerRNA *ptr)
209 {
210         Brush *br = (Brush *)ptr->data;
211         return (!(br->flag & BRUSH_ANCHORED) &&
212                 !(br->flag & BRUSH_RESTORE_MESH) &&
213                 !ELEM4(br->sculpt_tool,
214                        SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
215                        SCULPT_TOOL_SNAKE_HOOK, SCULPT_TOOL_THUMB));
216 }
217
218 static int rna_SculptToolCapabilities_has_space_attenuation_get(PointerRNA *ptr)
219 {
220         Brush *br = (Brush *)ptr->data;
221         return ((br->flag & BRUSH_SPACE) &&
222                 !ELEM4(br->sculpt_tool, SCULPT_TOOL_GRAB, SCULPT_TOOL_ROTATE,
223                        SCULPT_TOOL_SMOOTH, SCULPT_TOOL_SNAKE_HOOK));
224 }
225
226 static int rna_BrushCapabilities_has_spacing_get(PointerRNA *ptr)
227 {
228         Brush *br = (Brush *)ptr->data;
229         return (!(br->flag & BRUSH_ANCHORED));
230 }
231
232 static int rna_SculptToolCapabilities_has_strength_get(PointerRNA *ptr)
233 {
234         Brush *br = (Brush *)ptr->data;
235         return !ELEM(br->sculpt_tool, SCULPT_TOOL_GRAB, SCULPT_TOOL_SNAKE_HOOK);
236 }
237
238 static int rna_BrushCapabilities_has_texture_angle_get(PointerRNA *ptr)
239 {
240         Brush *br = (Brush *)ptr->data;
241         return ELEM4(br->mtex.brush_map_mode,
242                      MTEX_MAP_MODE_VIEW,
243                      MTEX_MAP_MODE_AREA,
244                      MTEX_MAP_MODE_TILED,
245                      MTEX_MAP_MODE_STENCIL);
246 }
247
248 static int rna_BrushCapabilities_has_texture_angle_source_get(PointerRNA *ptr)
249 {
250         Brush *br = (Brush *)ptr->data;
251         return ELEM(br->mtex.brush_map_mode,
252                     MTEX_MAP_MODE_VIEW,
253                     MTEX_MAP_MODE_AREA);
254 }
255
256 static PointerRNA rna_Sculpt_sculpt_tool_capabilities_get(PointerRNA *ptr)
257 {
258         return rna_pointer_inherit_refine(ptr, &RNA_SculptToolCapabilities, ptr->id.data);
259 }
260
261 static PointerRNA rna_Brush_capabilities_get(PointerRNA *ptr)
262 {
263         return rna_pointer_inherit_refine(ptr, &RNA_BrushCapabilities, ptr->id.data);
264 }
265
266 static void rna_Brush_reset_icon(Brush *br, const char *UNUSED(type))
267 {
268         ID *id = &br->id;
269
270         if (br->flag & BRUSH_CUSTOM_ICON)
271                 return;
272
273         if (id->icon_id >= BIFICONID_LAST) {
274                 BKE_icon_delete(id);
275                 BKE_previewimg_free_id(id);
276         }
277
278         id->icon_id = 0;
279 }
280
281 static void rna_Brush_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
282 {
283         Brush *br = (Brush *)ptr->data;
284         WM_main_add_notifier(NC_BRUSH | NA_EDITED, br);
285         /*WM_main_add_notifier(NC_SPACE|ND_SPACE_VIEW3D, NULL); */
286 }
287
288 static void rna_Brush_sculpt_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
289 {
290         Brush *br = (Brush *)ptr->data;
291         rna_Brush_reset_icon(br, "sculpt");
292         rna_Brush_update(bmain, scene, ptr);
293 }
294  
295 static void rna_Brush_vertex_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
296 {
297         Brush *br = (Brush *)ptr->data;
298         rna_Brush_reset_icon(br, "vertex_paint");
299         rna_Brush_update(bmain, scene, ptr);
300 }
301  
302 static void rna_Brush_imagepaint_tool_update(Main *bmain, Scene *scene, PointerRNA *ptr)
303 {
304         Brush *br = (Brush *)ptr->data;
305         rna_Brush_reset_icon(br, "image_paint");
306         rna_Brush_update(bmain, scene, ptr);
307 }
308
309 static void rna_Brush_icon_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
310 {
311         Brush *br = (Brush *)ptr->data;
312
313         if (br->icon_imbuf) {
314                 IMB_freeImBuf(br->icon_imbuf);
315                 br->icon_imbuf = NULL;
316         }
317
318         br->id.icon_id = 0;
319
320         if (br->flag & BRUSH_CUSTOM_ICON) {
321                 BKE_previewimg_get(&br->id);
322                 BKE_icon_changed(BKE_icon_getid(&br->id));
323         }
324
325         WM_main_add_notifier(NC_BRUSH | NA_EDITED, br);
326 }
327
328 static void rna_Brush_set_size(PointerRNA *ptr, int value)
329 {
330         Brush *brush = ptr->data;
331
332         /* scale unprojected radius so it stays consistent with brush size */
333         BKE_brush_scale_unprojected_radius(&brush->unprojected_radius,
334                                            value, brush->size);
335         brush->size = value;
336 }
337
338 static void rna_Brush_set_unprojected_radius(PointerRNA *ptr, float value)
339 {
340         Brush *brush = ptr->data;
341
342         /* scale brush size so it stays consistent with unprojected_radius */
343         BKE_brush_scale_size(&brush->size, value, brush->unprojected_radius);
344         brush->unprojected_radius = value;
345 }
346
347 static EnumPropertyItem *rna_Brush_direction_itemf(bContext *UNUSED(C), PointerRNA *ptr,
348                                                    PropertyRNA *UNUSED(prop), int *UNUSED(free))
349 {
350         static EnumPropertyItem prop_default_items[] = {
351                 {0, NULL, 0, NULL, NULL}
352         };
353
354         static EnumPropertyItem prop_flatten_contrast_items[] = {
355                 {0, "FLATTEN", 0, "Flatten", "Add effect of brush"},
356                 {BRUSH_DIR_IN, "CONTRAST", 0, "Contrast", "Subtract effect of brush"},
357                 {0, NULL, 0, NULL, NULL}
358         };
359
360         static EnumPropertyItem prop_fill_deepen_items[] = {
361                 {0, "FILL", 0, "Fill", "Add effect of brush"},
362                 {BRUSH_DIR_IN, "DEEPEN", 0, "Deepen", "Subtract effect of brush"},
363                 {0, NULL, 0, NULL, NULL}
364         };
365
366         static EnumPropertyItem prop_scrape_peaks_items[] = {
367                 {0, "SCRAPE", 0, "Scrape", "Add effect of brush"},
368                 {BRUSH_DIR_IN, "PEAKS", 0, "Peaks", "Subtract effect of brush"},
369                 {0, NULL, 0, NULL, NULL}
370         };
371
372         static EnumPropertyItem prop_pinch_magnify_items[] = {
373                 {0, "PINCH", 0, "Pinch", "Add effect of brush"},
374                 {BRUSH_DIR_IN, "MAGNIFY", 0, "Magnify", "Subtract effect of brush"},
375                 {0, NULL, 0, NULL, NULL}
376         };
377
378         static EnumPropertyItem prop_inflate_deflate_items[] = {
379                 {0, "INFLATE", 0, "Inflate", "Add effect of brush"},
380                 {BRUSH_DIR_IN, "DEFLATE", 0, "Deflate", "Subtract effect of brush"},
381                 {0, NULL, 0, NULL, NULL}
382         };
383
384         Brush *me = (Brush *)(ptr->data);
385
386         switch (me->sculpt_tool) {
387                 case SCULPT_TOOL_DRAW:
388                 case SCULPT_TOOL_CREASE:
389                 case SCULPT_TOOL_BLOB:
390                 case SCULPT_TOOL_LAYER:
391                 case SCULPT_TOOL_CLAY:
392                 case SCULPT_TOOL_CLAY_STRIPS:
393                         return prop_direction_items;
394
395                 case SCULPT_TOOL_MASK:
396                         switch ((BrushMaskTool)me->mask_tool) {
397                                 case BRUSH_MASK_DRAW:
398                                         return prop_direction_items;
399                                         break;
400                                 case BRUSH_MASK_SMOOTH:
401                                         return prop_default_items;
402                                         break;
403                         }
404
405                 case SCULPT_TOOL_FLATTEN:
406                         return prop_flatten_contrast_items;
407
408                 case SCULPT_TOOL_FILL:
409                         return prop_fill_deepen_items;
410
411                 case SCULPT_TOOL_SCRAPE:
412                         return prop_scrape_peaks_items;
413
414                 case SCULPT_TOOL_PINCH:
415                         return prop_pinch_magnify_items;
416
417                 case SCULPT_TOOL_INFLATE:
418                         return prop_inflate_deflate_items;
419
420                 default:
421                         return prop_default_items;
422         }
423 }
424
425 #else
426
427 static void rna_def_brush_texture_slot(BlenderRNA *brna)
428 {
429         StructRNA *srna;
430         PropertyRNA *prop;
431
432         static EnumPropertyItem prop_map_mode_items[] = {
433                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
434                 {MTEX_MAP_MODE_AREA, "AREA_PLANE", 0, "Area Plane", ""},
435                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
436                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
437                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
438                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
439                 {0, NULL, 0, NULL, NULL}
440         };
441
442         static EnumPropertyItem prop_tex_paint_map_mode_items[] = {
443                 {MTEX_MAP_MODE_VIEW, "VIEW_PLANE", 0, "View Plane", ""},
444                 {MTEX_MAP_MODE_TILED, "TILED", 0, "Tiled", ""},
445                 {MTEX_MAP_MODE_3D, "3D", 0, "3D", ""},
446                 {MTEX_MAP_MODE_RANDOM, "RANDOM", 0, "Random", ""},
447                 {MTEX_MAP_MODE_STENCIL, "STENCIL", 0, "Stencil", ""},
448                 {0, NULL, 0, NULL, NULL}
449         };
450
451         srna = RNA_def_struct(brna, "BrushTextureSlot", "TextureSlot");
452         RNA_def_struct_sdna(srna, "MTex");
453         RNA_def_struct_ui_text(srna, "Brush Texture Slot", "Texture slot for textures in a Brush datablock");
454
455         prop = RNA_def_property(srna, "angle", PROP_FLOAT, PROP_ANGLE);
456         RNA_def_property_float_sdna(prop, NULL, "rot");
457         RNA_def_property_range(prop, 0, M_PI * 2);
458         RNA_def_property_ui_text(prop, "Angle", "Brush texture rotation");
459         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
460
461         prop = RNA_def_property(srna, "map_mode", PROP_ENUM, PROP_NONE);
462         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
463         RNA_def_property_enum_items(prop, prop_map_mode_items);
464         RNA_def_property_ui_text(prop, "Mode", "");
465         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
466
467         prop = RNA_def_property(srna, "tex_paint_map_mode", PROP_ENUM, PROP_NONE);
468         RNA_def_property_enum_sdna(prop, NULL, "brush_map_mode");
469         RNA_def_property_enum_items(prop, prop_tex_paint_map_mode_items);
470         RNA_def_property_ui_text(prop, "Mode", "");
471         RNA_def_property_update(prop, 0, "rna_TextureSlot_update");
472 }
473
474 static void rna_def_sculpt_capabilities(BlenderRNA *brna)
475 {
476         StructRNA *srna;
477         PropertyRNA *prop;
478
479         srna = RNA_def_struct(brna, "SculptToolCapabilities", NULL);
480         RNA_def_struct_sdna(srna, "Brush");
481         RNA_def_struct_nested(brna, srna, "Brush");
482         RNA_def_struct_ui_text(srna, "Sculpt Capabilities",
483                                "Read-only indications of which brush operations "
484                                "are supported by the current sculpt tool");
485
486 #define SCULPT_TOOL_CAPABILITY(prop_name_, ui_name_)                      \
487         prop = RNA_def_property(srna, #prop_name_,                          \
488                                 PROP_BOOLEAN, PROP_NONE);                   \
489         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
490         RNA_def_property_boolean_funcs(prop, "rna_SculptToolCapabilities_"      \
491                                        #prop_name_ "_get", NULL);           \
492         RNA_def_property_ui_text(prop, ui_name_, NULL)
493
494         SCULPT_TOOL_CAPABILITY(has_accumulate, "Has Accumulate");
495         SCULPT_TOOL_CAPABILITY(has_auto_smooth, "Has Auto Smooth");
496         SCULPT_TOOL_CAPABILITY(has_height, "Has Height");
497         SCULPT_TOOL_CAPABILITY(has_jitter, "Has Jitter");
498         SCULPT_TOOL_CAPABILITY(has_normal_weight, "Has Crease/Pinch Factor");
499         SCULPT_TOOL_CAPABILITY(has_persistence, "Has Persistence");
500         SCULPT_TOOL_CAPABILITY(has_pinch_factor, "Has Pinch Factor");
501         SCULPT_TOOL_CAPABILITY(has_plane_offset, "Has Plane Offset");
502         SCULPT_TOOL_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
503         SCULPT_TOOL_CAPABILITY(has_sculpt_plane, "Has Sculpt Plane");
504         SCULPT_TOOL_CAPABILITY(has_secondary_color, "Has Secondary Color");
505         SCULPT_TOOL_CAPABILITY(has_smooth_stroke, "Has Smooth Stroke");
506         SCULPT_TOOL_CAPABILITY(has_space_attenuation, "Has Space Attenuation");
507         SCULPT_TOOL_CAPABILITY(has_strength, "Has Strength");
508
509 #undef SCULPT_CAPABILITY
510 }
511
512 static void rna_def_brush_capabilities(BlenderRNA *brna)
513 {
514         StructRNA *srna;
515         PropertyRNA *prop;
516
517         srna = RNA_def_struct(brna, "BrushCapabilities", NULL);
518         RNA_def_struct_sdna(srna, "Brush");
519         RNA_def_struct_nested(brna, srna, "Brush");
520         RNA_def_struct_ui_text(srna, "Brush Capabilities",
521                                "Read-only indications of which brush operations "
522                                "are supported by the current brush");
523
524 #define BRUSH_CAPABILITY(prop_name_, ui_name_)                          \
525         prop = RNA_def_property(srna, #prop_name_,                          \
526                                 PROP_BOOLEAN, PROP_NONE);                   \
527         RNA_def_property_clear_flag(prop, PROP_EDITABLE);                   \
528         RNA_def_property_boolean_funcs(prop, "rna_BrushCapabilities_"      \
529                                        #prop_name_ "_get", NULL);           \
530         RNA_def_property_ui_text(prop, ui_name_, NULL)
531
532         BRUSH_CAPABILITY(has_overlay, "Has Overlay");
533         BRUSH_CAPABILITY(has_random_texture_angle, "Has Random Texture Angle");
534         BRUSH_CAPABILITY(has_texture_angle, "Has Texture Angle");
535         BRUSH_CAPABILITY(has_texture_angle_source, "Has Texture Angle Source");
536         BRUSH_CAPABILITY(has_spacing, "Has Spacing");
537
538 #undef BRUSH_CAPABILITY
539 }
540
541 static void rna_def_brush(BlenderRNA *brna)
542 {
543         StructRNA *srna;
544         PropertyRNA *prop;
545         
546         static EnumPropertyItem prop_blend_items[] = {
547                 {IMB_BLEND_MIX, "MIX", 0, "Mix", "Use mix blending mode while painting"},
548                 {IMB_BLEND_ADD, "ADD", 0, "Add", "Use add blending mode while painting"},
549                 {IMB_BLEND_SUB, "SUB", 0, "Subtract", "Use subtract blending mode while painting"},
550                 {IMB_BLEND_MUL, "MUL", 0, "Multiply", "Use multiply blending mode while painting"},
551                 {IMB_BLEND_LIGHTEN, "LIGHTEN", 0, "Lighten", "Use lighten blending mode while painting"},
552                 {IMB_BLEND_DARKEN, "DARKEN", 0, "Darken", "Use darken blending mode while painting"},
553                 {IMB_BLEND_ERASE_ALPHA, "ERASE_ALPHA", 0, "Erase Alpha", "Erase alpha while painting"},
554                 {IMB_BLEND_ADD_ALPHA, "ADD_ALPHA", 0, "Add Alpha", "Add alpha while painting"},
555                 {0, NULL, 0, NULL, NULL}
556         };
557         
558         static EnumPropertyItem sculpt_stroke_method_items[] = {
559                 {0, "DOTS", 0, "Dots", "Apply paint on each mouse move step"},
560                 {BRUSH_RESTORE_MESH, "DRAG_DOT", 0, "Drag Dot", "Allows a single dot to be carefully positioned"},
561                 {BRUSH_SPACE, "SPACE", 0, "Space", "Limit brush application to the distance specified by spacing"},
562                 {BRUSH_ANCHORED, "ANCHORED", 0, "Anchored", "Keep the brush anchored to the initial location"},
563                 {BRUSH_AIRBRUSH, "AIRBRUSH", 0, "Airbrush", "Keep applying paint effect while holding mouse (spray)"},
564                 {0, NULL, 0, NULL, NULL}
565         };
566
567         static EnumPropertyItem brush_stroke_method_items[] = {
568                 {0, "DOTS", 0, "Dots", "Apply paint on each mouse move step"},
569                 {BRUSH_SPACE, "SPACE", 0, "Space", "Limit brush application to the distance specified by spacing"},
570                 {BRUSH_AIRBRUSH, "AIRBRUSH", 0, "Airbrush", "Keep applying paint effect while holding mouse (spray)"},
571                 {0, NULL, 0, NULL, NULL}
572         };
573
574         static EnumPropertyItem texture_angle_source_items[] = {
575                 {0, "USER", 0, "User", "Rotate the brush texture by given angle"},
576                 {BRUSH_RAKE, "RAKE", 0, "Rake", "Rotate the brush texture to match the stroke direction"},
577                 {BRUSH_RANDOM_ROTATION, "RANDOM", 0, "Random", "Rotate the brush texture at random"},
578                 {0, NULL, 0, NULL, NULL}
579         };
580
581         static EnumPropertyItem texture_angle_source_no_random_items[] = {
582                 {0, "USER", 0, "User", "Rotate the brush texture by given angle"},
583                 {BRUSH_RAKE, "RAKE", 0, "Rake", "Rotate the brush texture to match the stroke direction"},
584                 {0, NULL, 0, NULL, NULL}
585         };
586
587         static EnumPropertyItem brush_sculpt_plane_items[] = {
588                 {SCULPT_DISP_DIR_AREA, "AREA", 0, "Area Plane", ""},
589                 {SCULPT_DISP_DIR_VIEW, "VIEW", 0, "View Plane", ""},
590                 {SCULPT_DISP_DIR_X, "X", 0, "X Plane", ""},
591                 {SCULPT_DISP_DIR_Y, "Y", 0, "Y Plane", ""},
592                 {SCULPT_DISP_DIR_Z, "Z", 0, "Z Plane", ""},
593                 {0, NULL, 0, NULL, NULL}
594         };
595
596         static EnumPropertyItem brush_mask_tool_items[] = {
597                 {BRUSH_MASK_DRAW, "DRAW", 0, "Draw", ""},
598                 {BRUSH_MASK_SMOOTH, "SMOOTH", 0, "Smooth", ""},
599                 {0, NULL, 0, NULL, NULL}
600         };
601
602         srna = RNA_def_struct(brna, "Brush", "ID");
603         RNA_def_struct_ui_text(srna, "Brush", "Brush datablock for storing brush settings for painting and sculpting");
604         RNA_def_struct_ui_icon(srna, ICON_BRUSH_DATA);
605
606         /* enums */
607         prop = RNA_def_property(srna, "blend", PROP_ENUM, PROP_NONE);
608         RNA_def_property_enum_items(prop, prop_blend_items);
609         RNA_def_property_ui_text(prop, "Blending mode", "Brush blending mode");
610         RNA_def_property_update(prop, 0, "rna_Brush_update");
611
612         prop = RNA_def_property(srna, "sculpt_tool", PROP_ENUM, PROP_NONE);
613         RNA_def_property_enum_items(prop, brush_sculpt_tool_items);
614         RNA_def_property_ui_text(prop, "Sculpt Tool", "");
615         RNA_def_property_update(prop, 0, "rna_Brush_sculpt_tool_update");
616
617         prop = RNA_def_property(srna, "vertex_tool", PROP_ENUM, PROP_NONE);
618         RNA_def_property_enum_sdna(prop, NULL, "vertexpaint_tool");
619         RNA_def_property_enum_items(prop, brush_vertex_tool_items);
620         RNA_def_property_ui_text(prop, "Vertex/Weight Paint Tool", "");
621         RNA_def_property_update(prop, 0, "rna_Brush_vertex_tool_update");
622         
623         prop = RNA_def_property(srna, "image_tool", PROP_ENUM, PROP_NONE);
624         RNA_def_property_enum_sdna(prop, NULL, "imagepaint_tool");
625         RNA_def_property_enum_items(prop, brush_image_tool_items);
626         RNA_def_property_ui_text(prop, "Image Paint Tool", "");
627         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_imagepaint_tool_update");
628
629         prop = RNA_def_property(srna, "direction", PROP_ENUM, PROP_NONE);
630         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
631         RNA_def_property_enum_items(prop, prop_direction_items);
632         RNA_def_property_enum_funcs(prop, NULL, NULL, "rna_Brush_direction_itemf");
633         RNA_def_property_ui_text(prop, "Direction", "");
634         RNA_def_property_update(prop, 0, "rna_Brush_update");
635
636         prop = RNA_def_property(srna, "stroke_method", PROP_ENUM, PROP_NONE);
637         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
638         RNA_def_property_enum_items(prop, brush_stroke_method_items);
639         RNA_def_property_ui_text(prop, "Stroke Method", "");
640         RNA_def_property_update(prop, 0, "rna_Brush_update");
641
642         prop = RNA_def_property(srna, "sculpt_stroke_method", PROP_ENUM, PROP_NONE);
643         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
644         RNA_def_property_enum_items(prop, sculpt_stroke_method_items);
645         RNA_def_property_ui_text(prop, "Stroke Method", "");
646         RNA_def_property_update(prop, 0, "rna_Brush_update");
647
648         prop = RNA_def_property(srna, "texture_angle_source_random", PROP_ENUM, PROP_NONE);
649         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
650         RNA_def_property_enum_items(prop, texture_angle_source_items);
651         RNA_def_property_ui_text(prop, "Texture Angle Source", "");
652         RNA_def_property_update(prop, 0, "rna_Brush_update");
653
654         prop = RNA_def_property(srna, "texture_angle_source_no_random", PROP_ENUM, PROP_NONE);
655         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
656         RNA_def_property_enum_items(prop, texture_angle_source_no_random_items);
657         RNA_def_property_ui_text(prop, "Texture Angle Source", "");
658         RNA_def_property_update(prop, 0, "rna_Brush_update");
659
660         prop = RNA_def_property(srna, "sculpt_plane", PROP_ENUM, PROP_NONE);
661         RNA_def_property_enum_items(prop, brush_sculpt_plane_items);
662         RNA_def_property_ui_text(prop, "Sculpt Plane", "");
663         RNA_def_property_update(prop, 0, "rna_Brush_update");
664
665         prop = RNA_def_property(srna, "mask_tool", PROP_ENUM, PROP_NONE);
666         RNA_def_property_enum_items(prop, brush_mask_tool_items);
667         RNA_def_property_ui_text(prop, "Mask Tool", "");
668         RNA_def_property_update(prop, 0, "rna_Brush_update");
669         
670         /* number values */
671         prop = RNA_def_property(srna, "size", PROP_INT, PROP_NONE);
672         RNA_def_property_int_funcs(prop, NULL, "rna_Brush_set_size", NULL);
673         RNA_def_property_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS * 10);
674         RNA_def_property_ui_range(prop, 1, MAX_BRUSH_PIXEL_RADIUS, 1, 0);
675         RNA_def_property_ui_text(prop, "Radius", "Radius of the brush in pixels");
676         RNA_def_property_update(prop, 0, "rna_Brush_update");
677         
678         prop = RNA_def_property(srna, "unprojected_radius", PROP_FLOAT, PROP_DISTANCE);
679         RNA_def_property_float_funcs(prop, NULL, "rna_Brush_set_unprojected_radius", NULL);
680         RNA_def_property_range(prop, 0.001, FLT_MAX);
681         RNA_def_property_ui_range(prop, 0.001, 1, 0, 0);
682         RNA_def_property_ui_text(prop, "Unprojected Radius", "Radius of brush in Blender units");
683         RNA_def_property_update(prop, 0, "rna_Brush_update");
684
685         prop = RNA_def_property(srna, "jitter", PROP_FLOAT, PROP_NONE);
686         RNA_def_property_float_sdna(prop, NULL, "jitter");
687         RNA_def_property_range(prop, 0.0f, 1000.0f);
688         RNA_def_property_ui_range(prop, 0.0f, 2.0f, 0.1, 4);
689         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush while painting");
690         RNA_def_property_update(prop, 0, "rna_Brush_update");
691
692         prop = RNA_def_property(srna, "jitter_absolute", PROP_INT, PROP_NONE);
693         RNA_def_property_int_sdna(prop, NULL, "jitter_absolute");
694         RNA_def_property_range(prop, 0, 1000000);
695         RNA_def_property_ui_text(prop, "Jitter", "Jitter the position of the brush in pixels while painting");
696         RNA_def_property_update(prop, 0, "rna_Brush_update");
697
698         prop = RNA_def_property(srna, "spacing", PROP_INT, PROP_PERCENTAGE);
699         RNA_def_property_int_sdna(prop, NULL, "spacing");
700         RNA_def_property_range(prop, 1, 1000);
701         RNA_def_property_ui_range(prop, 1, 500, 5, 0);
702         RNA_def_property_ui_text(prop, "Spacing", "Spacing between brush daubs as a percentage of brush diameter");
703         RNA_def_property_update(prop, 0, "rna_Brush_update");
704
705         prop = RNA_def_property(srna, "smooth_stroke_radius", PROP_INT, PROP_NONE);
706         RNA_def_property_range(prop, 10, 200);
707         RNA_def_property_ui_text(prop, "Smooth Stroke Radius", "Minimum distance from last point before stroke continues");
708         RNA_def_property_update(prop, 0, "rna_Brush_update");
709
710         prop = RNA_def_property(srna, "smooth_stroke_factor", PROP_FLOAT, PROP_FACTOR);
711         RNA_def_property_range(prop, 0.5, 0.99);
712         RNA_def_property_ui_text(prop, "Smooth Stroke Factor", "Higher values give a smoother stroke");
713         RNA_def_property_update(prop, 0, "rna_Brush_update");
714         
715         prop = RNA_def_property(srna, "rate", PROP_FLOAT, PROP_NONE);
716         RNA_def_property_float_sdna(prop, NULL, "rate");
717         RNA_def_property_range(prop, 0.0001f, 10000.0f);
718         RNA_def_property_ui_range(prop, 0.01f, 1.0f, 1, 3);
719         RNA_def_property_ui_text(prop, "Rate", "Interval between paints for Airbrush");
720         RNA_def_property_update(prop, 0, "rna_Brush_update");
721         
722         prop = RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR_GAMMA);
723         RNA_def_property_range(prop, 0.0, 1.0);
724         RNA_def_property_float_sdna(prop, NULL, "rgb");
725         RNA_def_property_ui_text(prop, "Color", "");
726         RNA_def_property_update(prop, 0, "rna_Brush_update");
727         
728         prop = RNA_def_property(srna, "weight", PROP_FLOAT, PROP_FACTOR);
729         RNA_def_property_float_default(prop, 1.0f);
730         RNA_def_property_range(prop, 0.0f, 1.0f);
731         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
732         RNA_def_property_ui_text(prop, "Weight", "Vertex weight when brush is applied");
733         RNA_def_property_update(prop, 0, "rna_Brush_update");
734
735         prop = RNA_def_property(srna, "strength", PROP_FLOAT, PROP_FACTOR);
736         RNA_def_property_float_sdna(prop, NULL, "alpha");
737         RNA_def_property_float_default(prop, 0.5f);
738         RNA_def_property_range(prop, 0.0f, 10.0f);
739         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
740         RNA_def_property_ui_text(prop, "Strength", "How powerful the effect of the brush is when applied");
741         RNA_def_property_update(prop, 0, "rna_Brush_update");
742
743         prop = RNA_def_property(srna, "plane_offset", PROP_FLOAT, PROP_DISTANCE);
744         RNA_def_property_float_sdna(prop, NULL, "plane_offset");
745         RNA_def_property_float_default(prop, 0);
746         RNA_def_property_range(prop, -2.0f, 2.0f);
747         RNA_def_property_ui_range(prop, -0.5f, 0.5f, 0.001, 3);
748         RNA_def_property_ui_text(prop, "Plane Offset",
749                                  "Adjust plane on which the brush acts towards or away from the object surface");
750         RNA_def_property_update(prop, 0, "rna_Brush_update");
751
752         prop = RNA_def_property(srna, "plane_trim", PROP_FLOAT, PROP_DISTANCE);
753         RNA_def_property_float_sdna(prop, NULL, "plane_trim");
754         RNA_def_property_float_default(prop, 0.5f);
755         RNA_def_property_range(prop, 0, 1.0f);
756         RNA_def_property_ui_text(prop, "Plane Trim",
757                                  "If a vertex is further away from offset plane than this, then it is not affected");
758         RNA_def_property_update(prop, 0, "rna_Brush_update");
759
760         prop = RNA_def_property(srna, "height", PROP_FLOAT, PROP_DISTANCE);
761         RNA_def_property_float_sdna(prop, NULL, "height");
762         RNA_def_property_float_default(prop, 0.5f);
763         RNA_def_property_range(prop, 0, 1.0f);
764         RNA_def_property_ui_text(prop, "Brush Height", "Affectable height of brush (layer height for layer tool, i.e.)");
765         RNA_def_property_update(prop, 0, "rna_Brush_update");
766
767         prop = RNA_def_property(srna, "texture_sample_bias", PROP_FLOAT, PROP_DISTANCE);
768         RNA_def_property_float_sdna(prop, NULL, "texture_sample_bias");
769         RNA_def_property_float_default(prop, 0);
770         RNA_def_property_range(prop, -1, 1);
771         RNA_def_property_ui_text(prop, "Texture Sample Bias", "Value added to texture samples");
772         RNA_def_property_update(prop, 0, "rna_Brush_update");
773
774         prop = RNA_def_property(srna, "normal_weight", PROP_FLOAT, PROP_FACTOR);
775         RNA_def_property_float_sdna(prop, NULL, "normal_weight");
776         RNA_def_property_float_default(prop, 0);
777         RNA_def_property_range(prop, 0.0f, 1.0f);
778         RNA_def_property_ui_text(prop, "Normal Weight", "How much grab will pull vertexes out of surface during a grab");
779         RNA_def_property_update(prop, 0, "rna_Brush_update");
780
781         prop = RNA_def_property(srna, "crease_pinch_factor", PROP_FLOAT, PROP_FACTOR);
782         RNA_def_property_float_sdna(prop, NULL, "crease_pinch_factor");
783         RNA_def_property_float_default(prop, 2.0f / 3.0f);
784         RNA_def_property_range(prop, 0.0f, 1.0f);
785         RNA_def_property_ui_text(prop, "Crease Brush Pinch Factor", "How much the crease brush pinches");
786         RNA_def_property_update(prop, 0, "rna_Brush_update");
787
788         prop = RNA_def_property(srna, "auto_smooth_factor", PROP_FLOAT, PROP_FACTOR);
789         RNA_def_property_float_sdna(prop, NULL, "autosmooth_factor");
790         RNA_def_property_float_default(prop, 0);
791         RNA_def_property_range(prop, 0.0f, 1.0f);
792         RNA_def_property_ui_range(prop, 0.0f, 1.0f, 0.001, 3);
793         RNA_def_property_ui_text(prop, "Autosmooth", "Amount of smoothing to automatically apply to each stroke");
794         RNA_def_property_update(prop, 0, "rna_Brush_update");
795
796         prop = RNA_def_property(srna, "stencil_pos", PROP_FLOAT, PROP_DISTANCE);
797         RNA_def_property_float_sdna(prop, NULL, "stencil_pos");
798         RNA_def_property_array(prop, 2);
799         RNA_def_property_ui_text(prop, "Stencil Position", "Position of stencil in viewport");
800         RNA_def_property_update(prop, 0, "rna_Brush_update");
801
802         prop = RNA_def_property(srna, "stencil_dimension", PROP_FLOAT, PROP_DISTANCE);
803         RNA_def_property_float_sdna(prop, NULL, "stencil_dimension");
804         RNA_def_property_array(prop, 2);
805         RNA_def_property_ui_text(prop, "Stencil Dimensions", "Dimensions of stencil in viewport");
806         RNA_def_property_update(prop, 0, "rna_Brush_update");
807
808         /* flag */
809         prop = RNA_def_property(srna, "use_airbrush", PROP_BOOLEAN, PROP_NONE);
810         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_AIRBRUSH);
811         RNA_def_property_ui_text(prop, "Airbrush", "Keep applying paint effect while holding mouse (spray)");
812         RNA_def_property_update(prop, 0, "rna_Brush_update");
813         
814         prop = RNA_def_property(srna, "use_original_normal", PROP_BOOLEAN, PROP_NONE);
815         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ORIGINAL_NORMAL);
816         RNA_def_property_ui_text(prop, "Original Normal",
817                                  "When locked keep using normal of surface where stroke was initiated");
818         RNA_def_property_update(prop, 0, "rna_Brush_update");
819         
820         prop = RNA_def_property(srna, "use_wrap", PROP_BOOLEAN, PROP_NONE);
821         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_TORUS);
822         RNA_def_property_ui_text(prop, "Wrap", "Enable torus wrapping while painting");
823         RNA_def_property_update(prop, 0, "rna_Brush_update");
824         
825         prop = RNA_def_property(srna, "use_pressure_strength", PROP_BOOLEAN, PROP_NONE);
826         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ALPHA_PRESSURE);
827         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
828         RNA_def_property_ui_text(prop, "Strength Pressure", "Enable tablet pressure sensitivity for strength");
829         RNA_def_property_update(prop, 0, "rna_Brush_update");
830         
831         prop = RNA_def_property(srna, "use_offset_pressure", PROP_BOOLEAN, PROP_NONE);
832         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_OFFSET_PRESSURE);
833         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
834         RNA_def_property_ui_text(prop, "Plane Offset Pressure", "Enable tablet pressure sensitivity for offset");
835         RNA_def_property_update(prop, 0, "rna_Brush_update");
836
837         prop = RNA_def_property(srna, "use_pressure_size", PROP_BOOLEAN, PROP_NONE);
838         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SIZE_PRESSURE);
839         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
840         RNA_def_property_ui_text(prop, "Size Pressure", "Enable tablet pressure sensitivity for size");
841         RNA_def_property_update(prop, 0, "rna_Brush_update");
842         
843         prop = RNA_def_property(srna, "use_pressure_jitter", PROP_BOOLEAN, PROP_NONE);
844         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_JITTER_PRESSURE);
845         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
846         RNA_def_property_ui_text(prop, "Jitter Pressure", "Enable tablet pressure sensitivity for jitter");
847         RNA_def_property_update(prop, 0, "rna_Brush_update");
848
849         prop = RNA_def_property(srna, "use_pressure_spacing", PROP_BOOLEAN, PROP_NONE);
850         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACING_PRESSURE);
851         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
852         RNA_def_property_ui_text(prop, "Spacing Pressure", "Enable tablet pressure sensitivity for spacing");
853         RNA_def_property_update(prop, 0, "rna_Brush_update");
854
855         prop = RNA_def_property(srna, "use_inverse_smooth_pressure", PROP_BOOLEAN, PROP_NONE);
856         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_INVERSE_SMOOTH_PRESSURE);
857         RNA_def_property_ui_icon(prop, ICON_STYLUS_PRESSURE, 0);
858         RNA_def_property_ui_text(prop, "Inverse Smooth Pressure", "Lighter pressure causes more smoothing to be applied");
859         RNA_def_property_update(prop, 0, "rna_Brush_update");
860         
861         prop = RNA_def_property(srna, "use_rake", PROP_BOOLEAN, PROP_NONE);
862         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RAKE);
863         RNA_def_property_ui_text(prop, "Rake", "Rotate the brush texture to match the stroke direction");
864         RNA_def_property_update(prop, 0, "rna_Brush_update");
865
866         prop = RNA_def_property(srna, "use_relative_jitter", PROP_BOOLEAN, PROP_NONE);
867         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_ABSOLUTE_JITTER);
868         RNA_def_property_ui_text(prop, "Absolute Jitter", "Jittering happens in screen space, not relative to brush size");
869         RNA_def_property_update(prop, 0, "rna_Brush_update");
870
871         prop = RNA_def_property(srna, "use_random_rotation", PROP_BOOLEAN, PROP_NONE);
872         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RANDOM_ROTATION);
873         RNA_def_property_ui_text(prop, "Random Rotation", "Rotate the brush texture at random");
874         RNA_def_property_update(prop, 0, "rna_Brush_update");
875
876         prop = RNA_def_property(srna, "use_plane_trim", PROP_BOOLEAN, PROP_NONE);
877         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PLANE_TRIM);
878         RNA_def_property_ui_text(prop, "Use Plane Trim", "Enable Plane Trim");
879         RNA_def_property_update(prop, 0, "rna_Brush_update");
880
881         prop = RNA_def_property(srna, "use_frontface", PROP_BOOLEAN, PROP_NONE);
882         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_FRONTFACE);
883         RNA_def_property_ui_text(prop, "Use Front-Face", "Brush only affects vertexes that face the viewer");
884         RNA_def_property_update(prop, 0, "rna_Brush_update");
885
886         prop = RNA_def_property(srna, "use_anchor", PROP_BOOLEAN, PROP_NONE);
887         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ANCHORED);
888         RNA_def_property_ui_text(prop, "Anchored", "Keep the brush anchored to the initial location");
889         RNA_def_property_update(prop, 0, "rna_Brush_update");
890
891         prop = RNA_def_property(srna, "use_space", PROP_BOOLEAN, PROP_NONE);
892         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE);
893         RNA_def_property_ui_text(prop, "Space", "Limit brush application to the distance specified by spacing");
894         RNA_def_property_update(prop, 0, "rna_Brush_update");
895
896         prop = RNA_def_property(srna, "use_smooth_stroke", PROP_BOOLEAN, PROP_NONE);
897         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SMOOTH_STROKE);
898         RNA_def_property_ui_text(prop, "Smooth Stroke", "Brush lags behind mouse and follows a smoother path");
899         RNA_def_property_update(prop, 0, "rna_Brush_update");
900
901         prop = RNA_def_property(srna, "use_persistent", PROP_BOOLEAN, PROP_NONE);
902         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_PERSISTENT);
903         RNA_def_property_ui_text(prop, "Persistent", "Sculpt on a persistent layer of the mesh");
904         RNA_def_property_update(prop, 0, "rna_Brush_update");
905
906         prop = RNA_def_property(srna, "use_accumulate", PROP_BOOLEAN, PROP_NONE);
907         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ACCUMULATE);
908         RNA_def_property_ui_text(prop, "Accumulate", "Accumulate stroke daubs on top of each other");
909         RNA_def_property_update(prop, 0, "rna_Brush_update");
910         
911         prop = RNA_def_property(srna, "use_space_attenuation", PROP_BOOLEAN, PROP_NONE);
912         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_SPACE_ATTEN);
913         RNA_def_property_ui_text(prop, "Use Automatic Strength Adjustment",
914                                  "Automatically adjust strength to give consistent results for different spacings");
915         RNA_def_property_update(prop, 0, "rna_Brush_update");
916
917         /* adaptive space is not implemented yet */
918         prop = RNA_def_property(srna, "use_adaptive_space", PROP_BOOLEAN, PROP_NONE);
919         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_ADAPTIVE_SPACE);
920         RNA_def_property_ui_text(prop, "Adaptive Spacing",
921                                  "Space daubs according to surface orientation instead of screen space");
922         RNA_def_property_update(prop, 0, "rna_Brush_update");
923
924         prop = RNA_def_property(srna, "use_locked_size", PROP_BOOLEAN, PROP_NONE);
925         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_LOCK_SIZE);
926         RNA_def_property_ui_text(prop, "Use Blender Units",
927                                  "When locked brush stays same size relative to object; when unlocked brush size is "
928                                  "given in pixels");
929         RNA_def_property_update(prop, 0, "rna_Brush_update");
930
931         prop = RNA_def_property(srna, "use_texture_overlay", PROP_BOOLEAN, PROP_NONE);
932         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_TEXTURE_OVERLAY);
933         RNA_def_property_ui_text(prop, "Use Texture Overlay", "Show texture in viewport");
934         RNA_def_property_update(prop, 0, "rna_Brush_update");
935
936         prop = RNA_def_property(srna, "use_edge_to_edge", PROP_BOOLEAN, PROP_NONE);
937         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_EDGE_TO_EDGE);
938         RNA_def_property_ui_text(prop, "Edge-to-edge", "Drag anchor brush from edge-to-edge");
939         RNA_def_property_update(prop, 0, "rna_Brush_update");
940
941         prop = RNA_def_property(srna, "use_restore_mesh", PROP_BOOLEAN, PROP_NONE);
942         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_RESTORE_MESH);
943         RNA_def_property_ui_text(prop, "Restore Mesh", "Allow a single dot to be carefully positioned");
944         RNA_def_property_update(prop, 0, "rna_Brush_update");
945
946         /* only for projection paint, TODO, other paint modes */
947         prop = RNA_def_property(srna, "use_alpha", PROP_BOOLEAN, PROP_NONE);
948         RNA_def_property_boolean_negative_sdna(prop, NULL, "flag", BRUSH_LOCK_ALPHA);
949         RNA_def_property_ui_text(prop, "Alpha", "When this is disabled, lock alpha while painting");
950         RNA_def_property_update(prop, 0, "rna_Brush_update");
951
952         prop = RNA_def_property(srna, "curve", PROP_POINTER, PROP_NONE);
953         RNA_def_property_flag(prop, PROP_NEVER_NULL);
954         RNA_def_property_ui_text(prop, "Curve", "Editable falloff curve");
955         RNA_def_property_update(prop, 0, "rna_Brush_update");
956
957         /* paint mode flags */
958         prop = RNA_def_property(srna, "use_paint_sculpt", PROP_BOOLEAN, PROP_NONE);
959         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_SCULPT);
960         RNA_def_property_ui_text(prop, "Use Sculpt", "Use this brush in sculpt mode");
961
962         prop = RNA_def_property(srna, "use_paint_vertex", PROP_BOOLEAN, PROP_NONE);
963         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_VERTEX_PAINT);
964         RNA_def_property_ui_text(prop, "Use Vertex", "Use this brush in vertex paint mode");
965
966         prop = RNA_def_property(srna, "use_paint_weight", PROP_BOOLEAN, PROP_NONE);
967         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_WEIGHT_PAINT);
968         RNA_def_property_ui_text(prop, "Use Weight", "Use this brush in weight paint mode");
969
970         prop = RNA_def_property(srna, "use_paint_image", PROP_BOOLEAN, PROP_NONE);
971         RNA_def_property_boolean_sdna(prop, NULL, "ob_mode", OB_MODE_TEXTURE_PAINT);
972         RNA_def_property_ui_text(prop, "Use Texture", "Use this brush in texture paint mode");
973
974         /* texture */
975         prop = RNA_def_property(srna, "texture_slot", PROP_POINTER, PROP_NONE);
976         RNA_def_property_struct_type(prop, "BrushTextureSlot");
977         RNA_def_property_pointer_sdna(prop, NULL, "mtex");
978         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
979         RNA_def_property_ui_text(prop, "Texture Slot", "");
980         
981         prop = RNA_def_property(srna, "texture", PROP_POINTER, PROP_NONE);
982         RNA_def_property_pointer_sdna(prop, NULL, "mtex.tex");
983         RNA_def_property_flag(prop, PROP_EDITABLE);
984         RNA_def_property_ui_text(prop, "Texture", "");
985         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_update");
986
987         prop = RNA_def_property(srna, "mask_texture_slot", PROP_POINTER, PROP_NONE);
988         RNA_def_property_struct_type(prop, "BrushTextureSlot");
989         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex");
990         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
991         RNA_def_property_ui_text(prop, "Mask Texture Slot", "");
992
993         prop = RNA_def_property(srna, "mask_texture", PROP_POINTER, PROP_NONE);
994         RNA_def_property_pointer_sdna(prop, NULL, "mask_mtex.tex");
995         RNA_def_property_flag(prop, PROP_EDITABLE);
996         RNA_def_property_ui_text(prop, "Mask Texture", "");
997         RNA_def_property_update(prop, NC_TEXTURE, "rna_Brush_update");
998
999         prop = RNA_def_property(srna, "texture_overlay_alpha", PROP_INT, PROP_PERCENTAGE);
1000         RNA_def_property_int_sdna(prop, NULL, "texture_overlay_alpha");
1001         RNA_def_property_range(prop, 1, 100);
1002         RNA_def_property_ui_text(prop, "Texture Overlay Alpha", "");
1003         RNA_def_property_update(prop, 0, "rna_Brush_update");
1004
1005         prop = RNA_def_property(srna, "cursor_color_add", PROP_FLOAT, PROP_COLOR);
1006         RNA_def_property_float_sdna(prop, NULL, "add_col");
1007         RNA_def_property_array(prop, 3);
1008         RNA_def_property_ui_text(prop, "Add Color", "Color of cursor when adding");
1009         RNA_def_property_update(prop, 0, "rna_Brush_update");
1010
1011         prop = RNA_def_property(srna, "cursor_color_subtract", PROP_FLOAT, PROP_COLOR);
1012         RNA_def_property_float_sdna(prop, NULL, "sub_col");
1013         RNA_def_property_array(prop, 3);
1014         RNA_def_property_ui_text(prop, "Subtract Color", "Color of cursor when subtracting");
1015         RNA_def_property_update(prop, 0, "rna_Brush_update");
1016
1017         prop = RNA_def_property(srna, "use_custom_icon", PROP_BOOLEAN, PROP_NONE);
1018         RNA_def_property_boolean_sdna(prop, NULL, "flag", BRUSH_CUSTOM_ICON);
1019         RNA_def_property_ui_text(prop, "Custom Icon", "Set the brush icon from an image file");
1020         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1021
1022         prop = RNA_def_property(srna, "icon_filepath", PROP_STRING, PROP_FILEPATH);
1023         RNA_def_property_string_sdna(prop, NULL, "icon_filepath");
1024         RNA_def_property_ui_text(prop, "Brush Icon Filepath", "File path to brush icon");
1025         RNA_def_property_update(prop, 0, "rna_Brush_icon_update");
1026
1027         /* clone tool */
1028         prop = RNA_def_property(srna, "clone_image", PROP_POINTER, PROP_NONE);
1029         RNA_def_property_pointer_sdna(prop, NULL, "clone.image");
1030         RNA_def_property_flag(prop, PROP_EDITABLE);
1031         RNA_def_property_ui_text(prop, "Clone Image", "Image for clone tool");
1032         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1033         
1034         prop = RNA_def_property(srna, "clone_alpha", PROP_FLOAT, PROP_NONE);
1035         RNA_def_property_float_sdna(prop, NULL, "clone.alpha");
1036         RNA_def_property_range(prop, 0.0f, 1.0f);
1037         RNA_def_property_ui_text(prop, "Clone Alpha", "Opacity of clone image display");
1038         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1039
1040         prop = RNA_def_property(srna, "clone_offset", PROP_FLOAT, PROP_XYZ);
1041         RNA_def_property_float_sdna(prop, NULL, "clone.offset");
1042         RNA_def_property_ui_text(prop, "Clone Offset", "");
1043         RNA_def_property_ui_range(prop, -1.0f, 1.0f, 10.0f, 3);
1044         RNA_def_property_update(prop, NC_SPACE | ND_SPACE_IMAGE, "rna_Brush_update");
1045
1046         prop = RNA_def_property(srna, "brush_capabilities", PROP_POINTER, PROP_NONE);
1047         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1048         RNA_def_property_struct_type(prop, "BrushCapabilities");
1049         RNA_def_property_pointer_funcs(prop, "rna_Brush_capabilities_get", NULL, NULL, NULL);
1050         RNA_def_property_ui_text(prop, "Brush Capabilities", "Brush's capabilities");
1051
1052         /* brush capabilities (mode-dependent) */
1053         prop = RNA_def_property(srna, "sculpt_capabilities", PROP_POINTER, PROP_NONE);
1054         RNA_def_property_flag(prop, PROP_NEVER_NULL);
1055         RNA_def_property_struct_type(prop, "SculptToolCapabilities");
1056         RNA_def_property_pointer_funcs(prop, "rna_Sculpt_sculpt_tool_capabilities_get", NULL, NULL, NULL);
1057         RNA_def_property_ui_text(prop, "Sculpt Capabilities", "Brush's capabilities in sculpt mode");
1058 }
1059
1060
1061 /* A brush stroke is a list of changes to the brush that
1062  * can occur during a stroke
1063  *
1064  *  o 3D location of the brush
1065  *  o 2D mouse location
1066  *  o Tablet pressure
1067  *  o Direction flip
1068  *  o Tool switch
1069  *  o Time
1070  */
1071 static void rna_def_operator_stroke_element(BlenderRNA *brna)
1072 {
1073         StructRNA *srna;
1074         PropertyRNA *prop;
1075
1076         srna = RNA_def_struct(brna, "OperatorStrokeElement", "PropertyGroup");
1077         RNA_def_struct_ui_text(srna, "Operator Stroke Element", "");
1078
1079         prop = RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
1080         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1081         RNA_def_property_array(prop, 3);
1082         RNA_def_property_ui_text(prop, "Location", "");
1083
1084         prop = RNA_def_property(srna, "mouse", PROP_FLOAT, PROP_XYZ);
1085         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1086         RNA_def_property_array(prop, 2);
1087         RNA_def_property_ui_text(prop, "Mouse", "");
1088
1089         prop = RNA_def_property(srna, "pressure", PROP_FLOAT, PROP_NONE);
1090         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1091         RNA_def_property_range(prop, 0.0f, 1.0f);
1092         RNA_def_property_ui_text(prop, "Pressure", "Tablet pressure");
1093
1094         prop = RNA_def_property(srna, "pen_flip", PROP_BOOLEAN, PROP_NONE);
1095         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1096         RNA_def_property_ui_text(prop, "Flip", "");
1097
1098         /* used in uv painting */
1099         prop = RNA_def_property(srna, "time", PROP_FLOAT, PROP_UNSIGNED);
1100         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1101         RNA_def_property_ui_text(prop, "Time", "");
1102         
1103         /* used for Grease Pencil sketching sessions */
1104         prop = RNA_def_property(srna, "is_start", PROP_BOOLEAN, PROP_NONE);
1105         RNA_def_property_flag(prop, PROP_IDPROPERTY);
1106         RNA_def_property_ui_text(prop, "Is Stroke Start", "");
1107
1108         /* XXX: Tool (this will be for pressing a modifier key for a different brush,
1109          *      e.g. switching to a Smooth brush in the middle of the stroke */
1110
1111         /* XXX: i don't think blender currently supports the ability to properly do a remappable modifier
1112          *      in the middle of a stroke */
1113 }
1114
1115 void RNA_def_brush(BlenderRNA *brna)
1116 {
1117         rna_def_brush(brna);
1118         rna_def_brush_capabilities(brna);
1119         rna_def_sculpt_capabilities(brna);
1120         rna_def_brush_texture_slot(brna);
1121         rna_def_operator_stroke_element(brna);
1122 }
1123
1124 #endif