This library was created to develop addons for the Orbiter spaceflight simulator in Rust. It uses the cxx crate for creating Rust bindings for the Orbiter SDK. A fairly complicated addon complete with a landing guidance system built using these bindings can be found at: https://github.com/thomasantony/surveyor
The crate can now be imported and used like a library. A demo implementation can be found in examples/Surveyor/surveyor.rs
. An addon module must include a struct implementing the OrbiterVessel
trait. Then it must use the init_vessel!
macro to generate the code that links it to Orbiter SDK. For example:
init_vessel!(
fn init(vessel) {
Surveyor::new(vessel)
}
fn exit() {}
);
TODO
- Download/Install Orbiter
- Install Visual Studio 2019
- Install Rust using
rustup
(https://rustup.rs) - Install the win32 target by running
rustup target add i686-pc-windows-msvc
This addon has been tested with Rust 1.57.0 and Visual Studio 2019 Commuity Edition on Windows 10. Running cargo build
should build the project generate a DLL file.
Once you build the addon, you should have a file called Surveyor.dll
in target/i686-pc-windows-msvc/debug/examples/
. Copy this file to the Modules
folder in your Orbiter installation. Also copy over the files in the Config
, Meshes
and Scenarios
folders into the corresponding folders in your Orbiter installation. Launch the SurveyorInOrbit
scenario in Orbiter and make sure that the spacecraft shows up. Pressing "L" should activate the retro thruster firing sequence.
Only a limited number of Orbiter functions are now available to Rust bindings. This list will expand in the future to hopefully include all of Orbiter SDK. Pull requests are welcome!
The meshes in the demo addon were adapted from the Surveyor 1.0 Orbiter Addon. These were updated based on the tutorial at https://www.orbiterwiki.org/wiki/Vessel_Tutorial_1.
An older proof-of-concept for building MFDs can be found at https://github.com/thomasantony/RustMFD. However, this uses an outdated and modified version of cxx
and may not build at this time and exists just as a reference. The code in that repo will be moved over to this one at some point in the future.
- Uses
.cargo/config
to force i686 as target