Difference between revisions of "LlSetClickAction"
Jump to navigation
Jump to search
m |
|||
| Line 8: | Line 8: | ||
|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]] [[script]]s 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. | |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]] [[script]]s 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]]. | *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. The viewer always behaves as though an attached object has [[CLICK_ACTION_TOUCH]] set. | |||
|examples= This is a great way to create a user interface that evolves with the process the script is taking the user through.<lsl>key sitter; | |examples= This is a great way to create a user interface that evolves with the process the script is taking the user through.<lsl>key sitter; | ||
Revision as of 14:54, 2 February 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llSetClickAction( integer action );| 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) | 
|
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. The viewer always behaves as though an attached object has CLICK_ACTION_TOUCH set.
Examples
This is a great way to create a user interface that evolves with the process the script is taking the user through.<lsl>key sitter;
list up_up_and_away;
CoughsAndLolz() {
integer count = 0;
vector XYZ = llGetPos();
float X = XYZ.x;
float Y = XYZ.y;
do
up_up_and_away = up_up_and_away + [PRIM_POSITION, <X,Y,4000.0>];
while((++count) < 400);
}
default {
state_entry()
{
llSetClickAction(CLICK_ACTION_SIT); // Set in state entry to be sit on click.
llSitTarget(<0.0,0.0,0.01>, ZERO_ROTATION);
}
changed(integer change)
{
if(change & CHANGED_LINK)
{
sitter = llAvatarOnSitTarget();
if(sitter)
{ // Someone is upon us.
CoughsAndLolz();
llSetClickAction(CLICK_ACTION_TOUCH);// And so we change the click action to allow the touch_start.
llSay(0, "Click me for a thrill");
}
}
}
touch_start(integer detected)
{
if(sitter)
{
llSetLinkPrimitiveParams(LINK_SET, up_up_and_away);
llUnSit(sitter);
llDie();
}
}
}</lsl>
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
Signature |
|---|
function void llSetClickAction( integer action ); integer CLICK_ACTION_ZOOM = 7;//Zoom |