This article's documentation is for anything that uses the Source engine. Click here for more information.

script_intro

Материал из Valve Developer Community
Перейти к: навигация, поиск
English (en)Русский (ru)
... Icon-Important.png

script_intro — это точечный объект мира, доступный во всех играх на платформе Source Source.

Описание энтити

Энтити script_intro является единственным объектом, который используется для интро-сцен только в одиночных играх Valve, таких как Half-life 2 и её эпизодах. Она использует возможности DirectX’s рендера, когда на основное изображение (камера или зрение игрока) накладывается второстепенная картинка из другого источника, с примесью различных эффектов и переходов. Очень удобно для плавной смены ракурсов.

Некоторые эффекты данной энтити можно использовать для имитирования зрительных галлюцинаций или же снов наяву. Традиционно плавные переходы от камеры А к В используются в различных машинимах .

Главная проблема в понимании работы этой энтити заключается в том, что она очень зависит от таймингом выполнения различных Outputs команд. Недостаточно просто выставить нужные команды, ещё нужно подгадать интервалы времени между различными действиями, чтобы всё работало без багов. Для комфортной работы в данной энтити, нужен опыт. терпение и время.

Использование script_intro

У этой энтити есть всего один ключ, и это targetname. Как только у вас есть его имя, Вся работа с ним сводится к посылке в него инпут команд. Смешанный вид (ссо сконфигурированным к настоящему времени параметрами) включается через инпут Activate. Перед тем, как вы вызовите Activate, есть несколько вводов (инпутов), которым вам следует послать для инициализации энтити, так что переход от обычного вида игрока к смешанному происходит плавно. Этми инпутами являются: SetCameraViewEntity, SetFOV, FadeTo, SetFadeColor и SetBlendMode.

Начиная с инпута SetCameraViewEntity , с помощью имени энтити камеры (point_camera), вид из которой вы собираетесь следующим, в качестве параметра. Камера автоматически активирует инпут Activate указанный в script_intro. Помните, точка зрения игрока это первая камера, так что в привычных терминах, игрок это Камера A, а point_camera, использующаяся вscript_intro это Камера. Последующий необязательный инпут SetFOV установит нужный угол обзора для камеры B. Если вы также хотите управлять углом обзора камеры A, используйте энтити env_zoom. Обратите внимание, вам не обязательно активироватьSetCameraViewEntity; в этом случае инпут для камеры B будет абсолютно черным и вы сможете использовать энтити для всяких пост-процессинг эффектов, применяемых к виду от лица игрока.

Далее вы можете использовать инпуты SetFadeColor и FadeTo, чтобы опционально применить дополнительное смешивание сплошного цвета к двум камерам, как только энтити активировано. SetFadeColor (по умолчанию 0 0 0) определяет цвет, который добавляется к смешиванию, а FadeTo определяет прозрачность этого цвета в смешении. Вы используете инпут для отсылки параметра с одним или двумя значениями, разделенными пробелом. Первое значение это целое число от 0 до 255, где 255 это полная непрозрачность, а 0 (по умолчанию) это полная прозрачность (то есть никакой цвет не подмешивается в вид). Второе значение это число в секундах, за которые случится затухание. При первоначальном конфигурировании энтити, используйте значение 0 для второго параметра, чтобы изменения наступали сразу.

Наконец, вы можете изменить режим смешивания по умолчанию с помощью SetBlendMode. Хорошим выбором для начала является число 8 (см. список ниже), т.к. он учитывает только Камеру A и игронирует камеру B, позволяя сделать плавный переход. Если у вас нет камеры B, то и 0 (по умолчанию) подойдет неплохо.

С этого момента вы можете вызвать инпут Activate, чтобы включить смешанный виддля полностью сконфигурированной энтити. Затем вы можете использовать SetNextBlendMode, SetNextBlendTime, SetNextFOV, SetFOVBlendTime и FadeTo для достижения эффекта перехода.

SetNextBlendMode с параметром 6 выглядит наиболее реалистично. При завершении будет получена прямая аддитивная смесь вида двух камер. Другие режимы смешивания дадут специальные эффекты, такие как черно-белый негатив, который можно видеть в интро HL2. Инпут SetNextBlendMode с параметром от 0 до 9 даст различный эффект для каждого значения. Это устанавливает значение смешивания, далее вы используете инпут SetNextBlendTime, чтобы выполнить само смешивание с параметром, идентичным длительности эффекта перехода в секундах. Режим смешивания приведет к смене эффектов камеры одного за другим.

