Empires Scripting - Revision history

Andrewg: Andrewg moved page AEP Scripting to Empires Scripting

2019-07-08T20:03:41Z

Andrewg moved page AEP Scripting to Empires Scripting

← Older revision	Revision as of 20:03, 8 July 2019
(No difference)

Andrewg at 20:03, 8 July 2019

2019-07-08T20:03:17Z

← Older revision		Revision as of 20:03, 8 July 2019
Line 46:		Line 46:
	=== GetRouteEx ===		=== GetRouteEx ===

			GetRouteEx is a more advanced way to access pathfinding, GetRouteEx(sourceRegion, destRegion, [dynArrayHandle], [maxCost], [callback], [data...]).

			The primary difference is that the name of the callback function can be provided to GetRouteEx. The first parameter to the callback function will always be the region ID that data is requested for, all additional integer parameters will be passed through from the GetRouteExcall to the callback. Also, it uses a dynamic array for results (you can pass a dynamic array handle of 0 to get the cost of the route if you do not require the route itself). Finally, it take a maximum cost like GetRouteWithLimit (or <= 0 if cost is unlimited).

	~~=== GetRegionsInRange ===~~		For example, to get the optimal path from startID to destID up to a cost of 12 using the same callback as GetRoute uses:

	~~Pathfinding can also be used to find a list of regions in range of another. The entry point for this is GetRegionsInRange(sourceRegion, maxCost, dynArrayHandle, [callback]~~, ~~[data...]).~~

	~~Similar to GetRoute, evaluating a GetRegionsInRange request will result in a number of calls to a callback function which must call SetPathfindingData to provide costs~~ to the engine. The difference is that the name of the callback function can be provided to GetRegionsInRange. The first parameter to the callback function will always be the region ID that data is requested for, all additional integer parameters will be passed through from ~~the GetRegionsInRange call~~ to ~~the callback.~~

	~~For example,~~ to ~~get all regions within~~ a cost of 12 ~~of startID~~ using the same callback as GetRoute uses:
	handle = CreateDyamicArray();		handle = CreateDyamicArray();
	~~GetRegionsInRange~~(startID, 12, handle, "PathfindingData", groupID);		GetRouteEx(startID, destID, 12, handle, "PathfindingData", groupID);
	...		...
	DestroyDynamicArray(handle);		DestroyDynamicArray(handle);
Line 69:		Line 65:
	}		}
	And then provide the name and expected parameters to the search:		And then provide the name and expected parameters to the search:
	~~GetRegionsInRange~~(startID, 12, handle, "PathfindingDataByKind", kind, factionID);		GetRouteEx(startID, destID, 12, handle, "PathfindingDataByKind", kind, factionID);

	If the callback name and parameters are omitted, the search will be done without script callbacks based on the Connections attribute of the regions with a fixed cost of 1 for each step.		If the callback name and parameters are omitted, the search will be done without script callbacks based on the Connections attribute of the regions with a fixed cost of 1 for each step.

			=== GetRegionsInRange ===

			Pathfinding can also be used to find a list of regions in range of another. The entry point for this is GetRegionsInRange(sourceRegion, maxCost, dynArrayHandle, [callback], [data...]).

			The parameters have the same meaning as in GetRouteEx. For example, to get all regions within a cost of 12 of startID using the same callback as GetRoute uses:
			handle = CreateDyamicArray();
			GetRegionsInRange(startID, 12, handle, "PathfindingData", groupID);
			...
			DestroyDynamicArray(handle);

Andrewg at 18:43, 8 July 2019

2019-07-08T18:43:52Z

← Older revision		Revision as of 18:43, 8 July 2019
Line 1:		Line 1:
	See My Games\~~<Game Name>~~\AUTODOCS\BATTLESCRIPT.TXT for definitive script command descriptions.		See the general [[Scripting]] page for a description of the Archon scripting language. See My Games\FieldOfGloryEmpires\AUTODOCS\BATTLESCRIPT.TXT for definitive script command descriptions relevant to Empires.

	Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).		Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).
Line 43:		Line 43:

	There is an alternate version of the command, GetRouteWithLimit, that takes a maximum cost which can be more efficient when long routes are not of interest.		There is an alternate version of the command, GetRouteWithLimit, that takes a maximum cost which can be more efficient when long routes are not of interest.

			=== GetRouteEx ===



	=== GetRegionsInRange ===		=== GetRegionsInRange ===

Andrewg: /* GetRegionsInRange */

2017-06-07T20:15:56Z

GetRegionsInRange

