Difference between revisions of "039D"

From GTAMods Wiki
Jump to navigation Jump to search
(colors work!)
m
Line 9: Line 9:
 
|}
 
|}
 
</div></div>
 
</div></div>
−
{{Icon|3}} {{Icon|VC}} '''ADD_<wbr>MOVING_<wbr>PARTICLE_<wbr>EFFECT'''
+
{{OpCode
−
<hr />
+
| games      = {{Icon|3}} {{Icon|VC}}
−
'''Description'''
+
| command    = ADD_<wbr>MOVING_<wbr>PARTICLE_<wbr>EFFECT
−
: Adds a moving particle effect
+
| description = Adds a moving particle effect
−
'''Syntax'''
+
| syntax1    = 039D: scatter_particles [''int1''] [''flt1''] [''int2''] [''int3''] [''int4''] [''int5''] at [''flt2''] [''flt3''] [''flt4''] [''flt5''] [''flt6''] [''flt7'']
−
: 039D: scatter_particles [''int1''] [''flt1''] [''int2''] [''int3''] [''int4''] [''int5''] at [''flt2''] [''flt3''] [''flt4''] [''flt5''] [''flt6''] [''flt7'']
+
| p1t        = [''int1'']
−
'''Parameter'''
+
| p1d        = Particle effect (see below)
−
: [''int1'']
+
| p2t        = [''flt1'']
−
:: Particle effect ID (see below)
+
| p2d        = Scale
−
: [''flt1'']
+
| p3t        = [''int2'']
−
:: Scale
+
| p3d        = Red, between 0 and 255
−
: [''int2'']
+
| p4t        = [''int3'']
−
:: Red
+
| p4d        = Green, between 0 and 255
−
: [''int3'']
+
| p5t        = [''int4'']
−
:: Green
+
| p5d        = Blue, between 0 and 255
−
: [''int4'']
+
| p6t        = [''int5'']
−
:: Blue
+
| p6d        = Duration in milliseconds
−
: [''int5'']
+
| p7t        = [''flt2'']
−
:: Duration in milliseconds
+
| p7d        = X-coordinate
−
: [''flt2'']
+
| p8t        = [''flt3'']
−
:: X-coordinate
+
| p8d        = Y-coordinate
−
: [''flt3'']
+
| p9t        = [''flt4'']
−
:: Y-coordinate
+
| p9d        = Z-coordinate
−
: [''flt4'']
+
| p10t        = [''flt5'']
−
:: Z-coordinate
+
| p10d        = X-strength
−
: [''flt5'']
+
| p11t        = [''flt6'']
−
:: X-strength
+
| p11d        = Y-strength
−
: [''flt6'']
+
| p12t        = [''flt7'']
−
:: Y-strength
+
| p12d        = Z-strength
−
: [''flt7'']
+
}}
−
:: Z-strength
 
  
 
This opcode adds a moving particle effects at the specified location for a duration of time. Particle effects must be in range of the player (about 95 units) when adding them into the world; they will not appear when added outside the range. Particle effects that have been added will disappear when the player moves out of range regardless of duration.
 
This opcode adds a moving particle effects at the specified location for a duration of time. Particle effects must be in range of the player (about 95 units) when adding them into the world; they will not appear when added outside the range. Particle effects that have been added will disappear when the player moves out of range regardless of duration.
  
