RootModel (Artisynth API documentation)

java.lang.Object
- artisynth.core.modelbase.ModelComponentBase
- - artisynth.core.modelbase.ComponentList<ModelComponent>
  - - artisynth.core.modelbase.ModelBase
    - - artisynth.core.modelbase.RenderableModelBase
      - artisynth.core.workspace.RootModel

All Implemented Interfaces:

ComponentChangeListener, ComponentListView<ModelComponent>, CompositeComponent, HasMenuItems, HasState, IndexedComponentList, Model, ModelComponent, MutableCompositeComponent<ModelComponent>, ParameterizedClass, RenderableComponent, java.awt.event.ActionListener, java.lang.Cloneable, java.lang.Iterable<ModelComponent>, java.util.Collection<ModelComponent>, java.util.EventListener, HasProperties, HierarchyNode, HasRenderProps, IsRenderable, IsSelectable, Renderable, Disposable, ListView<ModelComponent>, Scannable

Direct Known Subclasses:

AjlCollisionTest, ArticulatedBeamBody, ArticulatedDemo, ArticulatedFem, AttachDemo, AttachedBeamBody, AttachedBeamDemo, BallPlateCollide, BeamBodyCollide, BlockTest, BlockTestX, ColoredMeshDemo, ColoredSphereTest, CompliantConstraintDemo, ConstrainedParticle, CoupledSolveDemo, CylinderWrapping, DicomLoader, DicomTest, DoubleArmDemo, DrawModeTest, EditableMeshTest, FallingSkull, Fem3dBlock, FemBeam, FemBeam3d, FemBeamMech, FemBeamTest, FemCollision, FemCollisions, FemEmbeddedSphere, FemFrictionBeam, FemMuscleBeams, FemMuscleDemo, FemMuscleHeart, FemPlaneCollide, FemSkinDemo, FemSurfaceTargetDemo, FemWithBeamBody, FishDemo, ForceTargetDemo, FrameBodyAttachment, FrameFemAttachment, FrameSpringDemo, Hello, HexFrame, HydrostatDemo, InstancedRenderingTest, JointedFemBeams, LaymanBowl, LaymanDemo, LinearAuxiliaryTest, LockingDemo, LumbarFrameSpring, LumbarSpringDemo, MappingDemo, MassSpringDemo, MechModelCollide, MechModelDemo, MeshBodyTest, MeshEditTest, MeshTestBase, MultiSpringDemo, MultiSpringTest, MuscleArm, NetDemo, NetDemo, ParticleAttachment, ParticleSpring, PenetrationRender, PenetrationRendererDemo, PlanarConnectorDemo, PointFemAttachment, PointModel, PressureShell, QuadFishDemo, QuadraticLockingDemo, RigidBodyCollision, RigidBodyDemo, RigidBodyJoint, RigidBodySpring, RigidCompositeCollide, RollPitchJointDemo, SDGridTest, SegmentedPlaneDemo, SimpleCollide, SimpleMuscle, SinCosMonitorProbe, SingleHex, SinglePyramid, SingleQuadhex, SingleQuadpyramid, SingleQuadtet, SingleQuadwedge, SingleTet, SingleWedge, SkinDemo, SkullParticles, SphericalJointDemo, SphericalTextureMapping, SpinControlProbe, SpongeDemo, SpringMeshDemo, TextTest, TorusDemo, TorusWrapTest, TransverseIsotropy, TransverseIsotropyTest, TubeDemo, TwoStrandWrapBase
```
public class RootModel
extends RenderableModelBase
implements Disposable
```
RootModel is the top-most model of an ArtiSynth model hierarchy. It contains a list of models, plus a number of other workspace components such as probes, controller, monitors, and control panels.

Nested Class Summary
- Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent
  ModelComponent.NavpanelVisibility
- Nested classes/interfaces inherited from interface artisynth.core.modelbase.CompositeComponent
  CompositeComponent.NavpanelDisplay

Field Summary

Fields
Modifier and Type Field and Description

static PropertyList myProps

static boolean testSaveAndRestoreState
- Fields inherited from class artisynth.core.modelbase.ComponentList
  DEFAULT_NAVPANEL_DISPLAY
- Fields inherited from class artisynth.core.modelbase.ModelComponentBase
  enforceUniqueCompositeNames, enforceUniqueNames, myNumber, NULL_OBJ, useCompactPathNames
- Fields inherited from interface maspack.render.IsRenderable
  TRANSPARENT, TWO_DIMENSIONAL

Fields
Modifier and Type	Field and Description
`static PropertyList`	`myProps`
`static boolean`	`testSaveAndRestoreState`

