text: /*****************************************************************************************
   *                                                                                       *
   * OpenSpace                                                                             *
   *                                                                                       *
   * Copyright (c) 2014-2019                                                               *
   *                                                                                       *
   * 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.                                         *
   ****************************************************************************************/
  
  #include <openspace/engine/globals.h>
  
  namespace openspace::luascriptfunctions {
  
  /**
  * \ingroup LuaScripts
  * setRenderer(string):
  * Set renderer
  */
  int setRenderer(lua_State* L) {
      ghoul::lua::checkArgumentsAndThrow(L, 1, "lua::setRenderer");
  
      const int type = lua_type(L, -1);
      if (type != LUA_TSTRING) {
          return ghoul::lua::luaError(L, "Expected argument of type 'string'");
      }
  
      const std::string& renderer = ghoul::lua::value<std::string>(
          L,
          1,
          ghoul::lua::PopValue::Yes
      );
      global::renderEngine.setRendererFromString(renderer);
  
      ghoul_assert(lua_gettop(L) == 0, "Incorrect number of items left on stack");
      return 0;
  }
  
  int addScreenSpaceRenderable(lua_State* L) {
      ghoul::lua::checkArgumentsAndThrow(L, 1, "lua::addScreenSpaceRenderable");
  
      using ghoul::lua::errorLocation;
  
      ghoul::Dictionary d;
      try {
          ghoul::lua::luaDictionaryFromState(L, d);
          lua_settop(L, 0);
      }
      catch (const ghoul::lua::LuaFormatException& e) {
          LERRORC("addScreenSpaceRenderable", e.what());
          lua_settop(L, 0);
          return 0;
      }
  
      std::unique_ptr<ScreenSpaceRenderable> s =
          ScreenSpaceRenderable::createFromDictionary(d);
  
      global::renderEngine.addScreenSpaceRenderable(std::move(s));
  
      ghoul_assert(lua_gettop(L) == 0, "Incorrect number of items left on stack");
      return 0;
  }
  
  int removeScreenSpaceRenderable(lua_State* L) {
      ghoul::lua::checkArgumentsAndThrow(L, 1, "lua::removeScreenSpaceRenderable");
  
      const std::string& name = ghoul::lua::value<std::string>(
          L,
          1,
          ghoul::lua::PopValue::Yes
      );
      global::renderEngine.removeScreenSpaceRenderable(name);
  
      ghoul_assert(lua_gettop(L) == 0, "Incorrect number of items left on stack");
      return 0;
  }
  
  int takeScreenshot(lua_State* L) {
      ghoul::lua::checkArgumentsAndThrow(L, 0, "lua::takeScreenshot");
  
      global::renderEngine.takeScreenshot();
      const unsigned int screenshotNumber = global::renderEngine.latestScreenshotNumber();
  
      lua_pushinteger(L, screenshotNumber);
      return 1;
  }
  
  }// namespace openspace::luascriptfunctions
  