MD5Camera.hpp

Go to the documentation of this file.

 
#ifndef CSCI441_MD5_CAMERA_HPP
#define CSCI441_MD5_CAMERA_HPP
 
#include "Camera.hpp"
#include "LogUtils.hpp"
 
#include <ctime>
#include <fstream>
#include <string>
 
namespace CSCI441 {
 
    class MD5Camera final : public CSCI441::Camera {
    public:
        enum class AdvancementStrategy {
            RUN_SINGLE_CUT,
            LOOP_SINGLE_CUT,
            RUN_ALL_CUTS,
            LOOP_ALL_CUTS
        };
 
        MD5Camera() = delete;
 
        explicit MD5Camera(const char* MD5CAMERA_FILE, AdvancementStrategy advancementStrategy, GLuint firstCutToRun = 0, GLfloat aspectRatio = 1.0f, GLfloat fovy = glm::half_pi<GLfloat>(), GLfloat nearClipPlane = 0.001f, GLfloat farClipPlane = 1000.0f, GLboolean INFO = true, GLboolean ERRORS = true);
 
        MD5Camera(const MD5Camera&);
        MD5Camera& operator=(const MD5Camera&);
 
        MD5Camera(MD5Camera&&) noexcept;
        MD5Camera& operator=(MD5Camera&&) noexcept;
 
        ~MD5Camera() override;
 
        void recomputeOrientation() override {}
        void moveForward(GLfloat unused) override;
        void moveBackward(GLfloat unused) override;
 
    private:
        bool _loadMD5CameraFromFile(const char * MD5CAMERA_FILE, GLboolean INFO = true, GLboolean ERRORS = true);
        void _copy(const MD5Camera&);
        void _moveFromSource(MD5Camera&);
        void _free();
 
        bool _isInitialized;
 
        struct Frame {
            glm::vec3 cameraPosition;
            glm::vec3 cameraQuaternion;
            GLfloat fieldOfView;
        };
 
        GLuint _frameRate;
        GLuint _numFrames;
        GLuint _numCuts;
        GLuint* _cutPositions;
        Frame* _frames;
        GLuint _currentFrameIndex;
        GLuint _currentCutIndex;
        AdvancementStrategy _advancementStrategy;
 
        void _updateCameraAttributesForCurrentFrame();
 
        // vertical field of view stored in degrees
        GLfloat _fovy;
        GLfloat _aspectRatio;
        GLfloat _nearClipPlane;
        GLfloat _farClipPlane;
    };
}
 
inline CSCI441::MD5Camera::MD5Camera(
        const char * const MD5CAMERA_FILE,
        const AdvancementStrategy advancementStrategy,
        const GLuint firstCutToRun,
        const GLfloat aspectRatio,
        const GLfloat fovy,
        const GLfloat nearClipPlane,
        const GLfloat farClipPlane,
        const GLboolean INFO,
        const GLboolean ERRORS
) : _isInitialized(false),
    _frameRate(60),
    _numFrames(0),
    _numCuts(0),
    _cutPositions(nullptr),
    _frames(nullptr),
    _currentFrameIndex(0),
    _currentCutIndex(firstCutToRun),
    _advancementStrategy(advancementStrategy),
    _fovy(fovy),
    _aspectRatio(aspectRatio),
    _nearClipPlane(nearClipPlane),
    _farClipPlane(farClipPlane)
{
    mProjectionMatrix = glm::perspective(_fovy, _aspectRatio, _nearClipPlane, _farClipPlane);
 
    _isInitialized = _loadMD5CameraFromFile(MD5CAMERA_FILE, INFO, ERRORS);
}
 
[[maybe_unused]]
inline CSCI441::MD5Camera::MD5Camera(
    const MD5Camera& OTHER
) : Camera(OTHER),
    _isInitialized(false),
    _frameRate(60),
    _numFrames(0),
    _numCuts(0),
    _cutPositions(nullptr),
    _frames(nullptr),
    _currentFrameIndex(0),
    _currentCutIndex(0),
    _advancementStrategy(AdvancementStrategy::RUN_SINGLE_CUT),
    _fovy(45.0f),
    _aspectRatio(1.0f),
    _nearClipPlane(0.001f),
    _farClipPlane(1000.0f)
{
    this->_copy(OTHER);
}
 
