Difference between revisions of "LlEdgeOfWorld"
Jump to navigation
Jump to search
m |
m (Replaced <source> with <syntaxhighlight>) |
||
| (10 intermediate revisions by 4 users not shown) | |||
| Line 4: | Line 4: | ||
|sort=EdgeOfWorld | |sort=EdgeOfWorld | ||
|func_id=205|func_sleep=0.0|func_energy=10.0 | |func_id=205|func_sleep=0.0|func_energy=10.0 | ||
|return_type=integer | |return_type=integer|return_subtype=boolean | ||
|p1_type=vector|p1_name=pos|p1_desc | |p1_type=vector|p1_name=pos|p1_desc | ||
|p2_type=vector|p2_name=dir|p2_desc=direction | |p2_type=vector|p2_subtype=direction|p2_name=dir|p2_desc=direction | ||
|func_footnote | |func_footnote=The '''z''' component of {{LSLP|dir}} is ignored. | ||
|func_desc=Checks to see whether the border hit by {{LSLP|dir}} from {{LSLP|pos}} is the edge of the world (has no neighboring simulator). | |func_desc=Checks to see whether the border hit by {{LSLP|dir}} from {{LSLP|pos}} is the edge of the world (has no neighboring simulator). | ||
|return_text= | |return_text=value. [[FALSE]] indicating there is a simulator in the direction indicated. | ||
|spec | |spec | ||
|caveats=* | |caveats=*If the '''x''' and '''y''' components of {{LSLP|dir}} are zero (like with [[ZERO_VECTOR]]), [[TRUE]] is always returned. | ||
* {{LSLP|pos}} must be in the region. | * {{LSLP|pos}} must be in the region. | ||
* Can only be used to detect directly adjacent regions, not diagonally adjacent regions | * Can only be used to detect directly adjacent regions, not diagonally adjacent regions | ||
* This function will also return [[TRUE]] if [[llRequestSimulatorData]]() returns "up" for an adjacent region but that region doesn't visibly show when standing next to its border. | |||
|constants | |constants | ||
|examples= | |examples= | ||
< | <syntaxhighlight lang="lsl2"> | ||
//--// Tells if there are neighboring sims on touch //--// | //--// Tells if there are neighboring sims on touch //--// | ||
| Line 36: | Line 37: | ||
} | } | ||
} | } | ||
</ | </syntaxhighlight> | ||
|helpers | |helpers | ||
|also_constants= | |also_constants= | ||
| Line 49: | Line 50: | ||
|permission | |permission | ||
|negative_index | |negative_index | ||
|haiku={{Haiku|The world once though flat|indeed has come full circle|here there be dragons.}} | |||
|cat1=Region | |cat1=Region | ||
|cat2=World Edge | |cat2=World Edge | ||
Latest revision as of 05:17, 23 April 2022
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: integer llEdgeOfWorld( vector pos, vector dir );| 0.0 | Forced Delay |
| 10.0 | Energy |
Checks to see whether the border hit by dir from pos is the edge of the world (has no neighboring simulator).
Returns a boolean (an integer) value. FALSE indicating there is a simulator in the direction indicated.
| • vector | pos | – | position in region coordinates | |
| • vector | dir | – | direction |
The z component of dir is ignored.
Caveats
- If the x and y components of dir are zero (like with ZERO_VECTOR), TRUE is always returned.
- pos must be in the region.
- Can only be used to detect directly adjacent regions, not diagonally adjacent regions
- This function will also return TRUE if llRequestSimulatorData() returns "up" for an adjacent region but that region doesn't visibly show when standing next to its border.
Examples
//--// Tells if there are neighboring sims on touch //--//
default{
touch_start( integer vIntTouched ){
vector vPosObject = llGetPos();
if (!llEdgeOfWorld( vPosObject, <0.0, 1.0, 0.0> )){
llOwnerSay( "There is a Sim to the North" );
}
if (!llEdgeOfWorld( vPosObject, <1.0, 0.0, 0.0> )){
llOwnerSay( "There is a Sim to the East" );
}
if (!llEdgeOfWorld( vPosObject, <0.0, -1.0, 0.0> )){
llOwnerSay( "There is a Sim to the South" );
}
if (!llEdgeOfWorld( vPosObject, <-1.0, 0.0, 0.0> )){
llOwnerSay( "There is a Sim to the West" );
}
}
}
See Also
Deep Notes
Signature |
|---|
function integer llEdgeOfWorld( vector pos, vector dir ); |
Haiku |
|---|
|
The world once though flat
|