Difference between revisions of "ISKernel:navpath (Data Type)"
Jump to navigation
Jump to search
(2 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
+ | '''navpath is deprecated and is not supported. There may be bugs in it. Please use [[LavishNav]] instead''' | ||
+ | |||
== Description == | == Description == | ||
This data type gives access to '''Navigation Path''' information. The methods control '''Navigation Path''' information. | This data type gives access to '''Navigation Path''' information. The methods control '''Navigation Path''' information. | ||
Line 11: | Line 13: | ||
== Methods == | == Methods == | ||
*'''Clear''': Resets the path so it contains no points | *'''Clear''': Resets the path so it contains no points | ||
− | *'''GetPath['''world''','''point a''','''point b''']''': Gets | + | *'''GetPath['''world''','''point a''','''point b''']''': Gets the shortest path from point A to point B (clearing is not required, it is done automatically) |
− | *'''GetPath['''world''','''point a''','''point b''','''additional points ...''']''': Gets | + | *'''GetPath['''world''','''point a''','''point b''','''additional points ...''']''': Gets the shortest path from point A to point B to point C to point D ad infinitum (clearing is not required, it is done automatically) |
*'''Reverse''': Reverses the path | *'''Reverse''': Reverses the path | ||
Line 21: | Line 23: | ||
*declare PathHome navpath | *declare PathHome navpath | ||
:This command will declare a '''navpath''' variable with the name "PathHome" | :This command will declare a '''navpath''' variable with the name "PathHome" | ||
− | ===Find | + | ===Find shortest path from point a to point b=== |
*NavPath:GetPath[earth,detroit,cincinatti] | *NavPath:GetPath[earth,detroit,cincinatti] | ||
− | :This command will get | + | :This command will get the shortest path from "detroit" to "cincinatti" in the world "earth" |
− | |||
===Find the nearest point to a given location=== | ===Find the nearest point to a given location=== | ||
*echo Nearest Point: ${NavPath.NearestPoint[123,432,-222]} | *echo Nearest Point: ${NavPath.NearestPoint[123,432,-222]} | ||
Line 55: | Line 56: | ||
*[[ISSession:Navigation (Top-Level Object)|Navigation (Top-Level Object)]] | *[[ISSession:Navigation (Top-Level Object)|Navigation (Top-Level Object)]] | ||
*[[ISSession:NavPath (Top-Level Object)|NavPath (Top-Level Object)]] | *[[ISSession:NavPath (Top-Level Object)|NavPath (Top-Level Object)]] | ||
− | * [[ | + | *[[LavishScript:Data Types|Data Types]] |
− | * [[ | + | *[[IS:Kernel#Data_Types|Kernel Data Types]] |
+ | {{DT-Stub}} | ||
[[Category:Inner Space]] | [[Category:Inner Space]] | ||
− | [[Category:Inner Space | + | [[Category:Inner Space Kernel]] |
− | [[Category:Inner Space | + | [[Category:Inner Space Kernel Data Types]] |
Latest revision as of 13:52, 10 July 2009
navpath is deprecated and is not supported. There may be bugs in it. Please use LavishNav instead
Contents
Description
This data type gives access to Navigation Path information. The methods control Navigation Path information.
Members
- point3f Point[#]: Retrieves a point on the path. (Valid # is 1-Points)
- string PointName[#]: Retrieves the original name of a point on the path. (Valid # is 1-Points)
- int Points: The total number of points on this path
- int NearestPoint[x]: Retrieves the number of the nearest point on the path to location (x,0,0)
- int NearestPoint[x,y]: Retrieves the number of the nearest point on the path to location (x,y,0)
- int NearestPoint[x,y,z]: Retrieves the number of the nearest point on the path to location (x,y,z)
Methods
- Clear: Resets the path so it contains no points
- GetPath[world,point a,point b]: Gets the shortest path from point A to point B (clearing is not required, it is done automatically)
- GetPath[world,point a,point b,additional points ...]: Gets the shortest path from point A to point B to point C to point D ad infinitum (clearing is not required, it is done automatically)
- Reverse: Reverses the path
Returns
NULL
Examples
- declare PathHome navpath
- This command will declare a navpath variable with the name "PathHome"
Find shortest path from point a to point b
- NavPath:GetPath[earth,detroit,cincinatti]
- This command will get the shortest path from "detroit" to "cincinatti" in the world "earth"
Find the nearest point to a given location
- echo Nearest Point: ${NavPath.NearestPoint[123,432,-222]}
- This command will find the nearest point to the given X,Y,Z and returns the Point index #
Find total number of points in a path
- echo Total Points: ${PathHome.Points}
- Output
Total Points: 47
List the name of all points
- Sample code
declare x int 1 do { echo Point ${x}: ${PathHome.PointName[x]} } while (${x:Inc}<=${PathHome.Points})
Reverse a path
- PathHome:Reverse
- This command will change a path that goes from point A to B to C to now be from C to B to A