Profile.cpp 86 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808
  1. /*
  2. * Copyright (c) 2022-2023, Nico Weber <thakis@chromium.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <AK/Endian.h>
  7. #include <LibGfx/CIELAB.h>
  8. #include <LibGfx/CMYKBitmap.h>
  9. #include <LibGfx/ICC/BinaryFormat.h>
  10. #include <LibGfx/ICC/Profile.h>
  11. #include <LibGfx/ICC/Tags.h>
  12. #include <LibGfx/Matrix3x3.h>
  13. #include <math.h>
  14. #include <time.h>
  15. // V2 spec: https://color.org/specification/ICC.1-2001-04.pdf
  16. // V4 spec: https://color.org/specification/ICC.1-2022-05.pdf
  17. namespace Gfx::ICC {
  18. namespace {
  19. ErrorOr<DateTime> parse_date_time_number(DateTimeNumber const& date_time)
  20. {
  21. return DateTime {
  22. .year = date_time.year,
  23. .month = date_time.month,
  24. .day = date_time.day,
  25. .hours = date_time.hours,
  26. .minutes = date_time.minutes,
  27. .seconds = date_time.seconds,
  28. };
  29. }
  30. ErrorOr<u32> parse_size(ICCHeader const& header, ReadonlyBytes icc_bytes)
  31. {
  32. // ICC v4, 7.2.2 Profile size field
  33. // "The value in the profile size field shall be the exact size obtained by combining the profile header,
  34. // the tag table, and the tagged element data, including the pad bytes for the last tag."
  35. // Valid files have enough data for profile header and tag table entry count.
  36. if (header.profile_size < sizeof(ICCHeader) + sizeof(u32))
  37. return Error::from_string_literal("ICC::Profile: Profile size too small");
  38. if (header.profile_size > icc_bytes.size())
  39. return Error::from_string_literal("ICC::Profile: Profile size larger than input data");
  40. // ICC v4, 7.1.2:
  41. // "NOTE 1 This implies that the length is required to be a multiple of four."
  42. // The ICC v2 spec doesn't have this note. It instead has:
  43. // ICC v2, 6.2.2 Offset:
  44. // "All tag data is required to start on a 4-byte boundary"
  45. // And indeed, there are files in the wild where the last tag has a size that isn't a multiple of four,
  46. // resulting in an ICC file whose size isn't a multiple of four either.
  47. if (header.profile_version_major >= 4 && header.profile_size % 4 != 0)
  48. return Error::from_string_literal("ICC::Profile: Profile size not a multiple of four");
  49. return header.profile_size;
  50. }
  51. Optional<PreferredCMMType> parse_preferred_cmm_type(ICCHeader const& header)
  52. {
  53. // ICC v4, 7.2.3 Preferred CMM type field
  54. // "This field may be used to identify the preferred CMM to be used.
  55. // If used, it shall match a CMM type signature registered in the ICC Tag Registry"
  56. // https://www.color.org/signatures2.xalter currently links to
  57. // https://www.color.org/registry/signature/TagRegistry-2021-03.pdf, which contains
  58. // some CMM signatures.
  59. // This requirement is often honored in practice, but not always. For example,
  60. // JPEGs exported in Adobe Lightroom contain profiles that set this to 'Lino',
  61. // which is not present in the "CMM Signatures" table in that PDF.
  62. // "If no preferred CMM is identified, this field shall be set to zero (00000000h)."
  63. if (header.preferred_cmm_type == PreferredCMMType { 0 })
  64. return {};
  65. return header.preferred_cmm_type;
  66. }
  67. ErrorOr<Version> parse_version(ICCHeader const& header)
  68. {
  69. // ICC v4, 7.2.4 Profile version field
  70. if (header.profile_version_zero != 0)
  71. return Error::from_string_literal("ICC::Profile: Reserved version bytes not zero");
  72. return Version(header.profile_version_major, header.profile_version_minor_bugfix);
  73. }
  74. ErrorOr<DeviceClass> parse_device_class(ICCHeader const& header)
  75. {
  76. // ICC v4, 7.2.5 Profile/device class field
  77. switch (header.profile_device_class) {
  78. case DeviceClass::InputDevice:
  79. case DeviceClass::DisplayDevice:
  80. case DeviceClass::OutputDevice:
  81. case DeviceClass::DeviceLink:
  82. case DeviceClass::ColorSpace:
  83. case DeviceClass::Abstract:
  84. case DeviceClass::NamedColor:
  85. return header.profile_device_class;
  86. }
  87. return Error::from_string_literal("ICC::Profile: Invalid device class");
  88. }
  89. ErrorOr<ColorSpace> parse_color_space(ColorSpace color_space)
  90. {
  91. // ICC v4, Table 19 — Data colour space signatures
  92. switch (color_space) {
  93. case ColorSpace::nCIEXYZ:
  94. case ColorSpace::CIELAB:
  95. case ColorSpace::CIELUV:
  96. case ColorSpace::YCbCr:
  97. case ColorSpace::CIEYxy:
  98. case ColorSpace::RGB:
  99. case ColorSpace::Gray:
  100. case ColorSpace::HSV:
  101. case ColorSpace::HLS:
  102. case ColorSpace::CMYK:
  103. case ColorSpace::CMY:
  104. case ColorSpace::TwoColor:
  105. case ColorSpace::ThreeColor:
  106. case ColorSpace::FourColor:
  107. case ColorSpace::FiveColor:
  108. case ColorSpace::SixColor:
  109. case ColorSpace::SevenColor:
  110. case ColorSpace::EightColor:
  111. case ColorSpace::NineColor:
  112. case ColorSpace::TenColor:
  113. case ColorSpace::ElevenColor:
  114. case ColorSpace::TwelveColor:
  115. case ColorSpace::ThirteenColor:
  116. case ColorSpace::FourteenColor:
  117. case ColorSpace::FifteenColor:
  118. return color_space;
  119. }
  120. return Error::from_string_literal("ICC::Profile: Invalid color space");
  121. }
  122. ErrorOr<ColorSpace> parse_data_color_space(ICCHeader const& header)
  123. {
  124. // ICC v4, 7.2.6 Data colour space field
  125. return parse_color_space(header.data_color_space);
  126. }
  127. ErrorOr<ColorSpace> parse_connection_space(ICCHeader const& header)
  128. {
  129. // ICC v4, 7.2.7 PCS field
  130. // and Annex D
  131. auto space = TRY(parse_color_space(header.profile_connection_space));
  132. if (header.profile_device_class != DeviceClass::DeviceLink && (space != ColorSpace::PCSXYZ && space != ColorSpace::PCSLAB))
  133. return Error::from_string_literal("ICC::Profile: Invalid profile connection space: Non-PCS space on non-DeviceLink profile");
  134. return space;
  135. }
  136. ErrorOr<DateTime> parse_creation_date_time(ICCHeader const& header)
  137. {
  138. // ICC v4, 7.2.8 Date and time field
  139. return parse_date_time_number(header.profile_creation_time);
  140. }
  141. ErrorOr<void> parse_file_signature(ICCHeader const& header)
  142. {
  143. // ICC v4, 7.2.9 Profile file signature field
  144. if (header.profile_file_signature != ProfileFileSignature)
  145. return Error::from_string_literal("ICC::Profile: profile file signature not 'acsp'");
  146. return {};
  147. }
  148. ErrorOr<Optional<PrimaryPlatform>> parse_primary_platform(ICCHeader const& header)
  149. {
  150. // ICC v4, 7.2.10 Primary platform field
  151. // "If there is no primary platform identified, this field shall be set to zero (00000000h)."
  152. if (header.primary_platform == PrimaryPlatform { 0 })
  153. return OptionalNone {};
  154. switch (header.primary_platform) {
  155. case PrimaryPlatform::Apple:
  156. case PrimaryPlatform::Microsoft:
  157. case PrimaryPlatform::SiliconGraphics:
  158. case PrimaryPlatform::Sun:
  159. return header.primary_platform;
  160. }
  161. return Error::from_string_literal("ICC::Profile: Invalid primary platform");
  162. }
  163. Optional<DeviceManufacturer> parse_device_manufacturer(ICCHeader const& header)
  164. {
  165. // ICC v4, 7.2.12 Device manufacturer field
  166. // "This field may be used to identify a device manufacturer.
  167. // If used the signature shall match the signature contained in the appropriate section of the ICC signature registry found at www.color.org"
  168. // Device manufacturers can be looked up at https://www.color.org/signatureRegistry/index.xalter
  169. // For example: https://www.color.org/signatureRegistry/?entityEntry=APPL-4150504C
  170. // Some icc files use codes not in that registry. For example. D50_XYZ.icc from https://www.color.org/XYZprofiles.xalter
  171. // has its device manufacturer set to 'none', but https://www.color.org/signatureRegistry/?entityEntry=none-6E6F6E65 does not exist.
  172. // "If not used this field shall be set to zero (00000000h)."
  173. if (header.device_manufacturer == DeviceManufacturer { 0 })
  174. return {};
  175. return header.device_manufacturer;
  176. }
  177. Optional<DeviceModel> parse_device_model(ICCHeader const& header)
  178. {
  179. // ICC v4, 7.2.13 Device model field
  180. // "This field may be used to identify a device model.
  181. // If used the signature shall match the signature contained in the appropriate section of the ICC signature registry found at www.color.org"
  182. // Device models can be looked up at https://www.color.org/signatureRegistry/deviceRegistry/index.xalter
  183. // For example: https://www.color.org/signatureRegistry/deviceRegistry/?entityEntry=7FD8-37464438
  184. // Some icc files use codes not in that registry. For example. D50_XYZ.icc from https://www.color.org/XYZprofiles.xalter
  185. // has its device model set to 'none', but https://www.color.org/signatureRegistry/deviceRegistry?entityEntry=none-6E6F6E65 does not exist.
  186. // "If not used this field shall be set to zero (00000000h)."
  187. if (header.device_model == DeviceModel { 0 })
  188. return {};
  189. return header.device_model;
  190. }
  191. ErrorOr<DeviceAttributes> parse_device_attributes(ICCHeader const& header)
  192. {
  193. // ICC v4, 7.2.14 Device attributes field
  194. // "4 to 31": "Reserved (set to binary zero)"
  195. if (header.device_attributes & 0xffff'fff0)
  196. return Error::from_string_literal("ICC::Profile: Device attributes reserved bits not set to 0");
  197. return DeviceAttributes { header.device_attributes };
  198. }
  199. ErrorOr<RenderingIntent> parse_rendering_intent(ICCHeader const& header)
  200. {
  201. // ICC v4, 7.2.15 Rendering intent field
  202. switch (header.rendering_intent) {
  203. case RenderingIntent::Perceptual:
  204. case RenderingIntent::MediaRelativeColorimetric:
  205. case RenderingIntent::Saturation:
  206. case RenderingIntent::ICCAbsoluteColorimetric:
  207. return header.rendering_intent;
  208. }
  209. return Error::from_string_literal("ICC::Profile: Invalid rendering intent");
  210. }
  211. ErrorOr<XYZ> parse_pcs_illuminant(ICCHeader const& header)
  212. {
  213. // ICC v4, 7.2.16 PCS illuminant field
  214. XYZ xyz = (XYZ)header.pcs_illuminant;
  215. /// "The value, when rounded to four decimals, shall be X = 0,9642, Y = 1,0 and Z = 0,8249."
  216. if (round(xyz.X * 10'000) != 9'642 || round(xyz.Y * 10'000) != 10'000 || round(xyz.Z * 10'000) != 8'249)
  217. return Error::from_string_literal("ICC::Profile: Invalid pcs illuminant");
  218. return xyz;
  219. }
  220. Optional<Creator> parse_profile_creator(ICCHeader const& header)
  221. {
  222. // ICC v4, 7.2.17 Profile creator field
  223. // "This field may be used to identify the creator of the profile.
  224. // If used the signature should match the signature contained in the device manufacturer section of the ICC signature registry found at www.color.org."
  225. // This is not always true in practice.
  226. // For example, .icc files in /System/ColorSync/Profiles on macOS 12.6 set this to 'appl', which is a CMM signature, not a device signature (that one would be 'APPL').
  227. // "If not used this field shall be set to zero (00000000h)."
  228. if (header.profile_creator == Creator { 0 })
  229. return {};
  230. return header.profile_creator;
  231. }
  232. template<size_t N>
  233. bool all_bytes_are_zero(const u8 (&bytes)[N])
  234. {
  235. for (u8 byte : bytes) {
  236. if (byte != 0)
  237. return false;
  238. }
  239. return true;
  240. }
  241. ErrorOr<Optional<Crypto::Hash::MD5::DigestType>> parse_profile_id(ICCHeader const& header, ReadonlyBytes icc_bytes)
  242. {
  243. // ICC v4, 7.2.18 Profile ID field
  244. // "A profile ID field value of zero (00h) shall indicate that a profile ID has not been calculated."
  245. if (all_bytes_are_zero(header.profile_id))
  246. return OptionalNone {};
  247. Crypto::Hash::MD5::DigestType id;
  248. static_assert(sizeof(id.data) == sizeof(header.profile_id));
  249. memcpy(id.data, header.profile_id, sizeof(id.data));
  250. auto computed_id = Profile::compute_id(icc_bytes);
  251. if (id != computed_id)
  252. return Error::from_string_literal("ICC::Profile: Invalid profile id");
  253. return id;
  254. }
  255. ErrorOr<void> parse_reserved(ICCHeader const& header)
  256. {
  257. // ICC v4, 7.2.19 Reserved field
  258. // "This field of the profile header is reserved for future ICC definition and shall be set to zero."
  259. if (!all_bytes_are_zero(header.reserved))
  260. return Error::from_string_literal("ICC::Profile: Reserved header bytes are not zero");
  261. return {};
  262. }
  263. }
  264. URL device_manufacturer_url(DeviceManufacturer device_manufacturer)
  265. {
  266. return URL(ByteString::formatted("https://www.color.org/signatureRegistry/?entityEntry={:c}{:c}{:c}{:c}-{:08X}",
  267. device_manufacturer.c0(), device_manufacturer.c1(), device_manufacturer.c2(), device_manufacturer.c3(), device_manufacturer.value));
  268. }
  269. URL device_model_url(DeviceModel device_model)
  270. {
  271. return URL(ByteString::formatted("https://www.color.org/signatureRegistry/deviceRegistry/?entityEntry={:c}{:c}{:c}{:c}-{:08X}",
  272. device_model.c0(), device_model.c1(), device_model.c2(), device_model.c3(), device_model.value));
  273. }
  274. Flags::Flags() = default;
  275. Flags::Flags(u32 bits)
  276. : m_bits(bits)
  277. {
  278. }
  279. DeviceAttributes::DeviceAttributes() = default;
  280. DeviceAttributes::DeviceAttributes(u64 bits)
  281. : m_bits(bits)
  282. {
  283. }
  284. static ErrorOr<void> validate_date_time(DateTime const& date_time)
  285. {
  286. // Returns if a DateTime is valid per ICC V4, 4.2 dateTimeNumber.
  287. // In practice, some profiles contain invalid dates, but we should enforce this for data we write at least.
  288. // "Number of the month (1 to 12)"
  289. if (date_time.month < 1 || date_time.month > 12)
  290. return Error::from_string_literal("ICC::Profile: dateTimeNumber month out of bounds");
  291. // "Number of the day of the month (1 to 31)"
  292. if (date_time.day < 1 || date_time.day > 31)
  293. return Error::from_string_literal("ICC::Profile: dateTimeNumber day out of bounds");
  294. // "Number of hours (0 to 23)"
  295. if (date_time.hours > 23)
  296. return Error::from_string_literal("ICC::Profile: dateTimeNumber hours out of bounds");
  297. // "Number of minutes (0 to 59)"
  298. if (date_time.minutes > 59)
  299. return Error::from_string_literal("ICC::Profile: dateTimeNumber minutes out of bounds");
  300. // "Number of seconds (0 to 59)"
  301. // ICC profiles apparently can't be created during leap seconds (seconds would be 60 there, but the spec doesn't allow that).
  302. if (date_time.seconds > 59)
  303. return Error::from_string_literal("ICC::Profile: dateTimeNumber seconds out of bounds");
  304. return {};
  305. }
  306. ErrorOr<time_t> DateTime::to_time_t() const
  307. {
  308. TRY(validate_date_time(*this));
  309. struct tm tm = {};
  310. tm.tm_year = year - 1900;
  311. tm.tm_mon = month - 1;
  312. tm.tm_mday = day;
  313. tm.tm_hour = hours;
  314. tm.tm_min = minutes;
  315. tm.tm_sec = seconds;
  316. // timegm() doesn't read tm.tm_isdst, tm.tm_wday, and tm.tm_yday, no need to fill them in.
  317. time_t timestamp = timegm(&tm);
  318. if (timestamp == -1)
  319. return Error::from_string_literal("ICC::Profile: dateTimeNumber not representable as timestamp");
  320. return timestamp;
  321. }
  322. ErrorOr<DateTime> DateTime::from_time_t(time_t timestamp)
  323. {
  324. struct tm gmt_tm;
  325. if (gmtime_r(&timestamp, &gmt_tm) == NULL)
  326. return Error::from_string_literal("ICC::Profile: timestamp not representable as DateTimeNumber");
  327. // FIXME: Range-check, using something like `TRY(Checked<u16>(x).try_value())`?
  328. DateTime result {
  329. .year = static_cast<u16>(gmt_tm.tm_year + 1900),
  330. .month = static_cast<u16>(gmt_tm.tm_mon + 1),
  331. .day = static_cast<u16>(gmt_tm.tm_mday),
  332. .hours = static_cast<u16>(gmt_tm.tm_hour),
  333. .minutes = static_cast<u16>(gmt_tm.tm_min),
  334. .seconds = static_cast<u16>(gmt_tm.tm_sec),
  335. };
  336. TRY(validate_date_time(result));
  337. return result;
  338. }
  339. static ErrorOr<ProfileHeader> read_header(ReadonlyBytes bytes)
  340. {
  341. if (bytes.size() < sizeof(ICCHeader))
  342. return Error::from_string_literal("ICC::Profile: Not enough data for header");
  343. ProfileHeader header;
  344. auto raw_header = *bit_cast<ICCHeader const*>(bytes.data());
  345. TRY(parse_file_signature(raw_header));
  346. header.on_disk_size = TRY(parse_size(raw_header, bytes));
  347. header.preferred_cmm_type = parse_preferred_cmm_type(raw_header);
  348. header.version = TRY(parse_version(raw_header));
  349. header.device_class = TRY(parse_device_class(raw_header));
  350. header.data_color_space = TRY(parse_data_color_space(raw_header));
  351. header.connection_space = TRY(parse_connection_space(raw_header));
  352. header.creation_timestamp = TRY(parse_creation_date_time(raw_header));
  353. header.primary_platform = TRY(parse_primary_platform(raw_header));
  354. header.flags = Flags { raw_header.profile_flags };
  355. header.device_manufacturer = parse_device_manufacturer(raw_header);
  356. header.device_model = parse_device_model(raw_header);
  357. header.device_attributes = TRY(parse_device_attributes(raw_header));
  358. header.rendering_intent = TRY(parse_rendering_intent(raw_header));
  359. header.pcs_illuminant = TRY(parse_pcs_illuminant(raw_header));
  360. header.creator = parse_profile_creator(raw_header);
  361. header.id = TRY(parse_profile_id(raw_header, bytes));
  362. TRY(parse_reserved(raw_header));
  363. return header;
  364. }
  365. static ErrorOr<NonnullRefPtr<TagData>> read_tag(ReadonlyBytes bytes, u32 offset_to_beginning_of_tag_data_element, u32 size_of_tag_data_element)
  366. {
  367. // "All tag data elements shall start on a 4-byte boundary (relative to the start of the profile data stream)"
  368. if (offset_to_beginning_of_tag_data_element % 4 != 0)
  369. return Error::from_string_literal("ICC::Profile: Tag data not aligned");
  370. if (static_cast<u64>(offset_to_beginning_of_tag_data_element) + size_of_tag_data_element > bytes.size())
  371. return Error::from_string_literal("ICC::Profile: Tag data out of bounds");
  372. auto tag_bytes = bytes.slice(offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  373. // ICC v4, 9 Tag definitions
  374. // ICC v4, 9.1 General
  375. // "All tags, including private tags, have as their first four bytes a tag signature to identify to profile readers
  376. // what kind of data is contained within a tag."
  377. if (tag_bytes.size() < sizeof(u32))
  378. return Error::from_string_literal("ICC::Profile: Not enough data for tag type");
  379. auto type = tag_type(tag_bytes);
  380. switch (type) {
  381. case ChromaticityTagData::Type:
  382. return ChromaticityTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  383. case CicpTagData::Type:
  384. return CicpTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  385. case CurveTagData::Type:
  386. return CurveTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  387. case Lut16TagData::Type:
  388. return Lut16TagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  389. case Lut8TagData::Type:
  390. return Lut8TagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  391. case LutAToBTagData::Type:
  392. return LutAToBTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  393. case LutBToATagData::Type:
  394. return LutBToATagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  395. case MeasurementTagData::Type:
  396. return MeasurementTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  397. case MultiLocalizedUnicodeTagData::Type:
  398. return MultiLocalizedUnicodeTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  399. case NamedColor2TagData::Type:
  400. return NamedColor2TagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  401. case ParametricCurveTagData::Type:
  402. return ParametricCurveTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  403. case S15Fixed16ArrayTagData::Type:
  404. return S15Fixed16ArrayTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  405. case SignatureTagData::Type:
  406. return SignatureTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  407. case TextDescriptionTagData::Type:
  408. return TextDescriptionTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  409. case TextTagData::Type:
  410. return TextTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  411. case ViewingConditionsTagData::Type:
  412. return ViewingConditionsTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  413. case XYZTagData::Type:
  414. return XYZTagData::from_bytes(tag_bytes, offset_to_beginning_of_tag_data_element, size_of_tag_data_element);
  415. default:
  416. // FIXME: optionally ignore tags of unknown type
  417. return try_make_ref_counted<UnknownTagData>(offset_to_beginning_of_tag_data_element, size_of_tag_data_element, type);
  418. }
  419. }
  420. static ErrorOr<OrderedHashMap<TagSignature, NonnullRefPtr<TagData>>> read_tag_table(ReadonlyBytes bytes)
  421. {
  422. OrderedHashMap<TagSignature, NonnullRefPtr<TagData>> tag_table;
  423. // ICC v4, 7.3 Tag table
  424. // ICC v4, 7.3.1 Overview
  425. // "The tag table acts as a table of contents for the tags and an index into the tag data element in the profiles. It
  426. // shall consist of a 4-byte entry that contains a count of the number of tags in the table followed by a series of 12-
  427. // byte entries with one entry for each tag. The tag table therefore contains 4+12n bytes where n is the number of
  428. // tags contained in the profile. The entries for the tags within the table are not required to be in any particular
  429. // order nor are they required to match the sequence of tag data element within the profile.
  430. // Each 12-byte tag entry following the tag count shall consist of a 4-byte tag signature, a 4-byte offset to define
  431. // the beginning of the tag data element, and a 4-byte entry identifying the length of the tag data element in bytes.
  432. // [...]
  433. // The tag table shall define a contiguous sequence of unique tag elements, with no gaps between the last byte
  434. // of any tag data element referenced from the tag table (inclusive of any necessary additional pad bytes required
  435. // to reach a four-byte boundary) and the byte offset of the following tag element, or the end of the file.
  436. // Duplicate tag signatures shall not be included in the tag table.
  437. // Tag data elements shall not partially overlap, so there shall be no part of any tag data element that falls within
  438. // the range defined for another tag in the tag table."
  439. ReadonlyBytes tag_table_bytes = bytes.slice(sizeof(ICCHeader));
  440. if (tag_table_bytes.size() < sizeof(u32))
  441. return Error::from_string_literal("ICC::Profile: Not enough data for tag count");
  442. auto tag_count = *bit_cast<BigEndian<u32> const*>(tag_table_bytes.data());
  443. tag_table_bytes = tag_table_bytes.slice(sizeof(u32));
  444. if (tag_table_bytes.size() < tag_count * sizeof(TagTableEntry))
  445. return Error::from_string_literal("ICC::Profile: Not enough data for tag table entries");
  446. auto tag_table_entries = bit_cast<TagTableEntry const*>(tag_table_bytes.data());
  447. // "The tag table may contain multiple tags signatures that all reference the same tag data element offset, allowing
  448. // efficient reuse of tag data elements."
  449. HashMap<u32, NonnullRefPtr<TagData>> offset_to_tag_data;
  450. for (u32 i = 0; i < tag_count; ++i) {
  451. // FIXME: optionally ignore tags with unknown signature
  452. // Dedupe identical offset/sizes.
  453. NonnullRefPtr<TagData> tag_data = TRY(offset_to_tag_data.try_ensure(tag_table_entries[i].offset_to_beginning_of_tag_data_element, [&]() {
  454. return read_tag(bytes, tag_table_entries[i].offset_to_beginning_of_tag_data_element, tag_table_entries[i].size_of_tag_data_element);
  455. }));
  456. // "In such cases, both the offset and size of the tag data elements in the tag table shall be the same."
  457. if (tag_data->size() != tag_table_entries[i].size_of_tag_data_element)
  458. return Error::from_string_literal("ICC::Profile: two tags have same offset but different sizes");
  459. // "Duplicate tag signatures shall not be included in the tag table."
  460. if (TRY(tag_table.try_set(tag_table_entries[i].tag_signature, move(tag_data))) != AK::HashSetResult::InsertedNewEntry)
  461. return Error::from_string_literal("ICC::Profile: duplicate tag signature");
  462. }
  463. return tag_table;
  464. }
  465. static bool is_xCLR(ColorSpace color_space)
  466. {
  467. switch (color_space) {
  468. case ColorSpace::TwoColor:
  469. case ColorSpace::ThreeColor:
  470. case ColorSpace::FourColor:
  471. case ColorSpace::FiveColor:
  472. case ColorSpace::SixColor:
  473. case ColorSpace::SevenColor:
  474. case ColorSpace::EightColor:
  475. case ColorSpace::NineColor:
  476. case ColorSpace::TenColor:
  477. case ColorSpace::ElevenColor:
  478. case ColorSpace::TwelveColor:
  479. case ColorSpace::ThirteenColor:
  480. case ColorSpace::FourteenColor:
  481. case ColorSpace::FifteenColor:
  482. return true;
  483. default:
  484. return false;
  485. }
  486. }
  487. ErrorOr<void> Profile::check_required_tags()
  488. {
  489. // ICC v4, 8 Required tags
  490. // ICC v4, 8.2 Common requirements
  491. // "With the exception of DeviceLink profiles, all profiles shall contain the following tags:
  492. // - profileDescriptionTag (see 9.2.41);
  493. // - copyrightTag (see 9.2.21);
  494. // - mediaWhitePointTag (see 9.2.34);
  495. // - chromaticAdaptationTag, when the measurement data used to calculate the profile was specified for an
  496. // adopted white with a chromaticity different from that of the PCS adopted white (see 9.2.15).
  497. // NOTE A DeviceLink profile is not required to have either a mediaWhitePointTag or a chromaticAdaptationTag."
  498. // profileDescriptionTag, copyrightTag are required for DeviceLink too (see ICC v4, 8.6 DeviceLink profile).
  499. // profileDescriptionTag, copyrightTag, mediaWhitePointTag are required in ICC v2 as well.
  500. // chromaticAdaptationTag isn't required in v2 profiles as far as I can tell.
  501. if (!m_tag_table.contains(profileDescriptionTag))
  502. return Error::from_string_literal("ICC::Profile: required profileDescriptionTag is missing");
  503. if (!m_tag_table.contains(copyrightTag))
  504. return Error::from_string_literal("ICC::Profile: required copyrightTag is missing");
  505. if (device_class() != DeviceClass::DeviceLink) {
  506. if (!m_tag_table.contains(mediaWhitePointTag))
  507. return Error::from_string_literal("ICC::Profile: required mediaWhitePointTag is missing");
  508. // FIXME: Check for chromaticAdaptationTag after figuring out when exactly it needs to be present.
  509. }
  510. auto has_tag = [&](auto& tag) { return m_tag_table.contains(tag); };
  511. auto has_all_tags = [&]<class T>(T tags) { return all_of(tags, has_tag); };
  512. switch (device_class()) {
  513. case DeviceClass::InputDevice: {
  514. // ICC v4, 8.3 Input profiles
  515. // "8.3.1 General
  516. // Input profiles are generally used with devices such as scanners and digital cameras. The types of profiles
  517. // available for use as Input profiles are N-component LUT-based, Three-component matrix-based, and
  518. // monochrome.
  519. // 8.3.2 N-component LUT-based Input profiles
  520. // In addition to the tags listed in 8.2 an N-component LUT-based Input profile shall contain the following tag:
  521. // - AToB0Tag (see 9.2.1).
  522. // 8.3.3 Three-component matrix-based Input profiles
  523. // In addition to the tags listed in 8.2, a three-component matrix-based Input profile shall contain the following tags:
  524. // - redMatrixColumnTag (see 9.2.44);
  525. // - greenMatrixColumnTag (see 9.2.30);
  526. // - blueMatrixColumnTag (see 9.2.4);
  527. // - redTRCTag (see 9.2.45);
  528. // - greenTRCTag (see 9.2.31);
  529. // - blueTRCTag (see 9.2.5).
  530. // [...] Only the PCSXYZ encoding can be used with matrix/TRC models.
  531. // 8.3.4 Monochrome Input profiles
  532. // In addition to the tags listed in 8.2, a monochrome Input profile shall contain the following tag:
  533. // - grayTRCTag (see 9.2.29)."
  534. bool has_n_component_lut_based_tags = has_tag(AToB0Tag);
  535. bool has_three_component_matrix_based_tags = has_all_tags(Array { redMatrixColumnTag, greenMatrixColumnTag, blueMatrixColumnTag, redTRCTag, greenTRCTag, blueTRCTag });
  536. bool has_monochrome_tags = has_tag(grayTRCTag);
  537. if (!has_n_component_lut_based_tags && !has_three_component_matrix_based_tags && !has_monochrome_tags)
  538. return Error::from_string_literal("ICC::Profile: InputDevice required tags are missing");
  539. if (!has_n_component_lut_based_tags && has_three_component_matrix_based_tags && connection_space() != ColorSpace::PCSXYZ)
  540. return Error::from_string_literal("ICC::Profile: InputDevice three-component matrix-based profile must use PCSXYZ");
  541. break;
  542. }
  543. case DeviceClass::DisplayDevice: {
  544. // ICC v4, 8.4 Display profiles
  545. // "8.4.1 General
  546. // This class of profiles represents display devices such as monitors. The types of profiles available for use as
  547. // Display profiles are N-component LUT-based, Three-component matrix-based, and monochrome.
  548. // 8.4.2 N-Component LUT-based Display profiles
  549. // In addition to the tags listed in 8.2 an N-component LUT-based Input profile shall contain the following tags:
  550. // - AToB0Tag (see 9.2.1);
  551. // - BToA0Tag (see 9.2.6).
  552. // 8.4.3 Three-component matrix-based Display profiles
  553. // In addition to the tags listed in 8.2, a three-component matrix-based Display profile shall contain the following
  554. // tags:
  555. // - redMatrixColumnTag (see 9.2.44);
  556. // - greenMatrixColumnTag (see 9.2.30);
  557. // - blueMatrixColumnTag (see 9.2.4);
  558. // - redTRCTag (see 9.2.45);
  559. // - greenTRCTag (see 9.2.31);
  560. // - blueTRCTag (see 9.2.5).
  561. // [...] Only the PCSXYZ encoding can be used with matrix/TRC models.
  562. // 8.4.4 Monochrome Display profiles
  563. // In addition to the tags listed in 8.2 a monochrome Display profile shall contain the following tag:
  564. // - grayTRCTag (see 9.2.29)."
  565. bool has_n_component_lut_based_tags = has_all_tags(Array { AToB0Tag, BToA0Tag });
  566. bool has_three_component_matrix_based_tags = has_all_tags(Array { redMatrixColumnTag, greenMatrixColumnTag, blueMatrixColumnTag, redTRCTag, greenTRCTag, blueTRCTag });
  567. bool has_monochrome_tags = has_tag(grayTRCTag);
  568. if (!has_n_component_lut_based_tags && !has_three_component_matrix_based_tags && !has_monochrome_tags)
  569. return Error::from_string_literal("ICC::Profile: DisplayDevice required tags are missing");
  570. if (!has_n_component_lut_based_tags && has_three_component_matrix_based_tags && connection_space() != ColorSpace::PCSXYZ)
  571. return Error::from_string_literal("ICC::Profile: DisplayDevice three-component matrix-based profile must use PCSXYZ");
  572. break;
  573. }
  574. case DeviceClass::OutputDevice: {
  575. // ICC v4, 8.5 Output profiles
  576. // "8.5.1 General
  577. // Output profiles are used to support devices such as printers and film recorders. The types of profiles available
  578. // for use as Output profiles are N-component LUT-based and Monochrome.
  579. // 8.5.2 N-component LUT-based Output profiles
  580. // In addition to the tags listed in 8.2 an N-component LUT-based Output profile shall contain the following tags:
  581. // - AToB0Tag (see 9.2.1);
  582. // - AToB1Tag (see 9.2.2);
  583. // - AToB2Tag (see 9.2.3);
  584. // - BToA0Tag (see 9.2.6);
  585. // - BToA1Tag (see 9.2.7);
  586. // - BToA2Tag (see 9.2.8);
  587. // - gamutTag (see 9.2.28);
  588. // - colorantTableTag (see 9.2.18), for the xCLR colour spaces (see 7.2.6)
  589. // 8.5.3 Monochrome Output profiles
  590. // In addition to the tags listed in 8.2 a monochrome Output profile shall contain the following tag:
  591. // - grayTRCTag (see 9.2.29)."
  592. // The colorantTableTag requirement is new in v4.
  593. Vector<TagSignature, 8> required_n_component_lut_based_tags = { AToB0Tag, AToB1Tag, AToB2Tag, BToA0Tag, BToA1Tag, BToA2Tag, gamutTag };
  594. if (is_v4() && is_xCLR(connection_space()))
  595. required_n_component_lut_based_tags.append(colorantTableTag);
  596. bool has_n_component_lut_based_tags = has_all_tags(required_n_component_lut_based_tags);
  597. bool has_monochrome_tags = has_tag(grayTRCTag);
  598. if (!has_n_component_lut_based_tags && !has_monochrome_tags)
  599. return Error::from_string_literal("ICC::Profile: OutputDevice required tags are missing");
  600. break;
  601. }
  602. case DeviceClass::DeviceLink: {
  603. // ICC v4, 8.6 DeviceLink profile
  604. // "A DeviceLink profile shall contain the following tags:
  605. // - profileDescriptionTag (see 9.2.41);
  606. // - copyrightTag (see 9.2.21);
  607. // - profileSequenceDescTag (see 9.2.42);
  608. // - AToB0Tag (see 9.2.1);
  609. // - colorantTableTag (see 9.2.18) which is required only if the data colour space field is xCLR, where x is
  610. // hexadecimal 2 to F (see 7.2.6);
  611. // - colorantTableOutTag (see 9.2.19), required only if the PCS field is xCLR, where x is hexadecimal 2 to F
  612. // (see 7.2.6)"
  613. // profileDescriptionTag and copyrightTag are already checked above, in the code for section 8.2.
  614. Vector<TagSignature, 4> required_tags = { profileSequenceDescTag, AToB0Tag };
  615. if (is_v4() && is_xCLR(connection_space())) { // This requirement is new in v4.
  616. required_tags.append(colorantTableTag);
  617. required_tags.append(colorantTableOutTag);
  618. }
  619. if (!has_all_tags(required_tags))
  620. return Error::from_string_literal("ICC::Profile: DeviceLink required tags are missing");
  621. // "The data colour space field (see 7.2.6) in the DeviceLink profile will be the same as the data colour space field
  622. // of the first profile in the sequence used to construct the device link. The PCS field (see 7.2.7) will be the same
  623. // as the data colour space field of the last profile in the sequence."
  624. // FIXME: Check that if profileSequenceDescType parsing is implemented.
  625. break;
  626. }
  627. case DeviceClass::ColorSpace:
  628. // ICC v4, 8.7 ColorSpace profile
  629. // "In addition to the tags listed in 8.2, a ColorSpace profile shall contain the following tags:
  630. // - BToA0Tag (see 9.2.6);
  631. // - AToB0Tag (see 9.2.1).
  632. // [...] ColorSpace profiles may be embedded in images."
  633. if (!has_all_tags(Array { AToB0Tag, BToA0Tag }))
  634. return Error::from_string_literal("ICC::Profile: ColorSpace required tags are missing");
  635. break;
  636. case DeviceClass::Abstract:
  637. // ICC v4, 8.8 Abstract profile
  638. // "In addition to the tags listed in 8.2, an Abstract profile shall contain the following tag:
  639. // - AToB0Tag (see 9.2.1).
  640. // [...] Abstract profiles cannot be embedded in images."
  641. if (!has_tag(AToB0Tag))
  642. return Error::from_string_literal("ICC::Profile: Abstract required AToB0Tag is missing");
  643. break;
  644. case DeviceClass::NamedColor:
  645. // ICC v4, 8.9 NamedColor profile
  646. // "In addition to the tags listed in 8.2, a NamedColor profile shall contain the following tag:
  647. // - namedColor2Tag (see 9.2.35)."
  648. if (!has_tag(namedColor2Tag))
  649. return Error::from_string_literal("ICC::Profile: NamedColor required namedColor2Tag is missing");
  650. break;
  651. }
  652. m_cached_has_any_a_to_b_tag = has_tag(AToB0Tag) || has_tag(AToB1Tag) || has_tag(AToB2Tag);
  653. m_cached_has_a_to_b0_tag = has_tag(AToB0Tag);
  654. m_cached_has_any_b_to_a_tag = has_tag(BToA0Tag) || has_tag(BToA1Tag) || has_tag(BToA2Tag);
  655. m_cached_has_b_to_a0_tag = has_tag(BToA0Tag);
  656. m_cached_has_all_rgb_matrix_tags = has_all_tags(Array { redMatrixColumnTag, greenMatrixColumnTag, blueMatrixColumnTag, redTRCTag, greenTRCTag, blueTRCTag });
  657. return {};
  658. }
  659. ErrorOr<void> Profile::check_tag_types()
  660. {
  661. // This uses m_tag_table.get() even for tags that are guaranteed to exist after check_required_tags()
  662. // so that the two functions can be called in either order.
  663. // Profile ID of /System/Library/ColorSync/Profiles/ITU-2020.icc on macOS 13.1.
  664. static constexpr Crypto::Hash::MD5::DigestType apple_itu_2020_id = { 0x57, 0x0b, 0x1b, 0x76, 0xc6, 0xa0, 0x50, 0xaa, 0x9f, 0x6c, 0x53, 0x8d, 0xbe, 0x2d, 0x3e, 0xf0 };
  665. // Profile ID of the "Display P3" profiles embedded in the images on https://webkit.org/blog-files/color-gamut/comparison.html
  666. // (The macOS 13.1 /System/Library/ColorSync/Profiles/Display\ P3.icc file no longer has this quirk.)
  667. static constexpr Crypto::Hash::MD5::DigestType apple_p3_2015_id = { 0xe5, 0xbb, 0x0e, 0x98, 0x67, 0xbd, 0x46, 0xcd, 0x4b, 0xbe, 0x44, 0x6e, 0xbd, 0x1b, 0x75, 0x98 };
  668. auto has_type = [&](auto tag, std::initializer_list<TagTypeSignature> types, std::initializer_list<TagTypeSignature> v4_types) {
  669. if (auto type = m_tag_table.get(tag); type.has_value()) {
  670. auto type_matches = [&](auto wanted_type) { return type.value()->type() == wanted_type; };
  671. return any_of(types, type_matches) || (is_v4() && any_of(v4_types, type_matches));
  672. }
  673. return true;
  674. };
  675. // ICC v4, 9.2.1 AToB0Tag
  676. // "Permitted tag types: lut8Type or lut16Type or lutAToBType"
  677. // ICC v2, 6.4.1 AToB0Tag
  678. // "Tag Type: lut8Type or lut16Type"
  679. if (!has_type(AToB0Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutAToBTagData::Type }))
  680. return Error::from_string_literal("ICC::Profile: AToB0Tag has unexpected type");
  681. // ICC v4, 9.2.2 AToB1Tag
  682. // "Permitted tag types: lut8Type or lut16Type or lutAToBType"
  683. // ICC v2, 6.4.2 AToB1Tag
  684. // "Tag Type: lut8Type or lut16Type"
  685. if (!has_type(AToB1Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutAToBTagData::Type }))
  686. return Error::from_string_literal("ICC::Profile: AToB1Tag has unexpected type");
  687. // ICC v4, 9.2.3 AToB2Tag
  688. // "Permitted tag types: lut8Type or lut16Type or lutAToBType"
  689. // ICC v2, 6.4.3 AToB2Tag
  690. // "Tag Type: lut8Type or lut16Type"
  691. if (!has_type(AToB2Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutAToBTagData::Type }))
  692. return Error::from_string_literal("ICC::Profile: AToB2Tag has unexpected type");
  693. // ICC v4, 9.2.4 blueMatrixColumnTag
  694. // "Permitted tag types: XYZType
  695. // This tag contains the third column in the matrix used in matrix/TRC transforms."
  696. // (Called blueColorantTag in the v2 spec, otherwise identical there.)
  697. if (auto type = m_tag_table.get(blueMatrixColumnTag); type.has_value()) {
  698. if (type.value()->type() != XYZTagData::Type)
  699. return Error::from_string_literal("ICC::Profile: blueMatrixColumnTag has unexpected type");
  700. if (static_cast<XYZTagData const&>(*type.value()).xyzs().size() != 1)
  701. return Error::from_string_literal("ICC::Profile: blueMatrixColumnTag has unexpected size");
  702. }
  703. // ICC v4, 9.2.5 blueTRCTag
  704. // "Permitted tag types: curveType or parametricCurveType"
  705. // ICC v2, 6.4.5 blueTRCTag
  706. // "Tag Type: curveType"
  707. if (!has_type(blueTRCTag, { CurveTagData::Type }, { ParametricCurveTagData::Type }))
  708. return Error::from_string_literal("ICC::Profile: blueTRCTag has unexpected type");
  709. // ICC v4, 9.2.6 BToA0Tag
  710. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  711. // ICC v2, 6.4.6 BToA0Tag
  712. // "Tag Type: lut8Type or lut16Type"
  713. if (!has_type(BToA0Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  714. return Error::from_string_literal("ICC::Profile: BToA0Tag has unexpected type");
  715. // ICC v4, 9.2.7 BToA1Tag
  716. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  717. // ICC v2, 6.4.7 BToA1Tag
  718. // "Tag Type: lut8Type or lut16Type"
  719. if (!has_type(BToA1Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  720. return Error::from_string_literal("ICC::Profile: BToA1Tag has unexpected type");
  721. // ICC v4, 9.2.8 BToA2Tag
  722. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  723. // ICC v2, 6.4.8 BToA2Tag
  724. // "Tag Type: lut8Type or lut16Type"
  725. if (!has_type(BToA2Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  726. return Error::from_string_literal("ICC::Profile: BToA2Tag has unexpected type");
  727. // ICC v4, 9.2.9 BToD0Tag
  728. // "Permitted tag types: multiProcessElementsType"
  729. // FIXME
  730. // ICC v4, 9.2.10 BToD1Tag
  731. // "Permitted tag types: multiProcessElementsType"
  732. // FIXME
  733. // ICC v4, 9.2.11 BToD2Tag
  734. // "Permitted tag types: multiProcessElementsType"
  735. // FIXME
  736. // ICC v4, 9.2.12 BToD3Tag
  737. // "Permitted tag types: multiProcessElementsType"
  738. // FIXME
  739. // ICC v4, 9.2.13 calibrationDateTimeTag
  740. // "Permitted tag types: dateTimeType"
  741. // FIXME
  742. // ICC v4, 9.2.14 charTargetTag
  743. // "Permitted tag types: textType"
  744. if (!has_type(charTargetTag, { TextTagData::Type }, {}))
  745. return Error::from_string_literal("ICC::Profile: charTargetTag has unexpected type");
  746. // ICC v4, 9.2.15 chromaticAdaptationTag
  747. // "Permitted tag types: s15Fixed16ArrayType [...]
  748. // Such a 3 x 3 chromatic adaptation matrix is organized as a 9-element array"
  749. if (auto type = m_tag_table.get(chromaticAdaptationTag); type.has_value()) {
  750. if (type.value()->type() != S15Fixed16ArrayTagData::Type)
  751. return Error::from_string_literal("ICC::Profile: chromaticAdaptationTag has unexpected type");
  752. if (static_cast<S15Fixed16ArrayTagData const&>(*type.value()).values().size() != 9)
  753. return Error::from_string_literal("ICC::Profile: chromaticAdaptationTag has unexpected size");
  754. }
  755. // ICC v4, 9.2.16 chromaticityTag
  756. // "Permitted tag types: chromaticityType"
  757. if (!has_type(chromaticityTag, { ChromaticityTagData::Type }, {}))
  758. return Error::from_string_literal("ICC::Profile: ChromaticityTagData has unexpected type");
  759. // ICC v4, 9.2.17 cicpTag
  760. // "Permitted tag types: cicpType"
  761. if (auto type = m_tag_table.get(cicpTag); type.has_value()) {
  762. if (type.value()->type() != CicpTagData::Type)
  763. return Error::from_string_literal("ICC::Profile: cicpTag has unexpected type");
  764. // "The colour encoding specified by the CICP tag content shall be equivalent to the data colour space encoding
  765. // represented by this ICC profile.
  766. // NOTE The ICC colour transform cannot match every possible rendering of a CICP colour encoding."
  767. // FIXME: Figure out what that means and check for it.
  768. // "This tag may be present when the data colour space in the profile header is RGB, YCbCr, or XYZ, and the
  769. // profile class in the profile header is Input or Display. The tag shall not be present for other data colour spaces
  770. // or profile classes indicated in the profile header."
  771. bool is_color_space_allowed = data_color_space() == ColorSpace::RGB || data_color_space() == ColorSpace::YCbCr || data_color_space() == ColorSpace::nCIEXYZ;
  772. bool is_profile_class_allowed = device_class() == DeviceClass::InputDevice || device_class() == DeviceClass::DisplayDevice;
  773. bool cicp_is_allowed = is_color_space_allowed && is_profile_class_allowed;
  774. if (!cicp_is_allowed)
  775. return Error::from_string_literal("ICC::Profile: cicpTag present but not allowed");
  776. }
  777. // ICC v4, 9.2.18 colorantOrderTag
  778. // "Permitted tag types: colorantOrderType"
  779. // FIXME
  780. // ICC v4, 9.2.19 colorantTableTag
  781. // "Permitted tag types: colorantTableType"
  782. // FIXME
  783. // ICC v4, 9.2.20 colorantTableOutTag
  784. // "Permitted tag types: colorantTableType"
  785. // FIXME
  786. // ICC v4, 9.2.21 colorimetricIntentImageStateTag
  787. // "Permitted tag types: signatureType"
  788. if (!has_type(colorimetricIntentImageStateTag, { SignatureTagData::Type }, {}))
  789. return Error::from_string_literal("ICC::Profile: colorimetricIntentImageStateTag has unexpected type");
  790. // ICC v4, 9.2.22 copyrightTag
  791. // "Permitted tag types: multiLocalizedUnicodeType"
  792. // ICC v2, 6.4.13 copyrightTag
  793. // "Tag Type: textType"
  794. if (auto type = m_tag_table.get(copyrightTag); type.has_value()) {
  795. // The v4 spec requires multiLocalizedUnicodeType for this, but I'm aware of a single file
  796. // that still uses the v2 'text' type here: /System/Library/ColorSync/Profiles/ITU-2020.icc on macOS 13.1.
  797. // https://openradar.appspot.com/radar?id=5529765549178880
  798. bool has_v2_cprt_type_in_v4_file_quirk = id() == apple_itu_2020_id || id() == apple_p3_2015_id;
  799. if (is_v4() && type.value()->type() != MultiLocalizedUnicodeTagData::Type && (!has_v2_cprt_type_in_v4_file_quirk || type.value()->type() != TextTagData::Type))
  800. return Error::from_string_literal("ICC::Profile: copyrightTag has unexpected v4 type");
  801. if (is_v2() && type.value()->type() != TextTagData::Type)
  802. return Error::from_string_literal("ICC::Profile: copyrightTag has unexpected v2 type");
  803. }
  804. // ICC v4, 9.2.23 deviceMfgDescTag
  805. // "Permitted tag types: multiLocalizedUnicodeType"
  806. // ICC v2, 6.4.15 deviceMfgDescTag
  807. // "Tag Type: textDescriptionType"
  808. if (auto type = m_tag_table.get(deviceMfgDescTag); type.has_value()) {
  809. if (is_v4() && type.value()->type() != MultiLocalizedUnicodeTagData::Type)
  810. return Error::from_string_literal("ICC::Profile: deviceMfgDescTag has unexpected v4 type");
  811. if (is_v2() && type.value()->type() != TextDescriptionTagData::Type)
  812. return Error::from_string_literal("ICC::Profile: deviceMfgDescTag has unexpected v2 type");
  813. }
  814. // ICC v4, 9.2.24 deviceModelDescTag
  815. // "Permitted tag types: multiLocalizedUnicodeType"
  816. // ICC v2, 6.4.16 deviceModelDescTag
  817. // "Tag Type: textDescriptionType"
  818. if (auto type = m_tag_table.get(deviceModelDescTag); type.has_value()) {
  819. if (is_v4() && type.value()->type() != MultiLocalizedUnicodeTagData::Type)
  820. return Error::from_string_literal("ICC::Profile: deviceModelDescTag has unexpected v4 type");
  821. if (is_v2() && type.value()->type() != TextDescriptionTagData::Type)
  822. return Error::from_string_literal("ICC::Profile: deviceModelDescTag has unexpected v2 type");
  823. }
  824. // ICC v4, 9.2.25 DToB0Tag
  825. // "Permitted tag types: multiProcessElementsType"
  826. // FIXME
  827. // ICC v4, 9.2.26 DToB1Tag
  828. // "Permitted tag types: multiProcessElementsType"
  829. // FIXME
  830. // ICC v4, 9.2.27 DToB2Tag
  831. // "Permitted tag types: multiProcessElementsType"
  832. // FIXME
  833. // ICC v4, 9.2.28 DToB3Tag
  834. // "Permitted tag types: multiProcessElementsType"
  835. // FIXME
  836. // ICC v4, 9.2.29 gamutTag
  837. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  838. // ICC v2, 6.4.18 gamutTag
  839. // "Tag Type: lut8Type or lut16Type"
  840. if (!has_type(gamutTag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  841. return Error::from_string_literal("ICC::Profile: gamutTag has unexpected type");
  842. // ICC v4, 9.2.30 grayTRCTag
  843. // "Permitted tag types: curveType or parametricCurveType"
  844. // ICC v2, 6.4.19 grayTRCTag
  845. // "Tag Type: curveType"
  846. if (!has_type(grayTRCTag, { CurveTagData::Type }, { ParametricCurveTagData::Type }))
  847. return Error::from_string_literal("ICC::Profile: grayTRCTag has unexpected type");
  848. // ICC v4, 9.2.31 greenMatrixColumnTag
  849. // "Permitted tag types: XYZType
  850. // This tag contains the second column in the matrix, which is used in matrix/TRC transforms."
  851. // (Called greenColorantTag in the v2 spec, otherwise identical there.)
  852. if (auto type = m_tag_table.get(greenMatrixColumnTag); type.has_value()) {
  853. if (type.value()->type() != XYZTagData::Type)
  854. return Error::from_string_literal("ICC::Profile: greenMatrixColumnTag has unexpected type");
  855. if (static_cast<XYZTagData const&>(*type.value()).xyzs().size() != 1)
  856. return Error::from_string_literal("ICC::Profile: greenMatrixColumnTag has unexpected size");
  857. }
  858. // ICC v4, 9.2.32 greenTRCTag
  859. // "Permitted tag types: curveType or parametricCurveType"
  860. // ICC v2, 6.4.21 greenTRCTag
  861. // "Tag Type: curveType"
  862. if (!has_type(greenTRCTag, { CurveTagData::Type }, { ParametricCurveTagData::Type }))
  863. return Error::from_string_literal("ICC::Profile: greenTRCTag has unexpected type");
  864. // ICC v4, 9.2.33 luminanceTag
  865. // "Permitted tag types: XYZType"
  866. // This tag contains the absolute luminance of emissive devices in candelas per square metre as described by the
  867. // Y channel.
  868. // NOTE The X and Z values are set to zero."
  869. // ICC v2, 6.4.22 luminanceTag
  870. // "Absolute luminance of emissive devices in candelas per square meter as described by the Y channel. The
  871. // X and Z channels are ignored in all cases."
  872. if (auto type = m_tag_table.get(luminanceTag); type.has_value()) {
  873. if (type.value()->type() != XYZTagData::Type)
  874. return Error::from_string_literal("ICC::Profile: luminanceTag has unexpected type");
  875. auto& xyz_type = static_cast<XYZTagData const&>(*type.value());
  876. if (xyz_type.xyzs().size() != 1)
  877. return Error::from_string_literal("ICC::Profile: luminanceTag has unexpected size");
  878. if (is_v4() && xyz_type.xyzs()[0].X != 0)
  879. return Error::from_string_literal("ICC::Profile: luminanceTag.x unexpectedly not 0");
  880. if (is_v4() && xyz_type.xyzs()[0].Z != 0)
  881. return Error::from_string_literal("ICC::Profile: luminanceTag.z unexpectedly not 0");
  882. }
  883. // ICC v4, 9.2.34 measurementTag
  884. // "Permitted tag types: measurementType"
  885. if (!has_type(measurementTag, { MeasurementTagData::Type }, {}))
  886. return Error::from_string_literal("ICC::Profile: measurementTag has unexpected type");
  887. // ICC v4, 9.2.35 metadataTag
  888. // "Permitted tag types: dictType"
  889. // FIXME
  890. // ICC v4, 9.2.36 mediaWhitePointTag
  891. // "Permitted tag types: XYZType
  892. // This tag, which is used for generating the ICC-absolute colorimetric intent, specifies the chromatically adapted
  893. // nCIEXYZ tristimulus values of the media white point. When the measurement data used to create the profile
  894. // were specified relative to an adopted white with a chromaticity different from that of the PCS adopted white, the
  895. // media white point nCIEXYZ values shall be adapted to be relative to the PCS adopted white chromaticity using
  896. // the chromaticAdaptationTag matrix, before recording in the tag. For capture devices, the media white point is
  897. // the encoding maximum white for the capture encoding. For displays, the values specified shall be those of the
  898. // PCS illuminant as defined in 7.2.16.
  899. // See Clause 6 and Annex A for a more complete description of the use of the media white point."
  900. // ICC v2, 6.4.25 mediaWhitePointTag
  901. // "This tag specifies the media white point and is used for generating ICC-absolute colorimetric intent. See
  902. // Annex A for a more complete description of its use."
  903. if (auto type = m_tag_table.get(mediaWhitePointTag); type.has_value()) {
  904. if (type.value()->type() != XYZTagData::Type)
  905. return Error::from_string_literal("ICC::Profile: mediaWhitePointTag has unexpected type");
  906. auto& xyz_type = static_cast<XYZTagData const&>(*type.value());
  907. if (xyz_type.xyzs().size() != 1)
  908. return Error::from_string_literal("ICC::Profile: mediaWhitePointTag has unexpected size");
  909. // V4 requires "For displays, the values specified shall be those of the PCS illuminant".
  910. // But in practice that's not always true. For example, on macOS 13.1, '/System/Library/ColorSync/Profiles/DCI(P3) RGB.icc'
  911. // has these values in the header: 0000F6D6 00010000 0000D32D
  912. // but these values in the tag: 0000F6D5 00010000 0000D32C
  913. // These are close, but not equal.
  914. // FIXME: File bug for these, and add id-based quirk instead.
  915. // if (is_v4() && device_class() == DeviceClass::DisplayDevice && xyz_type.xyzs()[0] != pcs_illuminant())
  916. // return Error::from_string_literal("ICC::Profile: mediaWhitePointTag for displays should be equal to PCS illuminant");
  917. }
  918. // ICC v4, 9.2.37 namedColor2Tag
  919. // "Permitted tag types: namedColor2Type"
  920. if (auto type = m_tag_table.get(namedColor2Tag); type.has_value()) {
  921. if (type.value()->type() != NamedColor2TagData::Type)
  922. return Error::from_string_literal("ICC::Profile: namedColor2Tag has unexpected type");
  923. // ICC v4, 10.17 namedColor2Type
  924. // "The device representation corresponds to the header’s “data colour space” field.
  925. // This representation should be consistent with the “number of device coordinates” field in the namedColor2Type.
  926. // If this field is 0, device coordinates are not provided."
  927. if (auto number_of_device_coordinates = static_cast<NamedColor2TagData const&>(*type.value()).number_of_device_coordinates();
  928. number_of_device_coordinates != 0 && number_of_device_coordinates != number_of_components_in_color_space(data_color_space())) {
  929. return Error::from_string_literal("ICC::Profile: namedColor2Tag number of device coordinates inconsistent with data color space");
  930. }
  931. }
  932. // ICC v4, 9.2.38 outputResponseTag
  933. // "Permitted tag types: responseCurveSet16Type"
  934. // FIXME
  935. // ICC v4, 9.2.39 perceptualRenderingIntentGamutTag
  936. // "Permitted tag types: signatureType"
  937. if (!has_type(perceptualRenderingIntentGamutTag, { SignatureTagData::Type }, {}))
  938. return Error::from_string_literal("ICC::Profile: perceptualRenderingIntentGamutTag has unexpected type");
  939. // ICC v4, 9.2.40 preview0Tag
  940. // "Permitted tag types: lut8Type or lut16Type or lutAToBType or lutBToAType"
  941. // ICC v2, 6.4.29 preview0Tag
  942. // "Tag Type: lut8Type or lut16Type"
  943. if (!has_type(preview0Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type, LutBToATagData::Type }))
  944. return Error::from_string_literal("ICC::Profile: preview0Tag has unexpected type");
  945. // ICC v4, 9.2.41 preview1Tag
  946. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  947. // ICC v2, 6.4.30 preview1Tag
  948. // "Tag Type: lut8Type or lut16Type"
  949. if (!has_type(preview1Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  950. return Error::from_string_literal("ICC::Profile: preview1Tag has unexpected type");
  951. // ICC v4, 9.2.42 preview2Tag
  952. // "Permitted tag types: lut8Type or lut16Type or lutBToAType"
  953. // ICC v2, 6.4.31 preview2Tag
  954. // "Tag Type: lut8Type or lut16Type"
  955. if (!has_type(preview2Tag, { Lut8TagData::Type, Lut16TagData::Type }, { LutBToATagData::Type }))
  956. return Error::from_string_literal("ICC::Profile: preview2Tag has unexpected type");
  957. // ICC v4, 9.2.43 profileDescriptionTag
  958. // "Permitted tag types: multiLocalizedUnicodeType"
  959. // ICC v2, 6.4.32 profileDescriptionTag
  960. // "Tag Type: textDescriptionType"
  961. if (auto type = m_tag_table.get(profileDescriptionTag); type.has_value()) {
  962. // The v4 spec requires multiLocalizedUnicodeType for this, but I'm aware of a single file
  963. // that still uses the v2 'desc' type here: /System/Library/ColorSync/Profiles/ITU-2020.icc on macOS 13.1.
  964. // https://openradar.appspot.com/radar?id=5529765549178880
  965. bool has_v2_desc_type_in_v4_file_quirk = id() == apple_itu_2020_id || id() == apple_p3_2015_id;
  966. if (is_v4() && type.value()->type() != MultiLocalizedUnicodeTagData::Type && (!has_v2_desc_type_in_v4_file_quirk || type.value()->type() != TextDescriptionTagData::Type))
  967. return Error::from_string_literal("ICC::Profile: profileDescriptionTag has unexpected v4 type");
  968. if (is_v2() && type.value()->type() != TextDescriptionTagData::Type)
  969. return Error::from_string_literal("ICC::Profile: profileDescriptionTag has unexpected v2 type");
  970. }
  971. // ICC v4, 9.2.44 profileSequenceDescTag
  972. // "Permitted tag types: profileSequenceDescType"
  973. // FIXME
  974. // ICC v4, 9.2.45 profileSequenceIdentifierTag
  975. // "Permitted tag types: profileSequenceIdentifierType"
  976. // FIXME
  977. // ICC v4, 9.2.46 redMatrixColumnTag
  978. // "Permitted tag types: XYZType
  979. // This tag contains the first column in the matrix, which is used in matrix/TRC transforms."
  980. // (Called redColorantTag in the v2 spec, otherwise identical there.)
  981. if (auto type = m_tag_table.get(redMatrixColumnTag); type.has_value()) {
  982. if (type.value()->type() != XYZTagData::Type)
  983. return Error::from_string_literal("ICC::Profile: redMatrixColumnTag has unexpected type");
  984. if (static_cast<XYZTagData const&>(*type.value()).xyzs().size() != 1)
  985. return Error::from_string_literal("ICC::Profile: redMatrixColumnTag has unexpected size");
  986. }
  987. // ICC v4, 9.2.47 redTRCTag
  988. // "Permitted tag types: curveType or parametricCurveType"
  989. // ICC v2, 6.4.41 redTRCTag
  990. // "Tag Type: curveType"
  991. if (!has_type(redTRCTag, { CurveTagData::Type }, { ParametricCurveTagData::Type }))
  992. return Error::from_string_literal("ICC::Profile: redTRCTag has unexpected type");
  993. // ICC v4, 9.2.48 saturationRenderingIntentGamutTag
  994. // "Permitted tag types: signatureType"
  995. if (!has_type(saturationRenderingIntentGamutTag, { SignatureTagData::Type }, {}))
  996. return Error::from_string_literal("ICC::Profile: saturationRenderingIntentGamutTag has unexpected type");
  997. // ICC v4, 9.2.49 technologyTag
  998. // "Permitted tag types: signatureType"
  999. if (!has_type(technologyTag, { SignatureTagData::Type }, {}))
  1000. return Error::from_string_literal("ICC::Profile: technologyTag has unexpected type");
  1001. // ICC v4, 9.2.50 viewingCondDescTag
  1002. // "Permitted tag types: multiLocalizedUnicodeType"
  1003. // ICC v2, 6.4.46 viewingCondDescTag
  1004. // "Tag Type: textDescriptionType"
  1005. if (auto type = m_tag_table.get(viewingCondDescTag); type.has_value()) {
  1006. if (is_v4() && type.value()->type() != MultiLocalizedUnicodeTagData::Type)
  1007. return Error::from_string_literal("ICC::Profile: viewingCondDescTag has unexpected v4 type");
  1008. if (is_v2() && type.value()->type() != TextDescriptionTagData::Type)
  1009. return Error::from_string_literal("ICC::Profile: viewingCondDescTag has unexpected v2 type");
  1010. }
  1011. // ICC v4, 9.2.51 viewingConditionsTag
  1012. // "Permitted tag types: viewingConditionsType"
  1013. if (!has_type(viewingConditionsTag, { ViewingConditionsTagData::Type }, {}))
  1014. return Error::from_string_literal("ICC::Profile: viewingConditionsTag has unexpected type");
  1015. // FIXME: Add validation for v2-only tags:
  1016. // - ICC v2, 6.4.14 crdInfoTag
  1017. // "Tag Type: crdInfoType"
  1018. // - ICC v2, 6.4.17 deviceSettingsTag
  1019. // "Tag Type: deviceSettingsType"
  1020. // - ICC v2, 6.4.24 mediaBlackPointTag
  1021. // "Tag Type: XYZType"
  1022. // - ICC v2, 6.4.26 namedColorTag
  1023. // "Tag Type: namedColorType"
  1024. // - ICC v2, 6.4.34 ps2CRD0Tag
  1025. // "Tag Type: dataType"
  1026. // - ICC v2, 6.4.35 ps2CRD1Tag
  1027. // "Tag Type: dataType"
  1028. // - ICC v2, 6.4.36 ps2CRD2Tag
  1029. // "Tag Type: dataType"
  1030. // - ICC v2, 6.4.37 ps2CRD3Tag
  1031. // "Tag Type: dataType"
  1032. // - ICC v2, 6.4.38 ps2CSATag
  1033. // "Tag Type: dataType"
  1034. // - ICC v2, 6.4.39 ps2RenderingIntentTag
  1035. // "Tag Type: dataType"
  1036. // - ICC v2, 6.4.42 screeningDescTag
  1037. // "Tag Type: textDescriptionType"
  1038. // - ICC v2, 6.4.43 screeningTag
  1039. // "Tag Type: screeningType"
  1040. // - ICC v2, 6.4.45 ucrbgTag
  1041. // "Tag Type: ucrbgType"
  1042. // https://www.color.org/v2profiles.xalter says about these tags:
  1043. // "it is also recommended that optional tags in the v2 specification that have subsequently become
  1044. // obsolete are not included in future profiles made to the v2 specification."
  1045. return {};
  1046. }
  1047. ErrorOr<NonnullRefPtr<Profile>> Profile::try_load_from_externally_owned_memory(ReadonlyBytes bytes)
  1048. {
  1049. auto header = TRY(read_header(bytes));
  1050. bytes = bytes.trim(header.on_disk_size);
  1051. auto tag_table = TRY(read_tag_table(bytes));
  1052. return create(header, move(tag_table));
  1053. }
  1054. ErrorOr<NonnullRefPtr<Profile>> Profile::create(ProfileHeader const& header, OrderedHashMap<TagSignature, NonnullRefPtr<TagData>> tag_table)
  1055. {
  1056. auto profile = TRY(adopt_nonnull_ref_or_enomem(new (nothrow) Profile(header, move(tag_table))));
  1057. TRY(profile->check_required_tags());
  1058. TRY(profile->check_tag_types());
  1059. return profile;
  1060. }
  1061. Crypto::Hash::MD5::DigestType Profile::compute_id(ReadonlyBytes bytes)
  1062. {
  1063. // ICC v4, 7.2.18 Profile ID field
  1064. // "The Profile ID shall be calculated using the MD5 fingerprinting method as defined in Internet RFC 1321.
  1065. // The entire profile, whose length is given by the size field in the header, with the
  1066. // profile flags field (bytes 44 to 47, see 7.2.11),
  1067. // rendering intent field (bytes 64 to 67, see 7.2.15),
  1068. // and profile ID field (bytes 84 to 99)
  1069. // in the profile header temporarily set to zeros (00h),
  1070. // shall be used to calculate the ID."
  1071. const u8 zero[16] = {};
  1072. Crypto::Hash::MD5 md5;
  1073. md5.update(bytes.slice(0, 44));
  1074. md5.update(ReadonlyBytes { zero, 4 }); // profile flags field
  1075. md5.update(bytes.slice(48, 64 - 48));
  1076. md5.update(ReadonlyBytes { zero, 4 }); // rendering intent field
  1077. md5.update(bytes.slice(68, 84 - 68));
  1078. md5.update(ReadonlyBytes { zero, 16 }); // profile ID field
  1079. md5.update(bytes.slice(100));
  1080. return md5.digest();
  1081. }
  1082. static TagSignature forward_transform_tag_for_rendering_intent(RenderingIntent rendering_intent)
  1083. {
  1084. // ICCv4, Table 25 — Profile type/profile tag and defined rendering intents
  1085. // This function assumes a profile class of InputDevice, DisplayDevice, OutputDevice, or ColorSpace.
  1086. switch (rendering_intent) {
  1087. case RenderingIntent::Perceptual:
  1088. return AToB0Tag;
  1089. case RenderingIntent::MediaRelativeColorimetric:
  1090. case RenderingIntent::ICCAbsoluteColorimetric:
  1091. return AToB1Tag;
  1092. case RenderingIntent::Saturation:
  1093. return AToB2Tag;
  1094. }
  1095. VERIFY_NOT_REACHED();
  1096. }
  1097. ErrorOr<FloatVector3> Profile::to_pcs_a_to_b(TagData const& tag_data, ReadonlyBytes color) const
  1098. {
  1099. // Assumes a "normal" device_class() (i.e. not DeviceLink).
  1100. VERIFY(number_of_components_in_color_space(connection_space()) == 3);
  1101. if (m_to_pcs_clut_cache.has_value() && m_to_pcs_clut_cache->key == color)
  1102. return m_to_pcs_clut_cache->value;
  1103. FloatVector3 result;
  1104. switch (tag_data.type()) {
  1105. case Lut16TagData::Type: {
  1106. auto const& a_to_b = static_cast<Lut16TagData const&>(tag_data);
  1107. result = TRY(a_to_b.evaluate(data_color_space(), connection_space(), color));
  1108. break;
  1109. }
  1110. case Lut8TagData::Type: {
  1111. auto const& a_to_b = static_cast<Lut8TagData const&>(tag_data);
  1112. result = TRY(a_to_b.evaluate(data_color_space(), connection_space(), color));
  1113. break;
  1114. }
  1115. case LutAToBTagData::Type: {
  1116. auto const& a_to_b = static_cast<LutAToBTagData const&>(tag_data);
  1117. if (a_to_b.number_of_input_channels() != number_of_components_in_color_space(data_color_space()))
  1118. return Error::from_string_literal("ICC::Profile::to_pcs_a_to_b: mAB input channel count does not match color space size");
  1119. if (a_to_b.number_of_output_channels() != number_of_components_in_color_space(connection_space()))
  1120. return Error::from_string_literal("ICC::Profile::to_pcs_a_to_b: mAB output channel count does not match profile connection space size");
  1121. result = TRY(a_to_b.evaluate(connection_space(), color));
  1122. break;
  1123. }
  1124. default:
  1125. VERIFY_NOT_REACHED();
  1126. }
  1127. if (!m_to_pcs_clut_cache.has_value())
  1128. m_to_pcs_clut_cache = OneElementCLUTCache {};
  1129. m_to_pcs_clut_cache->key = Vector<u8, 4>(color);
  1130. m_to_pcs_clut_cache->value = result;
  1131. return result;
  1132. }
  1133. ErrorOr<FloatVector3> Profile::to_pcs(ReadonlyBytes color) const
  1134. {
  1135. if (color.size() != number_of_components_in_color_space(data_color_space()))
  1136. return Error::from_string_literal("ICC::Profile: input color doesn't match color space size");
  1137. auto get_tag = [&](auto tag) { return m_tag_table.get(tag); };
  1138. switch (device_class()) {
  1139. case DeviceClass::InputDevice:
  1140. case DeviceClass::DisplayDevice:
  1141. case DeviceClass::OutputDevice:
  1142. case DeviceClass::ColorSpace: {
  1143. // ICC v4, 8.10 Precedence order of tag usage
  1144. // "There are several methods of colour transformation that can function within a single CMM. If data for more than
  1145. // one method are included in the same profile, the following selection algorithm shall be used by the software
  1146. // implementation."
  1147. // ICC v4, 8.10.2 Input, display, output, or colour space profile types
  1148. // "a) Use the BToD0Tag, BToD1Tag, BToD2Tag, BToD3Tag, DToB0Tag, DToB1Tag, DToB2Tag, or
  1149. // DToB3Tag designated for the rendering intent if the tag is present, except where this tag is not needed or
  1150. // supported by the CMM (if a particular processing element within the tag is not supported the tag is not
  1151. // supported)."
  1152. // FIXME: Implement multiProcessElementsType one day.
  1153. // "b) Use the BToA0Tag, BToA1Tag, BToA2Tag, AToB0Tag, AToB1Tag, or AToB2Tag designated for the
  1154. // rendering intent if present, when the tag in a) is not used."
  1155. if (m_cached_has_any_a_to_b_tag)
  1156. if (auto tag = get_tag(forward_transform_tag_for_rendering_intent(rendering_intent())); tag.has_value())
  1157. return to_pcs_a_to_b(*tag.value(), color);
  1158. // "c) Use the BToA0Tag or AToB0Tag if present, when the tags in a) and b) are not used."
  1159. // AToB0Tag is for the conversion _to_ PCS (BToA0Tag is for conversion _from_ PCS, so not needed in this function).
  1160. if (m_cached_has_a_to_b0_tag)
  1161. if (auto tag = get_tag(AToB0Tag); tag.has_value())
  1162. return to_pcs_a_to_b(*tag.value(), color);
  1163. // "d) Use TRCs (redTRCTag, greenTRCTag, blueTRCTag, or grayTRCTag) and colorants
  1164. // (redMatrixColumnTag, greenMatrixColumnTag, blueMatrixColumnTag) when tags in a), b), and c) are not
  1165. // used."
  1166. auto evaluate_curve = [this](TagSignature curve_tag, float f) {
  1167. auto const& trc = *m_tag_table.get(curve_tag).value();
  1168. VERIFY(trc.type() == CurveTagData::Type || trc.type() == ParametricCurveTagData::Type);
  1169. if (trc.type() == CurveTagData::Type)
  1170. return static_cast<CurveTagData const&>(trc).evaluate(f);
  1171. return static_cast<ParametricCurveTagData const&>(trc).evaluate(f);
  1172. };
  1173. if (data_color_space() == ColorSpace::Gray) {
  1174. VERIFY(color.size() == 1); // True because of color.size() check further up.
  1175. // ICC v4, F.2 grayTRCTag
  1176. // "connection = grayTRC[device]"
  1177. float gray = evaluate_curve(grayTRCTag, color[0] / 255.f);
  1178. FloatVector3 white { pcs_illuminant().X, pcs_illuminant().Y, pcs_illuminant().Z };
  1179. return white * gray;
  1180. }
  1181. // FIXME: Per ICC v4, A.1 General, this should also handle HLS, HSV, YCbCr.
  1182. if (data_color_space() == ColorSpace::RGB) {
  1183. if (!m_cached_has_all_rgb_matrix_tags)
  1184. return Error::from_string_literal("ICC::Profile::to_pcs: RGB color space but neither LUT-based nor matrix-based tags present");
  1185. VERIFY(color.size() == 3); // True because of color.size() check further up.
  1186. // ICC v4, F.3 Three-component matrix-based profiles
  1187. // "linear_r = redTRC[device_r]
  1188. // linear_g = greenTRC[device_g]
  1189. // linear_b = blueTRC[device_b]
  1190. // [connection_X] = [redMatrixColumn_X greenMatrixColumn_X blueMatrixColumn_X] [ linear_r ]
  1191. // [connection_Y] = [redMatrixColumn_Y greenMatrixColumn_Y blueMatrixColumn_Y] * [ linear_g ]
  1192. // [connection_Z] = [redMatrixColumn_Z greenMatrixColumn_Z blueMatrixColumn_Z] [ linear_b ]"
  1193. FloatVector3 linear_rgb {
  1194. evaluate_curve(redTRCTag, color[0] / 255.f),
  1195. evaluate_curve(greenTRCTag, color[1] / 255.f),
  1196. evaluate_curve(blueTRCTag, color[2] / 255.f),
  1197. };
  1198. return rgb_to_xyz_matrix() * linear_rgb;
  1199. }
  1200. return Error::from_string_literal("ICC::Profile::to_pcs: What happened?!");
  1201. }
  1202. case DeviceClass::DeviceLink:
  1203. case DeviceClass::Abstract:
  1204. // ICC v4, 8.10.3 DeviceLink or Abstract profile types
  1205. // FIXME
  1206. return Error::from_string_literal("ICC::Profile::to_pcs: conversion for DeviceLink and Abstract not implemented");
  1207. case DeviceClass::NamedColor:
  1208. return Error::from_string_literal("ICC::Profile::to_pcs: to_pcs with NamedColor profile does not make sense");
  1209. }
  1210. VERIFY_NOT_REACHED();
  1211. }
  1212. static FloatVector3 lab_from_xyz(FloatVector3 xyz, XYZ white_point)
  1213. {
  1214. // 6.3.2.2 Translation between media-relative colorimetric data and ICC-absolute colorimetric data
  1215. // 6.3.2.3 Computation of PCSLAB
  1216. // 6.3.4 Colour space encodings for the PCS
  1217. // A.3 PCS encodings
  1218. auto f = [](float x) {
  1219. if (x > powf(6.f / 29.f, 3))
  1220. return cbrtf(x);
  1221. return x / (3 * powf(6.f / 29.f, 2)) + 4.f / 29.f;
  1222. };
  1223. // "X/Xn is replaced by Xr/Xi (or Xa/Xmw)"
  1224. // 6.3.2.2 Translation between media-relative colorimetric data and ICC-absolute colorimetric data
  1225. // "The translation from ICC-absolute colorimetric data to media-relative colorimetry data is given by Equations
  1226. // Xr = (Xi/Xmw) * Xa
  1227. // where
  1228. // Xr media-relative colorimetric data (i.e. PCSXYZ);
  1229. // Xa ICC-absolute colorimetric data (i.e. nCIEXYZ);
  1230. // Xmw nCIEXYZ values of the media white point as specified in the mediaWhitePointTag;
  1231. // Xi PCSXYZ values of the PCS white point defined in 6.3.4.3."
  1232. // 6.3.4.3 PCS encodings for white and black
  1233. // "Table 14 — Encodings of PCS white point: X 0,9642 Y 1,0000 Z 0,8249"
  1234. // That's identical to the values in 7.2.16 PCS illuminant field (Bytes 68 to 79).
  1235. // 9.2.36 mediaWhitePointTag
  1236. // "For displays, the values specified shall be those of the PCS illuminant as defined in 7.2.16."
  1237. // ...so for displays, this is all equivalent I think? It's maybe different for OutputDevice profiles?
  1238. float Xn = white_point.X;
  1239. float Yn = white_point.Y;
  1240. float Zn = white_point.Z;
  1241. float x = xyz[0] / Xn;
  1242. float y = xyz[1] / Yn;
  1243. float z = xyz[2] / Zn;
  1244. float L = 116 * f(y) - 16;
  1245. float a = 500 * (f(x) - f(y));
  1246. float b = 200 * (f(y) - f(z));
  1247. return { L, a, b };
  1248. }
  1249. static FloatVector3 xyz_from_lab(FloatVector3 lab, XYZ white_point)
  1250. {
  1251. // Inverse of lab_from_xyz().
  1252. auto L_star = lab[0];
  1253. auto a_star = lab[1];
  1254. auto b_star = lab[2];
  1255. auto L = (L_star + 16) / 116 + a_star / 500; // f(x)
  1256. auto M = (L_star + 16) / 116; // f(y)
  1257. auto N = (L_star + 16) / 116 - b_star / 200; // f(z)
  1258. // Inverse of f in lab_from_xyz().
  1259. auto g = [](float x) {
  1260. if (x >= 6.0f / 29.0f)
  1261. return powf(x, 3);
  1262. return (x - 4.0f / 29.0f) * (3 * powf(6.f / 29.f, 2));
  1263. };
  1264. return { white_point.X * g(L), white_point.Y * g(M), white_point.Z * g(N) };
  1265. }
  1266. static TagSignature backward_transform_tag_for_rendering_intent(RenderingIntent rendering_intent)
  1267. {
  1268. // ICCv4, Table 25 — Profile type/profile tag and defined rendering intents
  1269. // This function assumes a profile class of InputDevice, DisplayDevice, OutputDevice, or ColorSpace.
  1270. switch (rendering_intent) {
  1271. case RenderingIntent::Perceptual:
  1272. return BToA0Tag;
  1273. case RenderingIntent::MediaRelativeColorimetric:
  1274. case RenderingIntent::ICCAbsoluteColorimetric:
  1275. return BToA1Tag;
  1276. case RenderingIntent::Saturation:
  1277. return BToA2Tag;
  1278. }
  1279. VERIFY_NOT_REACHED();
  1280. }
  1281. ErrorOr<void> Profile::from_pcs_b_to_a(TagData const& tag_data, FloatVector3 const& pcs, Bytes out_bytes) const
  1282. {
  1283. switch (tag_data.type()) {
  1284. case Lut16TagData::Type:
  1285. // FIXME
  1286. return Error::from_string_literal("ICC::Profile::to_pcs: BToA*Tag handling for mft2 tags not yet implemented");
  1287. case Lut8TagData::Type:
  1288. // FIXME
  1289. return Error::from_string_literal("ICC::Profile::to_pcs: BToA*Tag handling for mft1 tags not yet implemented");
  1290. case LutBToATagData::Type: {
  1291. auto const& b_to_a = static_cast<LutBToATagData const&>(tag_data);
  1292. if (b_to_a.number_of_input_channels() != number_of_components_in_color_space(connection_space()))
  1293. return Error::from_string_literal("ICC::Profile::from_pcs_b_to_a: mBA input channel count does not match color space size");
  1294. if (b_to_a.number_of_output_channels() != number_of_components_in_color_space(data_color_space()))
  1295. return Error::from_string_literal("ICC::Profile::from_pcs_b_to_a: mBA output channel count does not match profile connection space size");
  1296. return b_to_a.evaluate(connection_space(), pcs, out_bytes);
  1297. }
  1298. }
  1299. VERIFY_NOT_REACHED();
  1300. }
  1301. ErrorOr<void> Profile::from_pcs(Profile const& source_profile, FloatVector3 pcs, Bytes color) const
  1302. {
  1303. if (source_profile.connection_space() != connection_space()) {
  1304. if (source_profile.connection_space() == ColorSpace::PCSLAB) {
  1305. VERIFY(connection_space() == ColorSpace::PCSXYZ);
  1306. pcs = xyz_from_lab(pcs, source_profile.pcs_illuminant());
  1307. } else {
  1308. VERIFY(source_profile.connection_space() == ColorSpace::PCSXYZ);
  1309. VERIFY(connection_space() == ColorSpace::PCSLAB);
  1310. pcs = lab_from_xyz(pcs, pcs_illuminant());
  1311. }
  1312. }
  1313. // See `to_pcs()` for spec links.
  1314. // This function is very similar, but uses BToAn instead of AToBn for LUT profiles,
  1315. // and an inverse transform for matrix profiles.
  1316. if (color.size() != number_of_components_in_color_space(data_color_space()))
  1317. return Error::from_string_literal("ICC::Profile: output color doesn't match color space size");
  1318. auto get_tag = [&](auto tag) { return m_tag_table.get(tag); };
  1319. switch (device_class()) {
  1320. case DeviceClass::InputDevice:
  1321. case DeviceClass::DisplayDevice:
  1322. case DeviceClass::OutputDevice:
  1323. case DeviceClass::ColorSpace: {
  1324. // FIXME: Implement multiProcessElementsType one day.
  1325. if (m_cached_has_any_b_to_a_tag)
  1326. if (auto tag = get_tag(backward_transform_tag_for_rendering_intent(rendering_intent())); tag.has_value())
  1327. return from_pcs_b_to_a(*tag.value(), pcs, color);
  1328. if (m_cached_has_b_to_a0_tag)
  1329. if (auto tag = get_tag(BToA0Tag); tag.has_value())
  1330. return from_pcs_b_to_a(*tag.value(), pcs, color);
  1331. if (data_color_space() == ColorSpace::Gray) {
  1332. // FIXME
  1333. return Error::from_string_literal("ICC::Profile::from_pcs: Gray handling not yet implemented");
  1334. }
  1335. // FIXME: Per ICC v4, A.1 General, this should also handle HLS, HSV, YCbCr.
  1336. if (data_color_space() == ColorSpace::RGB) {
  1337. if (!m_cached_has_all_rgb_matrix_tags)
  1338. return Error::from_string_literal("ICC::Profile::from_pcs: RGB color space but neither LUT-based nor matrix-based tags present");
  1339. VERIFY(color.size() == 3); // True because of color.size() check further up.
  1340. // ICC v4, F.3 Three-component matrix-based profiles
  1341. // "The inverse model is given by the following equations:
  1342. // [linear_r] = [redMatrixColumn_X greenMatrixColumn_X blueMatrixColumn_X]^-1 [ connection_X ]
  1343. // [linear_g] = [redMatrixColumn_Y greenMatrixColumn_Y blueMatrixColumn_Y] * [ connection_Y ]
  1344. // [linear_b] = [redMatrixColumn_Z greenMatrixColumn_Z blueMatrixColumn_Z] [ connection_Z ]
  1345. //
  1346. // for linear_r < 0, device_r = redTRC^-1[0] (F.8)
  1347. // for 0 ≤ linear_r ≤ 1, device_r = redTRC^-1[linear_r] (F.9)
  1348. // for linear_r > 1, device_r = redTRC^-1[1] (F.10)
  1349. //
  1350. // for linear_g < 0, device_g = greenTRC^-1[0] (F.11)
  1351. // for 0 ≤ linear_g ≤ 1, device_g = greenTRC^-1[linear_g] (F.12)
  1352. // for linear_g > 1, device_g = greenTRC^-1[1] (F.13)
  1353. //
  1354. // for linear_b < 0, device_b = blueTRC^-1[0] (F.14)
  1355. // for 0 ≤ linear_b ≤ 1, device_b = blueTRC^-1[linear_b] (F.15)
  1356. // for linear_b > 1, device_b = blueTRC^-1[1] (F.16)
  1357. //
  1358. // where redTRC^-1, greenTRC^-1, and blueTRC^-1 indicate the inverse functions of the redTRC greenTRC and
  1359. // blueTRC functions respectively.
  1360. // If the redTRC, greenTRC, or blueTRC function is not invertible the behaviour of the corresponding redTRC^-1,
  1361. // greenTRC^-1, and blueTRC^-1 function is undefined. If a one-dimensional curve is constant, the curve cannot be
  1362. // inverted."
  1363. // Convert from XYZ to linear rgb.
  1364. // FIXME: Inverting curves on every call to this function is very inefficient.
  1365. FloatVector3 linear_rgb = TRY(xyz_to_rgb_matrix()) * pcs;
  1366. auto evaluate_curve_inverse = [this](TagSignature curve_tag, float f) {
  1367. auto const& trc = *m_tag_table.get(curve_tag).value();
  1368. VERIFY(trc.type() == CurveTagData::Type || trc.type() == ParametricCurveTagData::Type);
  1369. if (trc.type() == CurveTagData::Type)
  1370. return static_cast<CurveTagData const&>(trc).evaluate_inverse(f);
  1371. return static_cast<ParametricCurveTagData const&>(trc).evaluate_inverse(f);
  1372. };
  1373. // Convert from linear rgb to device rgb.
  1374. // See equations (F.8) - (F.16) above.
  1375. // FIXME: The spec says to do this, but it loses information. Color.js returns unclamped
  1376. // values instead (...but how do those make it through the TRC?) and has a separate
  1377. // clipping step. Maybe that's better?
  1378. // Also, maybe doing actual gamut mapping would look better?
  1379. // (For LUT profiles, I think the gamut mapping is baked into the BToA* data in the profile (?).
  1380. // But for matrix profiles, it'd have to be done in code.)
  1381. linear_rgb.clamp(0.f, 1.f);
  1382. float device_r = evaluate_curve_inverse(redTRCTag, linear_rgb[0]);
  1383. float device_g = evaluate_curve_inverse(greenTRCTag, linear_rgb[1]);
  1384. float device_b = evaluate_curve_inverse(blueTRCTag, linear_rgb[2]);
  1385. color[0] = round(255 * device_r);
  1386. color[1] = round(255 * device_g);
  1387. color[2] = round(255 * device_b);
  1388. return {};
  1389. }
  1390. return Error::from_string_literal("ICC::Profile::from_pcs: What happened?!");
  1391. }
  1392. case DeviceClass::DeviceLink:
  1393. case DeviceClass::Abstract:
  1394. // ICC v4, 8.10.3 DeviceLink or Abstract profile types
  1395. // FIXME
  1396. return Error::from_string_literal("ICC::Profile::from_pcs: conversion for DeviceLink and Abstract not implemented");
  1397. case DeviceClass::NamedColor:
  1398. return Error::from_string_literal("ICC::Profile::from_pcs: from_pcs with NamedColor profile does not make sense");
  1399. }
  1400. VERIFY_NOT_REACHED();
  1401. }
  1402. ErrorOr<CIELAB> Profile::to_lab(ReadonlyBytes color) const
  1403. {
  1404. auto pcs = TRY(to_pcs(color));
  1405. if (connection_space() == ColorSpace::PCSLAB)
  1406. return CIELAB { pcs[0], pcs[1], pcs[2] };
  1407. if (connection_space() != ColorSpace::PCSXYZ) {
  1408. VERIFY(device_class() == DeviceClass::DeviceLink);
  1409. return Error::from_string_literal("ICC::Profile::to_lab: conversion for DeviceLink not implemented");
  1410. }
  1411. FloatVector3 lab = lab_from_xyz(pcs, pcs_illuminant());
  1412. return CIELAB { lab[0], lab[1], lab[2] };
  1413. }
  1414. MatrixMatrixConversion::MatrixMatrixConversion(LutCurveType source_red_TRC,
  1415. LutCurveType source_green_TRC,
  1416. LutCurveType source_blue_TRC,
  1417. FloatMatrix3x3 matrix,
  1418. LutCurveType destination_red_TRC,
  1419. LutCurveType destination_green_TRC,
  1420. LutCurveType destination_blue_TRC)
  1421. : m_source_red_TRC(move(source_red_TRC))
  1422. , m_source_green_TRC(move(source_green_TRC))
  1423. , m_source_blue_TRC(move(source_blue_TRC))
  1424. , m_matrix(matrix)
  1425. , m_destination_red_TRC(move(destination_red_TRC))
  1426. , m_destination_green_TRC(move(destination_green_TRC))
  1427. , m_destination_blue_TRC(move(destination_blue_TRC))
  1428. {
  1429. auto check = [](auto const& trc) {
  1430. VERIFY(trc->type() == CurveTagData::Type || trc->type() == ParametricCurveTagData::Type);
  1431. };
  1432. check(m_source_red_TRC);
  1433. check(m_source_green_TRC);
  1434. check(m_source_blue_TRC);
  1435. check(m_destination_red_TRC);
  1436. check(m_destination_green_TRC);
  1437. check(m_destination_blue_TRC);
  1438. }
  1439. Optional<MatrixMatrixConversion> Profile::matrix_matrix_conversion(Profile const& source_profile) const
  1440. {
  1441. auto has_normal_device_class = [](DeviceClass device) {
  1442. return device == DeviceClass::InputDevice
  1443. || device == DeviceClass::DisplayDevice
  1444. || device == DeviceClass::OutputDevice
  1445. || device == DeviceClass::ColorSpace;
  1446. };
  1447. bool is_matrix_matrix_conversion = has_normal_device_class(device_class())
  1448. && has_normal_device_class(source_profile.device_class())
  1449. && connection_space() == ColorSpace::PCSXYZ
  1450. && source_profile.connection_space() == ColorSpace::PCSXYZ
  1451. && data_color_space() == ColorSpace::RGB
  1452. && source_profile.data_color_space() == ColorSpace::RGB
  1453. && !m_cached_has_any_a_to_b_tag
  1454. && !source_profile.m_cached_has_any_a_to_b_tag
  1455. && m_cached_has_all_rgb_matrix_tags
  1456. && source_profile.m_cached_has_all_rgb_matrix_tags
  1457. && rgb_to_xyz_matrix().is_invertible();
  1458. if (!is_matrix_matrix_conversion)
  1459. return OptionalNone {};
  1460. LutCurveType sourceRedTRC = *source_profile.m_tag_table.get(redTRCTag).value();
  1461. LutCurveType sourceGreenTRC = *source_profile.m_tag_table.get(greenTRCTag).value();
  1462. LutCurveType sourceBlueTRC = *source_profile.m_tag_table.get(blueTRCTag).value();
  1463. FloatMatrix3x3 matrix = MUST(xyz_to_rgb_matrix()) * source_profile.rgb_to_xyz_matrix();
  1464. LutCurveType destinationRedTRC = *m_tag_table.get(redTRCTag).value();
  1465. LutCurveType destinationGreenTRC = *m_tag_table.get(greenTRCTag).value();
  1466. LutCurveType destinationBlueTRC = *m_tag_table.get(blueTRCTag).value();
  1467. return MatrixMatrixConversion(sourceRedTRC, sourceGreenTRC, sourceBlueTRC, matrix, destinationRedTRC, destinationGreenTRC, destinationBlueTRC);
  1468. }
  1469. ErrorOr<void> Profile::convert_image_matrix_matrix(Gfx::Bitmap& bitmap, MatrixMatrixConversion const& map) const
  1470. {
  1471. for (auto& pixel : bitmap) {
  1472. FloatVector3 rgb { (float)Color::from_argb(pixel).red(), (float)Color::from_argb(pixel).green(), (float)Color::from_argb(pixel).blue() };
  1473. auto out = map.map(rgb / 255.0f);
  1474. out.set_alpha(Color::from_argb(pixel).alpha());
  1475. pixel = out.value();
  1476. }
  1477. return {};
  1478. }
  1479. ErrorOr<void> Profile::convert_image(Gfx::Bitmap& bitmap, Profile const& source_profile) const
  1480. {
  1481. if (auto map = matrix_matrix_conversion(source_profile); map.has_value())
  1482. return convert_image_matrix_matrix(bitmap, map.value());
  1483. for (auto& pixel : bitmap) {
  1484. u8 rgb[] = { Color::from_argb(pixel).red(), Color::from_argb(pixel).green(), Color::from_argb(pixel).blue() };
  1485. auto pcs = TRY(source_profile.to_pcs(rgb));
  1486. TRY(from_pcs(source_profile, pcs, rgb));
  1487. pixel = Color(rgb[0], rgb[1], rgb[2], Color::from_argb(pixel).alpha()).value();
  1488. }
  1489. return {};
  1490. }
  1491. ErrorOr<void> Profile::convert_cmyk_image(Bitmap& out, CMYKBitmap const& in, Profile const& source_profile) const
  1492. {
  1493. if (out.size() != in.size())
  1494. return Error::from_string_literal("ICC::Profile::convert_cmyk_image: out and in must have the same dimensions");
  1495. // Might fail if `out` has a scale_factor() != 1.
  1496. if (out.data_size() != in.data_size())
  1497. return Error::from_string_literal("ICC::Profile::convert_cmyk_image: out and in must have the same buffer size");
  1498. static_assert(sizeof(ARGB32) == sizeof(CMYK));
  1499. ARGB32* out_data = out.begin();
  1500. CMYK const* in_data = const_cast<CMYKBitmap&>(in).begin();
  1501. for (size_t i = 0; i < in.data_size() / sizeof(CMYK); ++i) {
  1502. u8 cmyk[] = { in_data[i].c, in_data[i].m, in_data[i].y, in_data[i].k };
  1503. auto pcs = TRY(source_profile.to_pcs(cmyk));
  1504. u8 rgb[3];
  1505. TRY(from_pcs(source_profile, pcs, rgb));
  1506. out_data[i] = Color(rgb[0], rgb[1], rgb[2]).value();
  1507. }
  1508. return {};
  1509. }
  1510. XYZ const& Profile::red_matrix_column() const { return xyz_data(redMatrixColumnTag); }
  1511. XYZ const& Profile::green_matrix_column() const { return xyz_data(greenMatrixColumnTag); }
  1512. XYZ const& Profile::blue_matrix_column() const { return xyz_data(blueMatrixColumnTag); }
  1513. Optional<String> Profile::tag_string_data(TagSignature signature) const
  1514. {
  1515. auto maybe_tag_data = tag_data(signature);
  1516. if (!maybe_tag_data.has_value())
  1517. return {};
  1518. auto& tag_data = maybe_tag_data.release_value();
  1519. if (tag_data.type() == Gfx::ICC::MultiLocalizedUnicodeTagData::Type) {
  1520. auto& multi_localized_unicode = static_cast<Gfx::ICC::MultiLocalizedUnicodeTagData const&>(tag_data);
  1521. // Try to find 'en-US', otherwise any 'en' language, otherwise the first record.
  1522. Optional<String> en_string;
  1523. constexpr u16 language_en = ('e' << 8) + 'n';
  1524. constexpr u16 country_us = ('U' << 8) + 'S';
  1525. for (auto const& record : multi_localized_unicode.records()) {
  1526. if (record.iso_639_1_language_code == language_en) {
  1527. if (record.iso_3166_1_country_code == country_us)
  1528. return record.text;
  1529. en_string = record.text;
  1530. }
  1531. }
  1532. if (en_string.has_value())
  1533. return en_string.value();
  1534. if (!multi_localized_unicode.records().is_empty())
  1535. return multi_localized_unicode.records().first().text;
  1536. return {};
  1537. }
  1538. if (tag_data.type() == Gfx::ICC::TextDescriptionTagData::Type) {
  1539. auto& text_description = static_cast<Gfx::ICC::TextDescriptionTagData const&>(tag_data);
  1540. return text_description.ascii_description();
  1541. }
  1542. if (tag_data.type() == Gfx::ICC::TextTagData::Type) {
  1543. auto& text = static_cast<Gfx::ICC::TextTagData const&>(tag_data);
  1544. return text.text();
  1545. }
  1546. return {};
  1547. }
  1548. ErrorOr<FloatMatrix3x3> Profile::xyz_to_rgb_matrix() const
  1549. {
  1550. if (!m_cached_xyz_to_rgb_matrix.has_value()) {
  1551. FloatMatrix3x3 forward_matrix = rgb_to_xyz_matrix();
  1552. if (!forward_matrix.is_invertible())
  1553. return Error::from_string_literal("ICC::Profile::from_pcs: matrix not invertible");
  1554. m_cached_xyz_to_rgb_matrix = forward_matrix.inverse();
  1555. }
  1556. return m_cached_xyz_to_rgb_matrix.value();
  1557. }
  1558. FloatMatrix3x3 Profile::rgb_to_xyz_matrix() const
  1559. {
  1560. auto const& red_matrix_column = this->red_matrix_column();
  1561. auto const& green_matrix_column = this->green_matrix_column();
  1562. auto const& blue_matrix_column = this->blue_matrix_column();
  1563. return FloatMatrix3x3 {
  1564. red_matrix_column.X, green_matrix_column.X, blue_matrix_column.X,
  1565. red_matrix_column.Y, green_matrix_column.Y, blue_matrix_column.Y,
  1566. red_matrix_column.Z, green_matrix_column.Z, blue_matrix_column.Z
  1567. };
  1568. }
  1569. }