point_spotlight

point_spotlight в действии.

point_spotlight - это точечная энтити(en), доступно для всех игр на движке Source. Представляет из себя light_dynamic(en) с двумя дополнительными спрайтовыми эффектами свечения: луч для наблюдателей снаружи конуса света и гало для наблюдателей внутри конуса света. Эту энтити часто используют для создания прожекторов.

Функционал light_dynamic внутри этой энтити можно отключить, используя флаг 'No Dynamic Light'. В таком состоянии энтити не будет по-настоящему освещать другие объекты самостоятельно и может использоваться вместе с light_spot(en) или env_projectedtexture(en) (или newLight_Spot(en), если Вы используете Black Mesa).

Баг: Не создаёт light_dynamic, даже если флаг 'No Dynamic Light' выключен.  [todo tested in ?]

Код:По умолчанию point_spotlight использует материал sprites/glow_test02.vmt. Это можно изменить, если Вы поставляете собственные бинарные файлы, перейдя на строку 351 в point_spotlight.cpp в проекте сервера и заменив путь на свой собственный материал.

Примечание:Эта энтити создаёт сущности env_beam(en) и spotlight_end, чтобы создавать свои спрайтовые эффекты. Это означает, что один point_spotlight на самом деле представляет собой три разных энтити, включая сам point_spotlight. Все они влияют на лимит энтити(en).

Нужно сделать: Указать способ установки собственных материалов через параметры этой энтити

Предупреждение:Эта энтити занимает 3 эдикта(en) (для себя, визуала луча и конца луча соответственно): point_spotlight, beam, spotlight_end. В Team Fortress 2 и Garry's Mod, энтити point_spotlight переделана в сугубо серверный эдикт. Так же в Team Fortress 2, если не указать имя энтити и имя родительской энтити, энтити point_spotlight и spotlight_end будут удалены. Таким образом статичный прожектор будет занимать только 1 эдикт.

Предупреждение:В Black Mesa, если эта энтити не использует флаг No Dynamic Light, то тогда она создаст динамический источник  отложенного освещения вместо использования лайтмапов(en).

