Project

General

Profile

Wiki » History » Version 36

Tony Ciavarella, 08/15/2022 04:28 PM

1 1 Tony Ciavarella
h1. Disorder
2
3 18 Tony Ciavarella
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.
4 1 Tony Ciavarella
5 12 Tony Ciavarella
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.
6 1 Tony Ciavarella
7
h2. Features
8
9
Some of the main features of Disorder are:
10
* full support for 1278.1-1995 PDUs
11 34 Tony Ciavarella
* 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)
12 31 Tony Ciavarella
* built-in simulation entity, transmitter, and designator management
13 30 Tony Ciavarella
* built-in dead reckoning of entities and articulated parts
14 1 Tony Ciavarella
* geospatial coordinate conversion
15
* extensible framework for logging, PDU manipulation and transmission, defining and handling custom PDUs, etc.
16
* optionally uses multiple threads to take advantage of modern multi-core CPUs
17
* included SISO compliant enumerations and bitfields headers
18 32 Tony Ciavarella
* basic support for working with DI Guy custom PDUs
19 25 Tony Ciavarella
* 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
20 8 Tony Ciavarella
* extensive test suite to prove correctness and robustness across versions and platforms
21 4 Tony Ciavarella
* good documentation
22 5 Tony Ciavarella
23
h2. Documentation
24
25 6 Tony Ciavarella
* [[Installation]]
26 36 Tony Ciavarella
* "User Manual":http://disorder.squallline.com/docs/manual/disorder_user_manual.html
27
* "API Reference Manual":http://disorder.squallline.com/docs/api
28 21 Tony Ciavarella
* Examples are included in the source tree
29 6 Tony Ciavarella
30 5 Tony Ciavarella
h2. Contributing
31 13 Tony Ciavarella
32 15 Tony Ciavarella
h3. Bug Reports and Feature Requests
33
34
These things are handled through this redmine instance.  Just make yourself a new account and submit your complaints and problems as new issues.
35
36
h3. Patches
37
38 22 Tony Ciavarella
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:
39 15 Tony Ciavarella
* using the web interface
40 17 Tony Ciavarella
* using @rbt post@ from RBTools for which you can find "installation instructions":http://www.reviewboard.org/docs/rbtools/dev/ on the Review Board website
41 15 Tony Ciavarella
* using the mercurial "ReviewBoard extension":http://mercurial.selenic.com/wiki/ReviewboardExtension directly in your repository clone
42
43 17 Tony Ciavarella
If you use rbt or the mercurial extension, inform it that the Review Board server you want to talk to is at
44 22 Tony Ciavarella
@https://rb.squalllinesoftware.com/oss@.
45 15 Tony Ciavarella
46 29 Tony Ciavarella
h3. Contract Work
47
48
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.
49
50 15 Tony Ciavarella
h3. Monetary Contributions
51
52
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.
53
54
Make your check payable to Squall Line Software, LLC and send to:
55
Squall Line Software, LLC
56 33 Tony Ciavarella
3000 Murrell Rd #1512
57
Rockledge, FL 32956
58 15 Tony Ciavarella
59
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.
60
61 13 Tony Ciavarella
h2. I Hate This Stupid Thing!
62
63 14 Tony Ciavarella
Perhaps you may enjoy these other open source DIS implementations:
64 35 Tony Ciavarella
* "OpenDIS":http://open-dis.org/
65 13 Tony Ciavarella
* "KDIS":http://kdis.sourceforge.net/