← Older revision		Revision as of 20:15, 7 June 2017
Line 57:		Line 57:

	To use a callback that uses different criteria or a different calculation, define another callback function:		To use a callback that uses different criteria or a different calculation, define another callback function:
	FUNCTION PathfindingDataByKind(regionID, kind, faction)		FUNCTION PathfindingDataByKind(regionID, neighbourID, kind, faction)
	{		{
	~~int i;~~
	~~int neighbour;~~
	int cost;		int cost;
	~~int count;~~

	~~count = GetRegionInt(region, $REGION_CONNECTIONCOUNT);~~		cost = myCost(neighbourID, kind, faction);
	~~for (i = 0; i < count; i++)~~		SetPathfindingData(regionID, neighbourID, cost);
	{
	~~neighbour = GetRegionInt(region, $REGION_CONNECTIONS, i);~~
	cost = myCost(~~regionID~~, kind, faction);
	SetPathfindingData(~~region~~, ~~neighbour~~, cost);
	}
	}		}
	And then provide the name and expected parameters to the search:		And then provide the name and expected parameters to the search:

Andrewg: /* Pathfinding */

2017-06-07T20:13:37Z

Pathfinding

← Older revision		Revision as of 20:13, 7 June 2017
Line 29:		Line 29:
	\| / \| \		\| / \| \
	\| v v v		\| v v v
	\| PathfindingData(region, groupID, ...) Map.BSF function		\| PathfindingData(region, neighbour, groupID, ...) Map.BSF function
	\| / \| \		\| \|
	\| ~~v v~~ v		\| v
	\| SetPathfindingData(region, neighbour, cost) BATTLESCRIPT command		\| SetPathfindingData(region, neighbour, cost, [speed]) BATTLESCRIPT command
	\|		\|
	\-> GetRoute returns total cost		\-> GetRoute returns total cost

	PathfindingData is a function implemented in Map.BSF that tells the engine ~~which regions are connected to the requested region and~~ the cost of moving to them. Simple calculations based on region and group properties can be used to determine the cost. PathfindingData ~~must call~~ SetPathfindingData ~~for each neighbour connected~~ to the ~~region~~. It is possible to pass additional parameters to the PathfindingData callback by adding more parameters to the function, and then padding them as additional parameters to GetRoute after the groupID.		PathfindingData is a function implemented in Map.BSF that tells the engine the cost of moving from one region to its neighbour them. Simple calculations based on region and group properties can be used to determine the cost. PathfindingData calls SetPathfindingData to return the cost and, optionally the speed used to take the step, if it is valid in the situation. The base connection graph is determined internally based on the $REGION_CONNECTIONS attribute and assuming that legal movement costs are always > 0. It is possible to pass additional parameters to the PathfindingData callback by adding more parameters to the function, and then padding them as additional parameters to GetRoute after the groupID.

	Internally, data is cached so that if you make consecutive calls to GetRoute for the same startRegion and groupID within the same frame, the result will be found much faster. A loop with one ~~unit~~ evaluating N destinations will be much faster than N ~~units~~ evaluating one destination.		Internally, data is cached so that if you make consecutive calls to GetRoute for the same startRegion and groupID within the same frame, the result will be found much faster. A loop with one group evaluating N destinations will be much faster than N groups evaluating one destination.

			If non-zero speeds are provided to SetPathfindingData, the engine will include the calculation of unused movement points not carried over between turns in the cost. The speed expected is the speed used if a turn starts in 'region', pathfinding internally will determine whether to use that speed or continue with the previous speed.

			There is an alternate version of the command, GetRouteWithLimit, that takes a maximum cost which can be more efficient when long routes are not of interest.

	=== GetRegionsInRange ===		=== GetRegionsInRange ===

Andrewg at 23:23, 15 November 2016

2016-11-15T23:23:44Z

← Older revision		Revision as of 23:23, 15 November 2016
Line 3:		Line 3:
	Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).		Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).

	= Pathfinding =		== Pathfinding ==

	== GetRoute ==		=== GetRoute ===

	The main entry point is GetRoute(startRegion, destRegion, workArray, groupID, ...). It returns the total cost of the route and the route itself is stored in the temporary work array. The steps in the route are accessed using GetArray(step). For example to get the route from current to destination into the array route:		The main entry point is GetRoute(startRegion, destRegion, workArray, groupID, ...). It returns the total cost of the route and the route itself is stored in the temporary work array. The steps in the route are accessed using GetArray(step). For example to get the route from current to destination into the array route:
Line 40:		Line 40:
	Internally, data is cached so that if you make consecutive calls to GetRoute for the same startRegion and groupID within the same frame, the result will be found much faster. A loop with one unit evaluating N destinations will be much faster than N units evaluating one destination.		Internally, data is cached so that if you make consecutive calls to GetRoute for the same startRegion and groupID within the same frame, the result will be found much faster. A loop with one unit evaluating N destinations will be much faster than N units evaluating one destination.

	== GetRegionsInRange ==		=== GetRegionsInRange ===

	Pathfinding can also be used to find a list of regions in range of another. The entry point for this is GetRegionsInRange(sourceRegion, maxCost, dynArrayHandle, [callback], [data...]).		Pathfinding can also be used to find a list of regions in range of another. The entry point for this is GetRegionsInRange(sourceRegion, maxCost, dynArrayHandle, [callback], [data...]).

