JMRI® is...
JMRI tools for working with your layout:
Layout Automation
Use JMRI to automate parts of your layout and operations:
Supported Hardware
JMRI supports a wide range of DCC systems, command stations and protocols.
By the community of

JMRI Help:

Contents Index
Glossary FAQ

Donate to JMRI Donate to

Using the Throttle Pane


Basic structure of a Throttle Window

There are three panels (or sub-windows) associated with each Throttle window. These are identified as:
Note that these three panels are actually windows defined within an overall window, each of these panels contain their own "minimize" and "close" buttons - as well as can also be resized. You can actually minimize one or more of these panels within the Throttle window. When one of these subwindows is closed, is can be reopened through the View menu.

For details about usage of the Throttle window menus, see there.
For details about usage of the Throttle window toolbar, see there.
For details about usage of the Throttles Preferences, see there.

For advanced control of a Throttle, see there.

Address Panel - Assign a Decoder Address to a Throttle

The first thing that needs to happen before any options or buttons in the window become active, is to assign a decoder's address in the "Address Panel". There are two ways that this can be accomplished.

Manually enter the decoder's address in the large text box or select an existing Roster entry though the drop down menu, then click on the "Set" button.
When manually entering an address, be sure to click on the Set button. Without this step, all throttle actions remain disabled.

Note that there is an option in the Throttles Preferences Pane that will enable an automatic look back in the roster when an address is entered, and eventually trigger an automatic set up of the full throttle if any matching Roster entry is found. This option is enabled as a default.

After an address is selected, all other controls and options in the throttle window will be enabled:

Control Panel - Let's Run a Train

Now that you have established an address for the throttle, you should be able to run the train on your layout (if your layout is active and the address you entered is valid to a locomotive on the track). You do this using the "Control Panel".
Beware of where you click with your mouse pointer in the Control Panel. If you click anywhere near the slider, your loco may take off on you unexpectedly (more on this below). If you click anywhere on the words "Forward" or "Reverse", you might change current train direction.

Control Panel config pane

This pane if accessible by right clicking in the Control Panel pane and opening Properties menu entry

The Function Panel

The Function Panel will automaticaly add/remove buttons when a throttle is acquired depending on the number of function this throttle can manage.

Clicking on the function buttons correlate to pressing the same function button on a hand-held throttle. The F0 function is normally used for the lights.

This is the basic functionality of the Function Panel. All buttons function act like an on/off toggle - click once to turn "on"; click again to turn "off".

Function Button config pane

This pane if accessible by right clicking in the AddressPanel pane, on a specific Function Button and opening Properties menu entry.

Note that for Throttles that have an associated Roster, it is better to define these settings in the Function label pane in DecoderPro (however if you change them here, you can still export these changes to the Roster through the Export to Roster menu entry).
By default, the Function Number is associated with the button number that you initially right-clicked on. For example, in the figures shown above, function number "3" (F3) is being edited. It is recommended that you leave this number as is, however, you can change this to a different function number if you really wish. An example of why you might want to do this is if you really want the "lights" button - which is usually F0 (located as the last/bottom button by default) - to be located as the first button in the Function Panel.

Warning! If any modifications are done to the "Function Number" field, verify to make sure that no two buttons are assigned the same function number - some unwanted consequences may occur.

The Text field will be the most welcome and modified field. By default, it is set similar to hand-held throttles: F1...F2...F3...etc. The content of the field is pretty much open to the imagination, however, there is going to be a point where the length of the text is not going to fit on the button. The Font Size field is available to also assist in getting the wanted text to fit on the button. A little experimentation will be required here to determine what looks good for you - and what will fit.

The Lockable check box may be a little confusing at first. When enabled - as it is by default - it simply means that when the button is clicked on, it will "lock" itself in either an "on" state or an "off" state. In other words, the button will act as a toggle switch - click once to turn the function "on"; click again to turn the function "off". The opposite of this action is what happens when the check box is disabled. Then the button acts like a momentary switch - supplying a momentary "on" command for as long as the mouse button is clicked and held over the button. When the mouse button is released, an "off" command is sent to the function. A good example of where one might want to use this is when customizing a throttle setup for a sound decoder. The horn/whistle is closer to functional when this option is disabled. Depending on the speed of the computer system and the DCC system, short and quick click and releases would provide a short blast of the horn or whistle. Holding down the button a little longer would produce a longer held blast of the whistle.
The lockable state of each button is updated from the mathing roster entry if any, or from the DCC throttle itself, as updated by the layout connector on a throttle acquisisiton event.

The Visible check box allows for the "removal" of unwanted buttons. By default, all function buttons are enabled as "visible" so that they can obviously be seen. But if there is only a single function being used - for example the "lights" (F0) - then this option does provide the ability to "hide" all of the other buttons.

Warning! Disabling the "Visible" check box should be one of the last steps performed during this customization process. The reason for this is that once the button is marked as "invisible" (by removing the check box), it is indeed invisible to the user and therefore can't be right-clicked on with the mouse in order to get the "Edit Function Button" window back. To make all buttons see throttle menu entry "View->Show All Function Buttons."

Button function icons are customizable by drag'n drop or by right clicking, to remove curent image, or use a shorcut to get to the JMRI icon ressources folder. Note that SVG files are supported, being vectorial, they will be resized nicely.
If necessary (no existing similar file), droped files are copied into your JMRI ressource folder.
If you're editing an existing roster entry, it will be updated accordingly. (see throttle menu entry "Edit->Export current throttles customization to roster").


See there for more informations about Jynstruments.

The Throttle Window is Jynstrumentable, particularly with more advanced function controls.

A few sample Jynstruments are delivered, some for function control, others for camera image integration into a JMRI throttle window, roster image display etc...

Note that Throttle Window toolbar is Jynstrumentable too, so here we drop the Jynstruments on the window contentitself, not on the toolbar.