/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2020 * * * * 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 __OPENSPACE_CORE___SCENEGRAPHNODE___H__ #define __OPENSPACE_CORE___SCENEGRAPHNODE___H__ #include #include #include #include #include #include #include #include #include #include #include #include #include //#define Debugging_Core_SceneGraphNode_Indices namespace ghoul { class Dictionary; } namespace openspace { class Camera; struct RenderData; class Renderable; struct RendererTasks; class Rotation; class Translation; class Scale; class Scene; struct UpdateData; struct SurfacePositionHandle; class TimeFrame; class Time; namespace documentation { struct Documentation; } class SceneGraphNode : public properties::PropertyOwner { public: enum class State : int { Loaded, Initialized, GLInitialized }; BooleanType(UpdateScene); struct PerformanceRecord { long long renderTime; // time in ns long long updateTimeRenderable; // time in ns long long updateTimeTranslation; // time in ns long long updateTimeRotation; // time in ns long long updateTimeScaling; // time in ns }; static constexpr const char* RootNodeIdentifier = "Root"; static constexpr const char* KeyIdentifier = "Identifier"; static constexpr const char* KeyParentName = "Parent"; static constexpr const char* KeyDependencies = "Dependencies"; static constexpr const char* KeyTag = "Tag"; SceneGraphNode(); ~SceneGraphNode(); static std::unique_ptr createFromDictionary( const ghoul::Dictionary& dictionary); void initialize(); void initializeGL(); void deinitialize(); void deinitializeGL(); void traversePreOrder(const std::function& fn); void traversePostOrder(const std::function& fn); void update(const UpdateData& data); void render(const RenderData& data, RendererTasks& tasks); void attachChild(std::unique_ptr child); std::unique_ptr detachChild(SceneGraphNode& child); void clearChildren(); void setParent(SceneGraphNode& parent); void addDependency(SceneGraphNode& dependency); void removeDependency(SceneGraphNode& dependency); void clearDependencies(); void setDependencies(const std::vector& dependencies); SurfacePositionHandle calculateSurfacePositionHandle( const glm::dvec3& targetModelSpace) const; const std::vector& dependencies() const; const std::vector& dependentNodes() const; Scene* scene(); void setScene(Scene* scene); glm::dvec3 position() const; const glm::dmat3& rotationMatrix() const; glm::dvec3 scale() const; glm::dvec3 worldPosition() const; const glm::dmat3& worldRotationMatrix() const; glm::dmat4 modelTransform() const; glm::dmat4 inverseModelTransform() const; glm::dvec3 worldScale() const; bool isTimeFrameActive(const Time& time) const; SceneGraphNode* parent() const; std::vector children() const; float boundingSphere() const; SceneGraphNode* childNode(const std::string& identifier); const PerformanceRecord& performanceRecord() const; void setRenderable(std::unique_ptr renderable); const Renderable* renderable() const; Renderable* renderable(); std::string guiPath() const; bool hasGuiHintHidden() const; static documentation::Documentation Documentation(); private: glm::dvec3 calculateWorldPosition() const; glm::dmat3 calculateWorldRotation() const; glm::dvec3 calculateWorldScale() const; void computeScreenSpaceData(RenderData& newData); std::atomic _state = State::Loaded; std::vector> _children; SceneGraphNode* _parent = nullptr; std::vector _dependencies; std::vector _dependentNodes; Scene* _scene = nullptr; // If this value is 'true' GUIs are asked to hide this node from collections, as it // might be a node that is not very interesting (for example barycenters) properties::BoolProperty _guiHidden; PerformanceRecord _performanceRecord = { 0, 0, 0, 0, 0 }; std::unique_ptr _renderable; properties::StringProperty _guiPath; properties::StringProperty _guiDisplayName; // Transformation defined by ephemeris, rotation and scale struct { std::unique_ptr translation; std::unique_ptr rotation; std::unique_ptr scale; } _transform; std::unique_ptr _timeFrame; // Cached transform data glm::dvec3 _worldPositionCached = glm::dvec3(0.0); glm::dmat3 _worldRotationCached = glm::dmat3(1.0); glm::dvec3 _worldScaleCached = glm::dvec3(1.0); float _fixedBoundingSphere = 0.f; glm::dmat4 _modelTransformCached = glm::dmat4(1.0); glm::dmat4 _inverseModelTransformCached = glm::dmat4(1.0); properties::BoolProperty _computeScreenSpaceValues; properties::IVec2Property _screenSpacePosition; properties::BoolProperty _screenVisibility; properties::DoubleProperty _distFromCamToNode; properties::DoubleProperty _screenSizeRadius; properties::FloatProperty _visibilityDistance; // This variable is used for the rate-limiting of the screenspace positions (if they // are calculated when _computeScreenSpaceValues is true) std::chrono::high_resolution_clock::time_point _lastScreenSpaceUpdateTime; #ifdef Debugging_Core_SceneGraphNode_Indices int index = 0; static int nextIndex; #endif // Debugging_Core_SceneGraphNode_Indices }; } // namespace openspace #endif // __OPENSPACE_CORE___SCENEGRAPHNODE___H__