Project

General

Profile

Wiki » History » Revision 36

Revision 35 (Tony Ciavarella, 12/23/2021 03:32 PM) → Revision 36/38 (Tony Ciavarella, 08/15/2022 04:28 PM)

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 Manual":http://disorder.squalllinesoftware.com/docs/manual/disorder_user_manual.html 
 * "API Reference Manual":http://disorder.squallline.com/docs/api Manual":http://disorder.squalllinesoftware.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/