Примечание:env_beam(en) сталкивается только с prop_static(en) и геометрией мира, что означает, что луч point_spotlight и его динамический свет будут игнорировать все динамические объекты (исключая func_physbox(en), NPC(en), физические объекты(en) и т.д.

Баг:В и параметр renderamt не функционален, используйте вместо него HDR color scale.

Примечание:В Alien Swarm Deferred, эта энтити не поддерживается и при загрузке карты все point_spotlight будут превращены в источники отложенного освещения(en)!

Параметры

Ignore Solid (IgnoreSolid) <булева переменная(en)> Отсутствует в FGD!

Если выставлен, то этот прожектор не будет сталкиваться с твёрдыми телами.(только в )

Spotlight Length (SpotlightLength) <целое число(en)>

Длина луча прожектора.

Spotlight Width (SpotlightWidth) <целое число(en)>

Ширина луча прожектора.

Color (R G B) (rendercolor) <цвет КЗС(en)>

Цвет прожектора.

HDR color scale. (HDRColorScale) <число с плавающей запятой(en)>

Число с плавающей точкой, на которое будет умножен цвет спрайта при игре в режиме HDR.

Halo size scale. (HaloScale) <число с плавающей запятой(en)> (Во всех играх начиная с )

Число с плавающей точкой, определяющее размер гало.

См. также:  Generic Keyvalues, Inputs and Outputs available to all entities

Name(en) (targetname) <объект источник(en)>

Имя энтити, по которому другие энтити могут ссылаться на этот объект.

Parentname:

Parent (parentname) <целевой объект(en)>

Specifies a movement parent. An entity will maintain its initial offset from its parent. An attachment point can be added to the end of the name, separated by a comma.

RenderFields:

Render Mode (rendermode) <варианты выбора>

Set a non-standard rendering mode on this entity.

Render Modes Expand

0: Normal 1: Color 2: Texture 3: Glow 4: Solid/Alphatest 5: Additive 6: Removed, does nothing 7: Additive Fractional Frame 8: Alpha Add 9: World Space Glow 10: Don't Render

Render FX(en) (renderfx) <варианты выбора>

Various somewhat legacy alpha effects. See render effects.

Render Amount / Transparency (renderamt) <byte(en)>

Transparency amount, requires a Render Mode other than Normal. 0 is invisible, 255 is fully visible.

Render Color (R G B) (rendercolor) <цвет КЗС(en)>

Color tint.

Pitch Yaw Roll (Y Z X) (angles) <angle(en)>

This entity's orientation in the world. Pitch is rotation around the Y axis, yaw is the rotation around the Z axis, roll is the rotation around the X axis.

Минимальный / Максимальный уровень DX (mindxlevel / maxdxlevel) <integer choices(en)> (удалено начиная с )

Энтити не будет существовать, если графический движок будет работать вне данных версий ПО - DirectX Versions.

Выбор Expand

Предупреждение:If these are used, the object may break when the user switches their DirectX settings.[missing string] 0 - Default (без привязки) 60 - DirectX 6 (Отсутствует в FGD! for mindxlevel) 70 - DirectX 7 80 - DirectX 8 (GeForce4 Ti & FX 5000 series) 81 - DirectX 8.1 (GeForce FX 5800, 5900 & Radeon 8500/9100 and 9000/9200) 90 - DirectX 9 SM2 92 - OpenGL equivalent to DirectX 9 Shader Model 2 (using ToGL; only) Отсутствует в FGD! 95 - DirectX 9 SM3 (Во всех играх начиная с ) 98 - DirectX 9 Shader Model 3 на Xbox 360 ( only) Отсутствует в FGD!

Minimum / Maximum Effect Details Level (mincpulevel / maxcpulevel) <integer choices(en)> (Во всех играх начиная с )

Don't render for players with Effect Details levels that exceed the minimum or maximum.

Choices Expand

0: Default ("Low" for mincpulevel, "High" for maxcpulevel) 1: Low 2: Medium 3: High

Minimum / Maximum Shader Details Level (mingpulevel / maxgpulevel) <integer choices(en)> (Во всех играх начиная с )

Don't render for players with Shader Details levels that exceed the minimum or maximum.

Choices Expand

0: Default ("Low" for mingpulevel, "Very High" for maxgpulevel) 1: Low 2: Medium 3: High 4: Very High

См. также:  cpu_level / gpu_level convars

Флаги

Start On : [1]

Включает энтити по умолчанию.

No Dynamic Light : [2]

Отключает динамический свет.

Инпуты

LightOn

Включает энтити.

LightOff

Выключает энтити.

LightToggle

Переключает энтити. (только в )

SetColor <цвет КЗС(en)> (Во всех играх начиная с ) (также в )

Меняет цвет прожектора. Свет необходимо выключить и включить обратно, чтобы динамический источник света обновился.

Примечание:Функционально идентичен инпуту Color. Необходима задержка как минимум 0.01 перед включением прожектора, иначе он не включится.

ForceUpdate  (Во всех играх начиная с ) (также в )

Заставляет прожектор обновить свои положение и ориентацию.

Parentname:

SetParent <строка(en)>

Move with this entity. See Entity Hierarchy (parenting).

SetParentAttachment <строка(en)>

Change this entity to attach to a specific attachment point on its parent. The entity will teleport so that the position of its root bone matches that of the attachment. Entities must be parented before being sent this input.

SetParentAttachmentMaintainOffset <строка(en)>

As above, but without teleporting. The entity retains its position relative to the attachment at the time of the input being received.

ClearParent

Removes this entity from the the movement hierarchy, leaving it free to move independently.

RenderFields:

Alpha <целое число(en) 0–255>

Sets the entity's transparency to a number from 0 (invisible) to 255 (fully visible). Requires the entity to have its rendermode set to a number other than 0.

Color <цвет КЗС(en)>

Sets an RGB color for the entity.

Аутпуты

OnLightOn

Срабатывает при включении света.

OnLightOff

Срабатывает при отключении света.

См. также

• Освещение(en)