# API CHANGES FROM 1.0-ALPHA TO 1.0-BETA

JBotSim is advancing towards the release of version 1.0.
We took the opportunity of the "beta" cycle to make a number of scheduled API 
changes.

The main changes removed AWT & SWING dependencies of non-UI classes  (in view
of enabling JBotSim on other platforms like Android). 
Most changes impact only the "imports" in your programs + other minor changes.

Please contact us (contact@jbotsim.io)  would you have some trouble migrating
your code.

Main changes:

- (import) awt.Color -> jbotsim.Color

- (import) awt.Point2D -> jbotsim.Point

- (import) jbotsim.Point3D -> jbotsim.Point

- (import) jbotsim.ui -> jbotsimx.ui

- (Topology) getDimension -> deleted (please use getWidth + getHeight directly)

- (Topology) fromString, toString, fromFile, toFile -> moved to jbotsimx.format

- (Node) basicColors -> moved to the new jbotsim.Color

- (internals) DefaultClock is now a timerless thread looping without delay.
  You can ignore this if you are using the classical JViewer or JTopology.

- (Topology) start() must be called explicitly once the simulation is set up

The last change is certainly the most critical, as the previous behavior
of the topology was to start automatically (by default). Now, it does not start
automatically, and start() must be called at the end of the simulation set up.

Note: If you want to start in a paused stated, but still want your nodes to 
have executed their onStart() method before that, you may simply call start() 
on your topology immediately followed by a call to pause().
(Eventually we will provide an atomic call to this effect.)