/** * @file * @brief Header file for ImageReader class * @author Jonathan Thomas * * @ref License */ /* LICENSE * * Copyright (c) 2008-2019 OpenShot Studios, LLC * . This file is part of * OpenShot Library (libopenshot), an open-source project dedicated to * delivering high quality video editing and animation solutions to the * world. For more information visit . * * OpenShot Library (libopenshot) 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. * * OpenShot Library (libopenshot) 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 OpenShot Library. If not, see . */ #ifndef OPENSHOT_IMAGE_READER_H #define OPENSHOT_IMAGE_READER_H // Require ImageMagick support #ifdef USE_IMAGEMAGICK #include "ReaderBase.h" #include #include #include #include #include #include #include "CacheMemory.h" #include "Exceptions.h" #include "MagickUtilities.h" namespace openshot { /** * @brief This class uses the ImageMagick++ libraries, to open image files, and return * openshot::Frame objects containing the image. * * @code * // Create a reader for a video * ImageReader r("MyAwesomeImage.jpeg"); * r.Open(); // Open the reader * * // Get frame number 1 from the video * std::shared_ptr f = r.GetFrame(1); * * // Now that we have an openshot::Frame object, lets have some fun! * f->Display(); // Display the frame on the screen * * // Close the reader * r.Close(); * @endcode */ class ImageReader : public ReaderBase { private: std::string path; std::shared_ptr image; bool is_open; public: /// Constructor for ImageReader. This automatically opens the media file and loads /// frame 1, or it throws one of the following exceptions. ImageReader(std::string path); /// Constructor for ImageReader. This only opens the media file to inspect its properties /// if inspect_reader=true. When not inspecting the media file, it's much faster, and useful /// when you are inflating the object using JSON after instantiating it. ImageReader(std::string path, bool inspect_reader); /// Close File void Close() override; /// Get the cache object used by this reader (always returns NULL for this object) CacheMemory* GetCache() override { return NULL; }; /// Get an openshot::Frame object for a specific frame number of this reader. All numbers /// return the same Frame, since they all share the same image data. /// /// @returns The requested frame (containing the image) /// @param requested_frame The frame number that is requested. std::shared_ptr GetFrame(int64_t requested_frame) override; /// Determine if reader is open or closed bool IsOpen() override { return is_open; }; /// Return the type name of the class std::string Name() override { return "ImageReader"; }; /// Get and Set JSON methods std::string Json() const override; ///< Generate JSON string of this object void SetJson(const std::string value) override; ///< Load JSON string into this object Json::Value JsonValue() const override; ///< Generate Json::Value for this object void SetJsonValue(const Json::Value root) override; ///< Load Json::Value into this object /// Open File - which is called by the constructor automatically void Open() override; }; } #endif //USE_IMAGEMAGICK #endif //OPENSHOT_IMAGE_READER_H