Class TrainzGameObject

Revision as of 11:43, 26 February 2024

• API Hierarchy
  • GSObject
    • GameObject
      • Class TrainzGameObject

• Base class for a GameObject that is an instance of a Trainz asset.

Init

Parameters

• asset = Reference to the script's associated asset.

Returned Value

• None

Syntax

• None, method is automatically called by the game.

Notes

• Initialisation method which is called by Trainz when the object is first created.
• It is up to the script programmer to do any initialization tasks required here.
• This may include starting monitor threads, adding message handlers, and so on.
• Some derived classes have both an Init() and Init(Asset) method. It is recommended that you use the Init(Asset) version whenever you can.
• Uses the 'mandatory' keyword, meaning you must call inherited() when overriding this function.
• Since Init() is called from native Trainz code, you cannot use Sleep() or wait(). However, Init() can start threaded methods that are allowed to sleep and process messages.

GetAsset

Parameters

• None

Returned Value

• A reference to the owning asset.

Syntax

Asset asset = GetAsset();

Notes

• The returned Asset reference can be used to retrieve the KUID, StringTable or configuration data of the Asset.

IssueSecurityToken

Parameters

• asset - The asset this token is intended to be used by.
• rights - Array of string identifiers specifying the operations permitted by this token.

Returned Value

• The issued SecurityToken.

Syntax

KUID friendlyAsset = GetAsset().LookupKUIDTable("some-asset");

string[] rights = new string[2];
rights[0] = "edit-settings";
rights[1] = "access-data";

SecurityToken token = IssueSecurityToken(friendlyAsset, rights);

Notes

• Creates a SecurityToken object which can be issued to other assets to grant access to certain features.
• The created SecurityToken can be given to trusted objects, and later passed to the Validate() function when checking permissions.
• SecurityToken.IsIsOwnerLocallyModified() can be used to check the issued asset hasn't been modified in some form.

IssueSecurityToken

MergeSecurityTokens

Validate

Validate

Categories