This article's documentation is for anything that uses the Source engine. Click here for more information.

Env smokestack: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
m (dead link)
No edit summary
 
(22 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{wrongtitle|title=env_smokestack}}
{{LanguageBar}}
[[File:Env smokestack.png|thumb|right|300px|<code>env_smokestack</code> using the FGD defaults.]]
{{CD|CSmokeStack|file1=smokestack.cpp}}
{{This is a|point entity|name=env_smokestack}} It spits out a constant stream of smoke. You can place up to two {{ent|env_particlelight}}s near the smoke stack to add ambient light to its particles.


==Entity Description==
== Keyvalues ==
An entity that spits out a constant stream of smoke. You can place up to two [[Env_particlelight|env_particlelight]] entities near the smoke stack to add ambient light to its particles.
{{KV Targetname}}
{{KV|Initial State|intn=InitialState|choices|Initial state of the entity.
:*0: Off
:*1: On}}
{{KV|Spread at the base|intn=BaseSpread|integer|Amount of random spread in the origins of the smoke particles when they're spawned.}}
{{KV|Spread Speed|intn=SpreadSpeed|integer|Amount of random spread in the velocity of the smoke particles after they're spawned.}}
{{KV|Speed|intn=Speed|integer|The speed at which the smoke particles move after they're spawned.}}
{{KV|Particle start size|intn=StartSize|integer|Size of the smoke particles when they're first emitted.}}
{{KV|Particle end size|intn=EndSize|integer|Size of the smoke particles at the point they fade out completely.}}
{{KV|Emission rate|intn=Rate|integer|Rate at which to emit smoke particles (i.e. particles to emit per second).}}
{{KV|Length of smoke trail|intn=JetLength|integer|Length of the smokestack. Lifetime of the smoke particles is derived from this & particle speed.}}
{{KV|Wind X/Y Angle|intn=WindAngle|angle|This specifies the wind direction. It is an angle in the XY plane.}}
{{KV|Wind Speed|intn=WindSpeed|integer|The strength of the wind.}}
{{KV|Particle material|intn=SmokeMaterial|string|Material of the smoke particles emitted by this stack.}}
{{KV|Twist|intn=Twist|integer|The amount, in degrees per second, that the smoke particles twist around the origin.}}
{{KV|Roll Speed|intn=Roll|float|Amount of roll in degrees per second.}}
{{KV|Base Color (R G B)|intn=rendercolor|color255|The color of the particles.}}
{{KV|Translucency|intn=renderamt|integer|How much you can see through the particles.}}
{{KV|Wind Vector|intn=Wind|nofgd=1|vector|Wind direction, not limited to any axis.}}


==Availability==
== Inputs ==
{{in game|point}} {{game-base}}
{{I|TurnOn|Turn on the smokestack.}}
{{in code|class=CSmokeStack|file=smokestack.cpp}}
{{I|TurnOff|Turn off the smokestack.}}
{{I|Toggle|Toggles the smokestack between on and off state.}}
{{I|JetLength|param=integer|Sets '''Length of smoke trail'''.}}
{{I|Rate|param=integer|Sets '''Emission rate'''.}}
{{I|Speed|param=integer|Sets '''Speed'''.}}
{{I|SpreadSpeed|param=integer|Sets '''Spread Speed'''.}}
{{I|Color|nofgd=1|param=color255|Sets '''Base Color'''.}}
{{I|Alpha|nofgd=1|param=int|Sets '''Translucency'''.}}


==Keyvalues==
== See also ==
* {{kv targetname}}
* {{ent|env_particlelight}}
* '''InitialState'''
: {{boolean}}
* '''BaseSpread'''
: <float> Amount of random spread in the origins of the smoke particles when they're spawned.
* '''SpreadSpeed'''
: <integer> Amount of random spread in the velocity of the smoke particles after they're spawned.
* '''Speed'''
: <integer> The speed at which the smoke particles move after they're spawned.
* '''StartSize'''
: <float> Size of the smoke particles when they're first emitted.
* '''EndSize'''
: <float> Size of the smoke particles at the point they fade out completely.
* '''Rate'''
: <integer> Rate at which to emit smoke particles (i.e. particles to emit per second).
* '''JetLength'''
: <integer> Length of the smokestack. Lifetime of the smoke particles is derived from this & particle speed.
* '''WindAngle'''
: <integer> This specifies the wind direction. It is an angle in the XY plane. WindSpeed specifies the strength of the wind.
* '''WindSpeed'''
: <integer> The strength of the wind.
* '''SmokeMaterial'''
: <material> Material of the smoke particles emitted by this stack.
* '''twist'''
: <float> The amount, in degrees per second, that the smoke particles twist around the origin.
* '''rendercolor'''
: {{color}} Base Color
* '''renderamt'''
: <integer> Translucency
 
==Inputs==
 
* {{i targetname}}
 
* '''TurnOn'''
: Turn on the smokestack.
 
* '''TurnOff'''
: Turn off the smokestack.
 
* '''Toggle'''
: Toggles the smokestack between on and off state.
 
* '''JetLength <float>'''
: Set the length of the smoke trail.
 
* '''Rate <float>'''
: Set the rate at which to emit smoke particles (particles per second).
 
* '''Speed <float>'''
: Set the speed at which the smoke particles move after they're spawned.
 
* '''SpreadSpeed <float>'''
: Set the amount of random spread in the velocity of the smoke particles after they're spawned.
 
==Outputs==
* {{o targetname}}
 
<!-- sadly, akilling appears to be permanently offline.
If it does come back, remove the comment codes.
==External links==
*[http://www.akilling.org/akg/tutorials/wiseSmokeStack.asp Tutorial]
-->
 
[[Category:Entities]]

Latest revision as of 22:29, 12 April 2025

English (en)Translate (Translate)
env_smokestack using the FGD defaults.
C++ Class hierarchy
CSmokeStack
CBaseParticleEntity
CBaseEntity
C++ smokestack.cpp

env_smokestack is a point entity available in all Source Source games. It spits out a constant stream of smoke. You can place up to two env_particlelights near the smoke stack to add ambient light to its particles.

Keyvalues

Name (targetname) <string>[ Edit ]
The name that other entities refer to this entity by, via Inputs/Outputs or other keyvalues (e.g. parentname or target).
Also displayed in Hammer's 2D views and Entity Report.
See also:  Generic Keyvalues, Inputs and Outputs available to all entities

Initial State (InitialState) <choices>
Initial state of the entity.
  • 0: Off
  • 1: On
Spread at the base (BaseSpread) <integer>
Amount of random spread in the origins of the smoke particles when they're spawned.
Spread Speed (SpreadSpeed) <integer>
Amount of random spread in the velocity of the smoke particles after they're spawned.
Speed (Speed) <integer>
The speed at which the smoke particles move after they're spawned.
Particle start size (StartSize) <integer>
Size of the smoke particles when they're first emitted.
Particle end size (EndSize) <integer>
Size of the smoke particles at the point they fade out completely.
Emission rate (Rate) <integer>
Rate at which to emit smoke particles (i.e. particles to emit per second).
Length of smoke trail (JetLength) <integer>
Length of the smokestack. Lifetime of the smoke particles is derived from this & particle speed.
Wind X/Y Angle (WindAngle) <angle>
This specifies the wind direction. It is an angle in the XY plane.
Wind Speed (WindSpeed) <integer>
The strength of the wind.
Particle material (SmokeMaterial) <string>
Material of the smoke particles emitted by this stack.
Twist (Twist) <integer>
The amount, in degrees per second, that the smoke particles twist around the origin.
Roll Speed (Roll) <float>
Amount of roll in degrees per second.
Base Color (R G B) (rendercolor) <color255>
The color of the particles.
Translucency (renderamt) <integer>
How much you can see through the particles.
Wind Vector (Wind) <vector> !FGD
Wind direction, not limited to any axis.

Inputs

TurnOn
Turn on the smokestack.
TurnOff
Turn off the smokestack.
Toggle
Toggles the smokestack between on and off state.
JetLength <integerRedirectInput/integer>
Sets Length of smoke trail.
Rate <integerRedirectInput/integer>
Sets Emission rate.
Speed <integerRedirectInput/integer>
Sets Speed.
SpreadSpeed <integerRedirectInput/integer>
Sets Spread Speed.
Color <color255RedirectInput/color32> !FGD
Sets Base Color.
Alpha <integerRedirectInput/integer> !FGD
Sets Translucency.

See also