This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
component:navigation [2015/05/10 22:15] rashy |
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` | + | - `findWaypoints(range: number): table` __//**Note:** Requires version 1.5.9 of OpenComputers.//__ |
- | Finds all waypoint blocks within the specified range. Returns a table containing the label of the waypoint, and coordinates relative to the robot or drone. | + | |
- | //**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}} |