Fix sun sprite palette slot

1 files changed, 18 insertions, 0 deletions

diff --git a/docs/reference/environment-effects.md b/docs/reference/environment-effects.md
index 31024f7..8045d68 100644
--- a/docs/reference/environment-effects.md
+++ b/docs/reference/environment-effects.md
@@ -189,6 +189,24 @@ OneShot         -> воспроизвести разовый звук молни
 отдельный spatial source, применяет DirectSound range/pan и текущий listener.
 Отсутствие устройства вывода не должно останавливать симуляцию.
 
+## Цвет солнца
+
+Солнце берёт цвет спрайта и прозрачность бликов из `palette[10]` расписания
+`sky.ske`; `palette[9]` — чёрный specular-компонент. Вторичный направленный
+свет использует `palette[14]`. При выборке расписания это выражено так:
+
+```rust
+packed: [key.colors[10], key.colors[14]],
+```
+
+Этот порядок соответствует живому GOG-замеру: `CSun+0x95c` содержал
+`0x41FF3C00` (интерполяция `palette[10]`), `+0x960` — `0xFF000000`
+(`palette[9]`), а `+0x964` — вторичный свет из `palette[14]`. В `Terrain.dll`
+по VA `0x1004AA92..0x1004AAAB` цвет в `+0x95c` обновляется, только если
+установлен бит 0 результата sky-query; иначе остаётся прежнее значение.
+`AtmosphereFrame` пока не несёт этот бит обновления, поэтому sampler
+выдаёт интерполированный цвет при каждом запросе.
+
 ## Что остаётся за владельцем
 
 `EnvironmentSystem` не извлекает камеру из renderer, не разрешает материалы