CS40 Project 4: 3D Coordinate transforms

Due 11:59pm Wednesday 28 September 2016

For this lab, you will be modeling and animating entire solar system, using coordinate transformations. Mostly you will be making judicious use of Translations, Scalings, and Rotations, to work in different frames.

Lab 4 goals

Useful references

Initializing git repos

You may work with one partner on this lab. If you have not told me your partner yet, you may do so in lab, and I can create a new team repo for you and your partner. Clone your personal copy of the starter code for lab 04 as shown below.
$ cd
[~]$ ssh-add
Enter passphrase for /home/ghopper1/.ssh/id_rsa: 
Identity added: /home/ghopper1/.ssh/id_rsa (/home/ghopper1/.ssh/id_rsa)
[~]$ cd ~/cs40/labs
[labs]$ git clone git@github.swarthmore.edu:CS40-F16/lab04-YOURUSERNAME-YOURPARTNERNAME.git 04

Making and building code

Before building your source, add a symlink to the folder containing the planet textures in your source folder:
[04]$ cd ~/cs40/labs/04
[04]$ ln -s /usr/local/doc/textures/ data
Make a build directory in your labs/04 directory and run cmake, and make. You can also do this in QtCreator by selecting new project and opening the file ~/cs40/labs/04/CMakeLists.txt
[04]$ cd ~/cs40/labs/04
[04]$ mkdir build
[04]$ cd build
[build]$ cmake ..
[build]$ make -j8
[build]$ ./solar

If you expect to see textures, but you don't, you may have forgotten to add the symlink above before building. You can manually add it to your build directory. If you are using QtCreator, you may need to find the build directory it created.


cd ~/cs40/labs/04/build
ln -s /usr/local/doc/textures/ data
Data
The file solarData.txt in your labs/04 folder contains some basic info about our solar system (and Pluto, which has recently been disqualified). The information contains the radius of each object (in thousands of km), the distance from the sun ($a$, in millions of km), the period of rotation around the sun ($\tau$, in earth years), the eccentricity of the elliptical orbit, and the inclination of the orbit with respect to a plane through the center of the sun. You should use this information to model a solar system as a collection of rotating spheres.

You can parse this data file using code similar to that in MyPanelOpenGL::parsePlanets.

Basic Requirements
You will need to find an acceptable coordinate system in which to draw your system. I recommend scaling the radii of the objects so they look visually appealing and convey some sense of relative scale. Feel free to adjust the sun (and perhaps the larger outer planets) differently than the rest. The sun is really big. After adjusting the radius field, you should be able to use the rest of the units as they are.

You must create a planet class or planet struct to organize necessary planet info. I have provided a sample class in planet.h/.cpp, but feel free to modify this or write a completely separate data structure.

You must draw and animate all the planets listed. All planets should revolve in the same direction around the sun, but not at the same rate. You may assume the planets revolve in circular orbits, but the eccentricity is given if you want to model elliptical orbits.

All planets should spin about their axis according to the time of day. The tilt column of SolarData.txt describes the tilt of the planet's axis with respect to the $\hat{y}$-axis of the sun. Planets should revolve around this tilted axis. You will likely want a way to speed up and slow down time so you can observe spinning and orbiting as desired.

Assign a texture to each of the planets. You may want to add these parameters to the data file, so you can refresh them without recompiling.

You must model at least one moon around one of the planets. You can choose the size of the moon, radius of orbit, and period of rotation, or consult a source for reasonable defaults. You can use the same moon texture for all moons, use a separate fragment shader, or modify your fragment shader to support textured and non-textured spheres.

Add keyboard controls to pan and zoom. You can decide how this is implemented. You should modify the m_view matrix when you do this.

Hints/Tips

You can use the Sphere class to model the planets. Note, you do not need to create multiple Sphere instances. You can reuse the same VBO and apply different transforms to the shader before drawing each planet.

Work incrementally. Get your data file parser working and then print out the info each planet to ensure you parsed the data correctly. Make subtle adjustments to the m_view matrix using QMatrix4x4::ortho, or until you understand what you are looking out and how the scene is effected.

Explore the MatrixStack class and try some examples in PaintGL with multiple objects.

You can use any of the QMatrix4x4 methods. Methods like translate, rotate and scale, modify an existing matrix, by multiplying it on the right.

Each planet/moon can have its own uniform model matrix in the vertex shader. You should probably only use one view matrix for the entire system.

Use the Square to help orient you if you find yourself getting lost.

Use a QTimer to animate. Do not try to maintain a global 'time'. Instead, each time the QTimer triggers, consider that $\Delta_t$ time has elapsed in the solar system. Pass this $\Delta$ to each planet so they can update their spin and rotation appropriately.

Optional features
The following are optional extensions and are not required for full credit.
Submit
You should regularly commit your changes to the project4 branch and occasionally push to your private remote. Note you must push to your remote to share updates with your partner. Ideally you should commit changes at the end of every session of working on the project. You will be graded on work that appears in your remote project4 branch by the project deadline