drop: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (moved to template. requires cleaning up.)
(Return value since 2.18)
 
(68 intermediate revisions by 14 users not shown)
Line 1: Line 1:
{{errors}}
{{RV|type=command
[[Category:Scripting Commands|DROP]]
[[Category:Scripting Commands OFP 1.96|DROP]]
[[Category:Scripting Commands ArmA|DROP]]


{{Command|= Comments
|game1= ofp
____________________________________________________________________________________________
|version1= 1.75


| ofpr |= Game name
|game2= ofpe
|version2= 1.00


|1.5|= Game version
|game3= arma1
|version3= 1.00


|eff= local |= Effects in MP
|game4= arma2
____________________________________________________________________________________________
|version4= 1.00


| Creates a particle effect. This command is used to create smoke, fire and similar effects. The particles are single polygons with single textures that always face the player. They can be set to dynamically change their position, size, direction, can be set to different weights and more or less dependant to the wind. |= Description
|game5= arma2oa
____________________________________________________________________________________________
|version5= 1.50


| '''drop''' effect |= Syntax
|game6= tkoh
|version6= 1.00


|p1= effect: [[Array]] - particle array (described below) |= Parameter 1
|game7= arma3
|version7= 0.50


|eff= local


| [[Nothing]] |= Return value
|arg= global
____________________________________________________________________________________________
 
|x1= <pre>Code</pre> |= Example 1
____________________________________________________________________________________________


| |= See also
|gr1= Particles


}}
|descr= Creates a particle effect.
This command is used to create smoke, fire and similar effects.
The particles are single polygons with single textures that always face the player.
They can be set to dynamically change their position, size, direction, can be set to different weights and to be more or less dependent on the wind.


<h3 style="display:none">Notes</h3>
|s1= [[drop]] parameters
<dl class="command_description">
<!-- Note Section BEGIN -->


'''Global parameters:''' '''Physical parameters:''' '''Render parameters:'''
|p1= parameters: [[Array]] format [[ParticleArray]]


Note that all these values are set as arrays to show their development in time. F.I. if you set the array [1,2] as a size then at the beginning the size of the particle will be 1 and at the end of the life time of the particle it's size will be 2. The rest od the values during the life time will be lineary interpolated. '''Random parameters:'''
|r1= [[Nothing]], since {{GVI|arma3|2.18}} [[Object]]


|p2= : [[]] |= Parameter 2
|x1= <sqf>
drop ["cl_basic", "", "Billboard", 1, 1,
[-3.5 * (sin (direction xural)), -3.5 * (cos (direction xural)), 0],
[random 0.1, random 0.1, random 0.5],
1, 0.005, 0.0042, 0.7, [0.3,3],
[[0.5,0.5,0.5,0], [0.7,0.7,0.7,0.5], [0.9,0.9,0.9,0]],
[0,1,0,1,0,1],
0.2, 0.2, "", "", xural];
</sqf>


|p3= : [[]] |= Parameter 3
|seealso= [[ParticleArray]] [[setParticleCircle]] [[setParticleParams]] [[setParticleRandom]] [[ParticleTemplates]] [[setParticleClass]] [[particlesQuality]] [[setParticleFire]]
 
}}
|p4= ShapeName: [[String]] - Name of the shape associated with the particle. |= Parameter 4
 
|p5= AnimationName: [[String]] - Name of the animation of the shape. |= Parameter 5
 
|p6= Type: [[String]] - Type of the particle (either "Billboard" or "SpaceObject"). |= Parameter 6
 
|p7= TimerPeriod: [[Number]] - The period of calling the "OnTimer" event (seconds). |= Parameter 7
 
|p8= LifeTime: [[Number]] - Life time of the particle (seconds). |= Parameter 8
 
|p9= Position: [[Position]] - Either a position or the name of a selection. In the latter case the Object property must be set, the selection has to exist in the Memory LOD of the model given in the Object property. |= Parameter 9
 
|p10= MoveVelocity: [[Vector]] - 3D vector which describes the velocity vector of the particle (direction and speed in m/s). |= Parameter 10
 
|p11= RotationVelocity: [[Number]] - Float number which determines number of rotations in one second. |= Parameter 11
 
|p12= Weight: [[Number]] - Weight of the particle (kg). |= Parameter 12
 
|p13= Volume: [[Number]] - Volume of the particle (m³). |= Parameter 13
 
|p14= Rubbing: [[Number]] - Float number without dimension which determines the impact of the density od the enviroment on this particle. 0 - no impact (vacuum). |= Parameter 14
 
|p15= Size: [[Type Array]] - array with elements of type [[Number]]. Size of the particle in time to render (meters). |= Parameter 15
 
|p16= Color: [[Type Array]] - array with elements of type [[]][[Color Array]]. Color of the particle in time to render. |= Parameter 16
 
|p17= AnimationPhase: [[Type Array]] - array with elements of type [[]][[Number]]. Phase of the animation in time. |= Parameter 17
 
|p18= RandomDirectionPeriod: [[Number]] - Period of changing the velocity vector (seconds). |= Parameter 18
 
|p19= RandomDirectionIntensity: [[Number]] - Each MoveVelocity component will be changed with random value from interval <0, RandomDirectionIntensity >. |= Parameter 19
 
|p20= OnTimer: [[String]] - Name of the script to run every period determined by TimerPeriod property. Position of the particle is stored in the "_this" variable. |= Parameter 20
 
|p21= BeforeDestroy: [[String]] - Name of the script to run right before destroying the particle. Position of the particle is stored in the "_this" variable. |= Parameter 21
 
|p22= Object: [[Object]] - Object to bind this particle to. If you don't want to set the particle to a specific vehicle, use objNull. |= Parameter 22
 
Particle systems created by drop are client-side ([[local]]) effects, that means they are affected by [[multiplayer locality]]. If a mission is designed for play on a dedicated server, you should consider excluding drop commands from the host for efficiency. Through thoughtful use of MP 'spoofing', drop works just as well as [[camCreate]]. This means you have the 'real' bullets and bombs generated on the server, while having the clients duplicate the script at the same time, only this time using harmless versions of the lethal stuff created on the server.
<!-- Note Section END -->
</dl>
 
<h3 style="display:none">Bottom Section</h3>

Latest revision as of 14:43, 3 October 2024

Hover & click on the images for description

Description

Description:
Creates a particle effect. This command is used to create smoke, fire and similar effects. The particles are single polygons with single textures that always face the player. They can be set to dynamically change their position, size, direction, can be set to different weights and to be more or less dependent on the wind.
Groups:
Particles

Syntax

Syntax:
drop parameters
Parameters:
parameters: Array format ParticleArray
Return Value:
Nothing, since Arma 3 logo black.png2.18 Object

Examples

Example 1:
drop ["cl_basic", "", "Billboard", 1, 1, [-3.5 * (sin (direction xural)), -3.5 * (cos (direction xural)), 0], [random 0.1, random 0.1, random 0.5], 1, 0.005, 0.0042, 0.7, [0.3,3], [[0.5,0.5,0.5,0], [0.7,0.7,0.7,0.5], [0.9,0.9,0.9,0]], [0,1,0,1,0,1], 0.2, 0.2, "", "", xural];

Additional Information

See also:
ParticleArray setParticleCircle setParticleParams setParticleRandom ParticleTemplates setParticleClass particlesQuality setParticleFire

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note