Difference between revisions of "AsBirthRule"
m (→blah) |
m (→Headings) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 14: | Line 14: | ||
{| class="wikitable" | {| class="wikitable" | ||
|+ Tags of the asBirthRule block | |+ Tags of the asBirthRule block | ||
| − | ! | + | !Tag!!Format!!Description |
|- | |- | ||
|Position||float float float||Position where particles originate | |Position||float float float||Position where particles originate | ||
| Line 33: | Line 33: | ||
|MassVar||float||Variance in particle mass | |MassVar||float||Variance in particle mass | ||
|- | |- | ||
| − | |Radius||float||Size of | + | |Radius||float||Size of the invisible sphere containing all particles |
|- | |- | ||
| − | |RadiusVar||float||Variance in | + | |RadiusVar||float||Variance in containing sphere |
|- | |- | ||
|Drag||float||Unknown | |Drag||float||Unknown | ||
| Line 45: | Line 45: | ||
|DampVar||float||Variance in damp | |DampVar||float||Variance in damp | ||
|- | |- | ||
| − | |DRadius||float|| | + | |DRadius||float||Size of the particles |
|- | |- | ||
| − | |DRadiusVar||float||Variance in | + | |DRadiusVar||float||Variance in particle size |
|- | |- | ||
| − | |DAlpha||float|| | + | |DAlpha||float||Transparency of the particle |
|- | |- | ||
| − | |DAlphaVar||float||Variance in | + | |DAlphaVar||float||Variance in particle transparency |
|- | |- | ||
| − | |DRotation||float|| | + | |DRotation||float||Particle rotation speed, about what axis? |
|- | |- | ||
| − | |DRotationVar||float||Variance in | + | |DRotationVar||float||Variance in particle rotation |
|- | |- | ||
| − | |InitialBlast||int|| | + | |InitialBlast||int||Number of particles created immediately on activation |
|- | |- | ||
| − | |SpewRate||float|| | + | |SpewRate||float||Number of new particles per second? |
|- | |- | ||
|SpewTimeLimit||float||Maximum time, in seconds, for particle creation | |SpewTimeLimit||float||Maximum time, in seconds, for particle creation | ||
| Line 75: | Line 75: | ||
|Intensity||float||Unknown | |Intensity||float||Unknown | ||
|- | |- | ||
| − | |Color||int|| | + | |Color||int||Controls colour of the particles in some mysterious way that only Stereo understands |
|} | |} | ||
Latest revision as of 22:46, 6 August 2006
The asBirthRule files define a particle effect. A particle effect is an effect where many, small objects are spewed out from a point at certain occasions. For weather effects, the particles can be rain drops, for colliding with a parking meter, the particles may be coins.
The format is ASCII-based and consist of a block enclosed by { and }.
The files start with a definition of the type of banger data given. None of the MM2 files use anything but type a, like this:
type: a
Next comes the main asBirthRule block:
asBirthRule {
...
}
This block can contain several tag-value parameters:
| Tag | Format | Description |
|---|---|---|
| Position | float float float | Position where particles originate |
| PositionVar | float float float | Variance in position, the origin
is randomly modified within this range |
| Velocity | float float float | Velocity and direction of the particles when created |
| VelocityVar | float float float | Variance in velocity, the velocity is randomly modified within this range |
| Life | float | Life-time of the particles |
| LifeVar | float | Variance in life-time |
| Mass | float | Mass of a particle |
| MassVar | float | Variance in particle mass |
| Radius | float | Size of the invisible sphere containing all particles |
| RadiusVar | float | Variance in containing sphere |
| Drag | float | Unknown |
| DragVar | float | Variance in drag |
| Damp | float | Unknown |
| DampVar | float | Variance in damp |
| DRadius | float | Size of the particles |
| DRadiusVar | float | Variance in particle size |
| DAlpha | float | Transparency of the particle |
| DAlphaVar | float | Variance in particle transparency |
| DRotation | float | Particle rotation speed, about what axis? |
| DRotationVar | float | Variance in particle rotation |
| InitialBlast | int | Number of particles created immediately on activation |
| SpewRate | float | Number of new particles per second? |
| SpewTimeLimit | float | Maximum time, in seconds, for particle creation |
| Gravity | float | Gravitational factor for particles, for Earth conditions enter -9.8 or thereabaouts |
| TexFrameStart | int | Index of the first frame of particle animation in the image, see below |
| TexFrameEnd | int | Index of the last frame of particle animation in the image , see below |
| BirthFlags | int | Unknown |
| Height | float | Unknown |
| Intensity | float | Unknown |
| Color | int | Controls colour of the particles in some mysterious way that only Stereo understands |
Some of the global particle effects use the texture image named "TODO: I could have sworn that I saw an image where the indices matched all of the default vehicular particle effect, now I can't find it". This image, and all particle texture images, are divided into rectangular frames used for animation. All frames are equal in size and they are numbered for easy access in the asBirthRule. Animation sequences must be made up of consequtive frames in the image, but the image may contain other frames for different particle effects.
Oject collision particle effects may use other images, see TexNumber in dgBangerData, but these are structured in the same way, with frames and indices to the frames.
