balance
Class Balance

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Panel
              extended by java.applet.Applet
                  extended by edu.davidson.tools.SApplet
                      extended by 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.applet.Applet
java.applet.Applet.AccessibleApplet
 
Nested classes/interfaces inherited from class java.awt.Panel
java.awt.Panel.AccessibleAWTPanel
 
Nested classes/interfaces inherited from class java.awt.Container
java.awt.Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class edu.davidson.tools.SApplet
autoRefresh, clock, dataConnections, dataListeners, dataSources, lock, oneShotMsg
 
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, cyclingClock, deleteDataConnection, deleteDataConnections, forward, getClockID, getClockTime, getDataConnectionFromDL, getDataConnectionFromDS, getDataFromDS, getDataListener, getDataListener, getDataSource, getDataSource, getID, getRunningID, getSourceData, getSourceVariables, isAutoRefresh, isClockRunning, makeDataConnection, pause, pausingClock, 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, stoppingClock, 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, addImpl, 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, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusBackward, transferFocusDownCycle, update, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, 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, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, 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
clone, equals, finalize, 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