Package edu.cnu.mdi.sim.ui

Class SimulationView

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JInternalFrame

edu.cnu.mdi.view.BaseView

edu.cnu.mdi.sim.ui.SimulationView

All Implemented Interfaces:

IFeedbackProvider, ISimulationHost, SimulationListener, IFileDropHandler, ComponentListener, FocusListener, MouseListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, RootPaneContainer, WindowConstants

Direct Known Subclasses:

ImageEvolutionDemoView, NetworkDeclutterDemoView, TspDemoView

public class SimulationView
extends BaseView
implements ISimulationHost, SimulationListener

Base class for an MDI BaseView that hosts a SimulationEngine.

This class is the "MDI bridge" for the MDI-agnostic simulation framework: the simulation engine knows nothing about views/containers, while this view knows how to repaint an IContainer on refresh and optionally hosts UI components (control panel, diagnostics).

Layout

BaseView already installs the container component in BorderLayout.CENTER (or inside a split pane), and may add a toolbar in BorderLayout.NORTH. This class adds:

• Optional control panel in BorderLayout.SOUTH
• Optional diagnostics component on the right, installed by wrapping the current CENTER component in a JSplitPane

Threading

All SimulationListener callbacks arrive on the Swing EDT (as guaranteed by SimulationEngine). Therefore, onRefresh(SimulationContext) safely repaints the container component.

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	SimulationView.ControlPanelFactory	Factory for creating a simulation control panel component.
static interface	SimulationView.DiagnosticFactory	Factory for creating an optional diagnostics component (e.g., plots/inspector) that will appear on the right side of a split pane.

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

JInternalFrame.AccessibleJInternalFrame, JInternalFrame.JDesktopIcon

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

JComponent.AccessibleJComponent

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

Modifier and Type	Field	Description
protected final JComponent	controlPanel	Optional control panel component (may be null).
protected final JComponent	diagnostics	Optional diagnostics component (may be null).
protected final JSplitPane	diagnosticsSplitPane	If diagnostics is installed, this is the split pane (else null).
protected SimulationEngine	engine	Hosted engine (never null).

Fields inherited from class edu.cnu.mdi.view.BaseView

container, desktop, infoDialog, properties, scrollPane, statusWP, viewPopupMenu, VIEWPROPNAME, virtualItem

Fields inherited from class javax.swing.JInternalFrame

closable, CONTENT_PANE_PROPERTY, desktopIcon, FRAME_ICON_PROPERTY, frameIcon, GLASS_PANE_PROPERTY, iconable, IS_CLOSED_PROPERTY, IS_ICON_PROPERTY, IS_MAXIMUM_PROPERTY, IS_SELECTED_PROPERTY, isClosed, isIcon, isMaximum, isSelected, LAYERED_PANE_PROPERTY, maximizable, MENU_BAR_PROPERTY, resizable, ROOT_PANE_PROPERTY, rootPane, rootPaneCheckingEnabled, title, TITLE_PROPERTY

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, 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

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
SimulationView(Simulation simulation, SimulationEngineConfig config, boolean includeControlPanel, SimulationView.ControlPanelFactory controlPanelFactory, boolean includeDiagnostics, SimulationView.DiagnosticFactory diagnosticFactory, double initialSplitFraction, Object... keyVals)	Construct a simulation view with optional control panel and optional diagnostics panel.
SimulationView(Simulation simulation, SimulationEngineConfig config, boolean includeControlPanel, SimulationView.ControlPanelFactory factory, Object... keyVals)	Construct a simulation view with a caller-provided control panel factory.
SimulationView(Simulation simulation, SimulationEngineConfig config, boolean includeControlPanel, Object... keyVals)	Construct a simulation view with optional inclusion of the default control panel.
SimulationView(Simulation simulation, Object... keyVals)	Construct a simulation view using default engine configuration and including the default control panel.

Method Summary

