2 Copyright (C) 2013-2021 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/>.
22 #include "text_content.h"
24 #include "exceptions.h"
27 #include <dcp/raw_convert.h>
28 #include <libcxml/cxml.h>
29 #include <libxml++/libxml++.h>
39 using std::shared_ptr;
40 using std::make_shared;
41 using std::dynamic_pointer_cast;
42 using boost::optional;
43 using dcp::raw_convert;
44 using namespace dcpomatic;
47 int const TextContentProperty::X_OFFSET = 500;
48 int const TextContentProperty::Y_OFFSET = 501;
49 int const TextContentProperty::X_SCALE = 502;
50 int const TextContentProperty::Y_SCALE = 503;
51 int const TextContentProperty::USE = 504;
52 int const TextContentProperty::BURN = 505;
53 int const TextContentProperty::FONTS = 506;
54 int const TextContentProperty::COLOUR = 507;
55 int const TextContentProperty::EFFECT = 508;
56 int const TextContentProperty::EFFECT_COLOUR = 509;
57 int const TextContentProperty::LINE_SPACING = 510;
58 int const TextContentProperty::FADE_IN = 511;
59 int const TextContentProperty::FADE_OUT = 512;
60 int const TextContentProperty::OUTLINE_WIDTH = 513;
61 int const TextContentProperty::TYPE = 514;
62 int const TextContentProperty::DCP_TRACK = 515;
63 int const TextContentProperty::LANGUAGE = 516;
64 int const TextContentProperty::LANGUAGE_IS_ADDITIONAL = 517;
67 TextContent::TextContent (Content* parent, TextType type, TextType original_type)
68 : ContentPart (parent)
78 , _original_type (original_type)
83 /** @return TextContents from node or <Text> nodes under node (according to version).
84 * The vector could be empty if no TextContents are found.
86 vector<shared_ptr<TextContent>>
87 TextContent::from_xml (Content* parent, cxml::ConstNodePtr node, int version, list<string>& notes)
90 /* With old metadata FFmpeg content has the subtitle-related tags even with no
91 subtitle streams, so check for that.
93 if (node->string_child("Type") == "FFmpeg" && node->node_children("SubtitleStream").empty()) {
97 /* Otherwise we can drop through to the newer logic */
101 if (!node->optional_number_child<double>("SubtitleXOffset") && !node->optional_number_child<double>("SubtitleOffset")) {
104 return { make_shared<TextContent>(parent, node, version, notes) };
107 vector<shared_ptr<TextContent>> content;
108 for (auto i: node->node_children("Text")) {
109 content.push_back(make_shared<TextContent>(parent, i, version, notes));
116 TextContent::TextContent (Content* parent, cxml::ConstNodePtr node, int version, list<string>& notes)
117 : ContentPart (parent)
124 , _line_spacing (node->optional_number_child<double>("LineSpacing").get_value_or(1))
125 , _outline_width (node->optional_number_child<int>("OutlineWidth").get_value_or(4))
126 , _type (TextType::OPEN_SUBTITLE)
127 , _original_type (TextType::OPEN_SUBTITLE)
130 _use = node->bool_child ("Use");
131 _burn = node->bool_child ("Burn");
132 } else if (version >= 32) {
133 _use = node->bool_child ("UseSubtitles");
134 _burn = node->bool_child ("BurnSubtitles");
138 _x_offset = node->number_child<double> ("XOffset");
139 _y_offset = node->number_child<double> ("YOffset");
140 } else if (version >= 7) {
141 _x_offset = node->number_child<double> ("SubtitleXOffset");
142 _y_offset = node->number_child<double> ("SubtitleYOffset");
144 _y_offset = node->number_child<double> ("SubtitleOffset");
147 if (node->optional_bool_child("Outline").get_value_or(false)) {
148 _effect = dcp::Effect::BORDER;
149 } else if (node->optional_bool_child("Shadow").get_value_or(false)) {
150 _effect = dcp::Effect::SHADOW;
152 _effect = dcp::Effect::NONE;
155 auto effect = node->optional_string_child("Effect");
157 if (*effect == "none") {
158 _effect = dcp::Effect::NONE;
159 } else if (*effect == "outline") {
160 _effect = dcp::Effect::BORDER;
161 } else if (*effect == "shadow") {
162 _effect = dcp::Effect::SHADOW;
167 _x_scale = node->number_child<double> ("XScale");
168 _y_scale = node->number_child<double> ("YScale");
169 } else if (version >= 10) {
170 _x_scale = node->number_child<double> ("SubtitleXScale");
171 _y_scale = node->number_child<double> ("SubtitleYScale");
173 _x_scale = _y_scale = node->number_child<double> ("SubtitleScale");
176 auto r = node->optional_number_child<int>("Red");
177 auto g = node->optional_number_child<int>("Green");
178 auto b = node->optional_number_child<int>("Blue");
180 _colour = dcp::Colour (*r, *g, *b);
184 auto er = node->optional_number_child<int>("EffectRed");
185 auto eg = node->optional_number_child<int>("EffectGreen");
186 auto eb = node->optional_number_child<int>("EffectBlue");
187 if (er && eg && eb) {
188 _effect_colour = dcp::Colour (*er, *eg, *eb);
191 _effect_colour = dcp::Colour (
192 node->optional_number_child<int>("OutlineRed").get_value_or(255),
193 node->optional_number_child<int>("OutlineGreen").get_value_or(255),
194 node->optional_number_child<int>("OutlineBlue").get_value_or(255)
200 fi = node->optional_number_child<Frame>("FadeIn");
202 fi = node->optional_number_child<Frame>("SubtitleFadeIn");
205 _fade_in = ContentTime (*fi);
210 fo = node->optional_number_child<Frame>("FadeOut");
212 fo = node->optional_number_child<Frame>("SubtitleFadeOut");
215 _fade_out = ContentTime (*fo);
218 for (auto i: node->node_children ("Font")) {
219 _fonts.push_back (make_shared<Font>(i));
225 _type = string_to_text_type (node->optional_string_child("Type").get_value_or("open"));
226 if (node->optional_string_child("OriginalType")) {
227 _original_type = string_to_text_type (node->optional_string_child("OriginalType").get());
231 auto dt = node->optional_node_child("DCPTrack");
233 _dcp_track = DCPTextTrack (dt);
236 auto lang = node->optional_node_child("Language");
239 _language = dcp::LanguageTag(lang->content());
240 auto add = lang->optional_bool_attribute("Additional");
241 _language_is_additional = add && *add;
242 } catch (dcp::LanguageTagError&) {
243 /* The language tag can be empty or invalid if it was loaded from a
244 * 2.14.x metadata file; we'll just ignore it in that case.
247 if (!lang->content().empty()) {
248 notes.push_back (String::compose(
249 _("A subtitle or closed caption file in this project is marked with the language '%1', "
250 "which DCP-o-matic does not recognise. The file's language has been cleared."), lang->content()));
259 TextContent::TextContent (Content* parent, vector<shared_ptr<Content>> c)
260 : ContentPart (parent)
262 /* This constructor is for join which is only supported for content types
263 that have a single text, so we can use only_text() here.
265 auto ref = c[0]->only_text();
266 DCPOMATIC_ASSERT (ref);
267 auto ref_fonts = ref->fonts ();
269 for (size_t i = 1; i < c.size(); ++i) {
271 if (c[i]->only_text()->use() != ref->use()) {
272 throw JoinError (_("Content to be joined must have the same 'use subtitles' setting."));
275 if (c[i]->only_text()->burn() != ref->burn()) {
276 throw JoinError (_("Content to be joined must have the same 'burn subtitles' setting."));
279 if (c[i]->only_text()->x_offset() != ref->x_offset()) {
280 throw JoinError (_("Content to be joined must have the same subtitle X offset."));
283 if (c[i]->only_text()->y_offset() != ref->y_offset()) {
284 throw JoinError (_("Content to be joined must have the same subtitle Y offset."));
287 if (c[i]->only_text()->x_scale() != ref->x_scale()) {
288 throw JoinError (_("Content to be joined must have the same subtitle X scale."));
291 if (c[i]->only_text()->y_scale() != ref->y_scale()) {
292 throw JoinError (_("Content to be joined must have the same subtitle Y scale."));
295 if (c[i]->only_text()->line_spacing() != ref->line_spacing()) {
296 throw JoinError (_("Content to be joined must have the same subtitle line spacing."));
299 if ((c[i]->only_text()->fade_in() != ref->fade_in()) || (c[i]->only_text()->fade_out() != ref->fade_out())) {
300 throw JoinError (_("Content to be joined must have the same subtitle fades."));
303 if ((c[i]->only_text()->outline_width() != ref->outline_width())) {
304 throw JoinError (_("Content to be joined must have the same outline width."));
307 auto fonts = c[i]->only_text()->fonts ();
308 if (fonts.size() != ref_fonts.size()) {
309 throw JoinError (_("Content to be joined must use the same fonts."));
312 if (c[i]->only_text()->dcp_track() != ref->dcp_track()) {
313 throw JoinError (_("Content to be joined must use the same DCP track."));
316 if (c[i]->only_text()->language() != ref->language()) {
317 throw JoinError (_("Content to be joined must use the same text language."));
320 if (c[i]->only_text()->language_is_additional() != ref->language_is_additional()) {
321 throw JoinError (_("Content to be joined must both be main subtitle languages or both additional."));
324 auto j = ref_fonts.begin ();
325 auto k = fonts.begin ();
327 while (j != ref_fonts.end ()) {
329 throw JoinError (_("Content to be joined must use the same fonts."));
337 _burn = ref->burn ();
338 _x_offset = ref->x_offset ();
339 _y_offset = ref->y_offset ();
340 _x_scale = ref->x_scale ();
341 _y_scale = ref->y_scale ();
343 _line_spacing = ref->line_spacing ();
344 _fade_in = ref->fade_in ();
345 _fade_out = ref->fade_out ();
346 _outline_width = ref->outline_width ();
347 _type = ref->type ();
348 _original_type = ref->original_type ();
349 _dcp_track = ref->dcp_track ();
350 _language = ref->language ();
351 _language_is_additional = ref->language_is_additional ();
356 /** _mutex must not be held on entry */
358 TextContent::as_xml (xmlpp::Node* root) const
360 boost::mutex::scoped_lock lm (_mutex);
362 auto text = root->add_child ("Text");
364 text->add_child("Use")->add_child_text (_use ? "1" : "0");
365 text->add_child("Burn")->add_child_text (_burn ? "1" : "0");
366 text->add_child("XOffset")->add_child_text (raw_convert<string> (_x_offset));
367 text->add_child("YOffset")->add_child_text (raw_convert<string> (_y_offset));
368 text->add_child("XScale")->add_child_text (raw_convert<string> (_x_scale));
369 text->add_child("YScale")->add_child_text (raw_convert<string> (_y_scale));
371 text->add_child("Red")->add_child_text (raw_convert<string> (_colour->r));
372 text->add_child("Green")->add_child_text (raw_convert<string> (_colour->g));
373 text->add_child("Blue")->add_child_text (raw_convert<string> (_colour->b));
377 case dcp::Effect::NONE:
378 text->add_child("Effect")->add_child_text("none");
380 case dcp::Effect::BORDER:
381 text->add_child("Effect")->add_child_text("outline");
383 case dcp::Effect::SHADOW:
384 text->add_child("Effect")->add_child_text("shadow");
388 if (_effect_colour) {
389 text->add_child("EffectRed")->add_child_text (raw_convert<string> (_effect_colour->r));
390 text->add_child("EffectGreen")->add_child_text (raw_convert<string> (_effect_colour->g));
391 text->add_child("EffectBlue")->add_child_text (raw_convert<string> (_effect_colour->b));
393 text->add_child("LineSpacing")->add_child_text (raw_convert<string> (_line_spacing));
395 text->add_child("FadeIn")->add_child_text (raw_convert<string> (_fade_in->get()));
398 text->add_child("FadeOut")->add_child_text (raw_convert<string> (_fade_out->get()));
400 text->add_child("OutlineWidth")->add_child_text (raw_convert<string> (_outline_width));
402 for (auto i: _fonts) {
403 i->as_xml (text->add_child("Font"));
406 text->add_child("Type")->add_child_text (text_type_to_string(_type));
407 text->add_child("OriginalType")->add_child_text (text_type_to_string(_original_type));
409 _dcp_track->as_xml(text->add_child("DCPTrack"));
412 auto lang = text->add_child("Language");
413 lang->add_child_text (_language->to_string());
414 lang->set_attribute ("Additional", _language_is_additional ? "1" : "0");
419 TextContent::identifier () const
421 auto s = raw_convert<string> (x_scale())
422 + "_" + raw_convert<string> (y_scale())
423 + "_" + raw_convert<string> (x_offset())
424 + "_" + raw_convert<string> (y_offset())
425 + "_" + raw_convert<string> (line_spacing())
426 + "_" + raw_convert<string> (fade_in().get_value_or(ContentTime()).get())
427 + "_" + raw_convert<string> (fade_out().get_value_or(ContentTime()).get())
428 + "_" + raw_convert<string> (outline_width())
429 + "_" + raw_convert<string> (colour().get_value_or(dcp::Colour(255, 255, 255)).to_argb_string())
430 + "_" + raw_convert<string> (dcp::effect_to_string(effect().get_value_or(dcp::Effect::NONE)))
431 + "_" + raw_convert<string> (effect_colour().get_value_or(dcp::Colour(0, 0, 0)).to_argb_string())
432 + "_" + raw_convert<string> (_parent->video_frame_rate().get_value_or(0));
434 /* XXX: I suppose really _fonts shouldn't be in here, since not all
435 types of subtitle content involve fonts.
437 for (auto f: _fonts) {
438 s += "_" + f->file().get_value_or("Default").string();
441 /* The DCP track and language are for metadata only, and don't affect how this content looks */
447 TextContent::add_font (shared_ptr<Font> font)
449 boost::mutex::scoped_lock lm(_mutex);
451 DCPOMATIC_ASSERT(!get_font_unlocked(font->id()));
452 _fonts.push_back (font);
457 TextContent::connect_to_fonts ()
459 for (auto const& i: _font_connections) {
463 _font_connections.clear ();
465 for (auto i: _fonts) {
466 _font_connections.push_back (i->Changed.connect (boost::bind (&TextContent::font_changed, this)));
471 TextContent::font_changed ()
474 ContentChangeSignaller cc (_parent, TextContentProperty::FONTS);
478 TextContent::set_colour (dcp::Colour colour)
480 maybe_set (_colour, colour, TextContentProperty::COLOUR);
484 TextContent::unset_colour ()
486 maybe_set (_colour, optional<dcp::Colour>(), TextContentProperty::COLOUR);
490 TextContent::set_effect (dcp::Effect e)
492 maybe_set (_effect, e, TextContentProperty::EFFECT);
496 TextContent::unset_effect ()
498 maybe_set (_effect, optional<dcp::Effect>(), TextContentProperty::EFFECT);
502 TextContent::set_effect_colour (dcp::Colour colour)
504 maybe_set (_effect_colour, colour, TextContentProperty::EFFECT_COLOUR);
508 TextContent::unset_effect_colour ()
510 maybe_set (_effect_colour, optional<dcp::Colour>(), TextContentProperty::EFFECT_COLOUR);
514 TextContent::set_use (bool u)
516 maybe_set (_use, u, TextContentProperty::USE);
520 TextContent::set_burn (bool b)
522 maybe_set (_burn, b, TextContentProperty::BURN);
526 TextContent::set_x_offset (double o)
528 maybe_set (_x_offset, o, TextContentProperty::X_OFFSET);
532 TextContent::set_y_offset (double o)
534 maybe_set (_y_offset, o, TextContentProperty::Y_OFFSET);
538 TextContent::set_x_scale (double s)
540 maybe_set (_x_scale, s, TextContentProperty::X_SCALE);
544 TextContent::set_y_scale (double s)
546 maybe_set (_y_scale, s, TextContentProperty::Y_SCALE);
550 TextContent::set_line_spacing (double s)
552 maybe_set (_line_spacing, s, TextContentProperty::LINE_SPACING);
556 TextContent::set_fade_in (ContentTime t)
558 maybe_set (_fade_in, t, TextContentProperty::FADE_IN);
562 TextContent::unset_fade_in ()
564 maybe_set (_fade_in, optional<ContentTime>(), TextContentProperty::FADE_IN);
568 TextContent::set_fade_out (ContentTime t)
570 maybe_set (_fade_out, t, TextContentProperty::FADE_OUT);
574 TextContent::unset_fade_out ()
576 maybe_set (_fade_out, optional<ContentTime>(), TextContentProperty::FADE_OUT);
580 TextContent::set_type (TextType type)
582 maybe_set (_type, type, TextContentProperty::TYPE);
586 TextContent::set_outline_width (int w)
588 maybe_set (_outline_width, w, TextContentProperty::OUTLINE_WIDTH);
592 TextContent::set_dcp_track (DCPTextTrack t)
594 maybe_set (_dcp_track, t, TextContentProperty::DCP_TRACK);
598 TextContent::unset_dcp_track ()
600 maybe_set (_dcp_track, optional<DCPTextTrack>(), TextContentProperty::DCP_TRACK);
604 TextContent::set_language (optional<dcp::LanguageTag> language)
606 maybe_set (_language, language, TextContentProperty::LANGUAGE);
610 TextContent::set_language_is_additional (bool additional)
612 maybe_set (_language_is_additional, additional, TextContentProperty::LANGUAGE_IS_ADDITIONAL);
616 TextContent::take_settings_from (shared_ptr<const TextContent> c)
620 set_x_offset (c->_x_offset);
621 set_y_offset (c->_y_offset);
622 set_x_scale (c->_x_scale);
623 set_y_scale (c->_y_scale);
624 maybe_set (_fonts, c->_fonts, TextContentProperty::FONTS);
626 set_colour (*c->_colour);
631 set_effect (*c->_effect);
633 if (c->_effect_colour) {
634 set_effect_colour (*c->_effect_colour);
636 unset_effect_colour ();
638 set_line_spacing (c->_line_spacing);
640 set_fade_in (*c->_fade_in);
643 set_fade_out (*c->_fade_out);
645 set_outline_width (c->_outline_width);
647 set_dcp_track (c->_dcp_track.get());
651 set_language (c->_language);
652 set_language_is_additional (c->_language_is_additional);
656 shared_ptr<dcpomatic::Font>
657 TextContent::get_font(string id) const
659 boost::mutex::scoped_lock lm(_mutex);
660 return get_font_unlocked(id);
664 shared_ptr<dcpomatic::Font>
665 TextContent::get_font_unlocked(string id) const
667 auto iter = std::find_if(_fonts.begin(), _fonts.end(), [&id](shared_ptr<dcpomatic::Font> font) {
668 return font->id() == id;
671 if (iter == _fonts.end()) {
680 TextContent::clear_fonts()
682 boost::mutex::scoped_lock lm(_mutex);