Difference between revisions of "LlGiveInventoryList"
Jump to navigation
Jump to search
m |
m |
||
| Line 21: | Line 21: | ||
|caveats= | |caveats= | ||
|examples= | |examples= | ||
< | <source lang="lsl2"> | ||
// when the prim is touched, the script checks all other inventory items whether or not they're copiable | // when the prim is touched, the script checks all other inventory items whether or not they're copiable | ||
// copiable items are added to a list, if the list is not empty when all items have been checked | // copiable items are added to a list, if the list is not empty when all items have been checked | ||
| Line 62: | Line 62: | ||
} | } | ||
} | } | ||
</ | </source> | ||
< | <source lang="lsl2"> | ||
// script gives items to owner only | // script gives items to owner only | ||
// all copiable items are given within a single folder | // all copiable items are given within a single folder | ||
| Line 100: | Line 100: | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions={{LSL DefineRow||[[llGiveInventory]]}} | |also_functions={{LSL DefineRow||[[llGiveInventory]]}} | ||
Revision as of 10:19, 22 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Specification
target types
Depending upon the type of target this function works differently.
- Avatar
- Must be or recently have been within the same Region as sending object. SVC-868
- Places the inventory items in a newly created folder in the avatars inventory (even if there is a folder by the same name, a new one is created).
- Prim / Object
- The prim must be in the same region.
- Does not create a folder.
Caveats
- This function causes the script to sleep for 3.0 seconds.
- If target is not the owner nor shares the same owner, and inventory does not have transfer permissions, an error is shouted on DEBUG_CHANNEL.
- If inventory permissions do not allow copy, the transfer fails and an error is shouted on DEBUG_CHANNEL.
- If target is a prim that is not in the same region an error is shouted on DEBUG_CHANNEL.
- When scripts are copied or moved between inventories, their state does not survive the transfer. Memory, event queue and execution position are all discarded.
- If inventory is missing from the prim's inventory then an error is shouted on DEBUG_CHANNEL.
Examples
// when the prim is touched, the script checks all other inventory items whether or not they're copiable
// copiable items are added to a list, if the list is not empty when all items have been checked
// the prim gives them to the touching avatar within a single folder
default
{
touch_start(integer num_detected)
{
string thisScript = llGetScriptName();
list inventoryItems;
integer inventoryNumber = llGetInventoryNumber(INVENTORY_ALL);
integer index;
for ( ; index < inventoryNumber; ++index )
{
string itemName = llGetInventoryName(INVENTORY_ALL, index);
if (itemName != thisScript)
{
if (llGetInventoryPermMask(itemName, MASK_OWNER) & PERM_COPY)
{
inventoryItems += itemName;
}
else
{
llSay(0, "Unable to copy the item named '" + itemName + "'.");
}
}
}
if (inventoryItems == [] )
{
llSay(0, "No copiable items found, sorry.");
}
else
{
llGiveInventoryList(llDetectedKey(0), llGetObjectName(), inventoryItems); // 3.0 seconds delay
}
}
}
// script gives items to owner only
// all copiable items are given within a single folder
// all no-copy items are transferred separately (only one time, right? right!)
default
{
touch_start(integer num_detected)
{
key owner = llGetOwner();
if (llDetectedKey(0) != owner)
return;
list inventoryItems;
integer inventoryNumber = llGetInventoryNumber(INVENTORY_ALL);
integer index;
for ( ; index < inventoryNumber; ++index )
{
string itemName = llGetInventoryName(INVENTORY_ALL, index);
if (itemName != llGetScriptName() )
{
if (llGetInventoryPermMask(itemName, MASK_OWNER) & PERM_COPY)
{
inventoryItems += itemName;
}
else
{
llGiveInventory(owner, itemName); // 2.0 seconds delay
}
}
}
if (inventoryItems != [] )
llGiveInventoryList(owner, llGetObjectName(), inventoryItems); // 3.0 seconds delay
}
}
See Also
Deep Notes
Signature |
|---|
function void llGiveInventoryList( key target, string folder, list inventory ); |