Package jmri

Interface Throttle

All Superinterfaces:
PropertyChangeProvider
All Known Subinterfaces:
DccThrottle
All Known Implementing Classes:
AbstractThrottle, BiDiBThrottle, CbusThrottle, DCCppThrottle, DebugThrottle, EasyDccThrottle, EcosDccThrottle, EliteXNetThrottle, Ib1Throttle, Ib2Throttle, LocoNetThrottle, MarklinThrottle, MqttThrottle, MrcThrottle, Mx1Throttle, NceThrottle, OlcbThrottle, Pr2Throttle, RocoXNetThrottle, SerialThrottle, SprogCSThrottle, SprogThrottle, SRCPThrottle, TamsThrottle, Throttle, XNetThrottle, XpaThrottle, Z21XNetThrottle

public interface Throttle extends PropertyChangeProvider
A Throttle object can be manipulated to change the speed, direction and functions of a single locomotive.

A Throttle implementation provides the actual control mechanism. These are obtained via a ThrottleManager.

With some control systems, there are only a limited number of Throttle's available.

On DCC systems, Throttles are often actually DccThrottle objects, which have some additional DCC-specific capabilities.

PropertyChangeEvents that can be listened to include

  • SpeedSetting, SpeedSteps, isForward
  • F0, F1, F2 .. F27, F28, F29, F30 ..
  • F0Momentary, F1Momentary, F2Momentary .. F28Momentary .. F29Momentary ..
  • ThrottleAssigned, throttleRemoved, throttleConnected, throttleNotFoundInRemoval
  • DispatchEnabled, ReleaseEnabled
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final String
    Constant sent by Throttle on Connected Property Change.
    static final String
    Constant sent by Throttle on Dispatch Enabled Property Change.
    static final String
    Deprecated.
    Use getFunctionString(int momentFunctionNum) instead.
    static final String
    Deprecated.
    Use getFunctionMomentaryString(int momentFunctionNum) instead.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Deprecated.
    static final String
    Constant sent by Throttle on Direction Property Change.
    static final String
    Constant sent by Throttle on Release Enabled Property Change.
    static final String
    Constant sent by Throttle on Speed Increment Property Change.
    static final String
    Constant sent by Throttle on Speed Setting Property Change.
    static final String
    Constant used in getThrottleInfo.
    static final String
    Constant sent by Throttle on Speed Steps Property Change.
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else.
    void
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunction(int functionNum) instead.
    default boolean
    Deprecated.
    Use getFunctionMomentary(int functionNum) instead.
    boolean
    getFunction(int functionNum)
    Get Loco Function status.
    boolean
    Get the Momentary Function Value.
    static String
    getFunctionMomentaryString(int momentFunctionNum)
    Get the Momentary Function String for a particular Function number.
    boolean[]
    Get copy of function array.
    boolean[]
    Get copy of function momentary status array.
    static String
    getFunctionString(int functionNum)
    Get the Function String for a particular Function number.
    boolean
    direction This is an bound property.
    Locomotive address.
     
    float
    Get the current speed setting, expressed as a value 0.0 -> 1.0. This property is bound to the SPEEDSETTING name.
    void
    Notify listeners that a Throttle has Dispatch enabled or disabled.
    void
    Notify listeners that a Throttle has Release enabled or disabled.
    void
    Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else.
    default void
    setF0(boolean f0)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF0Momentary(boolean f0Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF1(boolean f1)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF10(boolean f10)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF10Momentary(boolean f10Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF11(boolean f11)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF11Momentary(boolean f11Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF12(boolean f12)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF12Momentary(boolean f12Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF13(boolean f13)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF13Momentary(boolean f13Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF14(boolean f14)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF14Momentary(boolean f14Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF15(boolean f15)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF15Momentary(boolean f15Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF16(boolean f16)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF16Momentary(boolean f16Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF17(boolean f17)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF17Momentary(boolean f17Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF18(boolean f18)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF18Momentary(boolean f18Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF19(boolean f19)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF19Momentary(boolean f19Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF1Momentary(boolean f1Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF2(boolean f2)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF20(boolean f20)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF20Momentary(boolean f20Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF21(boolean f21)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF21Momentary(boolean f21Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF22(boolean f22)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF22Momentary(boolean f22Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF23(boolean f23)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF23Momentary(boolean f23Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF24(boolean f24)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF24Momentary(boolean f24Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF25(boolean f25)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF25Momentary(boolean f25Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF26(boolean f26)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF26Momentary(boolean f26Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF27(boolean f27)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF27Momentary(boolean f27Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF28(boolean f28)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF28Momentary(boolean f28Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF2Momentary(boolean f2Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF3(boolean f3)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF3Momentary(boolean f3Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF4(boolean f4)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF4Momentary(boolean f4Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF5(boolean f5)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF5Momentary(boolean f5Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF6(boolean f6)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF6Momentary(boolean f6Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF7(boolean f7)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF7Momentary(boolean f7Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF8(boolean f8)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF8Momentary(boolean f8Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    default void
    setF9(boolean f9)
    Deprecated.
    Use setFunction(int functionNum) instead.
    default void
    setF9Momentary(boolean f9Momentary)
    Deprecated.
    Use setFunctionMomentary(int functionNum) instead.
    void
    setFunction(int functionNum, boolean newState)
    Set Loco Function and send to Layout.
    void
    setFunctionMomentary(int momFuncNum, boolean state)
    Set Momentary Loco Function and send to Layout.
    void
    setIsForward(boolean forward)
    Set direction.
    void
     
    void
    setSpeedSetting(float speed)
    Set the desired speed setting, expressed as a value 0.0 -> 1.0. Negative means emergency stop.
    void
    setSpeedSetting(float speed, boolean allowDuplicates, boolean allowDuplicatesOnStop)
    Set the desired speed, expressed as a value 0.0 -> 1.0., with extra control over the messages to the layout.
    void
    setSpeedSettingAgain(float speed)
    Set the speed, and on systems which normally suppress the sending of a message make sure the message gets sent.