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.
21 * @brief Miscellaneous types.
24 #ifndef LIBDCP_TYPES_H
25 #define LIBDCP_TYPES_H
27 #include <boost/shared_ptr.hpp>
28 #include <boost/function.hpp>
35 * @brief The integer, two-dimensional size of something.
49 float ratio () const {
50 return float (width) / height;
57 /** Identifier for a sound channel */
61 CENTRE = 2, ///< centre
62 LFE = 3, ///< low-frequency effects (sub)
63 LS = 4, ///< left surround
64 RS = 5, ///< right surround
83 PUBLIC_SERVICE_ANNOUNCEMENT,
94 extern std::string effect_to_string (Effect e);
95 extern Effect string_to_effect (std::string s);
99 HALIGN_LEFT, ///< horizontal position is distance from left of screen to left of subtitle
100 HALIGN_CENTER, ///< horizontal position is distance from centre of screen to centre of subtitle
101 HALIGN_RIGHT, ///< horizontal position is distance from right of screen to right of subtitle
104 extern std::string halign_to_string (HAlign a);
105 extern HAlign string_to_halign (std::string s);
109 VALIGN_TOP, ///< vertical position is distance from top of screen to top of subtitle
110 VALIGN_CENTER, ///< vertical position is distance from centre of screen to centre of subtitle
111 VALIGN_BOTTOM ///< vertical position is distance from bottom of screen to bottom of subtitle
114 extern std::string valign_to_string (VAlign a);
115 extern VAlign string_to_valign (std::string s);
124 * @brief A fraction (i.e. a thing with an integer numerator and an integer denominator).
129 /** Construct a fraction of 0/0 */
130 Fraction () : numerator (0), denominator (0) {}
131 Fraction (std::string s);
132 /** Construct a fraction with a specified numerator and denominator.
133 * @param n Numerator.
134 * @param d Denominator.
136 Fraction (int n, int d) : numerator (n), denominator (d) {}
138 float as_float () const {
139 return float (numerator) / denominator;
142 std::string as_string () const;
148 extern bool operator== (Fraction const & a, Fraction const & b);
149 extern bool operator!= (Fraction const & a, Fraction const & b);
150 extern std::ostream& operator<< (std::ostream& s, Fraction const & f);
152 /** @struct EqualityOptions
153 * @brief A class to describe what "equality" means for a particular test.
155 * When comparing things, we want to be able to ignore some differences;
156 * this class expresses those differences.
158 struct EqualityOptions
160 /** Construct an EqualityOptions where nothing at all can differ */
162 : max_mean_pixel_error (0)
163 , max_std_dev_pixel_error (0)
164 , max_audio_sample_error (0)
165 , cpl_annotation_texts_can_differ (false)
166 , reel_annotation_texts_can_differ (false)
167 , reel_hashes_can_differ (false)
170 /** The maximum allowable mean difference in pixel value between two images */
171 double max_mean_pixel_error;
172 /** The maximum standard deviation of the differences in pixel value between two images */
173 double max_std_dev_pixel_error;
174 /** The maximum difference in audio sample value between two soundtracks */
175 int max_audio_sample_error;
176 /** true if the <AnnotationText> nodes of CPLs are allowed to differ */
177 bool cpl_annotation_texts_can_differ;
178 /** true if the <AnnotationText> nodes of Reels are allowed to differ */
179 bool reel_annotation_texts_can_differ;
180 /** true if <Hash>es in Reels can differ */
181 bool reel_hashes_can_differ;
184 /* I've been unable to make mingw happy with ERROR as a symbol, so
185 I'm using a DCP_ prefix here.
199 MODIFIED_TRANSITIONAL_1,
205 * @brief An RGB colour.
211 Colour (int r_, int g_, int b_);
212 Colour (std::string argb_hex);
214 int r; ///< red component, from 0 to 255
215 int g; ///< green component, from 0 to 255
216 int b; ///< blue component, from 0 to 255
218 std::string to_argb_string () const;
221 extern bool operator== (Colour const & a, Colour const & b);
222 extern bool operator!= (Colour const & a, Colour const & b);
223 extern std::ostream & operator<< (std::ostream & s, Colour const & c);
225 typedef boost::function<void (NoteType, std::string)> NoteHandler;
227 /** Maximum absolute difference between dcp::SubtitleString::aspect_adjust values that
228 * are considered equal.
230 const float ASPECT_ADJUST_EPSILON = 1e-3;
232 /** Maximum absolute difference between dcp::SubtitleString alignment values that
233 * are considered equal.
235 const float ALIGN_EPSILON = 1e-3;