third_party/decklink/mac/include/DeckLinkAPIModes.h

   1 /* -LICENSE-START-
   2 ** Copyright (c) 2014 Blackmagic Design
   3 **
   4 ** Permission is hereby granted, free of charge, to any person or organization
   5 ** obtaining a copy of the software and accompanying documentation covered by
   6 ** this license (the "Software") to use, reproduce, display, distribute,
   7 ** execute, and transmit the Software, and to prepare derivative works of the
   8 ** Software, and to permit third-parties to whom the Software is furnished to
   9 ** do so, all subject to the following:
  10 **
  11 ** The copyright notices in the Software and this entire statement, including
  12 ** the above license grant, this restriction and the following disclaimer,
  13 ** must be included in all copies of the Software, in whole or in part, and
  14 ** all derivative works of the Software, unless such copies or derivative
  15 ** works are solely in the form of machine-executable object code generated by
  16 ** a source language processor.
  17 **
  18 ** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19 ** IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20 ** FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
  21 ** SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
  22 ** FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
  23 ** ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  24 ** DEALINGS IN THE SOFTWARE.
  25 ** -LICENSE-END-
  26 */
  27
  28 #ifndef BMD_DECKLINKAPIMODES_H
  29 #define BMD_DECKLINKAPIMODES_H
  30
  31
  32 #ifndef BMD_CONST
  33     #if defined(_MSC_VER)
  34         #define BMD_CONST __declspec(selectany) static const
  35     #else
  36         #define BMD_CONST static const
  37     #endif
  38 #endif
  39
  40 // Type Declarations
  41
  42
  43 // Interface ID Declarations
  44
  45 BMD_CONST REFIID IID_IDeckLinkDisplayModeIterator                 = /* 9C88499F-F601-4021-B80B-032E4EB41C35 */ {0x9C,0x88,0x49,0x9F,0xF6,0x01,0x40,0x21,0xB8,0x0B,0x03,0x2E,0x4E,0xB4,0x1C,0x35};
  46 BMD_CONST REFIID IID_IDeckLinkDisplayMode                         = /* 3EB2C1AB-0A3D-4523-A3AD-F40D7FB14E78 */ {0x3E,0xB2,0xC1,0xAB,0x0A,0x3D,0x45,0x23,0xA3,0xAD,0xF4,0x0D,0x7F,0xB1,0x4E,0x78};
  47
  48 /* Enum BMDDisplayMode - Video display modes */
  49
  50 typedef uint32_t BMDDisplayMode;
  51 enum _BMDDisplayMode {
  52
  53     /* SD Modes */
  54
  55     bmdModeNTSC                                                  = 'ntsc',
  56     bmdModeNTSC2398                                              = 'nt23',      // 3:2 pulldown
  57     bmdModePAL                                                   = 'pal ',
  58     bmdModeNTSCp                                                 = 'ntsp',
  59     bmdModePALp                                                  = 'palp',
  60
  61     /* HD 1080 Modes */
  62
  63     bmdModeHD1080p2398                                           = '23ps',
  64     bmdModeHD1080p24                                             = '24ps',
  65     bmdModeHD1080p25                                             = 'Hp25',
  66     bmdModeHD1080p2997                                           = 'Hp29',
  67     bmdModeHD1080p30                                             = 'Hp30',
  68     bmdModeHD1080i50                                             = 'Hi50',
  69     bmdModeHD1080i5994                                           = 'Hi59',
  70     bmdModeHD1080i6000                                           = 'Hi60',      // N.B. This _really_ is 60.00 Hz.
  71     bmdModeHD1080p50                                             = 'Hp50',
  72     bmdModeHD1080p5994                                           = 'Hp59',
  73     bmdModeHD1080p6000                                           = 'Hp60',      // N.B. This _really_ is 60.00 Hz.
  74
  75     /* HD 720 Modes */
  76
  77     bmdModeHD720p50                                              = 'hp50',
  78     bmdModeHD720p5994                                            = 'hp59',
  79     bmdModeHD720p60                                              = 'hp60',
  80
  81     /* 2k Modes */
  82
  83     bmdMode2k2398                                                = '2k23',
  84     bmdMode2k24                                                  = '2k24',
  85     bmdMode2k25                                                  = '2k25',
  86
  87     /* DCI Modes (output only) */
  88
  89     bmdMode2kDCI2398                                             = '2d23',
  90     bmdMode2kDCI24                                               = '2d24',
  91     bmdMode2kDCI25                                               = '2d25',
  92
  93     /* 4k Modes */
  94
  95     bmdMode4K2160p2398                                           = '4k23',
  96     bmdMode4K2160p24                                             = '4k24',
  97     bmdMode4K2160p25                                             = '4k25',
  98     bmdMode4K2160p2997                                           = '4k29',
  99     bmdMode4K2160p30                                             = '4k30',
 100     bmdMode4K2160p50                                             = '4k50',
 101     bmdMode4K2160p5994                                           = '4k59',
 102     bmdMode4K2160p60                                             = '4k60',
 103
 104     /* DCI Modes (output only) */
 105
 106     bmdMode4kDCI2398                                             = '4d23',
 107     bmdMode4kDCI24                                               = '4d24',
 108     bmdMode4kDCI25                                               = '4d25',
 109
 110     /* Special Modes */
 111
 112     bmdModeUnknown                                               = 'iunk'
 113 };
 114
 115 /* Enum BMDFieldDominance - Video field dominance */
 116
 117 typedef uint32_t BMDFieldDominance;
 118 enum _BMDFieldDominance {
 119     bmdUnknownFieldDominance                                     = 0,
 120     bmdLowerFieldFirst                                           = 'lowr',
 121     bmdUpperFieldFirst                                           = 'uppr',
 122     bmdProgressiveFrame                                          = 'prog',
 123     bmdProgressiveSegmentedFrame                                 = 'psf '
 124 };
 125
 126 /* Enum BMDPixelFormat - Video pixel formats supported for output/input */
 127
 128 typedef uint32_t BMDPixelFormat;
 129 enum _BMDPixelFormat {
 130     bmdFormat8BitYUV                                             = '2vuy',
 131     bmdFormat10BitYUV                                            = 'v210',
 132     bmdFormat8BitARGB                                            = 32,
 133     bmdFormat8BitBGRA                                            = 'BGRA',
 134     bmdFormat10BitRGB                                            = 'r210',      // Big-endian RGB 10-bit per component with SMPTE video levels (64-960). Packed as 2:10:10:10
 135     bmdFormat12BitRGB                                            = 'R12B',      // Big-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
 136     bmdFormat12BitRGBLE                                          = 'R12L',      // Little-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
 137     bmdFormat10BitRGBXLE                                         = 'R10l',      // Little-endian 10-bit RGB with SMPTE video levels (64-940)
 138     bmdFormat10BitRGBX                                           = 'R10b'       // Big-endian 10-bit RGB with SMPTE video levels (64-940)
 139 };
 140
 141 /* Enum BMDDisplayModeFlags - Flags to describe the characteristics of an IDeckLinkDisplayMode. */
 142
 143 typedef uint32_t BMDDisplayModeFlags;
 144 enum _BMDDisplayModeFlags {
 145     bmdDisplayModeSupports3D                                     = 1 << 0,
 146     bmdDisplayModeColorspaceRec601                               = 1 << 1,
 147     bmdDisplayModeColorspaceRec709                               = 1 << 2
 148 };
 149
 150 // Forward Declarations
 151
 152 class IDeckLinkDisplayModeIterator;
 153 class IDeckLinkDisplayMode;
 154
 155 /* Interface IDeckLinkDisplayModeIterator - enumerates over supported input/output display modes. */
 156
 157 class IDeckLinkDisplayModeIterator : public IUnknown
 158 {
 159 public:
 160     virtual HRESULT Next (/* out */ IDeckLinkDisplayMode **deckLinkDisplayMode) = 0;
 161
 162 protected:
 163     virtual ~IDeckLinkDisplayModeIterator () {} // call Release method to drop reference count
 164 };
 165
 166 /* Interface IDeckLinkDisplayMode - represents a display mode */
 167
 168 class IDeckLinkDisplayMode : public IUnknown
 169 {
 170 public:
 171     virtual HRESULT GetName (/* out */ CFStringRef *name) = 0;
 172     virtual BMDDisplayMode GetDisplayMode (void) = 0;
 173     virtual long GetWidth (void) = 0;
 174     virtual long GetHeight (void) = 0;
 175     virtual HRESULT GetFrameRate (/* out */ BMDTimeValue *frameDuration, /* out */ BMDTimeScale *timeScale) = 0;
 176     virtual BMDFieldDominance GetFieldDominance (void) = 0;
 177     virtual BMDDisplayModeFlags GetFlags (void) = 0;
 178
 179 protected:
 180     virtual ~IDeckLinkDisplayMode () {} // call Release method to drop reference count
 181 };
 182
 183 /* Functions */
 184
 185 extern "C" {
 186
 187
 188 }
 189
 190
 191 #endif /* defined(BMD_DECKLINKAPIMODES_H) */