Particle Script - Revision history

Jackoalan: /* Int Elements */

2016-02-29T04:05:53Z

‎Int Elements

2016-02-29T03:21:31Z

2016-02-29T02:57:02Z

Replace woefully inaccurate guesses with properly researched discoveries

2016-02-27T20:39:30Z

Jackoalan moved page Effect Script to Particle Script: "Particle" is the canonical encompassing term (CParticleGen being the relevant superclass)

2016-02-04T00:33:41Z

ITRL and GTCP corrections

2015-02-25T10:37:38Z

‎Script Nodes

2015-02-22T07:34:34Z

‎File Layout

2015-02-22T07:33:44Z

‎File Layout

2015-02-21T02:22:21Z

2015-02-21T01:47:00Z

Added layout section

@@ Line 90: / Line 90: @@
 {{ParticleElementRow|DETH|IntElement&nbsp;passthrough, IntElement&nbsp;thresholdFrame|Death|Always returns ''passthrough'', and signals out-of-band to cease updating the system when the current frame index exceeds ''thresholdFrame''|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|GAPC||Get Active Particle Count|Accesses the current count of particles in the system|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
-{{ParticleElementRow|GEMT||{{unknown|'''Unknown'''}}||{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
+{{ParticleElementRow|GEMT||Get Emitter Time|Accesses the current frame count for the current particle system|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
-{{ParticleElementRow|GTCP||{{unknown|'''Unknown'''}}||{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
+{{ParticleElementRow|GTCP||Get Cumulative Particle Count|Accesses the total number of particles created over the particle system's lifetime (including those that have died)|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|ILPT|IntElement&nbsp;percent|Lifetime Percent|Queries the frame index at ''percent''/100.0 into the lifetime of the particle instance|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|IMPL|IntElement&nbsp;val|Impulse|Returns ''val'' ONLY at frame index 0, then returns 0 for subsequent frames|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}

@@ Line 89: / Line 89: @@
 {{ParticleElementRow|CNST|s32&nbsp;value|Constant|Returns ''value'' on every call|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|DETH|IntElement&nbsp;passthrough, IntElement&nbsp;thresholdFrame|Death|Always returns ''passthrough'', and signals out-of-band to cease updating the system when the current frame index exceeds ''thresholdFrame''|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
-{{ParticleElementRow|GAPC||{{unknown|'''Unknown'''}}||{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
+{{ParticleElementRow|GAPC||Get Active Particle Count|Accesses the current count of particles in the system|{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|GEMT||{{unknown|'''Unknown'''}}||{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}
 {{ParticleElementRow|GTCP||{{unknown|'''Unknown'''}}||{{check}}|{{check}}|{{check}}|{{check}}|{{check}}}}

@@ Line 229: / Line 229: @@
 |–
 |-
-|<code>float '''ITRL'''(float val)</code>
+|<code>float '''ITRL'''(int a, float b)</code>
 |–
 |–
 |–
 |-
-|<code>float '''GTCP'''(int val)</code>
+|<code>int '''GTCP'''()</code>
 |–
 |–

@@ Line 57: / Line 57: @@
 == Script Nodes ==
-Many of the animated qualities from effect scripts are achieved with dynamic ''script nodes''.
+Many of the animated qualities in effect scripts are achieved with dynamic ''script nodes''.
 These nodes provide parameter I/O interfaces and internally process numeric data that passes through.
 They may also gather data from other sources within the effect system.

@@ Line 17: / Line 17: @@
 ** Value Parameter(s) (one of:)
 *** <code>CNST</code>: Bool/Scalar/Vector literal
-**** 1-4 bool/int/float values
+**** bool/int/float/float3/float4 value
 *** <code>NONE</code>: Dummy value (equivalent to not specifying the key at all)
 *** Node Key ([[#Script Nodes|see below]])

← Older revision	Revision as of 20:39, 27 February 2016
(No difference)

@@ Line 1: / Line 1: @@
 {{research|1|Details are subject to corrections}}
 Retro games feature a uniform, fixed-function '''Effect Script''' system for describing various geometrical effects and weapon systems.
 The PAK archives contain binary resources using [[wikipedia:FourCC|FourCCs]] to build a [[wikipedia:Associative_array|key-value dictionary]].

@@ Line 8: / Line 8: @@
 parameters to be evaluated and assigned to the dictionary. In addition, the various effect systems provide dynamic node classes that are evaluated as part of the effect runtime.
 Ultimately, the systems use a recursive, node-based approach of generating animated scalar and vector values to control the effect.
 == Script Types ==
@@ Line 13: / Line 28: @@
 {| class="wikitable"
 !Type
 !Purpose
 |-
 |[[PART (File Format)|PART]]
 |Particle effect
 |-
 |[[SWHC (File Format)|SWHC]]
 |Swoosh effect
 |-
 |[[ELSC (File Format)|ELSC]]
 |Electric effect
 |-
 |[[DPSC (File Format)|DPSC]]
 |Decal effect
 |-
 |[[WPSC (File Format)|WPSC]]
 |Projectile weapon configuration
 |-
 |[[CRSC (File Format)|CRSC]]
 |Projectile collision response configuration
 |}