Difference between revisions of "LlSensor"

From Second Life Wiki
Jump to: navigation, search
m
Line 7: Line 7:
 
|p4_type=float|p4_name=range|p4_desc=range 0.0 to 96.0m
 
|p4_type=float|p4_name=range|p4_desc=range 0.0 to 96.0m
 
|p5_type=float|p5_name=arc|p5_desc=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to {{#var:PI}}|p5_hover=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to PI
 
|p5_type=float|p5_name=arc|p5_desc=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to {{#var:PI}}|p5_hover=the max angle between the local x-axis of the prim and detectable objects, range 0.0 to PI
|func_footnote=If '''name''', '''id''', and/or '''type''' are empty or 0, they are ignored.<br/>If '''id''' is an invalid key or [[NULL_KEY]] it is treated as empty.
+
|func_footnote=If '''name''', '''id''', and/or '''type''' are empty or 0, they are ignored.<br><b>(entering 0 as type currently makes the sensor to neither call the sensor or no_sensor event, 2008-12-08)</b><br/>If '''id''' is an invalid key or [[NULL_KEY]] it is treated as empty.
 
|func_desc=Performs a single scan for '''name''' and '''id''' with '''type''' within '''range''' meters and '''arc''' radians of forward vector
 
|func_desc=Performs a single scan for '''name''' and '''id''' with '''type''' within '''range''' meters and '''arc''' radians of forward vector
 
|return_text
 
|return_text

Revision as of 09:44, 8 December 2008

Deletion Requested
The deletion of this article was requested for the following reason:

Template is no longer used and it's creator thinks it does not function properly.

If there is a need to discuss the deletion of this article, please add your comment(s) here.

Summary

Function: llSensor( string name, key id, integer type, float range, float arc );

Performs a single scan for name and id with type within range meters and arc radians of forward vector

• string name Object or avatar name
• key id
• integer type mask (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED)
• float range range 0.0 to 96.0m
• float arc the max angle between the local x-axis of the prim and detectable objects, range 0.0 to PI

If name, id, and/or type are empty or 0, they are ignored.
(entering 0 as type currently makes the sensor to neither call the sensor or no_sensor event, 2008-12-08)
If id is an invalid key or NULL_KEY it is treated as empty.

Caveats

  • When searching for an avatar but not by name, it doesn't matter which AGENT flag is used.
  • Attachments cannot not detect their wearer.
All Issues ~ Search JIRA for related Bugs

Examples

This sensor scans a 45 degree cone about the x-axis. <lsl>llSensor( "Gigs Taggart", NULL_KEY, AGENT, 96.0, PI/4 );</lsl>

PI/2 or PI_BY_TWO scans a hemisphere. PI is a spherical scan.

See Also

Events

•  sensor Triggered when a sensor detects something
•  no_sensor Triggered when a sensor detects nothing

Functions

•  llSensorRepeat Runs a sensor on a timer
•  llSensorRemove Stops the llSensorRepeat timer

Articles

•  Object Type

Deep Notes

Search JIRA for related Issues

Signature

function void llSensor( string name, key id, integer type, float range, float arc );