Difference between revisions of "LlSensor"

Revision as of 11:35, 28 February 2007

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

If name, id, and/or type are empty or 0, they are ignored.
If id is an invalid key or NULL_KEY it is treated as empty.

Flag Mask		Description (llDetectedType())	Description (llSensor() and llSensorRepeat() mask)
AGENT_BY_LEGACY_NAME	0x1	Agents	This is used to find agents by legacy name.
AGENT	0x1	Agents	This is also used to find agents by legacy name, and is functionally identical to AGENT_BY_LEGACY_NAME
AGENT_BY_USERNAME	0x10	Reserved	This is used to find agents by username.
ACTIVE	0x2	Physical tasks. (Physical objects & agents)	Physical objects that are moving or objects containing an active script. Thus, it is using SL server resources now.
PASSIVE	0x4	Non-physical objects.	Non-scripted or script is inactive and non-physical or, if physical, not moving. Thus, it is not using SL server resources now.
SCRIPTED	0x8	Objects containing any active script.	Objects that has any script, which is doing anything in simulator just now.

llDetectedType()	Scripted	Not Scripted	Agent Standing	Agent Sitting
Physical Movement	10 (ACTIVE\|SCRIPTED)	2 (ACTIVE)	3 (ACTIVE\|AGENT)	3 (ACTIVE\|AGENT)
Non-Physical	12 (PASSIVE\|SCRIPTED)	4 (PASSIVE)	1 (AGENT)	5 (PASSIVE\|AGENT)

This sensor scans a 45 degree cone about the x-axis.

llSensor( "Gigs Taggart", NULL_KEY, AGENT, 96.0, PI/4 );

PI/2 or PI_BY_TWO constant is 90 degrees, aka a hemisphere. PI is a spherical scan.

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

@@ Line 1: / Line 1: @@
 {{LSL_Function
 |func_id=28|func_sleep=0.0|func_energy=10.0
-|sort=Sensor
+|sort=Sensor|func=llSensor
-|func=llSensor|p1_type=string|p1_name=name|p2_type=key|p2_name=id|p3_type=integer|p3_name=type|p4_type=float|p4_name=range|p5_type=float|p5_name=arc
+|p1_type=string|p1_name=name
-|func_footnote
+|p2_type=key|p2_name=id
-|func_desc=Performs a single scan for name and id with type (AGENT, ACTIVE, PASSIVE, and/or SCRIPTED) within range meters and arc radians of forward vector (name, id, and/or keytype can be empty or 0)
+|p3_type=integer|p3_name=type
+|p4_type=float|p4_name=range
+|p5_type=float|p5_name=arc
+|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_desc=Performs a single scan for '''name''' and '''id''' with '''type''' within '''range''' meters and '''arc''' radians of forward vector
 |return_text
 |spec
@@ Line 14: / Line 18: @@
 llSensor( "Gigs Taggart", NULL_KEY, AGENT, 96.0, PI/4 );
 </pre>
-[[PI]]/2 or [[PI_BY_TWO]] constant is 90 degrees, aka a hemisphere.  PI is a spherical scan.
+[[PI]]/2 or [[PI_BY_TWO]] constant is 90 degrees, aka a hemisphere. [[PI]] is a spherical scan.
 |helpers
 |also_functions=

•	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