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         EqualityOptions ()
 113                 : max_mean_pixel_error (0)
 114                 , max_std_dev_pixel_error (0)
 115                 , max_audio_sample_error (0)
 116                 , cpl_annotation_texts_can_differ (false)
 117                 , mxf_names_can_differ (false)
 118         {}
 119
 120         double max_mean_pixel_error;
 121         double max_std_dev_pixel_error;
 122         int max_audio_sample_error;
 123         bool cpl_annotation_texts_can_differ;
 124         bool mxf_names_can_differ;
 125 };
 126
 127 /* Win32 defines this */
 128 #undef ERROR
 129
 130 enum NoteType {
 131         PROGRESS,
 132         ERROR,
 133         NOTE
 134 };
 135
 136 enum Standard {
 137         INTEROP,
 138         SMPTE
 139 };
 140
 141 /** @class Color
 142  *  @brief An RGB color (aka colour).
 143  */
 144 class Color
 145 {
 146 public:
 147         Color ();
 148         Color (int r_, int g_, int b_);
 149         Color (std::string argb_hex);
 150
 151         int r; ///< red component, from 0 to 255
 152         int g; ///< green component, from 0 to 255
 153         int b; ///< blue component, from 0 to 255
 154
 155         std::string to_argb_string () const;
 156 };
 157
 158 extern bool operator== (Color const & a, Color const & b);
 159 extern bool operator!= (Color const & a, Color const & b);
 160 extern std::ostream & operator<< (std::ostream & s, Color const & c);
 161
 162 typedef std::pair<std::string, boost::shared_ptr<const parse::AssetMap> > PathAssetMap;
 163
 164 }
 165
 166 #endif