Andrewg at 23:21, 15 November 2016

2016-11-15T23:21:40Z

← Older revision		Revision as of 23:21, 15 November 2016
Line 2:		Line 2:

	Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).		Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).

			= Pathfinding =

			== GetRoute ==

			The main entry point is GetRoute(startRegion, destRegion, workArray, groupID, ...). It returns the total cost of the route and the route itself is stored in the temporary work array. The steps in the route are accessed using GetArray(step). For example to get the route from current to destination into the array route:

			int route[32];
			int i;
			cost = GetRoute(current, destination, 0, group);
			if (cost >= 0)
			{
			for (i = 0; i < 32; i++)
			{
			route[i] = GetArray(i);
			if (route[i] == -1)
			{
			i = 32; // done
			}
			}
			}

			Internally, there are a number of callbacks during pathfinding so that the costs can be dynamically determined by scripts. The sequence is something like this:

			/- GetRoute(startRegion, targetRegion, workArray, groupID, ...) BATTLESCRIPT command
			\| / \| \
			\| v v v
			\| PathfindingData(region, groupID, ...) Map.BSF function
			\| / \| \
			\| v v v
			\| SetPathfindingData(region, neighbour, cost) BATTLESCRIPT command
			\|
			\-> GetRoute returns total cost

			PathfindingData is a function implemented in Map.BSF that tells the engine which regions are connected to the requested region and the cost of moving to them. Simple calculations based on region and group properties can be used to determine the cost. PathfindingData must call SetPathfindingData for each neighbour connected to the region. It is possible to pass additional parameters to the PathfindingData callback by adding more parameters to the function, and then padding them as additional parameters to GetRoute after the groupID.

			Internally, data is cached so that if you make consecutive calls to GetRoute for the same startRegion and groupID within the same frame, the result will be found much faster. A loop with one unit evaluating N destinations will be much faster than N units evaluating one destination.

			== GetRegionsInRange ==

			Pathfinding can also be used to find a list of regions in range of another. The entry point for this is GetRegionsInRange(sourceRegion, maxCost, dynArrayHandle, [callback], [data...]).

			Similar to GetRoute, evaluating a GetRegionsInRange request will result in a number of calls to a callback function which must call SetPathfindingData to provide costs to the engine. The difference is that the name of the callback function can be provided to GetRegionsInRange. The first parameter to the callback function will always be the region ID that data is requested for, all additional integer parameters will be passed through from the GetRegionsInRange call to the callback.

			For example, to get all regions within a cost of 12 of startID using the same callback as GetRoute uses:
			handle = CreateDyamicArray();
			GetRegionsInRange(startID, 12, handle, "PathfindingData", groupID);
			...
			DestroyDynamicArray(handle);

			To use a callback that uses different criteria or a different calculation, define another callback function:
			FUNCTION PathfindingDataByKind(regionID, kind, faction)
			{
			int i;
			int neighbour;
			int cost;
			int count;

			count = GetRegionInt(region, $REGION_CONNECTIONCOUNT);
			for (i = 0; i < count; i++)
			{
			neighbour = GetRegionInt(region, $REGION_CONNECTIONS, i);
			cost = myCost(regionID, kind, faction);
			SetPathfindingData(region, neighbour, cost);
			}
			}
			And then provide the name and expected parameters to the search:
			GetRegionsInRange(startID, 12, handle, "PathfindingDataByKind", kind, factionID);

			If the callback name and parameters are omitted, the search will be done without script callbacks based on the Connections attribute of the regions with a fixed cost of 1 for each step.

Andrewg: Created page with "See My Games\\AUTODOCS\BATTLESCRIPT.TXT for definitive script command descriptions. Also output to the AUTODOCS folder is ARCHON.XML, a language definition compati..."

2016-10-06T23:28:56Z

Created page with "See My Games\<Game Name>\AUTODOCS\BATTLESCRIPT.TXT for definitive script command descriptions. Also output to the AUTODOCS folder is ARCHON.XML, a language definition compati..."

New page

See My Games\<Game Name>\AUTODOCS\BATTLESCRIPT.TXT for definitive script command descriptions.

Also output to the AUTODOCS folder is ARCHON.XML, a language definition compatible with Notepad++ (note that if the language definition is updated, the defined language must be removed and re-imported into Np++, it will not reload it automatically).