View source for Ru Temp Entity Events (Half-Life 1)

[[Category:Russian]]
[[Category:Ru:Scripting (AMX Mod X)]]
Temp Entity - это временные объекты на стороне клиента, которые создаются при посылке специальных сообщений сервером. Например, с помощью таких рассылок можно формировать эффекты трассирующих пуль, вызрывы, вспышки, а также мертвые тела игроков и многое другое.

=Типы сообщений=

Типы сообщений определяют механизм рассылки сообщений клиентам, а также адресатов. Типы описываются макроопределениями MSG_?, которые можно найти в файле const.h [[Ru:HLSDK|HLSDK]], или message_const.inc AMX Mod X [[Ru:API|API]]. Типы используются в качестве значения аргумента ''dest'' функции [http://www.amxmodx.org/funcwiki.php?go=func&id=262 message_begin()]:
<pawn>#define MSG_BROADCAST		0	
	// сообщение может быть доставлено всем клиентам
#define MSG_ONE			1
	// сообщение будет доставлено только одному клиенту (msg_entity)
#define MSG_ALL			2
	// сообщение будет доставлено всем клиентам
#define MSG_INIT		3
	// write to the init string(?)
#define MSG_PVS			4
	// сообщение может быть доставлено клиентам, находящимся в
	// в области видимости точки с координатами org
#define MSG_PAS			5
	// сообщение может быть доставлено клиентам, находящимся в
	// зоне слышимости от точки org
#define MSG_PVS_R		6
	// аналогично MSG_PVS с гарантией доставки сообщений
#define MSG_PAS_R		7
	// аналогично MSG_PAS с гарантией доставки сообщений
#define MSG_ONE_UNRELIABLE	8
	// аналогично MSG_ONE, но доставка сообщения НЕ гарантируется
#define MSG_SPEC		9
	// отправлка сообщения всем прокси для зрителей (HLTV?)</pawn>

= События TempEnt =


== 0: TE_BEAMPOINTS ==

Создает луч между 2-мя точками.

Параметры:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Настройка || Диапазон || Настройки по-умолчанию || Описание
|-
|nowrap="1"| Начало
|nowrap="1"| X Y Z (координаты)
|Координата первого энтити или 0 0 0
|Начальная точка луча
|-
|nowrap="1"| Конец
|nowrap="1"| X Y Z (координаты)
|Координата второго энтити или 0 0 0
|Конечная точка луча
|-
|nowrap="1"| Спрайт
|nowrap="1"| Путь к спрайту
|"sprites/laserbeam.spr"
|Собственно, луч
|-
|nowrap="1"| Первый кадр
|nowrap="1"| 0-255
|0
|Кадр, с которого будет проигрываться спрайт
|-
|nowrap="1"| FPS
|nowrap="1"| 0-255
|0
|Частота кадров, в 0.1 (10 = 1 fps)
|-
|nowrap="0"| Жизнь спрайта
|nowrap="0"| 0-255
|50
|Промежуток времени, в течении которого видно спрайт, в 0.1 (50 = 5 секунд)
|-
|nowrap="1"| Ширина
|nowrap="1"| 0-255
|10
|Ширина луча в 0.1
|-
|nowrap="1"| Искажение
|nowrap="1"| 0-255
|10
|Амплитуда искажения, обозначает то, как сильно будет "ломаться" луч, снова в 0.1
|-
|nowrap="1"| Цвет
|nowrap="1"| R G B
|255 255 255
|Цвет луча в системе R G B
|-
|nowrap="1"| Яркость
|nowrap="1"| 0-255
|127
|Яркость луча
|-
|nowrap="0"| Прокрутка
|nowrap="0"| 0-255
|0
|Скорость прокрутки(?) луча в 0.1
|}

Формат:
<pawn>#define TE_BEAMPOINTS 0
	// Луч между 2 точками

