No description, website, or topics provided.
JavaScript Java CSS Ruby
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
androidCode
css/cursors
images
js
node_modules
timemachine-viewer
.gitignore
README.md
config.json
controller.html
default_tour.json
hyperwall.html
hyperwall_editor.html
index.html
server.js

README.md

#Time Machine Hyperwall

  1. Setting up the master machine
  2. Running the node.js server on the master
  3. Syncing up other machines
  4. Installing the Android app
  5. Editing the location slider

Tutorial for the tablet controller

Setting up the master machine:

Download node.js and install it from http://nodejs.org/download/.

Running the node.js server on the master:

  • Download the timemachine-hyperwall code from github.

    git clone https://github.com/CMU-CREATE-Lab/timemachine-hyperwall.git
    

    OR download a zip from GitHub

  • In a terminal, go to the timemachine-hyperwall code folder on the master machine and start the server by typing:

    node server.js
    
  • Go to a browser (Chrome recommended) on the master machine and type in the following address:

    http://localhost:8080/hyperwall.html?master=true&showControls=true&showMap=true&mapPosition=topRight&showLogoUrl=true&logoUrlPosition=topLeft
    
  • Settings after http://localhost:8080/hyperwall.html?

    • master = (true|false; is a master machine or not)
    • showControls = (true|false; show the control bar or not)
    • fullControls = (true|false; show the play/help button or not)
    • showMap = (true|false; show the google map or not)
    • mapPosition = (topRight|topLeft|bottomRight|bottomLeft; set the map position)
    • showLogoUrl = (true|false; show the link to Google Earth Engine or not)
    • logoUrlPosition = (topRight|topLeft|bottomRight|bottomLeft; set the logo url position)

Syncing up other machines:

  • Connect each browser to the master

    Go to the machine with a display to the right of the master and in your browser point to the following address:

    http://192.168.1.2:8080/hyperwall.html?yawOffset=1
    

    This assumes the IP address of the master machine is 192.168.1.2.

  • Setting up a 3x3 hyperwall:

    After http://192.168.1.2:8080/hyperwall.html?, enter the following:

    • yawOffset=1 (right of the master)
    • yawOffset=-1 (left of the master)
    • pitchOffset=-1 (above the master)
    • pitchOffset=1 (below the master)
    • yawOffset=1&pitchOffset=-1 (top right corner)
    • yawOffset=-1&pitchOffset=-1 (top left corner)
    • yawOffset=1&pitchOffset=1 (bottom right corner)
    • yawOffset=-1&pitchOffset=1 (bottom left corner)

    pitchOffset is for above/below the master. Negative is above and positive is below. yawOffset is for left/right of the master. Negative is to the left and positive is to the right.

Installing the Android app

  • Prerequisites

    Officially we only support Android (latest - 1), which at this time is Android 4.4 and 4.3. However, our app should still work on Android 4.2, with the requirement that you have Google Maps installed and you are running at least version 7.4.0 of it. If you do have to upgrade your Maps to a later version, you will need to reboot your device after installing it. If there is also an update to Google Services for your device, you must install that too. Note that Android 4.2 is the minimum version we support.

    We use hardware acceleration for Android 4.4 or higher. If you are using Android version < 4.4, then you will see sluggish behavior when interacting with the map while the timeline is playing.

  • Download Android App

    Download the apk file from the tablet with the link above and install it. You have to enable the following on your tablet to install the app.

    Settings -> Security -> Device Administration -> Unknown Sources
    
  • Set up the node server first

    The node server on the master machine needs to be running before you start the app. In addition, the Android tablet and the master machine need to be on the same network. Once you start the app, it will ask you the IP address of the master machine, e.g. 192.168.1.2. Once you enter the IP address, the tablet will be connected. For your convenience, the address will be saved for future runs of the app.

Editing the location slider

  • Add locations from the tablet editor

    Locations can be added direcly from the tablet editor. Here is a tutorial for the tablet editor.

  • Edit the slider from the desktop editor

    For a more feature-rich editor, go to the desktop version at the following address:

    http://192.168.1.2:8080/hyperwall_editor.html
    

    This assumes the IP address of the master machine is 192.168.1.2. Here is a tutorial for the desktop editor.