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