doxygen: prevent GPL license block from being parsed as doxygen comment.
[blender.git] / source / blender / makesrna / intern / rna_color.c
1 /*
2  * $Id$
3  *
4  * ***** BEGIN GPL LICENSE BLOCK *****
5  *
6  * This program is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU General Public License
8  * as published by the Free Software Foundation; either version 2
9  * of the License, or (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software Foundation,
18  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
19  *
20  * Contributor(s): Blender Foundation (2008).
21  *
22  * ***** END GPL LICENSE BLOCK *****
23  */
24
25 #include <stdlib.h>
26 #include <stdio.h>
27
28 #include "RNA_define.h"
29 #include "rna_internal.h"
30
31 #include "DNA_color_types.h"
32 #include "DNA_texture_types.h"
33
34 #ifdef RNA_RUNTIME
35
36 #include "RNA_access.h"
37
38 #include "DNA_material_types.h"
39 #include "DNA_node_types.h"
40
41 #include "MEM_guardedalloc.h"
42
43 #include "BKE_colortools.h"
44 #include "BKE_depsgraph.h"
45 #include "BKE_node.h"
46 #include "BKE_texture.h"
47
48 #include "WM_api.h"
49 #include "WM_types.h"
50
51 #include "ED_node.h"
52
53 static int rna_CurveMapping_curves_length(PointerRNA *ptr)
54 {
55         CurveMapping *cumap= (CurveMapping*)ptr->data;
56         int len;
57
58         for(len=0; len<CM_TOT; len++)
59                 if(!cumap->cm[len].curve)
60                         break;
61         
62         return len;
63 }
64
65 static void rna_CurveMapping_curves_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
66 {
67         CurveMapping *cumap= (CurveMapping*)ptr->data;
68
69         rna_iterator_array_begin(iter, cumap->cm, sizeof(CurveMap), rna_CurveMapping_curves_length(ptr), 0, NULL);
70 }
71
72 static void rna_CurveMapping_clip_set(PointerRNA *ptr, int value)
73 {
74         CurveMapping *cumap= (CurveMapping*)ptr->data;
75
76         if(value) cumap->flag |= CUMA_DO_CLIP;
77         else cumap->flag &= ~CUMA_DO_CLIP;
78
79         curvemapping_changed(cumap, 0);
80 }
81
82 static void rna_CurveMapping_black_level_set(PointerRNA *ptr, const float *values)
83 {
84         CurveMapping *cumap= (CurveMapping*)ptr->data;
85         cumap->black[0]= values[0];
86         cumap->black[1]= values[1];
87         cumap->black[2]= values[2];
88         curvemapping_set_black_white(cumap, NULL, NULL);
89 }
90
91 static void rna_CurveMapping_white_level_set(PointerRNA *ptr, const float *values)
92 {
93         CurveMapping *cumap= (CurveMapping*)ptr->data;
94         cumap->white[0]= values[0];
95         cumap->white[1]= values[1];
96         cumap->white[2]= values[2];
97         curvemapping_set_black_white(cumap, NULL, NULL);
98 }
99
100 static void rna_CurveMapping_clipminx_range(PointerRNA *ptr, float *min, float *max)
101 {
102         CurveMapping *cumap= (CurveMapping*)ptr->data;
103
104         *min= -100.0f;
105         *max= cumap->clipr.xmax;
106 }
107
108 static void rna_CurveMapping_clipminy_range(PointerRNA *ptr, float *min, float *max)
109 {
110         CurveMapping *cumap= (CurveMapping*)ptr->data;
111
112         *min= -100.0f;
113         *max= cumap->clipr.ymax;
114 }
115
116 static void rna_CurveMapping_clipmaxx_range(PointerRNA *ptr, float *min, float *max)
117 {
118         CurveMapping *cumap= (CurveMapping*)ptr->data;
119
120         *min= cumap->clipr.xmin;
121         *max= 100.0f;
122 }
123
124 static void rna_CurveMapping_clipmaxy_range(PointerRNA *ptr, float *min, float *max)
125 {
126         CurveMapping *cumap= (CurveMapping*)ptr->data;
127
128         *min= cumap->clipr.ymin;
129         *max= 100.0f;
130 }
131
132
133 static char *rna_ColorRamp_path(PointerRNA *ptr)
134 {
135         /* handle the cases where a single datablock may have 2 ramp types */
136         if (ptr->id.data) {
137                 ID *id= ptr->id.data;
138                 
139                 switch (GS(id->name)) {
140                         case ID_MA:     /* material has 2 cases - diffuse and specular */ 
141                         {
142                                 Material *ma= (Material*)id;
143                                 
144                                 if (ptr->data == ma->ramp_col) 
145                                         return BLI_strdup("diffuse_ramp");
146                                 else if (ptr->data == ma->ramp_spec)
147                                         return BLI_strdup("specular_ramp");
148                         }
149                                 break;
150                 }
151         }
152         
153         /* everything else just uses 'color_ramp' */
154         return BLI_strdup("color_ramp");
155 }
156
157 static char *rna_ColorRampElement_path(PointerRNA *ptr)
158 {
159         PointerRNA ramp_ptr;
160         PropertyRNA *prop;
161         char *path = NULL;
162         int index;
163         
164         /* helper macro for use here to try and get the path 
165          *      - this calls the standard code for getting a path to a texture...
166          */
167 #define COLRAMP_GETPATH \
168 { \
169 prop= RNA_struct_find_property(&ramp_ptr, "elements"); \
170 if (prop) { \
171 index= RNA_property_collection_lookup_index(&ramp_ptr, prop, ptr); \
172 if (index >= 0) { \
173 char *texture_path= rna_ColorRamp_path(&ramp_ptr); \
174 path= BLI_sprintfN("%s.elements[%d]", texture_path, index); \
175 MEM_freeN(texture_path); \
176 } \
177 } \
178 }
179         
180         /* determine the path from the ID-block to the ramp */
181         // FIXME: this is a very slow way to do it, but it will have to suffice...
182         if (ptr->id.data) {
183                 ID *id= ptr->id.data;
184                 
185                 switch (GS(id->name)) {
186                         case ID_MA: /* 2 cases for material - diffuse and spec */
187                         {
188                                 Material *ma= (Material *)id;
189                                 
190                                 /* try diffuse first */
191                                 if (ma->ramp_col) {
192                                         RNA_pointer_create(id, &RNA_ColorRamp, ma->ramp_col, &ramp_ptr);
193                                         COLRAMP_GETPATH;
194                                 }
195                                 /* try specular if not diffuse */
196                                 if (!path && ma->ramp_spec) {
197                                         RNA_pointer_create(id, &RNA_ColorRamp, ma->ramp_spec, &ramp_ptr);
198                                         COLRAMP_GETPATH;
199                                 }
200                         }
201                                 break;
202                                 
203                                 // TODO: node trees need special attention
204                         case ID_NT: 
205                         {
206                                 bNodeTree *ntree = (bNodeTree *)id;
207                                 bNode *node;
208                                 
209                                 for(node=ntree->nodes.first; node; node=node->next) {
210                                         if (ELEM3(node->type, SH_NODE_VALTORGB, CMP_NODE_VALTORGB, TEX_NODE_VALTORGB)) {
211                                                 RNA_pointer_create(id, &RNA_ColorRamp, node->storage, &ramp_ptr);
212                                                 COLRAMP_GETPATH;
213                                         }
214                                 }
215                         }
216                                 break;
217                                 
218                         default: /* everything else should have a "color_ramp" property */
219                         {
220                                 /* create pointer to the ID block, and try to resolve "color_ramp" pointer */
221                                 RNA_id_pointer_create(id, &ramp_ptr);
222                                 if (RNA_path_resolve(&ramp_ptr, "color_ramp", &ramp_ptr, &prop)) {
223                                         COLRAMP_GETPATH;
224                                 }
225                         }
226                 }
227         }
228         
229         /* cleanup the macro we defined */
230 #undef COLRAMP_GETPATH
231         
232         return path;
233 }
234
235 static void rna_ColorRamp_update(Main *bmain, Scene *scene, PointerRNA *ptr)
236 {
237         if (ptr->id.data) {
238                 ID *id= ptr->id.data;
239                 
240                 switch (GS(id->name)) {
241                         case ID_MA:
242                         {
243                                 Material *ma= ptr->id.data;
244                                 
245                                 DAG_id_tag_update(&ma->id, 0);
246                                 WM_main_add_notifier(NC_MATERIAL|ND_SHADING_DRAW, ma);
247                         }
248                                 break;
249                         case ID_NT:
250                         {
251                                 bNodeTree *ntree = (bNodeTree *)id;
252                                 bNode *node;
253
254                                 for(node=ntree->nodes.first; node; node=node->next) {
255                                         if (ELEM3(node->type, SH_NODE_VALTORGB, CMP_NODE_VALTORGB, TEX_NODE_VALTORGB)) {
256                                                 ED_node_generic_update(bmain, ntree, node);
257                                         }
258                                 }
259                         }
260                                 break;
261                         case ID_TE:
262                         {
263                                 Tex *tex= ptr->id.data;
264
265                                 DAG_id_tag_update(&tex->id, 0);
266                                 WM_main_add_notifier(NC_TEXTURE, tex);
267                         }
268                                 break;
269                         default:
270                                 break;
271                 }
272         }
273 }
274
275 static void rna_ColorRamp_eval(struct ColorBand *coba, float position, float color[4])
276 {
277         do_colorband(coba, position, color);
278 }
279
280 static CBData *rna_ColorRampElement_new(struct ColorBand *coba, ReportList *reports, float position)
281 {
282         CBData *element= colorband_element_add(coba, position);
283
284         if(element==NULL)
285                 BKE_reportf(reports, RPT_ERROR, "Unable to add element to colorband (limit %d)", MAXCOLORBAND);
286
287         return element;
288 }
289
290 static void rna_ColorRampElement_remove(struct ColorBand *coba, ReportList *reports, CBData *element)
291 {
292         int index = (int)(element - coba->data);
293         if(colorband_element_remove(coba, index) == 0)
294                 BKE_report(reports, RPT_ERROR, "Element not found in element collection or last element");
295
296 }
297
298 static void rna_Scopes_update(Main *bmain, Scene *scene, PointerRNA *ptr)
299 {
300         Scopes *s= (Scopes*)ptr->data;
301         s->ok = 0;
302 }
303
304 #else
305
306 static void rna_def_curvemappoint(BlenderRNA *brna)
307 {
308         StructRNA *srna;
309         PropertyRNA *prop;
310         static EnumPropertyItem prop_handle_type_items[] = {
311                 {0, "AUTO", 0, "Auto Handle", ""},
312                 {CUMA_VECTOR, "VECTOR", 0, "Vector Handle", ""},
313                 {0, NULL, 0, NULL, NULL}
314         };
315
316         srna= RNA_def_struct(brna, "CurveMapPoint", NULL);
317         RNA_def_struct_ui_text(srna, "CurveMapPoint", "Point of a curve used for a curve mapping");
318
319         /* not editable for now, need to have CurveMapping to do curvemapping_changed */
320
321         prop= RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
322         RNA_def_property_float_sdna(prop, NULL, "x");
323         RNA_def_property_array(prop, 2);
324         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
325         RNA_def_property_ui_text(prop, "Location", "X/Y coordinates of the curve point");
326
327         prop= RNA_def_property(srna, "handle_type", PROP_ENUM, PROP_NONE);
328         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
329         RNA_def_property_enum_items(prop, prop_handle_type_items);
330         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
331         RNA_def_property_ui_text(prop, "Handle Type", "Curve interpolation at this point: bezier or vector");
332
333         prop= RNA_def_property(srna, "select", PROP_BOOLEAN, PROP_NONE);
334         RNA_def_property_boolean_sdna(prop, NULL, "flag", CUMA_SELECT);
335         RNA_def_property_ui_text(prop, "Select", "Selection state of the curve point");
336 }
337
338 static void rna_def_curvemap(BlenderRNA *brna)
339 {
340         StructRNA *srna;
341         PropertyRNA *prop;
342         static EnumPropertyItem prop_extend_items[] = {
343                 {0, "HORIZONTAL", 0, "Horizontal", ""},
344                 {CUMA_EXTEND_EXTRAPOLATE, "EXTRAPOLATED", 0, "Extrapolated", ""},
345                 {0, NULL, 0, NULL, NULL}
346         };
347
348         srna= RNA_def_struct(brna, "CurveMap", NULL);
349         RNA_def_struct_ui_text(srna, "CurveMap", "Curve in a curve mapping");
350
351         /* not editable for now, need to have CurveMapping to do curvemapping_changed */
352
353         prop= RNA_def_property(srna, "extend", PROP_ENUM, PROP_NONE);
354         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
355         RNA_def_property_enum_items(prop, prop_extend_items);
356         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
357         RNA_def_property_ui_text(prop, "Extend", "Extrapolate the curve or extend it horizontally");
358
359         prop= RNA_def_property(srna, "points", PROP_COLLECTION, PROP_NONE);
360         RNA_def_property_collection_sdna(prop, NULL, "curve", "totpoint");
361         RNA_def_property_struct_type(prop, "CurveMapPoint");
362         RNA_def_property_ui_text(prop, "Points", "");
363 }
364
365 static void rna_def_curvemapping(BlenderRNA *brna)
366 {
367         StructRNA *srna;
368         PropertyRNA *prop;
369
370         srna= RNA_def_struct(brna, "CurveMapping", NULL);
371         RNA_def_struct_ui_text(srna, "CurveMapping", "Curve mapping to map color, vector and scalar values to other values using a user defined curve");
372         
373         prop= RNA_def_property(srna, "use_clip", PROP_BOOLEAN, PROP_NONE);
374         RNA_def_property_boolean_sdna(prop, NULL, "flag", CUMA_DO_CLIP);
375         RNA_def_property_ui_text(prop, "Clip", "Force the curve view to fit a defined boundary");
376         RNA_def_property_boolean_funcs(prop, NULL, "rna_CurveMapping_clip_set");
377
378         prop= RNA_def_property(srna, "clip_min_x", PROP_FLOAT, PROP_NONE);
379         RNA_def_property_float_sdna(prop, NULL, "clipr.xmin");
380         RNA_def_property_range(prop, -100.0f, 100.0f);
381         RNA_def_property_ui_text(prop, "Clip Min X", "");
382         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipminx_range");
383
384         prop= RNA_def_property(srna, "clip_min_y", PROP_FLOAT, PROP_NONE);
385         RNA_def_property_float_sdna(prop, NULL, "clipr.ymin");
386         RNA_def_property_range(prop, -100.0f, 100.0f);
387         RNA_def_property_ui_text(prop, "Clip Min Y", "");
388         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipminy_range");
389
390         prop= RNA_def_property(srna, "clip_max_x", PROP_FLOAT, PROP_NONE);
391         RNA_def_property_float_sdna(prop, NULL, "clipr.xmax");
392         RNA_def_property_range(prop, -100.0f, 100.0f);
393         RNA_def_property_ui_text(prop, "Clip Max X", "");
394         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipmaxx_range");
395
396         prop= RNA_def_property(srna, "clip_max_y", PROP_FLOAT, PROP_NONE);
397         RNA_def_property_float_sdna(prop, NULL, "clipr.ymax");
398         RNA_def_property_range(prop, -100.0f, 100.0f);
399         RNA_def_property_ui_text(prop, "Clip Max Y", "");
400         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipmaxy_range");
401
402         prop= RNA_def_property(srna, "curves", PROP_COLLECTION, PROP_NONE);
403         RNA_def_property_collection_funcs(prop, "rna_CurveMapping_curves_begin", "rna_iterator_array_next", "rna_iterator_array_end", "rna_iterator_array_get", "rna_CurveMapping_curves_length", 0, 0);
404         RNA_def_property_struct_type(prop, "CurveMap");
405         RNA_def_property_ui_text(prop, "Curves", "");
406
407         prop= RNA_def_property(srna, "black_level", PROP_FLOAT, PROP_COLOR);
408         RNA_def_property_float_sdna(prop, NULL, "black");
409         RNA_def_property_range(prop, -1000.0f, 1000.0f);
410         RNA_def_property_ui_text(prop, "Black Level", "For RGB curves, the color that black is mapped to");
411         RNA_def_property_float_funcs(prop, NULL, "rna_CurveMapping_black_level_set", NULL);
412
413         prop= RNA_def_property(srna, "white_level", PROP_FLOAT, PROP_COLOR);
414         RNA_def_property_float_sdna(prop, NULL, "white");
415         RNA_def_property_range(prop, -1000.0f, 1000.0f);
416         RNA_def_property_ui_text(prop, "White Level", "For RGB curves, the color that white is mapped to");
417         RNA_def_property_float_funcs(prop, NULL, "rna_CurveMapping_white_level_set", NULL);
418 }
419
420 static void rna_def_color_ramp_element(BlenderRNA *brna)
421 {
422         StructRNA *srna;
423         PropertyRNA *prop;
424
425         srna= RNA_def_struct(brna, "ColorRampElement", NULL);
426         RNA_def_struct_sdna(srna, "CBData");
427         RNA_def_struct_path_func(srna, "rna_ColorRampElement_path");
428         RNA_def_struct_ui_text(srna, "Color Ramp Element", "Element defining a color at a position in the color ramp");
429         
430         prop= RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
431         RNA_def_property_float_sdna(prop, NULL, "r");
432         RNA_def_property_array(prop, 4);
433         RNA_def_property_ui_text(prop, "Color", "");
434         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
435         
436         prop= RNA_def_property(srna, "position", PROP_FLOAT, PROP_NONE);
437         RNA_def_property_float_sdna(prop, NULL, "pos");
438         RNA_def_property_range(prop, 0, 1);
439         RNA_def_property_ui_text(prop, "Position", "");
440         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
441 }
442
443 static void rna_def_color_ramp_element_api(BlenderRNA *brna, PropertyRNA *cprop)
444 {
445         StructRNA *srna;
446         PropertyRNA *parm;
447         FunctionRNA *func;
448
449         RNA_def_property_srna(cprop, "ColorRampElements");
450         srna= RNA_def_struct(brna, "ColorRampElements", NULL);
451         RNA_def_struct_sdna(srna, "ColorBand");
452         RNA_def_struct_path_func(srna, "rna_ColorRampElement_path");
453         RNA_def_struct_ui_text(srna, "Color Ramp Elements", "Collection of Color Ramp Elements");
454
455         /* TODO, make these functions generic in texture.c */
456         func = RNA_def_function(srna, "new", "rna_ColorRampElement_new");
457         RNA_def_function_ui_description(func, "Add element to ColorRamp");
458         RNA_def_function_flag(func, FUNC_USE_REPORTS);
459         parm= RNA_def_float(func, "position", 0.0f, 0.0f, 1.0f, "Position", "Position to add element", 0.0f, 1.0f);
460         RNA_def_property_flag(parm, PROP_REQUIRED);
461         /* return type */
462         parm= RNA_def_pointer(func, "element", "ColorRampElement", "", "New element.");
463         RNA_def_function_return(func, parm);
464
465         func = RNA_def_function(srna, "remove", "rna_ColorRampElement_remove");
466         RNA_def_function_ui_description(func, "Delete element from ColorRamp");
467         RNA_def_function_flag(func, FUNC_USE_REPORTS);
468         parm= RNA_def_pointer(func, "element", "ColorRampElement", "", "Element to remove.");
469         RNA_def_property_flag(parm, PROP_REQUIRED|PROP_NEVER_NULL);
470 }
471
472 static void rna_def_color_ramp(BlenderRNA *brna)
473 {
474         StructRNA *srna;
475         PropertyRNA *prop;
476         FunctionRNA *func;
477
478         static EnumPropertyItem prop_interpolation_items[] = {
479                 {1, "EASE", 0, "Ease", ""},
480                 {3, "CARDINAL", 0, "Cardinal", ""},
481                 {0, "LINEAR", 0, "Linear", ""},
482                 {2, "B_SPLINE", 0, "B-Spline", ""},
483                 {4, "CONSTANT", 0, "Constant", ""},
484                 {0, NULL, 0, NULL, NULL}};
485         
486         srna= RNA_def_struct(brna, "ColorRamp", NULL);
487         RNA_def_struct_sdna(srna, "ColorBand");
488         RNA_def_struct_path_func(srna, "rna_ColorRamp_path");
489         RNA_def_struct_ui_text(srna, "Color Ramp", "Color ramp mapping a scalar value to a color");
490         
491         prop= RNA_def_property(srna, "elements", PROP_COLLECTION, PROP_COLOR);
492         RNA_def_property_collection_sdna(prop, NULL, "data", "tot");
493         RNA_def_property_struct_type(prop, "ColorRampElement");
494         RNA_def_property_ui_text(prop, "Elements", "");
495         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
496         rna_def_color_ramp_element_api(brna, prop);
497
498         prop= RNA_def_property(srna, "interpolation", PROP_ENUM, PROP_NONE);
499         RNA_def_property_enum_sdna(prop, NULL, "ipotype");
500         RNA_def_property_enum_items(prop, prop_interpolation_items);
501         RNA_def_property_ui_text(prop, "Interpolation", "");
502         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
503
504 #if 0 // use len(elements)
505         prop= RNA_def_property(srna, "total", PROP_INT, PROP_NONE);
506         RNA_def_property_int_sdna(prop, NULL, "tot");
507         /* needs a function to do the right thing when adding elements like colorband_add_cb() */
508         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
509         RNA_def_property_range(prop, 0, 31); /* MAXCOLORBAND = 32 */
510         RNA_def_property_ui_text(prop, "Total", "Total number of elements");
511         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
512 #endif
513         
514         func = RNA_def_function(srna, "evaluate", "rna_ColorRamp_eval");
515         RNA_def_function_ui_description(func, "Evaluate ColorRamp");
516         prop= RNA_def_float(func, "position", 1.0f, 0.0f, 1.0f, "Position", "Evaluate ColorRamp at position", 0.0f, 1.0f);
517         RNA_def_property_flag(prop, PROP_REQUIRED);
518         /* return */
519         prop = RNA_def_float_color(func, "color", 4, NULL, -FLT_MAX, FLT_MAX, "Color", "Color at given position", -FLT_MAX, FLT_MAX);
520         RNA_def_property_flag(prop, PROP_THICK_WRAP);
521         RNA_def_function_output(func, prop);
522 }
523
524 static void rna_def_histogram(BlenderRNA *brna)
525 {
526         StructRNA *srna;
527         PropertyRNA *prop;
528         
529         static EnumPropertyItem prop_mode_items[] = {
530                 {HISTO_MODE_LUMA, "LUMA", ICON_COLOR, "Luma", ""},
531                 {HISTO_MODE_RGB, "RGB", ICON_COLOR, "Red Green Blue", ""},
532                 {HISTO_MODE_R, "R", ICON_COLOR, "Red", ""},
533                 {HISTO_MODE_G, "G", ICON_COLOR, "Green", ""},
534                 {HISTO_MODE_B, "B", ICON_COLOR, "Blue", ""},
535                 {0, NULL, 0, NULL, NULL}};
536                 
537         srna= RNA_def_struct(brna, "Histogram", NULL);
538         RNA_def_struct_ui_text(srna, "Histogram", "Statistical view of the levels of color in an image");
539         
540         prop= RNA_def_property(srna, "mode", PROP_ENUM, PROP_NONE);
541         RNA_def_property_enum_sdna(prop, NULL, "mode");
542         RNA_def_property_enum_items(prop, prop_mode_items);
543         RNA_def_property_ui_text(prop, "Mode", "Channels to display when drawing the histogram");
544         
545 }
546
547 static void rna_def_scopes(BlenderRNA *brna)
548 {
549         StructRNA *srna;
550         PropertyRNA *prop;
551
552         static EnumPropertyItem prop_wavefrm_mode_items[] = {
553                 {SCOPES_WAVEFRM_LUMA, "LUMA", ICON_COLOR, "Luma", ""},
554                 {SCOPES_WAVEFRM_RGB, "RGB", ICON_COLOR, "Red Green Blue", ""},
555                 {SCOPES_WAVEFRM_YCC_601, "YCBCR601", ICON_COLOR, "YCbCr (ITU 601)", ""},
556                 {SCOPES_WAVEFRM_YCC_709, "YCBCR709", ICON_COLOR, "YCbCr (ITU 709)", ""},
557                 {SCOPES_WAVEFRM_YCC_JPEG, "YCBCRJPG", ICON_COLOR, "YCbCr (Jpeg)", ""},
558                 {0, NULL, 0, NULL, NULL}};
559
560         srna= RNA_def_struct(brna, "Scopes", NULL);
561         RNA_def_struct_ui_text(srna, "Scopes", "Scopes for statistical view of an image");
562         
563         prop= RNA_def_property(srna, "use_full_resolution", PROP_BOOLEAN, PROP_NONE);
564         RNA_def_property_boolean_sdna(prop, "Scopes", "sample_full", 1);
565         RNA_def_property_ui_text(prop, "Full Sample", "Sample every pixel of the image");
566         RNA_def_property_update(prop, 0, "rna_Scopes_update");
567         
568         prop= RNA_def_property(srna, "accuracy", PROP_FLOAT, PROP_PERCENTAGE);
569         RNA_def_property_float_sdna(prop, "Scopes", "accuracy");
570         RNA_def_property_range(prop, 0.0, 100.0);
571         RNA_def_property_ui_range(prop, 0.0, 100.0, 10, 1);
572         RNA_def_property_ui_text(prop, "Accuracy", "Proportion of original image source pixel lines to sample");
573         RNA_def_property_update(prop, 0, "rna_Scopes_update");
574
575         prop= RNA_def_property(srna, "histogram", PROP_POINTER, PROP_NONE);
576         RNA_def_property_pointer_sdna(prop, "Scopes", "hist");
577         RNA_def_property_struct_type(prop, "Histogram");
578         RNA_def_property_ui_text(prop, "Histogram", "Histogram for viewing image statistics");
579
580         prop= RNA_def_property(srna, "waveform_mode", PROP_ENUM, PROP_NONE);
581         RNA_def_property_enum_sdna(prop, "Scopes", "wavefrm_mode");
582         RNA_def_property_enum_items(prop, prop_wavefrm_mode_items);
583         RNA_def_property_ui_text(prop, "Waveform Mode", "");
584         RNA_def_property_update(prop, 0, "rna_Scopes_update");
585
586         prop= RNA_def_property(srna, "waveform_alpha", PROP_FLOAT, PROP_PERCENTAGE);
587         RNA_def_property_float_sdna(prop, "Scopes", "wavefrm_alpha");
588         RNA_def_property_range(prop, 0, 1);
589         RNA_def_property_ui_text(prop, "Waveform Opacity", "Opacity of the points");
590
591         prop= RNA_def_property(srna, "vectorscope_alpha", PROP_FLOAT, PROP_PERCENTAGE);
592         RNA_def_property_float_sdna(prop, "Scopes", "vecscope_alpha");
593         RNA_def_property_range(prop, 0, 1);
594         RNA_def_property_ui_text(prop, "Vectorscope Opacity", "Opacity of the points");
595 }
596
597
598 void RNA_def_color(BlenderRNA *brna)
599 {
600         rna_def_curvemappoint(brna);
601         rna_def_curvemap(brna);
602         rna_def_curvemapping(brna);
603         rna_def_color_ramp_element(brna);
604         rna_def_color_ramp(brna);
605         rna_def_histogram(brna);
606         rna_def_scopes(brna);
607 }
608
609 #endif
610