2L DIGITAL FSX800

 

This is a small add-on to Microsoft Flight Simulator X. It connects FSX with the eMagin Z800 3DVisor headset. The head-tracking data from the headset gyroscopes is sent to FSX and controls the view direction (eg in 3D cockpit mode) to match exactly the direction the headset is looking.

Installation

Download the zip file at the bottom of this page and unzip it to a location of your choice.

You need to have the eMagin software and drivers installed to use the FSX800. However, before starting FSX800, shut down the eMagin Z800 3DVisor Software Utility. Otherwise FSX800 will not be able to connect to the headset.

There are two ways to run the add-on: Manually starting the FSX800.exe, or auto-starting it with FSX through the EXE.xml file

Manually starting FSX800

Simply double click the FSX800.exe in the main FSX800 directory. If FSX is already running it will attach right then, otherwise it will connect to FSX when you start it.

You can also create a short cut and start the exe with the command line options described below.

Auto-starting FSX800 with FSX

Copy the exe.xml file from the main FSX800 directory into the FSX main configuration directory:

  • On Windows XP this is located at: C:\Documents and Settings\<your username>\Application Data\Microsoft\FSX
  • On Windows Vista this is located at: C:\Users\<your username>\AppData\Roaming\Microsoft\FSX

Open the exe.xml in a text editor (eg Microsoft Notepad) and look for this line: <Path>C:\Program Files\FSX800\FSX800.exe</Path> Replace the path with the path where you extracted the FSX800 zip file.

Below this line there is a line with command line options that you can change according to the descriptions below: <CommandLine>/keyCenter:Shift+c /noConsole</CommandLine>

If you have configured everything correctly, the next time you start FSX it will attempt to launch the Add-On. It will ask for you confirmation to "trust" the add-on. This a security feature to avoid spreading viruses/other malicious code through FSX. Go ahead an trust the add-on.

Configuration options

You can start the FSX800.exe with several command line options to change its behavior.

/keyCenter:<keyname>
Specify a key you want to use to center the headset. You can always center the headset through the Add-On menu inside FSX. Additionally you can map a keyboard key (eg. "c"), key combination (eg. "Shift+c") or joystick button (eg. "joystick:0:button:0") to call this function. For examples of key names check the file "C:\Program Files\Microsoft Games\Microsoft Flight Simulator X\Standard.xml"

/noConsole
By default FSX800 will open a text window with information about its connection status and error messages. This command line option can be used to suppress this window.

Using the Z800 with FSX

Unfortunately FSX does not allow you to select 800x600 as a video resolution in the settings menu. However you can manually edit the configuration file in "C:\Documents and Settings\<your username>\Application Data\Microsoft\FSX\fsx.CFG".

Find the line which reads Mode=1024x768x32 (or whatever resolution you selected in the menu) and replace it with Mode=800x600x32

You will have to do this change every time you change setting in the settings menu, as FSX will reset your resolution to 1024x768

Stereo viewing with FSX

I have successfully run the Z800 with the NVIDIA stereo drivers version 91.31 and an NVIDIA Geforce 6800 graphics card. The default stereo separation values are quite high, you will want to decrease them quite a bit (default key combo: Ctrl + F3)

Compiling FSX800 yourself

FSX800 comes with full source code. It's a pretty small and simple program. If you know how to program, I encourage you to compile it yourself and play around with it.

To compile FSX800 you need these 3 things:

  • Microsoft Visual Studio 2005. The free Visual C++ Express Edition can be used, you will however need to install the Microsoft Platform SDK according to the instructions that come with the Express Edition. Other compilers or older versions of Visual Studio can probably be used with small modifications to the code.
  • eMagin SDK Version 2.2. Check the 3DVisor website how to get access to that.
  • Microsoft Flight Simulator X SDK. This ships with the Deluxe version of the game. Updates for it are available on the Flight Simulator download page.

You will probably have to adjust the include and library paths of the FSX800 project so that it can find the EMADevice files from the eMagin SDK and the SimConnect files from the FSX SDK. I have both SDKs installed in the parent directory of the FSX800 sources directory.

After successful compilation, copy the DLLs from the main FSX800 directory into the directories of your compiled exe. Testing and debugging changes to the add-on is pretty easy thanks to the SimConnect remote connection mechanism to FSX. Just run FSX all the time in a window and start and stop the add-on directly from Visual Studio.

Download

FSX add-on with source code (ZIP, 108 KB)


For further information or suggestions contact: Lutz Latta (llatta at 2ld.de)


:: Back home

<Last update: 13 December 2006>