balance
Class Balance

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Panel
              java.applet.Applet
                  edu.davidson.tools.SApplet
                      balance.Balance

All Implemented Interfaces:

edu.davidson.tools.SDataListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible

public class Balance
extends edu.davidson.tools.SApplet
implements edu.davidson.tools.SDataListener

This applet displays a pan balance. An active tare button is included, and the units of both the display and input values may be set by the user.

This applet uses Data Connections.

Applet Parameters

NAME	Variable Type	Default	Description
BGColor	String	null	The string is converted to an integer representing the RGB color to be used as the background color for the applet.
BodyColor	String	#E0C000	The string is converted to an integer representing the RGB color to be used for the body of the balance.
BodyHeight	int	0	The height in pixels of the body of the balance. If the value is zero, the applet will automatically set this value to fill the applet area.
BodyWidth	int	0	The width in pixels of the body of the balance. If the value is zero, the applet will automatically set this value to fill the applet area.
DisplayUnit	String	gram	Sets the unit used to display the mass on the balance. Options are gram, milligram, kilogram, ounce, and pound.
InputUnit	String	gram	Sets the unit for the mass as supplied by the user. Options are gram, milligram, kilogram, ounce, and pound. The applet automatically converts from the input to the display unit.
IsReady	String		JavaScript variable that will be set to true when applet has initialized. Must use MAYSCRIPT in APPLET tag to use this feature.
Mass	double	0.0	Value of the mass in the input unit.
PanColor	String	#C0C0C0	The string is converted to an integer representing the RGB color to be used for the pan.
PanWidth	int	0	Width in pixels of the pan. If the value is zero, the applet will automatically selected the width.
Precision	int	2	The number of decimal places to be displayed (0-4).
Scale	int	2	The maximum display value for the balance is 10 raised to this power. The default scale value of 2 corresponds with a maximum display value of 10^2 = 100.
StandardDeviation	double	0.0	Gaussian error with this standard deviation is added to the displayed value.

Version:

2.0

Author:

David N. Blauch

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.BaselineResizeBehavior

Field Summary

Fields inherited from class edu.davidson.tools.SApplet

clock, dataConnections, dataListeners, dataSources, lock

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Balance()

Method Summary

void	addData(edu.davidson.tools.SDataSource ds, int id, double[] xVal, double[] yVal) Adds an array of data points via DataConnections.
void	addDatum(edu.davidson.tools.SDataSource ds, int id, double xVal, double yVal) The data source and id are not used.
void	clearSeries(int id) This method is required by SDataListener but is not used in this class.
void	deleteSeries(int id) This method is required by SDataListener but is not used in this class.
void	destroy()
java.lang.String	getAppletInfo()
edu.davidson.tools.SApplet	getOwner() Gets the owner of this DataListener
java.lang.String	getParameter(java.lang.String key, java.lang.String def)
java.lang.String[][]	getParameterInfo()
void	init()
void	paint(java.awt.Graphics g)
void	setMass(double _mass) Sets the mass.
void	setOwner(edu.davidson.tools.SApplet owner) Sets the owner for SDataListener
void	setScale(int _scale, int _precision) Sets the scale and precision of the balance
void	setStandardDeviation(double _stdev) Sets the standard deviation for the mass value.
void	setUnits(java.lang.String _unitInput, java.lang.String _unitDisplay) Sets the units displayed on the balance.
void	start()
void	stop()
void	updateDisplay() Updates the display

Methods inherited from class edu.davidson.tools.SApplet

addDataListener, addDataSource, cleanupDataConnections, clearAllData, clearData, deleteDataConnection, deleteDataConnections, forward, getClockID, getClockTime, getDataConnectionFromDL, getDataConnectionFromDS, getDataFromDS, getDataListener, getDataListener, getDataSource, getDataSource, getID, getRunningID, getSourceData, getSourceVariables, isAutoRefresh, isClockRunning, makeDataConnection, pause, removeDataListener, removeDataSource, reset, reverse, setAutoRefresh, setClockContinous, setClockCycle, setClockOneShot, setClockTime, setConnectionBlock, setConnectionListener, setConnectionSmoothing, setConnectionSource, setConnectionStride, setDefault, setDt, setExternalClock, setFPS, setRunningID, setRunningID, setTimeContinuous, setTimeCycle, setTimeOneShot, startClock, stepClock, stepTime, stepTimeBack, stepTimeForward, stopClock, updateDataConnection, updateDataConnections

