Project

General

Profile

Wiki » History » Version 33

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