Skip to content
Snippets Groups Projects
Commit e620ec21 authored by Brutzman, Don's avatar Brutzman, Don
Browse files

project is ready for broad use

parent 67190677
No related branches found
No related tags found
No related merge requests found
# open-dis7-java
Type-safe java implementation of the DIS Protocol v. 7, IEEE 1278.1-2012
**IMPORTANT!** This project is not complete and is in a testing phase. Until this notice is removed, use the DIS libraries under the **open-dis-java** and **Enumerations** projects.
<H2>Building the release</H2>
This source is organized as a Netbeans Ant project. It includes the necessary support files required by Netbeans, specifically, the `nbproject` directory and `build.xml`.
After downloading or cloning the project from the Git repository, a simple `Run->Build Project` from the Netbeans menu should compile the source, as well as produce `open-dis7-java.jar` in then `dist` directory.
The other two artifacts of the build are produced by running two special targets in `build.xml`. Run each target by right-clicking `build.xml`, then selecting `Run Target->Other Targets->targetname`. The two targets to run, in no particular order are `jar-javadoc` and `jar-source`.
The completed build should produce the following files in the `dist` directory:
1. `open-dis7-java.jar`
2. `open-dis7-javadoc.jar`
3. `open-dis7-source.jar`
<H2>DIS Entities</H2>
The SISO specification, which is the foundation for much of the DIS library, enumerates values for a myriad of entity types, which are each descendant from the DIS class, `edu.nps.moves.dis7.EntityType`. Instances of this class are used in several DIS pdus, most notably `edu.nps.moves.dis7.EntityStatePdu`. The entities described by SISO are hierarchically organized by country, kind, domain, category, subcategory and extra values. They cover vehicles, munitions, radios, and sensors, and include entities from air, surface, subsurface, land and space domains.
Not all entities are of value to specific DIS applications. Since the number of classes is large, the spectrum of SISO entities has been partitioned into the following jars, contained in the `entityjars` directory:
1. `open-dis7-entities-usa-air.jar`
2. `open-dis7-entities-usa-land.jar`
3. `open-dis7-entities-usa-munitions.jar`
4. `open-dis7-entities-usa-surface.jar`
5. `open-dis7-entities-usa-all.jar`
6. `open-dis7-entities-chn.jar`
7. `open-dis7-entities-deu.jar`
8. `open-dis7-entities-nato.jar`
9. `open-dis7-entities-rus.jar`
10. `open-dis7-entities-all.jar`
Jar number 10 includes all entities from all countries.
`open-dis7-entities-javadoc.jar` is javadoc describing all entities from all countries.
This project provides a complete implementation of the IEEE DIS Protocol and
associated enumerations from the
[open-dis7-java-source-generator](https://github.com/open-dis/open-dis7-java-source-generator) project.
Additional testing and experimentation is performed in the NPS MOVES
[Networked Graphics MV3500](https://gitlab.nps.edu/Savage/NetworkedGraphicsMV3500) course.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment