Команды RPG Maker MV/Показать изображение

Материал из Русская версия РПГ.укр
Внешний вид окна настройки команды «Показать изображение».
Пример изображения, показанного командой «Показать изображение»: в правой верхней части экрана показана роза ветров.

Показать изображениекоманда событий в RPG Maker MV, позволяющая показать изображение или заменить показываемое изображение. Изображения располагаются в папке img/pictures внутри папки проекта.

Доступные настройки[править]

Для данной команды доступны такие параметры:

  • Номер изображения.
  • Файл изображения.
  • Позиция изображения:
    • Что указывается координатами: левый верхний край изображения или его центр.
    • Координаты изображения по X и по Y (в пикселях экрана): либо задаются напрямую, либо из переменных (причём учитывается только значение в переменных на момент вызова команды, будущие изменения не учитываются).
  • Растяжение изображения: масштаб по вертикали и по горизонтали.
  • Смешивание цветов:
    • Степень непрозрачности — число от 0 (полностью прозрачное) до 255 (полностью непрозрачное).
    • Режим смешивания:
      • нормальный (изображение показывается со своими обычными цветами),
      • добавка (цвета изображения прибавляются к цветам под ним, осветляя рисунок),
      • умножение (цвета изображения умножаются на цвета под ним, в результате чёрные области будут чёрными, белые будут исходного цвета),
      • экран (цвета изображения отнимаются от цветов за ним, как будто изображение — это ширма, экран перед картой).

Номера изображений[править]

В каждый момент игры может существовать только одно изображение с определённым номером. Попытка показать другие изображение с тем же номером приведёт к стиранию предыдущего. (Исключение: если изображение было показано на карте, а новое показывается в бою. Изображения на карте и в бою не зависят друг от друга.)

Кроме того, номера изображений определяют их порядок. Изображения с бо́льшими номерами показываются над изображениями с меньшими.

Координаты X и Y[править]

Координата X — это количество пикселей от левого края экрана до изображения (либо до его левого края, либо до центра, в зависимости от настройки «Начало координат»). По умолчанию ширина экрана — 816 пикселей, то есть если X=0, то изображение будет на левом краю экрана, если X=816 — на правом. При этом можно устанавливать значения за границам экрана (например, -100 или 900), тогда часть изображения будет скрыта (или оно всё).

Координата Y — это количество пикселей от верхнего края экрана до изображения (либо до его верхнего края, либо до центра, в зависимости от начала координат). Высота по умолчанию — 624 пикселей, то есть Y=0 разместит изображение вверху экрана, Y=624 — внизу.

Пиксели указываются для не растянутого окна: есть изменить размер окна во время игры, картинки не сдвинутся (просто один пиксель будет условно больше или меньше).

Если размер экрана изменён плагинами, то крайние точки будут не 816x624, а другие (в зависимости от настроек плагина).

Отображение изображений[править]

Изображения показываются на экранах карты и битвы поверх других объектов, но ниже игровых окон.

Изображения, показываемые на карте и в бою, отличаются (их и там, и там 100). Когда команда вызвана на карте, она создаёт изображение на карте; когда в бою, изображение в бою. Боевые изображения удаляются после конца битвы.

Отложенная загрузка изображений[править]

Если изображение раньше не загружалось и не содержится в кэше (во временном хранилище ресурсов), то команда Показать изображение только начнёт его загрузку, и оно появится лишь через некоторое время, после загрузки. Загрузка изображений с локального компьютера обычно занимает не больше нескольких секунд, а при игре через веб-браузер с внешнего сервера может быть больше.

В результате изображение может быть показано через некоторое время после выполнения команды Показать изображение. Чтобы этого избежать, нужно заранее загрузить изображение в кэш. Например, можно перед основным показом изображения показать его за границами экрана, чтобы оно заранее загрузилось.

Способ загрузки изображений в RPG Maker MV изменился по сравнению с прошлым версиями: в VX Ace, VX, XP, 2003 и 2000 изображения загружались сразу же. Это изменение было необходимо для поддержки мультиплатформенности (в частности для запуска в веб-браузерах).

Технические подробности[править]

Внутренний формат[править]

Код команды — 231. Она кодируется таким образом:

   {
     "code": 231,
     "indent": степень_вложенности,
     "parameters": [
       номер_изображения,
       "имя_файла_без_расширения",
       начало_координат,
       способ_задания_координат,
       x,
       y,
       масштаб_по_x,
       масштаб_по_y,
       непрозрачность,
       режим_смешивания_цветов
     ]
   }

Где нужно заменить следующие вещи:

  • степень_вложенности на количество команд, в которые вложена данная команда,
  • номер_изображения на номер, указывающий, какое изображение будет меняться,
  • "имя_файла_без_расширения" на имя файла изображения без расширения,
  • начало_координат — либо 0 (если координаты X и Y задают положение левого верхнего угла изображения), либо 1 (если координаты X и Y задают положение центра изображения),
  • способ_задания_координат — либо 0 (если координаты x и y указываются как числа напрямую в параметрах), либо 1 (если параметры x и y указывают номера переменных, в которых хранятся координаты),
  • x — либо координата по оси X (если способ_задания_координат равен 0), либо номер переменной, в которой хранится эта координата (если способ_задания_координат равен 1),
  • масштаб_по_x — масштаб по горизонтали в процентах (100 — изначальный размер изображения),
  • масштаб_по_y — масштаб по вертикали в процентах (100 — изначальный размер изображения),
  • непрозрачность — число от 0 до 255, указывающее степень непрозрачности изображения (0 — полная прозрачность, 255 — полная непрозрачность),
  • режим_смешивания_цветов — либо 0 (нормальный показ изображения; изображение закрывает фон), либо 1 (аддитивный: цвета изображения делают фон ярче), либо 2 (умножение), либо 3 (screen).