−
Using a particle ID outside the range listed below produces unpredictable results and may crash the game. The colors red, green, and blue only affect particle 14 in GTA III and particle 16 in Vice City and has no effect on anything else. Some particles do not obey the duration and are noted below. If the duration is set to 0, particles that obey duration will loop forever; using opcode [[03AE]] or moving outside the range of the particle can remove a particle effect stuck in a loop. The strength represents the direction and length of movement of the particle. Some particles look meaningless or weird absence of the strength. Ones that are affected by gravity can be seen arcing towards the ground if an X or Y strength is set. Some particles do not obey the strength and are noted below. Particle effects created with this opcode is saved in [[Saves (GTA 3)#Block 14: Particles|block 14 of the save file]] in GTA III and [[Saves (GTA VC)#Block 15: Particles|block 15]] in Vice City.
+
Using a particle effect outside the range listed below produces unpredictable results and may crash the game. The colors red, green, and blue only affect particle 14 in GTA III and particle 16 in Vice City and has no effect on anything else. Some particles do not obey the duration and are noted below. If the duration is set to 0, particles that obey duration will loop forever; using opcode [[03AE]] or moving outside the range of the particle can remove a particle effect stuck in a loop. The strength represents the direction and length of movement of the particle. Some particles look meaningless or weird absence of the strength. Ones that are affected by gravity can be seen arcing towards the ground if an x- or y-strength is set. Some particles do not obey the strength and are noted below. Particle effects created with this opcode is saved in [[Saves (GTA 3)#Block 14: Particles|block 14 of the save file]] in GTA III and [[Saves (GTA VC)#Block 15: Particles|block 15]] in Vice City.
  
 
The [[Main.scm|original script]] in GTA III uses particles 10, 11, 12, 13, 15, 18, and 19; and in Vice City uses 4 and 17.
 
The [[Main.scm|original script]] in GTA III uses particles 10, 11, 12, 13, 15, 18, and 19; and in Vice City uses 4 and 17.
Line 51: Line 50:
 
=== GTA III ===
 
=== GTA III ===
 
{|class="wikitable"
 
{|class="wikitable"
−
!ID ||Image ||Enum ||Obey<br>duration? ||Obey<br>strength? ||Notes
+
!Particle<br>effect ||Image ||Enum ||Obey<br>duration? ||Obey<br>strength? ||Notes
 
|-
 
|-
 
|{{a|c}} |0 ||[[File:III 039D-0.jpg|150px]] ||POBJECT_<wbr>PAVEMENT_<wbr>STEAM ||{{a|c}} |&#x2713; ||{{a|c}} |&#x2713; ||thin white smoke
 
|{{a|c}} |0 ||[[File:III 039D-0.jpg|150px]] ||POBJECT_<wbr>PAVEMENT_<wbr>STEAM ||{{a|c}} |&#x2713; ||{{a|c}} |&#x2713; ||thin white smoke
Line 96: Line 95:
 
=== Vice City ===
 
=== Vice City ===
 
{|class="wikitable"
 
{|class="wikitable"
−
!ID ||Image ||[[SCM language III/VC definitions#POBJECT|Enum]] ||Obey<br>duration? ||Obey<br>strength? ||Notes
+
!Particle<br>effect ||Image ||[[SCM language III/VC definitions#POBJECT|Enum]] ||Obey<br>duration? ||Obey<br>strength? ||Notes
 
|-
 
|-
 
|{{a|c}} |0 ||[[File:VC 039D-0.jpg|150px]] ||POBJECT_<wbr>PAVEMENT_<wbr>STEAM ||{{a|c}} |&#x2713; ||{{a|c}} |&#x2713; ||thin white smoke
 
|{{a|c}} |0 ||[[File:VC 039D-0.jpg|150px]] ||POBJECT_<wbr>PAVEMENT_<wbr>STEAM ||{{a|c}} |&#x2713; ||{{a|c}} |&#x2713; ||thin white smoke
Line 143: Line 142:
  
 
== See also ==
 
== See also ==
−
* [[02A2]], another particle effects opcode in GTA III
+
* {{Icon|3}} [[02A2]], adds a particle effect
−
 
 
−
[[Category:OpCodes]]
 

Revision as of 05:41, 13 February 2016

VC 039D-17 x0.5.jpg VC 039D-17 z0.5.jpg
Particle effect 17 of size 1.0 with an X-strength of 0.5.
Particle effect 17 of size 1.0 with an Z-strength of 0.5.

GTA III Vice City ADD_MOVING_PARTICLE_EFFECT

Description
Adds a moving particle effect
Syntax
039D: scatter_particles [int1] [flt1] [int2] [int3] [int4] [int5] at [flt2] [flt3] [flt4] [flt5] [flt6] [flt7]
Parameter
[int1]
Particle effect (see below)
[flt1]
Scale
[int2]
Red, between 0 and 255
[int3]
Green, between 0 and 255
[int4]
Blue, between 0 and 255
[int5]
Duration in milliseconds
[flt2]
X-coordinate
[flt3]
Y-coordinate
[flt4]
Z-coordinate
[flt5]
X-strength
[flt6]
Y-strength
[flt7]
Z-strength

This opcode adds a moving particle effects at the specified location for a duration of time. Particle effects must be in range of the player (about 95 units) when adding them into the world; they will not appear when added outside the range. Particle effects that have been added will disappear when the player moves out of range regardless of duration.

Using a particle effect outside the range listed below produces unpredictable results and may crash the game. The colors red, green, and blue only affect particle 14 in GTA III and particle 16 in Vice City and has no effect on anything else. Some particles do not obey the duration and are noted below. If the duration is set to 0, particles that obey duration will loop forever; using opcode 03AE or moving outside the range of the particle can remove a particle effect stuck in a loop. The strength represents the direction and length of movement of the particle. Some particles look meaningless or weird absence of the strength. Ones that are affected by gravity can be seen arcing towards the ground if an x- or y-strength is set. Some particles do not obey the strength and are noted below. Particle effects created with this opcode is saved in block 14 of the save file in GTA III and block 15 in Vice City.

The original script in GTA III uses particles 10, 11, 12, 13, 15, 18, and 19; and in Vice City uses 4 and 17.

List of particle effects

All images below are taken with a size of 1.0 and a strength of 0.0.

GTA III

Particle
effect		 Image Enum Obey
duration?		 Obey
strength?		 Notes
0 III 039D-0.jpg POBJECT_PAVEMENT_STEAM ✓ ✓ thin white smoke
1 III 039D-1.jpg POBJECT_PAVEMENT_STEAM_SLOWMOTION ✓ ✓ thick white smoke
2 III 039D-2.jpg POBJECT_WALL_STEAM ✓ ✓ thin white smoke
3 III 039D-3.jpg POBJECT_WALL_STEAM_SLOWMOTION ✓ ✓ thick white smoke
4 III 039D-4.jpg POBJECT_DARK_SMOKE ✓ ✓ black smoke
5 III 039D-5.jpg POBJECT_FIRE_HYDRANT ✗ ✗ fire hydrant water
6 III 039D-6.jpg POBJECT_CAR_WATER_SPLASH ✓ ✓ large water splash
7 III 039D-7.jpg POBJECT_PED_WATER_SPLASH ✓ ✓ medium water splash
8 III 039D-8.jpg POBJECT_SPLASHES_AROUND ✓ ✗ a square of raindrops on the ground; if scale is 1.0, size of square is 1x1 units
9 III 039D-9.jpg POBJECT_SMALL_FIRE ✓ ✗
10 III 039D-10.jpg POBJECT_BIG_FIRE ✓ ✗
11 III 039D-11.jpg POBJECT_DRY_ICE ✓ ✗
12 III 039D-12.jpg POBJECT_DRY_ICE_SLOWMOTION ✓ ✗
13 III 039D-13.jpg POBJECT_FIRE_TRAIL ✓ ✓
14 III 039D-14.jpg POBJECT_SMOKE_TRAIL ✓ ✓ the only particle effect that colors can be applied
15 III 039D-15.jpg POBJECT_FIREBALL_AND_SMOKE ✓ ✓ initial explosion then smokes
16 III 039D-16.jpg POBJECT_ROCKET_TRAIL ✗ ✓ initial explosion then smokes; setting duration to 0 can bug out all particles in the game, making random particles produce this smoke
17 III 039D-17.jpg POBJECT_EXPLOSION_ONCE ✗ ✓ single brief explosion
18 III 039D-18.jpg POBJECT_CATALINAS_GUNFLASH ✗ ✓ gun flash; strength only affects direction of flash
19 III 039D-19.jpg POBJECT_CATALINAS_SHOTGUNFLASH ✗ ✓ shotgun flash; strength only affects direction of flash

Vice City

Particle
effect		 Image Enum Obey
duration?		 Obey
strength?		 Notes
0 VC 039D-0.jpg POBJECT_PAVEMENT_STEAM ✓ ✓ thin white smoke
1 VC 039D-1.jpg POBJECT_PAVEMENT_STEAM_SLOWMOTION ✓ ✓ thick white smoke
2 VC 039D-2.jpg POBJECT_WALL_STEAM ✓ ✓ thin white smoke
3 VC 039D-3.jpg POBJECT_WALL_STEAM_SLOWMOTION ✓ ✓ thick white smoke
4 VC 039D-4.jpg POBJECT_DARK_SMOKE ✓ ✓ black smoke
5 VC 039D-5.jpg POBJECT_FIRE_HYDRANT ✗ ✗ fire hydrant water
6 VC 039D-6.jpg POBJECT_CAR_WATER_SPLASH ✓ ✓ large water splash
7 VC 039D-7.jpg POBJECT_PED_WATER_SPLASH ✓ ✓ medium water splash
8 VC 039D-8.jpg POBJECT_SPLASHES_AROUND ✓ ✗ a square of raindrops on the ground; if scale is 1.0, size of square is 1x1 units
9 VC 039D-9.jpg POBJECT_SMALL_FIRE ✓ ✗
10 VC 039D-10.jpg POBJECT_BIG_FIRE ✓ ✗
11 VC 039D-11.jpg POBJECT_DRY_ICE ✓ ✗
12 VC 039D-12.jpg POBJECT_DRY_ICE_SLOWMOTION ✓ ✗
13 VC 039D-13.jpg POBJECT_WATER_FOUNTAIN_VERT ✓ ✗ vertical fountain water
14 VC 039D-14.jpg POBJECT_WATER_FOUNTAIN_HORIZ ✓ ✓ horizontal fountain water
15 VC 039D-15.jpg POBJECT_FIRE_TRAIL ✓ ✓
16 VC 039D-16.jpg POBJECT_SMOKE_TRAIL ✓ ✓ the only particle effect that colors can be applied
17 VC 039D-17.jpg POBJECT_FIREBALL_AND_SMOKE ✓ ✓ initial explosion then smokes
18 VC 039D-18.jpg POBJECT_ROCKET_TRAIL ✗ ✓ initial explosion then smokes; setting duration to 0 can bug out all particles in the game, making random particles produce this smoke
19 VC 039D-19.jpg POBJECT_EXPLOSION_ONCE ✗ ✓ single brief explosion

Keywords

scatter, add, moving, particle, object, effect

See also

  • GTA III 02A2, adds a particle effect
Retrieved from "https://gtamods.com/mediawiki/index.php?title=039D&oldid=15480"