HowTo/Read string table or Config text - Revision history

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-03T09:48:49Z

Reading the string table or configtext of another object

← Older revision		Revision as of 09:48, 3 November 2025
Line 82:		Line 82:
	thread void ReadConfigFile(void);		thread void ReadConfigFile(void);

	public void Init (~~void) //Note that here we don't need to use the formula "~~Asset asset~~'. A simple a 'void' will be enough, since we don't need~~		public void Init (Asset asset)
	{ ~~//to guarantee an access to the configfile of our object : we will read the configfile of another object.~~		{
	inherited();		inherited(asset);
	ReadConfigFile();		ReadConfigFile();
	}		}

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-03T04:04:36Z

Reading the string table or configtext of another object

← Older revision		Revision as of 04:04, 3 November 2025
Line 101:		Line 101:
	string Coupling = stringTable.GetString("coupler"); //In that string-table, read the line 'coupler' to get the associated string (e.g. 'animated' or 'not animated')<br>		string Coupling = stringTable.GetString("coupler"); //In that string-table, read the line 'coupler' to get the associated string (e.g. 'animated' or 'not animated')<br>
	}		}
	//Read the configtext :		//Read the configtext :
	int i;		int i;
	for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]		for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-03T04:02:54Z

Reading the string table or configtext of another object

← Older revision		Revision as of 04:02, 3 November 2025
Line 56:		Line 56:
	== Reading the string table or configtext of another object ==		== Reading the string table or configtext of another object ==

	This time, the ~~config file~~ of the second object is not directly accessible. We have to introduce an additional step.		This time, the string-table or the configtext of the second object is not directly accessible. We have to introduce an additional step.

	After the mandatory 'Init (Asset asset)....', we have to launch an asynchronous query to cache the config file of the second object. But don't worry, it's finally quite simple.		After the mandatory 'Init (Asset asset)....', we have to launch an asynchronous query to cache the config file of the second object. But don't worry, it's finally quite simple.

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-03T04:01:39Z

Reading the string table or configtext of another object

← Older revision		Revision as of 04:01, 3 November 2025
Line 65:		Line 65:
	asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the query to be completed		asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the query to be completed
	string ExtractFromStringTable=SecondObject.GetAsset().GetStringTableCached().GetString("string0"); //Reads a string 'string0' into the string table of the second object		string ExtractFromStringTable=SecondObject.GetAsset().GetStringTableCached().GetString("string0"); //Reads a string 'string0' into the string table of the second object
			Soup SecondObjectconfigSoup = SecondObject.GetAsset().GetConfigSoupCached().GetNamedTag("xxx"); //Reads the tag 'xxx' into the configtext of the second object

	To note :		To note :
Line 73:		Line 74:


	Here an exemple of implementation, with a loco that needs to read the ~~config file~~ of the cars of its train.		Here an exemple of implementation, with a loco that needs to read the string-table or the configtext of the cars of its train.

	include "locomotive.gs"		include "locomotive.gs"
Line 90:		Line 91:
	{		{
	Train mytrain = me.GetMyTrain(); //Gets the train to which the loco belongs		Train mytrain = me.GetMyTrain(); //Gets the train to which the loco belongs
	Vehicle[]vehicles = mytrain.GetVehicles(); //Makes up a list of the cars in this train, including the loco		Vehicle[]vehicles = mytrain.GetVehicles(); //Makes up a list of the cars in this train, including the loco<br>
			//Read the string table :
	int i;		int i;
	for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]		for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]
Line 97:		Line 99:
	asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the result (infinitesimal on a human scale)		asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the result (infinitesimal on a human scale)
	StringTable stringTable = vehicles[i].GetAsset().GetStringTableCached(); //Gets the cached string-table of the car[i]		StringTable stringTable = vehicles[i].GetAsset().GetStringTableCached(); //Gets the cached string-table of the car[i]
	string Coupling = stringTable.GetString("coupler"); //In that string-table, read the line 'coupler' to get the associated string (e.g. 'animated' or 'not animated')		string Coupling = stringTable.GetString("coupler"); //In that string-table, read the line 'coupler' to get the associated string (e.g. 'animated' or 'not animated')<br>
	}		}
			//Read the configtext :
			int i;
			for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]
			{ //We assume that the loco is in front of train (i=0) ; so the first car should correspond to the i=1 vehicle.
			AsyncQueryHelper asyncqueryhelper = vehicles[i].GetAsset().CacheConfigSoup(); //Starts a query to cache the config file of the car[i]
			asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the result (infinitesimal on a human scale)
			Soup VehicleconfigSoup = vehicles[i].GetAsset().GetConfigSoupCached(); //Gets the cached configtext as a Soup of the car[i]
			string Script = VehicleconfigSoup.GetNamedTag("script"); //Read the tag 'script' in the configtext and return the name of this script
			}
	}		}
	};		};

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-02T21:16:08Z

Reading the string table or configtext of another object