inline CSCI441::MD5Camera::MD5Camera(
    MD5Camera&& src
) noexcept : Camera(std::move(src)),
    _isInitialized(false),
    _frameRate(60),
    _numFrames(0),
    _numCuts(0),
    _cutPositions(nullptr),
    _frames(nullptr),
    _currentFrameIndex(0),
    _currentCutIndex(0),
    _advancementStrategy(AdvancementStrategy::RUN_SINGLE_CUT),
    _fovy(45.0f),
    _aspectRatio(1.0f),
    _nearClipPlane(0.001f),
    _farClipPlane(1000.0f)
{
    this->_moveFromSource(src);
}
 
inline CSCI441::MD5Camera& CSCI441::MD5Camera::operator=(const MD5Camera& OTHER) {
    // call parent assignment operator
    CSCI441::Camera::operator=(OTHER);
 
    // guard against self-assignment
    if(this != &OTHER) {
        this->_free();
        this->_copy(OTHER);
    }
    return *this;
}
 
inline CSCI441::MD5Camera& CSCI441::MD5Camera::operator=(MD5Camera&& src) noexcept {
    // guard against self-move
    if (this != &src) {
        this->_free();
        this->_moveFromSource(src);
    }
 
    // call parent move operator
    CSCI441::Camera::operator=(std::move(src));
 
    return *this;
}
 
 
inline CSCI441::MD5Camera::~MD5Camera() {
    this->_free();
}
 
inline void CSCI441::MD5Camera::_copy(const MD5Camera& OTHER) {
    _fovy = OTHER._fovy;
    _aspectRatio = OTHER._aspectRatio;
    _nearClipPlane = OTHER._nearClipPlane;
    _farClipPlane = OTHER._farClipPlane;
    _frameRate = OTHER._frameRate;
    _currentFrameIndex = OTHER._currentFrameIndex;
    _currentCutIndex = OTHER._currentCutIndex;
    _advancementStrategy = OTHER._advancementStrategy;
    mProjectionMatrix = OTHER.mProjectionMatrix;
    _isInitialized = OTHER._isInitialized;
 
    _numCuts = OTHER._numCuts;
    _cutPositions = new GLuint[_numCuts];
    for(unsigned int i = 0; i < _numCuts; i++) {
        _cutPositions[i] = OTHER._cutPositions[i];
    }
 
    _numFrames = OTHER._numFrames;
    _frames = new Frame[_numFrames];
    for(unsigned int i = 0; i < _numFrames; i++) {
        _frames[i] = OTHER._frames[i];
    }
}
 
inline void CSCI441::MD5Camera::_moveFromSource(CSCI441::MD5Camera& src) {
    _fovy = src._fovy;
    src._fovy = 0.0f;
 
    _aspectRatio = src._aspectRatio;
    src._aspectRatio = 0.0f;
 
    _nearClipPlane = src._nearClipPlane;
    src._nearClipPlane = 0.0f;
 
    _farClipPlane = src._farClipPlane;
    src._farClipPlane = 0.0f;
 
    _frameRate = src._frameRate;
    src._frameRate = 0;
 
    _currentFrameIndex = src._currentFrameIndex;
    src._currentFrameIndex = 0;
;
    _currentCutIndex = src._currentCutIndex;
    src._currentCutIndex = 0;
 
    _advancementStrategy = src._advancementStrategy;
 
    _isInitialized = src._isInitialized;
    src._isInitialized = false;
 
    _numCuts = src._numCuts;
    src._numCuts = 0;
 
    _cutPositions = src._cutPositions;
    src._cutPositions = nullptr;
 
    _numFrames = src._numFrames;
    src._numFrames = 0;
 
    _frames = src._frames;
    src._frames = nullptr;
}
 
