Package org.opensourcephysics.controls

Class SimulationControl

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

org.opensourcephysics.display.OSPFrame

org.opensourcephysics.controls.ControlFrame

org.opensourcephysics.controls.OSPControl

org.opensourcephysics.controls.AnimationControl

org.opensourcephysics.controls.SimulationControl

All Implemented Interfaces:

ImageObserver, MenuContainer, PropertyChangeListener, Serializable, EventListener, Accessible, RootPaneContainer, WindowConstants, Control, MainFrame, SimControl, AppFrame, Hidable

public class SimulationControl
extends AnimationControl
implements SimControl

An AnimationControl that controls the editing of parameters.

Version:

1.0

Author:

Wolfgang Christian

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JFrame

JFrame.AccessibleJFrame

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

Frame.AccessibleAWTFrame

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

Window.AccessibleAWTWindow, Window.Type

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

Container.AccessibleAWTContainer

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

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields inherited from class org.opensourcephysics.controls.ControlFrame

clearItem, copyItem, displayMenu, editMenu, fileMenu, inspectItem, languageItems, languageMenu, model, ospApp, printFrameItem, readItem, saveAsItem, saveFrameAsEPSItem, sizeDownItem, sizeUpItem, xmlDefault

Fields inherited from class org.opensourcephysics.display.OSPFrame

action, animated, autoclear, buttonPanel, childFrames, constructorThreadGroup, customButtons, keepHidden, myFontLevel, strategy

Fields inherited from class javax.swing.JFrame

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface org.opensourcephysics.controls.Control

NOT_EDITABLE_BACKGROUND

Fields inherited from interface java.awt.image.ImageObserver

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

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Constructor	Description
SimulationControl(Simulation animation)	Constructs a SIPAnimationControl for the given animation.

Method Summary

Modifier and Type	Method	Description
static SimulationControl	createApp(Simulation model)	Creates a SIP animation control and establishes communication between the control and the model.
static SimulationControl	createApp(Simulation model, String[] xml)	Creates a simulation control and establishes communication between the control and the model.
static XML.ObjectLoader	getLoader()	Returns an XML.ObjectLoader to save and load data for this object.
boolean	isParamterFixed(String name)	Determines if the given parameter is fixed and can only be changed during initialization.
void	removeParameter(String name)	Removes a parameter from this control.
void	setAdjustableValue(String name, boolean val)	Stores a boolean in the control that can be edited after initialization.
void	setAdjustableValue(String name, double val)	Stores a double in the control that can be edited after initialization.
void	setAdjustableValue(String name, int val)	Stores an integer in the control that can be edited after initialization.
void	setAdjustableValue(String name, Object val)	Stores an object in the control that can be edited after initialization.
void	setParameterToFixed(String name, boolean fixed)	Sets the fixed property of the given parameter.
void	setValue(String name, boolean val)	Stores a name and a boolean value in the control that can only be edited when the control is in initialization mode.
void	setValue(String name, double val)	Stores a name and a double value in the control that can only be edited when the control is in initialization mode.
void	setValue(String name, int val)	Stores a name and an integer value in the control that can only be edited when the control is in initialization mode.
void	setValue(String name, Object val)	Stores an object in the control that can only be edited when the control is in initialization mode.

Methods inherited from class org.opensourcephysics.controls.AnimationControl

calculationDone, createApp, createApp, dispose, refreshGUI

Methods inherited from class org.opensourcephysics.controls.OSPControl

addButton, addButton, addControlListener, addControlListener, clearMessages, clearValues, createApp, getBoolean, getDouble, getInt, getMainFrame, getModel, getObject, getPropertyNames, getPropertyNamesRaw, getString, init, loadDisplayMenu, print, println, println, propertyChange, setDividerLocation, setEditable, setLockValues, toString

Methods inherited from class org.opensourcephysics.controls.ControlFrame

copy, getOSPApp, inspectXML, loadXML, loadXML, loadXML, loadXML, readParameters, save, saveXML

Methods inherited from class org.opensourcephysics.display.OSPFrame

