BIS fnc sceneSetObjects: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " +" to " ")
m (Text replacement - "\|seealso= ([^ ]+)(\]\]|\}\}), *(\[\[|\{\{)" to "|seealso= $1$2 $3")
 
(9 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=function
{{RV|type=function


| arma2
|game1= arma2
|1.00
|version1= 1.00


|game2= arma2oa
|game2= arma2oa
Line 17: Line 17:
|gr2= Scenes
|gr2= Scenes


| This function sets objects positions and direction relative to the chosen object.
|descr= This function sets objects positions and direction relative to the chosen object.
{{Feature|Warning|Same as its [[BIS_fnc_sceneGetObjects|GET]] counterpart (at least in {{arma3}}), this function doesn't work as intended as it doesn't set objects direction properly. All objects will be created with a zero azimuth.}}
{{Feature|warning|Same as its [[BIS_fnc_sceneGetObjects|GET]] counterpart (at least in {{arma3}}), this function does not work as intended as it does not set objects' direction properly. All objects will be created with a zero azimuth.}}


| [centre, objectsArray, applyOffset, stopped] call [[BIS_fnc_sceneSetObjects]]
|s1= [centre, objectsArray, applyOffset, stopped] call [[BIS_fnc_sceneSetObjects]]


|p1= centre: [[Object]] or [[String]] - object or marker name - '''NOT''' a [[Position]]
|p1= centre: [[Object]] or [[String]] - object or marker name - '''NOT''' a [[Position]]


|p2= objectsArray: [[Array]] - See [[BIS_fnc_sceneGetObjects]] for format information
|p2= objectsArray: [[Array]] - see [[BIS_fnc_sceneGetObjects]] for format information


|p3= applyOffset: [[Boolean]] - [[true]] to apply height offset
|p3= applyOffset: [[Boolean]] - [[true]] to apply height offset


|p4= stopped: [[Anything]] - if provided and if BIS_debugModules is defined, units will be [[stop|stopped]]
|p4= stopped: [[Anything]] - if provided and if {{hl|BIS_debugModules}} is defined, units will be [[stop|stopped]]


|r1= [[Boolean]]
|r1= [[Boolean]]


|x1= <code>[player, ''_arrayOfObjects'', false] [[call]] [[BIS_fnc_sceneSetObjects]];</code>
|x1= <sqf>[player, _arrayOfObjects, false] call BIS_fnc_sceneSetObjects;</sqf>


|seealso= [[BIS_fnc_sceneGetObjects]], [[BIS_fnc_objectsGrabber]], [[BIS_fnc_objectsMapper]]
|seealso= [[BIS_fnc_sceneGetObjects]] [[BIS_fnc_objectsGrabber]] [[BIS_fnc_objectsMapper]]
}}
}}
[[Category:{{Name|arma2}}: Functions|{{uc:sceneSetObjects}}]]
[[Category:{{Name|arma2oa}}: Functions|{{uc:sceneSetObjects}}]]
[[Category:{{Name|tkoh}}: Functions|{{uc:sceneSetObjects}}]]
[[Category:{{Name|arma3}}: Functions|{{uc:sceneSetObjects}}]]

Latest revision as of 13:00, 1 July 2022

Hover & click on the images for description

Description

Description:
This function sets objects positions and direction relative to the chosen object.
Same as its GET counterpart (at least in Arma 3), this function does not work as intended as it does not set objects' direction properly. All objects will be created with a zero azimuth.
Execution:
call
Groups:
Broken FunctionsScenes

Syntax

Syntax:
[centre, objectsArray, applyOffset, stopped] call BIS_fnc_sceneSetObjects
Parameters:
centre: Object or String - object or marker name - NOT a Position
objectsArray: Array - see BIS_fnc_sceneGetObjects for format information
applyOffset: Boolean - true to apply height offset
stopped: Anything - if provided and if BIS_debugModules is defined, units will be stopped
Return Value:
Boolean

Examples

Example 1:
[player, _arrayOfObjects, false] call BIS_fnc_sceneSetObjects;

Additional Information

See also:
BIS_fnc_sceneGetObjects BIS_fnc_objectsGrabber BIS_fnc_objectsMapper

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