Skip to content

Commit ef18bb8

Browse files
committed
Documentation updated.
1 parent 4efdac1 commit ef18bb8

File tree

2 files changed

+11
-8
lines changed

2 files changed

+11
-8
lines changed

aimax-osm/README.txt

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,9 @@ This project provides a framework for building intelligent Open Street Map
66
(OSM) data applications. It was originally designed to validate and test agent
77
and search concepts from the AIMA library in an interesting, non-trivial
88
application area. Meanwhile, it provides a framework for building small
9-
navigation systems.
9+
navigation systems. Two GUIs are provided:
10+
One based on JavaFX (package <code>aimax.osm.gui.fx</code>) and the other based on
11+
Swing (package <code>aimax.osm.gui.swing</code>).
1012

1113
The framework provides interfaces for central parts of the system and additionally
1214
example implementations. In the current version, the fundamental data structures
@@ -17,7 +19,7 @@ demonstrates how to plug the components together and provides means to integrate
1719
own versions of the needed components.
1820

1921
Central part of the project is an OSM viewer implementation. It is designed
20-
as an efficient general purpose viewer which is highly configurable and extendible.
22+
as an efficient general purpose viewer which is highly configurable and extendable.
2123

2224
The internal default map representation is chosen as close as possible to the
2325
original OSM XML file format. A kd-tree is used to improve rendering efficiency.
@@ -26,7 +28,7 @@ visual appearance within the drawn map are controlled by declarative
2628
rendering rules. They can be replaced or configured at runtime.
2729
New personal map styles can be created quite easily. See classes
2830
<code>aimax.osm.viewer.MapStyleFactory</code> and
29-
<code>aimax.osm.application.OsmViewerPlusApp</code> for ideas how that
31+
<code>aimax.osm.gui.swing.applications.OsmViewerPlusApp</code> for ideas how that
3032
can be achieved.
3133

3234
Routing functionality is based on the AIMA-CORE library.
@@ -42,11 +44,12 @@ cities like Berlin can be loaded and displayed without any problem if enough
4244
heap space is provided (VM argument -Xmx500M).
4345

4446
Getting started: Run one of the applications in the
47+
<code>aimax.osm.gui.fx.applications</code> or
4548
<code>aimax.osm.gui.swing.applications</code> package. If no map is displayed
4649
by default, make sure that the main/resource folder is included
4750
in the build path of your project, recompile and start again.
48-
Then, place the mouse inside the map viewer pane. Try mouse-left, mouse-right,
49-
mouse-drag, ctrl-mouse-left, plus button, minus button, shift-plus, shift-minus,
51+
Then, place the mouse inside the map viewer pane. Try mouse-left, mouse-middle,
52+
mouse-right, mouse-drag, ctrl-mouse-left, plus button, minus button, shift-plus, shift-minus,
5053
alt-plus, alt-minus, space, ctrl-space, arrow buttons, and also the mouse-wheel
5154
for navigation, mark setting, and track definition. For routing, at least two
5255
markers must be set.

aimax-osm/src/main/javadoc/overview.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
One based on JavaFX (package <code>aimax.osm.gui.fx</code>) and the other based on
66
Swing (package <code>aimax.osm.gui.swing</code>).
77
The viewer is designed as an efficient general purpose viewer which is highly configurable and
8-
extendible. The internal map representation is chosen as close as possible to the
8+
extendable. The internal map representation is chosen as close as possible to the
99
original OSM XML file format. A kd-tree is used to improve rendering efficiency.
1010
Classification and abstraction of map entities as well as their
1111
visual appearance within the drawn map are controlled by declarative
1212
rendering rules. They can be replaced or configured at runtime.
1313
New personal map styles can be created quite easily. See classes
1414
<code>aimax.osm.viewer.MapStyleFactory</code> and
15-
<code>aimax.osm.gui.swing.application.OsmViewerPlusApp</code> for ideas how that can be
15+
<code>aimax.osm.gui.swing.applications.OsmViewerPlusApp</code> for ideas how that can be
1616
achieved.
1717

1818
<p>Routing functionality is based on the AIMA-JAVA core library.
@@ -30,7 +30,7 @@
3030
in the <code>aimax.osm.gui.fx.applications</code> package. If no map is displayed
3131
by default, make sure that the main/resource folder is included in
3232
the build path of your project, recompile and start again.
33-
Then place the mouse inside the map viewer pane. Try mouse-left, mouse-right,
33+
Then place the mouse inside the map viewer pane. Try mouse-left, mouse-middle, mouse-right,
3434
mouse-drag, ctrl-mouse-left, plus button, minus button, ctrl-plus, ctrl-minus,
3535
space, ctrl-space, arrow buttons, and also the mouse-wheel for navigation,
3636
mark setting, and track definition. Before routing, at least two markers

0 commit comments

Comments
 (0)