/* * Copyright (c) 2022, Nico Weber * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include // V2 spec: https://color.org/specification/ICC.1-2001-04.pdf // V4 spec: https://color.org/specification/ICC.1-2022-05.pdf namespace Gfx::ICC { namespace { // ICC V4, 4.2 dateTimeNumber // "All the dateTimeNumber values in a profile shall be in Coordinated Universal Time [...]." struct DateTimeNumber { BigEndian year; BigEndian month; BigEndian day; BigEndian hour; BigEndian minutes; BigEndian seconds; }; ErrorOr parse_date_time_number(DateTimeNumber const& date_time) { // ICC V4, 4.2 dateTimeNumber // "Number of the month (1 to 12)" if (date_time.month < 1 || date_time.month > 12) return Error::from_string_literal("ICC::Profile: dateTimeNumber month out of bounds"); // "Number of the day of the month (1 to 31)" if (date_time.day < 1 || date_time.day > 31) return Error::from_string_literal("ICC::Profile: dateTimeNumber day out of bounds"); // "Number of hours (0 to 23)" if (date_time.hour > 23) return Error::from_string_literal("ICC::Profile: dateTimeNumber hour out of bounds"); // "Number of minutes (0 to 59)" if (date_time.minutes > 59) return Error::from_string_literal("ICC::Profile: dateTimeNumber minutes out of bounds"); // "Number of seconds (0 to 59)" // ICC profiles apparently can't be created during leap seconds (seconds would be 60 there, but the spec doesn't allow that). if (date_time.seconds > 59) return Error::from_string_literal("ICC::Profile: dateTimeNumber seconds out of bounds"); struct tm tm = {}; tm.tm_year = date_time.year - 1900; tm.tm_mon = date_time.month - 1; tm.tm_mday = date_time.day; tm.tm_hour = date_time.hour; tm.tm_min = date_time.minutes; tm.tm_sec = date_time.seconds; // timegm() doesn't read tm.tm_isdst, tm.tm_wday, and tm.tm_yday, no need to fill them in. time_t timestamp = timegm(&tm); if (timestamp == -1) return Error::from_string_literal("ICC::Profile: dateTimeNumber not representable as timestamp"); return timestamp; } // ICC V4, 7.2 Profile header struct ICCHeader { BigEndian profile_size; BigEndian preferred_cmm_type; u8 profile_version_major; u8 profile_version_minor_bugfix; BigEndian profile_version_zero; BigEndian profile_device_class; BigEndian data_color_space; BigEndian profile_connection_space; // "PCS" in the spec. DateTimeNumber profile_creation_time; BigEndian profile_file_signature; BigEndian primary_platform; BigEndian profile_flags; BigEndian device_manufacturer; BigEndian device_model; BigEndian device_attributes; BigEndian rendering_intent; BigEndian pcs_illuminant_x; BigEndian pcs_illuminant_y; BigEndian pcs_illuminant_z; BigEndian profile_creator; u8 profile_md5[16]; u8 reserved[28]; }; static_assert(sizeof(ICCHeader) == 128); ErrorOr parse_version(ICCHeader const& header) { // ICC v4, 7.2.4 Profile version field if (header.profile_version_zero != 0) return Error::from_string_literal("ICC::Profile: Reserved version bytes not zero"); return Version(header.profile_version_major, header.profile_version_minor_bugfix); } ErrorOr parse_device_class(ICCHeader const& header) { // ICC v4, 7.2.5 Profile/device class field switch (header.profile_device_class) { case DeviceClass::InputDevce: case DeviceClass::DisplayDevice: case DeviceClass::OutputDevice: case DeviceClass::DeviceLink: case DeviceClass::ColorSpace: case DeviceClass::Abstract: case DeviceClass::NamedColor: return header.profile_device_class; } return Error::from_string_literal("ICC::Profile: Invalid device class"); } ErrorOr parse_color_space(ColorSpace color_space) { // ICC v4, Table 19 — Data colour space signatures switch (color_space) { case ColorSpace::nCIEXYZ: case ColorSpace::CIELAB: case ColorSpace::CIELUV: case ColorSpace::YCbCr: case ColorSpace::CIEYxy: case ColorSpace::RGB: case ColorSpace::Gray: case ColorSpace::HSV: case ColorSpace::HLS: case ColorSpace::CMYK: case ColorSpace::CMY: case ColorSpace::TwoColor: case ColorSpace::ThreeColor: case ColorSpace::FourColor: case ColorSpace::FiveColor: case ColorSpace::SixColor: case ColorSpace::SevenColor: case ColorSpace::EightColor: case ColorSpace::NineColor: case ColorSpace::TenColor: case ColorSpace::ElevenColor: case ColorSpace::TwelveColor: case ColorSpace::ThirteenColor: case ColorSpace::FourteenColor: case ColorSpace::FifteenColor: return color_space; } return Error::from_string_literal("ICC::Profile: Invalid color space"); } ErrorOr parse_data_color_space(ICCHeader const& header) { // ICC v4, 7.2.6 Data colour space field return parse_color_space(header.data_color_space); } ErrorOr parse_connection_space(ICCHeader const& header) { // ICC v4, 7.2.7 PCS field // and Annex D auto space = TRY(parse_color_space(header.profile_connection_space)); if (header.profile_device_class != DeviceClass::DeviceLink && (space != ColorSpace::PCSXYZ && space != ColorSpace::PCSLAB)) return Error::from_string_literal("ICC::Profile: Invalid profile connection space: Non-PCS space on non-DeviceLink profile"); return space; } ErrorOr parse_rendering_intent(ICCHeader const& header) { // ICC v4, 7.2.15 Rendering intent field switch (header.rendering_intent) { case 0: return RenderingIntent::Perceptual; case 1: return RenderingIntent::MediaRelativeColorimetric; case 2: return RenderingIntent::Saturation; case 3: return RenderingIntent::ICCAbsoluteColorimetric; } return Error::from_string_literal("ICC::Profile: Invalid rendering intent"); } ErrorOr parse_creation_date_time(ICCHeader const& header) { // iCC v4, 7.2.8 Date and time field return parse_date_time_number(header.profile_creation_time); } ErrorOr parse_file_signature(ICCHeader const& header) { // iCC v4, 7.2.9 Profile file signature field if (header.profile_file_signature != 0x61637370) return Error::from_string_literal("ICC::Profile: profile file signature not 'acsp'"); return {}; } } StringView device_class_name(DeviceClass device_class) { switch (device_class) { case DeviceClass::InputDevce: return "InputDevce"sv; case DeviceClass::DisplayDevice: return "DisplayDevice"sv; case DeviceClass::OutputDevice: return "OutputDevice"sv; case DeviceClass::DeviceLink: return "DeviceLink"sv; case DeviceClass::ColorSpace: return "ColorSpace"sv; case DeviceClass::Abstract: return "Abstract"sv; case DeviceClass::NamedColor: return "NamedColor"sv; } VERIFY_NOT_REACHED(); } StringView data_color_space_name(ColorSpace color_space) { switch (color_space) { case ColorSpace::nCIEXYZ: return "nCIEXYZ"sv; case ColorSpace::CIELAB: return "CIELAB"sv; case ColorSpace::CIELUV: return "CIELUV"sv; case ColorSpace::YCbCr: return "YCbCr"sv; case ColorSpace::CIEYxy: return "CIEYxy"sv; case ColorSpace::RGB: return "RGB"sv; case ColorSpace::Gray: return "Gray"sv; case ColorSpace::HSV: return "HSV"sv; case ColorSpace::HLS: return "HLS"sv; case ColorSpace::CMYK: return "CMYK"sv; case ColorSpace::CMY: return "CMY"sv; case ColorSpace::TwoColor: return "2 color"sv; case ColorSpace::ThreeColor: return "3 color (other than XYZ, Lab, Luv, YCbCr, CIEYxy, RGB, HSV, HLS, CMY)"sv; case ColorSpace::FourColor: return "4 color (other than CMYK)"sv; case ColorSpace::FiveColor: return "5 color"sv; case ColorSpace::SixColor: return "6 color"sv; case ColorSpace::SevenColor: return "7 color"sv; case ColorSpace::EightColor: return "8 color"sv; case ColorSpace::NineColor: return "9 color"sv; case ColorSpace::TenColor: return "10 color"sv; case ColorSpace::ElevenColor: return "11 color"sv; case ColorSpace::TwelveColor: return "12 color"sv; case ColorSpace::ThirteenColor: return "13 color"sv; case ColorSpace::FourteenColor: return "14 color"sv; case ColorSpace::FifteenColor: return "15 color"sv; } VERIFY_NOT_REACHED(); } StringView profile_connection_space_name(ColorSpace color_space) { switch (color_space) { case ColorSpace::PCSXYZ: return "PCSXYZ"sv; case ColorSpace::PCSLAB: return "PCSLAB"sv; default: return data_color_space_name(color_space); } } StringView rendering_intent_name(RenderingIntent rendering_intent) { switch (rendering_intent) { case RenderingIntent::Perceptual: return "Perceptual"sv; case RenderingIntent::MediaRelativeColorimetric: return "Media-relative colorimetric"sv; case RenderingIntent::Saturation: return "Saturation"sv; case RenderingIntent::ICCAbsoluteColorimetric: return "ICC-absolute colorimetric"sv; } VERIFY_NOT_REACHED(); } Flags::Flags() = default; Flags::Flags(u32 bits) : m_bits(bits) { } ErrorOr> Profile::try_load_from_externally_owned_memory(ReadonlyBytes bytes) { auto profile = adopt_ref(*new Profile()); if (bytes.size() < sizeof(ICCHeader)) return Error::from_string_literal("ICC::Profile: Not enough data for header"); auto header = *bit_cast(bytes.data()); TRY(parse_file_signature(header)); profile->m_version = TRY(parse_version(header)); profile->m_device_class = TRY(parse_device_class(header)); profile->m_data_color_space = TRY(parse_data_color_space(header)); profile->m_connection_space = TRY(parse_connection_space(header)); profile->m_creation_timestamp = TRY(parse_creation_date_time(header)); profile->m_flags = Flags { header.profile_flags }; profile->m_rendering_intent = TRY(parse_rendering_intent(header)); return profile; } }