Editing FAQ

There is a web-based ORBITER discussion forum hosted by M6.net where you can post general questions/suggestions or bug reports. Just click at the "Web Forum" button on the navigator bar.  

You can also join the [http://firedrake.org/orbiter/list.html ORBITER mailing list] to exchange email with other users to get the latest hints and tricks.  

Before submitting a bug report make sure you have the latest version, and that the problem is not already addressed in this FAQ or the forum.

As a last resort, you can email me directly, but I cannot guarantee that I will be able to answer all Orbiter posts.

Is Orbiter free and virus free

I don't announce release dates and feature lists. This is mainly because Orbiter is a hobby of mine, and I don't need the pressure of working against a deadline or fixed specification. I can't always predict how much time I can spend on Orbiter, so the interval between releases will vary. The features added in a new version are usually a mixture of my own ideas and user requests.

Occasionally screen shots of the upcoming version will be posted on the Gallery page, just to keep the suspense up.  

Remember you need only the "Base" and "Textures" packages to run Orbiter. Everything else is optional. Select a download mirror close to your location, and if necessary, try several (try to avoid the medphys server, because excessive demand on that server will get me into trouble ;)

If you have a slow connection, you may try at a different time of day when net traffic is lower. A download manager may help as well. Please note that I am not able to provide a CD distribution service, although Orbiter occasionally features on magazine cover discs (so this may be your last option).  

===Does Orbiter run under Linux?===

Not on its own. It is designed and compiled especially for Windows. There are currently no plans to port Orbiter to Linux. As additional trouble, the Orbiter SDK is especially designed for Windows, making all addons limited to a Windows environment, as well.

It is also currently not possible to run Orbiter under a Windows emulator like "Wine", because of DirectX (but this might change if technology advances).

It IS possible however to use VMware Player to emulate Windows, and run Orbiter that way. Unfortunately, this is only possible if you already have a Windows license.

===How can I create/import spacecraft into Orbiter?===

===Where can i get an apollo program Addon?===

Currently you can get two [[Addons]] for Orbiter, which allow you to simulate the famous apollo missions:

* [[NASSP]], a very realistic and challenging interpretation ([http://sourceforge.net/projects/nassp/ Addon home])

* [[AMSO]], a less complex, but more userfriendly interpretation ([http://www.acsoft.ch/AMSO/amso.html Addon home])

For beginners, its recommended to begin excercising the missions with AMSO, and switch to NASSP later.

The basic Orbiter installation doesn't include sound, but there is a popular addon available which adds this functionality: DanSteph's [[OrbiterSound]] plugin, available from his homepage or from the Orbiter file repository at AVSIM.

Sometimes this problem occurs if a new version is installed over an old one. It is strongly recommended to always install new versions from scratch into a new directory rather than overwriting an existing installation. Installing from scratch can also solve problems caused by addons which are no longer compatible with a new version. If you suspect a problem may be caused by an addon, re-install your addons one at a time and see whether you can identify the culprit. If you can, you may consider notifying the author of the addon.  

This problem usually occurs if you forget to restore the Orbiter directory tree when extracting the packages. When using WinZip or a similar utility to unpack the Orbiter packages, you need to activate the "Use folder names" option (or an equivalent option to that effect). After unpacking the Base and Textures packages, your Orbiter root directory should contain (amongst other things):  

The orbiter executable (Orbiter.exe)

If all files ended up in a single directory, you made a mistake when unpacking.

===I can see the scenario list, but the Start button is inactive and I can't launch any scenarios.===

The scenario list contains directories (indicated by the folder icons next to them) and scenarios (indicated by the red delta-glider icons). The Orbiter Launch button remains inactive as long as a directory is selected in the list. You must select a scenario entry before you can launch orbiter. After a fresh installation there will be no scenarios in the top-level directory, so you need to step down into one of the subdirectories (by double-clicking on them) to access a scenario.  

===Orbiter takes a long time to load.===

ORBITER loads a large number of texture maps (mainly planetary surfaces) during startup. Loading these maps will be very slow if your graphics card does not support texture compression, because textures must then be decompressed on the fly. To reduce the loading time (and the amount of memory required for textures):

Disable high-resolution textures if you have any. High-resolution textures are located in the Textures2 subdirectory. The easiest way to disable them is to rename the directory. Orbiter will then use the lower-resolution textures in the Textures directory.

Turn off visual effects in the "Visual effects" tab of the Orbiter Launchpad dialog. In particular the Cloud layers and Specular water reflections options are texture-intensive.

B5. I get a low frame rate.

Make sure you have selected a hardware render device in the "Video" tab of the Orbiter Launchpad dialog (for example "Direct3D HAL" or "Direct3D HAL T&L"). Avoid the much slower software devices, such as "RGB Emulation".  

Here are a couple of possible solutions: Quit other programs running in the background. Run Orbiter in fullscreen mode. Use a lower screen resolution and lower colour depth (16 bit). Reduce planetary texture resolutions and don't use the highres planetary textures. Reduce the number of background stars. Turn off object shadows. (Most of these options can be adjusted in the Orbiter Launchpad dialog.)

 

===Orbiter fails to run.===

 

===My joystick is not responding.===

Make sure you have enabled the joystick in the "Joystick" tab of the Orbiter Launchpad dialog.  

In vacuum, aerodynamic control surfaces obviously have no effect - the spacecraft orientation can only be controlled with the RCS.

Conversely, in a dense atmosphere, the RCS may be too weak for attitude control. Control surfaces will be more effective.

In linear RCS mode, the joystick will not rotate the spacecraft, but add to the linear velocity vector.

If your joystick has a throttle control, you can use it to manipulate the main engines. If your throttle control is not responding, try selecting a different throttle axis from the Launchpad dialog.  

===Orbit deteriorates at 1000x and 10000x time acceleration.===

Orbiter uses discrete time stepping for dynamics, essentially approximating smooth trajectories by piecewise linear segments. This is reasonably accurate for small time steps, but at extreme time acceleration a full orbit may be sampled by very few steps, at which point the method falls apart. As a rule of thumb: Don't use 1000x acceleration when your trajectory changes rapidly, e.g. in a low orbit. On the other hand, en-route to Mars 1000x acceleration should be safe.

Orbiter now includes the option to "stabilise" orbits under certain circumstances. A stabilised orbit is assumed to be an unperturbed Keplerian orbit which can be solved analytically with a 2-body solution. This prevents orbital stations from falling out of the sky while you are on your way to Mars at 10000x time acceleration. A vessel orbit will not be stabilised if it engages its thrusters, if aerodynamic forces are acting on it, or if perturbations of the central body's gravitational field are larger than a user-defined threshold.

===Orbiter dies unexpectedly during startup ...===

... and the Orbiter.log file shows something like

ERROR: Destroy framework objects failed

This orbiter log message is a generic indicator that something went wrong and orbiter tried a shutdown during which it couldn't remove all its previously created graphics objects.

This could be caused by any number of problems, for example by low system memory, by a graphics driver problem, another process running in the background, a misbehaving addon, or by a bug in the Orbiter core.  

Try running a fresh orbiter installation (without any addons), use a low-resolution video resolution (say 800x600), try different video devices, turn off all the options in the "Visual parameters" tab, and don't use any high-resolution textures.  

If nothing helps, your last option may be posting a message on the forum with as much information about your system (hardware, OS, graphics drivers, DirectX version etc.) as possible. With any luck, somebody with a similar system may have a solution.

===An add-on is not working===

See also: [[Debugging add-ons]]

==Running Orbiter==

===I've installed Orbiter, how do I start?===

Assuming you have configured the video and other options in the Orbiter Launchpad dialog, you are ready to take off. Pick a scenario from the list, and click the "ORBITER" button.  

In a nutshell, the most important controls are on the numerical pad of your keyboard: Ctrl+ for increasing main thrust, Ctrl- for decreasing main thrust or engaging retros, Ins and Del for increasing/decreasing hovers (if available), and cursor keys for attitude controls. You should read the Orbiter manual in the Doc folder for a full list of keyboard functions, as well as explanations of the instrumentation.  

To reach orbit from a planetary surface, you need to do two things: attain sufficient altitude, and sufficient tangential velocity. The first point is easy, but unless you reach sufficient tangential velocity, you will simply fall back to Earth again in a ballistic trajectory. The required velocity depends on the orbit altitude and planet mass. For example, a low Earth orbit (LEO) requires a velocity of more than 7000 metres/second.

Orbital launchers usually take off vertically to clear the dense part of the atmosphere quickly, before pitching down to add to the tangential velocity component. You should always launch into a prograde orbit (towards the east) and from a base close to the equator to utilise the planet's rotation. Orbit insertion normally occurs in two stages: the initial burn leads to a ballistic trajectory with an apoapsis (highest point) outside the atmosphere, and a second (orbit insertion) burn takes place at the highest point of the trajectory (apoapsis) to raise the periapsis (lowest point of the orbit).

If you are new to Orbiter, you should try your first orbit insertions with one of the more powerful spacecraft, like the Delta-glider. The more realistic launchers, like the Space Shuttle, don't provide much margin for error. If you feel ready to take on the Shuttle, make sure you turn on the "limited fuel" option. With unlimited fuel, the Shuttle is too heavy to reach orbit!

===I want to rendezvous with the ISS, but I can't even get close.===

===I can get close to the ISS, but haven't succeeded in docking.===

Once you get close to your target (see C3), use the Docking HUD mode and the Docking MFD for final approach. The Docking HUD contains relative velocity indicators which help you close in on your target. You need to tune your navigation radios to the target's transmitter frequency to make use of the docking instrumentation. (You can find the target's transponder frequency (XPDR) in the vessel info sheet (Ctrl-I). Set one of your navigation radios (Shift-C) to that frequency, and slave the HUD and Docking MFD to the appropriate receiver.)

In the final approach stage, switch the nav receiver to one of the target's IDS (instrument docking system) frequencies, if available. This will activate approach path indicators in the HUD, and docking indicators in the MFD, to guide you to your final docking position.

===How can I get from Earth to the Moon/Mars?===

Orbiter now includes Duncan Sharpe's TransX MFD mode, which is a great tool for setting up interplanetary routes. You need to activate the TransX module in the Orbiter Launchpad dialog to use this.

===I want to see imperial units instead of metric.===

All internal calculations performed by Orbiter are done in metric units (metre, second, kilogram, Joule, Pascal, etc.), for the simple reason that this is the only system I am familiar and comfortable with, and it is widely used by the scientific community. Likewise, all standard instrument readouts and data displays are in metric units (with very few exceptions, like the use of astronomical units (AU) for large distances). There is however nothing preventing an addon developer from implementing instruments which display their data in a different unit system, and it would be entirely possible to write imperial unit replacements for all standard MFDs. Just don't expect them to feature in the stock Orbiter distribution. If you want to see feet, fathoms, stones, barns or quarts, you will probably have to code them yourself.

===I am looking for "ApD" in the Orbit MFD, but I have no idea where the "ApD" is.===

'''ApD''' ('''Ap'''ogee '''D'''istance) and '''PeD''' ('''Pe'''rigee '''D'''istance) have been renamed '''ApR''' ('''Ap'''ogee '''R'''adius) and '''PeR''' ('''Pe'''rigee '''R'''adius) in [[Orbit MFD]], but they represent the same measurement. Each value is still the distance between highest (ApR) or lowest (PeR) points of your current orbit and the center of the [[planet]]/[[natural satellite|moon]] you're orbiting, and the distance between the center of a circle or orbit and a point on it is called radius.

If you only see '''ApA''' ('''Ap'''oapsis '''A'''ltitude) and '''PeA''' ('''Pe'''riapsis '''A'''ltitude) in the MFD, press {{Key|SHIFT}} + {{Key|D}} to switch to the radius display mode.

In the [[Launch Pad (Dialog)|Launch Pad]] dialog, select the tab "Modules" and select the module for the MFD you want to activate. If you are not sure, which module contains which MFD, read the documentation for the MFD.

==Deltaglider Mk.4==

===Why can't I use the retro thrusters?===

You need to open the retro thruster covers first. You can find the retro cover controls in the control dialog ({{Key|CTRL}} + {{Key|Space}}) and in the 3D [[virtual cockpit]].

==M6.net Forum Questions==

===I'm trying to post a pic...===

You need an image host on the internet such as Photobucket or imageshack.us. Try Google or another search site and use keyword "image hosting".  

to get one to show up on the forum:

# Click the "insert image" icon in the message post window. It's the one with the little picture of mountains just to the right of the bold, itialic, and underlines icons. That will give you a pair of image tags. (img and /img both surrounded by brackets: [])

# Now split the tags apart and put your photo link in between:

# For photobucket use the url link. (The one without the image tags inserted) Then insert that link between the img tags you called up earlier. So my link looks like this:

Simply: when writing your post you insert the direct image URL between the two <nowiki>[img][/img]</nowiki> tags. (Without the periods after img)

Final Note - If your browser does not support the image insert icon in the post edit box, just manually type the <nowiki>[img]</nowiki> tags. It works just as well.