llDetectedPos

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/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

DetectedPos

llDetectedPos

Summary

Function: vector llDetectedPos( integer number );

0.0	Forced Delay
10.0	Energy

Returns a vector that is the position (in region coordinates) of detected object 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.

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.
  • Detection events are not raised if there is nothing detected.^[1]
  • The detection event's items detected parameter is initially never less than 1.^[2]

Examples

// Get position and distance of toucher

default
{
    touch_start(integer total_number)
    {
	// get the position of the avatar touching this prim
	vector pos = llDetectedPos(0);
		
	// compute how far away they are
	float dist = llVecDist(pos, llGetPos() );
		
	llSay(0, "You are " + (string) dist + " metres from me, at coordinates " + (string) pos);
    }
}

// get name and sim position of Avatars within "say" range

default
{
    state_entry()
    {
        llOwnerSay( "Touch me to get the positions of avatars in 'Say' range" );
    }

    touch_start( integer vIntTouchCount )
    {
        // Do a one-off sensor sweep over a 20m radius sphere for avatars
        llSensor( "", "", AGENT, 20, PI );
    }

    sensor( integer vIntFound )
    {
        integer vIntCounter = 0;
        //-- loop through all avatars found
        do
        {
            llOwnerSay( llDetectedName( vIntCounter )
                // get the position of this detected avatar
                + (string) llDetectedPos( vIntCounter ) );
        } while (++vIntCounter < vIntFound); 
    }

    // sensor does not detect owner if it's attached
    no_sensor()
    {
        llOwnerSay( "I couldn't find anybody" );
    }
}

See Also

Articles

•

Detected

Deep Notes

Footnotes

1. ^ The exception is no_sensor but it doesn't enable llDetected* functions.
2. ^ Like all event parameters, the user can overwrite the initial value.

Signature
function vector llDetectedPos( integer number );