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

Func dustmotes: Difference between revisions

From Valve Developer Community
Jump to navigation Jump to search
mNo edit summary
(Remove note about using trigger texture/nodraw. Was added in 2009 and unless proof is given otherwise the texture makes no difference.)
 
(17 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{LanguageBar}}
[[File:Func_dustmotes_example_css.jpg|thumb|right|260px|A <code>func_dustmotes</code> in <code>cs_militia</code>{{css}}.]]
[[File:Func_dustmotes_example_css.jpg|thumb|right|260px|A <code>func_dustmotes</code> in <code>cs_militia</code>{{css}}.]]
{{base brush|func_dustmotes}} It spawns sparkling dust motes within its volume. Use the [[tool textures#trigger|trigger]] texture with this entity. The [[tool textures#nodraw|nodraw]] texture can also be used, but not recommended.{{sfx_brush}}
{{CD|CFunc_DustMotes|file1=1}}
{{this is a|brush entity|name=func_dustmotes}} It spawns sparkling dust motes within its volume.{{sfx_brush}}


{{tip|This entity is affected by {{ent|env_wind}}.}}
{{note|This entity is affected by {{ent|env_wind}}. The dustmotes can be carried through walls.}}


{{note|The default [[material]] is <code>particle/sparkles.vmt</code>. It is normally extremely low-res, so consider overriding this .[[vmt]] for improved appearance.}}
{{note|The default [[material]] is <code>particle/sparkles.vmt</code>. It is normally extremely low-res, so consider overriding this .[[vmt]] for improved appearance.}}


{{note|This entity is functionally identical to <code>func_dustcloud</code> except that the size of sprites created by <code>func_dustcloud</code> will scale realistically depending on the viewing distance, and ones created by ''this'' entity will always take up the same amount of screen space regardless of viewing distance.}}
{{note|This entity is functionally identical to {{ent|func_dustcloud}} except that the size of sprites created by <code>func_dustcloud</code> will scale realistically depending on the viewing distance, and ones created by ''this'' entity will always take up the same amount of screen space regardless of viewing distance.}}


==Keyvalues==
==Keyvalues==
{{KV|Minimum Particle Size|string|Minimum size a dust mote should be. The units aren't exactly clear, but 100 is the highest you should probably be going.}}
{{KV|Maximum Particle Size|string|Maximum size a dust mote should be.}}
{{KV|Alpha|integer|Transparency of the particles. 255 is fully opaque, 0 is invisible (won't render at all).}}
{{KV Targetname}}
{{KV Targetname}}
{{KV|Minimum Particle Size|intn=SizeMin|string|Minimum size a dust mote should be. The units aren't exactly clear, but 100 is the highest you should probably be going.}}
{{KV|Maximum Particle Size|intn=SizeMax|string|Maximum size a dust mote should be.}}
{{KV|Alpha|intn=Alpha |integer|Transparency of the particles. 255 is fully opaque, 0 is invisible (won't render at all).}}
{{KV|Affected By Wind|intn=AffectedByWind|boolean|since=CSGO|Sets if dust particles are affected by wind.}}
{{KV BModelParticleSpawner}}
{{KV BModelParticleSpawner}}
{{KV AffectedByWind | If is affected by wind. This was added in Counter Strike: Global Offensive}}


==Inputs==
==Inputs==
{{I Targetname}}
{{I BModelParticleSpawner}}
{{I BModelParticleSpawner}}


==Outputs==
== See Also ==
{{O Targetname}}
* {{ent|func_dustcloud}}

Latest revision as of 17:14, 11 November 2024

English (en)Русский (ru)Translate (Translate)
A func_dustmotes in cs_militiaCounter-Strike: Source.
C++ Class hierarchy
CFunc_DustMotes
↳CFunc_Dust
↳CBaseEntity
C++ func_dust.cpp

func_dustmotes is a brush entity available in all Source Source games. It spawns sparkling dust motes within its volume.

Note.pngNote:This entity is affected by env_wind. The dustmotes can be carried through walls.
Note.pngNote:The default material is particle/sparkles.vmt. It is normally extremely low-res, so consider overriding this .vmt for improved appearance.
Note.pngNote:This entity is functionally identical to func_dustcloud except that the size of sprites created by func_dustcloud will scale realistically depending on the viewing distance, and ones created by this entity will always take up the same amount of screen space regardless of viewing distance.

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

Minimum Particle Size (SizeMin) <string>
Minimum size a dust mote should be. The units aren't exactly clear, but 100 is the highest you should probably be going.
Maximum Particle Size (SizeMax) <string>
Maximum size a dust mote should be.
Alpha (Alpha) <integer>
Transparency of the particles. 255 is fully opaque, 0 is invisible (won't render at all).
Affected By Wind (AffectedByWind) <boolean> (in all games since Counter-Strike: Global Offensive)
Sets if dust particles are affected by wind.
BModelParticleSpawner:
Start Disabled (StartDisabled) <boolean>
Suspend spawning particles after spawning ? Default value is 0
Particle Color (R G B) (Color) <color255>
Color of the particles.
Particle Per Second (SpawnRate) <integer>
Number of particles to spawn, per second.
Note.pngNote:Fourth number effects transparency after reload.
Maximum Particle Speed (SpeedMax) <string>
Maximum speed that the particles can move after spawning.
Minimum Particle Lifetime (LifetimeMin) <string>
Minimum number of seconds until each particle dies. Particles live for a random duration between this and 'Maximum Particle Lifetime'.
Maximum Particle Lifetime (LifetimeMax) <string>
Maximum number of seconds until each particle dies. Particles live for a random duration between 'Minimum Particle Lifetime' and this.
Maximum Visible Distance (DistMax) <integer>
Maximum distance at which particles are visible. They fade to translucent at this distance.
Frozen (Frozen) <boolean>
Spawn the number of particles in SpawnRate immediately, and then go inactive ? Default value is 0


Inputs

BModelParticleSpawner:
TurnOn
Turn on.
TurnOff
Turn off.

See Also

Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Func_dustmotes&oldid=457281"