Modifier and Type	Method	Description
protected JComponent	getDiagnosticsComponent()	Get the diagnostics component, if any.
final SimulationEngine	getSimulationEngine()	Return the SimulationEngine hosted by this object.
void	onCancelRequested(SimulationContext ctx)	Called when cancellation is requested via SimulationEngine.requestCancel().
void	onDone(SimulationContext ctx)	Called when the engine ends normally (reaches SimulationState.TERMINATED).
void	onFail(SimulationContext ctx, Throwable error)	Called when the engine fails (reaches SimulationState.FAILED).
void	onInit(SimulationContext ctx)	Called after the engine transitions to SimulationState.INITIALIZING.
void	onMessage(SimulationContext ctx, String message)	Called for status/log messages intended for UI display.
void	onPause(SimulationContext ctx)	Called when the engine enters SimulationState.PAUSED.
void	onProgress(SimulationContext ctx, ProgressInfo progress)	Called for progress updates (indeterminate or determinate).
void	onReady(SimulationContext ctx)	Called when initialization completes and the engine reaches SimulationState.READY.
void	onRefresh(SimulationContext ctx)	Default refresh behavior for MDI: repaint the container component.
void	onResume(SimulationContext ctx)	Called when the engine resumes from SimulationState.PAUSED back to SimulationState.RUNNING.
void	onRun(SimulationContext ctx)	Called when the engine begins execution (enters SimulationState.RUNNING).
protected void	onSimulationCancelRequested(SimulationContext ctx)	Called on the EDT after the first cancellation request.
protected void	onSimulationDone(SimulationContext ctx)	Called on the EDT after normal termination.
protected void	onSimulationFail(SimulationContext ctx, Throwable error)	Called on the EDT after simulation failure.
protected void	onSimulationInit(SimulationContext ctx)	Called on the EDT after simulation initialization begins.
protected void	onSimulationMessage(SimulationContext ctx, String message)	Called on the EDT when the simulation posts a status message.
protected void	onSimulationPause(SimulationContext ctx)	Called on the EDT when the simulation pauses.
protected void	onSimulationProgress(SimulationContext ctx, ProgressInfo progress)	Called on the EDT when the simulation posts progress.
protected void	onSimulationReady(SimulationContext ctx)	Called on the EDT when the initialized simulation becomes ready.
protected void	onSimulationRefresh(SimulationContext ctx)	Called on the EDT before the view repaints in response to a refresh.
protected void	onSimulationResume(SimulationContext ctx)	Called on the EDT when a paused simulation resumes.
protected void	onSimulationRun(SimulationContext ctx)	Called on the EDT when the simulation first starts running.
protected void	onSimulationStateChange(SimulationContext ctx, SimulationState from, SimulationState to, String reason)	Called on the EDT after any engine state transition.
void	onStateChange(SimulationContext ctx, SimulationState from, SimulationState to, String reason)	Called on every state transition.
protected final void	replaceEngine(SimulationEngine newEngine)	Replace the hosted engine and rebind the control panel on the EDT.
protected final void	requestEngineReset(Supplier<Simulation> simSupplier, Consumer<SimulationEngine> afterSwap, boolean autoStart, boolean refresh)	Replace the engine immediately when safe, or stop the current run and replace it after termination.
final void	startAndRun()	Start the engine and immediately request that it run, on the EDT.

Methods inherited from class edu.cnu.mdi.view.BaseView

addWestPanel, applyFocusFix, center, checkBooleanProperty, componentHidden, componentMoved, componentResized, componentShown, enableFileDrop, enableFileDrop, filesDropped, focusGained, focusLost, getAnnotationLayer, getCenterComponent, getConfigurationProperties, getConnectionLayer, getDefaultLayer, getFeedbackStrings, getFileFilter, getIContainer, getImageComponent, getInfoButton, getInsets, getIntProperty, getName, getParentFrame, getProperties, getPropertyName, getScrollPane, getSpecialClip, getToolBar, getViewInfo, getViewPopupMenu, getVirtualItem, handleMagnify, hoverClosed, hoverUpdate, initFeedback, initFeedback, isOnTop, isScrollable, isViewVisible, mouseClicked, mouseEntered, mouseExited, mousePressed, mouseReleased, offset, onFirstRealize, prepareForExit, refresh, resolveContainer, rightClicked, setAfterDraw, setBeforeDraw, setBooleanProperty, setFileFilter, setFromProperties, setIntProperty, setVirtualItem, viewInfo

Methods inherited from class javax.swing.JInternalFrame

addImpl, addInternalFrameListener, createRootPane, dispose, doDefaultCloseAction, fireInternalFrameEvent, getAccessibleContext, getContentPane, getDefaultCloseOperation, getDesktopIcon, getDesktopPane, getFocusCycleRootAncestor, getFocusOwner, getFrameIcon, getGlassPane, getInternalFrameListeners, getJMenuBar, getLastCursor, getLayer, getLayeredPane, getMenuBar, getMostRecentFocusOwner, getNormalBounds, getRootPane, getTitle, getUI, getUIClassID, getWarningString, hide, isClosable, isClosed, isFocusCycleRoot, isIcon, isIconifiable, isMaximizable, isMaximum, isResizable, isRootPaneCheckingEnabled, isSelected, moveToBack, moveToFront, pack, paintComponent, paramString, remove, removeInternalFrameListener, reshape, restoreSubcomponentFocus, setClosable, setClosed, setContentPane, setCursor, setDefaultCloseOperation, setDesktopIcon, setFocusCycleRoot, setFrameIcon, setGlassPane, setIcon, setIconifiable, setJMenuBar, setLayer, setLayer, setLayeredPane, setLayout, setMaximizable, setMaximum, setMenuBar, setNormalBounds, setResizable, setRootPane, setRootPaneCheckingEnabled, setSelected, setTitle, setUI, show, toBack, toFront, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, 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, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface edu.cnu.mdi.sim.ISimulationHost