message_begin(MSG_? ,SVC_TEMPENTITY)
write_byte(TE_BEAMPOINTS)
write_coord()	// Начало луча: x
write_coord()	// y
write_coord()	// z
write_coord()	// Конец луча: x
write_coord()	// y
write_coord()	// z
write_short()	// Индекс спрайта
write_byte()	// Начальный кадр
write_byte()	// FPS в 0.1
write_byte()	// Время существования в 0.1
write_byte()	// Ширина в 0.1
write_byte()	// Искажение в 0.1
write_byte()	// Красный (R)
write_byte()	// Зеленый (G)
write_byte()	// Синий (B)
write_byte()	// Яркость
write_byte()	// Скорость прокрутки в 0.1
message_end()
</pawn>

== 1: TE_BEAMENTPOINT ==
Создает луч между энтитей и точкой.

Настройки:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Настройка || Диапазон || Настройки по-умолчанию || Описание
|-
|nowrap="1"| Начальное энтити
|nowrap="1"| ID энтити
|Идентификатор первичного энтити
|Стартовая точка луча - центр (origin) энтити
|-
|nowrap="1"| Конец
|nowrap="1"| X Y Z (координаты)
|Координата второго энтити или 0 0 0
|Конечная точка луча
|-
|nowrap="1"| Спрайт
|nowrap="1"| Путь к спрайту
|"sprites/laserbeam.spr"
|Собственно, луч
|-
|nowrap="1"| Первый кадр
|nowrap="1"| 0-255
|0
|Кадр, с которого будет проигрываться спрайт
|-
|nowrap="1"| FPS
|nowrap="1"| 0-255
|nowrap="1"| 0
|Частота кадров, в 0.1 (10 = 1 fps)
|-
|nowrap="1"| Жизнь спрайта
|nowrap="1"| 0-255
|50
|Промежуток времени, в течении которого видно спрайт, в 0.1 (50 = 5 секунд)
|-
|nowrap="1"| Ширина
|nowrap="1"| 0-255
|10
|Ширина луча в 0.1
|-
|nowrap="1"| Искажение
|nowrap="1"| 0-255
|10
|Амплитуда искажения, обозначает то, как сильно будет "ломаться" луч, снова в 0.1
|-
|nowrap="1"| Цвет
|nowrap="1"| R G B
|255 255 255
|Цвет луча в системе R G B
|-
|nowrap="1"| Яркость
|nowrap="1"| 0-255
|127
|Яркость луча
|-
|nowrap="1"| Прокрутка
|nowrap="1"| 0-255
|0
|Скорость прокрутки(?) луча в 0.1
|}

Формат:
<pawn>#define TE_BEAMENTPOINT 1
	// Луч между энтитей и точкой

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_BEAMENTPOINT)
write_short()	// Начальное энтити
write_coord()	// Конец луча
write_coord()
write_coord()
write_short()	// Индекс спрайта
write_byte()	// Начальный кадр
write_byte()	// FPS в 0.1
write_byte()	// Время существования в 0.1
write_byte()	// Ширина в 0.1
write_byte()	// Искажение в 0.1
write_byte()	// Красный (R)
write_byte()	// Зеленый (G)
write_byte()	// Синий (B)
write_byte()	// Яркость
write_byte()	// Скорость прокрутки в 0.1
message_end()</pawn>

== 2: TE_GUNSHOT ==
Создает частцы и звук рикошета.

Настройки:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Настройка || Диапазон || Настройки по-умолчанию || Описание
|-
|nowrap="1"| Координата
|nowrap="1"| X Y Z (координаты)
|Координата первого энтити или 0 0 0
|Точка для эффекта выстрела
|}

Формат:
<pawn>#define TE_GUNSHOT 2
	// Частцы и звук рикошета

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_GUNSHOT)
write_coord()	// Координата: x
write_coord()	// y
write_coord()	// z
message_end()
</pawn>

== 3: TE_EXPLOSION ==

Creates an additive sprite, 2 dynamic lights, flickering particles, explosion sound, and moves the sprite vertically.

