From Second Life Wiki
Template:Needs Translation/LSL/de
Template:Needs Translation/LSL/es
Template:Needs Translation/LSL/el
Template:Needs Translation/LSL/he
Template:Needs Translation/LSL/it
Template:Needs Translation/LSL/ko
Template:Needs Translation/LSL/nl
Template:Needs Translation/LSL/hu
Template:Needs Translation/LSL/no
Template:Needs Translation/LSL/da
Template:Needs Translation/LSL/sv
Template:Needs Translation/LSL/tr
Template:Needs Translation/LSL/pl
Template:Needs Translation/LSL/pt
Template:Needs Translation/LSL/ru
Template:Needs Translation/LSL/uk
Template:Needs Translation/LSL/zh-Hans
Template:Needs Translation/LSL/zh-Hant
/LSL
Sensor
llSensor
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
| –
| avatar or object UUID that is in the same region
|
|
| • 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.
| type Flag
| Description
|
| AGENT
| 0x1
| This is used to find agents only.
|
| ACTIVE
| 0x2
| This is used to find physical objects that are moving or objects containing an active script.
|
|
| type Flag
| Description
|
| PASSIVE
| 0x4
| This is used to find physical objects that are not moving or non-physical objects containing an inactive script or a non-scripted object.
|
| SCRIPTED
| 0x8
| This is used to find objects containing an active script.
|
|
| Float Constants
| Arc
|
| PI_BY_TWO
| A hemisphere scan
|
| PI
| A full sphere scan
|
|
Caveats
- Attachments cannot detect their wearer (this includes HUD attachments).
- Sensors placed in attachments will use the direction the avatar is facing as their forward vector. In mouselook, this means that it will be wherever the avatar is looking, while out of mouselook, this means whichever way the avatar is pointing. This does not include where the avatar's head is pointing, or what animation the avatar is doing, just the direction the avatar would move in if you walked forward. This is the case, regardless of where the object is attached.
- If type is zero, the sensor will silently fail, neither sensor or no_sensor will be triggered.
- Only 16 objects will be scanned each time.
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.)
llSensor( "Gigs Taggart", NULL_KEY, AGENT, 96.0, PI/4 );
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.)
llSensor( "", NULL_KEY, ( AGENT | PASSIVE | ACTIVE ), 15.0, PI );
See Also
Events
| •
| sensor
| –
| Triggered when a sensor detects something
|
|
| •
| no_sensor
| –
| Triggered when a sensor detects nothing
|
|
Functions
