Throttle: Getting Started
Author: Paul Fraker (paul@frakers.com)
Description: Throttle documentation for JMRI project
Keywords: JMRI decoderpro dcc nmra throttlepro

# Current Throttle documentation

Please note that the Throttles Help was updated. Current version:

- The Throttle menu in JMRI
- The Throttle Window itself
- The Throttle Window menus
- The Throttle Window toolbar
- The Throttle Window controls
- The Throttles List Window
- The Throttles preferences pane

# Throttles in JMRI v2.x

## Where Do I Find the Throttles?

Chances are, if you are reading this text, then you probably saw reference to the "throttles" in the JMRI user group postings. And the first question that probably came to your mind was, "where the heck do I find these throttles?"

Well you've started at the right place. The first thing this section is going to do is show you how to gain access to the throttles. This section will also touch on the menu options that are available.

First, it is important to understand that the JMRI Project is a group of many "tools" for your railroad - with many contributions from different programmers. There are four primary startup applications available

- DecoderPro (the most widely and commonly known piece of the project)
- JMRI Demo
- Loco Tools
- PanelPro

For the purposes of this user guide, the JMRI Demo startup application was used for the purposes of writing these pages. However, you will find that many of the tools "cross over" to multiple startup applications. The Throttle Tool is a good example of this. No matter which of the above mentioned applications you start with, you will be able to find the throttles.

## The Main (or Primary) Menu

In each of the startup applications noted above, there is always a "primary" main window displayed on your screen (similar to that shown below in figure 1-1). Close down this window and the whole application will terminate. This main window contains a primary set of menu options. This is where you will find most of the tools and options available - including the Throttles.

- Click on "Tools".
- This will open a submenu.
- Navigate your mouse pointer down until you locate "Throttles".
- This will open another submenu.
- This is the Throttles Menu (refer to figure 1-2).

Figure 1-1: JMRI main menu structure

## The Throttles Submenu

The Throttles submenu (as shown in figure 1-2 below) contains the following menu options, which are defined as:

- New Throttle... opens a single new Throttle window with default Throttle settings enabled.
- Save Throttle Layout... saves one or more currently opened Throttle windows to a user-named file on your hard drive.
- Load Throttle Layout... opens a previously saved Throttle file. This file can contain one or more Throttle windows depending on how the layout was originally saved.
- Save Throttle Preferences... allows you to set up your overall preferences for all Throttle windows.

Figure 1-2: JMRI Throttles submenu structure

Use the links below to advance to the next chapter to walk through the process of opening up a new Throttle window and setting up some of the available options, and lets not forget... run a Locomotive.

|  | TOC |  |