1/* 2* Copyright (C) 2022-2023 Huawei Device Co., Ltd. 3* Licensed under the Apache License, Version 2.0 (the "License"); 4* you may not use this file except in compliance with the License. 5* You may obtain a copy of the License at 6* 7* http://www.apache.org/licenses/LICENSE-2.0 8* 9* Unless required by applicable law or agreed to in writing, software 10* distributed under the License is distributed on an "AS IS" BASIS, 11* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12* See the License for the specific language governing permissions and 13* limitations under the License. 14*/ 15 16/** 17 * @file 18 * @kit ArkGraphics2D 19 * @arkts 1.1&1.2 20 */ 21 22/** 23 * Color space manager. 24 * 25 * @namespace colorSpaceManager 26 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 27 * @since 9 28 */ 29/** 30 * Color space manager. 31 * 32 * @namespace colorSpaceManager 33 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 34 * @crossplatform 35 * @since 11 36 */ 37/** 38 * Color space manager. 39 * 40 * @namespace colorSpaceManager 41 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 42 * @crossplatform 43 * @atomicservice 44 * @since arkts {'1.1':'12', '1.2':'20'} 45 * @arkts 1.1&1.2 46 */ 47declare namespace colorSpaceManager { 48 /** 49 * Enumerates color space types. 50 * @enum { number } ColorSpace 51 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 52 * @since 9 53 */ 54 /** 55 * Enumerates color space types. 56 * @enum { number } ColorSpace 57 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 58 * @crossplatform 59 * @since 11 60 */ 61 /** 62 * Enumerates color space types. 63 * @enum { number } ColorSpace 64 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 65 * @crossplatform 66 * @atomicservice 67 * @since arkts{ '1.1':'12','1.2':'20'} 68 * @arkts 1.1&1.2 69 */ 70 enum ColorSpace { 71 /** 72 * Indicates an unknown color space. 73 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 74 * @since 9 75 */ 76 /** 77 * Indicates an unknown color space. 78 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 79 * @crossplatform 80 * @since 11 81 */ 82 /** 83 * Indicates an unknown color space. 84 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 85 * @crossplatform 86 * @atomicservice 87 * @since arkts {'1.1':'12', '1.2':'20'} 88 * @arkts 1.1&1.2 89 */ 90 UNKNOWN = 0, 91 92 /** 93 * Indicates the color space based on Adobe RGB (1998). 94 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 95 * @since 9 96 */ 97 /** 98 * Indicates the color space based on Adobe RGB (1998). 99 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 100 * @crossplatform 101 * @since 11 102 */ 103 /** 104 * Indicates the color space based on Adobe RGB (1998). 105 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 106 * @crossplatform 107 * @atomicservice 108 * @since arkts {'1.1':'12', '1.2':'20'} 109 * @arkts 1.1&1.2 110 */ 111 ADOBE_RGB_1998 = 1, 112 113 /** 114 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 115 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 116 * @since 9 117 */ 118 /** 119 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 120 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 121 * @crossplatform 122 * @since 11 123 */ 124 /** 125 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 126 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 127 * @crossplatform 128 * @atomicservice 129 * @since arkts {'1.1':'12', '1.2':'20'} 130 * @arkts 1.1&1.2 131 */ 132 DCI_P3 = 2, 133 134 /** 135 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 136 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 137 * @since 9 138 */ 139 /** 140 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 141 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 142 * @crossplatform 143 * @since 11 144 */ 145 /** 146 * Indicates the color space based on SMPTE RP 431-2-2007 and IEC 61966-2.1:1999. 147 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 148 * @crossplatform 149 * @atomicservice 150 * @since arkts {'1.1':'12', '1.2':'20'} 151 * @arkts 1.1&1.2 152 */ 153 DISPLAY_P3 = 3, 154 155 /** 156 * Indicates the standard red green blue (SRGB) color space based on IEC 61966-2.1:1999. 157 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 158 * @since 9 159 */ 160 /** 161 * Indicates the standard red green blue (SRGB) color space based on IEC 61966-2.1:1999. 162 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 163 * @crossplatform 164 * @since 11 165 */ 166 /** 167 * Indicates the standard red green blue (SRGB) color space based on IEC 61966-2.1:1999. 168 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 169 * @crossplatform 170 * @atomicservice 171 * @since arkts {'1.1':'12', '1.2':'20'} 172 * @arkts 1.1&1.2 173 */ 174 SRGB = 4, 175 176 /** 177 * Indicates the color space based on ITU-R BT.709. 178 * PRIMARIES_BT709 | TRANSFUNC_BT709 | RANGE_FULL 179 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 180 * @crossplatform 181 * @since 11 182 */ 183 /** 184 * Indicates the color space based on ITU-R BT.709. 185 * PRIMARIES_BT709 | TRANSFUNC_BT709 | RANGE_FULL 186 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 187 * @crossplatform 188 * @atomicservice 189 * @since arkts {'1.1':'12', '1.2':'20'} 190 * @arkts 1.1&1.2 191 */ 192 BT709 = 6, 193 194 /** 195 * Indicates the color space based on ITU-R BT.601. 196 * PRIMARIES_BT601_P | TRANSFUNC_BT709 | RANGE_FULL 197 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 198 * @crossplatform 199 * @since 11 200 */ 201 /** 202 * Indicates the color space based on ITU-R BT.601. 203 * PRIMARIES_BT601_P | TRANSFUNC_BT709 | RANGE_FULL 204 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 205 * @crossplatform 206 * @atomicservice 207 * @since arkts {'1.1':'12', '1.2':'20'} 208 * @arkts 1.1&1.2 209 */ 210 BT601_EBU = 7, 211 212 /** 213 * Indicates the color space based on ITU-R BT.601. 214 * PRIMARIES_BT601_N | TRANSFUNC_BT709 | RANGE_FULL 215 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 216 * @crossplatform 217 * @since 11 218 */ 219 /** 220 * Indicates the color space based on ITU-R BT.601. 221 * PRIMARIES_BT601_N | TRANSFUNC_BT709 | RANGE_FULL 222 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 223 * @crossplatform 224 * @atomicservice 225 * @since arkts {'1.1':'12', '1.2':'20'} 226 * @arkts 1.1&1.2 227 */ 228 BT601_SMPTE_C = 8, 229 230 /** 231 * Indicates the color space based on ITU-R BT.2020. 232 * PRIMARIES_BT2020 | TRANSFUNC_HLG | RANGE_FULL 233 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 234 * @crossplatform 235 * @since 11 236 */ 237 /** 238 * Indicates the color space based on ITU-R BT.2020. 239 * PRIMARIES_BT2020 | TRANSFUNC_HLG | RANGE_FULL 240 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 241 * @crossplatform 242 * @atomicservice 243 * @since arkts {'1.1':'12', '1.2':'20'} 244 * @arkts 1.1&1.2 245 */ 246 BT2020_HLG = 9, 247 248 /** 249 * Indicates the color space based on ITU-R BT.2020. 250 * PRIMARIES_BT2020 | TRANSFUNC_PQ | RANGE_FULL 251 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 252 * @crossplatform 253 * @since 11 254 */ 255 /** 256 * Indicates the color space based on ITU-R BT.2020. 257 * PRIMARIES_BT2020 | TRANSFUNC_PQ | RANGE_FULL 258 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 259 * @crossplatform 260 * @atomicservice 261 * @since arkts {'1.1':'12', '1.2':'20'} 262 * @arkts 1.1&1.2 263 */ 264 BT2020_PQ = 10, 265 266 /** 267 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_FULL 268 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 269 * @crossplatform 270 * @since 11 271 */ 272 /** 273 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_FULL 274 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 275 * @crossplatform 276 * @atomicservice 277 * @since arkts {'1.1':'12', '1.2':'20'} 278 * @arkts 1.1&1.2 279 */ 280 P3_HLG = 11, 281 282 /** 283 * PRIMARIES_P3_D65 | TRANSFUNC_PQ | RANGE_FULL 284 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 285 * @crossplatform 286 * @since 11 287 */ 288 /** 289 * PRIMARIES_P3_D65 | TRANSFUNC_PQ | RANGE_FULL 290 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 291 * @crossplatform 292 * @atomicservice 293 * @since arkts {'1.1':'12', '1.2':'20'} 294 * @arkts 1.1&1.2 295 */ 296 P3_PQ = 12, 297 298 /** 299 * PRIMARIES_ADOBE_RGB | TRANSFUNC_ADOBE_RGB | RANGE_LIMIT 300 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 301 * @crossplatform 302 * @since 11 303 */ 304 /** 305 * PRIMARIES_ADOBE_RGB | TRANSFUNC_ADOBE_RGB | RANGE_LIMIT 306 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 307 * @crossplatform 308 * @atomicservice 309 * @since arkts {'1.1':'12', '1.2':'20'} 310 * @arkts 1.1&1.2 311 */ 312 ADOBE_RGB_1998_LIMIT = 13, 313 314 /** 315 * PRIMARIES_P3_D65 | TRANSFUNC_SRGB | RANGE_LIMIT 316 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 317 * @crossplatform 318 * @since 11 319 */ 320 /** 321 * PRIMARIES_P3_D65 | TRANSFUNC_SRGB | RANGE_LIMIT 322 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 323 * @crossplatform 324 * @atomicservice 325 * @since arkts {'1.1':'12', '1.2':'20'} 326 * @arkts 1.1&1.2 327 */ 328 DISPLAY_P3_LIMIT = 14, 329 330 /** 331 * PRIMARIES_SRGB | TRANSFUNC_SRGB | RANGE_LIMIT 332 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 333 * @crossplatform 334 * @since 11 335 */ 336 /** 337 * PRIMARIES_SRGB | TRANSFUNC_SRGB | RANGE_LIMIT 338 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 339 * @crossplatform 340 * @atomicservice 341 * @since arkts {'1.1':'12', '1.2':'20'} 342 * @arkts 1.1&1.2 343 */ 344 SRGB_LIMIT = 15, 345 346 /** 347 * PRIMARIES_BT709 | TRANSFUNC_BT709 | RANGE_LIMIT 348 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 349 * @crossplatform 350 * @since 11 351 */ 352 /** 353 * PRIMARIES_BT709 | TRANSFUNC_BT709 | RANGE_LIMIT 354 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 355 * @crossplatform 356 * @atomicservice 357 * @since arkts {'1.1':'12', '1.2':'20'} 358 * @arkts 1.1&1.2 359 */ 360 BT709_LIMIT = 16, 361 362 /** 363 * PRIMARIES_BT601_P | TRANSFUNC_BT709 | RANGE_LIMIT 364 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 365 * @crossplatform 366 * @since 11 367 */ 368 /** 369 * PRIMARIES_BT601_P | TRANSFUNC_BT709 | RANGE_LIMIT 370 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 371 * @crossplatform 372 * @atomicservice 373 * @since arkts {'1.1':'12', '1.2':'20'} 374 * @arkts 1.1&1.2 375 */ 376 BT601_EBU_LIMIT = 17, 377 378 /** 379 * PRIMARIES_BT601_N | TRANSFUNC_BT709 | RANGE_LIMIT 380 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 381 * @crossplatform 382 * @since 11 383 */ 384 /** 385 * PRIMARIES_BT601_N | TRANSFUNC_BT709 | RANGE_LIMIT 386 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 387 * @crossplatform 388 * @atomicservice 389 * @since arkts {'1.1':'12', '1.2':'20'} 390 * @arkts 1.1&1.2 391 */ 392 BT601_SMPTE_C_LIMIT = 18, 393 394 /** 395 * PRIMARIES_BT2020 | TRANSFUNC_HLG | RANGE_LIMIT 396 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 397 * @crossplatform 398 * @since 11 399 */ 400 /** 401 * PRIMARIES_BT2020 | TRANSFUNC_HLG | RANGE_LIMIT 402 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 403 * @crossplatform 404 * @atomicservice 405 * @since arkts {'1.1':'12', '1.2':'20'} 406 * @arkts 1.1&1.2 407 */ 408 BT2020_HLG_LIMIT = 19, 409 410 /** 411 * PRIMARIES_BT2020 | TRANSFUNC_PQ | RANGE_LIMIT 412 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 413 * @crossplatform 414 * @since 11 415 */ 416 /** 417 * PRIMARIES_BT2020 | TRANSFUNC_PQ | RANGE_LIMIT 418 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 419 * @crossplatform 420 * @atomicservice 421 * @since arkts {'1.1':'12', '1.2':'20'} 422 * @arkts 1.1&1.2 423 */ 424 BT2020_PQ_LIMIT = 20, 425 426 /** 427 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_LIMIT 428 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 429 * @crossplatform 430 * @since 11 431 */ 432 /** 433 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_LIMIT 434 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 435 * @crossplatform 436 * @atomicservice 437 * @since arkts {'1.1':'12', '1.2':'20'} 438 * @arkts 1.1&1.2 439 */ 440 P3_HLG_LIMIT = 21, 441 442 /** 443 * PRIMARIES_P3_D65 | TRANSFUNC_PQ | RANGE_LIMIT 444 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 445 * @crossplatform 446 * @since 11 447 */ 448 /** 449 * PRIMARIES_P3_D65 | TRANSFUNC_PQ | RANGE_LIMIT 450 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 451 * @crossplatform 452 * @atomicservice 453 * @since arkts {'1.1':'12', '1.2':'20'} 454 * @arkts 1.1&1.2 455 */ 456 P3_PQ_LIMIT = 22, 457 458 /** 459 * PRIMARIES_P3_D65 | TRANSFUNC_LINEAR 460 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 461 * @crossplatform 462 * @since 11 463 */ 464 /** 465 * PRIMARIES_P3_D65 | TRANSFUNC_LINEAR 466 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 467 * @crossplatform 468 * @atomicservice 469 * @since arkts {'1.1':'12', '1.2':'20'} 470 * @arkts 1.1&1.2 471 */ 472 LINEAR_P3 = 23, 473 474 /** 475 * PRIMARIES_SRGB | TRANSFUNC_LINEAR 476 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 477 * @crossplatform 478 * @since 11 479 */ 480 /** 481 * PRIMARIES_SRGB | TRANSFUNC_LINEAR 482 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 483 * @crossplatform 484 * @atomicservice 485 * @since arkts {'1.1':'12', '1.2':'20'} 486 * @arkts 1.1&1.2 487 */ 488 LINEAR_SRGB = 24, 489 490 /** 491 * PRIMARIES_BT709 | TRANSFUNC_LINEAR 492 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 493 * @crossplatform 494 * @since 11 495 */ 496 /** 497 * PRIMARIES_BT709 | TRANSFUNC_LINEAR 498 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 499 * @crossplatform 500 * @atomicservice 501 * @since arkts {'1.1':'12', '1.2':'20'} 502 * @arkts 1.1&1.2 503 */ 504 LINEAR_BT709 = LINEAR_SRGB, 505 506 /** 507 * PRIMARIES_BT2020 | TRANSFUNC_LINEAR 508 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 509 * @crossplatform 510 * @since 11 511 */ 512 /** 513 * PRIMARIES_BT2020 | TRANSFUNC_LINEAR 514 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 515 * @crossplatform 516 * @atomicservice 517 * @since arkts {'1.1':'12', '1.2':'20'} 518 * @arkts 1.1&1.2 519 */ 520 LINEAR_BT2020 = 25, 521 522 /** 523 * PRIMARIES_SRGB | TRANSFUNC_SRGB | RANGE_FULL 524 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 525 * @crossplatform 526 * @since 11 527 */ 528 /** 529 * PRIMARIES_SRGB | TRANSFUNC_SRGB | RANGE_FULL 530 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 531 * @crossplatform 532 * @atomicservice 533 * @since arkts {'1.1':'12', '1.2':'20'} 534 * @arkts 1.1&1.2 535 */ 536 DISPLAY_SRGB = SRGB, 537 538 /** 539 * PRIMARIES_P3_D65 | TRANSFUNC_SRGB | RANGE_FULL 540 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 541 * @crossplatform 542 * @since 11 543 */ 544 /** 545 * PRIMARIES_P3_D65 | TRANSFUNC_SRGB | RANGE_FULL 546 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 547 * @crossplatform 548 * @atomicservice 549 * @since arkts {'1.1':'12', '1.2':'20'} 550 * @arkts 1.1&1.2 551 */ 552 DISPLAY_P3_SRGB = DISPLAY_P3, 553 554 /** 555 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_FULL 556 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 557 * @crossplatform 558 * @since 11 559 */ 560 /** 561 * PRIMARIES_P3_D65 | TRANSFUNC_HLG | RANGE_FULL 562 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 563 * @crossplatform 564 * @atomicservice 565 * @since arkts {'1.1':'12', '1.2':'20'} 566 * @arkts 1.1&1.2 567 */ 568 DISPLAY_P3_HLG = P3_HLG, 569 570 /** 571 * PRIMARIES_DISPLAY_P3 | TRANSFUNC_PQ | RANGE_FULL 572 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 573 * @crossplatform 574 * @since 11 575 */ 576 /** 577 * PRIMARIES_DISPLAY_P3 | TRANSFUNC_PQ | RANGE_FULL 578 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 579 * @crossplatform 580 * @atomicservice 581 * @since arkts {'1.1':'12', '1.2':'20'} 582 * @arkts 1.1&1.2 583 */ 584 DISPLAY_P3_PQ = P3_PQ, 585 586 /** 587 * PRIMARIES_BT2020 | TRANSFUNC_LOG 588 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 589 * @since 18 590 */ 591 H_LOG = 26, 592 593 /** 594 * PRIMARIES_BT2020 | TRANSFUNC_SRGB | RANGE_FULL 595 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 596 * @since 20 597 */ 598 DISPLAY_BT2020_SRGB = 27, 599 600 /** 601 * Indicates a customized color space. 602 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 603 * @since 9 604 */ 605 /** 606 * Indicates a customized color space. 607 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 608 * @crossplatform 609 * @since 11 610 */ 611 /** 612 * Indicates a customized color space. 613 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 614 * @crossplatform 615 * @atomicservice 616 * @since arkts {'1.1':'12', '1.2':'20'} 617 * @arkts 1.1&1.2 618 */ 619 CUSTOM = 5, 620 } 621 622 /** 623 * Describes the primary colors red, green, blue and white point coordinated as (x, y) 624 * in color space, in terms of real world chromaticities. 625 * @typedef ColorSpacePrimaries 626 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 627 * @since 9 628 */ 629 /** 630 * Describes the primary colors red, green, blue and white point coordinated as (x, y) 631 * in color space, in terms of real world chromaticities. 632 * @typedef ColorSpacePrimaries 633 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 634 * @crossplatform 635 * @since arkts {'1.1':'11', '1.2':'20'} 636 * @arkts 1.1&1.2 637 */ 638 interface ColorSpacePrimaries { 639 /** 640 * Coordinate value x of red color 641 * @type { number } 642 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 643 * @since 9 644 */ 645 /** 646 * Coordinate value x of red color 647 * @type { number } 648 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 649 * @crossplatform 650 * @since arkts{ '1.1':'11','1.2':'20'} 651 * @arkts 1.1&1.2 652 */ 653 redX: number; 654 655 /** 656 * Coordinate value y of red color 657 * @type { number } 658 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 659 * @since 9 660 */ 661 /** 662 * Coordinate value y of red color 663 * @type { number } 664 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 665 * @crossplatform 666 * @since arkts{ '1.1':'11','1.2':'20'} 667 * @arkts 1.1&1.2 668 */ 669 redY: number; 670 671 /** 672 * Coordinate value x of green color 673 * @type { number } 674 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 675 * @since 9 676 */ 677 /** 678 * Coordinate value x of green color 679 * @type { number } 680 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 681 * @crossplatform 682 * @since arkts{ '1.1':'11','1.2':'20'} 683 * @arkts 1.1&1.2 684 */ 685 greenX: number; 686 687 /** 688 * Coordinate value y of green color 689 * @type { number } 690 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 691 * @since 9 692 */ 693 /** 694 * Coordinate value y of green color 695 * @type { number } 696 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 697 * @crossplatform 698 * @since arkts{ '1.1':'11','1.2':'20'} 699 * @arkts 1.1&1.2 700 */ 701 greenY: number; 702 703 /** 704 * Coordinate value x of blue color 705 * @type { number } 706 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 707 * @since 9 708 */ 709 /** 710 * Coordinate value x of blue color 711 * @type { number } 712 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 713 * @crossplatform 714 * @since arkts{ '1.1':'11','1.2':'20'} 715 * @arkts 1.1&1.2 716 */ 717 blueX: number; 718 719 /** 720 * Coordinate value y of blue color 721 * @type { number } 722 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 723 * @since 9 724 */ 725 /** 726 * Coordinate value y of blue color 727 * @type { number } 728 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 729 * @crossplatform 730 * @since arkts{ '1.1':'11','1.2':'20'} 731 * @arkts 1.1&1.2 732 */ 733 blueY: number; 734 735 /** 736 * Coordinate value x of white point 737 * @type { number } 738 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 739 * @since 9 740 */ 741 /** 742 * Coordinate value x of white point 743 * @type { number } 744 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 745 * @crossplatform 746 * @since arkts{ '1.1':'11','1.2':'20'} 747 * @arkts 1.1&1.2 748 */ 749 whitePointX: number; 750 751 /** 752 * Coordinate value y of white point 753 * @type { number } 754 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 755 * @since 9 756 */ 757 /** 758 * Coordinate value y of white point 759 * @type { number } 760 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 761 * @crossplatform 762 * @since arkts{ '1.1':'11','1.2':'20'} 763 * @arkts 1.1&1.2 764 */ 765 whitePointY: number; 766 } 767 768 /** 769 * Defines a color space object and manages its key information 770 * @interface ColorSpaceManager 771 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 772 * @since 9 773 */ 774 /** 775 * Defines a color space object and manages its key information 776 * @interface ColorSpaceManager 777 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 778 * @crossplatform 779 * @since arkts {'1.1':'11', '1.2':'20'} 780 * @arkts 1.1&1.2 781 */ 782 interface ColorSpaceManager { 783 /** 784 * Get the name of color space type. 785 * @returns { ColorSpace } Returns the name of color space type. 786 * @throws { BusinessError } 18600001 - The parameter value is abnormal. 787 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 788 * @since 9 789 */ 790 /** 791 * Get the name of color space type. 792 * @returns { ColorSpace } Returns the name of color space type. 793 * @throws { BusinessError } 18600001 - The parameter value is abnormal. 794 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 795 * @crossplatform 796 * @since arkts {'1.1':'11', '1.2':'20'} 797 * @arkts 1.1&1.2 798 */ 799 getColorSpaceName(): ColorSpace; 800 801 /** 802 * Get white point(x, y) of color space. 803 * @returns { Array<number> } Returns the white point value of color space. 804 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 805 * color space type enum values to directly create a colorSpaceManager object. 806 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 807 * @since 9 808 */ 809 /** 810 * Get white point(x, y) of color space. 811 * @returns { Array<number> } Returns the white point value of color space. 812 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 813 * color space type enum values to directly create a colorSpaceManager object. 814 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 815 * @crossplatform 816 * @since arkts{ '1.1':'11','1.2':'20'} 817 * @arkts 1.1&1.2 818 */ 819 getWhitePoint(): Array<number>; 820 821 /** 822 * Get gamma value of color space. 823 * @returns { number } Returns the gamma value of color space. 824 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 825 * color space type enum values to directly create a colorSpaceManager object. 826 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 827 * @since 9 828 */ 829 /** 830 * Get gamma value of color space. 831 * @returns { number } Returns the gamma value of color space. 832 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 833 * color space type enum values to directly create a colorSpaceManager object. 834 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 835 * @crossplatform 836 * @since arkts{ '1.1':'11','1.2':'20'} 837 * @arkts 1.1&1.2 838 */ 839 getGamma(): number; 840 } 841 842 /** 843 * Create a color space manager by provided color space type. 844 * @param { ColorSpace } colorSpaceName - Indicates the type of color space 845 * @returns { ColorSpaceManager } Returns a color space manager object created by provided type. 846 * @throws { BusinessError } 401 - Parameter error. Possible cause: 1.Incorrect parameter type. 847 * 2.Parameter verification failed. 848 * @throws { BusinessError } 18600001 - The parameter value is abnormal. 849 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 850 * @since 9 851 */ 852 /** 853 * Create a color space manager by provided color space type. 854 * @param { ColorSpace } colorSpaceName - Indicates the type of color space 855 * @returns { ColorSpaceManager } Returns a color space manager object created by provided type. 856 * @throws { BusinessError } 401 - Parameter error. Possible cause: 1.Incorrect parameter type. 857 * 2.Parameter verification failed. 858 * @throws { BusinessError } 18600001 - The parameter value is abnormal. 859 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 860 * @crossplatform 861 * @since arkts {'1.1':'11', '1.2':'20'} 862 * @arkts 1.1&1.2 863 */ 864 function create(colorSpaceName: ColorSpace): ColorSpaceManager; 865 866 /** 867 * Create a customized color space manager by its color primaries and gamma value 868 * @param { ColorSpacePrimaries } primaries - Indicates the customized color primaries 869 * @param { number } gamma - Indicates display gamma value 870 * @returns { ColorSpaceManager } Returns a color space manager object created by customized parameters. 871 * @throws { BusinessError } 401 - Parameter error. Possible cause: 1.Incorrect parameter type. 872 * 2.Parameter verification failed. 873 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 874 * color space type enum values to directly create a colorSpaceManager object. 875 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 876 * @since 9 877 */ 878 /** 879 * Create a customized color space manager by its color primaries and gamma value 880 * @param { ColorSpacePrimaries } primaries - Indicates the customized color primaries 881 * @param { number } gamma - Indicates display gamma value 882 * @returns { ColorSpaceManager } Returns a color space manager object created by customized parameters. 883 * @throws { BusinessError } 401 - Parameter error. Possible cause: 1.Incorrect parameter type. 884 * 2.Parameter verification failed. 885 * @throws { BusinessError } 18600001 - Invalid parameter value. Possible cause: Used UNKNOWN or CUSTOM 886 * color space type enum values to directly create a colorSpaceManager object. 887 * @syscap SystemCapability.Graphic.Graphic2D.ColorManager.Core 888 * @crossplatform 889 * @since arkts{ '1.1':'11','1.2':'20'} 890 * @arkts 1.1&1.2 891 */ 892 function create(primaries: ColorSpacePrimaries, gamma: number): ColorSpaceManager; 893} 894 895export default colorSpaceManager;