/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2016 * * * * Permission is hereby granted, free of charge, to any person obtaining a copy of this * * software and associated documentation files (the "Software"), to deal in the Software * * without restriction, including without limitation the rights to use, copy, modify, * * merge, publish, distribute, sublicense, and/or sell copies of the Software, and to * * permit persons to whom the Software is furnished to do so, subject to the following * * conditions: * * * * The above copyright notice and this permission notice shall be included in all copies * * or substantial portions of the Software. * * * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, * * INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A * * PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT * * HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF * * CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE * * OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * ****************************************************************************************/ #ifndef __CAMERA_H__ #define __CAMERA_H__ #include // open space includes #include #include #include // glm includes #include #include #include #include namespace openspace { class Camera { public: Camera(); Camera(const Camera& o) : sgctInternal(o.sgctInternal) , _viewDirectionInCameraSpace(o._viewDirectionInCameraSpace) , _focusPosition(o._focusPosition) , _viewDirection(o._viewDirection) , _lookUp(o._lookUp) , _viewRotationMatrix(o._viewRotationMatrix) , _scaling(o._scaling) , _position(o._position) , _maxFov(o._maxFov) , _sinMaxFov(o._sinMaxFov) { } ~Camera(); // MUTATORS (SETTERS) void setPosition(psc pos); void setFocusPosition(psc pos); void setRotation(glm::quat rotation); void setLookUpVector(glm::vec3 lookUp); void setScaling(glm::vec2 scaling); void setMaxFov(float fov); // RELATIVE MUTATORS void rotate(const glm::quat& rotation); // ACCESSORS (GETTERS) const psc& position() const; const psc& unsynchedPosition() const; const psc& focusPosition() const; const glm::vec3& viewDirection() const; const glm::vec3& lookUpVector() const; const glm::vec2& scaling() const; float maxFov() const; float sinMaxFov() const; const glm::mat4& viewRotationMatrix() const; //@TODO this should simply be called viewMatrix! //Rename after removing deprecated methods const glm::mat4& combinedViewMatrix() const; // DEPRECATED ACCESSORS (GETTERS) // @TODO use Camera::SgctInternal interface instead [[deprecated("Replaced by Camera::SgctInternal::viewMatrix()")]] const glm::mat4& viewMatrix() const; [[deprecated("Replaced by Camera::SgctInternal::projectionMatrix()")]] const glm::mat4& projectionMatrix() const; [[deprecated("Replaced by Camera::SgctInternal::viewProjectionMatrix()")]] const glm::mat4& viewProjectionMatrix() const; // SYNCHRONIZATION void postSynchronizationPreDraw(); void preSynchronization(); void serialize(SyncBuffer* syncBuffer); void deserialize(SyncBuffer* syncBuffer); // Handles SGCT's internal matrices. Also caches a calculated viewProjection matrix. class SgctInternal { friend class Camera; public: void setViewMatrix(glm::mat4 viewMatrix); void setProjectionMatrix(glm::mat4 projectionMatrix); const glm::mat4& viewMatrix() const; const glm::mat4& projectionMatrix() const; const glm::mat4& viewProjectionMatrix() const; private: SgctInternal(); SgctInternal(const SgctInternal& o) : _viewMatrix(o._viewMatrix) , _projectionMatrix(o._projectionMatrix) , _dirtyViewProjectionMatrix(o._dirtyViewProjectionMatrix) , _viewProjectionMatrix(o._viewProjectionMatrix) {} glm::mat4 _viewMatrix; glm::mat4 _projectionMatrix; mutable bool _dirtyViewProjectionMatrix; mutable glm::mat4 _viewProjectionMatrix; mutable std::mutex _mutex; } sgctInternal; private: // Defines what direction in local camera space the camera is looking in. const glm::vec3 _viewDirectionInCameraSpace; psc _focusPosition; glm::vec3 _viewDirection; glm::vec3 _lookUp; // Class encapsulating the synced data. Are all three variables // (i.e. local, shared, synced) really neccessary? /EB template struct SyncData { SyncData() {} // copy constructor SyncData(const SyncData& d) : local(d.local), shared(d.shared), synced(d.synced) {} void serialize(SyncBuffer* syncBuffer) { syncBuffer->encode(shared); } void deserialize(SyncBuffer* syncBuffer) { syncBuffer->decode(shared); } void postSynchronizationPreDraw() { synced = shared; } void preSynchronization() { shared = local; } T local; T shared; T synced; }; SyncData _viewRotationMatrix; SyncData _scaling; SyncData _position; float _maxFov; float _sinMaxFov; mutable std::mutex _mutex; }; } // namespace openspace #endif // __CAMERA_H__