KIND Drivercommand

From TrainzOnline
(Difference between revisions)
Jump to: navigation, search
(Undo revision 18663 by Builderbob (talk))
Line 5: Line 5:
 
===Parent Classes===
 
===Parent Classes===
 
* [[KIND TrainzBaseSpec]]
 
* [[KIND TrainzBaseSpec]]
{{TBS}}
+
 
 
===Child Classes===
 
===Child Classes===
 
* ''none.''
 
* ''none.''
  
 
==Supported Tags==
 
==Supported Tags==
 +
The [[KIND Drivercommand]] [[config.txt file]] supports the following tags (in addition to the tags that are available to all assets). Each tag is shown here with its default value.
  
 
  kind "drivercommand"
 
  kind "drivercommand"
 
  supports-null-driver-character 0
 
  supports-null-driver-character 0
 +
properties-behavior no-properties
  
 
====supports-null-driver-character====
 
====supports-null-driver-character====
 
:Type: Boolean
 
:Type: Boolean
 +
:Compulsory: Yes (3.4)
 
:Desc: Order is written in such a way that it can be issued with a null driver character. If this is true, the order can be issued in surveyor.
 
:Desc: Order is written in such a way that it can be issued with a null driver character. If this is true, the order can be issued in surveyor.
 +
 +
====properties-behavior====
 +
:Type: String (enumerated)
 +
:Compulsory: Yes (4.6)
 +
:Minimum build: 4.5
 +
:Desc: Controls the behavior of the Driver Command in the 'add driver command' menu.
 +
 +
* no-properties -- The command requires no properties to be specified, and the instance will simply be created as-is.
 +
* edit-in-submenu -- The command prefers to show a submenu before the instance is created, controlling the initial configuration of the command instance. This should be used where there is only a single option to specify, where there are only a small number of choices for that option, and where a default selection would be inappropriate.
 +
* edit-after-add -- The command prefers to be edited in a popover after the instance is created. This should be used where there are multiple options to specify, or where the number of possible choices is large.
 +
 +
Note that the actual creation of the submenu and/or exposure of any properties via a popover are implemented in script. This tag simply tells Trainz what to expect so that it can display the initial menu without having to pay the cost of querying each possible script.
  
 
==Example Config.txt==
 
==Example Config.txt==
''TBD''
 
  
 +
kuid                                    <...>
 +
kind                                    "drivercommand"
 +
script                                  "DriveThruTrackmarkCommand"
 +
class                                  "DriveThruTrackmarkCommand"
 +
category-class                          "YD"
 +
supports-null-driver-character          1
 +
properties-behavior "no-properties"
 +
description                            "Drive train through a trackmark"
 +
category-region                        "US"
 +
category-era                            "2000s"
 +
trainz-build                            4.5
 +
 +
thumbnails
 +
{
 +
  0
 +
  {
 +
    image                              "DriveThruTrackmark.texture"
 +
    width                              64
 +
    height                              64
 +
  }
 +
 
 +
  1
 +
  {
 +
    image                              "thumbnail.jpg"
 +
    width                              240
 +
    height                              180
 +
  }
 +
}
 +
 +
string-table
 +
{
 +
  description                          "Drive train through a trackmark"
 +
}
 +
 +
kuid-table
 +
{
 +
  command-sounds                        <kuid:-3:10219>
 +
  sessionvariables                      <kuid:-3:10197>
 +
}
 +
 +
Note:
 +
* A 64x64 thumbnail is included for the display lists.
 +
* The KUID table includes libraries that the script relies on.
  
 
==Downloads==
 
==Downloads==
 
''Attach sample files here?''
 
''Attach sample files here?''
 
  
 
==Categories==
 
==Categories==

Revision as of 10:26, 2 May 2019

KIND Drivercommand assets are AI orders for use in sessions.

Contents

KIND Hierarchy

Parent Classes

Child Classes

  • none.

Supported Tags

The KIND Drivercommand config.txt file supports the following tags (in addition to the tags that are available to all assets). Each tag is shown here with its default value.

kind "drivercommand"
supports-null-driver-character 0
properties-behavior no-properties

supports-null-driver-character

Type: Boolean
Compulsory: Yes (3.4)
Desc: Order is written in such a way that it can be issued with a null driver character. If this is true, the order can be issued in surveyor.

properties-behavior

Type: String (enumerated)
Compulsory: Yes (4.6)
Minimum build: 4.5
Desc: Controls the behavior of the Driver Command in the 'add driver command' menu.
  • no-properties -- The command requires no properties to be specified, and the instance will simply be created as-is.
  • edit-in-submenu -- The command prefers to show a submenu before the instance is created, controlling the initial configuration of the command instance. This should be used where there is only a single option to specify, where there are only a small number of choices for that option, and where a default selection would be inappropriate.
  • edit-after-add -- The command prefers to be edited in a popover after the instance is created. This should be used where there are multiple options to specify, or where the number of possible choices is large.

Note that the actual creation of the submenu and/or exposure of any properties via a popover are implemented in script. This tag simply tells Trainz what to expect so that it can display the initial menu without having to pay the cost of querying each possible script.

Example Config.txt

kuid                                    <...>
kind                                    "drivercommand"
script                                  "DriveThruTrackmarkCommand"
class                                   "DriveThruTrackmarkCommand"
category-class                          "YD"
supports-null-driver-character          1
properties-behavior			"no-properties"
description                             "Drive train through a trackmark"
category-region                         "US"
category-era                            "2000s"
trainz-build                            4.5
thumbnails
{
 0
 {
   image                               "DriveThruTrackmark.texture"
   width                               64
   height                              64
 }
 
 1
 {
   image                               "thumbnail.jpg"
   width                               240
   height                              180
 }
}
string-table
{
 description                           "Drive train through a trackmark"
}
kuid-table
{
 command-sounds                        <kuid:-3:10219>
 sessionvariables                      <kuid:-3:10197>
}

Note:

  • A 64x64 thumbnail is included for the display lists.
  • The KUID table includes libraries that the script relies on.

Downloads

Attach sample files here?

Categories

Personal tools