Параметры:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Default || Description
|-
|nowrap="1"| Pos
|nowrap="1"| X Y Z (coords)
|nowrap="1"| Origin of primary entity, or 0 0 0
|Position of the explosion effect
|-
|nowrap="1"| Sprite
|nowrap="1"| sprite path
|nowrap="1"| "sprites/zerogxplode.spr"
|The additive sprite to use in the explosion
|-
|nowrap="1"| Scale
|nowrap="1"| 0-255
|nowrap="1"| 1
|The scale of the sprite in the explosion, in 0.1s
|-
|nowrap="1"| FrameRate
|nowrap="1"| 0-255
|nowrap="1"| 0
|The frame rate to show the sprite at, in 0.1s (10 = 1 fps)
|-
|nowrap="1"| Flags
|nowrap="1"| 0-15
|nowrap="1"| 0
|Sets flags for the explosion, you may also add these together:
*0: Default Half-Life explosion
*1: Sprite will be drawn opaque
*2: Do not render the dynamic lights
*4: Do not play the explosion sound
*8: Do not draw the particles
|}


Формат:
<pawn>#define TE_EXPLOSION 3
	// additive sprite, 2 dynamic lights, flickering particles, 
	// explosion sound, move vertically 8 pps

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_EXPLOSION)
write_coord()	// start position
write_coord()
write_coord()
write_short()	// sprite index
write_byte()	// scale in 0.1's
write_byte()	// framerate
write_byte()	// flags
message_end()</pawn>

== 4: TE_TAREXPLOSION ==
Creates the Quake 'tar' explosion.

Options:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Default || Description
|-
|nowrap="1"| Pos
|nowrap="1"| X Y Z (coords)
|nowrap="1"| Origin of primary entity, or 0 0 0
|Position of the effect
|}

Format:
<pawn>#define TE_TAREXPLOSION 4
	// Quake1 "tarbaby" explosion with sound

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_TAREXPLOSION)
write_coord()	// start position
write_coord()
write_coord()
message_end()
</pawn>

== 5: TE_SMOKE ==
Creates a rising alphablend sprite at 30 pps.

Options:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Default || Description
|-
|nowrap="1"| Pos
|nowrap="1"| X Y Z (coords)
|nowrap="1"| Origin of primary entity, or 0 0 0
|Position of the smoke effect
|-
|nowrap="1"| Sprite
|nowrap="1"| sprite path
|nowrap="1"| "sprites/steam1.spr"
|The alphablend sprite to use for smoke
|-
|nowrap="1"| Scale
|nowrap="1"| 0-255
|nowrap="1"| 1
|The scale of the smoke, in 0.1s
|-
|nowrap="1"| FrameRate
|nowrap="1"| 0-255
|nowrap="1"| 0
|The frame rate to show the sprite at
|}

Format:
<pawn>#define TE_SMOKE 5	
	// alphablend sprite, move vertically 30 pps

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_SMOKE)
write_coord()	// start position
write_coord()
write_coord()
write_short()	// sprite index 
write_byte()	// scale in 0.1's 
write_byte()	// framerate 
message_end()</pawn>

== 6: TE_TRACER ==
Создает эффект трассирующей пули из одной точки пространства в другую.

Параметры:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Значение по-умолчанию || Описание
|-
|nowrap="1"| Pos
|nowrap="1"| X Y Z (координаты)
|nowrap="1"| Origin of primary entity, or 0 0 0
|Начальная точка для эффекта
|-
|nowrap="1"| End
|nowrap="1"| X Y Z (координаты)
|nowrap="1"| Origin of secondary entity, or 0 0 0
|Конечная точка для эффекта
|}


Формат:
<pawn>#define TE_TRACER 6
	// tracer effect from point to point

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_TRACER)
write_coord()	// начальная позиция: x
write_coord()	// y
write_coord()	// z
write_coord()	// конечная позиция: x
write_coord()	// y
write_coord()	// z
message_end()
</pawn>

== 7: TE_LIGHTNING ==
Simplified options for TE_BEAMPOINTS - Lightning effect.