Constructor Summary

Constructors
Constructor and Description

RootModel()
Empty constructor, for creating a basic class instance

RootModel(java.lang.String name)
Constructor used to build the model

Constructors
Constructor and Description
`RootModel()` Empty constructor, for creating a basic class instance
`RootModel(java.lang.String name)` Constructor used to build the model

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`WayPoint`	`addBreakPoint(double t)`
`void`	`addComponentChangeListener(ComponentChangeListener l)`
`void`	`addController(Controller controller)`
`void`	`addController(Controller controller, Model model)`
`void`	`addControlPanel(ControlPanel panel)`
`void`	`addControlPanel(ControlPanel panel, int idx)`
`void`	`addInputProbe(Probe probe)`
`void`	`addInputProbe(Probe probe, int idx)`
`void`	`addModel(Model model)`
`void`	`addMonitor(Monitor monitor)`
`void`	`addMonitor(Monitor monitor, Model model)`
`void`	`addOutputProbe(Probe probe)`
`void`	`addOutputProbe(Probe probe, int idx)`
`IsRenderableHolder`	`addRenderable(Renderable renderable)`
`void`	`addRenderable(RenderableComponent comp)`
`TracingProbe`	`addTracingProbe(Traceable traceable, java.lang.String traceName, double startTime, double stopTime)` Convenience routine to add a tracing probe to this RootModel.
`WayPoint`	`addWayPoint(double t)`
`void`	`addWayPoint(WayPoint way)`
`StepAdjustment`	`advance(double t0, double t1, int flags)` Advances this object from time t0 to time t1.
`void`	`applyControllers(java.util.List<Controller> list, double t0, double t1)`
`void`	`applyInputProbes(java.util.List<Probe> list, double t)`
`void`	`applyMonitors(java.util.List<Monitor> list, double t0, double t1)`
`void`	`applyOutputProbes(java.util.List<Probe> list, double t1, artisynth.core.workspace.RootModel.ModelInfo info)`
`void`	`attach(DriverInterface driver)` Attach this root model to a driver program
`void`	`build(java.lang.String[] args)`
`void`	`checkWrite(java.lang.String str)`
`void`	`clear()`
`void`	`clearRenderables()`
`void`	`clearTraces()`
`void`	`clearTracing(Traceable tr)`
`void`	`componentChanged(ComponentChangeEvent e)` Notifies this composite component that a change has occured within one or more of its descendants.
`ComponentState`	`createState(ComponentState prevState)` Factory routine to create a state object for this component, which can then be used as an argument for `HasState.setState(artisynth.core.modelbase.ComponentState)` and `HasState.getState(artisynth.core.modelbase.ComponentState)`.
`void`	`detach(DriverInterface driver)` Detach this root model from a driver program.
`void`	`disableAllTracing()`
`boolean`	`disableTracing(Traceable tr)`
`void`	`dispose()` Called when the model is discarded.
`void`	`enableTracing(Traceable tr)`
`java.lang.String`	`getAbout()` Returns a text string giving a short description of this model.
`boolean`	`getAdaptiveStepping()`
`PropertyList`	`getAllPropertyInfo()` Returns a list giving static information about all properties exported by this object.
`ComponentListView<Controller>`	`getControllers()`
`ComponentListView<ControlPanel>`	`getControlPanels()`
`javax.swing.JTabbedPane`	`getControlPanelTabs()`
`AxisAngle`	`getDefaultViewOrientation()` Obtains the default orientation that should be used for viewing this model.
`void`	`getInitialState(ComponentState newstate, ComponentState oldstate)` Gets an initial state for this component and returns the value in `state`.
`ComponentList<Probe>`	`getInputProbes()`
`javax.swing.JFrame`	`getMainFrame()`
`GLViewer`	`getMainViewer()`
`double`	`getMinStepSize()`
`ComponentListView<Monitor>`	`getMonitors()`
`double`	`getNextAdvanceTime(java.util.List<Probe> probes, double stepSize, double t0, double t1)`
`int`	`getNumTraceables()`
`RenderableComponentList<Probe>`	`getOutputProbes()`
`static RootModel`	`getRoot(ModelComponent comp)` Find the most immediate RootModel, if any, that is an ancestor of a specified component.
`void`	`getState(ComponentState state)` Get the current state of this component.
`boolean`	`getStopRequest()`
`java.util.Collection<Traceable>`	`getTraceSet()`
`TracingProbe`	`getTracingProbe(Traceable tr, java.lang.String propName)`
`java.util.LinkedList<TracingProbe>`	`getTracingProbes()`
`Point3d`	`getViewerCenter()`
`Point3d`	`getViewerEye()`
`WayPoint`	`getWayPoint(double t)`
`boolean`	`getWaypointChecking()`
`WayPointProbe`	`getWayPoints()`
`static boolean`	`hasRoot(ModelComponent comp)` Queries if a specified component has a RootModel as an ancestor.
`boolean`	`hasState()` Queries if this component has state.
`boolean`	`hasTracingProbes()`
`void`	`initialize(double t)` Causes this model to initialize itself at time t.
`boolean`	`isCheckEnabled()`
`static boolean`	`isFocusable()`
`boolean`	`isTracing(Traceable tr)`
`ControlPanel`	`loadControlPanel(java.lang.String filename)`
`void`	`mergeAllControlPanels(boolean combine)`
`void`	`mergeControlPanel(boolean combine, ControlPanel panel)`
`ComponentListView<Model>`	`models()`
`void`	`notifyParentOfChange(ComponentChangeEvent e)` Notifies the parent of this component (if any) of changes within in its descendants.
`void`	`notifyStructureChanged(java.lang.Object comp)`
`void`	`postscan(java.util.Deque<ScanToken> tokens, CompositeComponent ancestor)` Performs any required post-scanning for this component.
`void`	`prerender(RenderList list)` Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates).
`void`	`removeAllControllers()`
`void`	`removeAllControlPanels()`
`void`	`removeAllInputProbes()`
`void`	`removeAllModels()`
`void`	`removeAllMonitors()`
`void`	`removeAllOutputProbes()`
`void`	`removeAllWayPoints()`
`boolean`	`removeComponentChangeListener(ComponentChangeListener l)`
`boolean`	`removeController(Controller controller)`
`boolean`	`removeControlPanel(ControlPanel panel)`
`boolean`	`removeInputProbe(Probe probe)`
`boolean`	`removeModel(Model model)`
`boolean`	`removeMonitor(Monitor monitor)`
`boolean`	`removeOutputProbe(Probe probe)`
`boolean`	`removeRenderable(Renderable renderable)`
`boolean`	`removeRenderable(RenderableComponent comp)`
`boolean`	`removeWayPoint(WayPoint way)`
`void`	`render(Renderer renderer, int flags)` Render this object using the functionality of the supplied `Renderer`.
`RenderableComponentList<RenderableComponent>`	`renderables()`
`void`	`rerender()`
`void`	`scan(ReaderTokenizer rtok, java.lang.Object ref)` Scans this element from a ReaderTokenizer.
`void`	`scanProbes(ReaderTokenizer rtok)`
`void`	`setAdaptiveStepping(boolean enable)`
`void`	`setCheckEnabled(boolean enable)`
`void`	`setDefaultValues()` Sets the attributes of this component to their default values.
`void`	`setDefaultViewOrientation(AxisAngle REW)` Sets the default orientation that should be used for viewing this model to `REW`.
`static void`	`setFocusable(boolean focusable)`
`void`	`setMainViewer(GLViewer v)`
`void`	`setMaxStepSize(double step)` Sets the maximum step size by which this model should be advanced within a simulation loop.
`void`	`setMinStepSize(double step)`
`void`	`setState(ComponentState state)` Set the state of this component.
`void`	`setStopRequest(boolean req)` If set true, tells the scheduler to stop simulating this root model.
`void`	`setTracingProbesVisible(boolean visible)`
`void`	`setViewerCenter(Point3d c)`
`void`	`setViewerEye(Point3d e)`
`void`	`setViewerUp(Vector3d up)`
`void`	`setWaypointChecking(boolean enable)`
`void`	`stopAdvance()` This is used by the scheduler to interrupts the current call to advance and cause state to be restored to that of the start time for the advance.
`void`	`updateBounds(Vector3d pmin, Vector3d pmax)` Update the minimum and maximum points for this object.
`void`	`writeProbes(java.io.PrintWriter pw, NumberFormat fmt)`