cancelSimulation, getSimulationContext, getSimulationState, pauseSimulation, resumeSimulation, runSimulation, startSimulation, stopSimulation

Methods inherited from interface edu.cnu.mdi.sim.SimulationListener

onCompleted

Field Details

engine

protected volatile SimulationEngine engine

Hosted engine (never null).

controlPanel

protected final JComponent controlPanel

Optional control panel component (may be null).

diagnostics

protected final JComponent diagnostics

Optional diagnostics component (may be null).

diagnosticsSplitPane

protected final JSplitPane diagnosticsSplitPane

If diagnostics is installed, this is the split pane (else null).

Constructor Details

SimulationView

public SimulationView(Simulation simulation,
 Object... keyVals)

Construct a simulation view using default engine configuration and including the default control panel.

Parameters:

simulation - the simulation to run (non-null)

keyVals - standard BaseView key-value arguments

SimulationView

public SimulationView(Simulation simulation,
 SimulationEngineConfig config,
 boolean includeControlPanel,
 Object... keyVals)

Construct a simulation view with optional inclusion of the default control panel.

Parameters:

simulation - the simulation to run (non-null)

config - engine configuration (non-null)

includeControlPanel - if true, creates and adds the default control panel at SOUTH

keyVals - standard BaseView key-value arguments

SimulationView

public SimulationView(Simulation simulation,
 SimulationEngineConfig config,
 boolean includeControlPanel,
 SimulationView.ControlPanelFactory factory,
 Object... keyVals)

Construct a simulation view with a caller-provided control panel factory.

Parameters:

simulation - the simulation to run (non-null)

config - engine configuration (non-null)

includeControlPanel - if true, creates and adds a control panel at SOUTH

factory - factory used to create the control panel component

keyVals - standard BaseView key-value arguments

SimulationView

public SimulationView(Simulation simulation,
 SimulationEngineConfig config,
 boolean includeControlPanel,
 SimulationView.ControlPanelFactory controlPanelFactory,
 boolean includeDiagnostics,
 SimulationView.DiagnosticFactory diagnosticFactory,
 double initialSplitFraction,
 Object... keyVals)

Construct a simulation view with optional control panel and optional diagnostics panel.

Parameters:

simulation - the simulation to run (non-null)

config - engine configuration (non-null)

includeControlPanel - if true, creates and adds a control panel at SOUTH

controlPanelFactory - factory used to create the control panel component (may be null if includeControlPanel is false)

includeDiagnostics - if true, installs a right-side diagnostics component via a split pane

diagnosticFactory - factory used to create the diagnostics component (required if includeDiagnostics is true)

initialSplitFraction - fraction of width given to the main (left) component on startup (0..1)

keyVals - standard BaseView key-value arguments

Method Details

getDiagnosticsComponent

protected JComponent getDiagnosticsComponent()

Get the diagnostics component, if any.

Returns:

the diagnostics component, or null if none

getSimulationEngine

public final SimulationEngine getSimulationEngine()

Description copied from interface: ISimulationHost

Return the SimulationEngine hosted by this object.

Specified by:

getSimulationEngine in interface ISimulationHost

Returns:

the simulation engine (never null)

onStateChange

public void onStateChange(SimulationContext ctx,
 SimulationState from,
 SimulationState to,
 String reason)

Description copied from interface: SimulationListener

Called on every state transition.

Specified by:

onStateChange in interface SimulationListener

Parameters:

ctx - simulation context

from - previous state

to - new state

reason - human-readable reason (may be null)

onInit

public void onInit(SimulationContext ctx)

Description copied from interface: SimulationListener

Called after the engine transitions to SimulationState.INITIALIZING.

Specified by:

onInit in interface SimulationListener

Parameters:

ctx - simulation context

onReady

