Files
OpenSpace/modules/imgui/include/guicomponent.h
2024-02-06 15:53:24 +01:00

104 lines
4.2 KiB
C++

/*****************************************************************************************
* *
* 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_MODULE_IMGUI___GUICOMPONENT___H__
#define __OPENSPACE_MODULE_IMGUI___GUICOMPONENT___H__
#include <openspace/properties/propertyowner.h>
#include <openspace/properties/scalar/boolproperty.h>
namespace openspace::gui {
class GUI;
/**
* The base class for a GUI component that can be rendered to the screen.
*/
class GuiComponent : public properties::PropertyOwner {
public:
/**
* Constructor that initializes this components member variables.
*/
GuiComponent(std::string identifier, std::string guiName = "");
/**
* Returns if this component is enabled, that is, if it is currently active and
* visible on the screen.
*
* \return `true` if this component is enabled, `false` otherwise
*/
bool isEnabled() const;
/**
* Sets if this component is enabled, that is, if it is currently active and visible
* on the screen.
*
* \param enabled The new enabled status of this component
*/
void setEnabled(bool enabled);
/**
* Initializes the component with everything that does not require an OpenGL context.
*/
virtual void initialize();
/**
* Initializes the component with everything that requires an OpenGL context.
*/
virtual void initializeGL();
/**
* Deinitializes the component with things that do not require an OpenGL context.
*/
virtual void deinitialize();
/**
* Deinitializes the component with things that require an OpenGL context.
*/
virtual void deinitializeGL();
/**
* Renders the individual subcomponents to the screen.
*/
virtual void render() = 0;
void setShowHelpTooltip(bool showHelpTooltip);
void setShowHelpTooltipDelay(double delay);
protected:
/// `true` if this component is enabled and visible on the screen
properties::BoolProperty _isEnabled;
/// if `true` this window is currently collapsed. This setting mirrors the ImGui
/// internal state of the window
properties::BoolProperty _isCollapsed;
bool _showHelpTooltip = true;
double _tooltipDelay = true;
};
} // namespace openspace::gui
#endif // __OPENSPACE_MODULE_IMGUI___GUICOMPONENT___H__