vectorLinearConversion: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "|gr1= Vectors|GROUP1=" to "|gr2= Math - Vectors |GROUP2=")
m (updated data type for parsing)
 
(26 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game=
|game1= arma3
|version1= 1.92


|1.92|Game Version =
|gr2= Math - Vectors


|arg=  |Multiplayer Arguments =
|descr= Interpolates vector between the given ''vectorFrom'' and ''vectorTo'' value according to the given range value.


|eff=  |Multiplayer Effects =
|s1= [[vectorLinearConversion]] [rangeFrom, rangeTo, rangeValue, vectorFrom, vectorTo, clip]


|gr2= Math - Vectors |GROUP2=
|p1= rangeFrom: [[Number]] - start "from" range


|serverExec= |Multiplayer Execution ("server" or empty)=
|p2= rangeTo: [[Number]] - end "to" range
____________________________________________________________________________________________


| Interpolates vector between the given "vectorFrom" and "vectorTo" value according to the given range value|Description=
|p3= rangeValue: [[Number]] - variable range value
____________________________________________________________________________________________


| [[vectorLinearConversion]] [rangeFrom, rangeTo, rangeValue, vectorFrom, vectorTo, clip] |Syntax=
|p4= vectorFrom: [[Vector3D]] - start "from" vector


|p1=[rangeFrom, rangeTo, rangeValue, vectorFrom, vectorTo, clip]: [[Array]]
|p5= vectorTo: [[Vector3D]] - end "to" vector


|p2=rangeFrom: [[Number]] - start "from" range
|p6= clip: [[Boolean]] - (Optional, default [[false]]) if [[true]], range value will be clipped to stay within "from" - "to" range


|p3=rangeTo: [[Number]] - end "to" range
|r1= [[Vector3D]] - interpolated vector


|p4=rangeValue: [[Number]] - variable range value
|x1= <sqf>vectorLinearConversion [0, 1, 0.5, [0,0,0], [25,50,100], false]; // [12.5,25,50]</sqf>


|p5=vectorFrom: [[Array]] - start "from" vector
|x2= <sqf>vectorLinearConversion [0, 1, 100, [0,0,0], [25,50,100], true]; // [25,50,100]</sqf>


|p6=vectorTo: [[Array]] - end "to" vector
|x3= <sqf>vectorLinearConversion [0, 1, 100, [0,0,0], [25,50,100], false]; // [2500,5000,10000]</sqf>


|p7=clip (Optional): [[Boolean]] - if [[true]], range value will be clipped to stay within "from" - "to" range. Default: [[false]]
|seealso= [[linearConversion]] [[bezierInterpolation]] [[matrixMultiply]] [[matrixTranspose]]
 
| [[Array]] - interpolated vector |Return Value=
____________________________________________________________________________________________
 
|x1= <code>[[vectorLinearConversion]] [0,1,0.5,[0,0,0],[25,50,100],[[false]]]; // [12.5,25,50]</code> |Example 1=
|x2= <code>[[vectorLinearConversion]] [0,1,100,[0,0,0],[25,50,100],[[true]]]; // [25,50,100]</code> |Example 2=
|x3= <code>[[vectorLinearConversion]] [0,1,100,[0,0,0],[25,50,100],[[false]]]; // [2500,5000,10000]</code> |Example 3=
____________________________________________________________________________________________
 
| [[linearConversion]], [[bezierInterpolation]], [[matrixMultiply]], [[matrixTranspose]] |See Also=
}}
}}
<dl class="command_description">
<!-- BEGIN Note Section -->
<!-- For example:
<dd class="notedate">Posted on Month Day, Year - Time (UTC)</dd>
<dt class="note">[[User:User Name|User Name]]</dt>
<dd class="note">This is an example note. It is true and verifiable, and contains a little code snippet.
<code>[[if]] ([[_this]] == anExample) [[then]] { [[hint]] "Leave it here for others to read"; };</code></dd>
-->
<!-- END Note Section -->
</dl>
<h3 style="display:none">Bottom Section</h3>
<!-- Appropriate categories go here -->
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 18:41, 5 January 2026

Arma 3 logo black.png 1.92
Hover & click on the images for description

Description

Description:
Interpolates vector between the given vectorFrom and vectorTo value according to the given range value.
Groups:
Math - Vectors

Syntax

Syntax:
vectorLinearConversion [rangeFrom, rangeTo, rangeValue, vectorFrom, vectorTo, clip]
Parameters:
rangeFrom: Number - start "from" range
rangeTo: Number - end "to" range
rangeValue: Number - variable range value
vectorFrom: Vector3D - start "from" vector
vectorTo: Vector3D - end "to" vector
clip: Boolean - (Optional, default false) if true, range value will be clipped to stay within "from" - "to" range
Return Value:
Vector3D - interpolated vector

Examples

Example 1:
vectorLinearConversion [0, 1, 0.5, [0,0,0], [25,50,100], false]; // [12.5,25,50]
Example 2:
vectorLinearConversion [0, 1, 100, [0,0,0], [25,50,100], true]; // [25,50,100]
Example 3:
vectorLinearConversion [0, 1, 100, [0,0,0], [25,50,100], false]; // [2500,5000,10000]

Additional Information

See also:
linearConversion bezierInterpolation matrixMultiply matrixTranspose

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord.
Only post proven facts here! Add Note
Retrieved from "https://community.bistudio.com/wiki?title=vectorLinearConversion&oldid=377894"