/***************************************************************************************** * * * 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. * ****************************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include namespace { constexpr openspace::properties::Property::PropertyInfo TexturePathInfo = { "TexturePath", "Texture path", "Sets the path of the texture that is displayed on this screen space plane. If " "this value is changed, the image at the new path will automatically be loaded " "and displayed. The size of the image will also automatically set the default " "size of this plane.", openspace::properties::Property::Visibility::User }; // This `ScreenSpaceRenderable` can be used to display an image from a local file on // disk. // // To load an image from a web URL, see // [ScreenSpaceImageOnline](#base_screenspace_image_online). struct [[codegen::Dictionary(ScreenSpaceImageLocal)]] Parameters { std::optional identifier; // [[codegen::verbatim(TexturePathInfo.description)]] std::optional texturePath; }; #include "screenspaceimagelocal_codegen.cpp" } // namespace namespace openspace { documentation::Documentation ScreenSpaceImageLocal::Documentation() { return codegen::doc("base_screenspace_image_local"); } ScreenSpaceImageLocal::ScreenSpaceImageLocal(const ghoul::Dictionary& dictionary) : ScreenSpaceRenderable(dictionary) , _texturePath(TexturePathInfo) { const Parameters p = codegen::bake(dictionary); std::string identifier = p.identifier.value_or("ScreenSpaceImageLocal"); setIdentifier(makeUniqueIdentifier(std::move(identifier))); _texturePath.onChange([this]() { if (!std::filesystem::is_regular_file(absPath(_texturePath))) { LWARNINGC( "ScreenSpaceImageLocal", std::format( "Image '{}' did not exist for '{}'", _texturePath.value(), _identifier ) ); } else { _textureIsDirty = true; } }); addProperty(_texturePath); if (p.texturePath.has_value()) { if (std::filesystem::is_regular_file(absPath(*p.texturePath))) { _texturePath = absPath(*p.texturePath).string(); } else { LWARNINGC( "ScreenSpaceImageLocal", std::format( "Image '{}' did not exist for '{}'", *p.texturePath, _identifier ) ); } } } bool ScreenSpaceImageLocal::deinitializeGL() { _texture = nullptr; return ScreenSpaceRenderable::deinitializeGL(); } void ScreenSpaceImageLocal::update() { if (_textureIsDirty && !_texturePath.value().empty()) { std::unique_ptr texture = ghoul::io::TextureReader::ref().loadTexture(absPath(_texturePath), 2); if (texture) { // Images don't need to start on 4-byte boundaries, for example if the // image is only RGB glPixelStorei(GL_UNPACK_ALIGNMENT, 1); if (texture->format() == ghoul::opengl::Texture::Format::Red) { texture->setSwizzleMask({ GL_RED, GL_RED, GL_RED, GL_ONE }); } texture->uploadTexture(); texture->setFilter(ghoul::opengl::Texture::FilterMode::LinearMipMap); texture->purgeFromRAM(); _texture = std::move(texture); _objectSize = _texture->dimensions(); _textureIsDirty = false; } } } void ScreenSpaceImageLocal::bindTexture() { if (_texture) { _texture->bind(); } } } // namespace openspace