From Second Life Wiki
Jump to navigation Jump to search


Function: vector llDetectedPos( integer number );

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.


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.


  • 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]
All Issues ~ Search JIRA for related Bugs


// Get position and distance of toucher

    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

        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
            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
        llOwnerSay( "I couldn't find anybody" );

See Also


•  Detected

Deep Notes

Search JIRA for related Issues


  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.


function vector llDetectedPos( integer number );