obs-studio/plugins/decklink/win/decklink-sdk/DeckLinkAPIModes.idl

/* -LICENSE-START-
** Copyright (c) 2021 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_CONST
    #if defined(_MSC_VER)
        #define BMD_CONST __declspec(selectany) static const
    #else
        #define BMD_CONST static const
    #endif
#endif

// Type Declarations


// Enumeration Mapping

cpp_quote("typedef unsigned int BMDDisplayModeFlags;")
cpp_quote("#if 0")
typedef enum _BMDDisplayModeFlags BMDDisplayModeFlags;
cpp_quote("#endif")

/* Enum BMDDisplayMode - BMDDisplayMode enumerates the video modes supported. */

typedef [v1_enum] enum _BMDDisplayMode {

    /* SD Modes */

    bmdModeNTSC                                                  = /* 'ntsc' */ 0x6E747363,
    bmdModeNTSC2398                                              = /* 'nt23' */ 0x6E743233,	// 3:2 pulldown
    bmdModePAL                                                   = /* 'pal ' */ 0x70616C20,
    bmdModeNTSCp                                                 = /* 'ntsp' */ 0x6E747370,
    bmdModePALp                                                  = /* 'palp' */ 0x70616C70,

    /* HD 1080 Modes */

    bmdModeHD1080p2398                                           = /* '23ps' */ 0x32337073,
    bmdModeHD1080p24                                             = /* '24ps' */ 0x32347073,
    bmdModeHD1080p25                                             = /* 'Hp25' */ 0x48703235,
    bmdModeHD1080p2997                                           = /* 'Hp29' */ 0x48703239,
    bmdModeHD1080p30                                             = /* 'Hp30' */ 0x48703330,
    bmdModeHD1080p4795                                           = /* 'Hp47' */ 0x48703437,
    bmdModeHD1080p48                                             = /* 'Hp48' */ 0x48703438,
    bmdModeHD1080p50                                             = /* 'Hp50' */ 0x48703530,
    bmdModeHD1080p5994                                           = /* 'Hp59' */ 0x48703539,
    bmdModeHD1080p6000                                           = /* 'Hp60' */ 0x48703630,	// N.B. This _really_ is 60.00 Hz.
    bmdModeHD1080p9590                                           = /* 'Hp95' */ 0x48703935,
    bmdModeHD1080p96                                             = /* 'Hp96' */ 0x48703936,
    bmdModeHD1080p100                                            = /* 'Hp10' */ 0x48703130,
    bmdModeHD1080p11988                                          = /* 'Hp11' */ 0x48703131,
    bmdModeHD1080p120                                            = /* 'Hp12' */ 0x48703132,
    bmdModeHD1080i50                                             = /* 'Hi50' */ 0x48693530,
    bmdModeHD1080i5994                                           = /* 'Hi59' */ 0x48693539,
    bmdModeHD1080i6000                                           = /* 'Hi60' */ 0x48693630,	// N.B. This _really_ is 60.00 Hz.

    /* HD 720 Modes */

    bmdModeHD720p50                                              = /* 'hp50' */ 0x68703530,
    bmdModeHD720p5994                                            = /* 'hp59' */ 0x68703539,
    bmdModeHD720p60                                              = /* 'hp60' */ 0x68703630,

    /* 2K Modes */

    bmdMode2k2398                                                = /* '2k23' */ 0x326B3233,
    bmdMode2k24                                                  = /* '2k24' */ 0x326B3234,
    bmdMode2k25                                                  = /* '2k25' */ 0x326B3235,

    /* 2K DCI Modes */

    bmdMode2kDCI2398                                             = /* '2d23' */ 0x32643233,
    bmdMode2kDCI24                                               = /* '2d24' */ 0x32643234,
    bmdMode2kDCI25                                               = /* '2d25' */ 0x32643235,
    bmdMode2kDCI2997                                             = /* '2d29' */ 0x32643239,
    bmdMode2kDCI30                                               = /* '2d30' */ 0x32643330,
    bmdMode2kDCI4795                                             = /* '2d47' */ 0x32643437,
    bmdMode2kDCI48                                               = /* '2d48' */ 0x32643438,
    bmdMode2kDCI50                                               = /* '2d50' */ 0x32643530,
    bmdMode2kDCI5994                                             = /* '2d59' */ 0x32643539,
    bmdMode2kDCI60                                               = /* '2d60' */ 0x32643630,
    bmdMode2kDCI9590                                             = /* '2d95' */ 0x32643935,
    bmdMode2kDCI96                                               = /* '2d96' */ 0x32643936,
    bmdMode2kDCI100                                              = /* '2d10' */ 0x32643130,
    bmdMode2kDCI11988                                            = /* '2d11' */ 0x32643131,
    bmdMode2kDCI120                                              = /* '2d12' */ 0x32643132,

    /* 4K UHD Modes */

    bmdMode4K2160p2398                                           = /* '4k23' */ 0x346B3233,
    bmdMode4K2160p24                                             = /* '4k24' */ 0x346B3234,
    bmdMode4K2160p25                                             = /* '4k25' */ 0x346B3235,
    bmdMode4K2160p2997                                           = /* '4k29' */ 0x346B3239,
    bmdMode4K2160p30                                             = /* '4k30' */ 0x346B3330,
    bmdMode4K2160p4795                                           = /* '4k47' */ 0x346B3437,
    bmdMode4K2160p48                                             = /* '4k48' */ 0x346B3438,
    bmdMode4K2160p50                                             = /* '4k50' */ 0x346B3530,
    bmdMode4K2160p5994                                           = /* '4k59' */ 0x346B3539,
    bmdMode4K2160p60                                             = /* '4k60' */ 0x346B3630,
    bmdMode4K2160p9590                                           = /* '4k95' */ 0x346B3935,
    bmdMode4K2160p96                                             = /* '4k96' */ 0x346B3936,
    bmdMode4K2160p100                                            = /* '4k10' */ 0x346B3130,
    bmdMode4K2160p11988                                          = /* '4k11' */ 0x346B3131,
    bmdMode4K2160p120                                            = /* '4k12' */ 0x346B3132,

    /* 4K DCI Modes */

    bmdMode4kDCI2398                                             = /* '4d23' */ 0x34643233,
    bmdMode4kDCI24                                               = /* '4d24' */ 0x34643234,
    bmdMode4kDCI25                                               = /* '4d25' */ 0x34643235,
    bmdMode4kDCI2997                                             = /* '4d29' */ 0x34643239,
    bmdMode4kDCI30                                               = /* '4d30' */ 0x34643330,
    bmdMode4kDCI4795                                             = /* '4d47' */ 0x34643437,
    bmdMode4kDCI48                                               = /* '4d48' */ 0x34643438,
    bmdMode4kDCI50                                               = /* '4d50' */ 0x34643530,
    bmdMode4kDCI5994                                             = /* '4d59' */ 0x34643539,
    bmdMode4kDCI60                                               = /* '4d60' */ 0x34643630,
    bmdMode4kDCI9590                                             = /* '4d95' */ 0x34643935,
    bmdMode4kDCI96                                               = /* '4d96' */ 0x34643936,
    bmdMode4kDCI100                                              = /* '4d10' */ 0x34643130,
    bmdMode4kDCI11988                                            = /* '4d11' */ 0x34643131,
    bmdMode4kDCI120                                              = /* '4d12' */ 0x34643132,

    /* 8K UHD Modes */

    bmdMode8K4320p2398                                           = /* '8k23' */ 0x386B3233,
    bmdMode8K4320p24                                             = /* '8k24' */ 0x386B3234,
    bmdMode8K4320p25                                             = /* '8k25' */ 0x386B3235,
    bmdMode8K4320p2997                                           = /* '8k29' */ 0x386B3239,
    bmdMode8K4320p30                                             = /* '8k30' */ 0x386B3330,
    bmdMode8K4320p4795                                           = /* '8k47' */ 0x386B3437,
    bmdMode8K4320p48                                             = /* '8k48' */ 0x386B3438,
    bmdMode8K4320p50                                             = /* '8k50' */ 0x386B3530,
    bmdMode8K4320p5994                                           = /* '8k59' */ 0x386B3539,
    bmdMode8K4320p60                                             = /* '8k60' */ 0x386B3630,

    /* 8K DCI Modes */

    bmdMode8kDCI2398                                             = /* '8d23' */ 0x38643233,
    bmdMode8kDCI24                                               = /* '8d24' */ 0x38643234,
    bmdMode8kDCI25                                               = /* '8d25' */ 0x38643235,
    bmdMode8kDCI2997                                             = /* '8d29' */ 0x38643239,
    bmdMode8kDCI30                                               = /* '8d30' */ 0x38643330,
    bmdMode8kDCI4795                                             = /* '8d47' */ 0x38643437,
    bmdMode8kDCI48                                               = /* '8d48' */ 0x38643438,
    bmdMode8kDCI50                                               = /* '8d50' */ 0x38643530,
    bmdMode8kDCI5994                                             = /* '8d59' */ 0x38643539,
    bmdMode8kDCI60                                               = /* '8d60' */ 0x38643630,

    /* PC Modes */

    bmdMode640x480p60                                            = /* 'vga6' */ 0x76676136,
    bmdMode800x600p60                                            = /* 'svg6' */ 0x73766736,
    bmdMode1440x900p50                                           = /* 'wxg5' */ 0x77786735,
    bmdMode1440x900p60                                           = /* 'wxg6' */ 0x77786736,
    bmdMode1440x1080p50                                          = /* 'sxg5' */ 0x73786735,
    bmdMode1440x1080p60                                          = /* 'sxg6' */ 0x73786736,
    bmdMode1600x1200p50                                          = /* 'uxg5' */ 0x75786735,
    bmdMode1600x1200p60                                          = /* 'uxg6' */ 0x75786736,
    bmdMode1920x1200p50                                          = /* 'wux5' */ 0x77757835,
    bmdMode1920x1200p60                                          = /* 'wux6' */ 0x77757836,
    bmdMode1920x1440p50                                          = /* '1945' */ 0x31393435,
    bmdMode1920x1440p60                                          = /* '1946' */ 0x31393436,
    bmdMode2560x1440p50                                          = /* 'wqh5' */ 0x77716835,
    bmdMode2560x1440p60                                          = /* 'wqh6' */ 0x77716836,
    bmdMode2560x1600p50                                          = /* 'wqx5' */ 0x77717835,
    bmdMode2560x1600p60                                          = /* 'wqx6' */ 0x77717836,

    /* Special Modes */

    bmdModeUnknown                                               = /* 'iunk' */ 0x69756E6B
} BMDDisplayMode;

