243 lines
11 KiB
C++
243 lines
11 KiB
C++
/* -LICENSE-START-
|
|
** Copyright (c) 2018 Blackmagic Design
|
|
**
|
|
** Permission is hereby granted, free of charge, to any person or organization
|
|
** obtaining a copy of the software and accompanying documentation covered by
|
|
** this license (the "Software") to use, reproduce, display, distribute,
|
|
** execute, and transmit the Software, and to prepare derivative works of the
|
|
** Software, and to permit third-parties to whom the Software is furnished to
|
|
** do so, all subject to the following:
|
|
**
|
|
** The copyright notices in the Software and this entire statement, including
|
|
** the above license grant, this restriction and the following disclaimer,
|
|
** must be included in all copies of the Software, in whole or in part, and
|
|
** all derivative works of the Software, unless such copies or derivative
|
|
** works are solely in the form of machine-executable object code generated by
|
|
** a source language processor.
|
|
**
|
|
** THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
** IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
** FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT
|
|
** SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE
|
|
** FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE,
|
|
** ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
|
|
** DEALINGS IN THE SOFTWARE.
|
|
** -LICENSE-END-
|
|
*/
|
|
|
|
#ifndef BMD_DECKLINKAPIMODES_H
|
|
#define BMD_DECKLINKAPIMODES_H
|
|
|
|
|
|
#ifndef BMD_CONST
|
|
#if defined(_MSC_VER)
|
|
#define BMD_CONST __declspec(selectany) static const
|
|
#else
|
|
#define BMD_CONST static const
|
|
#endif
|
|
#endif
|
|
|
|
#ifndef BMD_PUBLIC
|
|
#define BMD_PUBLIC
|
|
#endif
|
|
|
|
// Type Declarations
|
|
|
|
|
|
// Interface ID Declarations
|
|
|
|
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};
|
|
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};
|
|
|
|
/* Enum BMDDisplayMode - Video display modes */
|
|
|
|
typedef uint32_t BMDDisplayMode;
|
|
enum _BMDDisplayMode {
|
|
|
|
/* SD Modes */
|
|
|
|
bmdModeNTSC = 'ntsc',
|
|
bmdModeNTSC2398 = 'nt23', // 3:2 pulldown
|
|
bmdModePAL = 'pal ',
|
|
bmdModeNTSCp = 'ntsp',
|
|
bmdModePALp = 'palp',
|
|
|
|
/* HD 1080 Modes */
|
|
|
|
bmdModeHD1080p2398 = '23ps',
|
|
bmdModeHD1080p24 = '24ps',
|
|
bmdModeHD1080p25 = 'Hp25',
|
|
bmdModeHD1080p2997 = 'Hp29',
|
|
bmdModeHD1080p30 = 'Hp30',
|
|
bmdModeHD1080p50 = 'Hp50',
|
|
bmdModeHD1080p5994 = 'Hp59',
|
|
bmdModeHD1080p6000 = 'Hp60', // N.B. This _really_ is 60.00 Hz.
|
|
bmdModeHD1080i50 = 'Hi50',
|
|
bmdModeHD1080i5994 = 'Hi59',
|
|
bmdModeHD1080i6000 = 'Hi60', // N.B. This _really_ is 60.00 Hz.
|
|
|
|
/* HD 720 Modes */
|
|
|
|
bmdModeHD720p50 = 'hp50',
|
|
bmdModeHD720p5994 = 'hp59',
|
|
bmdModeHD720p60 = 'hp60',
|
|
|
|
/* 2K Modes */
|
|
|
|
bmdMode2k2398 = '2k23',
|
|
bmdMode2k24 = '2k24',
|
|
bmdMode2k25 = '2k25',
|
|
|
|
/* 2K DCI Modes */
|
|
|
|
bmdMode2kDCI2398 = '2d23',
|
|
bmdMode2kDCI24 = '2d24',
|
|
bmdMode2kDCI25 = '2d25',
|
|
bmdMode2kDCI2997 = '2d29',
|
|
bmdMode2kDCI30 = '2d30',
|
|
bmdMode2kDCI50 = '2d50',
|
|
bmdMode2kDCI5994 = '2d59',
|
|
bmdMode2kDCI60 = '2d60',
|
|
|
|
/* 4K UHD Modes */
|
|
|
|
bmdMode4K2160p2398 = '4k23',
|
|
bmdMode4K2160p24 = '4k24',
|
|
bmdMode4K2160p25 = '4k25',
|
|
bmdMode4K2160p2997 = '4k29',
|
|
bmdMode4K2160p30 = '4k30',
|
|
bmdMode4K2160p50 = '4k50',
|
|
bmdMode4K2160p5994 = '4k59',
|
|
bmdMode4K2160p60 = '4k60',
|
|
|
|
/* 4K DCI Modes */
|
|
|
|
bmdMode4kDCI2398 = '4d23',
|
|
bmdMode4kDCI24 = '4d24',
|
|
bmdMode4kDCI25 = '4d25',
|
|
bmdMode4kDCI2997 = '4d29',
|
|
bmdMode4kDCI30 = '4d30',
|
|
bmdMode4kDCI50 = '4d50',
|
|
bmdMode4kDCI5994 = '4d59',
|
|
bmdMode4kDCI60 = '4d60',
|
|
|
|
/* 8K UHD Modes */
|
|
|
|
bmdMode8K4320p2398 = '8k23',
|
|
bmdMode8K4320p24 = '8k24',
|
|
bmdMode8K4320p25 = '8k25',
|
|
bmdMode8K4320p2997 = '8k29',
|
|
bmdMode8K4320p30 = '8k30',
|
|
bmdMode8K4320p50 = '8k50',
|
|
bmdMode8K4320p5994 = '8k59',
|
|
bmdMode8K4320p60 = '8k60',
|
|
|
|
/* 8K DCI Modes */
|
|
|
|
bmdMode8kDCI2398 = '8d23',
|
|
bmdMode8kDCI24 = '8d24',
|
|
bmdMode8kDCI25 = '8d25',
|
|
bmdMode8kDCI2997 = '8d29',
|
|
bmdMode8kDCI30 = '8d30',
|
|
bmdMode8kDCI50 = '8d50',
|
|
bmdMode8kDCI5994 = '8d59',
|
|
bmdMode8kDCI60 = '8d60',
|
|
|
|
/* RAW Modes for Cintel (input only) */
|
|
|
|
bmdModeCintelRAW = 'rwci', // Frame size up to 4096x3072, variable frame rate
|
|
bmdModeCintelCompressedRAW = 'rwcc', // Frame size up to 4096x3072, variable frame rate
|
|
|
|
/* Special Modes */
|
|
|
|
bmdModeUnknown = 'iunk'
|
|
};
|
|
|
|
/* Enum BMDFieldDominance - Video field dominance */
|
|
|
|
typedef uint32_t BMDFieldDominance;
|
|
enum _BMDFieldDominance {
|
|
bmdUnknownFieldDominance = 0,
|
|
bmdLowerFieldFirst = 'lowr',
|
|
bmdUpperFieldFirst = 'uppr',
|
|
bmdProgressiveFrame = 'prog',
|
|
bmdProgressiveSegmentedFrame = 'psf '
|
|
};
|
|
|
|
/* Enum BMDPixelFormat - Video pixel formats supported for output/input */
|
|
|
|
typedef uint32_t BMDPixelFormat;
|
|
enum _BMDPixelFormat {
|
|
bmdFormat8BitYUV = '2vuy',
|
|
bmdFormat10BitYUV = 'v210',
|
|
bmdFormat8BitARGB = 32,
|
|
bmdFormat8BitBGRA = 'BGRA',
|
|
bmdFormat10BitRGB = 'r210', // Big-endian RGB 10-bit per component with SMPTE video levels (64-960). Packed as 2:10:10:10
|
|
bmdFormat12BitRGB = 'R12B', // Big-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
|
|
bmdFormat12BitRGBLE = 'R12L', // Little-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
|
|
bmdFormat10BitRGBXLE = 'R10l', // Little-endian 10-bit RGB with SMPTE video levels (64-940)
|
|
bmdFormat10BitRGBX = 'R10b', // Big-endian 10-bit RGB with SMPTE video levels (64-940)
|
|
bmdFormatH265 = 'hev1', // High Efficiency Video Coding (HEVC/h.265)
|
|
|
|
/* AVID DNxHR */
|
|
|
|
bmdFormatDNxHR = 'AVdh',
|
|
|
|
/* Cintel formats */
|
|
|
|
bmdFormat12BitRAWGRBG = 'r12p', // 12-bit RAW data for bayer pattern GRBG
|
|
bmdFormat12BitRAWJPEG = 'r16p' // 12-bit RAW data arranged in tiles and JPEG compressed
|
|
};
|
|
|
|
/* Enum BMDDisplayModeFlags - Flags to describe the characteristics of an IDeckLinkDisplayMode. */
|
|
|
|
typedef uint32_t BMDDisplayModeFlags;
|
|
enum _BMDDisplayModeFlags {
|
|
bmdDisplayModeSupports3D = 1 << 0,
|
|
bmdDisplayModeColorspaceRec601 = 1 << 1,
|
|
bmdDisplayModeColorspaceRec709 = 1 << 2,
|
|
bmdDisplayModeColorspaceRec2020 = 1 << 3
|
|
};
|
|
|
|
// Forward Declarations
|
|
|
|
class IDeckLinkDisplayModeIterator;
|
|
class IDeckLinkDisplayMode;
|
|
|
|
/* Interface IDeckLinkDisplayModeIterator - enumerates over supported input/output display modes. */
|
|
|
|
class BMD_PUBLIC IDeckLinkDisplayModeIterator : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Next (/* out */ IDeckLinkDisplayMode **deckLinkDisplayMode) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkDisplayModeIterator () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkDisplayMode - represents a display mode */
|
|
|
|
class BMD_PUBLIC IDeckLinkDisplayMode : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetName (/* out */ CFStringRef *name) = 0;
|
|
virtual BMDDisplayMode GetDisplayMode (void) = 0;
|
|
virtual long GetWidth (void) = 0;
|
|
virtual long GetHeight (void) = 0;
|
|
virtual HRESULT GetFrameRate (/* out */ BMDTimeValue *frameDuration, /* out */ BMDTimeScale *timeScale) = 0;
|
|
virtual BMDFieldDominance GetFieldDominance (void) = 0;
|
|
virtual BMDDisplayModeFlags GetFlags (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkDisplayMode () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Functions */
|
|
|
|
extern "C" {
|
|
|
|
|
|
}
|
|
|
|
|
|
#endif /* defined(BMD_DECKLINKAPIMODES_H) */
|