script_intro
script_intro
- это точечная энтити , доступно для всех игр на движке Source.
Contents
Описание энтити
Энтити 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](/w/images/thumb/c/cc/Note.png/10px-Note.png)
Примеры использования
Осмотрите карты Half-Life 2 (и эпизодов) чтобы понять принцип работы энтити:
d1_trainstation_01
(Первая сцена)d1_trainstation_05
(Сцена с телепоратацией)d3_breen_01
(Финальная сцена)ep1_citadel_00
(Ep1 вступление)ep2_outland_02
(событие с G-Man от сердца к сердцу )
Прямой переход от камеры игрока к обычной камере и назад в течении 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д элементы (спрайты вспышек итд)) . Следует отнимать оружие у игрока для таких сцен или же использовать второй стороннюю камеру в игре (две камеры А и В)
Обе проблемы из-за скайбоксов и оружия в руках.
![](/w/images/thumb/5/53/Cpp-16px.png/10px-Cpp-16px.png)
CSkyboxView
в CViewRender::RenderView()
, чтобы она происходила после того, как вторая камера отрисует интро сцену. Таким образом, она будет разделена на два инстанса, первый непосредственно перед CViewRender::ViewDrawScene()
, а другой инстанс подготовки (setup) из CViewRender::ViewDrawScene_Intro()
, вскоре после блока m_bDrawPrimary
. Это работает, если мы поместим ее перед g_pClientShadowMgr->PreRender()
. Чистый фон будет удален, по крайней мере, пока вычисляется визуализация скайбокса.Подтвердить:Приводит ли удаление VIEW_CLEAR_COLOR к прекращению корректной работы VortWarp ?
![](/w/images/thumb/5/53/Cpp-16px.png/10px-Cpp-16px.png)
CViewRender::DrawViewModels()
в CViewRender::RenderView()
, когда активен код intro, и добавив отдельный вызов в CViewRender::ViewDrawScene_Intro()
перед составлением intro_screenspaceeffect. Это работает, если мы поместим его сразу после main DrawWorldAndEntities
.Keyvalues (свойства энтити)
- Match env_zoom's FOV transition
(???)
<булева переменная > - Использовать ли плавный зум как в env_zoom.
- Name
(targetname)
<объект источник > - Название объекта по которому другие объекты могут ссылаться на этот объект.
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
toFireUser4
- Запуск выходов
OnUser
; см. Пользовательские вводы и выводы.
Use
Отсутствует в FGD!- То же, что и при вызове +use игроком; может не всё. Можно вызвать, создав вывод, которому не указан ввод.
Этот ввод не входит в Valve-файлы FGD.
RunScriptFile
<скрипт > (Во всех играх начиная с)
- Выполнить файл игрового скрипта с диска.
RunScriptCode
<строка > (Во всех играх начиная с)
- Выполнить строку исходного кода скрипта.
Предупреждение:Никогда не передавайте строковые параметры функции скрипта с помощью этого входа. Это повредит структуру VMF из-за вложения кавычек, которые потребуется удалять вручную в текстовом редакторе.
Outputs (Исходящие команды)
Targetname:
OnUser1
toOnUser4
- These outputs each fire in response to the firing of the like-numbered
FireUser1
toFireUser4
Input; see User Inputs and Outputs.