Spring - User contributions [en]

Lua PathFinder

2010-04-30T22:55:24Z

Troycheek: /* Path UserData Object */

[[Engine_Development|Development]] < [[Lua_Scripting|Lua Scripting]] < {{FULLPAGENAME}}

== PathFinder ==
'''Spring.RequestPath'''
( string "MoveTypeName" | number moveID,
number start_x, number start_y, number start_z,
number end_x, number end_y, number end_z
[, number radius = 8 ]
) -> nil | pathObject path (see below)

== Path UserData Object ==
'''Path:GetEstimatedPath'''
( ) -> nil | {
[1] = { x,y,z }, ...
},{
[1] = startIdxOfDetailedPath,
[2] = startIdxOfDetailedEstimatedPath1,
[3] = startIdxOfDetailedEstimatedPath2,
}
GetEstimatedPath() returns 2 tables: 1 table with the waypoints and 1 table with 3 indices (in the waypoint table) when a new (more lazy) pathfinding algorithm begins. So the waypoint table contains 3 different levels of details.

'''Path:Next'''
( number pos_x, number pos_y, number pos_z,
[, number radius = 0 ]
) -> nil | number x, number y, number z
Path:Next() returns the next waypoint in the path. Unlike GetEstimatedPath() in which the resolution of the waypoints decreases, Next updates the path so the resolution will increase as it approaches the target.

Note that ''Path'' in ''Path:GetEstimatedPath'' and ''Path:Next'' is not part of the command, but rather a reference to the path Object created by ''Spring.RequestPath''. It must match the path Object (case sensitive).

[[category: Lua]]

Lua PathFinder

2010-04-30T22:35:56Z

Troycheek:

[[Engine_Development|Development]] < [[Lua_Scripting|Lua Scripting]] < {{FULLPAGENAME}}

== PathFinder ==
'''Spring.RequestPath'''
( string "MoveTypeName" | number moveID,
number start_x, number start_y, number start_z,
number end_x, number end_y, number end_z
[, number radius = 8 ]
) -> nil | pathObject path (see below)

== Path UserData Object ==
'''Path:GetEstimatedPath'''
( ) -> nil | {
[1] = { x,y,z }, ...
},{
[1] = startIdxOfDetailedPath,
[2] = startIdxOfDetailedEstimatedPath1,
[3] = startIdxOfDetailedEstimatedPath2,
}
GetEstimatedPath() returns 2 tables:
1 table with the waypoints and 1 table with 3 indices (in the waypoint table)
when a new (more lazy) pathfinding algorithm begins.
So the waypoint table contains 3 different levels of details.

'''Path:Next'''
( number pos_x, number pos_y, number pos_z,
[, number radius = 0 ]
) -> nil | number x, number y, number z

Note that ''Path'' in ''Path:GetEstimatedPath'' and ''Path:Next'' is not part of the command, but rather a reference to the path Object created by ''Spring.RequestPath''. It must match the path Object (case sensitive).

[[category: Lua]]

Lua PathFinder

2010-04-30T12:12:34Z

Troycheek: changed bellow to below

Lua PathFinder

2010-04-30T12:10:42Z

Troycheek: changed GetUnitEstimatedPath to GetEstimatedPath