OsNpcTouch
From OpenSimulator
(Difference between revisions)
m |
m (Script improvement) |
||
| (10 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{osslfunc | {{osslfunc | ||
| − | |function_syntax=osNpcTouch( | + | |function_syntax=osNpcTouch(key npcKey, key objectKey, integer linkNum) |
|csharp_syntax= | |csharp_syntax= | ||
|description=Only LINK_THIS and LINK_ROOT are valid for this function. Any other of the LINK_* constants will be ignored and no touch takes place. | |description=Only LINK_THIS and LINK_ROOT are valid for this function. Any other of the LINK_* constants will be ignored and no touch takes place. | ||
| Line 8: | Line 8: | ||
2. If linkNum is LINK_ROOT or 0 then the root prim of the link set will be touched, even if the root prim key is not objectKey | 2. If linkNum is LINK_ROOT or 0 then the root prim of the link set will be touched, even if the root prim key is not objectKey | ||
| − | 3. For any other value of linkNum a search will be made through the linkset for a prim with that link number. If found that prim will be touched. If no prim is found for that link number | + | 3. For any other value of linkNum a search will be made through the linkset for a prim with that link number. If found that prim will be touched. If no prim is found for that link number the function fails silently and no touch takes place. |
The touch is fired as if it came from an old client that does not support face touch detection or (probably) one of the text clients like Metabolt. Since there is no mouse the llDetectedTouch* functions will return the defaults (See the LSL Wiki for full details) | The touch is fired as if it came from an old client that does not support face touch detection or (probably) one of the text clients like Metabolt. Since there is no mouse the llDetectedTouch* functions will return the defaults (See the LSL Wiki for full details) | ||
| − | llDetectedTouchBinormal TOUCH_INVALID_VECTOR | + | llDetectedTouchBinormal TOUCH_INVALID_VECTOR<br> |
| − | llDetectedTouchFace TOUCH_INVALID_FACE | + | llDetectedTouchFace TOUCH_INVALID_FACE<br> |
| − | llDetectedTouchNormal TOUCH_INVALID_VECTOR | + | llDetectedTouchNormal TOUCH_INVALID_VECTOR<br> |
| − | llDetectedTouchPos TOUCH_INVALID_VECTOR | + | llDetectedTouchPos TOUCH_INVALID_VECTOR<br> |
| − | llDetectedTouchST TOUCH_INVALID_TEXCOORD | + | llDetectedTouchST TOUCH_INVALID_TEXCOORD<br> |
| − | llDetectedTouchUV TOUCH_INVALID_TEXCOORD | + | llDetectedTouchUV TOUCH_INVALID_TEXCOORD<br> |
If the prim is not found or would not allow a normal client to touch it then this function fails silently. | If the prim is not found or would not allow a normal client to touch it then this function fails silently. | ||
|threat_level=High | |threat_level=High | ||
| − | |ossl_example= | + | |permissions=${OSSL|osslNPC} |
| − | |additional_info= | + | |delay=0 |
| + | |ossl_example=<source lang="lsl"> | ||
| + | // | ||
| + | // osNpcTouch Script Exemple | ||
| + | // Author: djphil | ||
| + | // | ||
| + | |||
| + | key npc; | ||
| + | integer hello; | ||
| + | |||
| + | default | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | llSay(PUBLIC_CHANNEL, "Touch to see osNpcTouch usage."); | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | key toucher = llDetectedKey(0); | ||
| + | vector npcPos = llGetPos() + <-1.0, 0.0, 1.0>; | ||
| + | osAgentSaveAppearance(toucher, "appearance"); | ||
| + | npc = osNpcCreate("ImYour", "Clone", npcPos, "appearance"); | ||
| + | state hasNPC; | ||
| + | } | ||
| + | } | ||
| + | |||
| + | state hasNPC | ||
| + | { | ||
| + | state_entry() | ||
| + | { | ||
| + | llSetTimerEvent(5.0); | ||
| + | } | ||
| + | |||
| + | timer() | ||
| + | { | ||
| + | if (hello == FALSE) | ||
| + | { | ||
| + | osNpcSay(npc, "Hello world!"); | ||
| + | hello = TRUE; | ||
| + | } | ||
| + | |||
| + | llSetTimerEvent(2.0); | ||
| + | osNpcTouch(npc, llGetKey(), LINK_THIS); | ||
| + | } | ||
| + | |||
| + | touch_start(integer number) | ||
| + | { | ||
| + | if (osIsNpc(llDetectedKey(0))) | ||
| + | { | ||
| + | llSetColor(<llFrand(1.0), llFrand(1.0), llFrand(1.0)>, ALL_SIDES); | ||
| + | } | ||
| + | |||
| + | else | ||
| + | { | ||
| + | llSetColor(<1.0, 1.0, 1.0>, ALL_SIDES); | ||
| + | osNpcSay(npc, "Goodbye!"); | ||
| + | llSetTimerEvent(0.0); | ||
| + | osNpcRemove(npc); | ||
| + | npc = NULL_KEY; | ||
| + | hello = FALSE; | ||
| + | state default; | ||
| + | } | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | |additional_info=This function was added in 0.7.4-post-fixes | ||
}} | }} | ||
Latest revision as of 17:21, 13 December 2020
 |
Languages: |
|
osNpcTouch(key npcKey, key objectKey, integer linkNum)
| |
| Only LINK_THIS and LINK_ROOT are valid for this function. Any other of the LINK_* constants will be ignored and no touch takes place.
1. If linkNum is LINK_THIS then the prim with the key objectKey will be touched. 2. If linkNum is LINK_ROOT or 0 then the root prim of the link set will be touched, even if the root prim key is not objectKey 3. For any other value of linkNum a search will be made through the linkset for a prim with that link number. If found that prim will be touched. If no prim is found for that link number the function fails silently and no touch takes place. The touch is fired as if it came from an old client that does not support face touch detection or (probably) one of the text clients like Metabolt. Since there is no mouse the llDetectedTouch* functions will return the defaults (See the LSL Wiki for full details) llDetectedTouchBinormal TOUCH_INVALID_VECTOR If the prim is not found or would not allow a normal client to touch it then this function fails silently. | |
| Threat Level | High |
| Permissions | ${OSSL|osslNPC} |
| Extra Delay | 0 seconds |
| Example(s) | |
// // osNpcTouch Script Exemple // Author: djphil // key npc; integer hello; default { state_entry() { llSay(PUBLIC_CHANNEL, "Touch to see osNpcTouch usage."); } touch_start(integer number) { key toucher = llDetectedKey(0); vector npcPos = llGetPos() + <-1.0, 0.0, 1.0>; osAgentSaveAppearance(toucher, "appearance"); npc = osNpcCreate("ImYour", "Clone", npcPos, "appearance"); state hasNPC; } } state hasNPC { state_entry() { llSetTimerEvent(5.0); } timer() { if (hello == FALSE) { osNpcSay(npc, "Hello world!"); hello = TRUE; } llSetTimerEvent(2.0); osNpcTouch(npc, llGetKey(), LINK_THIS); } touch_start(integer number) { if (osIsNpc(llDetectedKey(0))) { llSetColor(<llFrand(1.0), llFrand(1.0), llFrand(1.0)>, ALL_SIDES); } else { llSetColor(<1.0, 1.0, 1.0>, ALL_SIDES); osNpcSay(npc, "Goodbye!"); llSetTimerEvent(0.0); osNpcRemove(npc); npc = NULL_KEY; hello = FALSE; state default; } } } | |
| Notes | |
| This function was added in 0.7.4-post-fixes | |