Options:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Default || Description
|-
|nowrap="1"| Pos
|nowrap="1"| X Y Z (coords)
|nowrap="1"| Origin of primary entity, or 0 0 0
|Starting point of the lightning
|-
|nowrap="1"| End
|nowrap="1"| X Y Z (coords)
|nowrap="1"| Origin of secondary entity, or 0 0 0
|Ending point of the lightning
|-
|nowrap="1"| Life
|nowrap="1"| 0-255
|nowrap="1"| 50
|The length of time the lightning shall remain, in 0.1s (50 = 5 seconds)
|-
|nowrap="1"| Width
|nowrap="1"| 0-255
|nowrap="1"| 10
|The width of the lightning in 0.1s
|-
|nowrap="1"| Noise
|nowrap="1"| 0-255
|nowrap="1"| 10
|The noise amplitude of the lightning, this controls how much it distorts, again in 0.1s
|-
|nowrap="1"| Sprite
|nowrap="1"| sprite path
|nowrap="1"| "sprites/laserbeam.spr"
|The sprite to use in the lightning
|}


Format:
<pawn>#define TE_LIGHTNING 7
	// TE_BEAMPOINTS with simplified parameters

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_LIGHTNING)
write_coord()	// start position
write_coord()
write_coord()
write_coord()	// end position 
write_coord()
write_coord()
write_byte()	// life in 0.1's 
write_byte()	// width in 0.1's 
write_byte()	// amplitude in 0.01's 
write_short()	// sprite model index
message_end()
</pawn>

== 8: TE_BEAMENTS ==
Creates a beam between the primary entity and another entity.

Options:
{| border="1" cellpadding="5"
|- style="background:#efefef;"
! Option || Range || Default || Description
|-
|nowrap="1"| Start Entity
|nowrap="1"| ID of Entity
|nowrap="1"| Primary entity id
|Starting point of the beam from the id's origin
|-
|nowrap="1"| End Entity
|nowrap="1"| ID of Entity
|nowrap="1"| Secondary entity id
|Ending point of the beam to the id's origin
|-
|nowrap="1"| Sprite
|nowrap="1"| sprite path
|nowrap="1"| "sprites/laserbeam.spr"
|The sprite to use in the beam
|-
|nowrap="1"| FrameStart
|nowrap="1"| 0-255
|nowrap="1"| 0
|The frame to start with in the sprite
|-
|nowrap="1"| FrameRate
|nowrap="1"| 0-255
|nowrap="1"| 0
|The frame rate to show the sprite at, in 0.1s (10 = 1 fps)
|-
|nowrap="1"| Life
|nowrap="1"| 0-255
|nowrap="1"| 50
|The length of time the beam shall remain, in 0.1s (50 = 5 seconds)
|-
|nowrap="1"| Width
|nowrap="1"| 0-255
|nowrap="1"| 10
|The width of the beam in 0.1s
|-
|nowrap="1"| Noise
|nowrap="1"| 0-255
|nowrap="1"| 10
|The noise amplitude of the beam, this controls how much the beam distorts, again in 0.1s
|-
|nowrap="1"| Color
|nowrap="1"| R G B
|nowrap="1"| 255 255 255
|The color of the beam in the RBG triplet value
|-
|nowrap="1"| Brightness
|nowrap="1"| 0-255
|nowrap="1"| 127
|The brightness of the beam
|-
|nowrap="1"| Scroll
|nowrap="1"| 0-255
|nowrap="1"| 0
|The scroll speed of the beam, in 0.1s (??)
|}


Format:
<pawn>#define TE_BEAMENTS 8
	// Create a beam between two entities

message_begin(MSG_ ,SVC_TEMPENTITY)
write_byte(TE_BEAMENTS)
write_short()	// start entity
write_short()  // end entity
write_short()	// sprite index
write_byte()	// starting frame
write_byte()	// frame rate in 0.1's
write_byte()	// life in 0.1's
write_byte()	// line width in 0.1's
write_byte()	// noise amplitude in 0.01's
write_byte()	// red
write_byte()	// green
write_byte()	// blue
write_byte()	// brightness
write_byte()	// scroll speed in 0.1's
message_end()</pawn>

TODO: add rest, I'll get this done eventually.