Application.hh

Go to the documentation of this file.

/*
 * Copyright (C) 2018 Open Source Robotics Foundation
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
*/
#ifndef GZ_GUI_APPLICATION_HH_
#define GZ_GUI_APPLICATION_HH_
 
#include <memory>
#include <string>
#include <utility>
#include <vector>
 
#include "gz/gui/qt.h"
#include "gz/gui/Export.hh"
 
#include <gz/utils/ImplPtr.hh>
 
namespace tinyxml2
{
  class XMLElement;
}
 
namespace gz::gui
{
    class Dialog;
    class MainWindow;
    class Plugin;
 
    enum class WindowType : int
    {
      kMainWindow = 0,
 
      kDialog = 1
    };
 
    class GZ_GUI_VISIBLE Application : public QApplication
    {
      Q_OBJECT
 
      public: Application(int &_argc, char **_argv,
          const WindowType _type = WindowType::kMainWindow,
          const char *_renderEngineGuiApiBackend = nullptr);
 
      public: virtual ~Application();
 
      public: QQmlApplicationEngine *Engine() const;
 
      public: bool LoadPlugin(const std::string &_filename,
          const tinyxml2::XMLElement *_pluginElem = nullptr);
 
      public: bool LoadConfig(const std::string &_path);
 
      public: bool LoadWindowConfig(const tinyxml2::XMLElement &_window);
 
      public: bool LoadDefaultConfig();
 
      public: void SetDefaultConfigPath(const std::string &_path);
 
      public: std::string DefaultConfigPath() const;
 
      public: std::string ResolveConfigFile(const std::string &_path) const;
 
      public: void SetPluginPathEnv(const std::string &_env);
 
      public: void AddPluginPath(const std::string &_path);
 
      public: std::vector<std::pair<std::string, std::vector<std::string>>>
          PluginList();
 
      public: bool RemovePlugin(const std::string &_pluginName);
 
      public: std::shared_ptr<Plugin> PluginByName(
          const std::string &_pluginName) const;
 
      signals: void PluginAdded(const QString &_objectName);
 
      public slots: void OnPluginClose();
 
      public: bool CreateMainWindow();
 
      private: bool InitializeMainWindow();
 
      private: bool InitializeDialogs();
 
      private: void RemovePlugin(std::shared_ptr<Plugin> _plugin);
 
      private: bool AddPluginsToWindow();
 
      private: bool ApplyConfig();
 
      GZ_UTILS_UNIQUE_IMPL_PTR(dataPtr)
    };
 
    GZ_GUI_VISIBLE
    Application *App();
}  // namespace gz::gui
#endif  // GZ_GUI_APPLICATION_HH_