Difference between revisions of "LlSensor"

Revision as of 14:32, 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.

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.

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.

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.

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

@@ Line 2: / Line 2: @@
 |func_id=28|func_sleep=0.0|func_energy=10.0
 |sort=Sensor|func=llSensor
+|func_desc=Performs a single scan for '''name''' and '''id''' with '''type''' within '''range''' meters and '''arc''' radians of forward vector
 |p1_type=string|p1_name=name|p1_desc=object or avatar name
 |p2_type=key|p2_name=id|p2_desc=
@@ Line 8: / Line 9: @@
 |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''' or '''id''' is empty then that empty constraint is ignored.<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
 |return_text
 |spec
 |caveats=
 * 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.
 |examples=
 This sensor scans a 45 degree cone about the x-axis.

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

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