TiMan: Expand the SOMA guide with verified stock examples, practical steps and precise remaining documentation gaps.

2026-10-02T12:48:21Z

Expand the SOMA guide with verified stock examples, practical steps and precise remaining documentation gaps.

TiMan: Add source-verified reference; mark undocumented workflow and behavior for expansion.

2026-10-02T11:33:23Z

Add source-verified reference; mark undocumented workflow and behavior for expansion.

New page

{{shortPageTitle}}
{{stub}}

The <code>EnvParticles</code> element in SOMA’s <code>maps/chapter00/00_01_apartment/00_01_apartment.hpm</code> records the following level settings.

== Serialized SOMA example ==
{| class="wikitable"
! Attribute !! Example value
|-
| <code>Color</code> || <code>1 1 1 1</code>
|-
| <code>Brightness</code> || <code>1</code>
|-
| <code>BoxDistance</code> || <code>2</code>
|-
| <code>GravityVelocity</code> || <code>0 0 0</code>
|-
| <code>GravitySpeedRandomAmount</code> || <code>0</code>
|-
| <code>WindVelocity</code> || <code>0 0 0</code>
|-
| <code>WindSpeedRandomAmount</code> || <code>0</code>
|-
| <code>WindDirRandomAmount</code> || <code>0</code>
|-
| <code>RotateVelocity</code> || <code>0 0 0</code>
|-
| <code>RotateSpeedRandomAmount</code> || <code>0</code>
|-
| <code>RotateBothDirs</code> || <code>false</code>
|-
| <code>NumIterations</code> || <code>1</code>
|-
| <code>FadeInStart</code> || <code>0.2</code>
|-
| <code>FadeInEnd</code> || <code>1</code>
|-
| <code>FadeOutStart</code> || <code>10</code>
|-
| <code>FadeOutEnd</code> || <code>20</code>
|-
| <code>BoxSize</code> || <code>30</code>
|-
| <code>NumParticles</code> || <code>100</code>
|-
| <code>ParticleSize</code> || <code>1 1</code>
|-
| <code>SubDivUV</code> || <code>1 1</code>
|-
| <code>AffectedByLight</code> || <code>false</code>
|-
| <code>Texture</code> || <code>""</code>
|-
| <code>Active</code> || <code>false</code>
|}

== Editor documentation ==
The documented Env Particles tab contains Active, Color and Brightness controls.

== See also ==
* [[HPL3/Level Design/Level Settings|Level settings]]

== Documentation to expand ==
The complete current editor controls, units and a worked visual example need expansion.

[[Category:English]]

@@ Line 1: / Line 1: @@
 {{shortPageTitle}}
 {{stub}}
-The <code>EnvParticles</code> element in SOMA’s <code>maps/chapter00/00_01_apartment/00_01_apartment.hpm</code> records the following level settings.
+Environment particles add a field of textured particles to a level. SOMA’s underwater maps use them with the shipped <code>waterdust_tiny_3x3.dds</code> texture. The renderer turns the particle faces toward the camera and wraps their positions inside a box, so this is a repeating particle field.
-== Serialized SOMA example ==
+During its transition towards Theta Outside, the same stock script fades all matching particle layers to a new color and brightness:
-== Editor documentation ==
+<syntaxhighlight lang="cpp">
-The documented Env Particles tab contains Active, Color and Brightness controls.
+Map_FadeEnvironmentParticleColor("*", cColor(0.295,0.556,0.59,1.0), 7);
 == See also ==
-* [[HPL3/Level Design/Level Settings|Level settings]]
+* [[HPL3/Level Design/Level Settings|Level Settings]]
+* [[HPL3/SOMA/Scripting/Map Helper|Map scripting helpers]]
-== Documentation to expand ==
+* [[HPL3/SOMA/Scripting/Map Effects Handler|Fading level effects]]
 [[Category:English]]

HPL3/SOMA/Level Design/Environment Particles - Revision history

TiMan: Expand the SOMA guide with verified stock examples, practical steps and precise remaining documentation gaps.

TiMan: Add source-verified reference; mark undocumented workflow and behavior for expansion.