BIS fnc createSimpleObject: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Text replacement - "\|s1= +" to "|s1= ") |
Lou Montana (talk | contribs) m (Text replacement - "since= Arma3" to "since= arma3") |
||
(19 intermediate revisions by 3 users not shown) | |||
Line 6: | Line 6: | ||
|gr1= Object Manipulation | |gr1= Object Manipulation | ||
|descr= Creates non-simulated framerate and network performance friendly object - a | |descr= Creates non-simulated framerate and network performance friendly object - a [[Arma 3: Simple Objects|Simple Object]] - and applies different adjustments to fake non-existing physX and engine interactions. The adjustments need either to be stored in the object config or provided as the function input, otherwise they need to be done manually.<br> | ||
<br> | <br> | ||
Simple objects cannot be destroyed and do not interact with the environment. They are useful for creating low performance-demanding static compositions (walls, rocks, wrecks, …) and/or environments where shooting and collisions are not expected. | Simple objects cannot be destroyed and do not interact with the environment. They are useful for creating low performance-demanding static compositions (walls, rocks, wrecks, …) and/or environments where shooting and collisions are not expected. | ||
|s1= [input, position, direction, followTerrain, forceSuperSimpleObject] | |s1= [input, position, direction, followTerrain, forceSuperSimpleObject, local] call [[BIS_fnc_createSimpleObject]] | ||
|p1= input: [[String]] or [[Array]]: | |p1= input: [[String]] or [[Array]]: | ||
Line 17: | Line 17: | ||
** class: [[String]] - (Optional, default "") asset CfgVehicles config class ('''at least either ''model'' or ''class'' must be provided, ideally both''') | ** class: [[String]] - (Optional, default "") asset CfgVehicles config class ('''at least either ''model'' or ''class'' must be provided, ideally both''') | ||
** model: [[String]] - (Optional, default "") Path to the vehicle p3d model; needs to start without backslash and must end with the proper file extension ".p3d" | ** model: [[String]] - (Optional, default "") Path to the vehicle p3d model; needs to start without backslash and must end with the proper file extension ".p3d" | ||
** reversed: [[Number]] - (Optional, default 0) some objects, usually vehicles, are | ** reversed: [[Number]] - (Optional, default 0) some objects, usually vehicles, are reversed in p3d; valid values are: | ||
*** | *** 1: reverse | ||
*** 0: no change - any value other than 1 will result in no change | |||
*** -1 | ** verticalOffset: [[Number]] - (Optional, default 0) fix for non-existant physX; usually needed only for vehicles | ||
** verticalOffset: [[ | ** animationAdjustments: [[Array]] - (Optional, default <sqf inline>[]</sqf>) animation that need to be animated to given state, in format [animationName, animationState]: | ||
** animationAdjustments: [[Array]] - (Optional, default []) | |||
*** animationName: [[String]] - animation name | *** animationName: [[String]] - animation name | ||
*** animationState: [[Number]] - animation state | *** animationState: [[Number]] - animation state | ||
** selectionsToHide: [[Array]] - (Optional, default []) all listed selections will be hidden | ** selectionsToHide: [[Array]] - (Optional, default <sqf inline>[]</sqf>) all listed selections will be hidden | ||
|p2= position: [[Position# | |p2= position: [[Array]] format [[Position#PositionASL|PositionASL]] - the object will be placed by the '''model centre'''<nowiki/>'s position (see [[getPosWorld]]) | ||
|p3= direction: [[Number]] - (Optional, default 0) | |p3= direction: [[Number]] - (Optional, default 0) | ||
|p4= followTerrain: [[Boolean]] - (Optional, default true) [[true]] to follow terrain inclination, [[false]] to be horizontally aligned | |p4= followTerrain: [[Boolean]] - (Optional, default [[true]]) [[true]] to follow terrain inclination, [[false]] to be horizontally aligned | ||
|p5= forceSuperSimpleObject: [[Boolean]] - (Optional, default false) [[true]] to create a '''Super Simple Object''' from p3d path (that | |p5= forceSuperSimpleObject: [[Boolean]] - (Optional, default [[false]]) [[true]] to create a '''Super Simple Object''' from p3d path (that '''must''' be provided) | ||
| | |p6= local: [[Boolean]] - (Optional, default [[false]]) [[true]] to create [[local]] instance of the object | ||
|p6since= arma3 2.08 | |||
| | |r1= [[Object]] - the created Simple Object, [[objNull]] if creation failed | ||
| | |x1= <sqf>["B_Boat_Armed_01_minigun_F", getPosWorld player, getDir player] call BIS_fnc_createSimpleObject;</sqf> | ||
|seealso= [[BIS_fnc_adjustSimpleObject]] | |x2= <sqf>["B_Boat_Armed_01_minigun_F", player modelToWorldWorld [0,5,0], getDir player + 90, false, false] call BIS_fnc_createSimpleObject;</sqf> | ||
|seealso= [[Arma 3: Simple Objects]] [[createSimpleObject]] [[BIS_fnc_adjustSimpleObject]] [[BIS_fnc_replaceWithSimpleObject]] [[BIS_fnc_simpleObjectData]] [[getPosWorld]] [[setPosWorld]] | |||
}} | }} |
Latest revision as of 16:26, 9 February 2024
Description
- Description:
- Creates non-simulated framerate and network performance friendly object - a Simple Object - and applies different adjustments to fake non-existing physX and engine interactions. The adjustments need either to be stored in the object config or provided as the function input, otherwise they need to be done manually.
Simple objects cannot be destroyed and do not interact with the environment. They are useful for creating low performance-demanding static compositions (walls, rocks, wrecks, …) and/or environments where shooting and collisions are not expected. - Execution:
- call
- Groups:
- Object Manipulation
Syntax
- Syntax:
- [input, position, direction, followTerrain, forceSuperSimpleObject, local] call BIS_fnc_createSimpleObject
- Parameters:
- input: String or Array:
- String: classname of the object to be created. This is the preferred way if the asset config definition contains the adjustment data or the data are not needed (most objects do not need adjustments).
- Array: adjustment data in format [class, model, reversed, verticalOffset, animationAdjustments, selectionsToHide]:
- class: String - (Optional, default "") asset CfgVehicles config class (at least either model or class must be provided, ideally both)
- model: String - (Optional, default "") Path to the vehicle p3d model; needs to start without backslash and must end with the proper file extension ".p3d"
- reversed: Number - (Optional, default 0) some objects, usually vehicles, are reversed in p3d; valid values are:
- 1: reverse
- 0: no change - any value other than 1 will result in no change
- verticalOffset: Number - (Optional, default 0) fix for non-existant physX; usually needed only for vehicles
- animationAdjustments: Array - (Optional, default []) animation that need to be animated to given state, in format [animationName, animationState]:
- selectionsToHide: Array - (Optional, default []) all listed selections will be hidden
- position: Array format PositionASL - the object will be placed by the model centre's position (see getPosWorld)
- direction: Number - (Optional, default 0)
- followTerrain: Boolean - (Optional, default true) true to follow terrain inclination, false to be horizontally aligned
- forceSuperSimpleObject: Boolean - (Optional, default false) true to create a Super Simple Object from p3d path (that must be provided)
- since 2.08
- local: Boolean - (Optional, default false) true to create local instance of the object
- Return Value:
- Object - the created Simple Object, objNull if creation failed
Examples
- Example 1:
- Example 2:
Additional Information
- See also:
- Arma 3: Simple Objects createSimpleObject BIS_fnc_adjustSimpleObject BIS_fnc_replaceWithSimpleObject BIS_fnc_simpleObjectData getPosWorld setPosWorld
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