@origingame/engine 0.1.0 → 0.2.0

package/knowledge/wiki/render.md

@@ -14,7 +14,7 @@ module render {
   # declarations follow, each quoted below
 ```
 
-<sub>`api.ogt` line 1649</sub>
+<sub>`api.ogt` line 1660</sub>
 
 ## Contents
 
@@ -70,6 +70,7 @@ module render {
 | [`og.Light2D`](#record-Light2D) | component | A light in the 2D plane at the entity's position (z ignored): color times intensity at its centre, falling to zero at radius with (1 - d/r)^falloff, shadowed by occluders when castShadows. Lighting2D.enabled turns 2D lighting on; at most 64 are drawn. |
 | [`og.Occluder2D`](#record-Occluder2D) | component | A rectangle that blocks 2D light (walls, crates, characters), centred on the entity's position and turned with it about z. Pixels inside it are not shadowed by it. At most 128 are drawn. |
 | [`og.Decal`](#record-Decal) | component | A projected decal (scorch marks, blood, posters, bullet holes): the entity's unit box (-0.5 to 0.5 on each axis, scaled by its Transform) projected along its local -Z onto every lit opaque surface inside it, shaded with the surface. Its image is the uvMin to uvMax region of RenderSettings.decalAtlas (a solid colour without one). At most 32 are drawn. |
+| [`PARTICLES_ARMED`](#const-PARTICLES_ARMED) | constant | ParticleSystem.startTick's default: never written. A looping emitter emits as if started at tick 0; a one-shot (`looping false`) emits nothing until its startTick is written, so a burst spawned in `start` waits for its first use. Write it back to re-arm a one-shot without firing it. |
 | [`og.ParticleSystem`](#record-ParticleSystem) | component | Emits particles from an og.load.emitter asset at the entity's MatrixWorld. Particles are simulated by the renderer from (seed, startTick, the tick), so they are deterministic and replay, and never feed back into the simulation: compute on the full tier, the CPU on WebGL2, identical either way. |
 | [`og.Trail`](#record-Trail) | component | A streak behind the entity: its world positions over the last `lifetime` seconds as a camera-facing strip, from widthStart and color at the head to widthEnd and colorEnd at the tail. |
 | [`og.Beam`](#record-Beam) | component | A strip from the entity's position to `end` whose texture scrolls with the tick: lasers, tethers, lightning (jitter). |
@@ -137,7 +138,7 @@ fn ribbon {
 }
 ```
 
-<sub>`api.ogt` line 2874</sub>
+<sub>`api.ogt` line 2889</sub>
 
 <a id="fn-sprite"></a>
 
@@ -167,7 +168,7 @@ fn sprite {
 }
 ```
 
-<sub>`api.ogt` line 3002</sub>
+<sub>`api.ogt` line 3017</sub>
 
 <a id="fn-floatingText"></a>
 
@@ -197,7 +198,7 @@ fn floatingText {
 }
 ```
 
-<sub>`api.ogt` line 3179</sub>
+<sub>`api.ogt` line 3194</sub>
 
 <a id="fn-measureText"></a>
 
@@ -227,7 +228,7 @@ fn measureText {
 }
 ```
 
-<sub>`api.ogt` line 3186</sub>
+<sub>`api.ogt` line 3201</sub>
 
 <a id="fn-boxGeometry"></a>
 
@@ -257,7 +258,7 @@ fn boxGeometry {
 }
 ```
 
-<sub>`api.ogt` line 3255</sub>
+<sub>`api.ogt` line 3270</sub>
 
 <a id="fn-planeGeometry"></a>
 
@@ -287,7 +288,7 @@ fn planeGeometry {
 }
 ```
 
-<sub>`api.ogt` line 3262</sub>
+<sub>`api.ogt` line 3277</sub>
 
 <a id="fn-sphereGeometry"></a>
 
@@ -317,7 +318,7 @@ fn sphereGeometry {
 }
 ```
 
-<sub>`api.ogt` line 3269</sub>
+<sub>`api.ogt` line 3284</sub>
 
 <a id="fn-standardMaterial"></a>
 
@@ -347,7 +348,7 @@ fn standardMaterial {
 }
 ```
 
-<sub>`api.ogt` line 3293</sub>
+<sub>`api.ogt` line 3308</sub>
 
 <a id="fn-updateMaterial"></a>
 
@@ -379,7 +380,7 @@ fn updateMaterial {
 }
 ```
 
-<sub>`api.ogt` line 3300</sub>
+<sub>`api.ogt` line 3315</sub>
 
 <a id="fn-shaderMaterial"></a>
 
@@ -411,7 +412,7 @@ fn shaderMaterial {
 }
 ```
 
-<sub>`api.ogt` line 3310</sub>
+<sub>`api.ogt` line 3325</sub>
 
 <a id="fn-setMaterialShader"></a>
 
@@ -443,7 +444,7 @@ fn setMaterialShader {
 }
 ```
 
-<sub>`api.ogt` line 3318</sub>
+<sub>`api.ogt` line 3333</sub>
 
 <a id="fn-setShaderParam"></a>
 
@@ -477,7 +478,7 @@ fn setShaderParam {
 }
 ```
 
-<sub>`api.ogt` line 3326</sub>
+<sub>`api.ogt` line 3341</sub>
 
 <a id="fn-applyLook"></a>
 
@@ -507,7 +508,7 @@ fn applyLook {
 }
 ```
 
-<sub>`api.ogt` line 3335</sub>
+<sub>`api.ogt` line 3350</sub>
 
 <a id="fn-look"></a>
 
@@ -535,7 +536,7 @@ fn look {
 }
 ```
 
-<sub>`api.ogt` line 3342</sub>
+<sub>`api.ogt` line 3357</sub>
 
 <a id="fn-capabilities"></a>
 
@@ -563,7 +564,7 @@ fn capabilities {
 }
 ```
 
-<sub>`api.ogt` line 3348</sub>
+<sub>`api.ogt` line 3363</sub>
 
 <a id="fn-text"></a>
 
@@ -593,7 +594,7 @@ fn text {
 }
 ```
 
-<sub>`api.ogt` line 3354</sub>
+<sub>`api.ogt` line 3369</sub>
 
 ## Components, resources and events
 
@@ -647,7 +648,7 @@ component Mesh {
 }
 ```
 
-<sub>`api.ogt` line 1906</sub>
+<sub>`api.ogt` line 1917</sub>
 
 <a id="record-DirectionalLight"></a>
 
@@ -702,7 +703,7 @@ component DirectionalLight {
 }
 ```
 
-<sub>`api.ogt` line 1933</sub>
+<sub>`api.ogt` line 1944</sub>
 
 <a id="record-PointLight"></a>
 
@@ -743,7 +744,7 @@ component PointLight {
 }
 ```
 
-<sub>`api.ogt` line 1965</sub>
+<sub>`api.ogt` line 1976</sub>
 
 <a id="record-SpotLight"></a>
 
@@ -795,7 +796,7 @@ component SpotLight {
 }
 ```
 
-<sub>`api.ogt` line 1985</sub>
+<sub>`api.ogt` line 1996</sub>
 
 <a id="record-RenderSettings"></a>
 
@@ -872,7 +873,7 @@ resource RenderSettings {
 }
 ```
 
-<sub>`api.ogt` line 2030</sub>
+<sub>`api.ogt` line 2041</sub>
 
 <a id="record-Environment"></a>
 
@@ -912,7 +913,7 @@ resource Environment {
 }
 ```
 
-<sub>`api.ogt` line 2106</sub>
+<sub>`api.ogt` line 2117</sub>
 
 <a id="record-PostEffects"></a>
 
@@ -1149,7 +1150,7 @@ resource PostEffects {
 }
 ```
 
-<sub>`api.ogt` line 2186</sub>
+<sub>`api.ogt` line 2197</sub>
 
 <a id="record-Stylise"></a>
 
@@ -1404,7 +1405,7 @@ resource Stylise {
 }
 ```
 
-<sub>`api.ogt` line 2404</sub>
+<sub>`api.ogt` line 2415</sub>
 
 <a id="record-MaterialStyle"></a>
 
@@ -1469,7 +1470,7 @@ resource MaterialStyle {
 }
 ```
 
-<sub>`api.ogt` line 2597</sub>
+<sub>`api.ogt` line 2608</sub>
 
 <a id="record-Lighting2D"></a>
 
@@ -1508,7 +1509,7 @@ resource Lighting2D {
 }
 ```
 
-<sub>`api.ogt` line 2647</sub>
+<sub>`api.ogt` line 2658</sub>
 
 <a id="record-Light2D"></a>
 
@@ -1559,7 +1560,7 @@ component Light2D {
 }
 ```
 
-<sub>`api.ogt` line 2666</sub>
+<sub>`api.ogt` line 2677</sub>
 
 <a id="record-Occluder2D"></a>
 
@@ -1590,7 +1591,7 @@ component Occluder2D {
 }
 ```
 
-<sub>`api.ogt` line 2696</sub>
+<sub>`api.ogt` line 2707</sub>
 
 <a id="record-Decal"></a>
 
@@ -1645,7 +1646,7 @@ component Decal {
 }
 ```
 
-<sub>`api.ogt` line 2710</sub>
+<sub>`api.ogt` line 2721</sub>
 
 <a id="record-ParticleSystem"></a>
 
@@ -1659,7 +1660,7 @@ Token `og.ParticleSystem`, registered under the schema name `og.ParticleSystem`;
 |---|---|---|---|---|---|---|
 | `emitter` | `ParticleEmitter` | `0` | — | — | — | The emitter asset; 0 draws nothing. |
 | `seed` | `number` | `0` | — | — | — | The random seed: systems with different seeds differ. |
-| `startTick` | `number` | `0` | — | — | — | The tick emission started: write og.world tick when spawning a one-shot burst. |
+| `startTick` | `number` | `4294967295` | — | — | — | The tick emission started: write the tick (`time.tick`, `world.tick`) to fire a one-shot burst, or to restart one. Its default, PARTICLES_ARMED, is never written: a looping emitter emits as if started at tick 0, while a one-shot (`looping false`) stays armed and emits nothing until a tick is written, so effects spawned ahead of their first use wait. |
 | `stopTick` | `number` | `0` | — | — | — | The tick emission stops (the particles live out); 0 keeps emitting while the emitter loops. |
 | `visible` | `boolean` | `true` | — | — | — | Whether it is drawn (a hidden system loses its particles). |
 
@@ -1668,7 +1669,9 @@ component ParticleSystem {
   doc "Emits particles from an og.load.emitter asset at the entity's MatrixWorld. Particles are simulated by the renderer from (seed, startTick, the tick), so they are deterministic and replay, and never feed back into the simulation: compute on the full tier, the CPU on WebGL2, identical either way."
   field emitter ParticleEmitter "The emitter asset; 0 draws nothing."
   field seed u32 "The random seed: systems with different seeds differ."
-  field startTick u32 "The tick emission started: write og.world tick when spawning a one-shot burst."
+  field startTick u32 "The tick emission started: write the tick (`time.tick`, `world.tick`) to fire a one-shot burst, or to restart one. Its default, PARTICLES_ARMED, is never written: a looping emitter emits as if started at tick 0, while a one-shot (`looping false`) stays armed and emits nothing until a tick is written, so effects spawned ahead of their first use wait." {
+    default 4294967295
+  }
   field stopTick u32 "The tick emission stops (the particles live out); 0 keeps emitting while the emitter loops."
   field visible bool "Whether it is drawn (a hidden system loses its particles)." {
     default true
@@ -1676,7 +1679,7 @@ component ParticleSystem {
 }
 ```
 
-<sub>`api.ogt` line 2742</sub>
+<sub>`api.ogt` line 2755</sub>
 
 <a id="record-Trail"></a>
 
@@ -1752,7 +1755,7 @@ component Trail {
 }
 ```
 
-<sub>`api.ogt` line 2753</sub>
+<sub>`api.ogt` line 2768</sub>
 
 <a id="record-Beam"></a>
 
@@ -1818,7 +1821,7 @@ component Beam {
 }
 ```
 
-<sub>`api.ogt` line 2801</sub>
+<sub>`api.ogt` line 2816</sub>
 
 <a id="record-Sprite"></a>
 
@@ -1949,7 +1952,7 @@ component Sprite {
 }
 ```
 
-<sub>`api.ogt` line 3009</sub>
+<sub>`api.ogt` line 3024</sub>
 
 <a id="record-Afterimage"></a>
 
@@ -1997,7 +2000,7 @@ component Afterimage {
 }
 ```
 
-<sub>`api.ogt` line 3094</sub>
+<sub>`api.ogt` line 3109</sub>
 
 ## Types
 
@@ -2013,7 +2016,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Geometry "Vertex and index data, as three.js BufferGeometry. Comes from a loaded glTF."
 ```
 
-<sub>`api.ogt` line 1653</sub>
+<sub>`api.ogt` line 1664</sub>
 
 <a id="type-Material"></a>
 
@@ -2027,7 +2030,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Material "A material instance."
 ```
 
-<sub>`api.ogt` line 1654</sub>
+<sub>`api.ogt` line 1665</sub>
 
 <a id="type-Texture"></a>
 
@@ -2041,7 +2044,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Texture "A cooked texture."
 ```
 
-<sub>`api.ogt` line 1655</sub>
+<sub>`api.ogt` line 1666</sub>
 
 <a id="type-Side"></a>
 
@@ -2066,7 +2069,7 @@ enum Side {
 }
 ```
 
-<sub>`api.ogt` line 1671</sub>
+<sub>`api.ogt` line 1682</sub>
 
 <a id="type-RenderTier"></a>
 
@@ -2097,7 +2100,7 @@ enum RenderTier {
 }
 ```
 
-<sub>`api.ogt` line 1678</sub>
+<sub>`api.ogt` line 1689</sub>
 
 <a id="type-Antialias"></a>
 
@@ -2126,7 +2129,7 @@ enum Antialias {
 }
 ```
 
-<sub>`api.ogt` line 1688</sub>
+<sub>`api.ogt` line 1699</sub>
 
 <a id="type-PointShadows"></a>
 
@@ -2151,7 +2154,7 @@ enum PointShadows {
 }
 ```
 
-<sub>`api.ogt` line 1697</sub>
+<sub>`api.ogt` line 1708</sub>
 
 <a id="type-TaaHistory"></a>
 
@@ -2174,7 +2177,7 @@ enum TaaHistory {
 }
 ```
 
-<sub>`api.ogt` line 1704</sub>
+<sub>`api.ogt` line 1715</sub>
 
 <a id="type-RenderOptions"></a>
 
@@ -2212,7 +2215,7 @@ struct RenderOptions {
 }
 ```
 
-<sub>`api.ogt` line 1710</sub>
+<sub>`api.ogt` line 1721</sub>
 
 <a id="type-StandardMaterialDesc"></a>
 
@@ -2480,7 +2483,7 @@ struct StandardMaterialDesc {
 }
 ```
 
-<sub>`api.ogt` line 1728</sub>
+<sub>`api.ogt` line 1739</sub>
 
 <a id="type-ToneMapping"></a>
 
@@ -2505,7 +2508,7 @@ enum ToneMapping {
 }
 ```
 
-<sub>`api.ogt` line 2016</sub>
+<sub>`api.ogt` line 2027</sub>
 
 <a id="type-Lut"></a>
 
@@ -2519,7 +2522,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Lut "A colour lookup table for PostEffects.lut, from og.load.lut (a `.cube` file)."
 ```
 
-<sub>`api.ogt` line 2081</sub>
+<sub>`api.ogt` line 2092</sub>
 
 <a id="type-EnvironmentMap"></a>
 
@@ -2533,7 +2536,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle EnvironmentMap "A prefiltered HDR environment map for Environment.map, from og.load.environment (an `.ogt` of `type environment` naming an equirectangular `.hdr` or `.exr`, a KTX2 cube map, or six face images)."
 ```
 
-<sub>`api.ogt` line 2082</sub>
+<sub>`api.ogt` line 2093</sub>
 
 <a id="type-ParticleEmitter"></a>
 
@@ -2547,7 +2550,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle ParticleEmitter "A particle emitter asset for ParticleSystem.emitter, from og.load.emitter (an `.ogt` of `type particles`)."
 ```
 
-<sub>`api.ogt` line 2083</sub>
+<sub>`api.ogt` line 2094</sub>
 
 <a id="type-AoMethod"></a>
 
@@ -2572,7 +2575,7 @@ enum AoMethod {
 }
 ```
 
-<sub>`api.ogt` line 2133</sub>
+<sub>`api.ogt` line 2144</sub>
 
 <a id="type-DofQuality"></a>
 
@@ -2595,7 +2598,7 @@ enum DofQuality {
 }
 ```
 
-<sub>`api.ogt` line 2147</sub>
+<sub>`api.ogt` line 2158</sub>
 
 <a id="type-SpriteBlend"></a>
 
@@ -2618,7 +2621,7 @@ enum SpriteBlend {
 }
 ```
 
-<sub>`api.ogt` line 2160</sub>
+<sub>`api.ogt` line 2171</sub>
 
 <a id="type-StripBlend"></a>
 
@@ -2641,7 +2644,7 @@ enum StripBlend {
 }
 ```
 
-<sub>`api.ogt` line 2173</sub>
+<sub>`api.ogt` line 2184</sub>
 
 <a id="type-Palette"></a>
 
@@ -2655,7 +2658,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Palette "A colour palette for Stylise.palette, from og.load.palette (a `.hex` or GIMP `.gpl` file of up to 256 colours)."
 ```
 
-<sub>`api.ogt` line 2363</sub>
+<sub>`api.ogt` line 2374</sub>
 
 <a id="type-Look"></a>
 
@@ -2669,7 +2672,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Look "A look from og.load.look (an `.ogt` of `type look`): the frame's whole art direction as data, applied with og.render.applyLook."
 ```
 
-<sub>`api.ogt` line 2364</sub>
+<sub>`api.ogt` line 2375</sub>
 
 <a id="type-DitherPattern"></a>
 
@@ -2700,7 +2703,7 @@ enum DitherPattern {
 }
 ```
 
-<sub>`api.ogt` line 2373</sub>
+<sub>`api.ogt` line 2384</sub>
 
 <a id="type-StyliseSpace"></a>
 
@@ -2725,7 +2728,7 @@ enum StyliseSpace {
 }
 ```
 
-<sub>`api.ogt` line 2390</sub>
+<sub>`api.ogt` line 2401</sub>
 
 <a id="type-LookInfo"></a>
 
@@ -2756,7 +2759,7 @@ struct LookInfo {
 }
 ```
 
-<sub>`api.ogt` line 2636</sub>
+<sub>`api.ogt` line 2647</sub>
 
 <a id="type-RibbonPoint"></a>
 
@@ -2796,7 +2799,7 @@ struct RibbonPoint {
 }
 ```
 
-<sub>`api.ogt` line 2841</sub>
+<sub>`api.ogt` line 2856</sub>
 
 <a id="type-RibbonDesc"></a>
 
@@ -2827,7 +2830,7 @@ struct RibbonDesc {
 }
 ```
 
-<sub>`api.ogt` line 2862</sub>
+<sub>`api.ogt` line 2877</sub>
 
 <a id="type-TextDesc"></a>
 
@@ -2889,7 +2892,7 @@ struct TextDesc {
 }
 ```
 
-<sub>`api.ogt` line 2881</sub>
+<sub>`api.ogt` line 2896</sub>
 
 <a id="type-TextMeasureDesc"></a>
 
@@ -2918,7 +2921,7 @@ struct TextMeasureDesc {
 }
 ```
 
-<sub>`api.ogt` line 2915</sub>
+<sub>`api.ogt` line 2930</sub>
 
 <a id="type-TextMetrics"></a>
 
@@ -2941,7 +2944,7 @@ struct TextMetrics {
 }
 ```
 
-<sub>`api.ogt` line 2926</sub>
+<sub>`api.ogt` line 2941</sub>
 
 <a id="type-SpriteDesc"></a>
 
@@ -3052,7 +3055,7 @@ struct SpriteDesc {
 }
 ```
 
-<sub>`api.ogt` line 2933</sub>
+<sub>`api.ogt` line 2948</sub>
 
 <a id="type-FloatingTextDesc"></a>
 
@@ -3140,7 +3143,7 @@ struct FloatingTextDesc {
 }
 ```
 
-<sub>`api.ogt` line 3121</sub>
+<sub>`api.ogt` line 3136</sub>
 
 <a id="type-BoxGeometryDesc"></a>
 
@@ -3182,7 +3185,7 @@ struct BoxGeometryDesc {
 }
 ```
 
-<sub>`api.ogt` line 3193</sub>
+<sub>`api.ogt` line 3208</sub>
 
 <a id="type-PlaneGeometryDesc"></a>
 
@@ -3218,7 +3221,7 @@ struct PlaneGeometryDesc {
 }
 ```
 
-<sub>`api.ogt` line 3216</sub>
+<sub>`api.ogt` line 3231</sub>
 
 <a id="type-SphereGeometryDesc"></a>
 
@@ -3258,7 +3261,7 @@ struct SphereGeometryDesc {
 }
 ```
 
-<sub>`api.ogt` line 3234</sub>
+<sub>`api.ogt` line 3249</sub>
 
 <a id="type-RenderCapabilities"></a>
 
@@ -3293,7 +3296,7 @@ struct RenderCapabilities {
 }
 ```
 
-<sub>`api.ogt` line 3280</sub>
+<sub>`api.ogt` line 3295</sub>
 
 <a id="type-Shader"></a>
 
@@ -3307,7 +3310,7 @@ A generational handle: a number the engine hands out. A dead handle is an error
 handle Shader "A material shader from og.load.shader (an `.ogt` of `type shader`): WGSL hooks of the lit shader and the parameters they read."
 ```
 
-<sub>`api.ogt` line 3308</sub>
+<sub>`api.ogt` line 3323</sub>
 
 ## Column kinds
 
@@ -3339,7 +3342,7 @@ column Geometry {
 }
 ```
 
-<sub>`api.ogt` line 1657</sub>
+<sub>`api.ogt` line 1668</sub>
 
 ```ogt
 column Material {
@@ -3350,7 +3353,7 @@ column Material {
 }
 ```
 
-<sub>`api.ogt` line 1664</sub>
+<sub>`api.ogt` line 1675</sub>
 
 ```ogt
 column ToneMapping {
@@ -3361,7 +3364,7 @@ column ToneMapping {
 }
 ```
 
-<sub>`api.ogt` line 2023</sub>
+<sub>`api.ogt` line 2034</sub>
 
 ```ogt
 column Texture {
@@ -3372,7 +3375,7 @@ column Texture {
 }
 ```
 
-<sub>`api.ogt` line 2085</sub>
+<sub>`api.ogt` line 2096</sub>
 
 ```ogt
 column Lut {
@@ -3383,7 +3386,7 @@ column Lut {
 }
 ```
 
-<sub>`api.ogt` line 2092</sub>
+<sub>`api.ogt` line 2103</sub>
 
 ```ogt
 column EnvironmentMap {
@@ -3394,7 +3397,7 @@ column EnvironmentMap {
 }
 ```
 
-<sub>`api.ogt` line 2099</sub>
+<sub>`api.ogt` line 2110</sub>
 
 ```ogt
 column ParticleEmitter {
@@ -3405,7 +3408,7 @@ column ParticleEmitter {
 }
 ```
 
-<sub>`api.ogt` line 2126</sub>
+<sub>`api.ogt` line 2137</sub>
 
 ```ogt
 column AoMethod {
@@ -3416,7 +3419,7 @@ column AoMethod {
 }
 ```
 
-<sub>`api.ogt` line 2140</sub>
+<sub>`api.ogt` line 2151</sub>
 
 ```ogt
 column DofQuality {
@@ -3427,7 +3430,7 @@ column DofQuality {
 }
 ```
 
-<sub>`api.ogt` line 2153</sub>
+<sub>`api.ogt` line 2164</sub>
 
 ```ogt
 column SpriteBlend {
@@ -3438,7 +3441,7 @@ column SpriteBlend {
 }
 ```
 
-<sub>`api.ogt` line 2166</sub>
+<sub>`api.ogt` line 2177</sub>
 
 ```ogt
 column StripBlend {
@@ -3449,7 +3452,7 @@ column StripBlend {
 }
 ```
 
-<sub>`api.ogt` line 2179</sub>
+<sub>`api.ogt` line 2190</sub>
 
 ```ogt
 column Palette {
@@ -3460,7 +3463,7 @@ column Palette {
 }
 ```
 
-<sub>`api.ogt` line 2366</sub>
+<sub>`api.ogt` line 2377</sub>
 
 ```ogt
 column DitherPattern {
@@ -3471,7 +3474,7 @@ column DitherPattern {
 }
 ```
 
-<sub>`api.ogt` line 2383</sub>
+<sub>`api.ogt` line 2394</sub>
 
 ```ogt
 column StyliseSpace {
@@ -3482,30 +3485,37 @@ column StyliseSpace {
 }
 ```
 
-<sub>`api.ogt` line 2397</sub>
+<sub>`api.ogt` line 2408</sub>
 
 ## Constants
 
 | Constant | Type | Value | Doc |
 |---|---|---|---|
+| <a id="const-PARTICLES_ARMED"></a>`PARTICLES_ARMED` | `number` | `4294967295` | ParticleSystem.startTick's default: never written. A looping emitter emits as if started at tick 0; a one-shot (`looping false`) emits nothing until its startTick is written, so a burst spawned in `start` waits for its first use. Write it back to re-arm a one-shot without firing it. |
 | <a id="const-MAX_LIGHTS"></a>`MAX_LIGHTS` | `number` | `256` | The most point and spot lights one frame draws, among those in view; past it the ones brightest at the camera are kept. |
 | <a id="const-MAX_CLUSTER_LIGHTS"></a>`MAX_CLUSTER_LIGHTS` | `number` | `64` | The most point and spot lights that shade one screen cluster (a 1/16 by 1/9 tile of the view and one of 24 depth slices); past it the ones brightest at the camera are kept there. |
 | <a id="const-UI_LAYER"></a>`UI_LAYER` | `number` | `1000` | The UI's layer among screen sprites and screen text (SpriteDesc and TextDesc with screen): those at or below it draw under every og.ui element, those above it over every one, modals, toasts and the screen transition included (a HUD element made of sprites sitting on a UI panel: draw it only while its screen shows), in their layers' order either way. |
 
+```ogt
+const PARTICLES_ARMED u32 4294967295 "ParticleSystem.startTick's default: never written. A looping emitter emits as if started at tick 0; a one-shot (`looping false`) emits nothing until its startTick is written, so a burst spawned in `start` waits for its first use. Write it back to re-arm a one-shot without firing it."
+```
+
+<sub>`api.ogt` line 2753</sub>
+
 ```ogt
 const MAX_LIGHTS u32 256 "The most point and spot lights one frame draws, among those in view; past it the ones brightest at the camera are kept."
 ```
 
-<sub>`api.ogt` line 3276</sub>
+<sub>`api.ogt` line 3291</sub>
 
 ```ogt
 const MAX_CLUSTER_LIGHTS u32 64 "The most point and spot lights that shade one screen cluster (a 1/16 by 1/9 tile of the view and one of 24 depth slices); past it the ones brightest at the camera are kept there."
 ```
 
-<sub>`api.ogt` line 3277</sub>
+<sub>`api.ogt` line 3292</sub>
 
 ```ogt
 const UI_LAYER i32 1000 "The UI's layer among screen sprites and screen text (SpriteDesc and TextDesc with screen): those at or below it draw under every og.ui element, those above it over every one, modals, toasts and the screen transition included (a HUD element made of sprites sitting on a UI panel: draw it only while its screen shows), in their layers' order either way."
 ```
 
-<sub>`api.ogt` line 3278</sub>
+<sub>`api.ogt` line 3293</sub>