BIS fnc simpleObjectData: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\|seealso= ([^ ]+)(\]\]|\}\}), *(\[\[|\{\{)" to "|seealso= $1$2 $3")
m (Add return value details)
Line 21: Line 21:
* reversed: [[Number]] - (Default 0) reverse value, to fix orientation. 0: no change, 1: reverse
* reversed: [[Number]] - (Default 0) reverse value, to fix orientation. 0: no change, 1: reverse
* verticalOffset: [[Array]] - (Default 0) vertical offset
* verticalOffset: [[Array]] - (Default 0) vertical offset
* animationAdjustments: [[Array]] - (Default []) animation to animate, every element has this format: [_animationName:string,_animationState:scalar]
* animationAdjustments: [[Array]] - (Default []) animation to animate, every element has this format: [_animationName:string, _animationState:scalar]
* hiddenSelections: [[Array]] - (Default []) all listed selection will be hidden
* hiddenSelections: [[Array]] - (Default []) all listed selection will be hidden
* verticalOffsetWorld: [[Number]] - vertical offset in World coordinates; similar to [[ASL]] but refers to object at [0,0,0], not its land contacts
* verticalOffsetWorld: [[Number]] - vertical offset in World coordinates; similar to [[ASL]] but refers to object at [0, 0, 0], not its land contacts
* textures: [[Array]] - textures currently applied to the object
* textures: [[Array]] - textures currently applied to the object
* randomizeAnims: [[Boolean]] - (Default false) true if vehicle supports randomization through animations
* randomizeAnims: [[Boolean]] - (Default false) true if vehicle supports randomization through animations
* randomizeTexs: [[Boolean]] - (Default false) true if vehicle supports randomization of textures
* randomizeTexs: [[Boolean]] - (Default false) true if vehicle supports randomization of textures


{{Feature | Informative | Return values can be used with [[BIS_fnc_adjustSimpleObject]].}}
{{Feature|informative|Return values can directly be used with [[BIS_fnc_adjustSimpleObject]].}}


|x1= <sqf>["B_Boat_Armed_01_minigun_F"] call BIS_fnc_simpleObjectData;</sqf>
|x1= <sqf>
["B_Boat_Armed_01_minigun_F"] call BIS_fnc_simpleObjectData;
/*
[
"B_Boat_Armed_01_minigun_F",
"A3\Boat_F\Boat_Armed_01\Boat_Armed_01_minigun_F.p3d",
1,
3.323,
[
["damagehide", 0],
["turret_shake", 0],
["turret_shake_aside", 0],
["magazine_hide", 0],
["mainturret", 0],
["damagehideotocvez", 0],
["maingun", 0.09],
["damagehideotochlaven", 0],
["rearturret", -3.16],
["reargun", 0.09],
["muzzleflash", 0],
["zaslehrot", 79],
["zasleh2rot", 600],
["fuel", 1],
["mph", 0],
["rpm", 0],
["amps_random", 0],
["oil_random", 0],
["trim_random", 0],
["tmp_random", 0],
["volt_random", 0],
["drivingwheel", 0],
["ammobelt_hide", 0],
["bullet001_2_hide", 0.33],
["bullet002_2_hide", 0.33],
["bullet003_2_hide", 0.33],
["bullet004_2_hide", 0.33],
["bullet005_2_hide", 0.33],
["bullet006_2_hide", 0.33],
["positionlights", 0],
["gun_revolving", 0.33],
["muzzleflash2", 0],
["reargunner", 0.09]
],
["zasleh", "p svetlo", "zadni svetlo", "brzdove svetlo", "clan", "podsvit pristroju", "poskozeni"],
-0.148,
[
"\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_ext_co.paa",
"\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_int_co.paa",
"\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_crows_blufor_co.paa"
],
false,
false
]
*/
</sqf>


|x2= <sqf>[BIS_boat] call BIS_fnc_simpleObjectData;</sqf>
|x2= <sqf>[BIS_boat] call BIS_fnc_simpleObjectData;</sqf>

Revision as of 19:38, 29 April 2023

Hover & click on the images for description

Description

Description:
Get complete data needed for simple object creation.
Execution:
call
Groups:
Object Manipulation

Syntax

Syntax:
[classname] call BIS_fnc_simpleObjectData
Parameters:
classname: Object or String:
  • Object - Existing object or simple object that will be scanned; if it is a simple object '_reversed' attribute cannot be retrieved
  • String - Can be either:
    • Classname of the object; data are retrieved from the config definition.
    • Path to the p3d; verifies and fixes model path format and returns it in an array (index 1).
      It has very limited functionality in this mode as no data can actually be retrieved from model path.
Return Value:
Array in format [class, model, reversed, verticalOffset, animationAdjustments, selectionsToHide, verticalOffsetWorld, textures, randomizeAnims, randomizeTexs]:
  • class: String - (Default "") class name from CfgVehicles
  • model: String - (Default "") path to the vehicle p3d mode
  • reversed: Number - (Default 0) reverse value, to fix orientation. 0: no change, 1: reverse
  • verticalOffset: Array - (Default 0) vertical offset
  • animationAdjustments: Array - (Default []) animation to animate, every element has this format: [_animationName:string, _animationState:scalar]
  • hiddenSelections: Array - (Default []) all listed selection will be hidden
  • verticalOffsetWorld: Number - vertical offset in World coordinates; similar to ASL but refers to object at [0, 0, 0], not its land contacts
  • textures: Array - textures currently applied to the object
  • randomizeAnims: Boolean - (Default false) true if vehicle supports randomization through animations
  • randomizeTexs: Boolean - (Default false) true if vehicle supports randomization of textures
Return values can directly be used with BIS_fnc_adjustSimpleObject.

Examples

Example 1:
["B_Boat_Armed_01_minigun_F"] call BIS_fnc_simpleObjectData; /* [ "B_Boat_Armed_01_minigun_F", "A3\Boat_F\Boat_Armed_01\Boat_Armed_01_minigun_F.p3d", 1, 3.323, [ ["damagehide", 0], ["turret_shake", 0], ["turret_shake_aside", 0], ["magazine_hide", 0], ["mainturret", 0], ["damagehideotocvez", 0], ["maingun", 0.09], ["damagehideotochlaven", 0], ["rearturret", -3.16], ["reargun", 0.09], ["muzzleflash", 0], ["zaslehrot", 79], ["zasleh2rot", 600], ["fuel", 1], ["mph", 0], ["rpm", 0], ["amps_random", 0], ["oil_random", 0], ["trim_random", 0], ["tmp_random", 0], ["volt_random", 0], ["drivingwheel", 0], ["ammobelt_hide", 0], ["bullet001_2_hide", 0.33], ["bullet002_2_hide", 0.33], ["bullet003_2_hide", 0.33], ["bullet004_2_hide", 0.33], ["bullet005_2_hide", 0.33], ["bullet006_2_hide", 0.33], ["positionlights", 0], ["gun_revolving", 0.33], ["muzzleflash2", 0], ["reargunner", 0.09] ], ["zasleh", "p svetlo", "zadni svetlo", "brzdove svetlo", "clan", "podsvit pristroju", "poskozeni"], -0.148, [ "\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_ext_co.paa", "\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_int_co.paa", "\A3\boat_f\Boat_Armed_01\data\Boat_Armed_01_crows_blufor_co.paa" ], false, false ] */
Example 2:
[BIS_boat] call BIS_fnc_simpleObjectData;

Additional Information

See also:
createSimpleObject BIS_fnc_adjustSimpleObject BIS_fnc_createSimpleObject

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