Env smoketrail

From Valve Developer Community

The title given to this article is incorrect due to technical limitations. The correct title is env_smoketrail.

This point-based entity is available in all Source games.

Table of contents

[edit]

Entity Description

An entity that creates a smoke trail.

[edit]

Availability

This point-based entity is available in: all Source games. In code it is represented by class SmokeTrail (http://doxygen.page.needed/class_smoke_trail.html), defined in smoke_trail.cpp (http://doxygen.page.needed/smoke__trail_8cpp-source.html).

[edit]

Keyvalues

targetname <target_source>

Defines the name that other entities refer to this entity by.

hammerid [Episode Two Update]

<integer readonly> This id is used for debugging purposes in Hammer.

parentname <target_destination>

Specifies the targetname of this entity's Parent in a movement hierarchy. Child entities move with their Parent.

opacity

<float> Opacity of the sprites (range from 0 - 1).

spawnrate

<float> Number of particles to emit each second.

lifetime

<float> Number of seconds until each particle dies.

startcolor

<color255> Starting color of the emitted particles.

endcolor

<color255> Ending color of the emitted particles.

emittime

<float> Number of seconds until the env_smoketrail stops emitting particles. 0 means never stop emitting particles.

minspeed

<float> Minimum randomly-directed speed to use for emitted particles.

maxspeed

<float> Maximum randomly-directed speed to use for emitted particles.

mindirectedspeed

<float> Minimum speed along the env_smoketrail's forward direction (x axis) to use for emitted particles.

maxdirectedspeed

<float> Maximum speed along the env_smoketrail's forward direction (x axis) to use for emitted particles.

startsize

<float> Starting particle size.

endsize

<float> Ending particle size.

spawnradius

<float> Distance from env_smoketrail at which particles are emitted.

firesprite

<sprite> Fire Sprite.

smokesprite

<sprite> Smoke Puff.

[edit]

Inputs

Kill

Removes this entity from the world.

KillHierarchy

Removes this entity and all its children from the world.

AddOutput <string>

Evaluates a keyvalue/output on this entity. It can be potentially very dangerous, use with care.

Format: <key> <value>

Format: <output name> <targetname>:<inputname>:<parameter>:<delay>:<max times to fire (-1 == infinite)>

FireUser1-4

Causes this entity's OnUser1-4 outputs to be fired. See User Inputs and Outputs.

SetParent <target_destination>

Changes the entity's parent in the movement hierarchy.

SetParentAttachment <string>

Change this entity to attach to a specific attachment point on its parent. Entities must be parented before being sent this input. The parameter passed in should be the name of the attachment.

SetParentAttachmentMaintainOffset <string> [Episode One Update]

Change this entity to attach to a specific attachment point on it's parent. Entities must be parented before being sent this input. The parameter passed in should be the name of the attachment. The entity will maintain it's position relative to the Parent's Origin and Angles at the time it is attached.