Methods inherited from class artisynth.core.modelbase.RenderableModelBase
createRenderProps, getRenderHints, getRenderProps, getSelection, isSelectable, numSelectionQueriesNeeded, setRenderProps

Methods inherited from class artisynth.core.modelbase.ModelBase
actionPerformed, copy, getInitialState, getMaxStepSize, getMenuItems, hierarchyContainsReferences, preadvance, setInitialState

Methods inherited from class artisynth.core.modelbase.ComponentList
add, add, addAll, addComponents, addFixed, addNumbered, clone, contains, contains, containsAll, copy, ensureCapacity, findComponent, get, get, getByNumber, getChildren, getNavpanelDisplay, getNumberLimit, getShortName, getTypeParameter, hasChildren, hasParameterizedType, indexOf, invalidateNumbers, isEmpty, iterator, nextComponentNumber, numComponents, remove, remove, removeAll, removeAll, removeComponents, retainAll, set, setNavpanelDisplay, setNumbered, setNumberingStartAtOne, setShortName, size, toArray, toArray, updateNameMap

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface artisynth.core.modelbase.ModelComponent
connectToHierarchy, disconnectFromHierarchy, getHardReferences, getName, getNavpanelVisibility, getNumber, getParent, getSoftReferences, isFixed, isMarked, isSelected, setFixed, setMarked, setName, setNumber, setParent, setSelected, updateReferences

