Build Stereo VR Tours from Rendered Stereo Cubemaps – Initial Test Release
- Initial Release (23 February 2017)
- Currently only compatible with 6X1 STEREO Cubestrips. That basically means 12X1 with a resolution of 18432 X 1536. Any other resolution will crash or hang.
Possible future features
- Support for mono 6X1 Cubestrips
- Support for mono and stereo 2X1 Equirectangular images
- Option to choose various different types of hotspot icons
- Set and Control the Tour’s control bar colours, opacity etc
- A possible future feature in KRPano will eliminate the need for ImageMagick in MY SCRIPT
- Option to remove the included HTML5 security cors XML tag
This script is for owner’s of KRPano (version 1.19-pr8 Recommended). If you don’t already own it, you can get a free demo from here. (Script is untested with the KRpano demo)
You will also need a free copy of ImageMagick which you can get from here.
- Install KRpano by right clicking on the install file and selecting “Run as administrator“.
- Install ImageMagick by right clicking on the install file and selecting “Run as administrator“, then DURING install follow the next steps:
- For ImageMagick at the “Select Additional Tasks” screen (the options screen), make sure you ALSO TICK “Install legacy utilities (e.g. convert)”.
- After ImageMagick is installed, open a dos command prompt and type the following 2 commands:
- magick wizard: wizard.jpg (and press enter. It will appear to not do anything. There’s no visual feedback)
- magick wizard.jpg win: (including the colon mark and press enter. You should see a window that display a pic of a wizard, you can close it)
- Install the script as described on http://mornestudio.com/mornescriptspack/ and run it.
- Set the path to your KRPano installation files
- ImageMagick should be autodetected
- Add your Stereo Cubestrips (12X1 with a resolution of 18432 X 1536). The scene titles in the tour will be taken from the cubestrip filenames
- The default scene order will be the same as in the list. You can drag names to re-order
- Set an EMPTY folder as the output folder where the tour files will be saved
- Build Tour. PLEASE BE PATIENT AND WAIT! A single cubestrip can take a couple seconds to calculate. 7 Cubestrips can take up to a minute or longer!
- If there’s no crash or hang during the calculations, the progress bar completes to 100% whereafter a message will pop up stating what will happen next
- A KRPano local testing server will run and the tour will open in your browser. Don’t close the testing server while you are testing and adding hotspots
- When you are done, you can close the testing server and upload the tour online to your webserver. You don’t need to upload the the testing server files.
Tour and VR Tour compatibility:
The tour should work fine on most desktop browsers and VR devices using HTML5. I have successfully tested these browsers on Windows 10:
- Firefox 32-bit
- Firefox 64-bit
- Internet Explorer 11
This is an action you will perform and has nothing to do with the end user’s compatibility viewing the tour. Unfortunately currently adding hotspots requires flash. A possible future feature in KRPAno will eliminate the need for flash in MY SCRIPT. Firefox-64 bit as well as EDGE failed in my tests adding hotpsots. These desktop browsers with flash tested fine on Windows 10:
- Firefox 32-bit
- Internet Explorer 11
Uploading the tour to your online webserver (and technical stuff):
You can use something like FileZilla FTP Client to upload all the files and folders in the “VR Stereo Tour” Folder with the exception of 3 files. You don’t need to upload the tour_editor and the 2 tour_testingserver files as they’re not needed online. NOW it gets a bit technical and your hosting provider can help you out with the following settings if needed: I tested on an Apache webserver and I’m using .htaccess and therefore the script included the “security cors use credentials” in the tour xml file. You may not need this or configure it differently if your webserver is an IIS server. It basically has to do with the tour xml file that KRPano generates. If your tour is not working, it may have to do with the security cors and/or your webserver settings. If you’re brave you can look here for more info. Your run the tour by navigating to your webserver’s address and folders on the server where you uploaded and the tour.html file. For example the address could look something like this www.example.com/myprojects/vr/tour.html
Download and Installation:
Happy VR Touring!
* The script is free, but you will need a KRPano License. My script essentially runs in 3ds Max and it’s a basic UI for KRPano.