jmri
Interface Throttle

All Known Subinterfaces:

DccThrottle

All Known Implementing Classes:

AbstractThrottle, DebugThrottle, EasyDccThrottle, EliteXNetThrottle, LocoNetThrottle, NceThrottle, Pr2Throttle, SerialThrottle, SprogCSThrottle, SprogThrottle, SRCPThrottle, Throttle, XNetThrottle, XpaThrottle

public interface Throttle

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.

This file is part of JMRI.

JMRI is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation. See the "COPYING" file for a copy of this license.

JMRI is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Author:

Bob Jacobsen Copyright (C) 2001, 2008

Method Summary

void	addPropertyChangeListener(PropertyChangeListener p)
void	dispatch() Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else.
void	dispose() Not for general use, see release() and dispatch().
boolean	getF0()
boolean	getF0Momentary()
boolean	getF1()
boolean	getF10()
boolean	getF10Momentary()
boolean	getF11()
boolean	getF11Momentary()
boolean	getF12()
boolean	getF12Momentary()
boolean	getF13()
boolean	getF13Momentary()
boolean	getF14()
boolean	getF14Momentary()
boolean	getF15()
boolean	getF15Momentary()
boolean	getF16()
boolean	getF16Momentary()
boolean	getF17()
boolean	getF17Momentary()
boolean	getF18()
boolean	getF18Momentary()
boolean	getF19()
boolean	getF19Momentary()
boolean	getF1Momentary()
boolean	getF2()
boolean	getF20()
boolean	getF20Momentary()
boolean	getF21()
boolean	getF21Momentary()
boolean	getF22()
boolean	getF22Momentary()
boolean	getF23()
boolean	getF23Momentary()
boolean	getF24()
boolean	getF24Momentary()
boolean	getF25()
boolean	getF25Momentary()
boolean	getF26()
boolean	getF26Momentary()
boolean	getF27()
boolean	getF27Momentary()
boolean	getF28()
boolean	getF28Momentary()
boolean	getF2Momentary()
boolean	getF3()
boolean	getF3Momentary()
boolean	getF4()
boolean	getF4Momentary()
boolean	getF5()
boolean	getF5Momentary()
boolean	getF6()
boolean	getF6Momentary()
boolean	getF7()
boolean	getF7Momentary()
boolean	getF8()
boolean	getF8Momentary()
boolean	getF9()
boolean	getF9Momentary()
boolean	getIsForward() direction This is an bound parameter.
LocoAddress	getLocoAddress() Locomotive address.
float	getSpeedSetting() Speed - expressed as a value 0.0 -> 1.0.
void	release() Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else.
void	removePropertyChangeListener(PropertyChangeListener p)
void	setF0(boolean f0)
void	setF0Momentary(boolean f0Momentary)
void	setF1(boolean f1)
void	setF10(boolean f10)
void	setF10Momentary(boolean f10Momentary)
void	setF11(boolean f11)
void	setF11Momentary(boolean f11Momentary)
void	setF12(boolean f12)
void	setF12Momentary(boolean f12Momentary)
void	setF13(boolean f13)
void	setF13Momentary(boolean f13Momentary)
void	setF14(boolean f14)
void	setF14Momentary(boolean f14Momentary)
void	setF15(boolean f15)
void	setF15Momentary(boolean f15Momentary)
void	setF16(boolean f16)
void	setF16Momentary(boolean f16Momentary)
void	setF17(boolean f17)
void	setF17Momentary(boolean f17Momentary)
void	setF18(boolean f18)
void	setF18Momentary(boolean f18Momentary)
void	setF19(boolean f19)
void	setF19Momentary(boolean f19Momentary)
void	setF1Momentary(boolean f1Momentary)
void	setF2(boolean f2)
void	setF20(boolean f20)
void	setF20Momentary(boolean f20Momentary)
void	setF21(boolean f21)
void	setF21Momentary(boolean f21Momentary)
void	setF22(boolean f22)
void	setF22Momentary(boolean f22Momentary)
void	setF23(boolean f23)
void	setF23Momentary(boolean f23Momentary)
void	setF24(boolean f24)
void	setF24Momentary(boolean f24Momentary)
void	setF25(boolean f25)
void	setF25Momentary(boolean f25Momentary)
void	setF26(boolean f26)
void	setF26Momentary(boolean f26Momentary)
void	setF27(boolean f27)
void	setF27Momentary(boolean f27Momentary)
void	setF28(boolean f28)
void	setF28Momentary(boolean f28Momentary)
void	setF2Momentary(boolean f2Momentary)
void	setF3(boolean f3)
void	setF3Momentary(boolean f3Momentary)
void	setF4(boolean f4)
void	setF4Momentary(boolean f4Momentary)
void	setF5(boolean f5)
void	setF5Momentary(boolean f5Momentary)
void	setF6(boolean f6)
void	setF6Momentary(boolean f6Momentary)
void	setF7(boolean f7)
void	setF7Momentary(boolean f7Momentary)
void	setF8(boolean f8)
void	setF8Momentary(boolean f8Momentary)
void	setF9(boolean f9)
void	setF9Momentary(boolean f9Momentary)
void	setIsForward(boolean forward)
void	setSpeedSetting(float speed)

