You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.
This shows you the differences between two versions of the page.
|
functions:llallowinventorydrop [2015-01-08 14:33 SLT] sei created |
functions:llallowinventorydrop [2015-08-06 08:45 SLT] (current) sei Missing a word |
||
|---|---|---|---|
| Line 12: | Line 12: | ||
| === allow === | === allow === | ||
| - | [[types/Boolean]] value indicating whether to allow inventory drop (when [[constants/TRUE]]) or not (when [[constants/FALSE]]). | + | $lty[Boolean] value indicating whether to allow inventory drop (when $lct[TRUE]) or not (when $lct[FALSE]). |
| ===== Notes ===== | ===== Notes ===== | ||
| - | * The dropped items change ownership at the moment they are dropped. | + | * The dropped items change ownership at the moment they are dropped. No-transfer items can't be dropped. |
| - | * No-transfer items can't be dropped. | + | |
| * Scripts can't be dropped either. The dropper will receive a notification message: "Not permitted to edit this". | * Scripts can't be dropped either. The dropper will receive a notification message: "Not permitted to edit this". | ||
| - | * When an item is dropped with this option enabled, and the person who drops the item into the prim doesn't have modify rights, a [[events/changed]] event will be generated with the [[constants/CHANGED_ALLOWED_DROP]] flag set. However, if the person dropping the item has edit rights, then the setting of this function has no effect, and the flag for the **changed** event will be [[constants/CHANGED_INVENTORY]] instead. | + | * When an item is dropped with this option enabled, and the person who drops the item into the prim doesn't have modify rights on that prim, a $lev[changed] event will be generated with the $lct[CHANGED_ALLOWED_DROP] flag set. However, if the person dropping the item has edit rights, then the setting of this function has no effect, and the flag for the $ev[changed] event will be $lct[CHANGED_INVENTORY] instead. |
| * The **Locked** checkbox has no effect on the ability to drop: a locked object can still receive items. The official documentation says the opposite, but experimentation shows this to be the case (with Server 14.10.17.295641). | * The **Locked** checkbox has no effect on the ability to drop: a locked object can still receive items. The official documentation says the opposite, but experimentation shows this to be the case (with Server 14.10.17.295641). | ||
| - | * This setting is NOT a prim property: deleting all scripts that enabled it will cause the effect to cease. | ||
| * All items except textures, objects and scripts (that is, notecards, landmarks, clothing pieces, body parts, etc.) can be dropped by just dragging them from inventory. Objects and textures can be dropped by holding <html><kbd>Ctrl</kbd></html> before releasing the mouse button. Alternatively, editing the prim and dropping the item into the Contents tab works as well. | * All items except textures, objects and scripts (that is, notecards, landmarks, clothing pieces, body parts, etc.) can be dropped by just dragging them from inventory. Objects and textures can be dropped by holding <html><kbd>Ctrl</kbd></html> before releasing the mouse button. Alternatively, editing the prim and dropping the item into the Contents tab works as well. | ||
| * There is no way to determine who dropped an item, or what item it was. You can however enable drop when someone clicks, and assume that the first item dropped since then is from the person who clicked. See [[#Complete examples]] below. | * There is no way to determine who dropped an item, or what item it was. You can however enable drop when someone clicks, and assume that the first item dropped since then is from the person who clicked. See [[#Complete examples]] below. | ||
| + | * $perscript | ||
| ===== Short examples ===== | ===== Short examples ===== | ||
| Line 38: | Line 37: | ||
| <file lsl2 llAllowInventoryDrop-example.lsl> | <file lsl2 llAllowInventoryDrop-example.lsl> | ||
| string WhoDropped; | string WhoDropped; | ||
| + | integer in_use; | ||
| RevertToDefault() | RevertToDefault() | ||
| Line 43: | Line 43: | ||
| llSetText("Touch to drop an item", <1, 1, 1>, 1); | llSetText("Touch to drop an item", <1, 1, 1>, 1); | ||
| llSetTimerEvent(0); | llSetTimerEvent(0); | ||
| + | in_use = FALSE; | ||
| llAllowInventoryDrop(FALSE); | llAllowInventoryDrop(FALSE); | ||
| } | } | ||
| Line 55: | Line 56: | ||
| touch_start(integer n) | touch_start(integer n) | ||
| { | { | ||
| + | if (in_use) | ||
| + | { | ||
| + | llRegionSayTo(llDetectedKey(0), 0, "Sorry, this drop box is in use. Please wait until it's free."); | ||
| + | return; | ||
| + | } | ||
| + | in_use = TRUE; | ||
| llAllowInventoryDrop(TRUE); | llAllowInventoryDrop(TRUE); | ||
| WhoDropped = llDetectedName(0); | WhoDropped = llDetectedName(0); | ||
| Line 79: | Line 86: | ||
| The example is kept as simple as possible, and for that reason it doesn't recognize what was the last item dropped. | The example is kept as simple as possible, and for that reason it doesn't recognize what was the last item dropped. | ||
| - | The latter can be roughly done with a list that tracks the last known inventory of the prim, and comparing it with the list at the time a CHANGED_ALLOWED_DROP or a CHANGED_INVENTORY event is received. | + | The latter can be roughly done with a list that tracks the last known inventory of the prim, and comparing it with the list at the time a $ct[CHANGED_ALLOWED_DROP] or a $ct[CHANGED_INVENTORY] event is received. |
| - | Alternatively, as an easier alternative, it's possible to give the items to another prim in the linkset as they are received, deleting them from the current prim if they are copyable (using [[llGetInventoryPermMask]] to check the latter). | + | As an easier alternative, it's possible to give the items to another prim in the linkset (using $lfn[llGiveInventory] and $lfn[llGetLinkKey]) as they are received, deleting them from the current prim if they are copyable (using $lfn[llGetInventoryPermMask] to check the latter). That will help determine what the dropped items are. |
| ===== See also ===== | ===== See also ===== | ||
| - | * [[events/changed]] event is triggered when a successful drop occurs. | + | * $lev[changed] event is triggered when a successful drop occurs. |
| - | * [[llRemoveInventory]] to remove an item from the prim's contents. | + | * $lfn[llRemoveInventory] to remove an item from the prim's contents. |