How to install and use 3Di OpenViewer
How to install 3Di OpenViewer?
First and foremost, please note, that the viewer is currently for Windows and 3Di only supports Internet Explorer 6+ and Firefox 3.0 and 3.5 at this time.
Step 1.
IE Users:
Go to http://www.3di-opensim.com/openviewer/ie_install.html
The ActiveX bar will appear, click Install
FF Users:
Go to http://3di-opensim.com/openviewer/ff_install.html
Click on the orange button with the arrow to download and install the plugin.
Step 2.
The installer will appear.
The first screen is only an introduction. It asks you to close other applications before clicking next. The left button says Next, the right one is Cancel.
The second screen is the EULA. I won’t try to translate it to english, you can get a raw English version by pushing this through any online translation service. The long and the short of it was summarized in these two sentences:
1) No commercial use
2) No reverse engineering
The first radio button says Agree, the second says Disagree. Again the buttons are Back, Next and Cancel in that order. I guess it is pretty difficult to Agree with something you can’t read (I always feel that way in Japan 
). There are no traps in there and as long as you don’t use it to become a millionaire celebrity without 3Di’s consent, you should be alright. (If you happen to be a millionaire celebrity already, you should definitely contact us )
The next screen has three buttons saying Back, Install and Cancel respectively. After clicking Install, it will start the automatic install process. When it finishes, you can click on the Finish button on the next screen.
How do I embed the Viewer on a web page?
If you just want to try the viewer out, you can head to this page: http://zaki.asia/3di/ov/index.html
You can of course see (and therefore use yourself) the HTML and JS codes that are used to embed the viewer. Please keep in mind though that 3Di is just about to make these available officially (and more conveniently) very soon as well.
You can see some details about changing the login behavior from javascript here: http://zaki.asia/?p=46
Is it possible to use 3Di OpenViewer in English?
This question is asked many times lately, so here’s a short guide on how to do it. Please do note, that this is sort of a pre-release thing, that might in some places be a little rough around the edges. And if you find any leftover Japanese text after the switch, do let me know.
When you install the viewer, and open a page with the viewer embedded, it will appear in default Japanese locale, but it is possible to change this to English. There are two ways to do it: you can log in to an OpenSim grid with the Japanese version and change the locale from the menu, or you could change the configuration file to make the viewer appear in English from the first login page. Either method you choose, you will have to start the viewer at least once (to initialize the necessary directories and configuration files).
Method 1 – Using the menu
Using the login screen, specify the login URI, first name, last name and password in that order, then click on the button to log in.
After you log in, move the cursor towards the upper right corner until the menu appears. Click on the wrench icon to go to settings. The last selectbox on the first tab is the locale, you should select the first option and press OK. A dialog will appear telling you that the settings will be effective after you restart the viewer. Do so, and the UI will appear in English now.
Method 2 – Changing the configuration file
After you start the viewer, the configuration file will be created in your local settings directory. On XP, this will be in Documents and Settings/<username>/Local Settings/Application Data/3Di/OpenViewer/, while on Vista and Win7, this will be in Users/<username>/AppData/LocalLow/3Di/OpenViewer
Open the file in configs/ called OpenViewer.ini and change locale to en
locale = en
Start the viewer again and it should be in English now.
Can I connect to OpenSim grids?
The short answer is ‘yes’. The long answer is ‘yes, but’. You can definitely log in to OpenSim grids with the current release version and prims will display. However textures and the avatar will not currently appear. The reason for this is that assets are not downloaded through the region server. We are working on a fully compatible version that we will release in the future, but for the moment to get the full experience, unfortunately you will have to connect to 3Di’s servers. We are also preparing more demo servers, but I have to ask for just a little more patience on that.
If you try 3Di OpenViewer, your feedback is always appreciated.
Race for a Web viewer is on - Hypergrid Business
[...] To switch the language from Japanese to English, I followed the instructions from Zaki: [...]
Maria Korolov
Zaki — This is fantastic news for the OpenSim business community. Having a usable Web-based browser will be a major step forward in making OpenSim more accessible to the general public. 3Di is doing a great service here.
I can’t wait to see the next version of this viewer. In addition to textures, will you also be adding support for inventory access and hypergrid teleports? And will it be possible to access Second Life using this viewer?
Again, thank you so much for the effort you guys have put into this. It is greatly appreciated!
– Maria Korolov, editor, Hypergrid Business
Gwyneth Llewelyn
Astonishing work indeed
And I’m glad for the instructions in English hehe — now the only things I need are a Windows PC and a login to 3Di’s grid (or, well, if Hypergrid works…)
Electroman
This works with Second Life?
Nithin
This is amazing. Never thought i would see a browser based viewer. Cant wait to see the next version with textures.
Zaki
Hi Nithin,
3Di has released the viewer as open source and my changes for the texture download are included, so you can connect to opensim and see the textures.
Take a look at http://3di-rei.org for more info.
Virtual
I tried to login to the 3DI server but only see a skybox there using Firefox. With internet explorer I get nothing except a tiny dot in the center of the viewer window that seems to move it bit. The dot is a few pixels large.
I did manage to connect to OSgrid by using your viewer template here on your blog, when using Firefox everything renders well, I can even use the high detail settings and see the day night cycle in the skybox and the water renders fine. With internet explorer using Windows XP service pack 2 nothing happens.
I can run just about anything without problems but for some reasons Internet Explorer isn’t doing anything. I did run the standard viewer from within your application folder and then I could browse the default store just fine but no avatar showed there not even a cloud. In OSgrid I see myself as a cloud. Looking forward to see more improvement.
Keep up the good work
Mariana Hristova
Hi. I’m very happy to rich 3Di viewer REI. I start the compilation, on the last step: compile the main Firefox plugin i have Build failed – from Visual C++ express compiler, with next message:
1>Compiling…
1>plugin.cpp
1>c:\src\3di-viewer-rei-firefox\npopenviewer\npplat.h(36) : fatal error C1083: Cannot open include file: ‘npupp.h’: No such file or directory
1>nsScriptablePeer.cpp
1>c:\src\xulrunner-sdk\include\plugin\nptypes.h(98) : fatal error C1083: Cannot open include file: ‘stdint.h’: No such file or directory
1>npp_gate.cpp
1>c:\src\xulrunner-sdk\include\plugin\nptypes.h(98) : fatal error C1083: Cannot open include file: ‘stdint.h’: No such file or directory
1>npn_gate.cpp
1>c:\src\xulrunner-sdk\include\plugin\nptypes.h(98) : fatal error C1083: Cannot open include file: ‘stdint.h’: No such file or directory
1>np_entry.cpp
1>c:\src\xulrunner-sdk\include\plugin\nptypes.h(98) : fatal error C1083: Cannot open include file: ‘stdint.h’: No such file or directory
1>Generating Code…
1>Build log was saved at “file://c:\SRC\3di-viewer-rei-firefox\npOpenViewer\Debug\BuildLog.htm”
1>npOpenViewer – 5 error(s), 0 warning(s)
========== Build: 0 succeeded, 1 failed, 0 up-to-date, 0 skipped ==========
Did someone can help me,please to solve that problem!!!Thank’s!
Zaki
Hi Mariana,
You are probably using xulrunner 1.9.1. There has been some change in that minor version (like npupp.h renamed to npfunctions.h). I can see the same problem now on my environment with 1.9.1 so I’ll investigate and try to fix it.
In the meantime, you can use 1.9.0, that should work properly.
Let me know how it goes.
Mariana Hristova
Thank you very much, Zaki!Everything is working very well!!!
Mariana Hristova
Hello Zaki, I tried to instal 3Di Rei Viewer on Vista and on a last step – compiling the Firefox plugin with the Visual C# 2008 express compiler.I had this message for 3 errors:
Error 1 The type or namespace name ‘Viewer’ could not be found (are you missing a using directive or an assembly reference?) C:\SRC\3di-viewer-rei-firefox\3DiOpenViewer\bootstrap\Bootstrap.cs 43 26 OpenViewer.bootstrap
Error 2 The type or namespace name ‘OpenViewerConfigSource’ could not be found (are you missing a using directive or an assembly reference?) C:\SRC\3di-viewer-rei-firefox\3DiOpenViewer\bootstrap\Bootstrap.cs 45 26 OpenViewer.bootstrap
Error 3 The type or namespace name ‘Viewer’ could not be found (are you missing a using directive or an assembly reference?) C:\SRC\3di-viewer-rei-firefox\3DiOpenViewer\bootstrap\Bootstrap.cs 167 26 OpenViewer.bootstrap
Can you give me,please an advice, how to repair this?!
Thank’s
Mariana Hristova
Hello is there someone?! I have to solve the problem of the compilation as soon it is posible…Thank’s
Mariana Hristova
I tryed with Fifefox 3.6 Beta version…
Zaki
Hi Mariana,
From the error you gave above, it seems that you don’t have the core viewer binaries in place.
Before you can compile the firefox plugin, you will need to compile the core viewer (3di/3di-viewer-rei on github – this is because the firefox codes require a non-bsd license). When that is done, copy the following dlls to the firefox source’s bin\ folder:
Adapter.dll
Interfaces.dll
Nini.dll
OpenViewer.dll
OpenMetaverse.dll
OpenMetaverseTypes.dll
Then you should be able to build the c# bootstrap project and then the firefox plugin (c++) project. The process is unfortunately not very streamlined if you use express edition of visual studio.
For step-by-step instructions, you can always refer to http://3di-rei.org/developers/compiling-3di-viewer-rei/compiling-3di-viewer-rei-firefox-plugin/index.html
Let me know how this works, or if it still doesn’t, which step fails for you.
Mariana
Thank you very much. Now Rei is instaled correctly, but OpenViewerHost.exe could not open the texture file…I can’t open Open Sim. Is there any solution?!