ladybird/Libraries/LibGfx
Lucas CHOLLET 6affbf78c2
Some checks are pending
CI / Lagom (false, FUZZ, ubuntu-24.04, Linux, Clang) (push) Waiting to run
CI / Lagom (false, NO_FUZZ, macos-15, macOS, Clang) (push) Waiting to run
CI / Lagom (false, NO_FUZZ, ubuntu-24.04, Linux, GNU) (push) Waiting to run
CI / Lagom (true, NO_FUZZ, ubuntu-24.04, Linux, Clang) (push) Waiting to run
Package the js repl as a binary artifact / build-and-package (macos-14, macOS, macOS-universal2) (push) Waiting to run
Package the js repl as a binary artifact / build-and-package (ubuntu-24.04, Linux, Linux-x86_64) (push) Waiting to run
Run test262 and test-wasm / run_and_update_results (push) Waiting to run
Lint Code / lint (push) Waiting to run
Push notes / build (push) Waiting to run
LibGfx: Adjust matrices for XYZ -> sRGB conversions
TL;DR: There are two available sets of coefficients for the conversion
matrices from XYZ to sRGB. We switched from one set to the other, which
is what the WPT tests are expecting.

All RGB color spaces, like display-p3 or rec2020, are defined by their
three color chromacities and a white point. This is also the case for
the video color space Rec. 709, from which the sRGB color space is
derived. The sRGB specification is however a bit different.

In 1996, when formalizing the sRGB spec the authors published a draft
that is still available here [1]. In this document, they also provide
the matrix to convert from the XYZ color space to sRGB. This matrix can
be verified quite easily by using the usual math equations. But hold on,
here come the plot twist: at the time of publication, the spec contained
a different matrix than the one in the draft (the spec is obviously
behind a pay wall, but the numbers are also reported in this official
document [2]). This official matrix, is at a first glance simply a
wrongly rounded version of the one in the draft publication. It however
has some interesting properties: it can be inverted twice (so a
roundtrip) in 8 bits and not suffer from any errors from the
calculations.

So, we are here with two versions of the XYZ -> sRGB matrix, the one
from the spec, which is:
 - better for computations in 8 bits,
 - and official. This is the one that, by authority, we should use.
And a second version, that can be found in the draft, which:
 - makes sense, as directly derived from the chromacities,
 - is publicly available,
 - and (thus?) used in most places.

The old coefficients were the one from the spec, this commit change them
for the one derived from the mathematical formulae. The Python script to
compute these values is available at the end of the commit description.

More details about this subject can be found here [3].

[1] https://www.w3.org/Graphics/Color/sRGB.html
[2] https://color.org/chardata/rgb/sRGB.pdf
[3] https://photosauce.net/blog/post/making-a-minimal-srgb-icc-profile-part-3-choose-your-colors-carefully

The Python script:

```python
# http://www.brucelindbloom.com/index.html?Eqn_RGB_XYZ_Matrix.html

from numpy.typing import NDArray
import numpy as np

### sRGB
# https://www.w3.org/TR/css-color-4/#predefined-sRGB
srgb_r_chromacity = np.array([0.640, 0.330])
srgb_g_chromacity = np.array([0.300, 0.600])
srgb_b_chromacity = np.array([0.150, 0.060])
##

## White points
white_point_d50 = np.array([0.345700, 0.358500])
white_point_d65 = np.array([0.312700, 0.329000])
#

r_chromacity = srgb_r_chromacity
g_chromacity = srgb_g_chromacity
b_chromacity = srgb_b_chromacity
white_point = white_point_d65

def tristmimulus_vector(chromacity: NDArray) -> NDArray:
    return np.array([
        chromacity[0] /chromacity[1],
        1,
        (1 - chromacity[0] - chromacity[1]) / chromacity[1]
    ])

tristmimulus_matrix = np.hstack((
    tristmimulus_vector(r_chromacity).reshape(3, 1),
    tristmimulus_vector(g_chromacity).reshape(3, 1),
    tristmimulus_vector(b_chromacity).reshape(3, 1),
))

scaling_factors = (np.linalg.inv(tristmimulus_matrix) @
                   tristmimulus_vector(white_point))

M = tristmimulus_matrix * scaling_factors

np.set_printoptions(formatter={'float_kind':'{:.6f}'.format})
xyz_65_to_srgb = np.linalg.inv(M)

# http://www.brucelindbloom.com/index.html?Eqn_ChromAdapt.html
# Let's convert from D50 to D65 using the Bradford method.
m_a = np.array([
    [0.8951000, 0.2664000, -0.1614000],
    [-0.7502000, 1.7135000, 0.0367000],
    [0.0389000, -0.0685000, 1.0296000]
])

cone_response_source = m_a @ tristmimulus_vector(white_point_d50)
cone_response_destination = m_a @ tristmimulus_vector(white_point_d65)

cone_response_ratio = cone_response_destination / cone_response_source
m = np.linalg.inv(m_a) @ np.diagflat(cone_response_ratio) @ m_a

D50_to_D65 = m
xyz_50_to_srgb = xyz_65_to_srgb @ D50_to_D65

print(xyz_50_to_srgb)
print(xyz_65_to_srgb)
```
2024-11-17 22:18:40 +01:00
..
Font Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ICC Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ImageFormats Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
AffineTransform.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
AffineTransform.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
AntiAliasingPainter.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
AntiAliasingPainter.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Bitmap.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Bitmap.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
BitmapSequence.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
BitmapSequence.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
BoundingBox.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
CIELAB.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
CMakeLists.txt Meta+LibGfx: Exclude Metal and Vulkan headers from Clang module map 2024-11-15 10:51:45 -07:00
CMYKBitmap.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
CMYKBitmap.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Color.cpp LibGfx: Adjust matrices for XYZ -> sRGB conversions 2024-11-17 22:18:40 +01:00
Color.h LibWeb/CSS: Add support for the rec2020 color space in color() 2024-11-16 10:29:46 +01:00
Color.swift Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeltaE.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeltaE.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeprecatedPainter.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeprecatedPainter.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeprecatedPath.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
DeprecatedPath.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
EdgeFlagPathRasterizer.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
EdgeFlagPathRasterizer.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
FontCascadeList.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
FontCascadeList.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Forward.h LibGfx: Delete unused DisjointRectSet 2024-11-11 02:46:35 +01:00
FourCC.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
GradientPainting.cpp LibGfx: Delete unused paint styles 2024-11-11 02:46:35 +01:00
Gradients.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ImmutableBitmap.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ImmutableBitmap.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Line.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
LineStyle.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Matrix.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Matrix3x3.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Matrix4x4.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
MedianCut.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
MedianCut.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
MetalContext.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
MetalContext.mm Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Orientation.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Painter.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Painter.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
PainterSkia.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
PainterSkia.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
PaintingSurface.cpp LibGfx: Add a method to copy a Bitmap to a PaintingSurface 2024-11-13 14:38:39 +01:00
PaintingSurface.h LibGfx: Add a method to copy a Bitmap to a PaintingSurface 2024-11-13 14:38:39 +01:00
PaintStyle.h LibGfx: Delete unused paint styles 2024-11-11 02:46:35 +01:00
Palette.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Palette.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Path.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Path.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
PathSkia.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
PathSkia.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Point.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Point.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Quad.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Rect.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Rect.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ScalingMode.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ShareableBitmap.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
ShareableBitmap.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Size.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Size.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
SkiaBackendContext.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
SkiaBackendContext.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
StandardCursor.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
SystemTheme.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
SystemTheme.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
TextAlignment.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
TextAttributes.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
TextLayout.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
TextLayout.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
TIFFGenerator.py Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Triangle.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Triangle.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Vector2.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Vector3.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
Vector4.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
VectorGraphic.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
VectorGraphic.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
VectorN.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
VulkanContext.cpp Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
VulkanContext.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00
WindingRule.h Everywhere: Hoist the Libraries folder to the top-level 2024-11-10 12:50:45 +01:00