public void onReady(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when initialization completes and the engine reaches SimulationState.READY.

Specified by:

onReady in interface SimulationListener

Parameters:

ctx - simulation context

onRun

public void onRun(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine begins execution (enters SimulationState.RUNNING).

Specified by:

onRun in interface SimulationListener

Parameters:

ctx - simulation context

onResume

public void onResume(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine resumes from SimulationState.PAUSED back to SimulationState.RUNNING.

Specified by:

onResume in interface SimulationListener

Parameters:

ctx - simulation context

onPause

public void onPause(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine enters SimulationState.PAUSED.

Specified by:

onPause in interface SimulationListener

Parameters:

ctx - simulation context

onDone

public void onDone(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when the engine ends normally (reaches SimulationState.TERMINATED).

Specified by:

onDone in interface SimulationListener

Parameters:

ctx - simulation context

onFail

public void onFail(SimulationContext ctx,
 Throwable error)

Description copied from interface: SimulationListener

Called when the engine fails (reaches SimulationState.FAILED).

Specified by:

onFail in interface SimulationListener

Parameters:

ctx - simulation context

error - the exception/error that caused failure

onCancelRequested

public void onCancelRequested(SimulationContext ctx)

Description copied from interface: SimulationListener

Called when cancellation is requested via SimulationEngine.requestCancel().

This callback occurs on the EDT; the simulation thread observes cancellation via SimulationContext.isCancelRequested().

Specified by:

onCancelRequested in interface SimulationListener

Parameters:

ctx - simulation context

onMessage

public void onMessage(SimulationContext ctx,
 String message)

Description copied from interface: SimulationListener

Called for status/log messages intended for UI display.

Specified by:

onMessage in interface SimulationListener

Parameters:

ctx - simulation context

message - message text (non-null)

onProgress

public void onProgress(SimulationContext ctx,
 ProgressInfo progress)

Description copied from interface: SimulationListener

Called for progress updates (indeterminate or determinate).

Specified by:

onProgress in interface SimulationListener

Parameters:

ctx - simulation context

progress - progress payload

onRefresh

public void onRefresh(SimulationContext ctx)

Default refresh behavior for MDI: repaint the container component.

Specified by:

onRefresh in interface SimulationListener

Parameters:

ctx - simulation context

onSimulationStateChange

protected void onSimulationStateChange(SimulationContext ctx,
 SimulationState from,
 SimulationState to,
 String reason)

Called on the EDT after any engine state transition.

Parameters:

ctx - simulation context

from - previous state

to - new state

reason - human-readable transition reason

onSimulationInit

protected void onSimulationInit(SimulationContext ctx)

Called on the EDT after simulation initialization begins.

onSimulationReady

protected void onSimulationReady(SimulationContext ctx)

Called on the EDT when the initialized simulation becomes ready.

onSimulationRun

protected void onSimulationRun(SimulationContext ctx)

Called on the EDT when the simulation first starts running.

onSimulationResume

protected void onSimulationResume(SimulationContext ctx)

Called on the EDT when a paused simulation resumes.

onSimulationPause

protected void onSimulationPause(SimulationContext ctx)

Called on the EDT when the simulation pauses.

onSimulationDone

protected void onSimulationDone(SimulationContext ctx)

Called on the EDT after normal termination.

onSimulationFail

protected void onSimulationFail(SimulationContext ctx,
 Throwable error)

Called on the EDT after simulation failure.

onSimulationCancelRequested

protected void onSimulationCancelRequested(SimulationContext ctx)

Called on the EDT after the first cancellation request.

onSimulationMessage

protected void onSimulationMessage(SimulationContext ctx,
 String message)

Called on the EDT when the simulation posts a status message.

onSimulationProgress

protected void onSimulationProgress(SimulationContext ctx,
 ProgressInfo progress)

Called on the EDT when the simulation posts progress.

onSimulationRefresh

protected void onSimulationRefresh(SimulationContext ctx)

Called on the EDT before the view repaints in response to a refresh.

replaceEngine

protected final void replaceEngine(SimulationEngine newEngine)

Replace the hosted engine and rebind the control panel on the EDT.

Parameters:

newEngine - replacement engine

requestEngineReset

protected final void requestEngineReset(Supplier<Simulation> simSupplier,
 Consumer<SimulationEngine> afterSwap,
 boolean autoStart,
 boolean refresh)

Replace the engine immediately when safe, or stop the current run and replace it after termination.

Parameters:

simSupplier - creates the replacement simulation

afterSwap - optional engine-configuration callback

autoStart - whether to start the replacement engine

refresh - whether to request an initial refresh

startAndRun

public final void startAndRun()

Start the engine and immediately request that it run, on the EDT.