2f40520e59a73963bb93fe737b02072ca1d9e736
[blender.git] / source / blender / blenlib / BLI_math_color.h
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  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
21  * All rights reserved.
22  *
23  * The Original Code is: some of this file.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  * */
27
28 #ifndef BLI_MATH_COLOR
29 #define BLI_MATH_COLOR
30
31 #ifdef __cplusplus
32 extern "C" {
33 #endif
34
35 /* primaries */
36 #define BLI_XYZ_SMPTE   0
37 #define BLI_XYZ_REC709_SRGB     1
38 #define BLI_XYZ_CIE             2
39
40 /* built-in profiles */
41 #define BLI_PR_NONE             0
42 #define BLI_PR_SRGB             1
43 #define BLI_PR_REC709   2
44
45 /* YCbCr */
46 #define BLI_YCC_ITU_BT601       0
47 #define BLI_YCC_ITU_BT709       1
48 #define BLI_YCC_JFIF_0_255      2
49         
50 /******************* Conversion to RGB ********************/
51
52 void hsv_to_rgb(float h, float s, float v, float *r, float *g, float *b);
53 void hex_to_rgb(char *hexcol, float *r, float *g, float *b);
54 void yuv_to_rgb(float y, float u, float v, float *lr, float *lg, float *lb);
55 void ycc_to_rgb(float y, float cb, float cr, float *lr, float *lg, float *lb, int colorspace);
56 void xyz_to_rgb(float x, float y, float z, float *r, float *g, float *b, int colorspace);
57 void cpack_to_rgb(unsigned int col, float *r, float *g, float *b);
58
59 /***************** Conversion from RGB ********************/
60
61 void rgb_to_yuv(float r, float g, float b, float *ly, float *lu, float *lv);
62 void rgb_to_ycc(float r, float g, float b, float *ly, float *lcb, float *lcr, int colorspace);
63 void rgb_to_hsv(float r, float g, float b, float *lh, float *ls, float *lv);
64 unsigned int rgb_to_cpack(float r, float g, float b);
65 unsigned int hsv_to_cpack(float h, float s, float v);
66
67 float rgb_to_grayscale(float rgb[3]);
68
69 /***************** Profile Transformations ********************/
70
71 void gamma_correct(float *c, float gamma);
72 float rec709_to_linearrgb(float c);
73 float linearrgb_to_rec709(float c);
74 float srgb_to_linearrgb(float c);
75 float linearrgb_to_srgb(float c);
76 void srgb_to_linearrgb_v3_v3(float *col_to, float *col_from);
77 void linearrgb_to_srgb_v3_v3(float *col_to, float *col_from);
78
79 /* rgba buffer convenience functions */
80 void srgb_to_linearrgb_rgba_buf(float *col, int tot);
81 void linearrgb_to_srgb_rgba_buf(float *col, int tot);
82 void srgb_to_linearrgb_rgba_rgba_buf(float *col_to, float *col_from, int tot);
83 void linearrgb_to_srgb_rgba_rgba_buf(float *col_to, float *col_from, int tot);
84         
85 /************************** Other *************************/
86
87 int constrain_rgb(float *r, float *g, float *b);
88 void minmax_rgb(short c[3]);
89
90 void rgb_float_set_hue_float_offset(float * rgb, float hue_offset);
91 void rgb_byte_set_hue_float_offset(char * rgb, float hue_offset);
92
93 /***************** lift/gamma/gain / ASC-CDL conversion *****************/
94
95 void lift_gamma_gain_to_asc_cdl(float *lift, float *gamma, float *gain, float *offset, float *slope, float *power);
96
97 void rgb_byte_to_float(char *in, float *out);
98 void rgb_float_to_byte(float *in, char *out);
99
100 #ifdef __cplusplus
101 }
102 #endif
103
104 #endif /* BLI_MATH_COLOR */
105