inline void CSCI441::MD5Camera::_free() {
    delete[] _frames;
    _frames = nullptr;
 
    delete[] _cutPositions;
    _cutPositions = nullptr;
}
 
 
inline bool CSCI441::MD5Camera::_loadMD5CameraFromFile(
        const char * const MD5CAMERA_FILE,
        const GLboolean INFO,
        const GLboolean ERRORS
) {
    if ( INFO ) CSCI441::LogUtils::log("[.md5camera]: -=-=-=-=-=-=-=- BEGIN %s Info -=-=-=-=-=-=-=- \n", MD5CAMERA_FILE );
 
    time_t start, end;
    time(&start);
 
    std::ifstream md5CameraFile(MD5CAMERA_FILE);
    if( !md5CameraFile.is_open() ) {
        if (ERRORS) CSCI441::LogUtils::logError("[.md5camera]: [ERROR]: Could not open \"%s\"\n", MD5CAMERA_FILE );
        if ( INFO ) CSCI441::LogUtils::log("[.md5camera]: -=-=-=-=-=-=-=-  END  %s Info -=-=-=-=-=-=-=- \n", MD5CAMERA_FILE );
        return false;
    }
 
    std::string sectionLabel, commandLineStr, brace;
    int md5version;
    Frame frame = { glm::vec3(0.0f, 0.0f, 0.0f), glm::vec3(0.0f, 0.0f, 0.0f), 45.0f };
 
    // MD5Version 10
    md5CameraFile >> sectionLabel >> md5version;
    if(sectionLabel != "MD5Version" || md5version != 10) {
        if (ERRORS) fprintf (stderr, "[.md5camera]: [ERROR]: improper MD5Camera version found \"%s %d\"\n", sectionLabel.c_str(), md5version );
        if ( INFO ) CSCI441::LogUtils::log("[.md5camera]: -=-=-=-=-=-=-=-  END  %s Info -=-=-=-=-=-=-=- \n", MD5CAMERA_FILE );
        return false;
    }
 
    // commandline "string"
    md5CameraFile >> sectionLabel;
    getline(md5CameraFile, commandLineStr);
 
    for(unsigned short i = 0; i < 5; i++) {
        md5CameraFile >> sectionLabel;
        if(sectionLabel == "numFrames") {
             // numFrames <integer>
             md5CameraFile >> _numFrames;
            _frames = new Frame[_numFrames];
        } else if(sectionLabel == "frameRate") {
            // frameRate <integer>
            md5CameraFile >> _frameRate;
        } else if(sectionLabel == "numCuts") {
            // numCuts <integer>
            md5CameraFile >> _numCuts;
            _cutPositions = new GLuint[_numCuts];
        } else if(sectionLabel == "cuts") {
            // cuts {
            //   [frameNumber]
            //   [frameNumber]
            // }
            md5CameraFile >> brace;
            if (_cutPositions == nullptr) {
                if (ERRORS) CSCI441::LogUtils::logError("[.md5camera]: [ERROR]: malformed md5camera file.  numCuts not previously defined in file\n" );
                return false;
            }
            for(unsigned int cutNumber = 0; cutNumber < _numCuts; cutNumber++) {
                md5CameraFile >> _cutPositions[cutNumber];
            }
            md5CameraFile >> brace;
            _currentFrameIndex = _cutPositions[_currentCutIndex];
        } else if(sectionLabel == "camera") {
            // camera {
            //   ( [x] [y] [z] ) ( [orientation] ) [FOV]
            // }
            md5CameraFile >> brace;
            for(unsigned int frameNumber = 0; frameNumber < _numFrames; frameNumber++) {
                md5CameraFile >> brace >> frame.cameraPosition.x >> frame.cameraPosition.y >> frame.cameraPosition.z >> brace;
                md5CameraFile >> brace >> frame.cameraQuaternion.x >> frame.cameraQuaternion.y >> frame.cameraQuaternion.z >> brace;
                md5CameraFile >> frame.fieldOfView;
            }
            md5CameraFile >> brace;
        } else {
            if (ERRORS) CSCI441::LogUtils::logError("[.md5camera]: [ERROR]: unknown section label found \"%s\"\n", sectionLabel.c_str() );
            if ( INFO ) CSCI441::LogUtils::log("[.md5camera]: -=-=-=-=-=-=-=-  END  %s Info -=-=-=-=-=-=-=- \n", MD5CAMERA_FILE );
            return false;
        }
    }
 
    if (INFO) {
        CSCI441::LogUtils::log("[.md5camera]: Camera Stats:\n" );
        CSCI441::LogUtils::log("[.md5camera]: Num Frames:\t%u\tFrame Rate:\t%u\tNum Cuts:  \t%u\n", _numFrames, _frameRate, _numCuts );
    }
 
    time(&end);
    double seconds = difftime( end, start );
 
    if (INFO) {
        CSCI441::LogUtils::log("[.md5camera]: Completed in %.3fs\n", seconds );
        CSCI441::LogUtils::log("[.md5camera]: -=-=-=-=-=-=-=-  END %s Info  -=-=-=-=-=-=-=- \n\n", MD5CAMERA_FILE );
    }
 
    return true;
}
 
