OsNpcTouch

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
m
m (Added note stating which version of OpenSim introduced this function)
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{osslfunc
 
{{osslfunc
|function_syntax=osNpcTouch(LSL_KEY npcKey, LSL_Key objectKey, LSL_INTEGER linkNum)
+
|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 thefinction fails silently and no touch takes place.
+
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
 +
|permissions=${XEngine&#124;osslNPC}
 +
|delay=0
 
|ossl_example=
 
|ossl_example=
|additional_info=
+
|additional_info=This function was added in 0.7.4-post-fixes
 
}}
 
}}

Revision as of 09:43, 15 October 2018

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
llDetectedTouchFace TOUCH_INVALID_FACE
llDetectedTouchNormal TOUCH_INVALID_VECTOR
llDetectedTouchPos TOUCH_INVALID_VECTOR
llDetectedTouchST TOUCH_INVALID_TEXCOORD
llDetectedTouchUV TOUCH_INVALID_TEXCOORD

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 ${XEngine|osslNPC}
Extra Delay 0 seconds
Notes
This function was added in 0.7.4-post-fixes
Personal tools
General
About This Wiki