pgames-manager/docs/SCREENS.md

Экраны Ren'Py (screen)

Игры показывают свой интерфейс (HUD, карты-хотспоты, телефон, инвентарь) экранами screen. Конвертер переводит их в IR, плеер строит из IR DOM и пересчитывает его при каждом изменении состояния. Выражения выполняются в той же песочнице Python, что и сценарий.

• разбор: backend/app/converter/screens.py (язык экранов), rpy_parser.py (screen, style, call/show/hide screen), atl.py (анимации виджетов);
• плеер: frontend/src/player/screens.ts, подключение — в engine.ts.

Что поддерживается

• Операторы сценария: call screen name(args) (ждёт Return, значение в _return), show screen, hide screen; из Python — renpy.show_screen, renpy.hide_screen.
• Контейнеры: fixed, frame, window, vbox, hbox, grid, vpgrid, viewport (прокрутка), button, has.
• Элементы: text, label, textbutton, imagebutton (idle/hover/insensitive/auto), add, null, bar/vbar (отображение и перетаскивание для VariableValue).
• Управление: if/elif/else, showif, for, use (в том числе с transclude), default, $ и python:, key, timer, on "show"/"hide".
• Свойства: размеры, позиции и якоря, отступы, spacing, background/foreground, crop, цвета и шрифты текста, outlines, alpha, zoom, rotate, blur, selected, sensitive, tooltip (GetTooltip()), hover_sound/activate_sound, at с анимированными transform, условные свойства (if внутри виджета, который только задаёт свойства).
• Стили: style name is parent: и style_prefix; состояния idle_/hover_/selected_/ insensitive_. Неизвестные декоративные свойства стилей молча отбрасываются.
• Действия: Jump, Call, Return, SetVariable, ToggleVariable, SetScreenVariable, ToggleScreenVariable, SetDict, SetField, ToggleField, Show, Hide, ToggleScreen, Function, Play, Stop, Notify, If, SelectedIf, SensitiveIf, NullAction, Language, ShowMenu (открывает меню плеера), OpenURL (только http/https), Quit, MainMenu.
• Изображения-значения: Crop, LiveCrop, Solid, Frame, Null, Transform, DynamicDisplayable, Color.

Стандартные экраны движка (say, choice, input, главное меню, настройки, сохранения, история) плеер не использует: у него свой интерфейс. ShowMenu("preferences") открывает его меню.

Правила импорта

Экран проверяется только если игра его показывает (call/show screen, Show("name"), renpy.show_screen("name"), use name). Неподдерживаемое внутри такого экрана останавливает импорт, внутри неиспользуемого (например, стандартного) — нет. Экран, который вызывают, но нигде не определили, тоже останавливает импорт. Экраны для variant "touch"/"phone" отбрасываются.

Ограничения

• Шейдеры (shader, mesh, u_*) не исполняются; про слои экранов (onlayer), камеру, текстовые теги и остальное, что плеер делает как Ren'Py, — docs/RENPY_PLAYER.md.
• Экран перестраивается целиком; положение прокрутки сохраняется, фокус и ввод — нет.
• Позиции без точки (xpos 1) читаются как доля, а целые больше 1 — как пиксели.
• Фокус с клавиатуры — только Tab и Enter/Space на кнопках.