Dominion Land System (Road Pathfinder) More...

Classes
class	Info

Public Member Functions
function	SetDatum (NewDatum)
	Sets network Datum.
function	GetDatum ()
	Returns the currently set Datum.
function	IsGridPoint (Point)
	Is the tile given a grid point.
function	GridPoints (End1, End2)
	Get all the grid points between two tiles.
function	AllGridPoints ()
	Get all grid points.
function	FindPath (cycles=10000)
	Run the pathfinder.
function	InitializePath (StartArray, EndArray)
	Initializes the pathfinder.
function	BuildPath ()
	Build the path.
function	InitializePathOnTowns (StartTown, EndTown)
	Initializes the pathfinder using two towns.
function	GetPath ()
	Returns the path stored by the pathfinder.
function	GetPathLength ()
	Returns the length of the path stored by the pathfinder.
function	PathToTilePairs ()
	Convert the path to tile pairs.
function	PathToTiles ()
	Get all the tiles in the path.
function	TilePairsToBuild ()
	Get the road tile pairs that need built.
function	GetBuildCost ()
	Determine how much it will cost to build the path.
function	PresetOriginal ()
function	PresetPerfectPath ()
function	PresetQuickAndDirty ()
function	PresetCheckExisting ()
function	PresetPresetMode6 ()
function	PresetPresetStreetcar ()

Private Member Functions
	constructor ()

Private Attributes
	_grid_x = null
	Grid spacing in x direction (default is 8 tiles)
	_grid_y = null
	Grid spacing in y direction (default is 8 tiles)
	_datum = null
	This is the 'centre' of our survey system.
	_base_datum = null
	this is the 'grid point' closest to 0,0
	_pathfinder = null
	the pathfinder itself
	_start_tile = null
	starting tile
	_end_tile = null
	ending tile
	_path = null
	used to store that path as a array of tile pairs
	_running = null
	Is the pathfinder currently running?
	_road_type = null
	See http://noai.openttd.org/api/trunk/classAIRoad.html

Detailed Description

Dominion Land System (Road Pathfinder)

Version: v.1.1 (2013-01-01)

Author: W. Minchin (MinchinWeb)

Since: MetaLibrary v.6

Dominion Land System refers to the system of survey in Western Canada. Land was surveyed into 1/2 mile x 1/2 mile "quarter sections" that would be sold to settlers (around 1905, the price was $10). Roads were placed on a 1 mile x 2 mile grid along the edges of these quarter sections.

Here, we follow the same idea, although on a square grid. The default grid is 8x8 tiles. This is designed to run as a wrapper on the main road pathfinder.

Depends On:\n Pathfinder.Road.nut

See also: _MinchinWeb_RoadPathfinder_

Definition at line 63 of file Dominion.Roads.nut.

Member Function Documentation

◆ AllGridPoints()

function _MinchinWeb_DLS_::AllGridPoints ( )

Get all grid points.

Returns: An array of all the 'grid points' on the map

Definition at line 330 of file Dominion.Roads.nut.

◆ BuildPath()

function _MinchinWeb_DLS_::BuildPath ( )

Build the path.

Note: requires that the path has already been found.

See also: FindPath()

Definition at line 399 of file Dominion.Roads.nut.

◆ constructor()

_MinchinWeb_DLS_::constructor ( )

inlineprivate

Definition at line 75 of file Dominion.Roads.nut.

◆ FindPath()

function _MinchinWeb_DLS_::FindPath ( cycles = 10000 )

Run the pathfinder.

Parameters

cycles number of iterations to run before returning.

Returns: True when the path is found

See also: BuildPath(); GetPath()

Note: The path must be initialized before it can be run.

See also: InitializePath(); InitializePathOnTowns()

Todo: stop ignoring the passed parameter of cycles

Definition at line 335 of file Dominion.Roads.nut.

◆ GetBuildCost()

function _MinchinWeb_DLS_::GetBuildCost ( )

Determine how much it will cost to build the path.

Turns to 'test mode,' builds the route provided, and returns the cost.

Returns: The build cost, in British Pounds.; False if the test build fails somewhere.

Note: Note that due to inflation, this value can get stale.

Definition at line 550 of file Dominion.Roads.nut.

◆ GetDatum()

function _MinchinWeb_DLS_::GetDatum ( )

inline

Returns the currently set Datum.

Returns: The current Datum (as a TileIndex)

Note: In surveying, a 'datum' is where all other points are measured from.

Definition at line 99 of file Dominion.Roads.nut.

◆ GetPath()

function _MinchinWeb_DLS_::GetPath ( )

Returns the path stored by the pathfinder.

Definition at line 478 of file Dominion.Roads.nut.

◆ GetPathLength()

function _MinchinWeb_DLS_::GetPathLength ( )

Returns the length of the path stored by the pathfinder.

Returns: The length of the path in tiles.

Definition at line 487 of file Dominion.Roads.nut.

◆ GridPoints()

function _MinchinWeb_DLS_::GridPoints	(	End1	,
		End2	)

Get all the grid points between two tiles.

Parameters

End1	expected to be a TileIndex
End2	expected to be a TileIndex

Returns: An array of TileIndexes that are 'grid points' or where roads will have intersections.

Note: End1 and End2 will NOT be included in the return array.

Definition at line 272 of file Dominion.Roads.nut.

◆ InitializePath()

function _MinchinWeb_DLS_::InitializePath	(	StartArray	,
		EndArray	)

Initializes the pathfinder.

Parameters

StartArray	the first item assumed be a TileIndex, the of the items in the array are ignored.
EndArray	the first item assumed be a TileIndex, the of the items in the array are ignored.

Definition at line 391 of file Dominion.Roads.nut.

◆ InitializePathOnTowns()

function _MinchinWeb_DLS_::InitializePathOnTowns	(	StartTown	,
		EndTown	)

Initializes the pathfinder using two towns.

Parameters

StartTown	Assumed to be a TownID
EndTown	Assumed to be a TownID

Note: This assumes that the town centres are road tiles (if this is not the case, the pathfinder will still run, but it will take a long time and eventually fail to return a path). This is not typically an issue because on map generation, the centre of each town is a road tile.

Definition at line 470 of file Dominion.Roads.nut.

◆ IsGridPoint()

function _MinchinWeb_DLS_::IsGridPoint ( Point )

Is the tile given a grid point.

Returns: True if and only if Point is a gird point; False otherwise.

Definition at line 263 of file Dominion.Roads.nut.

◆ PathToTilePairs()

function _MinchinWeb_DLS_::PathToTilePairs ( )

Convert the path to tile pairs.

Returns: A 2D array that has each pair of tiles that the path joins.

See also: TileParisToBuild()

Definition at line 506 of file Dominion.Roads.nut.

◆ PathToTiles()

function _MinchinWeb_DLS_::PathToTiles ( )

inline

Get all the tiles in the path.

Returns: A 1D array of the tiles in the path

Definition at line 176 of file Dominion.Roads.nut.