Difference between revisions of "LlSensor"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 15: Line 15:
*If '''type''' is zero, the sensor will silently fail, neither [[sensor]] or [[no_sensor]] will be triggered.
*If '''type''' is zero, the sensor will silently fail, neither [[sensor]] or [[no_sensor]] will be triggered.
|examples=
|examples=
This sensor scans a 45 degree cone about the x-axis.
This sensor scans a 45 degree cone about the x-axis. ([[PI]]/2 or [[PI_BY_TWO]] scans a hemisphere. [[PI]] is a spherical scan.)
<lsl>llSensor( "Gigs Taggart", NULL_KEY, AGENT, 96.0, PI/4 );</lsl>
<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.
 
This sensor detects all prims and agents with a given name within 15m of the sensor.  (AGENT, PASSIVE and ACTIVE behave inclusively. SCRIPTED is not inclusive and will exclude non-scripted targets (like avatars) from the detected set.)
<lsl>llSensor( "Jopsy Pendragon", NULL_KEY, ( AGENT | PASSIVE | ACTIVE ), 15.0, PI );</lsl>
 
|helpers
|helpers
|also_functions=
|also_functions=

Revision as of 17:58, 21 February 2009

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 or id is empty then that empty constraint is ignored.
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 (this includes HUD attachments).
  • If type is zero, the sensor will silently fail, neither sensor or no_sensor will be triggered.
All Issues ~ Search JIRA for related Bugs

Examples

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

This sensor detects all prims and agents with a given name within 15m of the sensor. (AGENT, PASSIVE and ACTIVE behave inclusively. SCRIPTED is not inclusive and will exclude non-scripted targets (like avatars) from the detected set.)

<lsl>llSensor( "Jopsy Pendragon", NULL_KEY, ( AGENT

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 );