Difference between revisions of "LlDetectedVel"
Jump to navigation
Jump to search
Omei Qunhua (talk | contribs) (Edit example for formatting, improved loop, and to use sensible values for range and arc) |
Omei Qunhua (talk | contribs) m (Make example match the description) |
||
| (2 intermediate revisions by 2 users not shown) | |||
| Line 11: | Line 11: | ||
|constants | |constants | ||
|examples= | |examples= | ||
< | <source lang="lsl2"> | ||
//Tells the name and velocity of all near-by avatars. | //Tells the name and velocity of all near-by avatars. | ||
default | default | ||
| Line 18: | Line 18: | ||
{ | { | ||
// Scan once for avatars within a 96 metre radius sphere | // Scan once for avatars within a 96 metre radius sphere | ||
llSensor("", "", AGENT, 96 | llSensor("", "", AGENT, 96, PI); | ||
} | } | ||
sensor(integer num) | sensor(integer num) | ||
| Line 25: | Line 25: | ||
while(num--) | while(num--) | ||
{ | { | ||
llOwnerSay(llDetectedName(num) + " is moving at " + (string)llVecMag(llDetectedVel( | llOwnerSay(llDetectedName(num) + " is moving at " + (string)llVecMag(llDetectedVel(num)) + " m/s."); | ||
} | } | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers | ||
|also_functions | |also_functions | ||
Latest revision as of 08:46, 18 January 2016
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: vector llDetectedVel( integer number );
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns the vector velocity of detected object or avatar number.
| • integer | number | – | Index of detection information |
number does not support negative indexes. Returns <0.0, 0.0, 0.0> if number is not valid sensed object or avatar.
Specification
llDetected* functions only work if called from within Detection events (collision, collision_start, collision_end, sensor, touch, touch_start, touch_end) or in functions called by Detection events. They will fail silently and return unusable values if called during other events.
Caveats
- If number is out of bounds this function returns <0.0, 0.0, 0.0> and the script continues to execute without an error message.
- Events that enable the llDetected* functions always return at least one detected item.
Examples
//Tells the name and velocity of all near-by avatars.
default
{
state_entry()
{
// Scan once for avatars within a 96 metre radius sphere
llSensor("", "", AGENT, 96, PI);
}
sensor(integer num)
{
// num will initially be 1 or more. When num is 1, the index of the detected avatar will be zero
while(num--)
{
llOwnerSay(llDetectedName(num) + " is moving at " + (string)llVecMag(llDetectedVel(num)) + " m/s.");
}
}
}
See Also
Articles
| • | Detected |
Deep Notes
Footnotes
- ^ The exception is no_sensor but it doesn't enable llDetected* functions.
- ^ Like all event parameters, the user can overwrite the initial value.
Signature |
|---|
function vector llDetectedVel( integer number ); |