1 /* -LICENSE-START- 2 ** Copyright (c) 2016 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' */ 0x6E747363, 56 bmdModeNTSC2398 = /* 'nt23' */ 0x6E743233, // 3:2 pulldown 57 bmdModePAL = /* 'pal ' */ 0x70616C20, 58 bmdModeNTSCp = /* 'ntsp' */ 0x6E747370, 59 bmdModePALp = /* 'palp' */ 0x70616C70, 60 61 /* HD 1080 Modes */ 62 63 bmdModeHD1080p2398 = /* '23ps' */ 0x32337073, 64 bmdModeHD1080p24 = /* '24ps' */ 0x32347073, 65 bmdModeHD1080p25 = /* 'Hp25' */ 0x48703235, 66 bmdModeHD1080p2997 = /* 'Hp29' */ 0x48703239, 67 bmdModeHD1080p30 = /* 'Hp30' */ 0x48703330, 68 bmdModeHD1080i50 = /* 'Hi50' */ 0x48693530, 69 bmdModeHD1080i5994 = /* 'Hi59' */ 0x48693539, 70 bmdModeHD1080i6000 = /* 'Hi60' */ 0x48693630, // N.B. This _really_ is 60.00 Hz. 71 bmdModeHD1080p50 = /* 'Hp50' */ 0x48703530, 72 bmdModeHD1080p5994 = /* 'Hp59' */ 0x48703539, 73 bmdModeHD1080p6000 = /* 'Hp60' */ 0x48703630, // N.B. This _really_ is 60.00 Hz. 74 75 /* HD 720 Modes */ 76 77 bmdModeHD720p50 = /* 'hp50' */ 0x68703530, 78 bmdModeHD720p5994 = /* 'hp59' */ 0x68703539, 79 bmdModeHD720p60 = /* 'hp60' */ 0x68703630, 80 81 /* 2k Modes */ 82 83 bmdMode2k2398 = /* '2k23' */ 0x326B3233, 84 bmdMode2k24 = /* '2k24' */ 0x326B3234, 85 bmdMode2k25 = /* '2k25' */ 0x326B3235, 86 87 /* DCI Modes (output only) */ 88 89 bmdMode2kDCI2398 = /* '2d23' */ 0x32643233, 90 bmdMode2kDCI24 = /* '2d24' */ 0x32643234, 91 bmdMode2kDCI25 = /* '2d25' */ 0x32643235, 92 93 /* 4k Modes */ 94 95 bmdMode4K2160p2398 = /* '4k23' */ 0x346B3233, 96 bmdMode4K2160p24 = /* '4k24' */ 0x346B3234, 97 bmdMode4K2160p25 = /* '4k25' */ 0x346B3235, 98 bmdMode4K2160p2997 = /* '4k29' */ 0x346B3239, 99 bmdMode4K2160p30 = /* '4k30' */ 0x346B3330, 100 bmdMode4K2160p50 = /* '4k50' */ 0x346B3530, 101 bmdMode4K2160p5994 = /* '4k59' */ 0x346B3539, 102 bmdMode4K2160p60 = /* '4k60' */ 0x346B3630, 103 104 /* DCI Modes (output only) */ 105 106 bmdMode4kDCI2398 = /* '4d23' */ 0x34643233, 107 bmdMode4kDCI24 = /* '4d24' */ 0x34643234, 108 bmdMode4kDCI25 = /* '4d25' */ 0x34643235, 109 110 /* Special Modes */ 111 112 bmdModeUnknown = /* 'iunk' */ 0x69756E6B 113 }; 114 115 /* Enum BMDFieldDominance - Video field dominance */ 116 117 typedef uint32_t BMDFieldDominance; 118 enum _BMDFieldDominance { 119 bmdUnknownFieldDominance = 0, 120 bmdLowerFieldFirst = /* 'lowr' */ 0x6C6F7772, 121 bmdUpperFieldFirst = /* 'uppr' */ 0x75707072, 122 bmdProgressiveFrame = /* 'prog' */ 0x70726F67, 123 bmdProgressiveSegmentedFrame = /* 'psf ' */ 0x70736620 124 }; 125 126 /* Enum BMDPixelFormat - Video pixel formats supported for output/input */ 127 128 typedef uint32_t BMDPixelFormat; 129 enum _BMDPixelFormat { 130 bmdFormat8BitYUV = /* '2vuy' */ 0x32767579, 131 bmdFormat10BitYUV = /* 'v210' */ 0x76323130, 132 bmdFormat8BitARGB = 32, 133 bmdFormat8BitBGRA = /* 'BGRA' */ 0x42475241, 134 bmdFormat10BitRGB = /* 'r210' */ 0x72323130, // Big-endian RGB 10-bit per component with SMPTE video levels (64-960). Packed as 2:10:10:10 135 bmdFormat12BitRGB = /* 'R12B' */ 0x52313242, // Big-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component 136 bmdFormat12BitRGBLE = /* 'R12L' */ 0x5231324C, // Little-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component 137 bmdFormat10BitRGBXLE = /* 'R10l' */ 0x5231306C, // Little-endian 10-bit RGB with SMPTE video levels (64-940) 138 bmdFormat10BitRGBX = /* 'R10b' */ 0x52313062, // Big-endian 10-bit RGB with SMPTE video levels (64-940) 139 bmdFormatH265 = /* 'hev1' */ 0x68657631, // High Efficiency Video Coding (HEVC/h.265) 140 141 /* AVID DNxHR */ 142 143 bmdFormatDNxHR = /* 'AVdh' */ 0x41566468 144 }; 145 146 /* Enum BMDDisplayModeFlags - Flags to describe the characteristics of an IDeckLinkDisplayMode. */ 147 148 typedef uint32_t BMDDisplayModeFlags; 149 enum _BMDDisplayModeFlags { 150 bmdDisplayModeSupports3D = 1 << 0, 151 bmdDisplayModeColorspaceRec601 = 1 << 1, 152 bmdDisplayModeColorspaceRec709 = 1 << 2 153 }; 154 155 // Forward Declarations 156 157 class IDeckLinkDisplayModeIterator; 158 class IDeckLinkDisplayMode; 159 160 /* Interface IDeckLinkDisplayModeIterator - enumerates over supported input/output display modes. */ 161 162 class IDeckLinkDisplayModeIterator : public IUnknown 163 { 164 public: 165 virtual HRESULT Next (/* out */ IDeckLinkDisplayMode **deckLinkDisplayMode) = 0; 166 167 protected: ~IDeckLinkDisplayModeIterator()168 virtual ~IDeckLinkDisplayModeIterator () {} // call Release method to drop reference count 169 }; 170 171 /* Interface IDeckLinkDisplayMode - represents a display mode */ 172 173 class IDeckLinkDisplayMode : public IUnknown 174 { 175 public: 176 virtual HRESULT GetName (/* out */ const char **name) = 0; 177 virtual BMDDisplayMode GetDisplayMode (void) = 0; 178 virtual long GetWidth (void) = 0; 179 virtual long GetHeight (void) = 0; 180 virtual HRESULT GetFrameRate (/* out */ BMDTimeValue *frameDuration, /* out */ BMDTimeScale *timeScale) = 0; 181 virtual BMDFieldDominance GetFieldDominance (void) = 0; 182 virtual BMDDisplayModeFlags GetFlags (void) = 0; 183 184 protected: ~IDeckLinkDisplayMode()185 virtual ~IDeckLinkDisplayMode () {} // call Release method to drop reference count 186 }; 187 188 /* Functions */ 189 190 extern "C" { 191 192 193 } 194 195 196 #endif /* defined(BMD_DECKLINKAPIMODES_H) */ 197