Methods inherited from interface maspack.properties.HasProperties
getProperty

Methods inherited from interface maspack.properties.HierarchyNode
getChildren, hasChildren

Methods inherited from interface maspack.util.Scannable
isWritable, write

Methods inherited from interface artisynth.core.modelbase.ComponentListView
getName

Methods inherited from interface java.lang.Iterable
forEach, spliterator

Methods inherited from interface java.util.Collection
equals, hashCode, parallelStream, removeIf, spliterator, stream

- Field Detail
  - testSaveAndRestoreState
```
public static boolean testSaveAndRestoreState
```
  - myProps
```
public static PropertyList myProps
```
- Constructor Detail
  - RootModel
```
public RootModel()
```
    Empty constructor, for creating a basic class instance
  - RootModel
```
public RootModel(java.lang.String name)
```
    Constructor used to build the model
    
    Parameters:
    
    name - the name of the new model
- Method Detail
  - setFocusable
```
public static void setFocusable(boolean focusable)
```
  - isFocusable
```
public static boolean isFocusable()
```
  - build
```
public void build(java.lang.String[] args)
           throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - getAbout
```
public java.lang.String getAbout()
```
    Returns a text string giving a short description of this model.
    
    Returns:
    
    text description of this model
  - setDefaultValues
```
public void setDefaultValues()
```
    Description copied from class: ModelComponentBase
    
    Sets the attributes of this component to their default values.
  - getAdaptiveStepping
```
public boolean getAdaptiveStepping()
```
  - setAdaptiveStepping
```
public void setAdaptiveStepping(boolean enable)
```
  - getMinStepSize
```
public double getMinStepSize()
```
  - setMinStepSize
```
public void setMinStepSize(double step)
```
  - setMaxStepSize
```
public void setMaxStepSize(double step)
```
    Description copied from class: ModelBase
    
    Sets the maximum step size by which this model should be advanced within a simulation loop.
    
    Overrides:
    
    setMaxStepSize in class ModelBase
    
    Parameters:
    
    step - maximum step size (seconds)
  - getAllPropertyInfo
```
public PropertyList getAllPropertyInfo()
```
    Description copied from interface: HasProperties
    
    Returns a list giving static information about all properties exported by this object.
    
    Specified by:
    
    getAllPropertyInfo in interface HasProperties
    
    Overrides:
    
    getAllPropertyInfo in class RenderableModelBase
    
    Returns:
    
    static information for all exported properties
  - models
```
public ComponentListView<Model> models()
```
  - addModel
```
public void addModel(Model model)
```
  - removeModel
```
public boolean removeModel(Model model)
```
  - removeAllModels
```
public void removeAllModels()
```
  - addMonitor
```
public void addMonitor(Monitor monitor)
```
  - addController
```
public void addController(Controller controller)
```
  - addRenderable
```
public IsRenderableHolder addRenderable(Renderable renderable)
```
  - removeRenderable
```
public boolean removeRenderable(Renderable renderable)
```
  - addRenderable
```
public void addRenderable(RenderableComponent comp)
```
  - removeRenderable
```
public boolean removeRenderable(RenderableComponent comp)
```
  - clearRenderables
```
public void clearRenderables()
```
  - renderables
```
public RenderableComponentList<RenderableComponent> renderables()
```
  - getMainViewer
```
public GLViewer getMainViewer()
```
  - setMainViewer
```
public void setMainViewer(GLViewer v)
```
  - getMainFrame
```
public javax.swing.JFrame getMainFrame()
```
  - setViewerCenter
```
public void setViewerCenter(Point3d c)
```
  - getViewerCenter
```
public Point3d getViewerCenter()
```
  - setViewerEye
```
public void setViewerEye(Point3d e)
```
  - getViewerEye
```
public Point3d getViewerEye()
```
  - setViewerUp
```
public void setViewerUp(Vector3d up)
```
  - getDefaultViewOrientation
```
public AxisAngle getDefaultViewOrientation()
```
    Obtains the default orientation that should be used for viewing this model. A value of 0 indicates that no orientation is specified.
    
    Returns:
    
    default rotational transform from eye to world coordinates
  - setDefaultViewOrientation
```
public void setDefaultViewOrientation(AxisAngle REW)
```
    Sets the default orientation that should be used for viewing this model to REW. Setting a value of 0 indicates that no orientation is specified and so the viewer should use its default view.
    
    Parameters:
    
    REW - rotational transform from eye to world coordinates
  - addMonitor
```
public void addMonitor(Monitor monitor,
                       Model model)
