/***************************************************************************************** * * * OpenSpace * * * * Copyright (c) 2014-2021 * * * * 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 #include #include #include #include #include #include #include #include #include namespace openspace::luascriptfunctions { /** * \ingroup LuaScripts * toggleShutdown(): * Toggles the shutdown mode that will close the application after the countdown timer is * reached */ int toggleShutdown(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 0, "lua::toggleShutdown"); global::openSpaceEngine->toggleShutdownMode(); return 0; } /** * \ingroup LuaScripts * writeDocumentation(): * Writes out documentation files */ int writeDocumentation(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 0, "lua::writeDocumentation"); global::openSpaceEngine->writeStaticDocumentation(); global::openSpaceEngine->writeSceneDocumentation(); return 0; } /** * \ingroup LuaScripts * addVirtualProperty(): * Adds a virtual property that will set a group of properties */ int addVirtualProperty(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, { 5, 7 }, "lua::addVirtualProperty"); auto [type, name, identifier, description] = ghoul::lua::values(L); std::unique_ptr prop; if (type == "BoolProperty") { const bool v = ghoul::lua::value(L); prop = std::make_unique( properties::Property::PropertyInfo { identifier.c_str(), name.c_str(), description.c_str() }, v ); } else if (type == "IntProperty") { auto [v, min, max] = ghoul::lua::values(L); prop = std::make_unique( properties::Property::PropertyInfo { identifier.c_str(), name.c_str(), description.c_str() }, v, min, max ); } else if (type == "FloatProperty") { auto [v, min, max] = ghoul::lua::values(L); prop = std::make_unique( properties::Property::PropertyInfo { identifier.c_str(), name.c_str(), description.c_str() }, v, min, max ); } else if (type == "TriggerProperty") { prop = std::make_unique( properties::Property::PropertyInfo { identifier.c_str(), name.c_str(), description.c_str() } ); } else { return ghoul::lua::luaError(L, fmt::format("Unknown property type '{}'", type)); } global::virtualPropertyManager->addProperty(std::move(prop)); return 0; } /** * \ingroup LuaScripts * removeVirtualProperty(): * Removes a previously added virtual property */ int removeVirtualProperty(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 1, "lua::removeVirtualProperty"); const std::string name = ghoul::lua::value(L); properties::Property* p = global::virtualPropertyManager->property(name); if (p) { global::virtualPropertyManager->removeProperty(p); } else { LWARNINGC( "removeVirtualProperty", fmt::format("Virtual Property with name '{}' did not exist", name) ); } return 0; } /** * \ingroup LuaScripts * removeAllVirtualProperties(): * Remove all registered virtual properties */ int removeAllVirtualProperties(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 0, "lua::removeAllVirtualProperties"); for (properties::Property* p : global::virtualPropertyManager->properties()) { global::virtualPropertyManager->removeProperty(p); delete p; } return 0; } int setScreenshotFolder(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 1, "lua::setScreenshotFolder"); const std::string arg = ghoul::lua::value(L); std::filesystem::path folder = absPath(arg); if (!std::filesystem::exists(folder)) { std::filesystem::create_directory(folder); } FileSys.registerPathToken( "${SCREENSHOTS}", folder, ghoul::filesystem::FileSystem::Override::Yes ); global::windowDelegate->setScreenshotFolder(folder.string()); return 0; } /** * \ingroup LuaScripts * addTag() * Adds a Tag to a SceneGraphNode */ int addTag(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 2, "lua::addTag"); auto [uri, tag] = ghoul::lua::values(L); SceneGraphNode* node = global::renderEngine->scene()->sceneGraphNode(uri); if (!node) { return ghoul::lua::luaError(L, fmt::format("Unknown scene graph node '{}'", uri)); } node->addTag(std::move(tag)); return 0; } /** * \ingroup LuaScripts * removeTag(): * Removes a tag from a SceneGraphNode */ int removeTag(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 2, "lua::removeTag"); auto [uri, tag] = ghoul::lua::values(L); SceneGraphNode* node = global::renderEngine->scene()->sceneGraphNode(uri); if (!node) { return ghoul::lua::luaError(L, fmt::format("Unknown scene graph node '{}'", uri)); } node->removeTag(tag); return 0; } /** * \ingroup LuaScripts * downloadFile(): * Downloads a file from Lua interpreter */ int downloadFile(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, { 2, 3 }, "lua::downloadFile"); auto [uri, savePath, waitForComplete] = ghoul::lua::values>(L); waitForComplete = waitForComplete.value_or(false); LINFOC("OpenSpaceEngine", fmt::format("Downloading file from {}", uri)); std::shared_ptr future = global::downloadManager->downloadFile( uri, savePath, DownloadManager::OverrideFile::Yes, DownloadManager::FailOnError::Yes, 5 ); if (waitForComplete) { while (!future->isFinished && future->errorMessage.empty() ) { //just wait LTRACEC("OpenSpaceEngine", fmt::format("waiting {}", future->errorMessage)); } } if (!future || !future->isFinished) { return ghoul::lua::luaError( L, future ? "Download failed: " + future->errorMessage : "Download failed" ); } return 0; } /** * \ingroup LuaScripts * createSingleColorImage(): * Creates a one pixel image with a given color and returns the path to the cached file */ int createSingleColorImage(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 2, "lua::createSingleColorImage"); auto [name, d] = ghoul::lua::values(L); // @TODO (emmbr 2020-12-18) Verify that the input dictionary is a vec3 // Would like to clean this up with a more direct use of the Verifier in the future const std::string& key = "color"; ghoul::Dictionary colorDict; colorDict.setValue(key, d); documentation::TestResult res = documentation::Color3Verifier()(colorDict, key); if (!res.success) { return ghoul::lua::luaError( L, "Invalid color. Expected three double values {r, g, b} in range 0 to 1" ); } const glm::dvec3 color = colorDict.value(key); std::filesystem::path fileName = FileSys.cacheManager()->cachedFilename( name + ".ppm", "" ); const bool hasCachedFile = std::filesystem::is_regular_file(fileName); if (hasCachedFile) { LDEBUGC("OpenSpaceEngine", fmt::format("Cached file '{}' used", fileName)); ghoul::lua::push(L, fileName); return 1; } else { // Write the color to a ppm file static std::mutex fileMutex; std::lock_guard guard(fileMutex); std::ofstream ppmFile(fileName, std::ofstream::binary | std::ofstream::trunc); unsigned int width = 1; unsigned int height = 1; unsigned int size = width * height; std::vector img(size * 3); img[0] = static_cast(255 * color.r); img[1] = static_cast(255 * color.g); img[2] = static_cast(255 * color.b); if (ppmFile.is_open()) { ppmFile << "P6" << std::endl; ppmFile << width << " " << height << std::endl; ppmFile << 255 << std::endl; ppmFile.write(reinterpret_cast(&img[0]), size * 3); ppmFile.close(); ghoul::lua::push(L, fileName); return 1; } else { return ghoul::lua::luaError(L, "Could not open ppm file for writing."); } } } int isMaster(lua_State* L) { ghoul::lua::checkArgumentsAndThrow(L, 0, "lua::isMaster"); ghoul::lua::push(L, global::windowDelegate->isMaster()); return 1; } } // namespace openspace::luascriptfunctions