require "matrix" module Colors module Convert module_function # Sort alphabetically by FROM name such as degree, LCh, LUV and so on. # Utilities private def dot_product(matrix, vector) matrix.map do |row| product = 0.0 row.zip(vector) do |value1, value2| product += value1 * value2 end product end end private def matrix_inv(matrix) matrix = Matrix[*matrix] matrix.inv.to_a end def max_chroma(l, h) h_rad = degree_to_radian(h) sin_h = Math.sin(h_rad).to_r cos_h = Math.cos(h_rad).to_r max = Float::INFINITY luminance_bounds(l).each do |line| len = line[1] / (sin_h - line[0] * cos_h) max = len if 0 <= len && len < max end max end private def luminance_bounds(l) sub1 = (l + 16)**3 / 1560896r sub2 = sub1 > XYZ::EPSILON ? sub1 : l/XYZ::KAPPA bounds = Array.new(6) { [0r, 0r] } 0.upto(2) do |ch| m1 = M_XYZ_RGB[ch][0].to_r m2 = M_XYZ_RGB[ch][1].to_r m3 = M_XYZ_RGB[ch][2].to_r [0, 1].each do |t| top1 = (284517r * m1 - 94839r * m3) * sub2 top2 = (838422r * m3 + 769860r * m2 + 731718r * m1) * l * sub2 - 769860r * t * l bottom = (632260r * m3 - 126452r * m2) * sub2 + 126452r * t bounds[ch*2 + t][0] = top1 / bottom bounds[ch*2 + t][1] = top2 / bottom end end bounds end # degree -> ??? DEG2RAD = 0.01745329251994329577r # 2 * pi / 360 def degree_to_radian(d) d * DEG2RAD end # LCh -> ??? def lch_to_husl(l, c, h) if l > 99.9999999 || l < 1e-8 s = 0r else mx = max_chroma(l, h) s = c / mx * 100r end h = 0r if c < 1e-8 [h, s/100r, l/100r] end def lch_to_luv(l, c, h) h_rad = degree_to_radian(h) u = Math.cos(h_rad).to_r * c v = Math.sin(h_rad).to_r * c [l, u, v] end def lch_to_xyz(l, c, h) luv_to_xyz(*lch_to_luv(l, c, h)) end # linear-sRGB -> ??? def linear_srgb_to_srgb(r, g, b) [r, g, b].map do |v| # the following is an optimization technique for `1.055*v**(1/2.4) - 0.055`. # x^y ~= exp(y*log(x)) ~= exp2(y*log2(y)); the middle form is faster # # See https://github.com/JuliaGraphics/Colors.jl/issues/351#issuecomment-532073196 # for more detail benchmark in Julia language. if v <= 0.0031308 12.92*v else 1.055 * Math.exp(1/2.4 * Math.log(v)) - 0.055 end end end # Luv -> ??? def luv_to_husl(l, u, v) lch_to_husl(*luv_to_lch(l, u, v)) end def luv_to_lch(l, u, v) c = Math.sqrt(u*u + v*v).to_r hard = Math.atan2(v, u).to_r h = hard * 180 / Math::PI.to_r h += 360r if h < 0 [l, c, h] end def luv_to_xyz(l, u, v) return [0r, 0r, 0r] if l <= 1e-8 wp_u, wp_v = WHITE_POINT_D65.uv_values var_u = u / (13 * l) + wp_u var_v = v / (13 * l) + wp_v y = if l < 8 l / XYZ::KAPPA else ((l + 16r) / 116r)**3 end x = -(9 * y * var_u) / ((var_u - 4) * var_v - var_u * var_v) z = (9 * y - (15 * var_v * y) - (var_v * x)) / (3 * var_v) [x, y, z] end # RGB -> ??? RGB2XYZ = [ [ 0.41239079926595948129, 0.35758433938387796373, 0.18048078840183428751 ], [ 0.21263900587151035754, 0.71516867876775592746, 0.07219231536073371500 ], [ 0.01933081871559185069, 0.11919477979462598791, 0.95053215224966058086 ] ] def rgb_to_xyz(r, g, b) dot_product(RGB2XYZ, srgb_to_linear_srgb(r, g, b)) end def rgb_to_greyscale(r, g, b) r, g, b = srgb_to_linear_srgb(r, g, b) a = RGB2XYZ[1] (a[0]*r + a[1]*g + a[2]*b).clamp(0, 1) end def rgb_to_xterm256(r, g, b) i = closest_xterm256_rgb_index(r) j = closest_xterm256_rgb_index(g) k = closest_xterm256_rgb_index(b) r0 = xterm256_rgb_index_to_rgb_value(i) g0 = xterm256_rgb_index_to_rgb_value(j) b0 = xterm256_rgb_index_to_rgb_value(k) d0 = (r - r0)**2 + (g - g0)**2 + (b - b0)**2 l = closest_xterm256_gray_index(r, g, b) gr = xterm256_gray_index_to_gray_level(l) d1 = (r - gr)**2 + (g - gr)**2 + (b - gr)**2 if d0 > d1 xterm256_gray_index_to_code(l) else xterm256_rgb_indices_to_code(i, j, k) end end def xterm256_rgb_index_to_rgb_value(i) (i == 0) ? 0 : (40*i + 55)/255.0 end def closest_xterm256_rgb_index(x) ([x*255 - 55, 0].max / 40.0).round end def xterm256_gray_index_to_gray_level(i) (10*i + 8)/255.0 end def closest_xterm256_gray_index(r, g, b) ((255*(r + g + b) - 24)/30.0).round.clamp(0, 23) end def xterm256_rgb_indices_to_code(i, j, k) 6*(6*i + j) + k + 16 end def xterm256_gray_index_to_code(i) i + 232 end # sRGB -> ??? def srgb_from_linear_srgb(r, g, b) a = 0.055r [r, g, b].map do |v| if v < 0.0031308 12.92r * v else (1 + a) * v**(1/2.4r) - a end end end def srgb_to_linear_srgb(r, g, b) a = 0.055r [r, g, b].map do |v| if v > 0.04045 ((v + a) / (1 + a)) ** 2.4r else v / 12.92r end end end # xyY -> ??? def xyy_to_xyz(x, y, large_y) large_x = large_y*x/y large_z = large_y*(1 - x - y)/y [large_x, large_y, large_z] end # XYZ -> ??? # sRGB reference points R_xyY = [0.64r, 0.33r, 1r] G_xyY = [0.30r, 0.60r, 1r] B_xyY = [0.15r, 0.06r, 1r] D65_xyY = [0.3127r, 0.3290r, 1r] R_XYZ = xyy_to_xyz(*R_xyY) G_XYZ = xyy_to_xyz(*G_xyY) B_XYZ = xyy_to_xyz(*B_xyY) D65_XYZ = xyy_to_xyz(*D65_xyY) M_P = [ [R_XYZ[0], G_XYZ[0], B_XYZ[0]], [R_XYZ[1], G_XYZ[1], B_XYZ[1]], [R_XYZ[2], G_XYZ[2], B_XYZ[2]] ] M_S = dot_product(matrix_inv(M_P), D65_XYZ) M_RGB_XYZ = (0 ... 3).map do |i| (0 ... 3).map {|j| (M_S[j] * M_P[i][j]).round(4) } end M_XYZ_RGB = matrix_inv(M_RGB_XYZ).map do |row| row.map {|v| v.round(4) } end def xyz_to_rgb(x, y, z) r, g, b = dot_product(M_XYZ_RGB, [x, y, z]) r, g, b = srgb_from_linear_srgb(r, g, b) [ r.clamp(0r, 1r), g.clamp(0r, 1r), b.clamp(0r, 1r) ] end end end