Throttle Tool
User Guide
Revision 2004.11.21
Based on JMRI 1.5.3

View/download
this document using
Adobe Reader

TABLE OF CONTENTS

Advanced throttles

Introduction
Getting Started
Open and Configure
Advanced Configuration
Saving/Opening Layouts

Throttle Window Menus

File menu


Load throttle

This menu entry allows to load a Throttle window layout into the curent Throttle Window, it will load inner windows properties, and Jynstruments if any.

Save current throttle

This menu entry allows to save the curent Throttle window layout, it will save inner windows of the current throttle properties, and Jynstruments if any.
When a roster entry is selected, that menu entry is automatically enabled, using it will create (or update) a default Throttle file for that roster entry in <JMRI Preferences Folder>/throttle/XYZ.xml where XYZ is the Roster ID.

Note that when saving a Throttle that is the default one for a Roster Entry, Function Buttons customization won't be saved in that file, they have to be exported to the Roster Entry (in Edit menu, see bellow).

Save current throttle as...

Allows to save the curent throttle window layout using any file name and path, if this filename is not the default one for a Roster Entry, then, Function Buttons customizations will be saved in that file.


Edit menu


Frame properties


ThrottleWindowPreferences.png

Allows for editing curent Throttle Window properties, particularly the Window title:
Note that if you enter text, it won't be visible unless one of the middle three modes is selected.

Reset function buttons

Reset the function buttons content to default and reset their visibility.

If a roster is selected, default button content will be loaded from roster entry; further more, if the matching preference is enabled, buttons undefined is the roster entry will be hidden.

Export current throttles customization to roster

Push curent throttle window customizations to the Roster particularly Function Buttons customizations. See Roster Functions Labels Pane.


View menu



The first part of the "View" menu displays a small menu of 3 items — by default, each with a check mark preceding the item. This corresponds to the 3 sub-windows (Address Panel, Function Panel, & Control Panel) that are part of the throttle window.

As each sub-window has a minimize and close buttons, if one gets closed down in error, this menu option allows you to restore the window again.

Another way to use this option is when using the features of the throttles for decoders that are not associated with a motor (such as a lighted passenger car or caboose or a Fred unit). In these cases, critical screen real estate can be saved by being able to disable (or close down) the Control Panel. Be a little creative with the window resizing, and you could have several of these custom throttle windows in the same area as one single complete throttle window would take up.

Show all function buttons - ! Functionality moved to "Reset Button" entry in "Edit" menu

Get all current throttle components in bounds

Make sure that all inner windows of the curent Throttle are inside the Throttle Window bounds.