text: /*
   * This file is part of libSavitar
   *
   * Copyright (C) 2017 Ultimaker b.v. <j.vankessel@ultimaker.com>
   *
   * This program is free software: you can redistribute it and/or modify
   * it under the terms of the GNU Lesser General Public License as published
   * by the Free Software Foundation, either version 3 of the License, or
   * (at your option) any later version.
   *
   * This program is distributed in the hope that it will be useful,
   * but WITHOUT ANY WARRANTY; without even the implied warranty of
   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
   * GNU Lesser General Public License for more details.
   * You should have received a copy of the GNU Lesser General Public License
   * along with this program. If not, see <http://www.gnu.org/licenses/>.
   */
  
  #ifndef SCENE_H
  #define SCENE_H
  #include "SavitarExport.h"
  #include "SceneNode.h"
  
  #include <vector> // For std::vector
  #include <map> // For std::map
  #include <string> // For std::string
  
  // Forward declaration
  namespace pugi
  {
      class xml_node;
  }
  
  namespace Savitar
  {
      class SAVITAR_EXPORT Scene
      {
      public:
          /**
           * A Scene is an object that holds a number of SceneNodes, but also has some meta data entries. It also defines a unit in which the data is expressed.
           */
          Scene();
          virtual ~Scene();
  
          /**
           * Get the scene nodes in this scene.
           * \return The scene nodes that are in the scene.
           */
          std::vector<SceneNode*> getSceneNodes();
  
          std::vector<SceneNode*> getAllSceneNodes();
  
          /**
           * Add a scene node to the scene.
           * \param node The SceneNode to be added.
           */
          void addSceneNode(SceneNode* node);
  
          /**
           * Set the data of this SceneNode by giving it a xml node
           */
          void fillByXMLNode(pugi::xml_node xml_node);
  
          /**
           * Set a meta data entry of the scene.
           *
           * Note that this not adhere to the full 3mf spec yet. All keys are accepted.
           *
           * \param key The key of the meta data.
           * \param value The value of the meta data.
           */
          void setMetaDataEntry(std::string key, std::string value);
  
          /**
           * Get all meta data entries
           */
          std::map<std::string, std::string> getMetadata();
  
          /**
          * Get the unit (milimeter, inch, etc) of the scene.
          * This is in milimeter by default.
          */
          std::string getUnit();
  
          void setUnit(std::string unit);
  
      protected:
          std::vector< SceneNode*> scene_nodes;
          std::map<std::string, std::string> metadata;
          std::string unit;
  
          /**
           * Used to recursively create SceneNode objects based on xml nodes.
           * Because 3mf uses references, we also need to provide the root_node, so it's know what the reference points to
           * \returns The created SceneNode.
           */
          SceneNode* createSceneNodeFromObject(pugi::xml_node root_node, pugi::xml_node object_node);
      };
  }
  #endif