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