```
  - removeMonitor
```
public boolean removeMonitor(Monitor monitor)
```
  - removeAllMonitors
```
public void removeAllMonitors()
```
  - getMonitors
```
public ComponentListView<Monitor> getMonitors()
```
  - addController
```
public void addController(Controller controller,
                          Model model)
```
  - removeController
```
public boolean removeController(Controller controller)
```
  - removeAllControllers
```
public void removeAllControllers()
```
  - getControllers
```
public ComponentListView<Controller> getControllers()
```
  - addControlPanel
```
public void addControlPanel(ControlPanel panel)
```
  - addControlPanel
```
public void addControlPanel(ControlPanel panel,
                            int idx)
```
  - removeControlPanel
```
public boolean removeControlPanel(ControlPanel panel)
```
  - removeAllControlPanels
```
public void removeAllControlPanels()
```
  - getControlPanels
```
public ComponentListView<ControlPanel> getControlPanels()
```
  - loadControlPanel
```
public ControlPanel loadControlPanel(java.lang.String filename)
```
  - addInputProbe
```
public void addInputProbe(Probe probe)
```
  - addInputProbe
```
public void addInputProbe(Probe probe,
                          int idx)
```
  - removeInputProbe
```
public boolean removeInputProbe(Probe probe)
```
  - removeAllInputProbes
```
public void removeAllInputProbes()
```
  - getInputProbes
```
public ComponentList<Probe> getInputProbes()
```
  - addTracingProbe
```
public TracingProbe addTracingProbe(Traceable traceable,
                                    java.lang.String traceName,
                                    double startTime,
                                    double stopTime)
```
    Convenience routine to add a tracing probe to this RootModel. The probe is created for a specified trace of a Traceable component. Start and stop times are given in seconds. The probe's update interval is set to the maximum step size of this RootModel, and the render interval is set to 50 msec.
    
    Parameters:
    
    traceable - component to be traced
    
    traceName - name of the trace
    
    startTime - start time (seconds)
    
    stopTime - stop time (seconds)
    
    Returns:
    
    created tracing probe
  - addOutputProbe
```
public void addOutputProbe(Probe probe)
```
  - addOutputProbe
```
public void addOutputProbe(Probe probe,
                           int idx)
```
  - removeOutputProbe
```
public boolean removeOutputProbe(Probe probe)
```
  - removeAllOutputProbes
```
public void removeAllOutputProbes()
```
  - getOutputProbes
```
public RenderableComponentList<Probe> getOutputProbes()
```
  - hasTracingProbes
```
public boolean hasTracingProbes()
```
  - setTracingProbesVisible
```
public void setTracingProbesVisible(boolean visible)
```
  - getWayPoints
```
public WayPointProbe getWayPoints()
```
  - addWayPoint
```
public void addWayPoint(WayPoint way)
```
  - addWayPoint
```
public WayPoint addWayPoint(double t)
```
  - addBreakPoint
```
public WayPoint addBreakPoint(double t)
```
  - removeWayPoint
```
public boolean removeWayPoint(WayPoint way)
```
  - getWayPoint
```
public WayPoint getWayPoint(double t)
```
  - removeAllWayPoints
```
public void removeAllWayPoints()
```
  - getTracingProbe
```
public TracingProbe getTracingProbe(Traceable tr,
                                    java.lang.String propName)
