Transitions Glossary

Transition Conditions, Actions and Operations

Conditions 

Register 

SPEED: Current speed not based on the speed table

REQUESTED SPEED: When the decoder receives signal to change speed, and it matches this number, it will transition

CURRENT SPEED: Current speed based on the speed table

ACCELERATION: If you use acel and decel values in your driving functions, this is the difference between current speed and requested speed, this can be a positive or negative integer.

TIMER 1&2: Settable Timers, these are calculated at 1/4 second intervals, 4=1 second they are local to the sound slot and do not effect other slots

FUNCTION: True or False, works as expected

REVERSE: True or False, True means reverse is engaged, false means forward is engaged.

SHIFT 1-6: Secondary functions that can be enabled, typically used for Reverser Center, Dynamic Brakes, Isolation switch etc, refer to the Templates Value page

SHARE 1: These are typically used for the prime mover sounds and their points, refer to Templates Value page. This is a Global Value

SHARE 2 (2.0-2.7): Must be typed out (i.e. Share2.0) in the register, True/False value, refer to Templates Value page. This is a Global Value

SELECT: Honestly I forgot, will be added at a later date

BRAKE 1-3: Different Brake modes, controls the motors decel rate, settable in [Decoder ► Brake Settings ► Brake Functions] and activates sounds, refer to Templates Value page.

USER 1-4: The name is weird, but its basically a local number that can be set by the "Action" of a transition, and used as a condition later, useful for something like, having a counter to play a different sound each time you press the function key, or set it up as a random number generator (See: Nifty Bits page)

SOUND CV 1-16: These are numbers that can be set via CVs, CV 155= Sound CV 1, CV 170=SV 16 refer to Templates Value page

Global  Value=A value that is shared with every  sound slot, for example, if you make a transition set the action "Share 1 = 3"  your engine will go to idle, and will not respond until  you move the throttle. Be cautious on how you use these! Can also be set to a transition where the transition must meet that "Share 1 = 3" this will make it to where the engine has to be at idle for the state to activate.

Actions

Register

TIMER 1&2: Means the action will set the timer, timer will count down from the number typed in on the selected timer (Timer 1 and 2 are two different timers and are not linked to each other, or other sound slots)

SHARE 1: Will set Share 1 to whatever value you put in the value box, modified by the operation parameter This is a Global Value

SHARE 2 (2.0-2.7): Must be typed out (i.e. Share 2.1) this is a true or false value This is a Global Value

USER 1-4: Will set the selected user (i.e. User 1) to a the value specified, modified by the operation parameter

SOUND CV 1-16: I have never seen this work. I have tried extensively with no avail, in theory, should set the CV to the number specified

Global  Value=A value that is shared with every  sound slot, for example, if you make a transition set the action "Share 1 = 3"  your engine will go to idle, and will not respond until  you move the throttle. Be cautious on how you use these! Can also be set to a transition where the transition must meet that "Share 1 = 3" this will make it to where the engine has to be at idle for the state to activate. 

Operation

Has two different purposes depending where it is used

IN THE CONDITION PANE

= Means that the specified register must meet this exact number or specification 

!= Means the register MUST NOT equal that number to transition

< Means the register must be less than the number specified to transition

<= Means the register must not me less than or equal to this number to transition

> Means the register must be greater than this number to transition

>= Means the register must be equal to or greater than this number to transition


IN THE ACTION PANE

= Means the action will set this number in the register

+ Means the action will add this number to the register number

- Means this action will subtract this number from the register number 


Whats a register? A register is anything like a Timer, User, Share, Speed, Sound CV etc. Under the name "Register" in the Modify Action or Modify Condition pane

Nifty Bits

THE MAGIC OF rand

Some things that aren't mentioned elsewhere in any literature I have read.

You can make an action set a random number, to do this, in the Value box type rand(X,X) (X meaning a number between 0 and 255, must be separated with a comma) it will then randomly set a number for you. Very useful if you want to utilize it.  You know if you've done this right when the "OK" button becomes clickable