maszyna/pr-reviews/PR-228.md

Review PR #228 — utilities: XYZtoRGB: Use sRGB colorspace

Autor: @dos1 · base: master · 1 plik, +2/−2 https://github.com/MaSzyna-EU07/maszyna/pull/228

Werdykt: Approve z drobnymi uwagami

Podsumowanie

Zamiana macierzy odwrotnej XYZ→RGB z Adobe RGB na sRGB. Merytorycznie słuszne: reszta pipeline'u (tekstury, framebuffer sRGB, tonemapping) pracuje w sRGB/Rec.709, więc współrzędne Adobe RGB (szerszy gamut) wyświetlane jako sRGB dawały zbyt mało nasycone kolory nieba.

Uwagi

1. Komentarz nad macierzą jest teraz mylący. Nad aktywną linią nadal stoi // M^-1 for Adobe RGB …, a pod zakomentowaną // m^-1 for sRGB:. Proponuję odwrócić komentarze albo usunąć martwą macierz Adobe RGB całkiem — to jest dokładnie to, co Sonar oznacza jako „commented-out code” (S125).
2. Widoczna zmiana wyglądu. Wg CLAUDE.md: „A feature doesn't make existing sceneries look suddenly different after an update”. To jest poprawka błędu, więc mieści się w wyjątku, ale warto w opisie PR jasno napisać, co się zmienia wizualnie (kolor nieba/słońca), najlepiej ze zrzutami przed/po w kilku porach dnia.
3. Renderer GL4.6. Plik utilities/color.h zostaje po migracji, ale warto potwierdzić, czy feat/gl46-migration (#216) korzysta z tej samej funkcji i czy tam też ma iść ta zmiana (albo czy gałąź już ją ma).
4. Opis: literówka „depite” → „despite”.

Sugestia

Rozważyć połączenie/uzgodnienie z #227 (turbidity) — obie zmiany wpływają na ten sam model nieba i dobrze byłoby je przetestować razem.