setMass: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (typo)
m (Text replacement - ">Posted on March ([0-9]{2})[ a-zA-Z]*, ([0-9]{4})" to ">Posted on $2-03-$1")
 
(56 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 1.02


|1.02|= Game version
|arg= local
____________________________________________________________________________________________


| Changes the mass of an object smoothly during the given time (in seconds). A time of zero (or using the alternative syntax) means an immediate change. |= Description
|eff= global
____________________________________________________________________________________________


| myObject '''setMass''' [mass, time] |= Syntax
|gr1= Object Manipulation


|p1= myObject: [[Object]] |= PARAMETER1
|descr= Changes the mass of a PhysX object. When using the alternative syntax the mass change is gradual during the given time. A time of zero means immediate change.{{Feature | important | When main syntax is used on [[Multiplayer Scripting#Locality|local]] vehicle, the change is global. When alternative syntax is used with time transition on [[Multiplayer Scripting#Locality|local]] vehicle, the gradual mass change doesn't happen on remote clients, only final mass is applied after the given time. If you need gradual change on remote clients too, [[remoteExec | remote execute]] [[setMass]] globally. }}


|p2= [mass, time]: [[Array]] |= PARAMETER2
|s1= myObject [[setMass]] mass


|p3= mass: [[Number]] |= PARAMETER3
|p1= myObject: [[Object]]


|p4= time: [[Number]] |= PARAMETER4
|p2= mass: [[Number]]


| [[Nothing]]|= RETURNVALUE
|r1= [[Nothing]]
____________________________________________________________________________________________


|s2= myObject '''setMass''' mass |=
|s2= myObject [[setMass]] [mass, time]


|p21= myObject: [[Object]] |= PARAMETER21
|p21= myObject: [[Object]]


|p22= mass: [[Number]] |= PARAMETER22
|p22= mass: [[Number]]


|r2= [[Nothing]]|=
|p23= time: [[Number]]


____________________________________________________________________________________________
|r2= [[Nothing]]


|x1= <code>myObject setMass [10,0.5]</code>|= EXAMPLE1
|x1= <sqf>myObject setMass [10, 0.5];</sqf>


|x2= <code>myObject setMass 10</code>|= EXAMPLE2
|x2= <sqf>myObject setMass 10;</sqf>


____________________________________________________________________________________________
|seealso= [[getMass]] [[setCenterOfMass]] [[getCenterOfMass]]
}}
 
<dl class="command_description">
 
<dt></dt>
<dd class="notedate">Posted on 20 Jun, 2014 - 12:50</dd>
<dt class="note">[[User:ffur2007slx2_5|ffur2007slx2_5]]</dt>
<dd class="note">
{{GVI|arma3|1.22}} A quick reference:
{| class="wikitable sortable"


| [[getMass]], [[setCenterOfMass]], [[getCenterOfMass]] |= SEEALSO
! category
! [[setMass]]
! [[setCenterOfMass]]


| |= MPBEHAVIOUR
|-
____________________________________________________________________________________________
| unit
}}
| The larger the mass is, the easier a unit will physically fatigued
| N/A
 
|-
| aircraft
| The larger the mass is, the more sensitive an aircraft will react to joystick, vice versa (Except when AFM is enabled).
| Aircraft slant due to center change accordingly, and the position of the camera view will be altered relatively at the same time. (3rd person view)
 
|-
| vehicle
| The larger the mass is, the slower a vehicle drives (Ships will sink), vice versa. (Land vehicle performs like a bouncing ball while ships accelerated pretty speedy.)
| Vehicle slant due to center change accordingly.


<h3 style='display:none'>Notes</h3>
|}
<dl class='command_description'>
<dt></dt>
<!-- Note Section BEGIN -->
<dd class="notedate">Posted on 2015-03-26 - 15:02 (UTC)</dd>
<dt class="note">[[User:N3croo|N3croo]]</dt>
<dd class="note">
If you intend to use setMass in conjunction with ropeCreate in MP i highly recommend to first ropeCreate then setMass (on clientside).
RopeCreate in MP will set the mass of the attached object to the server value upon execution.
</dd>


<!-- Note Section END -->
</dl>
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 23:06, 13 May 2023

Hover & click on the images for description

Description

Description:
Changes the mass of a PhysX object. When using the alternative syntax the mass change is gradual during the given time. A time of zero means immediate change.
When main syntax is used on local vehicle, the change is global. When alternative syntax is used with time transition on local vehicle, the gradual mass change doesn't happen on remote clients, only final mass is applied after the given time. If you need gradual change on remote clients too, remote execute setMass globally.
Groups:
Object Manipulation

Syntax

Syntax:
myObject setMass mass
Parameters:
myObject: Object
mass: Number
Return Value:
Nothing

Alternative Syntax

Syntax:
myObject setMass [mass, time]
Parameters:
myObject: Object
mass: Number
time: Number
Return Value:
Nothing

Examples

Example 1:
myObject setMass [10, 0.5];
Example 2:
myObject setMass 10;

Additional Information

See also:
getMass setCenterOfMass getCenterOfMass

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
Posted on 20 Jun, 2014 - 12:50
ffur2007slx2_5
Arma 3 logo black.png1.22 A quick reference:
category setMass setCenterOfMass
unit The larger the mass is, the easier a unit will physically fatigued N/A
aircraft The larger the mass is, the more sensitive an aircraft will react to joystick, vice versa (Except when AFM is enabled). Aircraft slant due to center change accordingly, and the position of the camera view will be altered relatively at the same time. (3rd person view)
vehicle The larger the mass is, the slower a vehicle drives (Ships will sink), vice versa. (Land vehicle performs like a bouncing ball while ships accelerated pretty speedy.) Vehicle slant due to center change accordingly.
Posted on 2015-03-26 - 15:02 (UTC)
N3croo
If you intend to use setMass in conjunction with ropeCreate in MP i highly recommend to first ropeCreate then setMass (on clientside). RopeCreate in MP will set the mass of the attached object to the server value upon execution.