```
  - enableTracing
```
public void enableTracing(Traceable tr)
```
  - isTracing
```
public boolean isTracing(Traceable tr)
```
  - disableTracing
```
public boolean disableTracing(Traceable tr)
```
  - clearTracing
```
public void clearTracing(Traceable tr)
```
  - getTracingProbes
```
public java.util.LinkedList<TracingProbe> getTracingProbes()
```
  - disableAllTracing
```
public void disableAllTracing()
```
  - clearTraces
```
public void clearTraces()
```
  - getTraceSet
```
public java.util.Collection<Traceable> getTraceSet()
```
  - getNumTraceables
```
public int getNumTraceables()
```
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface java.util.Collection<ModelComponent>
    
    Overrides:
    
    clear in class ComponentList<ModelComponent>
  - prerender
```
public void prerender(RenderList list)
```
    Description copied from interface: IsRenderable
    
    Called prior to rendering to allow this object to update the internal state required for rendering (such as by caching rendering coordinates). The object may add internal objects to the list of objects being rendered, by calling
    list.addIfVisible (obj);
    for each of the objects in question.
    
    Specified by:
    
    prerender in interface IsRenderable
    
    Overrides:
    
    prerender in class RenderableModelBase
    
    Parameters:
    
    list - list of objects to be rendered
  - updateBounds
```
public void updateBounds(Vector3d pmin,
                         Vector3d pmax)
```
    Description copied from interface: IsRenderable
    
    Update the minimum and maximum points for this object. In an x-y-z coordinate system with x directed to the right and y directed upwards, the minimum and maximum points can be thought of as defining the left-lower-far and right-upper-near corners of a bounding cube. This method should only reduce the elements of the minimum point and increase the elements of the maximum point, since it may be used as part of an iteration to determine the bounding cube for several different objects.
    
    Specified by:
    
    updateBounds in interface IsRenderable
    
    Overrides:
    
    updateBounds in class RenderableModelBase
    
    Parameters:
    
    pmin - minimum point
    
    pmax - maximum point
  - render
```
public void render(Renderer renderer,
                   int flags)
```
    Description copied from interface: IsRenderable
    
    Render this object using the functionality of the supplied Renderer.
    
    Specified by:
    
    render in interface IsRenderable
    
    Specified by:
    
    render in class RenderableModelBase
    
    Parameters:
    
    renderer - provides the functionality used to perform the rendering.
    
    flags - flags that may be used to control different aspects of the rendering. Flags are defined in Renderer and currently include Renderer.HIGHLIGHT and Renderer.SORT_FACES.
  - rerender
```
public void rerender()
```
  - initialize
```
public void initialize(double t)
```
    Causes this model to initialize itself at time t. This method will be called at the very beginning of the simulation (with t = 0), or immediately after the model's state has been reset using HasState.setState(artisynth.core.modelbase.ComponentState), in which case t may have an arbitrary value.
    
    Specified by:
    
    initialize in interface Model
    
    Overrides:
    
    initialize in class ModelBase
    
    Parameters:
    
    t - initialization time (seconds)
  - attach
```
public void attach(DriverInterface driver)
```
    Attach this root model to a driver program
    
    Parameters:
    
    driver - Interface giving access to the frame and viewer
  - detach
```
public void detach(DriverInterface driver)
```
    Detach this root model from a driver program.
    
    Parameters:
    
    driver - Interface giving access to the frame and viewer
  - addComponentChangeListener
```
public void addComponentChangeListener(ComponentChangeListener l)
```
  - removeComponentChangeListener
```
public boolean removeComponentChangeListener(ComponentChangeListener l)
```
  - componentChanged
```
public void componentChanged(ComponentChangeEvent e)
```
    Description copied from class: ComponentList
    
    Notifies this composite component that a change has occured within one or more of its descendants. When this occurs, the composite may need to invalidate cached information that depends on the descendants.
    This method should propagate the notification up the component hierarchy by calling notifyParentOfChange.
    
    Specified by:
    
    componentChanged in interface ComponentChangeListener
    
    Specified by:
    
    componentChanged in interface CompositeComponent
    
    Overrides:
    
    componentChanged in class ComponentList<ModelComponent>
    
    Parameters:
    
    e - optional argument giving specific information about the change
  - notifyStructureChanged
```
public void notifyStructureChanged(java.lang.Object comp)
```
  - hasState
```
public boolean hasState()
```
    Description copied from interface: ModelComponent
    
    Queries if this component has state. Structure change events involving components that have state will cause the current state history of of the system to be cleared.
    
    Specified by:
    
    hasState in interface ModelComponent
    
    Overrides:
    
    hasState in class ModelComponentBase
    
    Returns:
    
    true if this component has state
  - createState
```
public ComponentState createState(ComponentState prevState)
```
    Factory routine to create a state object for this component, which can then be used as an argument for HasState.setState(artisynth.core.modelbase.ComponentState) and HasState.getState(artisynth.core.modelbase.ComponentState). The state object does not have to be set to the component's current state. If the component does not have any state information, this method should return an instance of EmptyState.
    
    Specified by:
    
    createState in interface HasState
    
    Overrides:
    
    createState in class ModelBase
    
    Parameters:
    
    prevState - If non-null, supplies a previous state that was created by this component and which can be used to provide pre-sizing hints.
    
    Returns:
    
    new object for storing this component's state
  - setState
```
public void setState(ComponentState state)
```
    Set the state of this component.
    
    Specified by:
    
    setState in interface HasState
    
    Overrides:
    
    setState in class ModelBase
    
    Parameters:
    
    state - state to be copied
  - getState
```
public void getState(ComponentState state)
```
    Get the current state of this component.
    
    Specified by:
    
    getState in interface HasState
    
    Overrides:
    
    getState in class ModelBase
    
    Parameters:
    
    state - receives the state information
  - getInitialState
```
public void getInitialState(ComponentState newstate,
                            ComponentState oldstate)
