2 Copyright (C) 2013-2018 Carl Hetherington <cth@carlh.net>
4 This file is part of DCP-o-matic.
6 DCP-o-matic is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 DCP-o-matic is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with DCP-o-matic. If not, see <http://www.gnu.org/licenses/>.
21 #include "text_content.h"
23 #include "exceptions.h"
26 #include <dcp/raw_convert.h>
27 #include <libcxml/cxml.h>
28 #include <libxml++/libxml++.h>
29 #include <boost/foreach.hpp>
38 using boost::shared_ptr;
39 using boost::dynamic_pointer_cast;
40 using boost::optional;
41 using dcp::raw_convert;
43 int const TextContentProperty::X_OFFSET = 500;
44 int const TextContentProperty::Y_OFFSET = 501;
45 int const TextContentProperty::X_SCALE = 502;
46 int const TextContentProperty::Y_SCALE = 503;
47 int const TextContentProperty::USE = 504;
48 int const TextContentProperty::BURN = 505;
49 int const TextContentProperty::LANGUAGE = 506;
50 int const TextContentProperty::FONTS = 507;
51 int const TextContentProperty::COLOUR = 508;
52 int const TextContentProperty::EFFECT = 509;
53 int const TextContentProperty::EFFECT_COLOUR = 510;
54 int const TextContentProperty::LINE_SPACING = 511;
55 int const TextContentProperty::FADE_IN = 512;
56 int const TextContentProperty::FADE_OUT = 513;
57 int const TextContentProperty::OUTLINE_WIDTH = 514;
58 int const TextContentProperty::TYPE = 515;
60 TextContent::TextContent (Content* parent, TextType type, TextType original_type)
61 : ContentPart (parent)
71 , _original_type (original_type)
76 /** @return TextContents from node or <Caption> nodes under node (according to version).
77 * The list could be empty if no TextContents are found.
79 list<shared_ptr<TextContent> >
80 TextContent::from_xml (Content* parent, cxml::ConstNodePtr node, int version)
83 /* With old metadata FFmpeg content has the subtitle-related tags even with no
84 subtitle streams, so check for that.
86 if (node->string_child("Type") == "FFmpeg" && node->node_children("SubtitleStream").empty()) {
87 return list<shared_ptr<TextContent> >();
90 /* Otherwise we can drop through to the newer logic */
94 if (!node->optional_number_child<double>("SubtitleXOffset") && !node->optional_number_child<double>("SubtitleOffset")) {
95 return list<shared_ptr<TextContent> >();
97 list<shared_ptr<TextContent> > c;
98 c.push_back (shared_ptr<TextContent> (new TextContent (parent, node, version)));
102 if (!node->optional_node_child("Caption")) {
103 return list<shared_ptr<TextContent> >();
106 list<shared_ptr<TextContent> > c;
107 BOOST_FOREACH (cxml::ConstNodePtr i, node->node_children("Caption")) {
108 c.push_back (shared_ptr<TextContent> (new TextContent (parent, i, version)));
113 TextContent::TextContent (Content* parent, cxml::ConstNodePtr node, int version)
114 : ContentPart (parent)
121 , _line_spacing (node->optional_number_child<double>("LineSpacing").get_value_or (1))
122 , _outline_width (node->optional_number_child<int>("OutlineWidth").get_value_or (2))
123 , _type (TEXT_OPEN_SUBTITLE)
126 _use = node->bool_child ("Use");
127 _burn = node->bool_child ("Burn");
128 } else if (version >= 32) {
129 _use = node->bool_child ("UseSubtitles");
130 _burn = node->bool_child ("BurnSubtitles");
134 _x_offset = node->number_child<double> ("XOffset");
135 _y_offset = node->number_child<double> ("YOffset");
136 } else if (version >= 7) {
137 _x_offset = node->number_child<double> ("SubtitleXOffset");
138 _y_offset = node->number_child<double> ("SubtitleYOffset");
140 _y_offset = node->number_child<double> ("SubtitleOffset");
143 if (node->optional_bool_child("Outline").get_value_or(false)) {
144 _effect = dcp::BORDER;
145 } else if (node->optional_bool_child("Shadow").get_value_or(false)) {
146 _effect = dcp::SHADOW;
151 optional<string> effect = node->optional_string_child("Effect");
153 if (*effect == "none") {
155 } else if (*effect == "outline") {
156 _effect = dcp::BORDER;
157 } else if (*effect == "shadow") {
158 _effect = dcp::SHADOW;
163 _x_scale = node->number_child<double> ("XScale");
164 _y_scale = node->number_child<double> ("YScale");
165 } else if (version >= 10) {
166 _x_scale = node->number_child<double> ("SubtitleXScale");
167 _y_scale = node->number_child<double> ("SubtitleYScale");
169 _x_scale = _y_scale = node->number_child<double> ("SubtitleScale");
172 optional<int> r = node->optional_number_child<int>("Red");
173 optional<int> g = node->optional_number_child<int>("Green");
174 optional<int> b = node->optional_number_child<int>("Blue");
176 _colour = dcp::Colour (*r, *g, *b);
180 optional<int> er = node->optional_number_child<int>("EffectRed");
181 optional<int> eg = node->optional_number_child<int>("EffectGreen");
182 optional<int> eb = node->optional_number_child<int>("EffectBlue");
183 if (er && eg && eb) {
184 _effect_colour = dcp::Colour (*er, *eg, *eb);
187 _effect_colour = dcp::Colour (
188 node->optional_number_child<int>("OutlineRed").get_value_or(255),
189 node->optional_number_child<int>("OutlineGreen").get_value_or(255),
190 node->optional_number_child<int>("OutlineBlue").get_value_or(255)
196 fi = node->optional_number_child<Frame>("FadeIn");
198 fi = node->optional_number_child<Frame>("SubtitleFadeIn");
201 _fade_in = ContentTime (*fi);
206 fo = node->optional_number_child<Frame>("FadeOut");
208 fo = node->optional_number_child<Frame>("SubtitleFadeOut");
211 _fade_out = ContentTime (*fo);
215 _language = node->optional_string_child ("Language").get_value_or ("");
217 _language = node->optional_string_child ("SubtitleLanguage").get_value_or ("");
220 list<cxml::NodePtr> fonts = node->node_children ("Font");
221 for (list<cxml::NodePtr>::const_iterator i = fonts.begin(); i != fonts.end(); ++i) {
222 _fonts.push_back (shared_ptr<Font> (new Font (*i)));
227 _type = string_to_text_type (node->optional_string_child("Type").get_value_or("open"));
228 if (node->optional_string_child("OriginalType")) {
229 _original_type = string_to_text_type (node->optional_string_child("OriginalType").get());
233 TextContent::TextContent (Content* parent, vector<shared_ptr<Content> > c)
234 : ContentPart (parent)
236 /* This constructor is for join which is only supported for content types
237 that have a single text, so we can use only_text() here.
239 shared_ptr<TextContent> ref = c[0]->only_text();
240 DCPOMATIC_ASSERT (ref);
241 list<shared_ptr<Font> > ref_fonts = ref->fonts ();
243 for (size_t i = 1; i < c.size(); ++i) {
245 if (c[i]->only_text()->use() != ref->use()) {
246 throw JoinError (_("Content to be joined must have the same 'use subtitles' setting."));
249 if (c[i]->only_text()->burn() != ref->burn()) {
250 throw JoinError (_("Content to be joined must have the same 'burn subtitles' setting."));
253 if (c[i]->only_text()->x_offset() != ref->x_offset()) {
254 throw JoinError (_("Content to be joined must have the same subtitle X offset."));
257 if (c[i]->only_text()->y_offset() != ref->y_offset()) {
258 throw JoinError (_("Content to be joined must have the same subtitle Y offset."));
261 if (c[i]->only_text()->x_scale() != ref->x_scale()) {
262 throw JoinError (_("Content to be joined must have the same subtitle X scale."));
265 if (c[i]->only_text()->y_scale() != ref->y_scale()) {
266 throw JoinError (_("Content to be joined must have the same subtitle Y scale."));
269 if (c[i]->only_text()->line_spacing() != ref->line_spacing()) {
270 throw JoinError (_("Content to be joined must have the same subtitle line spacing."));
273 if ((c[i]->only_text()->fade_in() != ref->fade_in()) || (c[i]->only_text()->fade_out() != ref->fade_out())) {
274 throw JoinError (_("Content to be joined must have the same subtitle fades."));
277 if ((c[i]->only_text()->outline_width() != ref->outline_width())) {
278 throw JoinError (_("Content to be joined must have the same outline width."));
281 list<shared_ptr<Font> > fonts = c[i]->only_text()->fonts ();
282 if (fonts.size() != ref_fonts.size()) {
283 throw JoinError (_("Content to be joined must use the same fonts."));
286 list<shared_ptr<Font> >::const_iterator j = ref_fonts.begin ();
287 list<shared_ptr<Font> >::const_iterator k = fonts.begin ();
289 while (j != ref_fonts.end ()) {
291 throw JoinError (_("Content to be joined must use the same fonts."));
299 _burn = ref->burn ();
300 _x_offset = ref->x_offset ();
301 _y_offset = ref->y_offset ();
302 _x_scale = ref->x_scale ();
303 _y_scale = ref->y_scale ();
304 _language = ref->language ();
306 _line_spacing = ref->line_spacing ();
307 _fade_in = ref->fade_in ();
308 _fade_out = ref->fade_out ();
309 _outline_width = ref->outline_width ();
310 _type = ref->type ();
311 _original_type = ref->original_type ();
316 /** _mutex must not be held on entry */
318 TextContent::as_xml (xmlpp::Node* root) const
320 boost::mutex::scoped_lock lm (_mutex);
322 xmlpp::Element* text = root->add_child ("Text");
324 text->add_child("Use")->add_child_text (_use ? "1" : "0");
325 text->add_child("Burn")->add_child_text (_burn ? "1" : "0");
326 text->add_child("XOffset")->add_child_text (raw_convert<string> (_x_offset));
327 text->add_child("YOffset")->add_child_text (raw_convert<string> (_y_offset));
328 text->add_child("XScale")->add_child_text (raw_convert<string> (_x_scale));
329 text->add_child("YScale")->add_child_text (raw_convert<string> (_y_scale));
330 text->add_child("Language")->add_child_text (_language);
332 text->add_child("Red")->add_child_text (raw_convert<string> (_colour->r));
333 text->add_child("Green")->add_child_text (raw_convert<string> (_colour->g));
334 text->add_child("Blue")->add_child_text (raw_convert<string> (_colour->b));
339 text->add_child("Effect")->add_child_text("none");
342 text->add_child("Effect")->add_child_text("outline");
345 text->add_child("Effect")->add_child_text("shadow");
349 if (_effect_colour) {
350 text->add_child("EffectRed")->add_child_text (raw_convert<string> (_effect_colour->r));
351 text->add_child("EffectGreen")->add_child_text (raw_convert<string> (_effect_colour->g));
352 text->add_child("EffectBlue")->add_child_text (raw_convert<string> (_effect_colour->b));
354 text->add_child("LineSpacing")->add_child_text (raw_convert<string> (_line_spacing));
356 text->add_child("FadeIn")->add_child_text (raw_convert<string> (_fade_in->get()));
359 text->add_child("FadeOut")->add_child_text (raw_convert<string> (_fade_out->get()));
361 text->add_child("OutlineWidth")->add_child_text (raw_convert<string> (_outline_width));
363 for (list<shared_ptr<Font> >::const_iterator i = _fonts.begin(); i != _fonts.end(); ++i) {
364 (*i)->as_xml (text->add_child("Font"));
367 text->add_child("Type")->add_child_text (text_type_to_string(_type));
368 text->add_child("OriginalType")->add_child_text (text_type_to_string(_original_type));
372 TextContent::identifier () const
374 string s = raw_convert<string> (x_scale())
375 + "_" + raw_convert<string> (y_scale())
376 + "_" + raw_convert<string> (x_offset())
377 + "_" + raw_convert<string> (y_offset())
378 + "_" + raw_convert<string> (line_spacing())
379 + "_" + raw_convert<string> (fade_in().get_value_or(ContentTime()).get())
380 + "_" + raw_convert<string> (fade_out().get_value_or(ContentTime()).get())
381 + "_" + raw_convert<string> (outline_width())
382 + "_" + raw_convert<string> (colour().get_value_or(dcp::Colour(255, 255, 255)).to_argb_string())
383 + "_" + raw_convert<string> (dcp::effect_to_string(effect().get_value_or(dcp::NONE)))
384 + "_" + raw_convert<string> (effect_colour().get_value_or(dcp::Colour(0, 0, 0)).to_argb_string());
386 /* XXX: I suppose really _fonts shouldn't be in here, since not all
387 types of subtitle content involve fonts.
389 BOOST_FOREACH (shared_ptr<Font> f, _fonts) {
390 for (int i = 0; i < FontFiles::VARIANTS; ++i) {
391 s += "_" + f->file(static_cast<FontFiles::Variant>(i)).get_value_or("Default").string();
395 /* The language is for metadata only, and doesn't affect
396 how this content looks.
403 TextContent::add_font (shared_ptr<Font> font)
405 _fonts.push_back (font);
410 TextContent::connect_to_fonts ()
412 BOOST_FOREACH (boost::signals2::connection& i, _font_connections) {
416 _font_connections.clear ();
418 BOOST_FOREACH (shared_ptr<Font> i, _fonts) {
419 _font_connections.push_back (i->Changed.connect (boost::bind (&TextContent::font_changed, this)));
424 TextContent::font_changed ()
426 _parent->signal_changed (TextContentProperty::FONTS);
430 TextContent::set_colour (dcp::Colour colour)
432 maybe_set (_colour, colour, TextContentProperty::COLOUR);
436 TextContent::unset_colour ()
438 maybe_set (_colour, optional<dcp::Colour>(), TextContentProperty::COLOUR);
442 TextContent::set_effect (dcp::Effect e)
444 maybe_set (_effect, e, TextContentProperty::EFFECT);
448 TextContent::unset_effect ()
450 maybe_set (_effect, optional<dcp::Effect>(), TextContentProperty::EFFECT);
454 TextContent::set_effect_colour (dcp::Colour colour)
456 maybe_set (_effect_colour, colour, TextContentProperty::EFFECT_COLOUR);
460 TextContent::unset_effect_colour ()
462 maybe_set (_effect_colour, optional<dcp::Colour>(), TextContentProperty::EFFECT_COLOUR);
466 TextContent::set_use (bool u)
468 maybe_set (_use, u, TextContentProperty::USE);
472 TextContent::set_burn (bool b)
474 maybe_set (_burn, b, TextContentProperty::BURN);
478 TextContent::set_x_offset (double o)
480 maybe_set (_x_offset, o, TextContentProperty::X_OFFSET);
484 TextContent::set_y_offset (double o)
486 maybe_set (_y_offset, o, TextContentProperty::Y_OFFSET);
490 TextContent::set_x_scale (double s)
492 maybe_set (_x_scale, s, TextContentProperty::X_SCALE);
496 TextContent::set_y_scale (double s)
498 maybe_set (_y_scale, s, TextContentProperty::Y_SCALE);
502 TextContent::set_language (string language)
504 maybe_set (_language, language, TextContentProperty::LANGUAGE);
508 TextContent::set_line_spacing (double s)
510 maybe_set (_line_spacing, s, TextContentProperty::LINE_SPACING);
514 TextContent::set_fade_in (ContentTime t)
516 maybe_set (_fade_in, t, TextContentProperty::FADE_IN);
520 TextContent::unset_fade_in ()
522 maybe_set (_fade_in, optional<ContentTime>(), TextContentProperty::FADE_IN);
526 TextContent::set_fade_out (ContentTime t)
528 maybe_set (_fade_out, t, TextContentProperty::FADE_OUT);
532 TextContent::unset_fade_out ()
534 maybe_set (_fade_out, optional<ContentTime>(), TextContentProperty::FADE_OUT);
538 TextContent::set_type (TextType type)
540 maybe_set (_type, type, TextContentProperty::TYPE);
544 TextContent::set_outline_width (int w)
546 maybe_set (_outline_width, w, TextContentProperty::OUTLINE_WIDTH);
550 TextContent::take_settings_from (shared_ptr<const TextContent> c)
554 set_x_offset (c->_x_offset);
555 set_y_offset (c->_y_offset);
556 set_x_scale (c->_x_scale);
557 set_y_scale (c->_y_scale);
558 maybe_set (_fonts, c->_fonts, TextContentProperty::FONTS);
560 set_colour (*c->_colour);
565 set_effect (*c->_effect);
567 if (c->_effect_colour) {
568 set_effect_colour (*c->_effect_colour);
570 unset_effect_colour ();
572 set_line_spacing (c->_line_spacing);
574 set_fade_in (*c->_fade_in);
577 set_fade_out (*c->_fade_out);
579 set_outline_width (c->_outline_width);