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
93 * vertical alignment point.
96 float v_position () const {
100 VAlign v_align () const {
104 Effect effect () const {
108 Colour effect_colour () const {
109 return _effect_colour;
112 Time fade_up_time () const {
113 return _fade_up_time;
116 Time fade_down_time () const {
117 return _fade_down_time;
124 int size_in_pixels (int screen_height) const;
126 /** @return Aspect ratio `adjustment' of the font size.
127 * Values greater than 1 widen each character, values less than 1 narrow each character,
128 * and the value must be between 0.25 and 4.
130 float aspect_adjust () const {
131 return _aspect_adjust;
134 void set_in (Time i) {
138 void set_out (Time o) {
142 void set_h_position (float p) {
146 /** @param p New vertical position as a proportion of the screen height
147 * from the top (between 0 and 1)
149 void set_v_position (float p) {
153 void set_size (int s) {
157 void set_aspect_adjust (float a) {
163 boost::optional<std::string> _font;
164 /** true if the text is italic */
168 /** Size in points as if the screen height is 11 inches, so a 72pt font
169 * would be 1/11th of the screen height.
172 float _aspect_adjust;
175 /** Horizontal position as a proportion of the screen width from the _h_align
180 /** Vertical position as a proportion of the screen height from the _v_align
187 Colour _effect_colour;
189 Time _fade_down_time;
192 bool operator== (SubtitleString const & a, SubtitleString const & b);
193 std::ostream& operator<< (std::ostream& s, SubtitleString const & sub);