Disorder

h1. Disorder

Disorder is a practical and modern C++ "Distributed Interactive Simulation":http://en.wikipedia.org/wiki/Distributed_interactive_simulation (DIS) library that implements the "IEEE":http://www.ieee.org 1278 standard.

Disorder is "free":http://www.gnu.org/philosophy/free-sw.html, "open source":http://www.opensource.org/docs/definition.php, and released under the comprehensible and liberal terms of the "MIT License":http://www.opensource.org/licenses/mit-license.php.

h2. Features

Some of the main features of Disorder are:

* full support for 1278.1-1995 PDUs

* partial support for 1278.1-1998 and 1278.1-2012 PDUs (see "limitations":http://disorder.squalllinesoftware.com/docs/manual/disorder_user_manual.html#_limitations in the User Manual for details)

* built-in simulation entity, transmitter, and designator management

* built-in dead reckoning of entities and articulated parts

* geospatial coordinate conversion

* extensible framework for logging, PDU manipulation and transmission, defining and handling custom PDUs, etc.

* optionally uses multiple threads to take advantage of modern multi-core CPUs

* included SISO compliant enumerations and bitfields headers

* basic support for working with DI Guy custom PDUs

* leverages the goodness provided by other open source projects including "ASIO":http://think-async.com, "Eigen":http://eigen.tuxfamily.org, "SEDRIS":http://www.sedris.org, "GeographicLib":https://geographiclib.sourceforge.io, and "Google Test":https://github.com/google/googletest

* extensive test suite to prove correctness and robustness across versions and platforms

* good documentation

h2. Documentation

* [[Installation]]

* "User Manual":http://disorder.squallline.com/docs/manual/disorder_user_manual.html

* "API Reference Manual":http://disorder.squallline.com/docs/api

* Examples are included in the source tree

h2. Contributing

h3. Bug Reports and Feature Requests

These things are handled through this redmine instance.  Just make yourself a new account and submit your complaints and problems as new issues.

h3. Patches

Patches should be submitted to our "Review Board":https://rb.squalllinesoftware.com/oss thingy.  That way we can review them and provide you with feedback for each submission allowing you to track the progress of the patch.  You'll need to make an account on our review board site and then you'll be able to submit things in any of the following ways:

* using the web interface

* using @rbt post@ from RBTools for which you can find "installation instructions":http://www.reviewboard.org/docs/rbtools/dev/ on the Review Board website

* using the mercurial "ReviewBoard extension":http://mercurial.selenic.com/wiki/ReviewboardExtension directly in your repository clone

If you use rbt or the mercurial extension, inform it that the Review Board server you want to talk to is at

@https://rb.squalllinesoftware.com/oss@.

h3. Contract Work

The library author can be contracted to add features to the library, integrate the library into your project, or whatever else you want within reason.

h3. Monetary Contributions

We accept donations in the form of old school check in USD only via snail mail.  Why do we only use arcane technology for this?  Simple.  We don't want your donations to be fleeced by 3rd party clowns.

Make your check payable to Squall Line Software, LLC and send to:

Squall Line Software, LLC

3000 Murrell Rd #1512

Rockledge, FL 32956

Please indicate that your donation should go toward Disorder development and provide some information about yourself and some way for us to contact you to properly thank you for your contribution.

h2. I Hate This Stupid Thing!

Perhaps you may enjoy these other open source DIS implementations:

* "OpenDIS":http://open-dis.org/

* "KDIS":http://kdis.sourceforge.net/