Script_intro

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

Энтити 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: Приведенные выши опции работают только на DX9 системах и выше. На более старых DirectX могут не работать. Боже, 2020 год, о чем это я?

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

Осмотрите карты 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д элементы (спрайты вспышек итд)) . Следует отнимать оружие у игрока для таких сцен или же использовать второй стороннюю камеру в игре (две камеры А и В)

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

Code Fix:  Проблему со скайбоксом можно обойти, если передвинуть подготовку (setup) из CSkyboxView в CViewRender::RenderView(), чтобы она происходила после того, как вторая камера отрисует интро сцену. Таким образом, она будет разделена на два инстанса, первый непосредственно перед CViewRender::ViewDrawScene() , а другой инстанс подготовки (setup) из CViewRender::ViewDrawScene_Intro(), вскоре после блока m_bDrawPrimary. Это работает, если мы поместим ее перед g_pClientShadowMgr->PreRender(). Чистый фон будет удален, по крайней мере, пока вычисляется визуализация скайбокса.

Confirm:Приводит ли удаление VIEW_CLEAR_COLOR к прекращению корректной работы VortWarp?

Code Fix: Баг с 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.

Entity Scripts (vscripts) <scriptlist> (in all games since )

Space delimited list of VScript files (without file extension) that are executed after all entities have spawned. The scripts are all executed in the same script scope, later ones overwriting any identical variables and functions.

Script think function (thinkfunction) <string> (in all games since )

Name of a function in this entity's script which will be called automatically every 100 milliseconds (ten times a second) for the duration of the script. It can be used to create timers or to simulate autonomous behavior. The return value (if present) will set the time until the next call.

 Note: Try to avoid expensive operations in this function, as it may cause performance problems.

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

Activate

Объект готов к работе.

Deactivate

Объект выключен.

SetCameraViewEntity

Имя камеры, чья картинка будет смешиваться (камер может быть две)

SetBlendMode

Выбрать метод смешивания

SetFOV

Установить уровень FOV (зум)

SetNextFOV

Установить следующий уровень FOV, используется с SetFOVBlendTime командой в паре.

SetFOVBlendTime

Установить время перехода от исходного значения FOV к указанному выше.

SetNextBlendMode

Установить следующий метод смешивания с SetNextBlendTime командой в паре

SetNextBlendTime

Установить время перехода между двумя методами смешивания, смотри выше

FadeTo

Установить прозрачность экрана <альфа> и переход<длительность>

SetFadeColor

указать цвет затемнения экрана <красный> <зеленый> <синий>

Targetname:

Kill

Removes this entity from the world.

KillHierarchy

Removes this entity and its children from the world.

 Note: Entities already remove orphaned children upon being removed, but this input removes all children on the same frame, being marginally faster than Kill.

AddOutput <string>

Adds a keyvalue/output to this entity. It can be potentially very dangerous, use with care.
KV Format: <key> <value>
I/O Format: <output name> <targetname>:<inputname>:<parameter>:<delay>:<max times to fire, -1 means infinite>

FireUser1 to FireUser4

Fire the OnUser outputs; see User Inputs and Outputs.

Use  !FGD

Same as a player invoking +use; may not do anything depending on the entity. Can also be invoked by firing an output that does not specify an input.

RunScriptFile <script> (in all games since )

Execute a VScript file from disk, without file extension. The script contents are merged with the script scope of the receiving entity.

RunScriptCode <string> (in all games since )

Execute a string of VScript source code in the scope of the entity receiving the input. String quotation may be needed when fired via console.

 Bug: In , the code is executed in the script scope of the entity that fires the output, not the one receiving the input.

 Warning: Never try to pass string parameters to a script function with this input. It will corrupt the VMF structure because of the nested quotation marks, which then must be removed manually with a text editor.

CallScriptFunction <string> (in all games since ) !FGD

Execute a VScript function in the scope of the receiving entity.

SetLocalOrigin <coordinates> (in all games since ) !FGD

Send this entity to a spot in the map. If the entity is parented to something, it will be offset from the parent by this amount.

SetLocalAngles <angles> (in all games since ) !FGD

Set this entity's angles.

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 )

This output fires when the entity is killed and removed from the game.