2 Copyright (C) 2012-2015 Carl Hetherington <cth@carlh.net>
4 This program is free software; you can redistribute it and/or modify
5 it under the terms of the GNU General Public License as published by
6 the Free Software Foundation; either version 2 of the License, or
7 (at your option) any later version.
9 This program is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 GNU General Public License for more details.
14 You should have received a copy of the GNU General Public License
15 along with this program; if not, write to the Free Software
16 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
20 /** @file src/subtitle_string.h
21 * @brief SubtitleString class.
24 #ifndef LIBDCP_SUBTITLE_STRING_H
25 #define LIBDCP_SUBTITLE_STRING_H
29 #include <boost/optional.hpp>
34 /** @class SubtitleString
35 * @brief A single line of subtitle text with all the associated attributes.
41 boost::optional<std::string> font,
59 /** @return font ID */
60 boost::optional<std::string> font () const {
64 bool italic () const {
68 Colour colour () const {
80 std::string text () const {
84 float h_position () const {
88 HAlign h_align () const {
92 /** @return vertical position as a proportion of the screen height from the top
95 float v_position () const {
99 VAlign v_align () const {
103 Effect effect () const {
107 Colour effect_colour () const {
108 return _effect_colour;
111 Time fade_up_time () const {
112 return _fade_up_time;
115 Time fade_down_time () const {
116 return _fade_down_time;
123 int size_in_pixels (int screen_height) const;
125 /** @return Aspect ratio `adjustment' of the font size.
126 * Values greater than 1 widen each character, values less than 1 narrow each character,
127 * and the value must be between 0.25 and 4.
129 float aspect_adjust () const {
130 return _aspect_adjust;
133 /** @param p New vertical position as a proportion of the screen height
134 * from the top (between 0 and 1)
136 void set_v_position (float p) {
140 void set_size (int s) {
144 void set_aspect_adjust (float a) {
150 boost::optional<std::string> _font;
151 /** true if the text is italic */
155 /** Size in points as if the screen height is 11 inches, so a 72pt font
156 * would be 1/11th of the screen height.
159 float _aspect_adjust;
162 /** Horizontal position as a proportion of the screen width from the _h_align
167 /** Vertical position as a proportion of the screen height from the _v_align
174 Colour _effect_colour;
176 Time _fade_down_time;
179 bool operator== (SubtitleString const & a, SubtitleString const & b);
180 std::ostream& operator<< (std::ostream& s, SubtitleString const & sub);