/* Enum BMDFieldDominance - BMDFieldDominance enumerates settings applicable to video fields. */

typedef [v1_enum] enum _BMDFieldDominance {
    bmdUnknownFieldDominance                                     = 0,
    bmdLowerFieldFirst                                           = /* 'lowr' */ 0x6C6F7772,
    bmdUpperFieldFirst                                           = /* 'uppr' */ 0x75707072,
    bmdProgressiveFrame                                          = /* 'prog' */ 0x70726F67,
    bmdProgressiveSegmentedFrame                                 = /* 'psf ' */ 0x70736620
} BMDFieldDominance;

/* Enum BMDPixelFormat - Video pixel formats supported for output/input */

typedef [v1_enum] enum _BMDPixelFormat {
    bmdFormatUnspecified                                         = 0,
    bmdFormat8BitYUV                                             = /* '2vuy' */ 0x32767579,
    bmdFormat10BitYUV                                            = /* 'v210' */ 0x76323130,
    bmdFormat8BitARGB                                            = 32,
    bmdFormat8BitBGRA                                            = /* 'BGRA' */ 0x42475241,
    bmdFormat10BitRGB                                            = /* 'r210' */ 0x72323130,	// Big-endian RGB 10-bit per component with SMPTE video levels (64-960). Packed as 2:10:10:10
    bmdFormat12BitRGB                                            = /* 'R12B' */ 0x52313242,	// Big-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
    bmdFormat12BitRGBLE                                          = /* 'R12L' */ 0x5231324C,	// Little-endian RGB 12-bit per component with full range (0-4095). Packed as 12-bit per component
    bmdFormat10BitRGBXLE                                         = /* 'R10l' */ 0x5231306C,	// Little-endian 10-bit RGB with SMPTE video levels (64-940)
    bmdFormat10BitRGBX                                           = /* 'R10b' */ 0x52313062,	// Big-endian 10-bit RGB with SMPTE video levels (64-940)
    bmdFormatH265                                                = /* 'hev1' */ 0x68657631,	// High Efficiency Video Coding (HEVC/h.265)

    /* AVID DNxHR */

    bmdFormatDNxHR                                               = /* 'AVdh' */ 0x41566468
} BMDPixelFormat;

