- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 31
- 32
- 33
- 34
- 35
- 36
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
- 54
- 55
- 56
- 57
- 58
- 59
- 60
- 61
- 62
- 63
- 64
- 65
- 66
- 67
- 68
- 69
- 70
- 71
- 72
- 73
- 74
- 75
- 76
- 77
- 78
- 79
- 80
- 81
- 82
- 83
- 84
- 85
- 86
- 87
- 88
- 89
- 90
- 91
- 92
- 93
- 94
- 95
- 96
- 97
- 98
- 99
- 100
- 101
- 102
- 103
- 104
- 105
- 106
- 107
- 108
- 109
- 110
- 111
- 112
- 113
- 114
- 115
- 116
- 117
- 118
- 119
- 120
- 121
- 122
- 123
- 124
- 125
- 126
- 127
- 128
- 129
- 130
- 131
- 132
- 133
- 134
- 135
- 136
- 137
- 138
- 139
- 140
- 141
- 142
- 143
- 144
- 145
- 146
- 147
- 148
- 149
- 150
- 151
- 152
- 153
- 154
- 155
- 156
- 157
- 158
- 159
- 160
- 161
- 162
- 163
- 164
- 165
- 166
- 167
- 168
- 169
- 170
- 171
- 172
- 173
- 174
- 175
- 176
- 177
- 178
- 179
- 180
- 181
- 182
- 183
- 184
- 185
- 186
- 187
- 188
- 189
- 190
- 191
- 192
- 193
- 194
- 195
- 196
- 197
- 198
- 199
- 200
- 201
- 202
- 203
- 204
- 205
- 206
- 207
- 208
- 209
- 210
- 211
- 212
- 213
- 214
- 215
- 216
- 217
- 218
- 219
- 220
- 221
- 222
- 223
- 224
- 225
- 226
- 227
- 228
- 229
- 230
- 231
- 232
- 233
- 234
- 235
- 236
- 237
- 238
- 239
- 240
- 241
- 242
- 243
- 244
- 245
- 246
- 247
- 248
- 249
- 250
- 251
- 252
- 253
- 254
- 255
- 256
- 257
- 258
- 259
- 260
- 261
- 262
- 263
- 264
- 265
- 266
- 267
- 268
- 269
- 270
- 271
- 272
- 273
- 274
- 275
- 276
- 277
- 278
- 279
- 280
- 281
- 282
- 283
- 284
- 285
- 286
- 287
- 288
- 289
- 290
- 291
- 292
- 293
- 294
- 295
- 296
- 297
- 298
- 299
- 300
- 301
- 302
- 303
- 304
- 305
- 306
- 307
- 308
- 309
- 310
- 311
- 312
- 313
- 314
- 315
- 316
- 317
- 318
- 319
- 320
- 321
- 322
- 323
- 324
- 325
- 326
- 327
- 328
- 329
- 330
- 331
- 332
- 333
- 334
- 335
- 336
- 337
- 338
- 339
- 340
- 341
- 342
- 343
- 344
- 345
- 346
- 347
- 348
- 349
- 350
- 351
- 352
- 353
- 354
- 355
- 356
- 357
- 358
- 359
- 360
- 361
- 362
- 363
- 364
- 365
- 366
- 367
- 368
- 369
- 370
- 371
- 372
- 373
- 374
- 375
- 376
- 377
- 378
- 379
- 380
- 381
- 382
- 383
- 384
- 385
- 386
- 387
- 388
- 389
- 390
- 391
- 392
- 393
- 394
- 395
- 396
- 397
- 398
- 399
- 400
- 401
- 402
- 403
- 404
- 405
- 406
- 407
- 408
- 409
- 410
- 411
- 412
- 413
- 414
- 415
- 416
- 417
- 418
- 419
- 420
- 421
- 422
- 423
- 424
- 425
- 426
- 427
- 428
- 429
- 430
- 431
- 432
- 433
- 434
- 435
- 436
- 437
- 438
- 439
- 440
- 441
- 442
- 443
- 444
- 445
- 446
- 447
- 448
- 449
- 450
- 451
- 452
- 453
- 454
- 455
- 456
- 457
- 458
- 459
- 460
- 461
- 462
- 463
- 464
- 465
- 466
- 467
- 468
- 469
- 470
- 471
- 472
- 473
- 474
- 475
- 476
- 477
- 478
- 479
- 480
- 481
- 482
- 483
- 484
- 485
- 486
- 487
- 488
- 489
- 490
- 491
- 492
- 493
- 494
- 495
- 496
- 497
- 498
- 499
- 500
- 501
- 502
- 503
- 504
- 505
- 506
- 507
- 508
- 509
- 510
- 511
- 512
- 513
- 514
- 515
- 516
- 517
- 518
- 519
- 520
- 521
- 522
- 523
- 524
- 525
- 526
- 527
- 528
- 529
- 530
- 531
- 532
- 533
- 534
- 535
- 536
- 537
- 538
- 539
- 540
- 541
- 542
- 543
- 544
- 545
- 546
- 547
- 548
- 549
- 550
- 551
- 552
- 553
- 554
- 555
- 556
- 557
- 558
- 559
- 560
- 561
- 562
- 563
- 564
- 565
- 566
- 567
- 568
- 569
- 570
- 571
- 572
- 573
- 574
- 575
- 576
- 577
- 578
- 579
- 580
- 581
- 582
- 583
- 584
- 585
- 586
- 587
- 588
- 589
- 590
- 591
- 592
- 593
- 594
- 595
- 596
- 597
- 598
- 599
- 600
- 601
- 602
- 603
- 604
- 605
- 606
- 607
- 608
- 609
- 610
- 611
- 612
- 613
- 614
- 615
- 616
- 617
- 618
- 619
- 620
- 621
- 622
- 623
- 624
- 625
- 626
- 627
- 628
import { clamp, random } from "./math.js";
import pool from "./../system/pooling.js";
// convert a give color component to it hexadecimal value
const charLookup = ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9", "A", "B", "C", "D", "E", "F"];
function toHex(component) {
return charLookup[(component & 0xF0) >> 4] + charLookup[component & 0x0F];
}
function hue2rgb(p, q, t) {
if (t < 0) t += 1;
if (t > 1) t -= 1;
if (t < 1 / 6) return p + (q - p) * 6 * t;
if (t < 1 / 2) return q;
if (t < 2 / 3) return p + (q - p) * (2 / 3 - t) * 6;
return p;
}
const rgbaRx = /^rgba?\((\d+), ?(\d+), ?(\d+)(, ?([\d\.]+))?\)$/;
const hex3Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
const hex4Rx = /^#([\da-fA-F])([\da-fA-F])([\da-fA-F])([\da-fA-F])$/;
const hex6Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
const hex8Rx = /^#([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})([\da-fA-F]{2})$/;
let cssToRGB = new Map();
[
// CSS1
[ "black", [ 0, 0, 0 ] ],
[ "silver", [ 192, 192, 129 ] ],
[ "gray", [ 128, 128, 128 ] ],
[ "white", [ 255, 255, 255 ] ],
[ "maroon", [ 128, 0, 0 ] ],
[ "red", [ 255, 0, 0 ] ],
[ "purple", [ 128, 0, 128 ] ],
[ "fuchsia", [ 255, 0, 255 ] ],
[ "green", [ 0, 128, 0 ] ],
[ "lime", [ 0, 255, 0 ] ],
[ "olive", [ 128, 128, 0 ] ],
[ "yellow", [ 255, 255, 0 ] ],
[ "navy", [ 0, 0, 128 ] ],
[ "blue", [ 0, 0, 255 ] ],
[ "teal", [ 0, 128, 128 ] ],
[ "aqua", [ 0, 255, 255 ] ],
// CSS2
[ "orange", [ 255, 165, 0 ] ],
// CSS3
[ "aliceblue", [ 240, 248, 245 ] ],
[ "antiquewhite", [ 250, 235, 215 ] ],
[ "aquamarine", [ 127, 255, 212 ] ],
[ "azure", [ 240, 255, 255 ] ],
[ "beige", [ 245, 245, 220 ] ],
[ "bisque", [ 255, 228, 196 ] ],
[ "blanchedalmond", [ 255, 235, 205 ] ],
[ "blueviolet", [ 138, 43, 226 ] ],
[ "brown", [ 165, 42, 42 ] ],
[ "burlywood", [ 222, 184, 35 ] ],
[ "cadetblue", [ 95, 158, 160 ] ],
[ "chartreuse", [ 127, 255, 0 ] ],
[ "chocolate", [ 210, 105, 30 ] ],
[ "coral", [ 255, 127, 80 ] ],
[ "cornflowerblue", [ 100, 149, 237 ] ],
[ "cornsilk", [ 255, 248, 220 ] ],
[ "crimson", [ 220, 20, 60 ] ],
[ "darkblue", [ 0, 0, 139 ] ],
[ "darkcyan", [ 0, 139, 139 ] ],
[ "darkgoldenrod", [ 184, 134, 11 ] ],
[ "darkgray[*]", [ 169, 169, 169 ] ],
[ "darkgreen", [ 0, 100, 0 ] ],
[ "darkgrey[*]", [ 169, 169, 169 ] ],
[ "darkkhaki", [ 189, 183, 107 ] ],
[ "darkmagenta", [ 139, 0, 139 ] ],
[ "darkolivegreen", [ 85, 107, 47 ] ],
[ "darkorange", [ 255, 140, 0 ] ],
[ "darkorchid", [ 153, 50, 204 ] ],
[ "darkred", [ 139, 0, 0 ] ],
[ "darksalmon", [ 233, 150, 122 ] ],
[ "darkseagreen", [ 143, 188, 143 ] ],
[ "darkslateblue", [ 72, 61, 139 ] ],
[ "darkslategray", [ 47, 79, 79 ] ],
[ "darkslategrey", [ 47, 79, 79 ] ],
[ "darkturquoise", [ 0, 206, 209 ] ],
[ "darkviolet", [ 148, 0, 211 ] ],
[ "deeppink", [ 255, 20, 147 ] ],
[ "deepskyblue", [ 0, 191, 255 ] ],
[ "dimgray", [ 105, 105, 105 ] ],
[ "dimgrey", [ 105, 105, 105 ] ],
[ "dodgerblue", [ 30, 144, 255 ] ],
[ "firebrick", [ 178, 34, 34 ] ],
[ "floralwhite", [ 255, 250, 240 ] ],
[ "forestgreen", [ 34, 139, 34 ] ],
[ "gainsboro", [ 220, 220, 220 ] ],
[ "ghostwhite", [ 248, 248, 255 ] ],
[ "gold", [ 255, 215, 0 ] ],
[ "goldenrod", [ 218, 165, 32 ] ],
[ "greenyellow", [ 173, 255, 47 ] ],
[ "grey", [ 128, 128, 128 ] ],
[ "honeydew", [ 240, 255, 240 ] ],
[ "hotpink", [ 255, 105, 180 ] ],
[ "indianred", [ 205, 92, 92 ] ],
[ "indigo", [ 75, 0, 130 ] ],
[ "ivory", [ 255, 255, 240 ] ],
[ "khaki", [ 240, 230, 140 ] ],
[ "lavender", [ 230, 230, 250 ] ],
[ "lavenderblush", [ 255, 240, 245 ] ],
[ "lawngreen", [ 124, 252, 0 ] ],
[ "lemonchiffon", [ 255, 250, 205 ] ],
[ "lightblue", [ 173, 216, 230 ] ],
[ "lightcoral", [ 240, 128, 128 ] ],
[ "lightcyan", [ 224, 255, 255 ] ],
[ "lightgoldenrodyellow", [ 250, 250, 210 ] ],
[ "lightgray", [ 211, 211, 211 ] ],
[ "lightgreen", [ 144, 238, 144 ] ],
[ "lightgrey", [ 211, 211, 211 ] ],
[ "lightpink", [ 255, 182, 193 ] ],
[ "lightsalmon", [ 255, 160, 122 ] ],
[ "lightseagreen", [ 32, 178, 170 ] ],
[ "lightskyblue", [ 135, 206, 250 ] ],
[ "lightslategray", [ 119, 136, 153 ] ],
[ "lightslategrey", [ 119, 136, 153 ] ],
[ "lightsteelblue", [ 176, 196, 222 ] ],
[ "lightyellow", [ 255, 255, 224 ] ],
[ "limegreen", [ 50, 205, 50 ] ],
[ "linen", [ 250, 240, 230 ] ],
[ "mediumaquamarine", [ 102, 205, 170 ] ],
[ "mediumblue", [ 0, 0, 205 ] ],
[ "mediumorchid", [ 186, 85, 211 ] ],
[ "mediumpurple", [ 147, 112, 219 ] ],
[ "mediumseagreen", [ 60, 179, 113 ] ],
[ "mediumslateblue", [ 123, 104, 238 ] ],
[ "mediumspringgreen", [ 0, 250, 154 ] ],
[ "mediumturquoise", [ 72, 209, 204 ] ],
[ "mediumvioletred", [ 199, 21, 133 ] ],
[ "midnightblue", [ 25, 25, 112 ] ],
[ "mintcream", [ 245, 255, 250 ] ],
[ "mistyrose", [ 255, 228, 225 ] ],
[ "moccasin", [ 255, 228, 181 ] ],
[ "navajowhite", [ 255, 222, 173 ] ],
[ "oldlace", [ 253, 245, 230 ] ],
[ "olivedrab", [ 107, 142, 35 ] ],
[ "orangered", [ 255, 69, 0 ] ],
[ "orchid", [ 218, 112, 214 ] ],
[ "palegoldenrod", [ 238, 232, 170 ] ],
[ "palegreen", [ 152, 251, 152 ] ],
[ "paleturquoise", [ 175, 238, 238 ] ],
[ "palevioletred", [ 219, 112, 147 ] ],
[ "papayawhip", [ 255, 239, 213 ] ],
[ "peachpuff", [ 255, 218, 185 ] ],
[ "peru", [ 205, 133, 63 ] ],
[ "pink", [ 255, 192, 203 ] ],
[ "plum", [ 221, 160, 221 ] ],
[ "powderblue", [ 176, 224, 230 ] ],
[ "rosybrown", [ 188, 143, 143 ] ],
[ "royalblue", [ 65, 105, 225 ] ],
[ "saddlebrown", [ 139, 69, 19 ] ],
[ "salmon", [ 250, 128, 114 ] ],
[ "sandybrown", [ 244, 164, 96 ] ],
[ "seagreen", [ 46, 139, 87 ] ],
[ "seashell", [ 255, 245, 238 ] ],
[ "sienna", [ 160, 82, 45 ] ],
[ "skyblue", [ 135, 206, 235 ] ],
[ "slateblue", [ 106, 90, 205 ] ],
[ "slategray", [ 112, 128, 144 ] ],
[ "slategrey", [ 112, 128, 144 ] ],
[ "snow", [ 255, 250, 250 ] ],
[ "springgreen", [ 0, 255, 127 ] ],
[ "steelblue", [ 70, 130, 180 ] ],
[ "tan", [ 210, 180, 140 ] ],
[ "thistle", [ 216, 191, 216 ] ],
[ "tomato", [ 255, 99, 71 ] ],
[ "turquoise", [ 64, 224, 208 ] ],
[ "violet", [ 238, 130, 238 ] ],
[ "wheat", [ 245, 222, 179 ] ],
[ "whitesmoke", [ 245, 245, 245 ] ],
[ "yellowgreen", [ 154, 205, 50 ] ]
].forEach((value) => {
cssToRGB.set(value[0], value[1]);
});
/**
* @classdesc
* A color manipulation object.
*/
export default class Color {
/**
* @param {number} [r=0] - red component [0 .. 255]
* @param {number} [g=0] - green component [0 .. 255]
* @param {number} [b=0] - blue component [0 .. 255]
* @param {number} [alpha=1.0] - alpha value [0.0 .. 1.0]
*/
constructor(r = 0, g = 0, b = 0, alpha = 1.0) {
this.onResetEvent(r, g, b, alpha);
}
/**
* @ignore
*/
onResetEvent(r = 0, g = 0, b = 0, alpha = 1.0) {
if (typeof this.glArray === "undefined") {
// Color components in a Float32Array suitable for WebGL
this.glArray = new Float32Array([ 0.0, 0.0, 0.0, 1.0 ]);
}
this.setColor(r, g, b, alpha);
}
/**
* Color Red Component [0 .. 255]
* @type {number}
*/
get r() {
return ~~(this.glArray[0] * 255);
}
set r(value) {
this.glArray[0] = clamp(~~value || 0, 0, 255) / 255.0;
}
/**
* Color Green Component [0 .. 255]
* @type {number}
*/
get g() {
return ~~(this.glArray[1] * 255);
}
set g(value) {
this.glArray[1] = clamp(~~value || 0, 0, 255) / 255.0;
}
/**
* Color Blue Component [0 .. 255]
* @type {number}
*/
get b() {
return ~~(this.glArray[2] * 255);
}
set b(value) {
this.glArray[2] = clamp(~~value || 0, 0, 255) / 255.0;
}
/**
* Color Alpha Component [0.0 .. 1.0]
* @type {number}
*/
get alpha() {
return this.glArray[3];
}
set alpha(value = 1.0) {
this.glArray[3] = clamp(+value, 0, 1.0);
}
/**
* Set this color to the specified value.
* @param {number} r - red component [0 .. 255]
* @param {number} g - green component [0 .. 255]
* @param {number} b - blue component [0 .. 255]
* @param {number} [alpha=1.0] - alpha value [0.0 .. 1.0]
* @returns {Color} Reference to this object for method chaining
*/
setColor(r, g, b, alpha = 1.0) {
this.r = r;
this.g = g;
this.b = b;
this.alpha = alpha;
return this;
}
/**
* set this color to the specified normalized float values
* @param {number} r - red component [0.0 .. 1.0]
* @param {number} g - green component [0.0 .. 1.0]
* @param {number} b - blue component [0.0 .. 1.0]
* @param {number} [alpha=1.0] - alpha value [0.0 .. 1.0]
* @returns {Color} Reference to this object for method chaining
*/
setFloat(r, g, b, alpha = 1.0) {
const a = this.glArray;
a[0] = clamp(+r, 0, 1.0);
a[1] = clamp(+g, 0, 1.0);
a[2] = clamp(+b, 0, 1.0);
a[3] = clamp(+alpha, 0, 1.0);
return this;
}
/**
* set this color to the specified HSV value
* @param {number} h - hue (a value from 0 to 1)
* @param {number} s - saturation (a value from 0 to 1)
* @param {number} v - value (a value from 0 to 1)
* @returns {Color} Reference to this object for method chaining
*/
setHSV(h, s, v) {
let r, g, b;
let i = Math.floor(h * 6);
let f = h * 6 - i;
let p = v * (1 - s);
let q = v * (1 - f * s);
let t = v * (1 - (1 - f) * s);
switch (i % 6) {
case 0: r = v, g = t, b = p; break;
case 1: r = q, g = v, b = p; break;
case 2: r = p, g = v, b = t; break;
case 3: r = p, g = q, b = v; break;
case 4: r = t, g = p, b = v; break;
case 5: r = v, g = p, b = q; break;
}
return this.setColor(r * 255, g * 255, b * 255);
}
/**
* set this color to the specified HSL value
* @param {number} h - hue (a value from 0 to 1)
* @param {number} s - saturation (a value from 0 to 1)
* @param {number} l - lightness (a value from 0 to 1)
* @returns {Color} Reference to this object for method chaining
*/
setHSL(h, s, l) {
let r, g, b;
if (s === 0) {
r = g = b = l; // achromatic
} else {
let q = l < 0.5 ? l * (1 + s) : l + s - l * s;
let p = 2 * l - q;
r = hue2rgb(p, q, h + 1 / 3);
g = hue2rgb(p, q, h);
b = hue2rgb(p, q, h - 1 / 3);
}
return this.setColor(r * 255, g * 255, b * 255);
}
/**
* Create a new copy of this color object.
* @returns {Color} Reference to the newly cloned object
*/
clone() {
return pool.pull("Color").copy(this);
}
/**
* Copy a color object or CSS color into this one.
* @param {Color|string} color
* @returns {Color} Reference to this object for method chaining
*/
copy(color) {
if (typeof color === "string") {
return this.parseCSS(color);
} else {
this.glArray.set(color.glArray);
return this;
}
}
/**
* Blend this color with the given one using addition.
* @param {Color} color
* @returns {Color} Reference to this object for method chaining
*/
add(color) {
this.glArray[0] = clamp(this.glArray[0] + color.glArray[0], 0, 1);
this.glArray[1] = clamp(this.glArray[1] + color.glArray[1], 0, 1);
this.glArray[2] = clamp(this.glArray[2] + color.glArray[2], 0, 1);
this.glArray[3] = (this.glArray[3] + color.glArray[3]) / 2;
return this;
}
/**
* Darken this color value by 0..1
* @param {number} scale
* @returns {Color} Reference to this object for method chaining
*/
darken(scale) {
scale = clamp(scale, 0, 1);
this.glArray[0] *= scale;
this.glArray[1] *= scale;
this.glArray[2] *= scale;
return this;
}
/**
* Linearly interpolate between this color and the given one.
* @param {Color} color
* @param {number} alpha - with alpha = 0 being this color, and alpha = 1 being the given one.
* @returns {Color} Reference to this object for method chaining
*/
lerp(color, alpha) {
alpha = clamp(alpha, 0, 1);
this.glArray[0] += (color.glArray[0] - this.glArray[0]) * alpha;
this.glArray[1] += (color.glArray[1] - this.glArray[1]) * alpha;
this.glArray[2] += (color.glArray[2] - this.glArray[2]) * alpha;
return this;
}
/**
* Lighten this color value by 0..1
* @param {number} scale
* @returns {Color} Reference to this object for method chaining
*/
lighten(scale) {
scale = clamp(scale, 0, 1);
this.glArray[0] = clamp(this.glArray[0] + (1 - this.glArray[0]) * scale, 0, 1);
this.glArray[1] = clamp(this.glArray[1] + (1 - this.glArray[1]) * scale, 0, 1);
this.glArray[2] = clamp(this.glArray[2] + (1 - this.glArray[2]) * scale, 0, 1);
return this;
}
/**
* Generate random r,g,b values for this color object
* @param {number} [min=0] - minimum value for the random range
* @param {number} [max=255] - maxmium value for the random range
* @returns {Color} Reference to this object for method chaining
*/
random(min = 0, max = 255) {
if (min < 0) {
min = 0;
}
if (max > 255) {
max = 255;
}
return this.setColor(
random(min, max),
random(min, max),
random(min, max),
this.alpha
);
}
/**
* Return true if the r,g,b,a values of this color are equal with the
* given one.
* @param {Color} color
* @returns {boolean}
*/
equals(color) {
return (
(this.glArray[0] === color.glArray[0]) &&
(this.glArray[1] === color.glArray[1]) &&
(this.glArray[2] === color.glArray[2]) &&
(this.glArray[3] === color.glArray[3])
);
}
/**
* Parse a CSS color string and set this color to the corresponding
* r,g,b values
* @param {string} cssColor
* @returns {Color} Reference to this object for method chaining
*/
parseCSS(cssColor) {
// TODO : Memoize this function by caching its input
if (cssToRGB.has(cssColor)) {
return this.setColor.apply(this, cssToRGB.get(cssColor));
}
return this.parseRGB(cssColor);
}
/**
* Parse an RGB or RGBA CSS color string
* @param {string} rgbColor
* @returns {Color} Reference to this object for method chaining
*/
parseRGB(rgbColor) {
// TODO : Memoize this function by caching its input
let match = rgbaRx.exec(rgbColor);
if (match) {
return this.setColor(+match[1], +match[2], +match[3], +match[5]);
}
return this.parseHex(rgbColor);
}
/**
* Parse a Hex color ("#RGB", "#RGBA" or "#RRGGBB", "#RRGGBBAA" format) and set this color to
* the corresponding r,g,b,a values
* @param {string} hexColor
* @param {boolean} [argb = false] - true if format is #ARGB, or #AARRGGBB (as opposed to #RGBA or #RGGBBAA)
* @returns {Color} Reference to this object for method chaining
*/
parseHex(hexColor, argb = false) {
// TODO : Memoize this function by caching its input
let match;
if ((match = hex8Rx.exec(hexColor))) {
// #AARRGGBB or #RRGGBBAA
return this.setColor(
parseInt(match[argb === false ? 1 : 2], 16), // r
parseInt(match[argb === false ? 2 : 3], 16), // g
parseInt(match[argb === false ? 3 : 4], 16), // b
(clamp(parseInt(match[argb === false ? 4 : 1], 16), 0, 255) / 255.0).toFixed(1) // a
);
}
if ((match = hex6Rx.exec(hexColor))) {
// #RRGGBB
return this.setColor(
parseInt(match[1], 16),
parseInt(match[2], 16),
parseInt(match[3], 16)
);
}
if ((match = hex4Rx.exec(hexColor))) {
// #ARGB or #RGBA
let r = match[argb === false ? 1 : 2];
let g = match[argb === false ? 2 : 3];
let b = match[argb === false ? 3 : 4];
let a = match[argb === false ? 4 : 1];
return this.setColor(
parseInt(r + r, 16), // r
parseInt(g + g, 16), // g
parseInt(b + b, 16), // b
(clamp(parseInt(a + a, 16), 0, 255) / 255.0).toFixed(1) // a
);
}
if ((match = hex3Rx.exec(hexColor))) {
// #RGB
return this.setColor(
parseInt(match[1] + match[1], 16),
parseInt(match[2] + match[2], 16),
parseInt(match[3] + match[3], 16)
);
}
throw new Error(
"invalid parameter: " + hexColor
);
}
/**
* Pack this color RGB components into a Uint32 ARGB representation
* @param {number} [alpha=1.0] - alpha value [0.0 .. 1.0]
* @returns {number}
*/
toUint32(alpha = 1.0) {
const a = this.glArray;
const ur = (a[0] * 255) >> 0;
const ug = (a[1] * 255) >> 0;
const ub = (a[2] * 255) >> 0;
return (((alpha * 255) >> 0) << 24) | (ur << 16) | (ug << 8) | ub;
}
/**
* return an Float Array representation of this object
* @returns {Float32Array}
*/
toArray() {
return this.glArray;
}
/**
* return the color in "#RRGGBB" format
* @returns {string}
*/
toHex() {
// TODO : Memoize this function by caching its result until any of
// the r,g,b,a values are changed
return "#" + toHex(this.r) + toHex(this.g) + toHex(this.b);
}
/**
* Get the color in "#RRGGBBAA" format
* @returns {string}
*/
toHex8(alpha = this.alpha) {
// TODO : Memoize this function by caching its result until any of
// the r,g,b,a values are changed
return "#" + toHex(this.r) + toHex(this.g) + toHex(this.b) + toHex(alpha * 255);
}
/**
* Get the color in "rgb(R,G,B)" format
* @returns {string}
*/
toRGB() {
// TODO : Memoize this function by caching its result until any of
// the r,g,b,a values are changed
return "rgb(" +
this.r + "," +
this.g + "," +
this.b +
")";
}
/**
* Get the color in "rgba(R,G,B,A)" format
* @param {number} [alpha=1.0] - alpha value [0.0 .. 1.0]
* @returns {string}
*/
toRGBA(alpha = this.alpha) {
// TODO : Memoize this function by caching its result until any of
// the r,g,b,a values are changed
return "rgba(" +
this.r + "," +
this.g + "," +
this.b + "," +
alpha +
")";
}
}