BIS fnc addVirtualItemCargo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (pf)
m (Some wiki formatting)
 
(41 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Function|Comments=
{{RV|type=function
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|version1= 1.24


|1.24|Game version=
|gr1= Inventory
____________________________________________________________________________________________


|Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the [[Arsenal]].|Description=
|descr= Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the [[Arsenal]].
____________________________________________________________________________________________
If parameters 4 and 5 are used this function can replace [[BIS_fnc_addVirtualWeaponCargo]], [[BIS_fnc_addVirtualMagazineCargo]] and [[BIS_fnc_addVirtualBackpackCargo]].


| [object,itemClasses,addItemsGlobal,arsenal] call [[BIS_fnc_addVirtualItemCargo]] |Syntax=
|s1= [object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call [[BIS_fnc_addVirtualItemCargo]]


|p1=object: [[Object]] - Object to which items will be added|Parameter 1=
|p1= object: [[Object]] - object to which items will be added


|p2=itemClasses: [[String]] or [[Array]] of [[String|strings]] - Item classes|Parameter 2=
|p2= itemClasses: [[Boolean]], [[String]] or [[Array]] of [[String]]s - item classes


|p3=addItemsGlobal: [[Boolean]] - (Optional, default [[false]]) [[True]] to add items globally|Parameter 3=
|p3= addItemsGlobal: [[Boolean]] - (Optional, default [[false]]) [[true]] to add items globally


|p4=arsenal: [[Boolean]] - (Optional, default [[true]]) [[True]] to add [[Arsenal]] action|Parameter 4=
|p4= arsenal: [[Boolean]] - (Optional, default [[true]]) [[true]] to add [[Arsenal]] action


| [[Array]] of [[Array|arrays]] - All virtual items in objects's space in format:
|p5= mode: [[Number]] - (Optional, default 1) defines what the function will do, can be:
*0: [[Array]] - Items
* -1 - remove given items
*1: [[Array]] - Weapons
*  0 - return current content
*2: [[Array]] - Magazines
*  1 - add given items
*3: [[Array]] - Backpacks|Return value=
____________________________________________________________________________________________


|x1= <code>[ BIS_ammoBox, ["class_1","class_2"], [[false]], [[true]] ] [[call]] [[BIS_fnc_addVirtualItemCargo]];</code>|Example 1=
|p6= itemType: [[Number]] - (Optional, default 0) define the item type, can be:
* 0 - items
* 1 - weapons
* 2 - magazines
* 3 - backpacks


____________________________________________________________________________________________
|r1= [[Array]] of [[String]]s - all virtual items


| [[Arsenal]],[[BIS_fnc_addVirtualBackpackCargo]], [[BIS_fnc_addVirtualMagazineCargo]],[[BIS_fnc_addVirtualWeaponCargo]],[[BIS_fnc_arsenal]],[[BIS_fnc_getVirtualBackpackCargo]],[[BIS_fnc_getVirtualItemCargo]],[[BIS_fnc_getVirtualMagazineCargo]],[[BIS_fnc_getVirtualWeaponCargo]], [[BIS_fnc_removeVirtualBackpackCargo]],[[BIS_fnc_removeVirtualItemCargo]], [[BIS_fnc_removeVirtualMagazineCargo]],[[BIS_fnc_removeVirtualWeaponCargo]] |See also=
|x1= <sqf>[BIS_ammoBox, ["class_1", "class_2"], false, true] call BIS_fnc_addVirtualItemCargo;</sqf>
 
|seealso= [[Arsenal]] [[BIS_fnc_addVirtualBackpackCargo]] [[BIS_fnc_addVirtualMagazineCargo]] [[BIS_fnc_addVirtualWeaponCargo]] [[BIS_fnc_arsenal]] [[BIS_fnc_getVirtualBackpackCargo]] [[BIS_fnc_getVirtualItemCargo]] [[BIS_fnc_getVirtualMagazineCargo]] [[BIS_fnc_getVirtualWeaponCargo]] [[BIS_fnc_removeVirtualBackpackCargo]] [[BIS_fnc_removeVirtualItemCargo]] [[BIS_fnc_removeVirtualMagazineCargo]] [[BIS_fnc_removeVirtualWeaponCargo]]
}}
}}


