Open a console or a command prompt depending on your system. In Mac OS X / Linux open a terminal app, in Windows before Win 8 open the command prompt via Start menu > Run > type in “cmd” without double quotes and press Enter. In Windows 8 and newer, right click on the menu icon in the lower left corner of your desktop and select Command Prompt. (There is no need to run it with Admin or superuser privileges.)
Now it is time to run jar files in the following order:
It is important to maintain the indicated order, as the bridge connects to the CVE server, and web-socket uses both bridge and CVE server.
To run a jar file, open up a new command prompt or terminal window and type in:
java -jar <path to the cve server jar file>
and press Enter.
The iOS Bridge jar file is located in (folder you extracted the zip file to)/iOSBridge/build/iOS-CVE-Bridge.jar.
To run it, you need to add the IP address of where the CVE session server is running, so for example:
java -jar <path to the iOS bridge jar file> 127.0.0.1
(which is usually your localhost address)
The web-socket jar file can be found in the (folder you extracted the zip file to)/build/pano_socket.jar, and to run it, you need to append CVE session server host IP addr and channel that you are going to use on Twhirleds app:
java -jar <path to the web-socket jar file> 127.0.0.1 CH2 (Keep every new window open so that server, bridge, and socket can run simultaneously.)
Now open the panoramic browser window. There are two icons in the lower left bottom corner for images and settings. Pictures icon is rather self-explanatory, although it is important to note that we made this software expecting images shot by Ricoh Theta cameras, and thus other images might look distorted.
In the settings you can change web-socket URL (however if you’re not using a separate server, a localhost will be fine), as well as set offsets and directions for camera movement.
The camera can be controlled either through dragging with a mouse cursor or touch gestures. Besides that it can be controlled by the Twhirleds app connected into the same network, just choose the appropriate channel that was used in web-socket application.
If you have any questions or comments please feel free to send us a message at mcohen@u-aizu.ac.jp