point_template

From Valve Developer Community
< Ru
Jump to navigation Jump to search
English (en)Русский (ru)中文 (zh)Translate (Translate)
C++ Классовая структура
CPointTemplate
↳CLogicalEntity
↳CServerOnlyEntity
↳CBaseEntity
C++ point_template.cpp

Point template.pngPoint template classic.pngpoint_template - это точечная энтити(en), доступно для всех игр на движке Source Source.

Описание объекта

point_template превращает объект(en) или несколько объектов в набор, который можно многократно размещать в любом месте. При его активации (ForceSpawn), он создает объекты из набора в тех же относительных позициях, в которых они находились при его создании. Если point_template не перемещался, то они появятся в исходных местоположениях. Для появления набора объектов в других местах, можно использовать объект env_entity_maker.

Tip.pngСовет: У всех объектов logic_relay из набора при их появлении срабатывает выход OnSpawn. Это поведение можно использовать для того, чтобы объекты из набора выполняли определенные действия при появлении.
Icon-Bug.pngБаг:InsurgencyDay of Infamy Функциональность этого объекта нарушена и приводит к сбою игры. Однако в режиме тренировки в Insurgency он работает нормально.
Icon-Bug.pngБаг:Counter-Strike: Global Offensive Создание func_breakable_surf с помощью этого объекта приводит к сбою игры.
Note.pngПримечание: Any entity from S_PreserveEnts(en) cannot be instanced by default. This can be workarounded by making the point_template a preserved entity itself at map load which can be done by using logic_auto(en) to change the classname of the template with AddOutput to one from S_PreserveEnts. When spawning this template a message will be shown that there are no templated entities, however it will work anyways.
Warning.pngПредупреждение: Объекты, с указанным внешним именем(en), не будут появляться, пока не будут предварительно уничтожены.

Прежде чем использовать этот объект, ознакомьтесь с разделами, как Исправление имён и Доработка FGD.

Исправление имён

Для предотвращения взаимного влияния (входов/выходов объектов, наследования или иных ссылок по имени) между объектами, имена объектов в наборе изменяются, а все связанные выходы перенаправляются на измененные имена. Формат исправления имени следующий: '<исходное_имя>&XXXX', где '&XXXX' заменяется порядковым номером создаваемого экземпляра набора, поэтому поиск по маске '<исходное_имя>&*' позволит их обнаружить. Исправляются только имена объектов в наборе, создаваемых с помощью выхода; имена выходов point_template, как и выходов других объектов, ссылающихся на объекты из набора, не исправляются.

Специальные целевые имена(en) (!self и т.п.) работают для созданных объектов, поэтому для воздействия на отдельные созданные объекты можно использовать trigger_multiple с выходом на !activator. Подстановочные символы позволят обратиться ко всем объектам, созданным с помощью point_template с включенным исправлением имён.

Note that if '"Don't remove template entities"' flag is active, the first (batch of) entities spawned will be postfixed&0002. If you don't want the name fixup to happen, because you're only spawning the template once, or you want inputs to trigger all instances of the template, check the 'Preserve entity names' spawnflag.

Подтвердить:Ifspawnflag 2is active, will the unremoved entity have its name postfixed with&0001?
Warning.pngПредупреждение: point_template will not do any name fixing-up in the parameter override boxes of its templated entities.
Note.pngПримечание: Entities must be referenced by name in a keyvalue or external I/O connection to get fixed up. If neither is present, then the name is preserved. If this isn't desired, a easy fix is to add a dummy keyvalue in the entity that references it's own name. It doesn't even have to be a keyvalue that really exists on the entity.

Ключ-параметры

Name (targetname) <объект источник(en)>
Имя объекта, по которому другие объекты могут ссылаться на этот объект, через Входы/Выходы(en) или другие ключ-параметры(en) (например parentname(en) или target).
Оно отображается на 2D-видах в Hammer и Отчёте об объектах (Entity Report)(en).
См. также: Основные ключ-параметры, входы и выходы(en) доступные для всех объектов
Template 1 (Template01) to Template 16 (Template16) <целевой объект(en)>
Целевые имена(en) объектов для добавления в набор. Допускается как точное указание, так и использование подстановочных символов(en) (*). Если маске будет соотвествовать несколько объектов, все они будут добавлены в набор.

Признаки

Don't remove template entities : [1]
Отключить автоматическое удаление для созданных объектов из набора.
Preserve entity names (Don't do name fixup) : [2]
Создавать объекты с исходными именами, которые были при создании набора (не исправлять имена).

Входы

ForceSpawn
Создаёт экземпляр набора объектов в исходном местоположении.

Выходы

OnEntitySpawned
!activator = !caller = this entity
Срабатывает после создания экземпляра набора объектов.

Доработка FGD

From TeamSpen210's Hammer Addons,point_templatecan be made to show connecting lines to all entities part of its template.

Найдите в файле base.fgd следующую строку и выделите её часть, как здесь приведено:

@PointClass base(Targetname) iconsprite("editor/point_template.vmt") = point_template :

Скопируйте следующие строки и замените выделенное в файле:

@PointClass base(BaseEntityPoint) 
	iconsprite("editor/point_template.vmt")
	line(255 255 0, targetname, Template01)
	line(255 255 0, targetname, Template09)
	line(255 255 0, targetname, Template02)
	line(255 255 0, targetname, Template10)
	line(255 255 0, targetname, Template03)
	line(255 255 0, targetname, Template11)
	line(255 255 0, targetname, Template04)
	line(255 255 0, targetname, Template12)
	line(255 255 0, targetname, Template05)
	line(255 255 0, targetname, Template13)
	line(255 255 0, targetname, Template06)
	line(255 255 0, targetname, Template14)
	line(255 255 0, targetname, Template07)
	line(255 255 0, targetname, Template15)
	line(255 255 0, targetname, Template08)
	line(255 255 0, targetname, Template16)
= point_template:

Смотреть также