llSetClickAction
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetClickAction( integer action );| 333 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Sets the action performed when a prim is clicked upon (aka click action).
| • integer | action | – | CLICK_ACTION_* flag |
When the cursor hovers over the prim, its image changes to reflect the action.
Constants
| Flag | Description | Cursor | |
|---|---|---|---|
| CLICK_ACTION_NONE | 0 | Performs the default action: when the prim is touched, touch events are triggered | |
| CLICK_ACTION_TOUCH | 0 | When the prim is touched, touch events are triggered | |
| CLICK_ACTION_SIT | 1 | When the prim is touched, the avatar sits upon it | 
|
| CLICK_ACTION_BUY | 2 | When the prim is touched, the buy dialog is opened | 
|
| CLICK_ACTION_PAY | 3 | When the prim is touched, the pay dialog is opened |
|
| CLICK_ACTION_OPEN | 4 | When the prim is touched, the object inventory dialog is opened | 
|
| CLICK_ACTION_PLAY | 5 | Play or pause parcel media on touch | 
|
| CLICK_ACTION_OPEN_MEDIA | 6 | Play parcel media on touch, no pause | 
|
| CLICK_ACTION_ZOOM | 7 | Zoom (Viewer 2) | 
|
| CLICK_ACTION_DISABLED | 8 | No click action. No touches detected or passed. |
Caveats
- When set in the root of an object the chosen CLICK_ACTION_* will be that for the children also even if they have their own llSetClickAction set (it will be over-ridden). However (in the case of touch for example) if the CLICK_ACTION_* is set in the root but not at all in the children (including not having touch event scripts in them (this creates a default CLICK_ACTION_TOUCH)) the effect of the roots CLICK_ACTION_* is not seen but the CLICK_ACTION_* is used on clicking. To both use and see the correct cursor the CLICK_ACTION_* flags must match in the children and root.
- If llSetClickAction is CLICK_ACTION_PAY then you must have a money event, or it will revert to CLICK_ACTION_NONE.
- While this function works or attached objects (click action can be changed), the configured click action of an attachment is ignored by the viewer (with exceptions). The viewer always* behaves as though an attached object has CLICK_ACTION_TOUCH set.
- The only exception to the above rule is when the chosen click action is CLICK_ACTION_NONE, which will disable the cursor changing from the standard pointer arrow to the touch pointer.
Examples
| make sitting easier | make unpaking for next owner easier | make buying for customers easier |
|---|---|---|
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_SIT);
llRemoveInventory(llGetScriptName());
}
}
|
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_OPEN);
llRemoveInventory(llGetScriptName());
}
}
|
// remember you'll have to set a price
// in the general tab of the edit window
// for your object before using this script
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_BUY);
llRemoveInventory(llGetScriptName());
}
}
|
// simple tipjar
default
{
state_entry()
{
llSetClickAction(CLICK_ACTION_PAY);
// enabled edit field to put own amount, all quick-pay-buttons hidden
llSetPayPrice(PAY_DEFAULT, [PAY_HIDE, PAY_HIDE, PAY_HIDE, PAY_HIDE]);
}
money(key id, integer amount)
{
string name = llKey2Name(id);
llInstantMessage(id, "Thank you for the tip, " + name + "!");
}
}
//Sit Only with Permission
list gAvWhitelist = ["953d10f1-44ce-462a-8bc1-f634333ee031","599dce91-a2b8-48c5-b96d-54965433022b"];
default
{
state_entry()
{
llSitTarget(<0.0,0.0,0.5>,ZERO_ROTATION);
}
changed(integer change)
{
if(change & CHANGED_LINK)
{
list Properties = llGetObjectDetails(llGetKey(),[OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties,0);
key Av = llAvatarOnSitTarget();
if ((Av != NULL_KEY) && (!Click))
{
llSay(0,"Please click first for permission to sit.");
llUnSit(Av);
}
}
}
touch_start(integer total_number)
{
list Properties = llGetObjectDetails(llGetKey(),[OBJECT_CLICK_ACTION]);
integer Click = llList2Integer(Properties,0);
if (!Click && (~llListFindList(gAvWhitelist,[(string)llDetectedKey(0)])) )
{
llSetClickAction(CLICK_ACTION_SIT);
llSetTimerEvent(10.0);
llSay(0,"Please take a seat.");
}
else
{
llSetClickAction(CLICK_ACTION_TOUCH);
if (llAvatarOnSitTarget() != NULL_KEY)
{
llSay(0,"Good bye!");
}
else
{
llSay(0,"Sorry. You are not allowed to sit here.");
}
llUnSit(llDetectedKey(0));
}
}
timer()
{
llSetTimerEvent(0.0);
llSetClickAction(CLICK_ACTION_TOUCH);
}
}
See Also
Deep Notes
History
- Introduced in SL Client 1.19.1(0)
- CLICK_ACTION_ZOOM added in SL Server 1.32 and Viewer 2
All Issues
~ Search JIRA for related Issues
|
|
VWR-640 | A | Shift-drag to copy object does not copy all settings | |
|
|
|
VWR-10829 | A | Linux Viewer: CLICK_ACTION_PAY shows CLICK_ACTION_PLAY icon |
Signature |
|---|
function void llSetClickAction( integer action ); integer CLICK_ACTION_ZOOM = 7;//Zoom |