LlSensor

From Second Life Wiki

Jump to: navigation, search

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

Contents

Summary

Function: llSensor( string name, key id, integer type, float range, float arc );
28 Function ID
0.0 Delay
10.0 Energy

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 simulator
• 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

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

Deep Notes

This article wasn't helpful for you? Maybe the related article at the LSL Wiki is able to bring enlightenment.
Personal tools
In other languages