/* Enum BMDDisplayModeFlags - Flags to describe the characteristics of an IDeckLinkDisplayMode. */

[v1_enum] enum _BMDDisplayModeFlags {
    bmdDisplayModeSupports3D                                     = 1 << 0,
    bmdDisplayModeColorspaceRec601                               = 1 << 1,
    bmdDisplayModeColorspaceRec709                               = 1 << 2,
    bmdDisplayModeColorspaceRec2020                              = 1 << 3
};

// Forward Declarations

interface IDeckLinkDisplayModeIterator;
interface IDeckLinkDisplayMode;

/* Interface IDeckLinkDisplayModeIterator - Enumerates over supported input/output display modes. */

[
    object,
    uuid(9C88499F-F601-4021-B80B-032E4EB41C35),
    helpstring("Enumerates over supported input/output display modes.")
] interface IDeckLinkDisplayModeIterator : IUnknown
{
    HRESULT Next ([out] IDeckLinkDisplayMode** deckLinkDisplayMode);
};

/* Interface IDeckLinkDisplayMode - Represents a display mode */

[
    object,
    uuid(3EB2C1AB-0A3D-4523-A3AD-F40D7FB14E78),
    helpstring("Represents a display mode")
] interface IDeckLinkDisplayMode : IUnknown
{
    HRESULT GetName ([out] BSTR* name);
    BMDDisplayMode GetDisplayMode (void);
    long GetWidth (void);
    long GetHeight (void);
    HRESULT GetFrameRate ([out] BMDTimeValue* frameDuration, [out] BMDTimeScale* timeScale);
    BMDFieldDominance GetFieldDominance (void);
    BMDDisplayModeFlags GetFlags (void);
};

/* Coclasses */

importlib("stdole2.tlb");