Compiling 3Di Viewer “Rei”
Before you start
- Confirm that your system meets the System Requirements for running and developing 3Di Viewer “Rei”.
- Download the source code. We’ll assume you downloaded into a directory named SRC.
- Open Windows Explorer, browse to SRC/3di-viewer-rei/, and double click on “runprebuild2008.bat“. This will create the necessary solution and project files.
Compiling and executing the main application
To get started with compiling and developing 3Di Viewer “Rei”, you only need to compile and run the main application, as described in this section. Compiling other packages (e.g. libraries) is optional, since the libraries are included as binary DLL files in the source code distribution.
From the command-line
- Start a command prompt or terminal window. Note: On Windows Vista, you must run the command prompt as administrator. This is because 3Di Viewer “Rei” registers an ActiveX control, which requires administrator privileges.
- Change the current directory to SRC/3di-viewer-rei.
- Execute COMPILE.BAT. Compilation should complete with some warnings but no errors.
From within Visual Studio
- Start Microsoft Visual C# 2008 Express Edition. Note: On Windows Vista, you must run the program as administrator to register the ActiveX control.
- Select File->Open Project from the main menu.
- Select SRC/3di-viewer-rei/3DiOpenViewer.sln from the dialog box and click Open.
- Press Ctrl+Shift+B to build the entire solution. The build should succeed with some warnings but no errors.
Executing the compiled viewer
After successful compilation, you can run the viewer in one of two ways:
- Standalone: Execute the file SRC/3di-viewer-rei/bin/OpenViewerHost.exe, which runs a stand-alone viewer, OR
- In-browser: Open the file SRC/3di-viewer-rei/bin/test.html in Internet Explorer, which should launch the ActiveX control automatically.
For standalone mode (option 1), you can either run OpenViewerHost.exe in three ways:
- Directly invoke the EXE file from a command prompt, or
- Double click the file in Windows explorer, or
- Run the file from within Visual C#. To do this, in the Solution Explorer window, right-click the OpenViewerHost project and select “Set as Startup Project”. Then press F5 to compile and run. After successfully starting the viewer, you should then see the viewer login screen, in which you can enter grid and user information to login to an OpenSim server.
For in-browser mode (option 2), IE will display a warning bar indicating the presence of an ActiveX control on the test.html page. Click the warning bar, then choose the menu option to allow the ActiveX control to execute, and confirm your choice in the confirmation dialog. The viewer should then start inside the browser, and you should see a splash screen. Using the text fields at the right-hand side of the screen, you can enter grid and user information to login to an OpenSim server.
How to use the viewer
Please see the Frequently Asked Questions for links where you can get more information.