```
    Description copied from interface: HasState
    
    Gets an initial state for this component and returns the value in state. If prevstate is non-null, then it is assumed to contain a previous initial state value returned by this method, and state should be set to be as consistent with this previous state as possible. For example, suppose that this component currently contains subcomponents A, B, and C, while the prevstate contains the state from a previous time when it had components B, C, and D. Then state should contain substate values for B and C that are taken from prevstate. To facilitate this, the information returned in state should contain additional information such as the identities of all the (current) sub-components.
    
    Specified by:
    
    getInitialState in interface HasState
    
    Overrides:
    
    getInitialState in class ModelBase
    
    Parameters:
    
    newstate - receives the state information
    
    oldstate - previous state information; may be null.
  - advance
```
public StepAdjustment advance(double t0,
                              double t1,
                              int flags)
```
    Description copied from class: ModelBase
    
    Advances this object from time t0 to time t1.
    If the method determines that the step size should be reduced, it can return a StepAdjustment object indicating the recommended reduction. Otherwise, the method may return null
    
    Specified by:
    
    advance in interface Model
    
    Specified by:
    
    advance in class ModelBase
    
    Parameters:
    
    t0 - current time (seconds)
    
    t1 - new time to advance to (seconds)
    
    flags - reserved for future use
    
    Returns:
    
    null, or a step adjustment recommendation
  - applyInputProbes
```
public void applyInputProbes(java.util.List<Probe> list,
                             double t)
```
  - applyControllers
```
public void applyControllers(java.util.List<Controller> list,
                             double t0,
                             double t1)
```
  - applyMonitors
```
public void applyMonitors(java.util.List<Monitor> list,
                          double t0,
                          double t1)
```
  - applyOutputProbes
```
public void applyOutputProbes(java.util.List<Probe> list,
                              double t1,
                              artisynth.core.workspace.RootModel.ModelInfo info)
```
  - getNextAdvanceTime
```
public double getNextAdvanceTime(java.util.List<Probe> probes,
                                 double stepSize,
                                 double t0,
                                 double t1)
```
  - stopAdvance
```
public void stopAdvance()
```
    This is used by the scheduler to interrupts the current call to advance and cause state to be restored to that of the start time for the advance.
  - setStopRequest
```
public void setStopRequest(boolean req)
```
    If set true, tells the scheduler to stop simulating this root model. Will be set to false by the scheduler when simulation is started.
    
    Parameters:
    
    req - if true, requests a simulation stop
  - getStopRequest
```
public boolean getStopRequest()
```
  - scanProbes
```
public void scanProbes(ReaderTokenizer rtok)
                throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - writeProbes
```
public void writeProbes(java.io.PrintWriter pw,
                        NumberFormat fmt)
                 throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - scan
```
public void scan(ReaderTokenizer rtok,
                 java.lang.Object ref)
          throws java.io.IOException
```
    Scans this element from a ReaderTokenizer. The expected text format is assumed to be compatible with that produced by write.
    
    Specified by:
    
    scan in interface ModelComponent
    
    Specified by:
    
    scan in interface Scannable
    
    Overrides:
    
    scan in class ComponentList<ModelComponent>
    
    Parameters:
    
    rtok - Tokenizer from which to scan the element
    
    ref - optional reference object which can be used for resolving references to other objects
    
    Throws:
    
    java.io.IOException - if an I/O or formatting error occured
  - postscan
```
public void postscan(java.util.Deque<ScanToken> tokens,
                     CompositeComponent ancestor)
              throws java.io.IOException
