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

Env embers: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
(→‎Flags: added info requested in the TODO)
m (→‎Inputs: Substituted IO templates)
 
(13 intermediate revisions by 9 users not shown)
Line 1: Line 1:
[[Image:{{PAGENAME}}.jpg|thumb|250px|An example of embers in-game. The embers are difficult to see in the thumbnail]]
<!-- When this page is updated to {{langsp}} or {{langsp}} instead of {{lang}}, please move {{this is a}} to the base page, as it is automatically translated. -->{{lang|Env embers}}{{CD|CEmbers|file1=effects.cpp}}[[File:env_embers.gif|thumb|250px|<code>env_embers</code> demonstration.]]
{{this is a|brush entity|name=env_embers}} It spawns fire embers within its volume. Its state can only be changed with the {{ent|Use}} input.


{{base_brush|env_embers}} It spawns fire embers within its volume. For some reason its state is changed in-game by [[+use|+using]] it, rather than with an input.
{{sfx_brush}}
 
==Flags==
{{fl|1|Start On}}
{{fl|2|Toggle|If left off, only one <code>Use</code> input will ever be accepted.}}


==Keyvalues==
==Keyvalues==
; Ember type <code><choices></code>
: The manner in which embers should appear and disappear.
:* Normal
:* Smooth Fade {{clarify}}
:* Pulled {{clarify}}
; Density <code><[[int]]></code>
: Number of particles spawned each second.
; Particle Lifetime <code><int></code>
: Number of seconds each particle lasts for. {{todo|Is any noise applied to this?}}
; Particle Speed <code><int></code>
: Number of units moved by particles each second. {{todo|As above.}}
; Ember Color {{color}}
: Usually orange-ish!
{{KV Angles}}
{{KV Parentname}}
{{KV Targetname}}
{{KV Targetname}}
 
{{KV|Ember type |intn=particletype|choices|deprecated=1|Not present in code. The manner in which embers should appear and disappear.
==Flags==
:*0: Normal
{{note|The state of env_embers is changed by <code>[[+use]]</code>ing it. (E key by default in most games)}}
:*1: Smooth Fade
* Start On
:*2: Pulled}}
* Toggle
{{KV|Density |intn=density|int|Number of particles spawned each second.}}
{{KV|Particle Lifetime |intn=lifetime|int|Number of seconds each particle lasts for. A certain amount of randomness is added proportional to the time specified here.}}
{{KV|Particle Speed |intn=speed|int|Number of units moved by particles each second.}}
{{KV|Ember Color |intn=rendercolor|color255|Color of the sprites.}}


==Inputs==
==Inputs==
 
{{I|Color|nofgd=1|param=color255|Changes the color that new sprites will spawn with.}}
{{I Parentname}}
{{I Targetname}}
 
==Outputs==
 
{{O Targetname}}

Latest revision as of 10:07, 21 April 2025

English (en)Translate (Translate)
C++ Class hierarchy
CEmbers
CBaseEntity
C++ effects.cpp
env_embers demonstration.

env_embers is a brush entity available in all Source Source games. It spawns fire embers within its volume. Its state can only be changed with the Use input.

Flags

Start On : [1]
Toggle : [2]
If left off, only one Use input will ever be accepted.

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

Ember type (particletype) <choices> Obsolete
Deprecated.
Not present in code. The manner in which embers should appear and disappear.
  • 0: Normal
  • 1: Smooth Fade
  • 2: Pulled
Density (density) <integer>
Number of particles spawned each second.
Particle Lifetime (lifetime) <integer>
Number of seconds each particle lasts for. A certain amount of randomness is added proportional to the time specified here.
Particle Speed (speed) <integer>
Number of units moved by particles each second.
Ember Color (rendercolor) <color255>
Color of the sprites.

Inputs

Color <color255RedirectInput/color32> !FGD
Changes the color that new sprites will spawn with.