<h3 style="display:none">Notes</h3>
{{Note
<dl class="command_description">
|user= Kamaradski
<!-- Note Section BEGIN -->
|timestamp= 20141016235500
 
|text= In AmmoboxInit mode, for the ammobox to ONLY contain your white-listed items in the ammobox, you should first issue the [[BIS_fnc_removeVirtualItemCargo]] command. Otherwise the box will contain non whitelisted clutter.
<!-- Note Section END -->
<br><br>
</dl>
'''Example:'''
 
<sqf>
<h3 style="display:none">Bottom Section</h3>
["AmmoboxInit", [_myBox, true]] call BIS_fnc_arsenal;
[[Category:Function Group: Inventory|{{uc:addVirtualItemCargo}}]]
[_myBox, [true], true] call BIS_fnc_removeVirtualItemCargo;
[[Category:Functions|{{uc:addVirtualItemCargo}}]]
[_myBox, ["U_B_CombatUniform_mcam", "U_B_CombatUniform_mcam_tshirt"], true] call BIS_fnc_addVirtualItemCargo;
[[Category:{{Name|arma3}}: Functions|{{uc:addVirtualItemCargo}}]]
</sqf>
 
}}
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on October 16, 2014 - 23:55 (UTC)</dd>
<dt class="note">[[User:Kamaradski|Kamaradski]]</dt>
<dd class="note">
 
In AmmoboxInit mode, for the ammobox to ONLY contain your white-listed items in the ammobox, you should first issue the [[BIS_fnc_removeVirtualItemCargo]] command. Otherwise the box will contain non whitelisted clutter.
<BR>
<BR>'''Example:'''
<code>["AmmoboxInit",[_myBox,true]] call BIS_fnc_arsenal;
[_myBox,[true],true] call BIS_fnc_removeVirtualItemCargo;
[_myBox,["U_B_CombatUniform_mcam","U_B_CombatUniform_mcam_tshirt"],true] call BIS_fnc_addVirtualItemCargo;
</code>
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 00:41, 11 July 2022

Arma 3 logo black.png1.24
Hover & click on the images for description

Description

Description:
Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the Arsenal. If parameters 4 and 5 are used this function can replace BIS_fnc_addVirtualWeaponCargo, BIS_fnc_addVirtualMagazineCargo and BIS_fnc_addVirtualBackpackCargo.
Execution:
call
Groups:
Inventory

Syntax

Syntax:
[object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call BIS_fnc_addVirtualItemCargo
Parameters:
object: Object - object to which items will be added
itemClasses: Boolean, String or Array of Strings - item classes
addItemsGlobal: Boolean - (Optional, default false) true to add items globally
arsenal: Boolean - (Optional, default true) true to add Arsenal action
mode: Number - (Optional, default 1) defines what the function will do, can be:
  • -1 - remove given items
  •  0 - return current content
  •  1 - add given items
itemType: Number - (Optional, default 0) define the item type, can be:
  • 0 - items
  • 1 - weapons
  • 2 - magazines
  • 3 - backpacks
Return Value:
Array of Strings - all virtual items

Examples

Example 1:
[BIS_ammoBox, ["class_1", "class_2"], false, true] call BIS_fnc_addVirtualItemCargo;

Additional Information

See also:
Arsenal BIS_fnc_addVirtualBackpackCargo BIS_fnc_addVirtualMagazineCargo BIS_fnc_addVirtualWeaponCargo BIS_fnc_arsenal BIS_fnc_getVirtualBackpackCargo BIS_fnc_getVirtualItemCargo BIS_fnc_getVirtualMagazineCargo BIS_fnc_getVirtualWeaponCargo BIS_fnc_removeVirtualBackpackCargo BIS_fnc_removeVirtualItemCargo BIS_fnc_removeVirtualMagazineCargo BIS_fnc_removeVirtualWeaponCargo

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
Kamaradski - c
Posted on Oct 16, 2014 - 23:55 (UTC)
In AmmoboxInit mode, for the ammobox to ONLY contain your white-listed items in the ammobox, you should first issue the BIS_fnc_removeVirtualItemCargo command. Otherwise the box will contain non whitelisted clutter.

Example:
["AmmoboxInit", [_myBox, true]] call BIS_fnc_arsenal; [_myBox, [true], true] call BIS_fnc_removeVirtualItemCargo; [_myBox, ["U_B_CombatUniform_mcam", "U_B_CombatUniform_mcam_tshirt"], true] call BIS_fnc_addVirtualItemCargo;
Retrieved from "https://community.bistudio.com/wiki?title=BIS_fnc_addVirtualItemCargo&oldid=325299"