CameraExample.cpp

/*
 * First things first -- to apply the Propane Camera we want to call
 * the setPerspective method.
 */

Propane::Camera thisCamera;
thisCamera.setPosition(0, 100, 0);      // set to x=0, y=100, z=0
thisCamera.setPerspective();            // tell OpenGL to use this camera

/*
 * To use the Propane Camera, every time you update you must make
 * incremental updates -- not entire rotations. Quaternions are
 * designed to take updates OVER TIME instead of arbitrary axis-angle
 * combinations. Otherwise, we get gimbal lock when we try to handle
 * all three axis rotations at once.
 */
thisCamera.changePitch(-10.0f);         // this will be applied next time you
                                        // call setPerspective or 
                                        // getForwardVector!

/*
 * Wanna move forward? You have two options -- use the moveForward method
 * or use the getForwardVector method and do the math yourself.
 */
thisCamera.moveForward(1.0f);           // Move along current rotation 1.0 units

Propane::Math::Vector3 sourcePos(100,100,100);
Propane::Math::Vector3 forVec = thisCamera.getForwardVector();
sourcePos += forVec * 10000.0f;         // Move 10000.0f units along current
                                        // rotation from (100,100,100)
thisCamera.setPosition(sourcePos);

/*
 * If you want to take the internal quaternion and go do something else
 * with it, then call the getAggregate method. Check out the Quaternion
 * docs for more information on this neat feature of math.
 */
Propane::Math::Quaternion myQuat = thisCamera.getAggregate();
std::cout << "Hello from the quaternion: " << myQuat << std::endl;

---