/** * @file * @brief Header file for TextReader class * @author Jonathan Thomas * * @section LICENSE * * Copyright (c) 2008-2013 OpenShot Studios, LLC * (http://www.openshotstudios.com). This file is part of * OpenShot Library (http://www.openshot.org), an open-source project * dedicated to delivering high quality video editing and animation solutions * to the world. * * OpenShot Library is free software: you can redistribute it and/or modify * it under the terms of the GNU 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 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 General Public License for more details. * * You should have received a copy of the GNU General Public License * along with OpenShot Library. If not, see . */ #ifndef OPENSHOT_TEXT_READER_H #define OPENSHOT_TEXT_READER_H #include "ReaderBase.h" #include #include #include #include #include #include #include "Magick++.h" #include "Cache.h" #include "Clip.h" #include "Exceptions.h" using namespace std; namespace openshot { /** * @brief This class uses the ImageMagick++ libraries, to create frames with "Text", and return * openshot::Frame objects. * * All system fonts are supported, including many different font properties, such as size, color, * alignment, padding, etc... * * @code * // Create a reader to generate an openshot::Frame containing text * TextReader r(720, // width * 480, // height * 5, // x_offset * 5, // y_offset * GRAVITY_CENTER, // gravity * "Check out this Text!", // text * "Arial", // font * 15.0, // size * "#fff000", // text_color * "#000000" // background_color * ); * r.Open(); // Open the reader * * // Get frame number 1 from the video (in fact, any frame # you request will return the same frame) * tr1::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 TextReader : public ReaderBase { private: int width; int height; int x_offset; int y_offset; string text; string font; double size; string text_color; string background_color; tr1::shared_ptr image; list lines; bool is_open; GravityType gravity; public: /// @brief Constructor for TextReader. /// @param width The width of the requested openshot::Frame (not the size of the text) /// @param height The height of the requested openshot::Frame (not the size of the text) /// @param x_offset The number of pixels to offset the text on the X axis (horizontal) /// @param y_offset The number of pixels to offset the text on the Y axis (vertical) /// @param gravity The alignment / gravity of the text /// @param text The text you want to generate / display /// @param font The font of the text /// @param size The size of the text /// @param text_color The color of the text /// @param background_color The background color of the text (also supports Transparent) TextReader(int width, int height, int x_offset, int y_offset, GravityType gravity, string text, string font, double size, string text_color, string background_color); /// Close Reader void Close(); /// 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. tr1::shared_ptr GetFrame(int requested_frame) throw(ReaderClosed); /// Get and Set JSON methods Json::Value JsonValue(); ///< Generate Json::JsonValue for this object void Json(Json::Value root) throw(InvalidFile); ///< Load Json::JsonValue into this object /// Open Reader - which is called by the constructor automatically void Open(); }; } #endif