Сборка космических слоёв
Необязательный devices.<device>.render.space_layers версии 1.0 связывает уже рассчитанный inputs.space_scene с подготовленными материалами темы. Реализация — space-layers/1.0.102. Основные схемы коллекции 1 и темы 0.2 сохраняются. Все имена, номера слоёв, пути, палитры и коэффициенты берутся из декларации. Проверки идентификатора конкретной темы нет.
Снимок и порядок работы
Один входной inputs.at даёт один кадр. Время геометрии должно совпадать с ним. Сборка не читает часы, не обращается к сети и не рассчитывает заново орбиту или каталог. Штатное обновление использует почасовые снимки; повторная сборка материалов между ними сохраняет время и входы последнего снимка. Следующий снимок может изменить изображение при прежней погоде. Вне режима space_layers поведение расписания сохранено.
Исходный автомат base/life сначала принимает прежнее решение. Его record.recipe, life_slot, блокировка часа и контекст не заменяются пространственным рецептом. Материализация выполняется после решения и сохраняется в отдельном space_render. На штатной публикации готовый JPEG и JSON публикуются вместе.
Материалы и операции
Импорт обнаруживает файлы из resources относительно asset_root, проверяет PNG, режим и размеры по kind и включает их в архив/индекс устройства с SHA-256. Отсутствие обязательного материала оставляет совместимый исходный рецепт. Текстуры не объявляются обычными готовыми overlays. Проверяется безопасный относительный путь.
solid_rgb— непрозрачная основа.catalog_sprites— переданные точки Hipparcos, поиск колонок по имени, порядок HIP, объявленная палитра B−V, билинейный premultiplied-спрайт. Случайные звёзды и линии созвездий не добавляются.sun_disc,earth_sphere,moon_camera_disc— пересечения лучей со сферами и сравнение глубины на фиксированной сетке 2×2. Центр вне кадра не скрывает видимую часть. Земная текстура вращается через ITRS, долгота заворачивается; освещение и ночная эмиссия вычисляются в linear RGB. Лунный лик полный, фазу и тёмную непрозрачную сторону задаёт геометрия.surface_group— выбранные прежним рецептом компоненты корпуса. Материал выбирается точно поselected.asset. Альфа служебного слоя выполняет destination-out только на корпусе; его старый RGB-фон не рисуется.normal_rtn— нормали в RTN, прямой свет с коэффициентом тени/полутени, ambient и независимая эмиссия.unlitсохраняет исходные пиксели.relight_layersсохраняют id/order/opacity; opacity применяется один раз итоговым композитором. Galaga не получает второго освещения; передние отбойники сохраняют объявленный порядок.
Все выходы полноразмерные. Первый слой RGB с opacity 1; следующие RGBA. Диски усредняются в premultiplied linear RGBA и кодируются в sRGB с round-half-up. Итоговые PNG собирает прежний source-over-композитор в sRGB. Числа вычисляются в float64, матрицы проверяются на ортонормальность и согласованность. Коллизия id/order — ошибка декларации.
Перекрытие отдельного аппарата
В необязательном словаре occlusion_masks ключ совпадает с точным ID из assets устройства, а значение ссылается на ресурс того же устройства с kind: "l_occlusion". Файл ресурса представляет собой 8-битный PNG режима L в размер холста и задаётся относительно asset_root. Один ресурс может использоваться несколькими ID аппаратов.
{
"resources": {
"civil_0_mask": {"kind": "l_occlusion", "file": "render/masks/civil_0.png"}
},
"occlusion_masks": {"civil_0": "civil_0_mask"}
}
Маска применяется, когда исходный рецепт выбрал этот asset и слой остался самостоятельным после drop_layers и surface_group. После освещения, перед source-over, сборщик меняет только альфу слоя по формуле A_out = floor(A_in × (255 − M) / 255). Чёрный оставляет пиксель, белый скрывает его, серый даёт частичное перекрытие. RGB, ID, порядок и opacity сохраняются. Итоговый композитор применяет opacity один раз.
Корпус, тени и общий передний план front_pad_occlusion идут отдельными слоями по рецепту. Если общий передний план уже перекрывает тот же полупрозрачный край, исключите его из индивидуальной маски.
Неизвестный ID ассета, отсутствующее объявление ресурса или неверный kind считаются ошибкой декларации. Ошибка файла выбранной маски даёт штатный fallback с причиной и ID ресурса. Файл невыбранной маски на кадр и его эффективный ключ не влияет. Для выбранной маски в ключ входят привязка и хеш содержимого. Повторное воспроизведение использует сохранённые слои.
Отчёт, кеш и воспроизведение
space_render.status бывает ready, partial, fallback. Готовность геометрии в space_scene.status не подменяет готовность изображений. Недоступный каталог даёт прозрачные звёзды и partial; недоступная геометрия, неподдерживаемая операция или ошибочный материал дают fallback с причиной и прежним рецептом. Другие устройства продолжают работу.
Отчёт содержит frame_at, версию алгоритма и зависимостей, SHA-256 привязок, эффективных входов, исходного рецепта, ресурсов и готовых PNG, отдельный materialized_recipe. Неизвестные необязательные поля сохраняются, но не исполняются и не меняют эффективный ключ. Ранний reused проверяется после материализации/сравнения ключа.
Приватное хранилище state_dir/dynamic/space-assets/objects/<sha256> сохраняет версии исходных выбранных PNG, материалов, JSON темы и производных слоёв по содержимому. В рецепте используются виртуальные безопасные пути source/... и generated/<sha256>.png, разрешаемые по asset_manifest. Хранилище не очищается при смене текущей ревизии. Каталог Hipparcos не копируется в кадр. Воспроизведение использует сохранённую тему и пиксели, поэтому текущая тема может быть изменена или отсутствовать. Для побайтного совпадения JPEG нужен тот же набор зависимостей.
Пример воспроизведения на сервере; путь state_dir берётся из действующей конфигурации:
./.venv/bin/python games/gremlin_dynamic_wallpapers.py --state /путь/к/current.json --space-assets /путь/к/state_dir/dynamic/space-assets --output /путь/к/replay.jpg
Поставка темы
В контракте приведены 148 будущих ресурсов и 303 точных привязки прежних ассетов. Архив контракта не содержит этих PNG. Код сборщика и примеры не делают существующий художественный пакет готовым к новому режиму: автору темы нужны материалы, затем в профиль добавляется space_layers. Исходные рисунки и production theme.json этим выпуском кода не заменяются. При отсутствии блока прежняя сборка сохраняется.
Схема привязок · Схема результата · Пример FullHD · Пример 4K · Астрономия
Необязательные PNG-мастер, независимая активность, календарь темы и облака/атмосфера: расширения 1.0.90.