DIS-rust

A rust implementation of the DIS simulation protocol.

Getting Started

Introductions to DIS can be found here:

• Integrating the DIS Standards Into a Fully-Immersive Simulation Application
• DIS Plain and Simple: an Introduction to DIS

Currently supported DIS PDUs are:

• Entity State PDU
• Fire PDU
• Detonation PDU
• Event Report PDU

Note that it is up to the application to decode simulation-specific enumerations. A good starting point are the SISO enumerations.

Prerequisites

Requirements for the software and other tools to build, test and push:

• rust
• cargo
• clippy

Installing

The easiest way to include this crate in your project is to simply add the following to your Cargo.toml file:

dis-rust = "0.2.10"

Documentation

Further documentation can be found on docs.rs.

Running the tests

Unit tests can be run using cargo:

cargo test

Style tests

Clippy will complain about the linting within dis-rust due the DIS enumerations.

Rustc will complain about the DIS procotol version enumerations in the PDU header record. These warnings have been disabled in-line within the source code.

Versioning

We use Semantic Versioning for versioning. For the versions available, see the tags on this repository.

Authors

• Thomas Mann - Original Author - tom.mann@coffeebreakdevs.co.uk

License / Copyright

This project is dual licensed under the AGPLv3.0 License - see the LICENSE file for details.

It is also available under a commerical license. Please email contact@coffeebreakdevs.co.uk for more details.

Copyright (C) 2022 Thomas Mann