2 Copyright (C) 2012-2015 Carl Hetherington <cth@carlh.net>
4 This file is part of libdcp.
6 libdcp 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 libdcp 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 libdcp. If not, see <http://www.gnu.org/licenses/>.
19 In addition, as a special exception, the copyright holders give
20 permission to link the code of portions of this program with the
21 OpenSSL library under certain conditions as described in each
22 individual source file, and distribute linked combinations
25 You must obey the GNU General Public License in all respects
26 for all of the code used other than OpenSSL. If you modify
27 file(s) with this exception, you may extend this exception to your
28 version of the file(s), but you are not obligated to do so. If you
29 do not wish to do so, delete this exception statement from your
30 version. If you delete this exception statement from all source
31 files in the program, then also delete it here.
35 * @brief Miscellaneous types.
38 #ifndef LIBDCP_TYPES_H
39 #define LIBDCP_TYPES_H
41 #include <boost/shared_ptr.hpp>
42 #include <boost/function.hpp>
49 * @brief The integer, two-dimensional size of something.
63 float ratio () const {
64 return float (width) / height;
71 extern bool operator== (Size const & a, Size const & b);
72 extern bool operator!= (Size const & a, Size const & b);
73 extern std::ostream& operator<< (std::ostream& s, Size const & a);
75 /** Identifier for a sound channel */
79 CENTRE = 2, ///< centre
80 LFE = 3, ///< low-frequency effects (sub)
81 LS = 4, ///< left surround
82 RS = 5, ///< right surround
101 PUBLIC_SERVICE_ANNOUNCEMENT,
105 extern std::string content_kind_to_string (ContentKind kind);
106 extern ContentKind content_kind_from_string (std::string kind);
115 extern std::string effect_to_string (Effect e);
116 extern Effect string_to_effect (std::string s);
120 HALIGN_LEFT, ///< horizontal position is distance from left of screen to left of subtitle
121 HALIGN_CENTER, ///< horizontal position is distance from centre of screen to centre of subtitle
122 HALIGN_RIGHT, ///< horizontal position is distance from right of screen to right of subtitle
125 extern std::string halign_to_string (HAlign a);
126 extern HAlign string_to_halign (std::string s);
130 VALIGN_TOP, ///< vertical position is distance from top of screen to top of subtitle
131 VALIGN_CENTER, ///< vertical position is distance from centre of screen to centre of subtitle
132 VALIGN_BOTTOM ///< vertical position is distance from bottom of screen to bottom of subtitle
135 extern std::string valign_to_string (VAlign a);
136 extern VAlign string_to_valign (std::string s);
138 /** Direction for subtitle test */
141 DIRECTION_LTR, ///< left-to-right
142 DIRECTION_RTL, ///< right-to-left
143 DIRECTION_TTB, ///< top-to-bottom
144 DIRECTION_BTT ///< bottom-to-top
147 extern std::string direction_to_string (Direction a);
148 extern Direction string_to_direction (std::string s);
157 * @brief A fraction (i.e. a thing with an integer numerator and an integer denominator).
162 /** Construct a fraction of 0/0 */
163 Fraction () : numerator (0), denominator (0) {}
164 explicit Fraction (std::string s);
165 /** Construct a fraction with a specified numerator and denominator.
166 * @param n Numerator.
167 * @param d Denominator.
169 Fraction (int n, int d) : numerator (n), denominator (d) {}
171 float as_float () const {
172 return float (numerator) / denominator;
175 std::string as_string () const;
181 extern bool operator== (Fraction const & a, Fraction const & b);
182 extern bool operator!= (Fraction const & a, Fraction const & b);
183 extern std::ostream& operator<< (std::ostream& s, Fraction const & f);
185 /** @struct EqualityOptions
186 * @brief A class to describe what "equality" means for a particular test.
188 * When comparing things, we want to be able to ignore some differences;
189 * this class expresses those differences.
191 struct EqualityOptions
193 /** Construct an EqualityOptions where nothing at all can differ */
195 : max_mean_pixel_error (0)
196 , max_std_dev_pixel_error (0)
197 , max_audio_sample_error (0)
198 , cpl_annotation_texts_can_differ (false)
199 , reel_annotation_texts_can_differ (false)
200 , reel_hashes_can_differ (false)
201 , issue_dates_can_differ (false)
205 /** The maximum allowable mean difference in pixel value between two images */
206 double max_mean_pixel_error;
207 /** The maximum standard deviation of the differences in pixel value between two images */
208 double max_std_dev_pixel_error;
209 /** The maximum difference in audio sample value between two soundtracks */
210 int max_audio_sample_error;
211 /** true if the <AnnotationText> nodes of CPLs are allowed to differ */
212 bool cpl_annotation_texts_can_differ;
213 /** true if the <AnnotationText> nodes of Reels are allowed to differ */
214 bool reel_annotation_texts_can_differ;
215 /** true if <Hash>es in Reels can differ */
216 bool reel_hashes_can_differ;
217 /** true if IssueDate nodes can differ */
218 bool issue_dates_can_differ;
222 /* I've been unable to make mingw happy with ERROR as a symbol, so
223 I'm using a DCP_ prefix here.
237 MODIFIED_TRANSITIONAL_1,
238 MULTIPLE_MODIFIED_TRANSITIONAL_1,
241 /** For testing: adds no AuthorizedDeviceInfo tag */
242 MODIFIED_TRANSITIONAL_TEST
246 * @brief An RGB colour.
252 Colour (int r_, int g_, int b_);
253 explicit Colour (std::string argb_hex);
255 int r; ///< red component, from 0 to 255
256 int g; ///< green component, from 0 to 255
257 int b; ///< blue component, from 0 to 255
259 std::string to_rgb_string () const;
260 std::string to_argb_string () const;
263 extern bool operator== (Colour const & a, Colour const & b);
264 extern bool operator!= (Colour const & a, Colour const & b);
265 extern std::ostream & operator<< (std::ostream & s, Colour const & c);
267 typedef boost::function<void (NoteType, std::string)> NoteHandler;
269 /** Maximum absolute difference between dcp::SubtitleString::aspect_adjust values that
270 * are considered equal.
272 const float ASPECT_ADJUST_EPSILON = 1e-3;
274 /** Maximum absolute difference between dcp::SubtitleString alignment values that
275 * are considered equal.
277 const float ALIGN_EPSILON = 1e-3;