← Older revision		Revision as of 21:16, 2 November 2025
Line 62:		Line 62:
	Here are the codes to implement :		Here are the codes to implement :

	~~Asyncqueryhelper~~ asyncqueryhelper = SecondObject.GetAsset().CacheConfigSoup(); //Starts a query to cache the config file of the second object		AsyncQueryHelper asyncqueryhelper = SecondObject.GetAsset().CacheConfigSoup(); //Starts a query to cache the config file of the second object
	asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the query to be completed		asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the query to be completed
	string ExtractFromStringTable=SecondObject.GetAsset().GetStringTableCached().GetString("string0"); //Reads a string 'string0' into the string table of the second object		string ExtractFromStringTable=SecondObject.GetAsset().GetStringTableCached().GetString("string0"); //Reads a string 'string0' into the string table of the second object

Vincentrh: /* Reading the string table or configtext of another object */

2025-11-02T21:14:03Z

Reading the string table or configtext of another object

← Older revision		Revision as of 21:14, 2 November 2025
Line 94:		Line 94:
	for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]		for(i=1; i<vehicles.size();i++) //Inspects each car of the train vehicle[0], vehicle[1],....vehicle[i]
	{ //We assume that the loco is in front of train (i=0) ; so the first car should correspond to the i=1 vehicle.		{ //We assume that the loco is in front of train (i=0) ; so the first car should correspond to the i=1 vehicle.
	~~Asyncqueryhelper~~ asyncqueryhelper = ~~vehicle~~[i].GetAsset().CacheConfigSoup(); //Starts a query to cache the config file of the car[i]		AsyncQueryHelper asyncqueryhelper = vehicles[i].GetAsset().CacheConfigSoup(); //Starts a query to cache the config file of the car[i]
	asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the result (infinitesimal on a human scale)		asyncqueryhelper.SynchronouslyWaitForResults("AsyncResult"); //Waits for the result (infinitesimal on a human scale)
	StringTable stringTable = vehicles[i].GetAsset().GetStringTableCached(); //Gets the cached string-table of the car[i]		StringTable stringTable = vehicles[i].GetAsset().GetStringTableCached(); //Gets the cached string-table of the car[i]

Vincentrh at 11:59, 11 August 2023

2023-08-11T11:59:36Z

← Older revision		Revision as of 11:59, 11 August 2023
Line 1:		Line 1:
	This page is the continuation of the ~~How To~~/Upgrade obsolete script functions.		This page is the continuation of the [[HowTo/Upgrade obsolete script functions]]

	More precisely, it's about the new method to read the config file of an object, and thus its string table or another element of its configtext. Two cases are presented to us : the reading concerns the own string table or configtext of an object (in Trainz, an asset), or we want to read the same thing from an object into another object.		More precisely, it's about the new method to read the config file of an object, and thus its string table or another element of its configtext. Two cases are presented to us : the reading concerns the own string table or configtext of an object (in Trainz, an asset), or we want to read the same thing from an object into another object.

Vincentrh: /* Reading the string table or configtext of another object */

2023-05-22T07:42:33Z

Reading the string table or configtext of another object

← Older revision		Revision as of 07:42, 22 May 2023
Line 81:		Line 81:
	thread void ReadConfigFile(void);		thread void ReadConfigFile(void);

	public void Init (void)		public void Init (void) //Note that here we don't need to use the formula "Asset asset'. A simple a 'void' will be enough, since we don't need
	{		{ //to guarantee an access to the configfile of our object : we will read the configfile of another object.
	inherited();		inherited();
	ReadConfigFile();		ReadConfigFile();

Vincentrh at 15:26, 20 May 2023

2023-05-20T15:26:46Z

← Older revision		Revision as of 15:26, 20 May 2023
Line 11:		Line 11:
	{		{
	inherited(asset);		inherited(asset);
	}		}

	This method gets the asset subject of this script as a parameter. This guarantees that the config file is already available for reading.		This method gets the asset subject of this script as a parameter. This guarantees that the config file is already available for reading.

Line 26:		Line 25:
	Here is a basic exemple.		Here is a basic exemple.

	Assume we have an object whith this string-table:		Assume we have an object whith this string-table :

	String-table		String-table

Vincentrh at 15:21, 20 May 2023

2023-05-20T15:21:31Z

← Older revision		Revision as of 15:21, 20 May 2023
Line 1:		Line 1:
	This page is the continuation of the How To/Upgrade obsolete script functions.		This page is the continuation of the How To/Upgrade obsolete script functions.

	More precisely, it's about the new method to read the ~~congig~~ file of an object, and thus its string table or another element of its configtext. Two cases are presented to us : the reading concerns the own string table or configtext of an object (in Trainz, an asset), or we want to read the same thing from an object into another object.		More precisely, it's about the new method to read the config file of an object, and thus its string table or another element of its configtext. Two cases are presented to us : the reading concerns the own string table or configtext of an object (in Trainz, an asset), or we want to read the same thing from an object into another object.