Methods inherited from class java.applet.Applet

getAccessibleContext, getAppletContext, getAudioClip, getAudioClip, getCodeBase, getDocumentBase, getImage, getImage, getLocale, getParameter, isActive, newAudioClip, play, play, resize, resize, setStub, showStatus

Methods inherited from class java.awt.Panel

addNotify

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, dispatchEvent, enable, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface edu.davidson.tools.SDataListener

getID

Constructor Detail

Balance

public Balance()

Method Detail

getParameter

public java.lang.String getParameter(java.lang.String key,
                                     java.lang.String def)

init

public void init()

Overrides:

init in class java.applet.Applet

start

public void start()

Overrides:

start in class java.applet.Applet

stop

public void stop()

Overrides:

stop in class java.applet.Applet

destroy

public void destroy()

Overrides:

destroy in class edu.davidson.tools.SApplet

getAppletInfo

public java.lang.String getAppletInfo()

Overrides:

getAppletInfo in class java.applet.Applet

getParameterInfo

public java.lang.String[][] getParameterInfo()

Overrides:

getParameterInfo in class java.applet.Applet

addData

public void addData(edu.davidson.tools.SDataSource ds,
                    int id,
                    double[] xVal,
                    double[] yVal)

Adds an array of data points via DataConnections. The data source and id are not used. The mass is set to the value of yVal[0].

Specified by:

addData in interface edu.davidson.tools.SDataListener

Parameters:

ds - the data source supplying the information (not used).

id - the data identification (not used).

xVal - not used

yVal - mass

addDatum

public void addDatum(edu.davidson.tools.SDataSource ds,
                     int id,
                     double xVal,
                     double yVal)

The data source and id are not used. The mass is set to the value of yVal.

Specified by:

addDatum in interface edu.davidson.tools.SDataListener

Parameters:

ds - the data source supplying the information (not used).

id - the data identification (not used).

xVal - not used

yVal - mass

clearSeries

public void clearSeries(int id)

This method is required by SDataListener but is not used in this class.

Specified by:

clearSeries in interface edu.davidson.tools.SDataListener

deleteSeries

public void deleteSeries(int id)

This method is required by SDataListener but is not used in this class.

Specified by:

deleteSeries in interface edu.davidson.tools.SDataListener

getOwner

public edu.davidson.tools.SApplet getOwner()

Gets the owner of this DataListener

Specified by:

getOwner in interface edu.davidson.tools.SDataListener

Returns:

the owner

paint

public void paint(java.awt.Graphics g)

Overrides:

paint in class java.awt.Container

setMass

public void setMass(double _mass)

Sets the mass. The mass unit of the user-supplied value are set by the setUnits method

See Also:

setUnits(java.lang.String, java.lang.String)

setOwner

public void setOwner(edu.davidson.tools.SApplet owner)

Sets the owner for SDataListener

Specified by:

setOwner in interface edu.davidson.tools.SDataListener

Parameters:

owner - the owner of this DataListener

setScale

public void setScale(int _scale,
                     int _precision)

Sets the scale and precision of the balance

Parameters:

_scale - maximum mass is 10^_scale

_precision - number of decimal places displaced

setStandardDeviation

public void setStandardDeviation(double _stdev)

Sets the standard deviation for the mass value. (Default is zero.)

setUnits

public void setUnits(java.lang.String _unitInput,
                     java.lang.String _unitDisplay)

Sets the units displayed on the balance. Acceptable units are gram, milligram, kilogram, pound, and ounce. The mass values supplied by the user need not have the same units at the values displayed by the balance.

Parameters:

_unitInput - unit for input mass values

_unitDisplay - unit for mass display

updateDisplay

public void updateDisplay()

Updates the display