Method Detail

getSpeedSetting

float getSpeedSetting()

Speed - expressed as a value 0.0 -> 1.0. Negative means emergency stop. This is an bound parameter.

setSpeedSetting

void setSpeedSetting(float speed)

getIsForward

boolean getIsForward()

direction This is an bound parameter.

setIsForward

void setIsForward(boolean forward)

getF0

boolean getF0()

setF0

void setF0(boolean f0)

getF1

boolean getF1()

setF1

void setF1(boolean f1)

getF2

boolean getF2()

setF2

void setF2(boolean f2)

getF3

boolean getF3()

setF3

void setF3(boolean f3)

getF4

boolean getF4()

setF4

void setF4(boolean f4)

getF5

boolean getF5()

setF5

void setF5(boolean f5)

getF6

boolean getF6()

setF6

void setF6(boolean f6)

getF7

boolean getF7()

setF7

void setF7(boolean f7)

getF8

boolean getF8()

setF8

void setF8(boolean f8)

getF9

boolean getF9()

setF9

void setF9(boolean f9)

getF10

boolean getF10()

setF10

void setF10(boolean f10)

getF11

boolean getF11()

setF11

void setF11(boolean f11)

getF12

boolean getF12()

setF12

void setF12(boolean f12)

getF13

boolean getF13()

setF13

void setF13(boolean f13)

getF14

boolean getF14()

setF14

void setF14(boolean f14)

getF15

boolean getF15()

setF15

void setF15(boolean f15)

getF16

boolean getF16()

setF16

void setF16(boolean f16)

getF17

boolean getF17()

setF17

void setF17(boolean f17)

getF18

boolean getF18()

setF18

void setF18(boolean f18)

getF19

boolean getF19()

setF19

void setF19(boolean f19)

getF20

boolean getF20()

setF20

void setF20(boolean f20)

getF21

boolean getF21()

setF21

void setF21(boolean f21)

getF22

boolean getF22()

setF22

void setF22(boolean f22)

getF23

boolean getF23()

setF23

void setF23(boolean f23)

getF24

boolean getF24()

setF24

void setF24(boolean f24)

getF25

boolean getF25()

setF25

void setF25(boolean f25)

getF26

boolean getF26()

setF26

void setF26(boolean f26)

getF27

boolean getF27()

setF27

void setF27(boolean f27)

getF28

boolean getF28()

setF28

void setF28(boolean f28)

getF0Momentary

boolean getF0Momentary()

setF0Momentary

void setF0Momentary(boolean f0Momentary)

getF1Momentary

boolean getF1Momentary()

setF1Momentary

void setF1Momentary(boolean f1Momentary)

getF2Momentary

boolean getF2Momentary()

setF2Momentary

void setF2Momentary(boolean f2Momentary)

getF3Momentary

boolean getF3Momentary()

setF3Momentary

void setF3Momentary(boolean f3Momentary)

