BIS_fnc_simpleObjectData

1.00

Hover & click on the images for description

Description

Description:

/*
	Author: Jiri Wainar

	Description:
	Get complete data needed for simple object creation.

	Parameter(s):
	0: STRING - classname of the object; data are retrieved from the config definition.
	   or
	   OBJECT - existing object or simple object that will be scanned; if it is a simple object '_reversed' attribute cannot be retrieved
	   or
	   STRING - 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.

	Returns:
   	0: _class:string - asset CfgVehicles config class (default: "")
   	1: _model:string - path to the vehicle p3d model; needs to start without backslash and must end with the proper file extension ".p3d" (default: "")
   	2: _reversed:scalar - some objects, usually vehicles, are reveresed in p3d (default: 0); valid values are 0: no change, 1: reverse, -1: unknown (behaves as 0)
   	3: _verticalOffset:scalar - fix for non-existant physX; usually needed only for vehicles (default: 0)
   	4: _animationsAdjustments:array - animation that need to be animated to given state (default: []); every element has this format: [_animationName:string,_animationState:scalar]
   	5: _selectionsToHide:array - all listed selection will be hidden (default: [])
   	6: _verticalOffsetWorld:scalar - vertical offset in World coordinates; similar to ASL but refers to object [0,0,0], not its land contacts
   	7. _textures:array - textures applied to object

	Example:
	_data:array = [_vehicle:object] call BIS_fnc_simpleObjectData;
	_data:array = [_class:string] call BIS_fnc_simpleObjectData;

	See also:
	* bis_fnc_createSimpleObject
	* bis_fnc_replaceWithSimpleObject
	* bis_fnc_simpleObjectData
	* bis_fnc_exportCfgVehiclesSimpleObjectData
	* bis_fnc_diagMacrosSimpleObjectData
*/

#define SELECTIONS_TO_HIDE		["fireanim","brakelights","clan","dashboard","showdamage","damage","backlights","offlight","redlight","whitelight","hrotorstill","hrotormove","vrotorstill","vrotormove","rotorstill","rotormove"]
#define RETURN_VALUES			[_class,_model,_reversed,_verticalOffset,_animationsAdjustments,_selectionsToHide,_verticalOffsetWorld,_textures]
#define ROUND_DECIMALS(input,accuracy)	round((1/accuracy)*(input))*accuracy;

(Placeholder description extracted from the function header by BIS_fnc_exportFunctionsToWiki)

Execution:

call

Groups:

Uncategorised

Syntax

Syntax:

Syntax needed

Return Value:

Return value needed

Examples

Example 1:

Additional Information

See also:

See also needed

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