SetNextFOV и SetFOVBlendTime нужны для сглаживания переходов FOV камеры B от одного значения (по умолчанию) к следующему, в противном случае он работают аналогично SetNextBlendMode и SetNextBlendTime.

Наконец, инпуты SetFadeColor и FadeTo могут быть использованы для сглаживания смешивания цельного цвета в вид (похоже на env_fade). Чтобы избежать резкого изменения цвета, применяйте толькоSetFadeColor когда альфа параметраFadeTo установлена в 0. После того, как вы установите цвет затухания, выполните инпут FadeTo с желаемой величиной затухания и его длительностью. Например, установка цвета затухания в "255 255 255", а затем выполнение FadeTo со значениями "127 5" приведет к затуханию зрения игрока в молочно белый цвет за 5 секунд. Следует отметить, что инпут FadeTo используется хакерски в интро для затухания вида от лица игрока. Это связано с тем, что энтити env_fade не может быть повторена, т.е. не может быть двух энтити env_fade и вызывать затухание из одной в другую.

После того, как Вы наиграетесь с камерой игрока, Вы можете вернуть нормальный вид для камер с помощью команды Deactivate , а чтобы отключить их, можно воспользоваться SetOff, данная команда отключает все камеры, которые используются Вами.



Blend modes Методы смешивания