getF4Momentary

boolean getF4Momentary()

setF4Momentary

void setF4Momentary(boolean f4Momentary)

getF5Momentary

boolean getF5Momentary()

setF5Momentary

void setF5Momentary(boolean f5Momentary)

getF6Momentary

boolean getF6Momentary()

setF6Momentary

void setF6Momentary(boolean f6Momentary)

getF7Momentary

boolean getF7Momentary()

setF7Momentary

void setF7Momentary(boolean f7Momentary)

getF8Momentary

boolean getF8Momentary()

setF8Momentary

void setF8Momentary(boolean f8Momentary)

getF9Momentary

boolean getF9Momentary()

setF9Momentary

void setF9Momentary(boolean f9Momentary)

getF10Momentary

boolean getF10Momentary()

setF10Momentary

void setF10Momentary(boolean f10Momentary)

getF11Momentary

boolean getF11Momentary()

setF11Momentary

void setF11Momentary(boolean f11Momentary)

getF12Momentary

boolean getF12Momentary()

setF12Momentary

void setF12Momentary(boolean f12Momentary)

getF13Momentary

boolean getF13Momentary()

setF13Momentary

void setF13Momentary(boolean f13Momentary)

getF14Momentary

boolean getF14Momentary()

setF14Momentary

void setF14Momentary(boolean f14Momentary)

getF15Momentary

boolean getF15Momentary()

setF15Momentary

void setF15Momentary(boolean f15Momentary)

getF16Momentary

boolean getF16Momentary()

setF16Momentary

void setF16Momentary(boolean f16Momentary)

getF17Momentary

boolean getF17Momentary()

setF17Momentary

void setF17Momentary(boolean f17Momentary)

getF18Momentary

boolean getF18Momentary()

setF18Momentary

void setF18Momentary(boolean f18Momentary)

getF19Momentary

boolean getF19Momentary()

setF19Momentary

void setF19Momentary(boolean f19Momentary)

getF20Momentary

boolean getF20Momentary()

setF20Momentary

void setF20Momentary(boolean f20Momentary)

getF21Momentary

boolean getF21Momentary()

setF21Momentary

void setF21Momentary(boolean f21Momentary)

getF22Momentary

boolean getF22Momentary()

setF22Momentary

void setF22Momentary(boolean f22Momentary)

getF23Momentary

boolean getF23Momentary()

setF23Momentary

void setF23Momentary(boolean f23Momentary)

getF24Momentary

boolean getF24Momentary()

setF24Momentary

void setF24Momentary(boolean f24Momentary)

getF25Momentary

boolean getF25Momentary()

setF25Momentary

void setF25Momentary(boolean f25Momentary)

getF26Momentary

boolean getF26Momentary()

setF26Momentary

void setF26Momentary(boolean f26Momentary)

getF27Momentary

boolean getF27Momentary()

setF27Momentary

void setF27Momentary(boolean f27Momentary)

getF28Momentary

boolean getF28Momentary()

setF28Momentary

void setF28Momentary(boolean f28Momentary)

getLocoAddress

LocoAddress getLocoAddress()

Locomotive address. The exact format is defined by the specific implementation, as subclasses of LocoAddress will contain different information. This is an unbound parameter.

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener p)

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener p)

dispose

void dispose()

Not for general use, see release() and dispatch().

Dispose of object when finished it. This does not free any hardware resources used; rather, it just cleans up the software implementation.

Used for handling certain internal error conditions, where the object still exists but hardware is not associated with it.

After this, further usage of this Throttle object will result in a JmriException.

release

void release()

Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else.

After this, further usage of this Throttle object will result in a JmriException. Do not call dispose after release.

Normally, release ends with a call to dispose.

dispatch

void dispatch()

Finished with this Throttle, tell the layout that the locomotive is available for reuse/reallocation by somebody else. If possible, tell the layout that this locomotive has been dispatched to another user. Not all layouts will implement this, in which case it is synomous with release();

After this, further usage of this Throttle object will result in a JmriException.

Normally, dispatch ends with a call to dispose.