inline void CSCI441::MD5Camera::moveForward(const GLfloat unused) {
    // prevent memory errors by checking if file loaded correctly
    if( !_isInitialized ) return;
 
    // clamp to current cut ? loop ? advance ?
 
    // check if current frame is at end of overall list of frames
    if( _currentFrameIndex == _numFrames - 1) {
        switch(_advancementStrategy) {
        case AdvancementStrategy::LOOP_ALL_CUTS:
            // go back to start of all cuts
            _currentCutIndex = 0;
        case AdvancementStrategy::LOOP_SINGLE_CUT:
            // go to start of current cut
            _currentFrameIndex = _cutPositions[ _currentCutIndex ];
            break;
 
        case AdvancementStrategy::RUN_SINGLE_CUT:
        case AdvancementStrategy::RUN_ALL_CUTS:
            // do nothing, at end and not looping
            return;
        }
    }
    // check if in last cut, but can't be at the end of the last cut because then we'd be at the end of the overall frames
    else if( _currentCutIndex == _numCuts - 1 ) {
        // in the middle of the last cut, move forward
        _currentFrameIndex++;
    }
    // otherwise not on final overall frame and not in the last cut
    else {
        // check if at end of current cut
        if( _currentFrameIndex == _cutPositions[_currentCutIndex + 1] - 1 ) {
            switch(_advancementStrategy) {
            case AdvancementStrategy::RUN_ALL_CUTS:
            case AdvancementStrategy::LOOP_ALL_CUTS:
                // go to next cut
                _currentCutIndex++;
            case AdvancementStrategy::LOOP_SINGLE_CUT:
                // go to start of current cut
                _currentFrameIndex = _cutPositions[ _currentCutIndex ];
                break;
 
            case AdvancementStrategy::RUN_SINGLE_CUT:
                // do nothing, at end and not looping nor advancing
                return;
            }
        } else {
            // in the middle of a cut, move forward
            _currentFrameIndex++;
        }
    }
    _updateCameraAttributesForCurrentFrame();
}
 
inline void CSCI441::MD5Camera::moveBackward(const GLfloat unused) {
    // prevent memory errors by checking if file loaded correctly
    if( !_isInitialized ) return;
 
    // clamp to current cut ? loop ? advance ?
 
    // check if current frame is at beginning of overall list of frames
    if( _currentFrameIndex == 0) {
        switch(_advancementStrategy) {
            case AdvancementStrategy::LOOP_ALL_CUTS:
                // go back to end of all frames
                _currentCutIndex = _numFrames-1;
                break;
 
            case AdvancementStrategy::LOOP_SINGLE_CUT:
                if( _numCuts == 1 ) {
                    // go back to end of all frames
                    _currentCutIndex = _numFrames-1;
                } else {
                    // go to end of current cut, which is the frame before the next cut
                    _currentFrameIndex = _cutPositions[ _currentCutIndex+1 ] - 1;
                }
                break;
 
            case AdvancementStrategy::RUN_SINGLE_CUT:
            case AdvancementStrategy::RUN_ALL_CUTS:
                // do nothing, at end and not looping
                return;
        }
    }
    // check if in first cut, but can't be at the end of the first cut because then we'd be at the end of the overall frames
    else if( _currentCutIndex == 0 ) {
        // in the middle of the first cut, move backward
        _currentFrameIndex--;
    }
    // otherwise not on initial overall frame and not in the first cut
    else {
        // check if at beginning of current cut
        if( _currentFrameIndex == _cutPositions[_currentCutIndex] ) {
            switch(_advancementStrategy) {
                case AdvancementStrategy::RUN_ALL_CUTS:
                case AdvancementStrategy::LOOP_ALL_CUTS:
                    // go to previous cut
                    _currentCutIndex--;
                case AdvancementStrategy::LOOP_SINGLE_CUT:
                    // go to end of current cut, which is the frame before the next cut
                    _currentFrameIndex = _cutPositions[ _currentCutIndex+1 ] - 1;
                    break;
 
                case AdvancementStrategy::RUN_SINGLE_CUT:
                    // do nothing, at end and not looping nor advancing
                    return;
            }
        } else {
            // in the middle of a cut, move backward
            _currentFrameIndex--;
        }
    }
    _updateCameraAttributesForCurrentFrame();
}
 