Это перечень доступных методов смешивания. Они работают при использовании команд SetNextBlendMode и SetNextBlendTime или же просто SetBlendMode.

  • 0: Камера А в нормальном цвете, камера В в негативе серого канала. Примечание, если камера А не используется, вместо неё подразумевается камера игрока. Это значение используется по умолчанию.
  • 1:Камера А в негативном цвете, камера В с нормальным серым оттенком.
  • 2: Камера А с нормальным серым оттенком, камера В в нормальном цвете. (нет смешивания)
  • 3: Камера А с нормальным серым оттенком, камера В с нормальным цветом. Камера В, говоря простым языком, выдаёт черно белую картинку и обе камеры полупрозрачны.
  • 4:Обе камеры А и В в нормальном цвете, почти тоже самое что и 2 (3) методы.
  • 5: Камера А пастеризованного цвета, камера В нормального цвета, но на черном фоне камеры В будет проецироваться изображение с камеры А ( в общем, некий хромакей, только вместо зеленого фона должен использоваться черный)
  • 6: Обе камеры в нормальном цвете аддитивное смешивание. В целом всё как в 3 методе, но картинка цветная и слегка засвечена.
  • 7: Камера А не рендерится, камера В нормальном цвете. Это может быть использовано как point_viewcontrol, когда нужно ограничить обзор игрока. (сомнительная идея)
  • 8: Камера А в нормальном цвете, камера В пуста. Противоположность 7 методу.
  • {{EP2 add|9: Обе камеры А и В в нормальном цвете. Данный метод очень похож на 5, только наоборот. Плюс ко всему, полупрозрачность между обеими камерами.

.

Note.pngПримечание:Приведенные выши опции работают только на DX9 системах и выше. На более старых DirectX могут не работать. Боже, 2020 год, о чем это я?


Примеры использования

Осмотрите карты Half-Life 2 (и эпизодов) чтобы понять принцип работы энтити:

Прямой переход от камеры игрока к обычной камере и назад в течении 10 сек (предполагается, что Вы будете использовать script_intro с именем "fxintro" на карте и камера будет носить имя "b_camera", также используется OnTrigger для запуска Outputs скриптов). 

"OnTrigger" "fxintro,SetCameraViewEntity,b_camera,0,-1"
"OnTrigger" "fxintro,SetBlendMode,8,0.01,-1"
"OnTrigger" "fxintro,Activate,,0.02,-1"
"OnTrigger" "fxintro,SetNextBlendMode,7,0.03,-1"
"OnTrigger" "fxintro,SetNextBlendTime,5,0.04,-1"
"OnTrigger" "fxintro,SetNextBlendMode,8,5.05,-1"
"OnTrigger" "fxintro,SetNextBlendTime,5,5.06,-1"
"OnTrigger" "fxintro,Deactivate,,10.06,-1"
"OnTrigger" "b_camera,SetOff,,10.07,-1"

Баги

  • script_intro Не работает полноценно на картах использующих 3D скайбоксы. В зависимости от версии движка, вылазят разные баги. Например, 2D скайбокс может казаться черным, либо вообще могут не срабатывать визуальные эффекты. Дабы избежать нежелательных последствий, не используйте script_intro на картах с 3D скайбоксами, либо реализуйте эффекты лишь в тех местах, где не будет видно небо.
  • Viewmodels, если они присутствуют (в поле зрения игрока) в момент проигрывания script_intro, то не будут корректно отображаться (видны только 2д элементы (спрайты вспышек итд)) . Следует отнимать оружие у игрока для таких сцен или же использовать второй стороннюю камеру в игре (две камеры А и В)

Обе проблемы из-за скайбоксов и оружия в руках.

Исправление кода:  Проблему со скайбоксом можно обойти, если передвинуть подготовку (setup) из CSkyboxView в CViewRender::RenderView(), чтобы она происходила после того, как вторая камера отрисует интро сцену. Таким образом, она будет разделена на два инстанса, первый непосредственно перед CViewRender::ViewDrawScene() , а другой инстанс подготовки (setup) из CViewRender::ViewDrawScene_Intro(), вскоре после блока m_bDrawPrimary. Это работает, если мы поместим ее перед g_pClientShadowMgr->PreRender(). Чистый фон будет удален, по крайней мере, пока вычисляется визуализация скайбокса.
Подтвердить:Приводит ли удаление VIEW_CLEAR_COLOR к прекращению корректной работы VortWarp?
Исправление кода: Баг с viewmodel можно обойти отключив обычный вызов CViewRender::DrawViewModels() в CViewRender::RenderView(), когда активен код intro, и добавив отдельный вызов в CViewRender::ViewDrawScene_Intro() перед составлением intro_screenspaceeffect. Это работает, если мы поместим его сразу после main DrawWorldAndEntities.

Keyvalues (свойства энтити)

Match env_zoom's FOV transition (???) <boolean>
Использовать ли плавный зум как в env_zoom.

Targetname:
Name (targetname) <string>
The targetname that other entities refer to this entity by.

Inputs (Входящие команды)

Activate
Объект готов к работе.
Deactivate
Объект выключен.
SetCameraViewEntity
Имя камеры, чья картинка будет смешиваться (камер может быть две)
SetBlendMode
Выбрать метод смешивания
SetFOV
Установить уровень FOV (зум)
SetNextFOV
Установить следующий уровень FOV, используется с SetFOVBlendTime командой в паре.
SetFOVBlendTime
Установить время перехода от исходного значения FOV к указанному выше.
SetNextBlendMode
Установить следующий метод смешивания с SetNextBlendTime командой в паре
SetNextBlendTime
Установить время перехода между двумя методами смешивания, смотри выше
FadeTo
Установить прозрачность экрана <альфа> и переход<длительность>
SetFadeColor
указать цвет затемнения экрана <красный> <зеленый> <синий>


Kill
Удаляет этот энтити из мира.
KillHierarchy
Удаляет энтити и его потомков из мира.
AddOutput  <строка>
Определяет keyvalue/output в этом энтити. Потенциально представляет большую опасность, используйте с осторожностью.
Формат: <key> <value>
Формат: <output name> <targetname>:<inputname>:<parameter>:<delay>:<макс. количество активаций, -1 - бесконечно>
FireUser1 до FireUser4
Запуск выходов OnUser; см. Пользовательские вводы и выводы.
Use  Отсутствует в FGD! English
То же, что и при вызове +use игроком; может не всё. Можно вызвать, создав вывод, которому не указан ввод.
Этот ввод не входит в Valve-файлы FGD.
RunScriptFile  <скрипт> (Во всех играх начиная с L4D2)
Выполнить файл игрового скрипта с диска.
RunScriptCode  <строка> (Во всех играх начиная с L4D2)
Выполнить строку исходного кода скрипта.
Warning.pngПредупреждение:Никогда не передавайте строковые параметры функции скрипта с помощью этого входа. Это повредит структуру VMF из-за вложения кавычек, которые потребуется удалять вручную в текстовом редакторе.

Outputs (Исходящие команды)


Targetname:
OnUser1 to OnUser4
These outputs each fire in response to the firing of the like-numbered FireUser1 to FireUser4 Input; see User Inputs and Outputs.
OnKilled  (only in Left 4 Dead)
This output fires when the entity is killed and removed from the game.
Источник — «https://developer.valvesoftware.com/w/index.php?title=Script_intro:ru&oldid=373744»