Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
component:navigation [2014/07/10 09:04]
vexatos
component:navigation [2016/11/19 10:27] (current)
typheus
Line 12: Line 12:
 - `getRange():​ number`  ​ - `getRange():​ number`  ​
   Gets the effective range of the upgrade. If the absolute value of the relative X or Z coordinate becomes larger than this, `getPosition()` will fail.   Gets the effective range of the upgrade. If the absolute value of the relative X or Z coordinate becomes larger than this, `getPosition()` will fail.
 +- `findWaypoints(range:​ number): table` ​ __//​**Note:​** Requires version 1.5.9 of OpenComputers.//​__
 +
 +  Finds all [[block:​waypoint|waypoint blocks]] within the specified range. ​  
 +This returns a table that contains other tables. The top table has only numbered indices corresponding to each detected beacon. In each of this entries is another table, each row various aspects of the specified beacon: "​position",​ "​redstone",​ "​label"​.
 +
 +  * position returns a table with numbered indices in which 1 is x, 2 is y, and 3 is z. These numbers are the distance from the navigation component to the beacon in terms of block coordinates.
 +  * redstone returns a single number that is the current strength of the redstone signal
 +  * label returns a string that is the label of the beacon you can set by right clicking on it.   
   ​   ​
 +Below is an example of how the tables are set up. A single beacon'​s results are shown.
 +^table: main  ||| |
 +^table: 1  ^ table: position ​   ^ 1: | number: x distance |
 +|:::  |::: ​ ^ 2: | number: y distance |
 +|:::​ |:::​ ^ 3: | number: z distance |
 +|::: ^ redstone || number: redstone strength ||
 +|::: ^ label || string: beacon label ||
 +
  
 ---- ----
  
 {{page>​component:​contents&​noheader&​noeditbutton&​nouser&​nofooter}} {{page>​component:​contents&​noheader&​noeditbutton&​nouser&​nofooter}}