Script Include Directive - Revision history

Ek.skirl: /* LibraryCall */

2023-08-21T16:06:06Z

LibraryCall

← Older revision		Revision as of 16:06, 21 August 2023
Line 10:		Line 10:
	'''''TBD: Searchpath while including'''''		'''''TBD: Searchpath while including'''''

	=== LibraryCall ===		=== LibraryCall methode ===
	The second example uses the LibraryCall method. The config.txt connects the library assets within the kuid-table. Here we use two libraries A and B.		The second example uses the LibraryCall method. The config.txt connects the library assets within the kuid-table. Here we use two libraries A and B.

Ek.skirl: /* Example */

2023-08-21T14:21:05Z

Example

@@ Line 4: / Line 4: @@
 == Example ==
-TBD.
+=== Include "scriptname.gs"  ===
 == Cross-Asset Includes ==

Windwalkr at 05:50, 18 January 2014

2014-01-18T05:50:38Z

← Older revision		Revision as of 05:50, 18 January 2014
Line 13:		Line 13:
	This will then allow you to call public functions in the library directly without needing to use the [[Class Library#LibraryCall\|Library.LibraryCall()]] syntax.		This will then allow you to call public functions in the library directly without needing to use the [[Class Library#LibraryCall\|Library.LibraryCall()]] syntax.

	~~Assets~~ referenced through a script-include-table must already exist on the DLS or contained in the same package (cdp) being uploaded to the DLS.		Note: When uploading a scripted asset to the Download Station, any dependency assets referenced through a script-include-table must already exist on the DLS or else must be contained in the same package (cdp) being uploaded to the DLS. The DLS will reject the upload of any asset where the necessary script dependencies are not present.

	== Circular Includes ==		== Circular Includes ==

Pcas1986: /* Categories */

2014-01-17T04:29:02Z

Pcas1986: /* Cross-Asset Includes */ Added note about referenced assets.

2014-01-17T04:23:35Z

Cross-Asset Includes: Added note about referenced assets.

← Older revision		Revision as of 04:23, 17 January 2014
Line 12:		Line 12:

	This will then allow you to call public functions in the library directly without needing to use the [[Class Library#LibraryCall\|Library.LibraryCall()]] syntax.		This will then allow you to call public functions in the library directly without needing to use the [[Class Library#LibraryCall\|Library.LibraryCall()]] syntax.

			Assets referenced through a script-include-table must already exist on the DLS or contained in the same package (cdp) being uploaded to the DLS.

	== Circular Includes ==		== Circular Includes ==

Mjolnir at 11:27, 10 July 2013

2013-07-10T11:27:17Z

← Older revision		Revision as of 11:27, 10 July 2013
Line 23:		Line 23:

	The content creator must avoid any situation in which multiple script files (regardless of the file name) which define same-named script classes are included at the same time. The outcome is undefined.		The content creator must avoid any situation in which multiple script files (regardless of the file name) which define same-named script classes are included at the same time. The outcome is undefined.

			== Categories ==

			[[Category:TBD]]

Jamesmoody at 10:29, 12 February 2013

2013-02-12T10:29:19Z

← Older revision		Revision as of 10:29, 12 February 2013
Line 11:		Line 11:
	Script files from other assets can be included through the use of an [[KIND TrainzBaseSpec#script-include-table\|"script-include-table"]] tag in the parent asset's [[config.txt file]]. This causes the asset to become dependant on the specified child assets, and makes it possible to directly include the child assets' script file(s) from the parent asset's script file(s). If the child asset is a [[KIND Library]], the parent asset may use [[Class World#GetLibrary\|World.GetLibrary()]] to gain a reference to the library, as demonstrated [[Class Library#Client Configuration\|here]].		Script files from other assets can be included through the use of an [[KIND TrainzBaseSpec#script-include-table\|"script-include-table"]] tag in the parent asset's [[config.txt file]]. This causes the asset to become dependant on the specified child assets, and makes it possible to directly include the child assets' script file(s) from the parent asset's script file(s). If the child asset is a [[KIND Library]], the parent asset may use [[Class World#GetLibrary\|World.GetLibrary()]] to gain a reference to the library, as demonstrated [[Class Library#Client Configuration\|here]].

			This will then allow you to call public functions in the library directly without needing to use the [[Class Library#LibraryCall\|Library.LibraryCall()]] syntax.

	== Circular Includes ==		== Circular Includes ==

Windwalkr: Created page with "A script written in the TrainzScript language is stored in one or more ".gs" files within an asset. One of these script, referred to as the asset's "primary sc..."

2013-02-10T11:26:00Z

Created page with "A script written in the TrainzScript language is stored in one or more ".gs" files within an asset. One of these script, referred to as the asset's "primary sc..."

New page

A script written in the [[TrainzScript]] language is stored in one or more [[GS file|".gs" files]] within an asset. One of these script, referred to as the asset's "primary script", is referenced from the asset's [[config.txt file]]. Any additional ".gs" files within the asset may then be referenced from within a script file by using the "include" directive.

== Example ==

TBD.

== Cross-Asset Includes ==

Script files from other assets can be included through the use of an [[KIND TrainzBaseSpec#script-include-table|"script-include-table"]] tag in the parent asset's [[config.txt file]]. This causes the asset to become dependant on the specified child assets, and makes it possible to directly include the child assets' script file(s) from the parent asset's script file(s). If the child asset is a [[KIND Library]], the parent asset may use [[Class World#GetLibrary|World.GetLibrary()]] to gain a reference to the library, as demonstrated [[Class Library#Client Configuration|here]].

== Circular Includes ==

Circular inclusion is not permitted. Examples of circular inclusion are "A includes B includes A" or "A includes B includes C includes A" (where A, B, C are script files.)

== Scripts with Identical Names ==

The content creator must avoid any situation in which multiple script files (at different file paths) have the same file name. The outcome is undefined.

The content creator must avoid any situation in which multiple script files (regardless of the file name) which define same-named script classes are included at the same time. The outcome is undefined.

← Older revision		Revision as of 04:29, 17 January 2014
Line 28:		Line 28:
	== Categories ==		== Categories ==

	[[Category:~~TBD~~]]		[[Category:TrainzScript]]