/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2024 * * * * 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 #include #include //#define Debugging_Core_SceneGraphNode_Indices namespace ghoul { class Dictionary; } namespace ghoul::opengl { class ProgramObject; } 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); static constexpr std::string_view KeyIdentifier = "Identifier"; static constexpr std::string_view KeyParentName = "Parent"; static constexpr std::string_view KeyDependencies = "Dependencies"; static constexpr std::string_view KeyTag = "Tag"; SceneGraphNode(); virtual ~SceneGraphNode() override; static ghoul::mm_unique_ptr createFromDictionary( const ghoul::Dictionary& dictionary); void initialize(); void initializeGL(); void deinitialize(); void deinitializeGL(); void update(const UpdateData& data); void render(const RenderData& data, RendererTasks& tasks); void attachChild(ghoul::mm_unique_ptr child); ghoul::mm_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::dvec3 worldScale() const; bool isTimeFrameActive(const Time& time) const; SceneGraphNode* parent() const; std::vector children() const; const std::vector& onApproachAction() const; const std::vector& onReachAction() const; const std::vector& onRecedeAction() const; const std::vector& onExitAction() const; double boundingSphere() const; double interactionSphere() const; double reachFactor() const; double approachFactor() const; bool supportsDirectInteraction() const; SceneGraphNode* childNode(const std::string& id); const Renderable* renderable() const; Renderable* renderable(); std::string guiPath() const; bool hasGuiHintHidden() const; void setGuiHintHidden(bool value); static documentation::Documentation Documentation(); private: void traversePreOrder(const std::function& fn); void traversePostOrder(const std::function& fn); glm::dvec3 calculateWorldPosition() const; glm::dmat3 calculateWorldRotation() const; glm::dvec3 calculateWorldScale() const; void computeScreenSpaceData(RenderData& newData); void renderDebugSphere(const Camera& camera, double size, const glm::vec4& color); std::atomic _state = State::Loaded; std::vector> _children; SceneGraphNode* _parent = nullptr; std::vector _dependencies; std::vector _dependentNodes; Scene* _scene = nullptr; std::vector _onApproachAction; std::vector _onReachAction; std::vector _onRecedeAction; std::vector _onExitAction; ghoul::mm_unique_ptr _renderable; // 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; properties::StringProperty _guiPath; properties::StringProperty _guiDisplayName; properties::StringProperty _guiDescription; properties::BoolProperty _useGuiOrdering; properties::FloatProperty _guiOrderingNumber; // Transformation defined by translation, rotation and scale struct { ghoul::mm_unique_ptr translation; ghoul::mm_unique_ptr rotation; ghoul::mm_unique_ptr scale; } _transform; ghoul::mm_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); glm::dmat4 _modelTransformCached = glm::dmat4(1.0); properties::DoubleProperty _boundingSphere; properties::DoubleProperty _evaluatedBoundingSphere; properties::DoubleProperty _interactionSphere; properties::DoubleProperty _evaluatedInteractionSphere; properties::DoubleProperty _approachFactor; properties::DoubleProperty _reachFactor; properties::BoolProperty _computeScreenSpaceValues; properties::IVec2Property _screenSpacePosition; properties::BoolProperty _screenVisibility; properties::DoubleProperty _distFromCamToNode; properties::DoubleProperty _screenSizeRadius; properties::FloatProperty _visibilityDistance; properties::BoolProperty _supportsDirectInteraction; // 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; properties::BoolProperty _showDebugSphere; static ghoul::opengl::ProgramObject* _debugSphereProgram; std::optional _overrideBoundingSphere; std::optional _overrideInteractionSphere; #ifdef Debugging_Core_SceneGraphNode_Indices int index = 0; static int nextIndex; #endif // Debugging_Core_SceneGraphNode_Indices }; } // namespace openspace #endif // __OPENSPACE_CORE___SCENEGRAPHNODE___H__