particle.cfg

From GTAMods Wiki
Revision as of 23:16, 29 June 2017 by Spaceeinstein (talk | contribs)
Jump to navigation Jump to search

The particle.cfg file stores particle configuration data and settings for the particle system for GTA III and Vice City.

Format

See also: handling.cfg § Format and syntax description

The length of each line is limited to 500 characters instead of 200 characters in handling.cfg.

GTA III Vice City Identifier Type Description
A Particle name string The name of the particle.
B,C,D Rendering color integer[3] The particle color in RGB format. Each is a value between 0 and 255.
E Initial color variation integer Initial color variation of the particle. Using this value a random value gets calculated to manipulate each color level of the particle. This makes every particle look different. Value is between 0 and 100 (any value above 100 is set to 100).

Example:
Rendering color = (100, 100, 100), Initial color variation = 20
Real variation = random(-20, 20)
Real color = (100 + Real variation, 100 + Real variation, 100 + Real variation)

F,G,H Fade destination color integer[3] Destination color in RGB format if the particle is fading. Each is a value between 0 and 255.
I Fading time integer Time required to fade from the rendering color to the fade destination color. Value is between 0 and 100.
J Initial radius float Initial radius of the particle sprite.
K Expansion rate float Rate the particle sprite grows during its lifetime.
L Fade to black initial intensity integer If the particle "fades to black" (means it gets destroyed with fading) this value defines its initial intensity. The value is between 0 and 255 where 255 means 100%.
M Fade to black time integer The number of frames between each fade step.
N Fade to black amount integer The amount the initial intensity gets decreased with each step.
O Fade alpha initial intensity integer
P Fade alpha time integer
Q Fade alpha amount integer
R Z rotation initial angle integer Initial angle around the z-axis. The value is between 0 and 1023.
S Z rotation change time integer Number of frames between each rotation step.
T Z rotation angle change amount integer Amount the sprite gets rotated around the z-axis with each step.
U Initial z radius float Initial radius of the particle around the z-axis.
V Z radius change time integer Number of frames between each radius change step.
W Z radius change amount float Amount the radius changes with each step.
X Animation speed integer Time between each animation step. 0 means that the particle is not animated.
Y Animation start frame integer Index first frame of the animated particle.
Z Animation final frame integer Index of the last frame of the animated particle.
AA Rotation speed integer
AB Gravitational acceleration float Acceleration of the particle falling to the ground.
AC Frictional deceleration integer Frictional deceleration of the particle. This value is between 0 and 1 where 1 represents 100%.
AD Default life span integer Default lifetime of the particle in milliseconds.
AE Position random error float Final position gets corrected using a random value between 0 and this one.
AF Velocity random error float Final velocity gets corrected using a random value between 0 and this one.
AG Expansion rate error float Expansion rate gets corrected using a random value between 0 and this one.
AH Rotation rate error integer Rotation rate gets corrected using a random value between 0 and this one.
AI Life span error shape integer Shape for the distribution of the particle's lifetime. Value is between 0 and 255.
AJ Trail length multiplier float If the particle trail flag is set the length of its trail gets multiplied by this value.
AK Stretch X float Amount the particle's texture gets stretched along x-axis.
AL Stretch Y float Amount the particle's texture gets stretched along y-axis.
AM Wind influence float Factor for the influence of wind for the particle.
AK AN Creation range float Maximum distance from the camera for actually creating the particle.
AL AO Flags integer See below

Flags

This section is incomplete. You can help by fixing and expanding it.

There are different flags that influence the particles rendering process. Those flags are listed in the following table:

Name Flag Binary Description
-1 1111 1111 1111 1111 Enables all flags. [1] Never used by default.
ZCHECK_FIRST 1 0000 0000 0000 0001
ZCHECK_STEP 2 0000 0000 0000 0010
DRAW_OPAQUE 4 0000 0000 0000 0100
SCREEN_TRAIL 8 0000 0000 0000 1000
SPEED_TRAIL 16 0000 0000 0001 0000
RAND_VERT_V 32 0000 0000 0010 0000
CYCLE_ANIM 64 0000 0000 0100 0000 Cycles the particles animation.
DRAW_DARK 128 0000 0000 1000 0000
VERT_TRAIL 256 0000 0001 0000 0000
DRAWTOP2D 1024 0000 0100 0000 0000
CLIPOUT2D 2048 0000 1000 0000 0000
ZCHECK_BUMP 4096 0001 0000 0000 0000
ZCHECK_BUMP_FIRST 8192 0010 0000 0000 0000

List of particles

This section is incomplete. You can help by fixing and expanding it.

The following gallery shows ingame screenshots of the particles defined inside the default particle configuration.

See also

References