inline void CSCI441::MD5Camera::_updateCameraAttributesForCurrentFrame() {
    // get and set camera position for current frame
    mCameraPosition = _frames[_currentFrameIndex].cameraPosition;
 
    // get and set camera orientation for current frame
    // compute W of quaternion
    glm::vec4 q(_frames[_currentFrameIndex].cameraQuaternion, 0.0f);
    GLfloat t = 1.0f - (q.x * q.x) - (q.y * q.y) - (q.z * q.z);
    if (t < 0.0f)
        q.w = 0.0f;
    else
        q.w = -glm::sqrt(t);
 
    // set direction and look at point
    glm::vec3 defaultCameraDirection(0.0f, 0.0f, -1.0f);
    glm::vec4 inverseQ(-q.x, -q.y, -q.z, q.w);
    inverseQ = glm::normalize(inverseQ);
 
    glm::vec4 tmp(  (q.w * defaultCameraDirection.x) + (q.y * defaultCameraDirection.z) - (q.z * defaultCameraDirection.y),
                    (q.w * defaultCameraDirection.y) + (q.z * defaultCameraDirection.x) - (q.x * defaultCameraDirection.z),
                    (q.w * defaultCameraDirection.z) + (q.x * defaultCameraDirection.y) - (q.y * defaultCameraDirection.x),
                   -(q.w * defaultCameraDirection.x) - (q.y * defaultCameraDirection.y) - (q.z * defaultCameraDirection.z) );
    glm::vec4 rotatedCameraDirection((tmp.x * inverseQ.w) + (tmp.w * inverseQ.x) + (tmp.y * inverseQ.z) - (tmp.z * inverseQ.y),
                                     (tmp.y * inverseQ.w) + (tmp.w * inverseQ.y) + (tmp.z * inverseQ.x) - (tmp.x * inverseQ.z),
                                     (tmp.z * inverseQ.w) + (tmp.w * inverseQ.z) + (tmp.x * inverseQ.y) - (tmp.y * inverseQ.x),
                                     (tmp.w * inverseQ.w) - (tmp.x * inverseQ.x) - (tmp.y * inverseQ.y) - (tmp.z * inverseQ.z) );
    mCameraDirection = glm::vec3( rotatedCameraDirection.x, rotatedCameraDirection.y, rotatedCameraDirection.z );
    mCameraLookAtPoint = mCameraPosition + mCameraDirection;
 
    // set up vector
    glm::vec3 defaultCameraUpVector(0.0f, 1.0f, 0.0f);
    glm::vec4 tmp2(  (q.w * defaultCameraUpVector.x) + (q.y * defaultCameraUpVector.z) - (q.z * defaultCameraUpVector.y),
                     (q.w * defaultCameraUpVector.y) + (q.z * defaultCameraUpVector.x) - (q.x * defaultCameraUpVector.z),
                     (q.w * defaultCameraUpVector.z) + (q.x * defaultCameraUpVector.y) - (q.y * defaultCameraUpVector.x),
                    -(q.w * defaultCameraUpVector.x) - (q.y * defaultCameraUpVector.y) - (q.z * defaultCameraUpVector.z) );
    glm::vec4 rotatedCameraUpVector((tmp2.x * inverseQ.w) + (tmp2.w * inverseQ.x) + (tmp2.y * inverseQ.z) - (tmp2.z * inverseQ.y),
                                    (tmp2.y * inverseQ.w) + (tmp2.w * inverseQ.y) + (tmp2.z * inverseQ.x) - (tmp2.x * inverseQ.z),
                                    (tmp2.z * inverseQ.w) + (tmp2.w * inverseQ.z) + (tmp2.x * inverseQ.y) - (tmp2.y * inverseQ.x),
                                    (tmp2.w * inverseQ.w) - (tmp2.x * inverseQ.x) - (tmp2.y * inverseQ.y) - (tmp2.z * inverseQ.z) );
    mCameraUpVector = glm::vec3(rotatedCameraUpVector.x, rotatedCameraUpVector.y, rotatedCameraUpVector.z);
 
    // compute and set view matrix
    computeViewMatrix();
 
    // get and set field of view for perspective projection matrix
    _fovy = _frames[_currentFrameIndex].fieldOfView;
    mProjectionMatrix = glm::perspective(_fovy, _aspectRatio, _nearClipPlane, _farClipPlane);
}
 
#endif//CSCI441_MD5_CAMERA_HPP