angelica_villegas.428.P1

Welcome to CS 428 Project 1 - Around the World GitHub Documentation

Created by Angelica Villegas Salazar.

Introduction

This is a project for Virtual, Augmented and Mixed Reality taught by Professor Andy Johnson.

The goal was to create two designs of two distinct locations that could be projected onto two cubes. Each cube has five models on top (three models from the web, two models I created), one side that states the location temperature (in either Fahrenheit or Celsius), one side that states the current time at the location, one side that states the location name and one side that I chose to add a 2D model. If you flip the cube upside down and rightside up the lighting will change.

For more information visit the project website.

Software Requirements

• Unity
  • version 2021.3.6f1
• Vuforia
  • version 10.9
• Unity Hub

Installation Instructions

1. Download the newest version of Unity Hub.
2. Once the download is complete, Open Unity Hub, navigate to the left hand bar and click on the Installs tab
3. If this is your first install of Unity Hub/Unity there will be no installs listed. To install the correct version on Unity:
   1. Navigate to Install Editor in the top left
   2. Navigate to the Archive tab in the top bar
   3. In the statment in this tab, click on the hyper link that says download archive
   4. Navigate to the correct version of Unity(2021.3.6f1)
   5. Click on the Unity Hub button to download this version to Unity Hub.
   6. This will prompt Unity Hub to open and then will open an Install page with the version listed.
      1. Under Platforms make sure to select Android Build Support and iOS Build Support if you want to build to a mobile device.
      2. Under Documentation make sure to select Documentation
   7. If you forget to check any modules above you can do it after Unity is installed.
   8. Click on the Install
   9. The correct version should now be installing
4. Now that the correct version of Unity is installed, you can move forward in the project

Project Instructions

1. Print out and assemble the MergeCube and ClassCube (found in the CubesForVuforia folder)
2. Download the code from this GitHub
3. Unzip the file and move the file into the Unity folder that was created
4. Before opening you have to install Vuforia

Install Vuforia

1. Navigate to the vuforia website
2. Create an account then navigate to Downloads page
3. Download Vuforia 10.9 via Unity Hub (It should be the first option Add Vuforia Engine to a Unity Project or upgrade to the latest version)
4. Once the download is complete click to open the .unityPackage, this should open Unity Hub and download the Vuforia package

Setting up project

1. Click Open in the Unity Projects page and select the project folder where this project is saved to open it.
2. It should spend some time processing and will open up the project
3. Once opne you may have to import Vuforia to do this go to Assets from there Import Package and then Custom Package you should be able to then import all the files required.
4. Additionally, you will need a Vuforia key to have the project work correctly:
   1. Go to the Vuforia website
      1. Create a Vuforia developer account
      2. Under the Develop tab ensure you are on the License Manager page
      3. Click on Get Development Key to create a license key.
      4. Once created you should get the key that you can now copy
   2. Go to the Unity project
      1. On the top bar, find the Window tab and scroll to Vuforia Configuration
      2. Paste this key in the Global section of the Vuforia Configuration window in the right hand menu in Unity
5. In the Project folder in the bottom part of Unity in there is an Assets folder, which contains a Scenes folder
6. In the Scenes folder there is a file named ThemeParkCubes.unity, drag it into the hieracy (not inside any scene) and delete the Default scene/cameras that are there.
7. Congratulations! If you open the Scene, under ARCamera you should see two models, MagicKingdom (Cube 1) and SuperNintendoWorld (Cube 2). Print out the merge and class cube (found in the CubesForVuforia folder), assemble them and put them in front of the screen. When you click the play you can now use AR to see the two cube designs on the physical cubes built.

If there are problems installing, ensure that the com.ptc.vuforia.engine-10.9.3.tgz is in the Packages folder

You can find further information about Vuforia and Unity here.