src/types.h

   1 /*
   2     Copyright (C) 2012-2014 Carl Hetherington <cth@carlh.net>
   3
   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.
   8
   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.
  13
  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.
  17
  18 */
  19
  20 /** @file  src/types.h
  21  *  @brief Miscellaneous types.
  22  */
  23
  24 #ifndef LIBDCP_TYPES_H
  25 #define LIBDCP_TYPES_H
  26
  27 #include <boost/shared_ptr.hpp>
  28 #include <string>
  29
  30 namespace dcp
  31 {
  32
  33 namespace parse {
  34         class AssetMap;
  35 }
  36
  37 /** Identifier for a sound channel */
  38 enum Channel {
  39         LEFT = 0,      ///< left
  40         RIGHT = 1,     ///< right
  41         CENTRE = 2,    ///< centre
  42         LFE = 3,       ///< low-frequency effects (sub)
  43         LS = 4,        ///< left surround
  44         RS = 5,        ///< right surround
  45         CHANNEL_7 = 6, ///< channel 7; not sure what this should be called
  46         CHANNEL_8 = 7  ///< channel 8; not sure what this should be called
  47 };
  48
  49 enum ContentKind
  50 {
  51         FEATURE,
  52         SHORT,
  53         TRAILER,
  54         TEST,
  55         TRANSITIONAL,
  56         RATING,
  57         TEASER,
  58         POLICY,
  59         PUBLIC_SERVICE_ANNOUNCEMENT,
  60         ADVERTISEMENT
  61 };
  62
  63 enum Effect
  64 {
  65         NONE,
  66         BORDER,
  67         SHADOW
  68 };
  69
  70 extern std::string effect_to_string (Effect e);
  71 extern Effect string_to_effect (std::string s);
  72
  73 enum VAlign
  74 {
  75         TOP,
  76         CENTER,
  77         BOTTOM
  78 };
  79
  80 extern std::string valign_to_string (VAlign a);
  81 extern VAlign string_to_valign (std::string s);
  82
  83 enum Eye
  84 {
  85         EYE_LEFT,
  86         EYE_RIGHT
  87 };
  88
  89 /** @class Fraction
  90  *  @brief A fraction (i.e. a thing with an integer numerator and an integer denominator).
  91  */
  92 class Fraction
  93 {
  94 public:
  95         /** Construct a fraction of 0/0 */
  96         Fraction () : numerator (0), denominator (0) {}
  97         Fraction (std::string s);
  98         /** Construct a fraction with a specified numerator and denominator.
  99          *  @param n Numerator.
 100          *  @param d Denominator.
 101          */
 102         Fraction (int n, int d) : numerator (n), denominator (d) {}
 103
 104         int numerator;
 105         int denominator;
 106 };
 107
 108 extern bool operator== (Fraction const & a, Fraction const & b);
 109 extern bool operator!= (Fraction const & a, Fraction const & b);
 110
 111 /** @struct EqualityOptions
 112  *  @brief  A class to describe what "equality" means for a particular test.
 113  *
 114  *  When comparing things, we want to be able to ignore some differences;
 115  *  this class expresses those differences.
 116  */
 117 struct EqualityOptions
 118 {
 119         /** Construct an EqualityOptions where nothing at all can differ */
 120         EqualityOptions ()
 121                 : max_mean_pixel_error (0)
 122                 , max_std_dev_pixel_error (0)
 123                 , max_audio_sample_error (0)
 124                 , cpl_annotation_texts_can_differ (false)
 125                 , mxf_names_can_differ (false)
 126         {}
 127
 128         /** The maximum allowable mean difference in pixel value between two images */
 129         double max_mean_pixel_error;
 130         /** The maximum standard deviation of the differences in pixel value between two images */
 131         double max_std_dev_pixel_error;
 132         /** The maximum difference in audio sample value between two soundtracks */
 133         int max_audio_sample_error;
 134         /** true if the <AnnotationText> nodes of CPLs are allowed to differ */
 135         bool cpl_annotation_texts_can_differ;
 136         /** true if MXF filenames are allowed to differ */
 137         bool mxf_names_can_differ;
 138 };
 139
 140 /* Win32 defines this */
 141 #undef ERROR
 142
 143 enum NoteType {
 144         PROGRESS,
 145         ERROR,
 146         NOTE
 147 };
 148
 149 enum Standard {
 150         INTEROP,
 151         SMPTE
 152 };
 153
 154 /** @class Color
 155  *  @brief An RGB color (aka colour).
 156  */
 157 class Color
 158 {
 159 public:
 160         Color ();
 161         Color (int r_, int g_, int b_);
 162         Color (std::string argb_hex);
 163
 164         int r; ///< red component, from 0 to 255
 165         int g; ///< green component, from 0 to 255
 166         int b; ///< blue component, from 0 to 255
 167
 168         std::string to_argb_string () const;
 169 };
 170
 171 extern bool operator== (Color const & a, Color const & b);
 172 extern bool operator!= (Color const & a, Color const & b);
 173 extern std::ostream & operator<< (std::ostream & s, Color const & c);
 174
 175 typedef std::pair<std::string, boost::shared_ptr<const parse::AssetMap> > PathAssetMap;
 176
 177 }
 178
 179 #endif