svn merge ^/trunk/blender -r50080:50089
[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 #include "WM_api.h"
38 #include "WM_types.h"
39
40 static EnumPropertyItem view_transform_items[] = {
41         {0, "NONE", 0, "None", "Do not perform any color transform on display, use old non-color managed technique for display"},
42         {0, NULL, 0, NULL, NULL}
43 };
44
45 static EnumPropertyItem color_space_items[] = {
46         {0, "NONE", 0, "None", "Do not perform any color transform on load, treat colors as in scene linear space already"},
47         {0, NULL, 0, NULL, NULL}
48 };
49
50 #ifdef RNA_RUNTIME
51
52 #include "RNA_access.h"
53
54 #include "DNA_image_types.h"
55 #include "DNA_material_types.h"
56 #include "DNA_movieclip_types.h"
57 #include "DNA_node_types.h"
58
59 #include "MEM_guardedalloc.h"
60
61 #include "BKE_colortools.h"
62 #include "BKE_depsgraph.h"
63 #include "BKE_image.h"
64 #include "BKE_movieclip.h"
65 #include "BKE_node.h"
66 #include "BKE_texture.h"
67
68 #include "ED_node.h"
69
70 #include "IMB_colormanagement.h"
71
72 static int rna_CurveMapping_curves_length(PointerRNA *ptr)
73 {
74         CurveMapping *cumap = (CurveMapping *)ptr->data;
75         int len;
76
77         for (len = 0; len < CM_TOT; len++)
78                 if (!cumap->cm[len].curve)
79                         break;
80         
81         return len;
82 }
83
84 static void rna_CurveMapping_curves_begin(CollectionPropertyIterator *iter, PointerRNA *ptr)
85 {
86         CurveMapping *cumap = (CurveMapping *)ptr->data;
87
88         rna_iterator_array_begin(iter, cumap->cm, sizeof(CurveMap), rna_CurveMapping_curves_length(ptr), 0, NULL);
89 }
90
91 static void rna_CurveMapping_clip_set(PointerRNA *ptr, int value)
92 {
93         CurveMapping *cumap = (CurveMapping *)ptr->data;
94
95         if (value) cumap->flag |= CUMA_DO_CLIP;
96         else cumap->flag &= ~CUMA_DO_CLIP;
97
98         curvemapping_changed(cumap, FALSE);
99 }
100
101 static void rna_CurveMapping_black_level_set(PointerRNA *ptr, const float *values)
102 {
103         CurveMapping *cumap = (CurveMapping *)ptr->data;
104         cumap->black[0] = values[0];
105         cumap->black[1] = values[1];
106         cumap->black[2] = values[2];
107         curvemapping_set_black_white(cumap, NULL, NULL);
108 }
109
110 static void rna_CurveMapping_white_level_set(PointerRNA *ptr, const float *values)
111 {
112         CurveMapping *cumap = (CurveMapping *)ptr->data;
113         cumap->white[0] = values[0];
114         cumap->white[1] = values[1];
115         cumap->white[2] = values[2];
116         curvemapping_set_black_white(cumap, NULL, NULL);
117 }
118
119 static void rna_CurveMapping_clipminx_range(PointerRNA *ptr, float *min, float *max, float *softmin, float *softmax)
120 {
121         CurveMapping *cumap = (CurveMapping *)ptr->data;
122
123         *min = -100.0f;
124         *max = cumap->clipr.xmax;
125 }
126
127 static void rna_CurveMapping_clipminy_range(PointerRNA *ptr, float *min, float *max, float *softmin, float *softmax)
128 {
129         CurveMapping *cumap = (CurveMapping *)ptr->data;
130
131         *min = -100.0f;
132         *max = cumap->clipr.ymax;
133 }
134
135 static void rna_CurveMapping_clipmaxx_range(PointerRNA *ptr, float *min, float *max, float *softmin, float *softmax)
136 {
137         CurveMapping *cumap = (CurveMapping *)ptr->data;
138
139         *min = cumap->clipr.xmin;
140         *max = 100.0f;
141 }
142
143 static void rna_CurveMapping_clipmaxy_range(PointerRNA *ptr, float *min, float *max, float *softmin, float *softmax)
144 {
145         CurveMapping *cumap = (CurveMapping *)ptr->data;
146
147         *min = cumap->clipr.ymin;
148         *max = 100.0f;
149 }
150
151
152 static char *rna_ColorRamp_path(PointerRNA *ptr)
153 {
154         char *path = NULL;
155         
156         /* handle the cases where a single datablock may have 2 ramp types */
157         if (ptr->id.data) {
158                 ID *id = ptr->id.data;
159                 
160                 switch (GS(id->name)) {
161                         case ID_MA: /* material has 2 cases - diffuse and specular */
162                         {
163                                 Material *ma = (Material *)id;
164                                 
165                                 if (ptr->data == ma->ramp_col)
166                                         path = BLI_strdup("diffuse_ramp");
167                                 else if (ptr->data == ma->ramp_spec)
168                                         path = BLI_strdup("specular_ramp");
169                                 break;
170                         }
171                         
172                         case ID_NT:
173                         {
174                                 bNodeTree *ntree = (bNodeTree *)id;
175                                 bNode *node;
176                                 PointerRNA node_ptr;
177                                 char *node_path;
178                                 
179                                 for (node = ntree->nodes.first; node; node = node->next) {
180                                         if (ELEM3(node->type, SH_NODE_VALTORGB, CMP_NODE_VALTORGB, TEX_NODE_VALTORGB)) {
181                                                 if (node->storage == ptr->data) {
182                                                         /* all node color ramp properties called 'color_ramp'
183                                                          * prepend path from ID to the node
184                                                          */
185                                                         RNA_pointer_create(id, &RNA_Node, node, &node_ptr);
186                                                         node_path = RNA_path_from_ID_to_struct(&node_ptr);
187                                                         path = BLI_sprintfN("%s.color_ramp", node_path);
188                                                         MEM_freeN(node_path);
189                                                 }
190                                         }
191                                 }
192                                 break;
193                         }
194                         
195                         default:
196                                 /* everything else just uses 'color_ramp' */
197                                 path = BLI_strdup("color_ramp");
198                                 break;
199                 }
200         }
201         else {
202                 /* everything else just uses 'color_ramp' */
203                 path = BLI_strdup("color_ramp");
204         }
205         
206         return path;
207 }
208
209 static char *rna_ColorRampElement_path(PointerRNA *ptr)
210 {
211         PointerRNA ramp_ptr;
212         PropertyRNA *prop;
213         char *path = NULL;
214         int index;
215         
216         /* helper macro for use here to try and get the path
217          *      - this calls the standard code for getting a path to a texture...
218          */
219
220 #define COLRAMP_GETPATH                                                       \
221 {                                                                             \
222         prop = RNA_struct_find_property(&ramp_ptr, "elements");                   \
223         if (prop) {                                                               \
224                 index = RNA_property_collection_lookup_index(&ramp_ptr, prop, ptr);   \
225                 if (index >= 0) {                                                     \
226                         char *texture_path = rna_ColorRamp_path(&ramp_ptr);               \
227                         path = BLI_sprintfN("%s.elements[%d]", texture_path, index);      \
228                         MEM_freeN(texture_path);                                          \
229                 }                                                                     \
230         }                                                                         \
231 } (void)0
232
233         /* determine the path from the ID-block to the ramp */
234         /* FIXME: this is a very slow way to do it, but it will have to suffice... */
235         if (ptr->id.data) {
236                 ID *id = ptr->id.data;
237                 
238                 switch (GS(id->name)) {
239                         case ID_MA: /* 2 cases for material - diffuse and spec */
240                         {
241                                 Material *ma = (Material *)id;
242                                 
243                                 /* try diffuse first */
244                                 if (ma->ramp_col) {
245                                         RNA_pointer_create(id, &RNA_ColorRamp, ma->ramp_col, &ramp_ptr);
246                                         COLRAMP_GETPATH;
247                                 }
248                                 /* try specular if not diffuse */
249                                 if (!path && ma->ramp_spec) {
250                                         RNA_pointer_create(id, &RNA_ColorRamp, ma->ramp_spec, &ramp_ptr);
251                                         COLRAMP_GETPATH;
252                                 }
253                         }
254                         break;
255                                 
256                         case ID_NT:
257                         {
258                                 bNodeTree *ntree = (bNodeTree *)id;
259                                 bNode *node;
260                                 
261                                 for (node = ntree->nodes.first; node; node = node->next) {
262                                         if (ELEM3(node->type, SH_NODE_VALTORGB, CMP_NODE_VALTORGB, TEX_NODE_VALTORGB)) {
263                                                 RNA_pointer_create(id, &RNA_ColorRamp, node->storage, &ramp_ptr);
264                                                 COLRAMP_GETPATH;
265                                         }
266                                 }
267                         }
268                         break;
269                                 
270                         default: /* everything else should have a "color_ramp" property */
271                         {
272                                 /* create pointer to the ID block, and try to resolve "color_ramp" pointer */
273                                 RNA_id_pointer_create(id, &ramp_ptr);
274                                 if (RNA_path_resolve(&ramp_ptr, "color_ramp", &ramp_ptr, &prop)) {
275                                         COLRAMP_GETPATH;
276                                 }
277                         }
278                 }
279         }
280         
281         /* cleanup the macro we defined */
282 #undef COLRAMP_GETPATH
283         
284         return path;
285 }
286
287 static void rna_ColorRamp_update(Main *bmain, Scene *UNUSED(scene), PointerRNA *ptr)
288 {
289         if (ptr->id.data) {
290                 ID *id = ptr->id.data;
291                 
292                 switch (GS(id->name)) {
293                         case ID_MA:
294                         {
295                                 Material *ma = ptr->id.data;
296                                 
297                                 DAG_id_tag_update(&ma->id, 0);
298                                 WM_main_add_notifier(NC_MATERIAL | ND_SHADING_DRAW, ma);
299                         }
300                         break;
301                         case ID_NT:
302                         {
303                                 bNodeTree *ntree = (bNodeTree *)id;
304                                 bNode *node;
305
306                                 for (node = ntree->nodes.first; node; node = node->next) {
307                                         if (ELEM3(node->type, SH_NODE_VALTORGB, CMP_NODE_VALTORGB, TEX_NODE_VALTORGB)) {
308                                                 ED_node_generic_update(bmain, ntree, node);
309                                         }
310                                 }
311                         }
312                         break;
313                         case ID_TE:
314                         {
315                                 Tex *tex = ptr->id.data;
316
317                                 DAG_id_tag_update(&tex->id, 0);
318                                 WM_main_add_notifier(NC_TEXTURE, tex);
319                         }
320                         break;
321                         default:
322                                 break;
323                 }
324         }
325 }
326
327 void rna_ColorRamp_eval(struct ColorBand *coba, float position, float color[4])
328 {
329         do_colorband(coba, position, color);
330 }
331
332 static CBData *rna_ColorRampElement_new(struct ColorBand *coba, ReportList *reports, float position)
333 {
334         CBData *element = colorband_element_add(coba, position);
335
336         if (element == NULL)
337                 BKE_reportf(reports, RPT_ERROR, "Unable to add element to colorband (limit %d)", MAXCOLORBAND);
338
339         return element;
340 }
341
342 static void rna_ColorRampElement_remove(struct ColorBand *coba, ReportList *reports, CBData *element)
343 {
344         int index = (int)(element - coba->data);
345         if (colorband_element_remove(coba, index) == 0)
346                 BKE_report(reports, RPT_ERROR, "Element not found in element collection or last element");
347
348 }
349
350 static void rna_Scopes_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
351 {
352         Scopes *s = (Scopes *)ptr->data;
353         s->ok = 0;
354 }
355
356 static int rna_ColorManagedDisplaySettings_display_device_get(struct PointerRNA *ptr)
357 {
358         ColorManagedDisplaySettings *display = (ColorManagedDisplaySettings *) ptr->data;
359
360         return IMB_colormanagement_display_get_named_index(display->display_device);
361 }
362
363 static void rna_ColorManagedDisplaySettings_display_device_set(struct PointerRNA *ptr, int value)
364 {
365         ColorManagedDisplaySettings *display = (ColorManagedDisplaySettings *) ptr->data;
366         const char *name = IMB_colormanagement_display_get_indexed_name(value);
367
368         if (name) {
369                 BLI_strncpy(display->display_device, name, sizeof(display->display_device));
370         }
371 }
372
373 static EnumPropertyItem *rna_ColorManagedDisplaySettings_display_device_itemf(bContext *C, PointerRNA *ptr, PropertyRNA *UNUSED(prop), int *free)
374 {
375         EnumPropertyItem *items = NULL;
376         int totitem = 0;
377
378         IMB_colormanagement_display_items_add(&items, &totitem);
379         RNA_enum_item_end(&items, &totitem);
380
381         *free = TRUE;
382
383         return items;
384 }
385
386 static int rna_ColorManagedViewSettings_view_transform_get(PointerRNA *ptr)
387 {
388         ColorManagedViewSettings *view = (ColorManagedViewSettings *) ptr->data;
389
390         return IMB_colormanagement_view_get_named_index(view->view_transform);
391 }
392
393 static void rna_ColorManagedViewSettings_view_transform_set(PointerRNA *ptr, int value)
394 {
395         ColorManagedViewSettings *view = (ColorManagedViewSettings *) ptr->data;
396
397         const char *name = IMB_colormanagement_view_get_indexed_name(value);
398
399         if (name) {
400                 BLI_strncpy(view->view_transform, name, sizeof(view->view_transform));
401         }
402 }
403
404 static EnumPropertyItem* rna_ColorManagedViewSettings_view_transform_itemf(bContext *C, PointerRNA *ptr, PropertyRNA *UNUSED(prop), int *free)
405 {
406         wmWindow *win = CTX_wm_window(C);
407         EnumPropertyItem *items = NULL;
408         ColorManagedDisplaySettings *display_settings = &win->display_settings;
409         int totitem = 0;
410
411         RNA_enum_item_add(&items, &totitem, &view_transform_items[0]);
412         IMB_colormanagement_view_items_add(&items, &totitem, display_settings->display_device);
413         RNA_enum_item_end(&items, &totitem);
414
415         *free = TRUE;
416         return items;
417 }
418
419 static int rna_ColorManagedColorspaceSettings_colorspace_get(struct PointerRNA *ptr)
420 {
421         ColorManagedColorspaceSettings *colorspace = (ColorManagedColorspaceSettings *) ptr->data;
422
423         return IMB_colormanagement_colorspace_get_named_index(colorspace->name);
424 }
425
426 static void rna_ColorManagedColorspaceSettings_colorspace_set(struct PointerRNA *ptr, int value)
427 {
428         ColorManagedColorspaceSettings *colorspace = (ColorManagedColorspaceSettings *) ptr->data;
429         const char *name = IMB_colormanagement_colorspace_get_indexed_name(value);
430
431         if (name) {
432                 BLI_strncpy(colorspace->name, name, sizeof(colorspace->name));
433         }
434 }
435
436 static EnumPropertyItem *rna_ColorManagedColorspaceSettings_colorspace_itemf(bContext *C, PointerRNA *ptr, PropertyRNA *UNUSED(prop), int *free)
437 {
438         EnumPropertyItem *items = NULL;
439         int totitem = 0;
440
441         RNA_enum_item_add(&items, &totitem, &color_space_items[0]);
442         IMB_colormanagement_colorspace_items_add(&items, &totitem);
443         RNA_enum_item_end(&items, &totitem);
444
445         *free = TRUE;
446
447         return items;
448 }
449
450 static void rna_ColorManagedColorspaceSettings_reload_update(Main *UNUSED(bmain), Scene *UNUSED(scene), PointerRNA *ptr)
451 {
452         ID *id = ptr->id.data;
453
454         if (GS(id->name) == ID_IM) {
455                 Image *ima = (Image *) id;
456
457                 BKE_image_signal(ima, NULL, IMA_SIGNAL_RELOAD);
458                 WM_main_add_notifier(NC_IMAGE | ND_DISPLAY, &ima->id);
459         }
460         else if (GS(id->name) == ID_MC) {
461                 MovieClip *clip = (MovieClip *) id;
462
463                 BKE_movieclip_reload(clip);
464                 WM_main_add_notifier(NC_MOVIECLIP | ND_DISPLAY, &clip->id);
465         }
466 }
467
468 /* this function only exists because #curvemap_evaluateF uses a 'const' qualifier */
469 float rna_CurveMap_evaluateF(struct CurveMap *cuma, float value)
470 {
471         return curvemap_evaluateF(cuma, value);
472 }
473
474 #else
475
476 static void rna_def_curvemappoint(BlenderRNA *brna)
477 {
478         StructRNA *srna;
479         PropertyRNA *prop;
480         static EnumPropertyItem prop_handle_type_items[] = {
481                 {0, "AUTO", 0, "Auto Handle", ""},
482                 {CUMA_VECTOR, "VECTOR", 0, "Vector Handle", ""},
483                 {0, NULL, 0, NULL, NULL}
484         };
485
486         srna = RNA_def_struct(brna, "CurveMapPoint", NULL);
487         RNA_def_struct_ui_text(srna, "CurveMapPoint", "Point of a curve used for a curve mapping");
488
489         prop = RNA_def_property(srna, "location", PROP_FLOAT, PROP_XYZ);
490         RNA_def_property_float_sdna(prop, NULL, "x");
491         RNA_def_property_array(prop, 2);
492         RNA_def_property_ui_text(prop, "Location", "X/Y coordinates of the curve point");
493
494         prop = RNA_def_property(srna, "handle_type", PROP_ENUM, PROP_NONE);
495         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
496         RNA_def_property_enum_items(prop, prop_handle_type_items);
497         RNA_def_property_ui_text(prop, "Handle Type", "Curve interpolation at this point: Bezier or vector");
498
499         prop = RNA_def_property(srna, "select", PROP_BOOLEAN, PROP_NONE);
500         RNA_def_property_boolean_sdna(prop, NULL, "flag", CUMA_SELECT);
501         RNA_def_property_ui_text(prop, "Select", "Selection state of the curve point");
502 }
503
504 static void rna_def_curvemap_points_api(BlenderRNA *brna, PropertyRNA *cprop)
505 {
506         StructRNA *srna;
507         PropertyRNA *parm;
508         FunctionRNA *func;
509
510         RNA_def_property_srna(cprop, "CurveMapPoints");
511         srna = RNA_def_struct(brna, "CurveMapPoints", NULL);
512         RNA_def_struct_sdna(srna, "CurveMap");
513         RNA_def_struct_ui_text(srna, "Curve Map Point", "Collection of Curve Map Points");
514
515         func = RNA_def_function(srna, "new", "curvemap_insert");
516         RNA_def_function_ui_description(func, "Add point to CurveMap");
517         parm = RNA_def_float(func, "position", 0.0f, -FLT_MAX, FLT_MAX, "Position", "Position to add point", -FLT_MAX, FLT_MAX);
518         RNA_def_property_flag(parm, PROP_REQUIRED);
519         parm = RNA_def_float(func, "value", 0.0f, -FLT_MAX, FLT_MAX, "Value", "Value of point", -FLT_MAX, FLT_MAX);
520         RNA_def_property_flag(parm, PROP_REQUIRED);
521         parm = RNA_def_pointer(func, "point", "CurveMapPoint", "", "New point");
522         RNA_def_function_return(func, parm);
523
524         func = RNA_def_function(srna, "remove", "curvemap_remove_point");
525         RNA_def_function_ui_description(func, "Delete point from CurveMap");
526         parm = RNA_def_pointer(func, "point", "CurveMapPoint", "", "PointElement to remove");
527         RNA_def_property_flag(parm, PROP_REQUIRED | PROP_NEVER_NULL);
528 }
529
530 static void rna_def_curvemap(BlenderRNA *brna)
531 {
532         StructRNA *srna;
533         PropertyRNA *prop, *parm;
534         FunctionRNA *func;
535
536         static EnumPropertyItem prop_extend_items[] = {
537                 {0, "HORIZONTAL", 0, "Horizontal", ""},
538                 {CUMA_EXTEND_EXTRAPOLATE, "EXTRAPOLATED", 0, "Extrapolated", ""},
539                 {0, NULL, 0, NULL, NULL}
540         };
541
542         srna = RNA_def_struct(brna, "CurveMap", NULL);
543         RNA_def_struct_ui_text(srna, "CurveMap", "Curve in a curve mapping");
544
545         prop = RNA_def_property(srna, "extend", PROP_ENUM, PROP_NONE);
546         RNA_def_property_enum_bitflag_sdna(prop, NULL, "flag");
547         RNA_def_property_enum_items(prop, prop_extend_items);
548         RNA_def_property_ui_text(prop, "Extend", "Extrapolate the curve or extend it horizontally");
549
550         prop = RNA_def_property(srna, "points", PROP_COLLECTION, PROP_NONE);
551         RNA_def_property_collection_sdna(prop, NULL, "curve", "totpoint");
552         RNA_def_property_struct_type(prop, "CurveMapPoint");
553         RNA_def_property_ui_text(prop, "Points", "");
554         rna_def_curvemap_points_api(brna, prop);
555
556         func = RNA_def_function(srna, "evaluate", "rna_CurveMap_evaluateF");
557         RNA_def_function_ui_description(func, "Evaluate curve at given location");
558         parm = RNA_def_float(func, "position", 0.0f, -FLT_MAX, FLT_MAX, "Position", "Position to evaluate curve at", -FLT_MAX, FLT_MAX);
559         RNA_def_property_flag(parm, PROP_REQUIRED);
560         parm = RNA_def_float(func, "value", 0.0f, -FLT_MAX, FLT_MAX, "Value", "Value of curve at given location", -FLT_MAX, FLT_MAX);
561         RNA_def_function_return(func, parm);
562 }
563
564 static void rna_def_curvemapping(BlenderRNA *brna)
565 {
566         StructRNA *srna;
567         PropertyRNA *prop;
568         FunctionRNA *func;
569
570         srna = RNA_def_struct(brna, "CurveMapping", NULL);
571         RNA_def_struct_ui_text(srna, "CurveMapping",
572                                "Curve mapping to map color, vector and scalar values to other values using "
573                                "a user defined curve");
574         
575         prop = RNA_def_property(srna, "use_clip", PROP_BOOLEAN, PROP_NONE);
576         RNA_def_property_boolean_sdna(prop, NULL, "flag", CUMA_DO_CLIP);
577         RNA_def_property_ui_text(prop, "Clip", "Force the curve view to fit a defined boundary");
578         RNA_def_property_boolean_funcs(prop, NULL, "rna_CurveMapping_clip_set");
579
580         prop = RNA_def_property(srna, "clip_min_x", PROP_FLOAT, PROP_NONE);
581         RNA_def_property_float_sdna(prop, NULL, "clipr.xmin");
582         RNA_def_property_range(prop, -100.0f, 100.0f);
583         RNA_def_property_ui_text(prop, "Clip Min X", "");
584         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipminx_range");
585
586         prop = RNA_def_property(srna, "clip_min_y", PROP_FLOAT, PROP_NONE);
587         RNA_def_property_float_sdna(prop, NULL, "clipr.ymin");
588         RNA_def_property_range(prop, -100.0f, 100.0f);
589         RNA_def_property_ui_text(prop, "Clip Min Y", "");
590         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipminy_range");
591
592         prop = RNA_def_property(srna, "clip_max_x", PROP_FLOAT, PROP_NONE);
593         RNA_def_property_float_sdna(prop, NULL, "clipr.xmax");
594         RNA_def_property_range(prop, -100.0f, 100.0f);
595         RNA_def_property_ui_text(prop, "Clip Max X", "");
596         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipmaxx_range");
597
598         prop = RNA_def_property(srna, "clip_max_y", PROP_FLOAT, PROP_NONE);
599         RNA_def_property_float_sdna(prop, NULL, "clipr.ymax");
600         RNA_def_property_range(prop, -100.0f, 100.0f);
601         RNA_def_property_ui_text(prop, "Clip Max Y", "");
602         RNA_def_property_float_funcs(prop, NULL, NULL, "rna_CurveMapping_clipmaxy_range");
603
604         prop = RNA_def_property(srna, "curves", PROP_COLLECTION, PROP_NONE);
605         RNA_def_property_collection_funcs(prop, "rna_CurveMapping_curves_begin", "rna_iterator_array_next",
606                                           "rna_iterator_array_end", "rna_iterator_array_get",
607                                           "rna_CurveMapping_curves_length", NULL, NULL, NULL);
608         RNA_def_property_struct_type(prop, "CurveMap");
609         RNA_def_property_ui_text(prop, "Curves", "");
610
611         prop = RNA_def_property(srna, "black_level", PROP_FLOAT, PROP_COLOR);
612         RNA_def_property_float_sdna(prop, NULL, "black");
613         RNA_def_property_range(prop, -1000.0f, 1000.0f);
614         RNA_def_property_ui_text(prop, "Black Level", "For RGB curves, the color that black is mapped to");
615         RNA_def_property_float_funcs(prop, NULL, "rna_CurveMapping_black_level_set", NULL);
616
617         prop = RNA_def_property(srna, "white_level", PROP_FLOAT, PROP_COLOR);
618         RNA_def_property_float_sdna(prop, NULL, "white");
619         RNA_def_property_range(prop, -1000.0f, 1000.0f);
620         RNA_def_property_ui_text(prop, "White Level", "For RGB curves, the color that white is mapped to");
621         RNA_def_property_float_funcs(prop, NULL, "rna_CurveMapping_white_level_set", NULL);
622
623         func = RNA_def_function(srna, "update", "curvemapping_changed_all");
624         RNA_def_function_ui_description(func, "Update curve mapping after making changes");
625 }
626
627 static void rna_def_color_ramp_element(BlenderRNA *brna)
628 {
629         StructRNA *srna;
630         PropertyRNA *prop;
631
632         srna = RNA_def_struct(brna, "ColorRampElement", NULL);
633         RNA_def_struct_sdna(srna, "CBData");
634         RNA_def_struct_path_func(srna, "rna_ColorRampElement_path");
635         RNA_def_struct_ui_text(srna, "Color Ramp Element", "Element defining a color at a position in the color ramp");
636         
637         prop = RNA_def_property(srna, "color", PROP_FLOAT, PROP_COLOR);
638         RNA_def_property_float_sdna(prop, NULL, "r");
639         RNA_def_property_array(prop, 4);
640         RNA_def_property_ui_text(prop, "Color", "Set color of selected color stop");
641         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
642         
643         prop = RNA_def_property(srna, "position", PROP_FLOAT, PROP_NONE);
644         RNA_def_property_float_sdna(prop, NULL, "pos");
645         RNA_def_property_range(prop, 0, 1);
646         RNA_def_property_ui_text(prop, "Position", "Set position of selected color stop");
647         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
648 }
649
650 static void rna_def_color_ramp_element_api(BlenderRNA *brna, PropertyRNA *cprop)
651 {
652         StructRNA *srna;
653         PropertyRNA *parm;
654         FunctionRNA *func;
655
656         RNA_def_property_srna(cprop, "ColorRampElements");
657         srna = RNA_def_struct(brna, "ColorRampElements", NULL);
658         RNA_def_struct_sdna(srna, "ColorBand");
659         RNA_def_struct_path_func(srna, "rna_ColorRampElement_path");
660         RNA_def_struct_ui_text(srna, "Color Ramp Elements", "Collection of Color Ramp Elements");
661
662         /* TODO, make these functions generic in texture.c */
663         func = RNA_def_function(srna, "new", "rna_ColorRampElement_new");
664         RNA_def_function_ui_description(func, "Add element to ColorRamp");
665         RNA_def_function_flag(func, FUNC_USE_REPORTS);
666         parm = RNA_def_float(func, "position", 0.0f, 0.0f, 1.0f, "Position", "Position to add element", 0.0f, 1.0f);
667         RNA_def_property_flag(parm, PROP_REQUIRED);
668         /* return type */
669         parm = RNA_def_pointer(func, "element", "ColorRampElement", "", "New element");
670         RNA_def_function_return(func, parm);
671
672         func = RNA_def_function(srna, "remove", "rna_ColorRampElement_remove");
673         RNA_def_function_ui_description(func, "Delete element from ColorRamp");
674         RNA_def_function_flag(func, FUNC_USE_REPORTS);
675         parm = RNA_def_pointer(func, "element", "ColorRampElement", "", "Element to remove");
676         RNA_def_property_flag(parm, PROP_REQUIRED | PROP_NEVER_NULL);
677 }
678
679 static void rna_def_color_ramp(BlenderRNA *brna)
680 {
681         StructRNA *srna;
682         PropertyRNA *prop;
683         FunctionRNA *func;
684
685         static EnumPropertyItem prop_interpolation_items[] = {
686                 {1, "EASE", 0, "Ease", ""},
687                 {3, "CARDINAL", 0, "Cardinal", ""},
688                 {0, "LINEAR", 0, "Linear", ""},
689                 {2, "B_SPLINE", 0, "B-Spline", ""},
690                 {4, "CONSTANT", 0, "Constant", ""},
691                 {0, NULL, 0, NULL, NULL}
692         };
693         
694         srna = RNA_def_struct(brna, "ColorRamp", NULL);
695         RNA_def_struct_sdna(srna, "ColorBand");
696         RNA_def_struct_path_func(srna, "rna_ColorRamp_path");
697         RNA_def_struct_ui_text(srna, "Color Ramp", "Color ramp mapping a scalar value to a color");
698         
699         prop = RNA_def_property(srna, "elements", PROP_COLLECTION, PROP_COLOR);
700         RNA_def_property_collection_sdna(prop, NULL, "data", "tot");
701         RNA_def_property_struct_type(prop, "ColorRampElement");
702         RNA_def_property_ui_text(prop, "Elements", "");
703         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
704         rna_def_color_ramp_element_api(brna, prop);
705
706         prop = RNA_def_property(srna, "interpolation", PROP_ENUM, PROP_NONE);
707         RNA_def_property_enum_sdna(prop, NULL, "ipotype");
708         RNA_def_property_enum_items(prop, prop_interpolation_items);
709         RNA_def_property_ui_text(prop, "Interpolation", "");
710         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
711
712 #if 0 /* use len(elements) */
713         prop = RNA_def_property(srna, "total", PROP_INT, PROP_NONE);
714         RNA_def_property_int_sdna(prop, NULL, "tot");
715         /* needs a function to do the right thing when adding elements like colorband_add_cb() */
716         RNA_def_property_clear_flag(prop, PROP_EDITABLE);
717         RNA_def_property_range(prop, 0, 31); /* MAXCOLORBAND = 32 */
718         RNA_def_property_ui_text(prop, "Total", "Total number of elements");
719         RNA_def_property_update(prop, 0, "rna_ColorRamp_update");
720 #endif
721         
722         func = RNA_def_function(srna, "evaluate", "rna_ColorRamp_eval");
723         RNA_def_function_ui_description(func, "Evaluate ColorRamp");
724         prop = RNA_def_float(func, "position", 1.0f, 0.0f, 1.0f, "Position", "Evaluate ColorRamp at position", 0.0f, 1.0f);
725         RNA_def_property_flag(prop, PROP_REQUIRED);
726         /* return */
727         prop = RNA_def_float_color(func, "color", 4, NULL, -FLT_MAX, FLT_MAX, "Color", "Color at given position",
728                                    -FLT_MAX, FLT_MAX);
729         RNA_def_property_flag(prop, PROP_THICK_WRAP);
730         RNA_def_function_output(func, prop);
731 }
732
733 static void rna_def_histogram(BlenderRNA *brna)
734 {
735         StructRNA *srna;
736         PropertyRNA *prop;
737         
738         static EnumPropertyItem prop_mode_items[] = {
739                 {HISTO_MODE_LUMA, "LUMA", 0, "Luma", "Luma"},
740                 {HISTO_MODE_RGB, "RGB", 0, "RGB", "Red Green Blue"},
741                 {HISTO_MODE_R, "R", 0, "R", "Red"},
742                 {HISTO_MODE_G, "G", 0, "G", "Green"},
743                 {HISTO_MODE_B, "B", 0, "B", "Blue"},
744                 {HISTO_MODE_ALPHA, "A", 0, "A", "Alpha"},
745                 {0, NULL, 0, NULL, NULL}
746         };
747
748         srna = RNA_def_struct(brna, "Histogram", NULL);
749         RNA_def_struct_ui_text(srna, "Histogram", "Statistical view of the levels of color in an image");
750         
751         prop = RNA_def_property(srna, "mode", PROP_ENUM, PROP_NONE);
752         RNA_def_property_enum_sdna(prop, NULL, "mode");
753         RNA_def_property_enum_items(prop, prop_mode_items);
754         RNA_def_property_ui_text(prop, "Mode", "Channels to display when drawing the histogram");
755
756         prop = RNA_def_property(srna, "show_line", PROP_BOOLEAN, PROP_NONE);
757         RNA_def_property_boolean_sdna(prop, NULL, "flag", HISTO_FLAG_LINE);
758         RNA_def_property_ui_text(prop, "Show Line", "Display lines rather then filled shapes");
759         RNA_def_property_ui_icon(prop, ICON_IPO, 0);
760 }
761
762 static void rna_def_scopes(BlenderRNA *brna)
763 {
764         StructRNA *srna;
765         PropertyRNA *prop;
766
767         static EnumPropertyItem prop_wavefrm_mode_items[] = {
768                 {SCOPES_WAVEFRM_LUMA, "LUMA", ICON_COLOR, "Luma", ""},
769                 {SCOPES_WAVEFRM_RGB, "RGB", ICON_COLOR, "Red Green Blue", ""},
770                 {SCOPES_WAVEFRM_YCC_601, "YCBCR601", ICON_COLOR, "YCbCr (ITU 601)", ""},
771                 {SCOPES_WAVEFRM_YCC_709, "YCBCR709", ICON_COLOR, "YCbCr (ITU 709)", ""},
772                 {SCOPES_WAVEFRM_YCC_JPEG, "YCBCRJPG", ICON_COLOR, "YCbCr (Jpeg)", ""},
773                 {0, NULL, 0, NULL, NULL}
774         };
775
776         srna = RNA_def_struct(brna, "Scopes", NULL);
777         RNA_def_struct_ui_text(srna, "Scopes", "Scopes for statistical view of an image");
778         
779         prop = RNA_def_property(srna, "use_full_resolution", PROP_BOOLEAN, PROP_NONE);
780         RNA_def_property_boolean_sdna(prop, "Scopes", "sample_full", 1);
781         RNA_def_property_ui_text(prop, "Full Sample", "Sample every pixel of the image");
782         RNA_def_property_update(prop, 0, "rna_Scopes_update");
783         
784         prop = RNA_def_property(srna, "accuracy", PROP_FLOAT, PROP_PERCENTAGE);
785         RNA_def_property_float_sdna(prop, "Scopes", "accuracy");
786         RNA_def_property_range(prop, 0.0, 100.0);
787         RNA_def_property_ui_range(prop, 0.0, 100.0, 10, 1);
788         RNA_def_property_ui_text(prop, "Accuracy", "Proportion of original image source pixel lines to sample");
789         RNA_def_property_update(prop, 0, "rna_Scopes_update");
790
791         prop = RNA_def_property(srna, "histogram", PROP_POINTER, PROP_NONE);
792         RNA_def_property_pointer_sdna(prop, "Scopes", "hist");
793         RNA_def_property_struct_type(prop, "Histogram");
794         RNA_def_property_ui_text(prop, "Histogram", "Histogram for viewing image statistics");
795
796         prop = RNA_def_property(srna, "waveform_mode", PROP_ENUM, PROP_NONE);
797         RNA_def_property_enum_sdna(prop, "Scopes", "wavefrm_mode");
798         RNA_def_property_enum_items(prop, prop_wavefrm_mode_items);
799         RNA_def_property_ui_text(prop, "Waveform Mode", "");
800         RNA_def_property_update(prop, 0, "rna_Scopes_update");
801
802         prop = RNA_def_property(srna, "waveform_alpha", PROP_FLOAT, PROP_FACTOR);
803         RNA_def_property_float_sdna(prop, "Scopes", "wavefrm_alpha");
804         RNA_def_property_range(prop, 0, 1);
805         RNA_def_property_ui_text(prop, "Waveform Opacity", "Opacity of the points");
806
807         prop = RNA_def_property(srna, "vectorscope_alpha", PROP_FLOAT, PROP_FACTOR);
808         RNA_def_property_float_sdna(prop, "Scopes", "vecscope_alpha");
809         RNA_def_property_range(prop, 0, 1);
810         RNA_def_property_ui_text(prop, "Vectorscope Opacity", "Opacity of the points");
811 }
812
813 static void rna_def_colormanage(BlenderRNA *brna)
814 {
815         StructRNA *srna;
816         PropertyRNA *prop;
817
818         static EnumPropertyItem display_device_items[] = {
819                 {0, "DEFAULT", 0, "Default", ""},
820                 {0, NULL, 0, NULL, NULL}
821         };
822
823         /* ** Display Settings  **  */
824         srna = RNA_def_struct(brna, "ColorManagedDisplaySettings", NULL);
825         RNA_def_struct_ui_text(srna, "ColorManagedDisplaySettings", "Color management specific to display device");
826
827         prop= RNA_def_property(srna, "display_device", PROP_ENUM, PROP_NONE);
828         RNA_def_property_enum_items(prop, display_device_items);
829         RNA_def_property_enum_funcs(prop, "rna_ColorManagedDisplaySettings_display_device_get",
830                                           "rna_ColorManagedDisplaySettings_display_device_set",
831                                           "rna_ColorManagedDisplaySettings_display_device_itemf");
832         RNA_def_property_ui_text(prop, "Display Device", "Display device name");
833         RNA_def_property_update(prop, NC_WINDOW, NULL);
834
835         /* ** View Settings  **  */
836         srna = RNA_def_struct(brna, "ColorManagedViewSettings", NULL);
837         RNA_def_struct_ui_text(srna, "ColorManagedViewSettings", "Color management settings used for displaying images on the display");
838
839         prop = RNA_def_property(srna, "use_global_settings", PROP_BOOLEAN, PROP_NONE);
840         RNA_def_property_boolean_sdna(prop, NULL, "flag", COLORMANAGE_VIEW_USE_GLOBAL);
841         RNA_def_property_ui_text(prop, "Use Global Settings", "Use global display settings instead of per-space setting");
842         RNA_def_property_update(prop, NC_WINDOW, NULL);
843
844         prop= RNA_def_property(srna, "view_transform", PROP_ENUM, PROP_NONE);
845         RNA_def_property_enum_items(prop, view_transform_items);
846         RNA_def_property_enum_funcs(prop, "rna_ColorManagedViewSettings_view_transform_get",
847                                           "rna_ColorManagedViewSettings_view_transform_set",
848                                           "rna_ColorManagedViewSettings_view_transform_itemf");
849         RNA_def_property_ui_text(prop, "View Transform", "View transform used for this image editor");
850         RNA_def_property_update(prop, NC_WINDOW, NULL);
851
852         prop = RNA_def_property(srna, "exposure", PROP_FLOAT, PROP_FACTOR);
853         RNA_def_property_float_sdna(prop, NULL, "exposure");
854         RNA_def_property_range(prop, -10.0f, 10.0f);
855         RNA_def_property_float_default(prop, 0.0f);
856         RNA_def_property_ui_text(prop, "Exposure", "Exposure (stops) applied on displaying image buffers");
857         RNA_def_property_update(prop, NC_WINDOW, NULL);
858
859         prop = RNA_def_property(srna, "gamma", PROP_FLOAT, PROP_FACTOR);
860         RNA_def_property_float_sdna(prop, NULL, "gamma");
861         RNA_def_property_float_default(prop, 1.0f);
862         RNA_def_property_range(prop, 0.0f, 5.0f);
863         RNA_def_property_ui_text(prop, "Gamma", "Amount f gamma modification for displaying image buffers");
864         RNA_def_property_update(prop, NC_WINDOW, NULL);
865
866         /* ** Colorspace **  */
867         srna = RNA_def_struct(brna, "ColorManagedColorspaceSettings", NULL);
868         RNA_def_struct_ui_text(srna, "ColorManagedColorspaceSettings", "Input color space settings");
869
870         prop= RNA_def_property(srna, "name", PROP_ENUM, PROP_NONE);
871         RNA_def_property_enum_items(prop, color_space_items);
872         RNA_def_property_enum_funcs(prop, "rna_ColorManagedColorspaceSettings_colorspace_get",
873                                           "rna_ColorManagedColorspaceSettings_colorspace_set",
874                                           "rna_ColorManagedColorspaceSettings_colorspace_itemf");
875         RNA_def_property_ui_text(prop, "Color Space", "Input color space name");
876         RNA_def_property_update(prop, NC_WINDOW, "rna_ColorManagedColorspaceSettings_reload_update");
877 }
878
879 void RNA_def_color(BlenderRNA *brna)
880 {
881         rna_def_curvemappoint(brna);
882         rna_def_curvemap(brna);
883         rna_def_curvemapping(brna);
884         rna_def_color_ramp_element(brna);
885         rna_def_color_ramp(brna);
886         rna_def_histogram(brna);
887         rna_def_scopes(brna);
888         rna_def_colormanage(brna);
889 }
890
891 #endif