```
    Performs any required post-scanning for this component. This involves handling any information whose processing was deferred during the scan() method and stored in the token queue. The most common use of this method is to resolve the paths of component references, which may not have been created at the time of the initial scan() call.
    
    Specified by:
    
    postscan in interface ModelComponent
    
    Overrides:
    
    postscan in class ComponentList<ModelComponent>
    
    Parameters:
    
    tokens - token information that was stored during scan().
    
    ancestor - ancestor component with respect to which reference component paths are defined.
    
    Throws:
    
    java.io.IOException - if an error is encountered (such as a reference to a non-existent component)
  - dispose
```
public void dispose()
```
    Description copied from class: ModelBase
    
    Called when the model is discarded. Disposes of any resources used.
    
    Specified by:
    
    dispose in interface Model
    
    Specified by:
    
    dispose in interface Disposable
    
    Overrides:
    
    dispose in class ModelBase
  - setWaypointChecking
```
public void setWaypointChecking(boolean enable)
```
  - getWaypointChecking
```
public boolean getWaypointChecking()
```
  - isCheckEnabled
```
public boolean isCheckEnabled()
```
  - setCheckEnabled
```
public void setCheckEnabled(boolean enable)
```
  - checkWrite
```
public void checkWrite(java.lang.String str)
```
  - mergeAllControlPanels
```
public void mergeAllControlPanels(boolean combine)
```
  - getControlPanelTabs
```
public javax.swing.JTabbedPane getControlPanelTabs()
```
  - mergeControlPanel
```
public void mergeControlPanel(boolean combine,
                              ControlPanel panel)
```
  - notifyParentOfChange
```
public void notifyParentOfChange(ComponentChangeEvent e)
```
    Notifies the parent of this component (if any) of changes within in its descendants. This is done by calling the parent's componentChanged method.
    
    Specified by:
    
    notifyParentOfChange in interface ModelComponent
    
    Overrides:
    
    notifyParentOfChange in class ModelComponentBase
    
    Parameters:
    
    e - optional argument giving specific information about the change
  - getRoot
```
public static RootModel getRoot(ModelComponent comp)
```
    Find the most immediate RootModel, if any, that is an ancestor of a specified component.
    
    Parameters:
    
    comp - component to seek RootModel for
    
    Returns:
    
    Most immediate RootModel ancestor, or null
  - hasRoot
```
public static boolean hasRoot(ModelComponent comp)
```
    Queries if a specified component has a RootModel as an ancestor.
    
    Parameters:
    
    comp - component to query
    
    Returns:
    
    true if comp has a RootModel as an ancestor.

Class RootModel

Nested Class Summary

Nested classes/interfaces inherited from interface artisynth.core.modelbase.ModelComponent

Nested classes/interfaces inherited from interface artisynth.core.modelbase.CompositeComponent

Field Summary

Fields inherited from class artisynth.core.modelbase.ComponentList

Fields inherited from class artisynth.core.modelbase.ModelComponentBase

Fields inherited from interface maspack.render.IsRenderable

Constructor Summary

Method Summary

Methods inherited from class artisynth.core.modelbase.RenderableModelBase

Methods inherited from class artisynth.core.modelbase.ModelBase

Methods inherited from class artisynth.core.modelbase.ComponentList

Methods inherited from class artisynth.core.modelbase.ModelComponentBase

Methods inherited from class java.lang.Object

Methods inherited from interface artisynth.core.modelbase.ModelComponent

Methods inherited from interface maspack.properties.HasProperties

Methods inherited from interface maspack.properties.HierarchyNode

Methods inherited from interface maspack.util.Scannable

Methods inherited from interface artisynth.core.modelbase.ComponentListView

Methods inherited from interface java.lang.Iterable

Methods inherited from interface java.util.Collection

Field Detail

testSaveAndRestoreState

myProps

Constructor Detail

RootModel

RootModel

Method Detail

setFocusable

isFocusable

build

getAbout

setDefaultValues

getAdaptiveStepping

setAdaptiveStepping

getMinStepSize

setMinStepSize

setMaxStepSize

getAllPropertyInfo

models

addModel

removeModel

removeAllModels

addMonitor

addController

addRenderable

removeRenderable

addRenderable

removeRenderable

clearRenderables

renderables

getMainViewer

setMainViewer

getMainFrame

setViewerCenter

getViewerCenter

setViewerEye

getViewerEye

setViewerUp

getDefaultViewOrientation

setDefaultViewOrientation

addMonitor

removeMonitor

removeAllMonitors

getMonitors

addController

removeController

removeAllControllers

getControllers

addControlPanel

addControlPanel

removeControlPanel

removeAllControlPanels

getControlPanels

loadControlPanel

addInputProbe

addInputProbe

removeInputProbe

removeAllInputProbes