addButton, addChildFrame, bufferStrategyShow, clearChildFrames, clearData, clearDataAndRepaint, createBufferStrategy, getChildFrames, getChooser, getConstructorThreadGroup, getMenu, invalidateImage, isAnimated, isAutoclear, isIconified, isKeepHidden, loadToolsMenu, parseXMLMenu, parseXMLMenu, removeMenu, removeMenuItem, render, setAnimated, setAutoclear, setDefaultCloseOperation, setFontLevel, setKeepHidden, setResizeAction, setSize, setTitle, setVisible, show, wishesToExit

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setType, toBack, toFront

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusDownCycle, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opensourcephysics.display.AppFrame

getDefaultCloseOperation

Methods inherited from interface org.opensourcephysics.controls.Control

calculationDone, clearMessages, clearValues, getBoolean, getDouble, getInt, getObject, getPropertyNames, getPropertyNamesRaw, getString, print, println, println, setLockValues, setValue

Methods inherited from interface org.opensourcephysics.controls.MainFrame

addChildFrame, clearChildFrames, getChildFrames, getOSPApp

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Details

SimulationControl

public SimulationControl(Simulation animation)

Constructs a SIPAnimationControl for the given animation.

Parameters:

animation - Animation

Method Details

setParameterToFixed

public void setParameterToFixed(String name,
 boolean fixed)

Sets the fixed property of the given parameter. Fixed parameters can only be changed before initialization.

Specified by:

setParameterToFixed in interface SimControl

isParamterFixed

public boolean isParamterFixed(String name)

Determines if the given parameter is fixed and can only be changed during initialization.

Parameters:

name - String

Returns:

boolean

setValue

public void setValue(String name,
 Object val)

Stores an object in the control that can only be edited when the control is in initialization mode.

Specified by:

setValue in interface Control

Overrides:

setValue in class OSPControl

Parameters:

name -

val -

setAdjustableValue

public void setAdjustableValue(String name,
 Object val)

Stores an object in the control that can be edited after initialization.

Specified by:

setAdjustableValue in interface SimControl

Parameters:

name -

val -

setValue

public void setValue(String name,
 double val)

Stores a name and a double value in the control that can only be edited when the control is in initialization mode.

Specified by:

setValue in interface Control

Overrides:

setValue in class OSPControl

Parameters:

name -

val -

setAdjustableValue

public void setAdjustableValue(String name,
 double val)

Stores a double in the control that can be edited after initialization.

Specified by:

setAdjustableValue in interface SimControl

Parameters:

name -

val -

setValue

public void setValue(String name,
 int val)

Stores a name and an integer value in the control that can only be edited when the control is in initialization mode.

Specified by:

setValue in interface Control

Overrides:

setValue in class OSPControl

Parameters:

name -

val -

setAdjustableValue

public void setAdjustableValue(String name,
 int val)

Stores an integer in the control that can be edited after initialization.

Specified by:

setAdjustableValue in interface SimControl

Parameters:

name -

val -

setValue

public void setValue(String name,
 boolean val)

Stores a name and a boolean value in the control that can only be edited when the control is in initialization mode.

Specified by:

setValue in interface Control

Overrides:

setValue in class OSPControl

Parameters:

name -

val -

removeParameter

public void removeParameter(String name)

Removes a parameter from this control.

Specified by:

removeParameter in interface SimControl

Overrides:

removeParameter in class OSPControl

Parameters:

name -

setAdjustableValue

public void setAdjustableValue(String name,
 boolean val)

Stores a boolean in the control that can be edited after initialization.

Specified by:

setAdjustableValue in interface SimControl

Parameters:

name -

val -

getLoader

public static XML.ObjectLoader getLoader()

Returns an XML.ObjectLoader to save and load data for this object.

Returns:

the object loader

createApp

public static SimulationControl createApp(Simulation model)

Creates a SIP animation control and establishes communication between the control and the model.

Parameters:

model - SIPAnimation

Returns:

AnimationControl

createApp

public static SimulationControl createApp(Simulation model,
 String[] xml)

Creates a simulation control and establishes communication between the control and the model. Initial parameters are set using the xml data.

Parameters:

model - Simulation

xml - String[]

Returns:

SimulationControl