mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-11-28 12:41:05 +00:00
796fffa441
This change is needed to support 2K DCI video modes. Version 10.8 of the Decklink SDK supported DCI video modes for output only. This updated version drops that restriction. The current latest version of the Decklink SDK is 11.5, however the gstreamer decklink plugin is not compatible with API changes introduced in version 11 of the SDK. Therefore I have opted to upgrade to the latest 10.x version instead.
1231 lines
63 KiB
C++
1231 lines
63 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_DECKLINKAPI_H
|
|
#define BMD_DECKLINKAPI_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
|
|
|
|
/* DeckLink API */
|
|
|
|
#include <CoreFoundation/CoreFoundation.h>
|
|
#include <CoreFoundation/CFPlugInCOM.h>
|
|
#include <stdint.h>
|
|
|
|
#include "DeckLinkAPITypes.h"
|
|
#include "DeckLinkAPIModes.h"
|
|
#include "DeckLinkAPIDiscovery.h"
|
|
#include "DeckLinkAPIConfiguration.h"
|
|
#include "DeckLinkAPIDeckControl.h"
|
|
|
|
#include "DeckLinkAPIStreaming.h"
|
|
|
|
#define BLACKMAGIC_DECKLINK_API_MAGIC 1
|
|
|
|
// Type Declarations
|
|
|
|
|
|
// Interface ID Declarations
|
|
|
|
BMD_CONST REFIID IID_IDeckLinkVideoOutputCallback = /* 20AA5225-1958-47CB-820B-80A8D521A6EE */ {0x20,0xAA,0x52,0x25,0x19,0x58,0x47,0xCB,0x82,0x0B,0x80,0xA8,0xD5,0x21,0xA6,0xEE};
|
|
BMD_CONST REFIID IID_IDeckLinkInputCallback = /* DD04E5EC-7415-42AB-AE4A-E80C4DFC044A */ {0xDD,0x04,0xE5,0xEC,0x74,0x15,0x42,0xAB,0xAE,0x4A,0xE8,0x0C,0x4D,0xFC,0x04,0x4A};
|
|
BMD_CONST REFIID IID_IDeckLinkEncoderInputCallback = /* ACF13E61-F4A0-4974-A6A7-59AFF6268B31 */ {0xAC,0xF1,0x3E,0x61,0xF4,0xA0,0x49,0x74,0xA6,0xA7,0x59,0xAF,0xF6,0x26,0x8B,0x31};
|
|
BMD_CONST REFIID IID_IDeckLinkMemoryAllocator = /* B36EB6E7-9D29-4AA8-92EF-843B87A289E8 */ {0xB3,0x6E,0xB6,0xE7,0x9D,0x29,0x4A,0xA8,0x92,0xEF,0x84,0x3B,0x87,0xA2,0x89,0xE8};
|
|
BMD_CONST REFIID IID_IDeckLinkAudioOutputCallback = /* 403C681B-7F46-4A12-B993-2BB127084EE6 */ {0x40,0x3C,0x68,0x1B,0x7F,0x46,0x4A,0x12,0xB9,0x93,0x2B,0xB1,0x27,0x08,0x4E,0xE6};
|
|
BMD_CONST REFIID IID_IDeckLinkIterator = /* 50FB36CD-3063-4B73-BDBB-958087F2D8BA */ {0x50,0xFB,0x36,0xCD,0x30,0x63,0x4B,0x73,0xBD,0xBB,0x95,0x80,0x87,0xF2,0xD8,0xBA};
|
|
BMD_CONST REFIID IID_IDeckLinkAPIInformation = /* 7BEA3C68-730D-4322-AF34-8A7152B532A4 */ {0x7B,0xEA,0x3C,0x68,0x73,0x0D,0x43,0x22,0xAF,0x34,0x8A,0x71,0x52,0xB5,0x32,0xA4};
|
|
BMD_CONST REFIID IID_IDeckLinkOutput = /* CC5C8A6E-3F2F-4B3A-87EA-FD78AF300564 */ {0xCC,0x5C,0x8A,0x6E,0x3F,0x2F,0x4B,0x3A,0x87,0xEA,0xFD,0x78,0xAF,0x30,0x05,0x64};
|
|
BMD_CONST REFIID IID_IDeckLinkInput = /* AF22762B-DFAC-4846-AA79-FA8883560995 */ {0xAF,0x22,0x76,0x2B,0xDF,0xAC,0x48,0x46,0xAA,0x79,0xFA,0x88,0x83,0x56,0x09,0x95};
|
|
BMD_CONST REFIID IID_IDeckLinkHDMIInputEDID = /* ABBBACBC-45BC-4665-9D92-ACE6E5A97902 */ {0xAB,0xBB,0xAC,0xBC,0x45,0xBC,0x46,0x65,0x9D,0x92,0xAC,0xE6,0xE5,0xA9,0x79,0x02};
|
|
BMD_CONST REFIID IID_IDeckLinkEncoderInput = /* 270587DA-6B7D-42E7-A1F0-6D853F581185 */ {0x27,0x05,0x87,0xDA,0x6B,0x7D,0x42,0xE7,0xA1,0xF0,0x6D,0x85,0x3F,0x58,0x11,0x85};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoFrame = /* 3F716FE0-F023-4111-BE5D-EF4414C05B17 */ {0x3F,0x71,0x6F,0xE0,0xF0,0x23,0x41,0x11,0xBE,0x5D,0xEF,0x44,0x14,0xC0,0x5B,0x17};
|
|
BMD_CONST REFIID IID_IDeckLinkMutableVideoFrame = /* 69E2639F-40DA-4E19-B6F2-20ACE815C390 */ {0x69,0xE2,0x63,0x9F,0x40,0xDA,0x4E,0x19,0xB6,0xF2,0x20,0xAC,0xE8,0x15,0xC3,0x90};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoFrame3DExtensions = /* DA0F7E4A-EDC7-48A8-9CDD-2DB51C729CD7 */ {0xDA,0x0F,0x7E,0x4A,0xED,0xC7,0x48,0xA8,0x9C,0xDD,0x2D,0xB5,0x1C,0x72,0x9C,0xD7};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoFrameMetadataExtensions = /* D5973DC9-6432-46D0-8F0B-2496F8A1238F */ {0xD5,0x97,0x3D,0xC9,0x64,0x32,0x46,0xD0,0x8F,0x0B,0x24,0x96,0xF8,0xA1,0x23,0x8F};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoInputFrame = /* 05CFE374-537C-4094-9A57-680525118F44 */ {0x05,0xCF,0xE3,0x74,0x53,0x7C,0x40,0x94,0x9A,0x57,0x68,0x05,0x25,0x11,0x8F,0x44};
|
|
BMD_CONST REFIID IID_IDeckLinkAncillaryPacket = /* CC5BBF7E-029C-4D3B-9158-6000EF5E3670 */ {0xCC,0x5B,0xBF,0x7E,0x02,0x9C,0x4D,0x3B,0x91,0x58,0x60,0x00,0xEF,0x5E,0x36,0x70};
|
|
BMD_CONST REFIID IID_IDeckLinkAncillaryPacketIterator = /* 3FC8994B-88FB-4C17-968F-9AAB69D964A7 */ {0x3F,0xC8,0x99,0x4B,0x88,0xFB,0x4C,0x17,0x96,0x8F,0x9A,0xAB,0x69,0xD9,0x64,0xA7};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoFrameAncillaryPackets = /* 6C186C0F-459E-41D8-AEE2-4812D81AEE68 */ {0x6C,0x18,0x6C,0x0F,0x45,0x9E,0x41,0xD8,0xAE,0xE2,0x48,0x12,0xD8,0x1A,0xEE,0x68};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoFrameAncillary = /* 732E723C-D1A4-4E29-9E8E-4A88797A0004 */ {0x73,0x2E,0x72,0x3C,0xD1,0xA4,0x4E,0x29,0x9E,0x8E,0x4A,0x88,0x79,0x7A,0x00,0x04};
|
|
BMD_CONST REFIID IID_IDeckLinkEncoderPacket = /* B693F36C-316E-4AF1-B6C2-F389A4BCA620 */ {0xB6,0x93,0xF3,0x6C,0x31,0x6E,0x4A,0xF1,0xB6,0xC2,0xF3,0x89,0xA4,0xBC,0xA6,0x20};
|
|
BMD_CONST REFIID IID_IDeckLinkEncoderVideoPacket = /* 4E7FD944-E8C7-4EAC-B8C0-7B77F80F5AE0 */ {0x4E,0x7F,0xD9,0x44,0xE8,0xC7,0x4E,0xAC,0xB8,0xC0,0x7B,0x77,0xF8,0x0F,0x5A,0xE0};
|
|
BMD_CONST REFIID IID_IDeckLinkEncoderAudioPacket = /* 49E8EDC8-693B-4E14-8EF6-12C658F5A07A */ {0x49,0xE8,0xED,0xC8,0x69,0x3B,0x4E,0x14,0x8E,0xF6,0x12,0xC6,0x58,0xF5,0xA0,0x7A};
|
|
BMD_CONST REFIID IID_IDeckLinkH265NALPacket = /* 639C8E0B-68D5-4BDE-A6D4-95F3AEAFF2E7 */ {0x63,0x9C,0x8E,0x0B,0x68,0xD5,0x4B,0xDE,0xA6,0xD4,0x95,0xF3,0xAE,0xAF,0xF2,0xE7};
|
|
BMD_CONST REFIID IID_IDeckLinkAudioInputPacket = /* E43D5870-2894-11DE-8C30-0800200C9A66 */ {0xE4,0x3D,0x58,0x70,0x28,0x94,0x11,0xDE,0x8C,0x30,0x08,0x00,0x20,0x0C,0x9A,0x66};
|
|
BMD_CONST REFIID IID_IDeckLinkScreenPreviewCallback = /* B1D3F49A-85FE-4C5D-95C8-0B5D5DCCD438 */ {0xB1,0xD3,0xF4,0x9A,0x85,0xFE,0x4C,0x5D,0x95,0xC8,0x0B,0x5D,0x5D,0xCC,0xD4,0x38};
|
|
BMD_CONST REFIID IID_IDeckLinkCocoaScreenPreviewCallback = /* D174152F-8F96-4C07-83A5-DD5F5AF0A2AA */ {0xD1,0x74,0x15,0x2F,0x8F,0x96,0x4C,0x07,0x83,0xA5,0xDD,0x5F,0x5A,0xF0,0xA2,0xAA};
|
|
BMD_CONST REFIID IID_IDeckLinkGLScreenPreviewHelper = /* 504E2209-CAC7-4C1A-9FB4-C5BB6274D22F */ {0x50,0x4E,0x22,0x09,0xCA,0xC7,0x4C,0x1A,0x9F,0xB4,0xC5,0xBB,0x62,0x74,0xD2,0x2F};
|
|
BMD_CONST REFIID IID_IDeckLinkNotificationCallback = /* B002A1EC-070D-4288-8289-BD5D36E5FF0D */ {0xB0,0x02,0xA1,0xEC,0x07,0x0D,0x42,0x88,0x82,0x89,0xBD,0x5D,0x36,0xE5,0xFF,0x0D};
|
|
BMD_CONST REFIID IID_IDeckLinkNotification = /* 0A1FB207-E215-441B-9B19-6FA1575946C5 */ {0x0A,0x1F,0xB2,0x07,0xE2,0x15,0x44,0x1B,0x9B,0x19,0x6F,0xA1,0x57,0x59,0x46,0xC5};
|
|
BMD_CONST REFIID IID_IDeckLinkAttributes = /* ABC11843-D966-44CB-96E2-A1CB5D3135C4 */ {0xAB,0xC1,0x18,0x43,0xD9,0x66,0x44,0xCB,0x96,0xE2,0xA1,0xCB,0x5D,0x31,0x35,0xC4};
|
|
BMD_CONST REFIID IID_IDeckLinkStatus = /* 5F558200-4028-49BC-BEAC-DB3FA4A96E46 */ {0x5F,0x55,0x82,0x00,0x40,0x28,0x49,0xBC,0xBE,0xAC,0xDB,0x3F,0xA4,0xA9,0x6E,0x46};
|
|
BMD_CONST REFIID IID_IDeckLinkKeyer = /* 89AFCAF5-65F8-421E-98F7-96FE5F5BFBA3 */ {0x89,0xAF,0xCA,0xF5,0x65,0xF8,0x42,0x1E,0x98,0xF7,0x96,0xFE,0x5F,0x5B,0xFB,0xA3};
|
|
BMD_CONST REFIID IID_IDeckLinkVideoConversion = /* 3BBCB8A2-DA2C-42D9-B5D8-88083644E99A */ {0x3B,0xBC,0xB8,0xA2,0xDA,0x2C,0x42,0xD9,0xB5,0xD8,0x88,0x08,0x36,0x44,0xE9,0x9A};
|
|
BMD_CONST REFIID IID_IDeckLinkDeviceNotificationCallback = /* 4997053B-0ADF-4CC8-AC70-7A50C4BE728F */ {0x49,0x97,0x05,0x3B,0x0A,0xDF,0x4C,0xC8,0xAC,0x70,0x7A,0x50,0xC4,0xBE,0x72,0x8F};
|
|
BMD_CONST REFIID IID_IDeckLinkDiscovery = /* CDBF631C-BC76-45FA-B44D-C55059BC6101 */ {0xCD,0xBF,0x63,0x1C,0xBC,0x76,0x45,0xFA,0xB4,0x4D,0xC5,0x50,0x59,0xBC,0x61,0x01};
|
|
|
|
/* Enum BMDVideoOutputFlags - Flags to control the output of ancillary data along with video. */
|
|
|
|
typedef uint32_t BMDVideoOutputFlags;
|
|
enum _BMDVideoOutputFlags {
|
|
bmdVideoOutputFlagDefault = 0,
|
|
bmdVideoOutputVANC = 1 << 0,
|
|
bmdVideoOutputVITC = 1 << 1,
|
|
bmdVideoOutputRP188 = 1 << 2,
|
|
bmdVideoOutputDualStream3D = 1 << 4
|
|
};
|
|
|
|
/* Enum BMDPacketType - Type of packet */
|
|
|
|
typedef uint32_t BMDPacketType;
|
|
enum _BMDPacketType {
|
|
bmdPacketTypeStreamInterruptedMarker = 'sint', // A packet of this type marks the time when a video stream was interrupted, for example by a disconnected cable
|
|
bmdPacketTypeStreamData = 'sdat' // Regular stream data
|
|
};
|
|
|
|
/* Enum BMDFrameFlags - Frame flags */
|
|
|
|
typedef uint32_t BMDFrameFlags;
|
|
enum _BMDFrameFlags {
|
|
bmdFrameFlagDefault = 0,
|
|
bmdFrameFlagFlipVertical = 1 << 0,
|
|
bmdFrameContainsHDRMetadata = 1 << 1,
|
|
bmdFrameContainsCintelMetadata = 1 << 2,
|
|
|
|
/* Flags that are applicable only to instances of IDeckLinkVideoInputFrame */
|
|
|
|
bmdFrameCapturedAsPsF = 1 << 30,
|
|
bmdFrameHasNoInputSource = 1 << 31
|
|
};
|
|
|
|
/* Enum BMDVideoInputFlags - Flags applicable to video input */
|
|
|
|
typedef uint32_t BMDVideoInputFlags;
|
|
enum _BMDVideoInputFlags {
|
|
bmdVideoInputFlagDefault = 0,
|
|
bmdVideoInputEnableFormatDetection = 1 << 0,
|
|
bmdVideoInputDualStream3D = 1 << 1
|
|
};
|
|
|
|
/* Enum BMDVideoInputFormatChangedEvents - Bitmask passed to the VideoInputFormatChanged notification to identify the properties of the input signal that have changed */
|
|
|
|
typedef uint32_t BMDVideoInputFormatChangedEvents;
|
|
enum _BMDVideoInputFormatChangedEvents {
|
|
bmdVideoInputDisplayModeChanged = 1 << 0,
|
|
bmdVideoInputFieldDominanceChanged = 1 << 1,
|
|
bmdVideoInputColorspaceChanged = 1 << 2
|
|
};
|
|
|
|
/* Enum BMDDetectedVideoInputFormatFlags - Flags passed to the VideoInputFormatChanged notification to describe the detected video input signal */
|
|
|
|
typedef uint32_t BMDDetectedVideoInputFormatFlags;
|
|
enum _BMDDetectedVideoInputFormatFlags {
|
|
bmdDetectedVideoInputYCbCr422 = 1 << 0,
|
|
bmdDetectedVideoInputRGB444 = 1 << 1,
|
|
bmdDetectedVideoInputDualStream3D = 1 << 2
|
|
};
|
|
|
|
/* Enum BMDDeckLinkCapturePassthroughMode - Enumerates whether the video output is electrically connected to the video input or if the clean switching mode is enabled */
|
|
|
|
typedef uint32_t BMDDeckLinkCapturePassthroughMode;
|
|
enum _BMDDeckLinkCapturePassthroughMode {
|
|
bmdDeckLinkCapturePassthroughModeDisabled = 'pdis',
|
|
bmdDeckLinkCapturePassthroughModeDirect = 'pdir',
|
|
bmdDeckLinkCapturePassthroughModeCleanSwitch = 'pcln'
|
|
};
|
|
|
|
/* Enum BMDOutputFrameCompletionResult - Frame Completion Callback */
|
|
|
|
typedef uint32_t BMDOutputFrameCompletionResult;
|
|
enum _BMDOutputFrameCompletionResult {
|
|
bmdOutputFrameCompleted,
|
|
bmdOutputFrameDisplayedLate,
|
|
bmdOutputFrameDropped,
|
|
bmdOutputFrameFlushed
|
|
};
|
|
|
|
/* Enum BMDReferenceStatus - GenLock input status */
|
|
|
|
typedef uint32_t BMDReferenceStatus;
|
|
enum _BMDReferenceStatus {
|
|
bmdReferenceNotSupportedByHardware = 1 << 0,
|
|
bmdReferenceLocked = 1 << 1
|
|
};
|
|
|
|
/* Enum BMDAudioFormat - Audio Format */
|
|
|
|
typedef uint32_t BMDAudioFormat;
|
|
enum _BMDAudioFormat {
|
|
bmdAudioFormatPCM = 'lpcm' // Linear signed PCM samples
|
|
};
|
|
|
|
/* Enum BMDAudioSampleRate - Audio sample rates supported for output/input */
|
|
|
|
typedef uint32_t BMDAudioSampleRate;
|
|
enum _BMDAudioSampleRate {
|
|
bmdAudioSampleRate48kHz = 48000
|
|
};
|
|
|
|
/* Enum BMDAudioSampleType - Audio sample sizes supported for output/input */
|
|
|
|
typedef uint32_t BMDAudioSampleType;
|
|
enum _BMDAudioSampleType {
|
|
bmdAudioSampleType16bitInteger = 16,
|
|
bmdAudioSampleType32bitInteger = 32
|
|
};
|
|
|
|
/* Enum BMDAudioOutputStreamType - Audio output stream type */
|
|
|
|
typedef uint32_t BMDAudioOutputStreamType;
|
|
enum _BMDAudioOutputStreamType {
|
|
bmdAudioOutputStreamContinuous,
|
|
bmdAudioOutputStreamContinuousDontResample,
|
|
bmdAudioOutputStreamTimestamped
|
|
};
|
|
|
|
/* Enum BMDDisplayModeSupport - Output mode supported flags */
|
|
|
|
typedef uint32_t BMDDisplayModeSupport;
|
|
enum _BMDDisplayModeSupport {
|
|
bmdDisplayModeNotSupported = 0,
|
|
bmdDisplayModeSupported,
|
|
bmdDisplayModeSupportedWithConversion
|
|
};
|
|
|
|
/* Enum BMDAncillaryPacketFormat - Ancillary packet format */
|
|
|
|
typedef uint32_t BMDAncillaryPacketFormat;
|
|
enum _BMDAncillaryPacketFormat {
|
|
bmdAncillaryPacketFormatUInt8 = 'ui08',
|
|
bmdAncillaryPacketFormatUInt16 = 'ui16',
|
|
bmdAncillaryPacketFormatYCbCr10 = 'v210'
|
|
};
|
|
|
|
/* Enum BMDTimecodeFormat - Timecode formats for frame metadata */
|
|
|
|
typedef uint32_t BMDTimecodeFormat;
|
|
enum _BMDTimecodeFormat {
|
|
bmdTimecodeRP188VITC1 = 'rpv1', // RP188 timecode where DBB1 equals VITC1 (line 9)
|
|
bmdTimecodeRP188VITC2 = 'rp12', // RP188 timecode where DBB1 equals VITC2 (line 9 for progressive or line 571 for interlaced/PsF)
|
|
bmdTimecodeRP188LTC = 'rplt', // RP188 timecode where DBB1 equals LTC (line 10)
|
|
bmdTimecodeRP188Any = 'rp18', // For capture: return the first valid timecode in {VITC1, LTC ,VITC2} - For playback: set the timecode as VITC1
|
|
bmdTimecodeVITC = 'vitc',
|
|
bmdTimecodeVITCField2 = 'vit2',
|
|
bmdTimecodeSerial = 'seri'
|
|
};
|
|
|
|
/* Enum BMDAnalogVideoFlags - Analog video display flags */
|
|
|
|
typedef uint32_t BMDAnalogVideoFlags;
|
|
enum _BMDAnalogVideoFlags {
|
|
bmdAnalogVideoFlagCompositeSetup75 = 1 << 0,
|
|
bmdAnalogVideoFlagComponentBetacamLevels = 1 << 1
|
|
};
|
|
|
|
/* Enum BMDAudioOutputAnalogAESSwitch - Audio output Analog/AESEBU switch */
|
|
|
|
typedef uint32_t BMDAudioOutputAnalogAESSwitch;
|
|
enum _BMDAudioOutputAnalogAESSwitch {
|
|
bmdAudioOutputSwitchAESEBU = 'aes ',
|
|
bmdAudioOutputSwitchAnalog = 'anlg'
|
|
};
|
|
|
|
/* Enum BMDVideoOutputConversionMode - Video/audio conversion mode */
|
|
|
|
typedef uint32_t BMDVideoOutputConversionMode;
|
|
enum _BMDVideoOutputConversionMode {
|
|
bmdNoVideoOutputConversion = 'none',
|
|
bmdVideoOutputLetterboxDownconversion = 'ltbx',
|
|
bmdVideoOutputAnamorphicDownconversion = 'amph',
|
|
bmdVideoOutputHD720toHD1080Conversion = '720c',
|
|
bmdVideoOutputHardwareLetterboxDownconversion = 'HWlb',
|
|
bmdVideoOutputHardwareAnamorphicDownconversion = 'HWam',
|
|
bmdVideoOutputHardwareCenterCutDownconversion = 'HWcc',
|
|
bmdVideoOutputHardware720p1080pCrossconversion = 'xcap',
|
|
bmdVideoOutputHardwareAnamorphic720pUpconversion = 'ua7p',
|
|
bmdVideoOutputHardwareAnamorphic1080iUpconversion = 'ua1i',
|
|
bmdVideoOutputHardwareAnamorphic149To720pUpconversion = 'u47p',
|
|
bmdVideoOutputHardwareAnamorphic149To1080iUpconversion = 'u41i',
|
|
bmdVideoOutputHardwarePillarbox720pUpconversion = 'up7p',
|
|
bmdVideoOutputHardwarePillarbox1080iUpconversion = 'up1i'
|
|
};
|
|
|
|
/* Enum BMDVideoInputConversionMode - Video input conversion mode */
|
|
|
|
typedef uint32_t BMDVideoInputConversionMode;
|
|
enum _BMDVideoInputConversionMode {
|
|
bmdNoVideoInputConversion = 'none',
|
|
bmdVideoInputLetterboxDownconversionFromHD1080 = '10lb',
|
|
bmdVideoInputAnamorphicDownconversionFromHD1080 = '10am',
|
|
bmdVideoInputLetterboxDownconversionFromHD720 = '72lb',
|
|
bmdVideoInputAnamorphicDownconversionFromHD720 = '72am',
|
|
bmdVideoInputLetterboxUpconversion = 'lbup',
|
|
bmdVideoInputAnamorphicUpconversion = 'amup'
|
|
};
|
|
|
|
/* Enum BMDVideo3DPackingFormat - Video 3D packing format */
|
|
|
|
typedef uint32_t BMDVideo3DPackingFormat;
|
|
enum _BMDVideo3DPackingFormat {
|
|
bmdVideo3DPackingSidebySideHalf = 'sbsh',
|
|
bmdVideo3DPackingLinebyLine = 'lbyl',
|
|
bmdVideo3DPackingTopAndBottom = 'tabo',
|
|
bmdVideo3DPackingFramePacking = 'frpk',
|
|
bmdVideo3DPackingLeftOnly = 'left',
|
|
bmdVideo3DPackingRightOnly = 'righ'
|
|
};
|
|
|
|
/* Enum BMDIdleVideoOutputOperation - Video output operation when not playing video */
|
|
|
|
typedef uint32_t BMDIdleVideoOutputOperation;
|
|
enum _BMDIdleVideoOutputOperation {
|
|
bmdIdleVideoOutputBlack = 'blac',
|
|
bmdIdleVideoOutputLastFrame = 'lafa'
|
|
};
|
|
|
|
/* Enum BMDVideoEncoderFrameCodingMode - Video frame coding mode */
|
|
|
|
typedef uint32_t BMDVideoEncoderFrameCodingMode;
|
|
enum _BMDVideoEncoderFrameCodingMode {
|
|
bmdVideoEncoderFrameCodingModeInter = 'inte',
|
|
bmdVideoEncoderFrameCodingModeIntra = 'intr'
|
|
};
|
|
|
|
/* Enum BMDDNxHRLevel - DNxHR Levels */
|
|
|
|
typedef uint32_t BMDDNxHRLevel;
|
|
enum _BMDDNxHRLevel {
|
|
bmdDNxHRLevelSQ = 'dnsq',
|
|
bmdDNxHRLevelLB = 'dnlb',
|
|
bmdDNxHRLevelHQ = 'dnhq',
|
|
bmdDNxHRLevelHQX = 'dhqx',
|
|
bmdDNxHRLevel444 = 'd444'
|
|
};
|
|
|
|
/* Enum BMDLinkConfiguration - Video link configuration */
|
|
|
|
typedef uint32_t BMDLinkConfiguration;
|
|
enum _BMDLinkConfiguration {
|
|
bmdLinkConfigurationSingleLink = 'lcsl',
|
|
bmdLinkConfigurationDualLink = 'lcdl',
|
|
bmdLinkConfigurationQuadLink = 'lcql'
|
|
};
|
|
|
|
/* Enum BMDDeviceInterface - Device interface type */
|
|
|
|
typedef uint32_t BMDDeviceInterface;
|
|
enum _BMDDeviceInterface {
|
|
bmdDeviceInterfacePCI = 'pci ',
|
|
bmdDeviceInterfaceUSB = 'usb ',
|
|
bmdDeviceInterfaceThunderbolt = 'thun'
|
|
};
|
|
|
|
/* Enum BMDColorspace - Colorspace */
|
|
|
|
typedef uint32_t BMDColorspace;
|
|
enum _BMDColorspace {
|
|
bmdColorspaceRec601 = 'r601',
|
|
bmdColorspaceRec709 = 'r709',
|
|
bmdColorspaceRec2020 = '2020'
|
|
};
|
|
|
|
/* Enum BMDDynamicRange - SDR or HDR */
|
|
|
|
typedef uint32_t BMDDynamicRange;
|
|
enum _BMDDynamicRange {
|
|
bmdDynamicRangeSDR = 0,
|
|
bmdDynamicRangeHDRStaticPQ = 1 << 29, // SMPTE ST 2084
|
|
bmdDynamicRangeHDRStaticHLG = 1 << 30 // ITU-R BT.2100-0
|
|
};
|
|
|
|
/* Enum BMDDeckLinkHDMIInputEDIDID - DeckLink HDMI Input EDID ID */
|
|
|
|
typedef uint32_t BMDDeckLinkHDMIInputEDIDID;
|
|
enum _BMDDeckLinkHDMIInputEDIDID {
|
|
bmdDeckLinkHDMIInputEDIDDynamicRange = 'HIDy' // Parameter is of type BMDDynamicRange. Default is (bmdDynamicRangeSDR|bmdDynamicRangeHDRStaticPQ)
|
|
};
|
|
|
|
/* Enum BMDDeckLinkFrameMetadataID - DeckLink Frame Metadata ID */
|
|
|
|
typedef uint32_t BMDDeckLinkFrameMetadataID;
|
|
enum _BMDDeckLinkFrameMetadataID {
|
|
bmdDeckLinkFrameMetadataColorspace = 'cspc', // Colorspace of video frame (see BMDColorspace)
|
|
bmdDeckLinkFrameMetadataHDRElectroOpticalTransferFunc = 'eotf', // EOTF in range 0-7 as per CEA 861.3
|
|
bmdDeckLinkFrameMetadataCintelFilmType = 'cfty', // Current film type
|
|
bmdDeckLinkFrameMetadataCintelFilmGauge = 'cfga', // Current film gauge
|
|
bmdDeckLinkFrameMetadataCintelOffsetDetectedHorizontal = 'odfh', // Horizontal offset (pixels) detected in image
|
|
bmdDeckLinkFrameMetadataCintelOffsetDetectedVertical = 'odfv', // Vertical offset (pixels) detected in image
|
|
bmdDeckLinkFrameMetadataCintelKeykodeLow = 'ckkl', // Raw keykode value - low 64 bits
|
|
bmdDeckLinkFrameMetadataCintelKeykodeHigh = 'ckkh', // Raw keykode value - high 64 bits
|
|
bmdDeckLinkFrameMetadataCintelTile1Size = 'ct1s', // Size in bytes of compressed raw tile 1
|
|
bmdDeckLinkFrameMetadataCintelTile2Size = 'ct2s', // Size in bytes of compressed raw tile 2
|
|
bmdDeckLinkFrameMetadataCintelTile3Size = 'ct3s', // Size in bytes of compressed raw tile 3
|
|
bmdDeckLinkFrameMetadataCintelTile4Size = 'ct4s', // Size in bytes of compressed raw tile 4
|
|
bmdDeckLinkFrameMetadataCintelImageWidth = 'IWPx', // Width in pixels of image
|
|
bmdDeckLinkFrameMetadataCintelImageHeight = 'IHPx', // Height in pixels of image
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInRed = 'mrir', // Red in red linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInRed = 'mgir', // Green in red linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInRed = 'mbir', // Blue in red linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInGreen = 'mrig', // Red in green linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInGreen = 'mgig', // Green in green linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInGreen = 'mbig', // Blue in green linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingRedInBlue = 'mrib', // Red in blue linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingGreenInBlue = 'mgib', // Green in blue linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLinearMaskingBlueInBlue = 'mbib', // Blue in blue linear masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingRedInRed = 'mlrr', // Red in red log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInRed = 'mlgr', // Green in red log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInRed = 'mlbr', // Blue in red log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingRedInGreen = 'mlrg', // Red in green log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInGreen = 'mlgg', // Green in green log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInGreen = 'mlbg', // Blue in green log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingRedInBlue = 'mlrb', // Red in blue log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingGreenInBlue = 'mlgb', // Green in blue log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelLogMaskingBlueInBlue = 'mlbb', // Blue in blue log masking parameter
|
|
bmdDeckLinkFrameMetadataCintelFilmFrameRate = 'cffr', // Film frame rate
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesRedX = 'hdrx', // Red display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesRedY = 'hdry', // Red display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesGreenX = 'hdgx', // Green display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesGreenY = 'hdgy', // Green display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesBlueX = 'hdbx', // Blue display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRDisplayPrimariesBlueY = 'hdby', // Blue display primaries in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRWhitePointX = 'hdwx', // White point in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRWhitePointY = 'hdwy', // White point in range 0.0 - 1.0
|
|
bmdDeckLinkFrameMetadataHDRMaxDisplayMasteringLuminance = 'hdml', // Max display mastering luminance in range 1 cd/m2 - 65535 cd/m2
|
|
bmdDeckLinkFrameMetadataHDRMinDisplayMasteringLuminance = 'hmil', // Min display mastering luminance in range 0.0001 cd/m2 - 6.5535 cd/m2
|
|
bmdDeckLinkFrameMetadataHDRMaximumContentLightLevel = 'mcll', // Maximum Content Light Level in range 1 cd/m2 - 65535 cd/m2
|
|
bmdDeckLinkFrameMetadataHDRMaximumFrameAverageLightLevel = 'fall', // Maximum Frame Average Light Level in range 1 cd/m2 - 65535 cd/m2
|
|
bmdDeckLinkFrameMetadataCintelOffsetToApplyHorizontal = 'otah', // Horizontal offset (pixels) to be applied to image
|
|
bmdDeckLinkFrameMetadataCintelOffsetToApplyVertical = 'otav', // Vertical offset (pixels) to be applied to image
|
|
bmdDeckLinkFrameMetadataCintelGainRed = 'LfRd', // Red gain parameter to apply after log
|
|
bmdDeckLinkFrameMetadataCintelGainGreen = 'LfGr', // Green gain parameter to apply after log
|
|
bmdDeckLinkFrameMetadataCintelGainBlue = 'LfBl', // Blue gain parameter to apply after log
|
|
bmdDeckLinkFrameMetadataCintelLiftRed = 'GnRd', // Red lift parameter to apply after log and gain
|
|
bmdDeckLinkFrameMetadataCintelLiftGreen = 'GnGr', // Green lift parameter to apply after log and gain
|
|
bmdDeckLinkFrameMetadataCintelLiftBlue = 'GnBl' // Blue lift parameter to apply after log and gain
|
|
};
|
|
|
|
/* Enum BMDDuplexMode - Duplex for configurable ports */
|
|
|
|
typedef uint32_t BMDDuplexMode;
|
|
enum _BMDDuplexMode {
|
|
bmdDuplexModeFull = 'fdup',
|
|
bmdDuplexModeHalf = 'hdup'
|
|
};
|
|
|
|
/* Enum BMDDeckLinkAttributeID - DeckLink Attribute ID */
|
|
|
|
typedef uint32_t BMDDeckLinkAttributeID;
|
|
enum _BMDDeckLinkAttributeID {
|
|
|
|
/* Flags */
|
|
|
|
BMDDeckLinkSupportsInternalKeying = 'keyi',
|
|
BMDDeckLinkSupportsExternalKeying = 'keye',
|
|
BMDDeckLinkSupportsHDKeying = 'keyh',
|
|
BMDDeckLinkSupportsInputFormatDetection = 'infd',
|
|
BMDDeckLinkHasReferenceInput = 'hrin',
|
|
BMDDeckLinkHasSerialPort = 'hspt',
|
|
BMDDeckLinkHasAnalogVideoOutputGain = 'avog',
|
|
BMDDeckLinkCanOnlyAdjustOverallVideoOutputGain = 'ovog',
|
|
BMDDeckLinkHasVideoInputAntiAliasingFilter = 'aafl',
|
|
BMDDeckLinkHasBypass = 'byps',
|
|
BMDDeckLinkSupportsClockTimingAdjustment = 'ctad',
|
|
BMDDeckLinkSupportsFullDuplex = 'fdup',
|
|
BMDDeckLinkSupportsFullFrameReferenceInputTimingOffset = 'frin',
|
|
BMDDeckLinkSupportsSMPTELevelAOutput = 'lvla',
|
|
BMDDeckLinkSupportsDualLinkSDI = 'sdls',
|
|
BMDDeckLinkSupportsQuadLinkSDI = 'sqls',
|
|
BMDDeckLinkSupportsIdleOutput = 'idou',
|
|
BMDDeckLinkHasLTCTimecodeInput = 'hltc',
|
|
BMDDeckLinkSupportsDuplexModeConfiguration = 'dupx',
|
|
BMDDeckLinkSupportsHDRMetadata = 'hdrm',
|
|
BMDDeckLinkSupportsColorspaceMetadata = 'cmet',
|
|
|
|
/* Integers */
|
|
|
|
BMDDeckLinkMaximumAudioChannels = 'mach',
|
|
BMDDeckLinkMaximumAnalogAudioInputChannels = 'iach',
|
|
BMDDeckLinkMaximumAnalogAudioOutputChannels = 'aach',
|
|
BMDDeckLinkNumberOfSubDevices = 'nsbd',
|
|
BMDDeckLinkSubDeviceIndex = 'subi',
|
|
BMDDeckLinkPersistentID = 'peid',
|
|
BMDDeckLinkDeviceGroupID = 'dgid',
|
|
BMDDeckLinkTopologicalID = 'toid',
|
|
BMDDeckLinkVideoOutputConnections = 'vocn', // Returns a BMDVideoConnection bit field
|
|
BMDDeckLinkVideoInputConnections = 'vicn', // Returns a BMDVideoConnection bit field
|
|
BMDDeckLinkAudioOutputConnections = 'aocn', // Returns a BMDAudioConnection bit field
|
|
BMDDeckLinkAudioInputConnections = 'aicn', // Returns a BMDAudioConnection bit field
|
|
BMDDeckLinkVideoIOSupport = 'vios', // Returns a BMDVideoIOSupport bit field
|
|
BMDDeckLinkDeckControlConnections = 'dccn', // Returns a BMDDeckControlConnection bit field
|
|
BMDDeckLinkDeviceInterface = 'dbus', // Returns a BMDDeviceInterface
|
|
BMDDeckLinkAudioInputRCAChannelCount = 'airc',
|
|
BMDDeckLinkAudioInputXLRChannelCount = 'aixc',
|
|
BMDDeckLinkAudioOutputRCAChannelCount = 'aorc',
|
|
BMDDeckLinkAudioOutputXLRChannelCount = 'aoxc',
|
|
BMDDeckLinkPairedDevicePersistentID = 'ppid',
|
|
|
|
/* Floats */
|
|
|
|
BMDDeckLinkVideoInputGainMinimum = 'vigm',
|
|
BMDDeckLinkVideoInputGainMaximum = 'vigx',
|
|
BMDDeckLinkVideoOutputGainMinimum = 'vogm',
|
|
BMDDeckLinkVideoOutputGainMaximum = 'vogx',
|
|
BMDDeckLinkMicrophoneInputGainMinimum = 'migm',
|
|
BMDDeckLinkMicrophoneInputGainMaximum = 'migx',
|
|
|
|
/* Strings */
|
|
|
|
BMDDeckLinkSerialPortDeviceName = 'slpn',
|
|
BMDDeckLinkVendorName = 'vndr',
|
|
BMDDeckLinkDisplayName = 'dspn',
|
|
BMDDeckLinkModelName = 'mdln',
|
|
BMDDeckLinkDeviceHandle = 'devh'
|
|
};
|
|
|
|
/* Enum BMDDeckLinkAPIInformationID - DeckLinkAPI information ID */
|
|
|
|
typedef uint32_t BMDDeckLinkAPIInformationID;
|
|
enum _BMDDeckLinkAPIInformationID {
|
|
BMDDeckLinkAPIVersion = 'vers'
|
|
};
|
|
|
|
/* Enum BMDDeckLinkStatusID - DeckLink Status ID */
|
|
|
|
typedef uint32_t BMDDeckLinkStatusID;
|
|
enum _BMDDeckLinkStatusID {
|
|
|
|
/* Integers */
|
|
|
|
bmdDeckLinkStatusDetectedVideoInputMode = 'dvim',
|
|
bmdDeckLinkStatusDetectedVideoInputFlags = 'dvif',
|
|
bmdDeckLinkStatusCurrentVideoInputMode = 'cvim',
|
|
bmdDeckLinkStatusCurrentVideoInputPixelFormat = 'cvip',
|
|
bmdDeckLinkStatusCurrentVideoInputFlags = 'cvif',
|
|
bmdDeckLinkStatusCurrentVideoOutputMode = 'cvom',
|
|
bmdDeckLinkStatusCurrentVideoOutputFlags = 'cvof',
|
|
bmdDeckLinkStatusPCIExpressLinkWidth = 'pwid',
|
|
bmdDeckLinkStatusPCIExpressLinkSpeed = 'plnk',
|
|
bmdDeckLinkStatusLastVideoOutputPixelFormat = 'opix',
|
|
bmdDeckLinkStatusReferenceSignalMode = 'refm',
|
|
bmdDeckLinkStatusReferenceSignalFlags = 'reff',
|
|
bmdDeckLinkStatusDuplexMode = 'dupx',
|
|
bmdDeckLinkStatusBusy = 'busy',
|
|
bmdDeckLinkStatusInterchangeablePanelType = 'icpt',
|
|
bmdDeckLinkStatusDeviceTemperature = 'dtmp',
|
|
|
|
/* Flags */
|
|
|
|
bmdDeckLinkStatusVideoInputSignalLocked = 'visl',
|
|
bmdDeckLinkStatusReferenceSignalLocked = 'refl',
|
|
bmdDeckLinkStatusReceivedEDID = 'edid'
|
|
};
|
|
|
|
/* Enum BMDDeckLinkVideoStatusFlags - */
|
|
|
|
typedef uint32_t BMDDeckLinkVideoStatusFlags;
|
|
enum _BMDDeckLinkVideoStatusFlags {
|
|
bmdDeckLinkVideoStatusPsF = 1 << 0,
|
|
bmdDeckLinkVideoStatusDualStream3D = 1 << 1
|
|
};
|
|
|
|
/* Enum BMDDuplexStatus - Duplex status of the device */
|
|
|
|
typedef uint32_t BMDDuplexStatus;
|
|
enum _BMDDuplexStatus {
|
|
bmdDuplexStatusFullDuplex = 'fdup',
|
|
bmdDuplexStatusHalfDuplex = 'hdup',
|
|
bmdDuplexStatusSimplex = 'splx',
|
|
bmdDuplexStatusInactive = 'inac'
|
|
};
|
|
|
|
/* Enum BMDPanelType - The type of interchangeable panel */
|
|
|
|
typedef uint32_t BMDPanelType;
|
|
enum _BMDPanelType {
|
|
bmdPanelNotDetected = 'npnl',
|
|
bmdPanelTeranexMiniSmartPanel = 'tmsm'
|
|
};
|
|
|
|
/* Enum BMDDeviceBusyState - Current device busy state */
|
|
|
|
typedef uint32_t BMDDeviceBusyState;
|
|
enum _BMDDeviceBusyState {
|
|
bmdDeviceCaptureBusy = 1 << 0,
|
|
bmdDevicePlaybackBusy = 1 << 1,
|
|
bmdDeviceSerialPortBusy = 1 << 2
|
|
};
|
|
|
|
/* Enum BMDVideoIOSupport - Device video input/output support */
|
|
|
|
typedef uint32_t BMDVideoIOSupport;
|
|
enum _BMDVideoIOSupport {
|
|
bmdDeviceSupportsCapture = 1 << 0,
|
|
bmdDeviceSupportsPlayback = 1 << 1
|
|
};
|
|
|
|
/* Enum BMD3DPreviewFormat - Linked Frame preview format */
|
|
|
|
typedef uint32_t BMD3DPreviewFormat;
|
|
enum _BMD3DPreviewFormat {
|
|
bmd3DPreviewFormatDefault = 'defa',
|
|
bmd3DPreviewFormatLeftOnly = 'left',
|
|
bmd3DPreviewFormatRightOnly = 'righ',
|
|
bmd3DPreviewFormatSideBySide = 'side',
|
|
bmd3DPreviewFormatTopBottom = 'topb'
|
|
};
|
|
|
|
/* Enum BMDNotifications - Events that can be subscribed through IDeckLinkNotification */
|
|
|
|
typedef uint32_t BMDNotifications;
|
|
enum _BMDNotifications {
|
|
bmdPreferencesChanged = 'pref',
|
|
bmdStatusChanged = 'stat'
|
|
};
|
|
|
|
#if defined(__cplusplus)
|
|
|
|
// Forward Declarations
|
|
|
|
class IDeckLinkVideoOutputCallback;
|
|
class IDeckLinkInputCallback;
|
|
class IDeckLinkEncoderInputCallback;
|
|
class IDeckLinkMemoryAllocator;
|
|
class IDeckLinkAudioOutputCallback;
|
|
class IDeckLinkIterator;
|
|
class IDeckLinkAPIInformation;
|
|
class IDeckLinkOutput;
|
|
class IDeckLinkInput;
|
|
class IDeckLinkHDMIInputEDID;
|
|
class IDeckLinkEncoderInput;
|
|
class IDeckLinkVideoFrame;
|
|
class IDeckLinkMutableVideoFrame;
|
|
class IDeckLinkVideoFrame3DExtensions;
|
|
class IDeckLinkVideoFrameMetadataExtensions;
|
|
class IDeckLinkVideoInputFrame;
|
|
class IDeckLinkAncillaryPacket;
|
|
class IDeckLinkAncillaryPacketIterator;
|
|
class IDeckLinkVideoFrameAncillaryPackets;
|
|
class IDeckLinkVideoFrameAncillary;
|
|
class IDeckLinkEncoderPacket;
|
|
class IDeckLinkEncoderVideoPacket;
|
|
class IDeckLinkEncoderAudioPacket;
|
|
class IDeckLinkH265NALPacket;
|
|
class IDeckLinkAudioInputPacket;
|
|
class IDeckLinkScreenPreviewCallback;
|
|
class IDeckLinkCocoaScreenPreviewCallback;
|
|
class IDeckLinkGLScreenPreviewHelper;
|
|
class IDeckLinkNotificationCallback;
|
|
class IDeckLinkNotification;
|
|
class IDeckLinkAttributes;
|
|
class IDeckLinkStatus;
|
|
class IDeckLinkKeyer;
|
|
class IDeckLinkVideoConversion;
|
|
class IDeckLinkDeviceNotificationCallback;
|
|
class IDeckLinkDiscovery;
|
|
|
|
/* Interface IDeckLinkVideoOutputCallback - Frame completion callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoOutputCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT ScheduledFrameCompleted (/* in */ IDeckLinkVideoFrame *completedFrame, /* in */ BMDOutputFrameCompletionResult result) = 0;
|
|
virtual HRESULT ScheduledPlaybackHasStopped (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoOutputCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkInputCallback - Frame arrival callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkInputCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT VideoInputFormatChanged (/* in */ BMDVideoInputFormatChangedEvents notificationEvents, /* in */ IDeckLinkDisplayMode *newDisplayMode, /* in */ BMDDetectedVideoInputFormatFlags detectedSignalFlags) = 0;
|
|
virtual HRESULT VideoInputFrameArrived (/* in */ IDeckLinkVideoInputFrame* videoFrame, /* in */ IDeckLinkAudioInputPacket* audioPacket) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkInputCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkEncoderInputCallback - Frame arrival callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkEncoderInputCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT VideoInputSignalChanged (/* in */ BMDVideoInputFormatChangedEvents notificationEvents, /* in */ IDeckLinkDisplayMode *newDisplayMode, /* in */ BMDDetectedVideoInputFormatFlags detectedSignalFlags) = 0;
|
|
virtual HRESULT VideoPacketArrived (/* in */ IDeckLinkEncoderVideoPacket* videoPacket) = 0;
|
|
virtual HRESULT AudioPacketArrived (/* in */ IDeckLinkEncoderAudioPacket* audioPacket) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkEncoderInputCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkMemoryAllocator - Memory allocator for video frames. */
|
|
|
|
class BMD_PUBLIC IDeckLinkMemoryAllocator : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT AllocateBuffer (/* in */ uint32_t bufferSize, /* out */ void **allocatedBuffer) = 0;
|
|
virtual HRESULT ReleaseBuffer (/* in */ void *buffer) = 0;
|
|
|
|
virtual HRESULT Commit (void) = 0;
|
|
virtual HRESULT Decommit (void) = 0;
|
|
};
|
|
|
|
/* Interface IDeckLinkAudioOutputCallback - Optional callback to allow audio samples to be pulled as required. */
|
|
|
|
class BMD_PUBLIC IDeckLinkAudioOutputCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT RenderAudioSamples (/* in */ bool preroll) = 0;
|
|
};
|
|
|
|
/* Interface IDeckLinkIterator - enumerates installed DeckLink hardware */
|
|
|
|
class BMD_PUBLIC IDeckLinkIterator : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Next (/* out */ IDeckLink **deckLinkInstance) = 0;
|
|
};
|
|
|
|
/* Interface IDeckLinkAPIInformation - DeckLinkAPI attribute interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkAPIInformation : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetFlag (/* in */ BMDDeckLinkAPIInformationID cfgID, /* out */ bool *value) = 0;
|
|
virtual HRESULT GetInt (/* in */ BMDDeckLinkAPIInformationID cfgID, /* out */ int64_t *value) = 0;
|
|
virtual HRESULT GetFloat (/* in */ BMDDeckLinkAPIInformationID cfgID, /* out */ double *value) = 0;
|
|
virtual HRESULT GetString (/* in */ BMDDeckLinkAPIInformationID cfgID, /* out */ CFStringRef *value) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkAPIInformation () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkOutput - Created by QueryInterface from IDeckLink. */
|
|
|
|
class BMD_PUBLIC IDeckLinkOutput : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT DoesSupportVideoMode (/* in */ BMDDisplayMode displayMode, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDVideoOutputFlags flags, /* out */ BMDDisplayModeSupport *result, /* out */ IDeckLinkDisplayMode **resultDisplayMode) = 0;
|
|
virtual HRESULT GetDisplayModeIterator (/* out */ IDeckLinkDisplayModeIterator **iterator) = 0;
|
|
|
|
virtual HRESULT SetScreenPreviewCallback (/* in */ IDeckLinkScreenPreviewCallback *previewCallback) = 0;
|
|
|
|
/* Video Output */
|
|
|
|
virtual HRESULT EnableVideoOutput (/* in */ BMDDisplayMode displayMode, /* in */ BMDVideoOutputFlags flags) = 0;
|
|
virtual HRESULT DisableVideoOutput (void) = 0;
|
|
|
|
virtual HRESULT SetVideoOutputFrameMemoryAllocator (/* in */ IDeckLinkMemoryAllocator *theAllocator) = 0;
|
|
virtual HRESULT CreateVideoFrame (/* in */ int32_t width, /* in */ int32_t height, /* in */ int32_t rowBytes, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDFrameFlags flags, /* out */ IDeckLinkMutableVideoFrame **outFrame) = 0;
|
|
virtual HRESULT CreateAncillaryData (/* in */ BMDPixelFormat pixelFormat, /* out */ IDeckLinkVideoFrameAncillary **outBuffer) = 0; // Use of IDeckLinkVideoFrameAncillaryPackets is preferred
|
|
|
|
virtual HRESULT DisplayVideoFrameSync (/* in */ IDeckLinkVideoFrame *theFrame) = 0;
|
|
virtual HRESULT ScheduleVideoFrame (/* in */ IDeckLinkVideoFrame *theFrame, /* in */ BMDTimeValue displayTime, /* in */ BMDTimeValue displayDuration, /* in */ BMDTimeScale timeScale) = 0;
|
|
virtual HRESULT SetScheduledFrameCompletionCallback (/* in */ IDeckLinkVideoOutputCallback *theCallback) = 0;
|
|
virtual HRESULT GetBufferedVideoFrameCount (/* out */ uint32_t *bufferedFrameCount) = 0;
|
|
|
|
/* Audio Output */
|
|
|
|
virtual HRESULT EnableAudioOutput (/* in */ BMDAudioSampleRate sampleRate, /* in */ BMDAudioSampleType sampleType, /* in */ uint32_t channelCount, /* in */ BMDAudioOutputStreamType streamType) = 0;
|
|
virtual HRESULT DisableAudioOutput (void) = 0;
|
|
|
|
virtual HRESULT WriteAudioSamplesSync (/* in */ void *buffer, /* in */ uint32_t sampleFrameCount, /* out */ uint32_t *sampleFramesWritten) = 0;
|
|
|
|
virtual HRESULT BeginAudioPreroll (void) = 0;
|
|
virtual HRESULT EndAudioPreroll (void) = 0;
|
|
virtual HRESULT ScheduleAudioSamples (/* in */ void *buffer, /* in */ uint32_t sampleFrameCount, /* in */ BMDTimeValue streamTime, /* in */ BMDTimeScale timeScale, /* out */ uint32_t *sampleFramesWritten) = 0;
|
|
|
|
virtual HRESULT GetBufferedAudioSampleFrameCount (/* out */ uint32_t *bufferedSampleFrameCount) = 0;
|
|
virtual HRESULT FlushBufferedAudioSamples (void) = 0;
|
|
|
|
virtual HRESULT SetAudioCallback (/* in */ IDeckLinkAudioOutputCallback *theCallback) = 0;
|
|
|
|
/* Output Control */
|
|
|
|
virtual HRESULT StartScheduledPlayback (/* in */ BMDTimeValue playbackStartTime, /* in */ BMDTimeScale timeScale, /* in */ double playbackSpeed) = 0;
|
|
virtual HRESULT StopScheduledPlayback (/* in */ BMDTimeValue stopPlaybackAtTime, /* out */ BMDTimeValue *actualStopTime, /* in */ BMDTimeScale timeScale) = 0;
|
|
virtual HRESULT IsScheduledPlaybackRunning (/* out */ bool *active) = 0;
|
|
virtual HRESULT GetScheduledStreamTime (/* in */ BMDTimeScale desiredTimeScale, /* out */ BMDTimeValue *streamTime, /* out */ double *playbackSpeed) = 0;
|
|
virtual HRESULT GetReferenceStatus (/* out */ BMDReferenceStatus *referenceStatus) = 0;
|
|
|
|
/* Hardware Timing */
|
|
|
|
virtual HRESULT GetHardwareReferenceClock (/* in */ BMDTimeScale desiredTimeScale, /* out */ BMDTimeValue *hardwareTime, /* out */ BMDTimeValue *timeInFrame, /* out */ BMDTimeValue *ticksPerFrame) = 0;
|
|
virtual HRESULT GetFrameCompletionReferenceTimestamp (/* in */ IDeckLinkVideoFrame *theFrame, /* in */ BMDTimeScale desiredTimeScale, /* out */ BMDTimeValue *frameCompletionTimestamp) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkOutput () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkInput - Created by QueryInterface from IDeckLink. */
|
|
|
|
class BMD_PUBLIC IDeckLinkInput : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT DoesSupportVideoMode (/* in */ BMDDisplayMode displayMode, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDVideoInputFlags flags, /* out */ BMDDisplayModeSupport *result, /* out */ IDeckLinkDisplayMode **resultDisplayMode) = 0;
|
|
virtual HRESULT GetDisplayModeIterator (/* out */ IDeckLinkDisplayModeIterator **iterator) = 0;
|
|
|
|
virtual HRESULT SetScreenPreviewCallback (/* in */ IDeckLinkScreenPreviewCallback *previewCallback) = 0;
|
|
|
|
/* Video Input */
|
|
|
|
virtual HRESULT EnableVideoInput (/* in */ BMDDisplayMode displayMode, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDVideoInputFlags flags) = 0;
|
|
virtual HRESULT DisableVideoInput (void) = 0;
|
|
virtual HRESULT GetAvailableVideoFrameCount (/* out */ uint32_t *availableFrameCount) = 0;
|
|
virtual HRESULT SetVideoInputFrameMemoryAllocator (/* in */ IDeckLinkMemoryAllocator *theAllocator) = 0;
|
|
|
|
/* Audio Input */
|
|
|
|
virtual HRESULT EnableAudioInput (/* in */ BMDAudioSampleRate sampleRate, /* in */ BMDAudioSampleType sampleType, /* in */ uint32_t channelCount) = 0;
|
|
virtual HRESULT DisableAudioInput (void) = 0;
|
|
virtual HRESULT GetAvailableAudioSampleFrameCount (/* out */ uint32_t *availableSampleFrameCount) = 0;
|
|
|
|
/* Input Control */
|
|
|
|
virtual HRESULT StartStreams (void) = 0;
|
|
virtual HRESULT StopStreams (void) = 0;
|
|
virtual HRESULT PauseStreams (void) = 0;
|
|
virtual HRESULT FlushStreams (void) = 0;
|
|
virtual HRESULT SetCallback (/* in */ IDeckLinkInputCallback *theCallback) = 0;
|
|
|
|
/* Hardware Timing */
|
|
|
|
virtual HRESULT GetHardwareReferenceClock (/* in */ BMDTimeScale desiredTimeScale, /* out */ BMDTimeValue *hardwareTime, /* out */ BMDTimeValue *timeInFrame, /* out */ BMDTimeValue *ticksPerFrame) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkInput () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkHDMIInputEDID - Created by QueryInterface from IDeckLink. Releasing all references will restore EDID to default */
|
|
|
|
class BMD_PUBLIC IDeckLinkHDMIInputEDID : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT SetInt (/* in */ BMDDeckLinkHDMIInputEDIDID cfgID, /* in */ int64_t value) = 0;
|
|
virtual HRESULT GetInt (/* in */ BMDDeckLinkHDMIInputEDIDID cfgID, /* out */ int64_t *value) = 0;
|
|
virtual HRESULT WriteToEDID (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkHDMIInputEDID () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkEncoderInput - Created by QueryInterface from IDeckLink. */
|
|
|
|
class BMD_PUBLIC IDeckLinkEncoderInput : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT DoesSupportVideoMode (/* in */ BMDDisplayMode displayMode, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDVideoInputFlags flags, /* out */ BMDDisplayModeSupport *result, /* out */ IDeckLinkDisplayMode **resultDisplayMode) = 0;
|
|
virtual HRESULT GetDisplayModeIterator (/* out */ IDeckLinkDisplayModeIterator **iterator) = 0;
|
|
|
|
/* Video Input */
|
|
|
|
virtual HRESULT EnableVideoInput (/* in */ BMDDisplayMode displayMode, /* in */ BMDPixelFormat pixelFormat, /* in */ BMDVideoInputFlags flags) = 0;
|
|
virtual HRESULT DisableVideoInput (void) = 0;
|
|
virtual HRESULT GetAvailablePacketsCount (/* out */ uint32_t *availablePacketsCount) = 0;
|
|
virtual HRESULT SetMemoryAllocator (/* in */ IDeckLinkMemoryAllocator *theAllocator) = 0;
|
|
|
|
/* Audio Input */
|
|
|
|
virtual HRESULT EnableAudioInput (/* in */ BMDAudioFormat audioFormat, /* in */ BMDAudioSampleRate sampleRate, /* in */ BMDAudioSampleType sampleType, /* in */ uint32_t channelCount) = 0;
|
|
virtual HRESULT DisableAudioInput (void) = 0;
|
|
virtual HRESULT GetAvailableAudioSampleFrameCount (/* out */ uint32_t *availableSampleFrameCount) = 0;
|
|
|
|
/* Input Control */
|
|
|
|
virtual HRESULT StartStreams (void) = 0;
|
|
virtual HRESULT StopStreams (void) = 0;
|
|
virtual HRESULT PauseStreams (void) = 0;
|
|
virtual HRESULT FlushStreams (void) = 0;
|
|
virtual HRESULT SetCallback (/* in */ IDeckLinkEncoderInputCallback *theCallback) = 0;
|
|
|
|
/* Hardware Timing */
|
|
|
|
virtual HRESULT GetHardwareReferenceClock (/* in */ BMDTimeScale desiredTimeScale, /* out */ BMDTimeValue *hardwareTime, /* out */ BMDTimeValue *timeInFrame, /* out */ BMDTimeValue *ticksPerFrame) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkEncoderInput () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoFrame - Interface to encapsulate a video frame; can be caller-implemented. */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoFrame : public IUnknown
|
|
{
|
|
public:
|
|
virtual long GetWidth (void) = 0;
|
|
virtual long GetHeight (void) = 0;
|
|
virtual long GetRowBytes (void) = 0;
|
|
virtual BMDPixelFormat GetPixelFormat (void) = 0;
|
|
virtual BMDFrameFlags GetFlags (void) = 0;
|
|
virtual HRESULT GetBytes (/* out */ void **buffer) = 0;
|
|
|
|
virtual HRESULT GetTimecode (/* in */ BMDTimecodeFormat format, /* out */ IDeckLinkTimecode **timecode) = 0;
|
|
virtual HRESULT GetAncillaryData (/* out */ IDeckLinkVideoFrameAncillary **ancillary) = 0; // Use of IDeckLinkVideoFrameAncillaryPackets is preferred
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoFrame () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkMutableVideoFrame - Created by IDeckLinkOutput::CreateVideoFrame. */
|
|
|
|
class BMD_PUBLIC IDeckLinkMutableVideoFrame : public IDeckLinkVideoFrame
|
|
{
|
|
public:
|
|
virtual HRESULT SetFlags (/* in */ BMDFrameFlags newFlags) = 0;
|
|
|
|
virtual HRESULT SetTimecode (/* in */ BMDTimecodeFormat format, /* in */ IDeckLinkTimecode *timecode) = 0;
|
|
virtual HRESULT SetTimecodeFromComponents (/* in */ BMDTimecodeFormat format, /* in */ uint8_t hours, /* in */ uint8_t minutes, /* in */ uint8_t seconds, /* in */ uint8_t frames, /* in */ BMDTimecodeFlags flags) = 0;
|
|
virtual HRESULT SetAncillaryData (/* in */ IDeckLinkVideoFrameAncillary *ancillary) = 0;
|
|
virtual HRESULT SetTimecodeUserBits (/* in */ BMDTimecodeFormat format, /* in */ BMDTimecodeUserBits userBits) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkMutableVideoFrame () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoFrame3DExtensions - Optional interface implemented on IDeckLinkVideoFrame to support 3D frames */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoFrame3DExtensions : public IUnknown
|
|
{
|
|
public:
|
|
virtual BMDVideo3DPackingFormat Get3DPackingFormat (void) = 0;
|
|
virtual HRESULT GetFrameForRightEye (/* out */ IDeckLinkVideoFrame* *rightEyeFrame) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoFrame3DExtensions () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoFrameMetadataExtensions - Optional interface implemented on IDeckLinkVideoFrame to support frame metadata such as HDMI HDR information */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoFrameMetadataExtensions : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetInt (/* in */ BMDDeckLinkFrameMetadataID metadataID, /* out */ int64_t *value) = 0;
|
|
virtual HRESULT GetFloat (/* in */ BMDDeckLinkFrameMetadataID metadataID, /* out */ double *value) = 0;
|
|
virtual HRESULT GetFlag (/* in */ BMDDeckLinkFrameMetadataID metadataID, /* out */ bool* value) = 0;
|
|
virtual HRESULT GetString (/* in */ BMDDeckLinkFrameMetadataID metadataID, /* out */ CFStringRef *value) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoFrameMetadataExtensions () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoInputFrame - Provided by the IDeckLinkVideoInput frame arrival callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoInputFrame : public IDeckLinkVideoFrame
|
|
{
|
|
public:
|
|
virtual HRESULT GetStreamTime (/* out */ BMDTimeValue *frameTime, /* out */ BMDTimeValue *frameDuration, /* in */ BMDTimeScale timeScale) = 0;
|
|
virtual HRESULT GetHardwareReferenceTimestamp (/* in */ BMDTimeScale timeScale, /* out */ BMDTimeValue *frameTime, /* out */ BMDTimeValue *frameDuration) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoInputFrame () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkAncillaryPacket - On output, user needs to implement this interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkAncillaryPacket : public IUnknown
|
|
{
|
|
public:
|
|
|
|
virtual HRESULT GetBytes (/* in */ BMDAncillaryPacketFormat format /* For output, only one format need be offered */, /* out */ const void **data /* Optional */, /* out */ uint32_t *size /* Optional */) = 0;
|
|
virtual uint8_t GetDID (void) = 0;
|
|
virtual uint8_t GetSDID (void) = 0;
|
|
virtual uint32_t GetLineNumber (void) = 0; // On output, zero is auto
|
|
virtual uint8_t GetDataStreamIndex (void) = 0; // Usually zero. Can only be 1 if non-SD and the first data stream is completely full
|
|
|
|
protected:
|
|
virtual ~IDeckLinkAncillaryPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkAncillaryPacketIterator - Enumerates ancillary packets */
|
|
|
|
class BMD_PUBLIC IDeckLinkAncillaryPacketIterator : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Next (/* out */ IDeckLinkAncillaryPacket **packet) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkAncillaryPacketIterator () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoFrameAncillaryPackets - Obtained through QueryInterface() on an IDeckLinkVideoFrame object. */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoFrameAncillaryPackets : public IUnknown
|
|
{
|
|
public:
|
|
|
|
virtual HRESULT GetPacketIterator (/* out */ IDeckLinkAncillaryPacketIterator **iterator) = 0;
|
|
virtual HRESULT GetFirstPacketByID (/* in */ uint8_t DID, /* in */ uint8_t SDID, /* out */ IDeckLinkAncillaryPacket **packet) = 0;
|
|
virtual HRESULT AttachPacket (/* in */ IDeckLinkAncillaryPacket *packet) = 0; // Implement IDeckLinkAncillaryPacket to output your own
|
|
virtual HRESULT DetachPacket (/* in */ IDeckLinkAncillaryPacket *packet) = 0;
|
|
virtual HRESULT DetachAllPackets (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoFrameAncillaryPackets () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoFrameAncillary - Use of IDeckLinkVideoFrameAncillaryPackets is preferred. Obtained through QueryInterface() on an IDeckLinkVideoFrame object. */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoFrameAncillary : public IUnknown
|
|
{
|
|
public:
|
|
|
|
virtual HRESULT GetBufferForVerticalBlankingLine (/* in */ uint32_t lineNumber, /* out */ void **buffer) = 0; // Pixels/rowbytes is same as display mode, except for above HD where it's 1920 pixels for UHD modes and 2048 pixels for DCI modes
|
|
virtual BMDPixelFormat GetPixelFormat (void) = 0;
|
|
virtual BMDDisplayMode GetDisplayMode (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoFrameAncillary () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkEncoderPacket - Interface to encapsulate an encoded packet. */
|
|
|
|
class BMD_PUBLIC IDeckLinkEncoderPacket : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetBytes (/* out */ void **buffer) = 0;
|
|
virtual long GetSize (void) = 0;
|
|
virtual HRESULT GetStreamTime (/* out */ BMDTimeValue *frameTime, /* in */ BMDTimeScale timeScale) = 0;
|
|
virtual BMDPacketType GetPacketType (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkEncoderPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkEncoderVideoPacket - Provided by the IDeckLinkEncoderInput video packet arrival callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkEncoderVideoPacket : public IDeckLinkEncoderPacket
|
|
{
|
|
public:
|
|
virtual BMDPixelFormat GetPixelFormat (void) = 0;
|
|
virtual HRESULT GetHardwareReferenceTimestamp (/* in */ BMDTimeScale timeScale, /* out */ BMDTimeValue *frameTime, /* out */ BMDTimeValue *frameDuration) = 0;
|
|
|
|
virtual HRESULT GetTimecode (/* in */ BMDTimecodeFormat format, /* out */ IDeckLinkTimecode **timecode) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkEncoderVideoPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkEncoderAudioPacket - Provided by the IDeckLinkEncoderInput audio packet arrival callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkEncoderAudioPacket : public IDeckLinkEncoderPacket
|
|
{
|
|
public:
|
|
virtual BMDAudioFormat GetAudioFormat (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkEncoderAudioPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkH265NALPacket - Obtained through QueryInterface() on an IDeckLinkEncoderVideoPacket object */
|
|
|
|
class BMD_PUBLIC IDeckLinkH265NALPacket : public IDeckLinkEncoderVideoPacket
|
|
{
|
|
public:
|
|
virtual HRESULT GetUnitType (/* out */ uint8_t *unitType) = 0;
|
|
virtual HRESULT GetBytesNoPrefix (/* out */ void **buffer) = 0;
|
|
virtual long GetSizeNoPrefix (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkH265NALPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkAudioInputPacket - Provided by the IDeckLinkInput callback. */
|
|
|
|
class BMD_PUBLIC IDeckLinkAudioInputPacket : public IUnknown
|
|
{
|
|
public:
|
|
virtual long GetSampleFrameCount (void) = 0;
|
|
virtual HRESULT GetBytes (/* out */ void **buffer) = 0;
|
|
virtual HRESULT GetPacketTime (/* out */ BMDTimeValue *packetTime, /* in */ BMDTimeScale timeScale) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkAudioInputPacket () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkScreenPreviewCallback - Screen preview callback */
|
|
|
|
class BMD_PUBLIC IDeckLinkScreenPreviewCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT DrawFrame (/* in */ IDeckLinkVideoFrame *theFrame) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkScreenPreviewCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkCocoaScreenPreviewCallback - Screen preview callback for Cocoa-based applications */
|
|
|
|
class BMD_PUBLIC IDeckLinkCocoaScreenPreviewCallback : public IDeckLinkScreenPreviewCallback
|
|
{
|
|
public:
|
|
|
|
protected:
|
|
virtual ~IDeckLinkCocoaScreenPreviewCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkGLScreenPreviewHelper - Created with CoCreateInstance(). */
|
|
|
|
class BMD_PUBLIC IDeckLinkGLScreenPreviewHelper : public IUnknown
|
|
{
|
|
public:
|
|
|
|
/* Methods must be called with OpenGL context set */
|
|
|
|
virtual HRESULT InitializeGL (void) = 0;
|
|
virtual HRESULT PaintGL (void) = 0;
|
|
virtual HRESULT SetFrame (/* in */ IDeckLinkVideoFrame *theFrame) = 0;
|
|
virtual HRESULT Set3DPreviewFormat (/* in */ BMD3DPreviewFormat previewFormat) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkGLScreenPreviewHelper () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkNotificationCallback - DeckLink Notification Callback Interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkNotificationCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Notify (/* in */ BMDNotifications topic, /* in */ uint64_t param1, /* in */ uint64_t param2) = 0;
|
|
};
|
|
|
|
/* Interface IDeckLinkNotification - DeckLink Notification interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkNotification : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Subscribe (/* in */ BMDNotifications topic, /* in */ IDeckLinkNotificationCallback *theCallback) = 0;
|
|
virtual HRESULT Unsubscribe (/* in */ BMDNotifications topic, /* in */ IDeckLinkNotificationCallback *theCallback) = 0;
|
|
};
|
|
|
|
/* Interface IDeckLinkAttributes - DeckLink Attribute interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkAttributes : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetFlag (/* in */ BMDDeckLinkAttributeID cfgID, /* out */ bool *value) = 0;
|
|
virtual HRESULT GetInt (/* in */ BMDDeckLinkAttributeID cfgID, /* out */ int64_t *value) = 0;
|
|
virtual HRESULT GetFloat (/* in */ BMDDeckLinkAttributeID cfgID, /* out */ double *value) = 0;
|
|
virtual HRESULT GetString (/* in */ BMDDeckLinkAttributeID cfgID, /* out */ CFStringRef *value) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkAttributes () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkStatus - DeckLink Status interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkStatus : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT GetFlag (/* in */ BMDDeckLinkStatusID statusID, /* out */ bool *value) = 0;
|
|
virtual HRESULT GetInt (/* in */ BMDDeckLinkStatusID statusID, /* out */ int64_t *value) = 0;
|
|
virtual HRESULT GetFloat (/* in */ BMDDeckLinkStatusID statusID, /* out */ double *value) = 0;
|
|
virtual HRESULT GetString (/* in */ BMDDeckLinkStatusID statusID, /* out */ CFStringRef *value) = 0;
|
|
virtual HRESULT GetBytes (/* in */ BMDDeckLinkStatusID statusID, /* out */ void *buffer, /* in, out */ uint32_t *bufferSize) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkStatus () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkKeyer - DeckLink Keyer interface */
|
|
|
|
class BMD_PUBLIC IDeckLinkKeyer : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT Enable (/* in */ bool isExternal) = 0;
|
|
virtual HRESULT SetLevel (/* in */ uint8_t level) = 0;
|
|
virtual HRESULT RampUp (/* in */ uint32_t numberOfFrames) = 0;
|
|
virtual HRESULT RampDown (/* in */ uint32_t numberOfFrames) = 0;
|
|
virtual HRESULT Disable (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkKeyer () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkVideoConversion - Created with CoCreateInstance(). */
|
|
|
|
class BMD_PUBLIC IDeckLinkVideoConversion : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT ConvertFrame (/* in */ IDeckLinkVideoFrame* srcFrame, /* in */ IDeckLinkVideoFrame* dstFrame) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkVideoConversion () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkDeviceNotificationCallback - DeckLink device arrival/removal notification callbacks */
|
|
|
|
class BMD_PUBLIC IDeckLinkDeviceNotificationCallback : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT DeckLinkDeviceArrived (/* in */ IDeckLink* deckLinkDevice) = 0;
|
|
virtual HRESULT DeckLinkDeviceRemoved (/* in */ IDeckLink* deckLinkDevice) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkDeviceNotificationCallback () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Interface IDeckLinkDiscovery - DeckLink device discovery */
|
|
|
|
class BMD_PUBLIC IDeckLinkDiscovery : public IUnknown
|
|
{
|
|
public:
|
|
virtual HRESULT InstallDeviceNotifications (/* in */ IDeckLinkDeviceNotificationCallback* deviceNotificationCallback) = 0;
|
|
virtual HRESULT UninstallDeviceNotifications (void) = 0;
|
|
|
|
protected:
|
|
virtual ~IDeckLinkDiscovery () {} // call Release method to drop reference count
|
|
};
|
|
|
|
/* Functions */
|
|
|
|
extern "C" {
|
|
|
|
IDeckLinkIterator* BMD_PUBLIC CreateDeckLinkIteratorInstance (void);
|
|
IDeckLinkDiscovery* BMD_PUBLIC CreateDeckLinkDiscoveryInstance (void);
|
|
IDeckLinkAPIInformation* BMD_PUBLIC CreateDeckLinkAPIInformationInstance (void);
|
|
IDeckLinkGLScreenPreviewHelper* BMD_PUBLIC CreateOpenGLScreenPreviewHelper (void);
|
|
IDeckLinkCocoaScreenPreviewCallback* BMD_PUBLIC CreateCocoaScreenPreview (void* /* (NSView*) */ parentView);
|
|
IDeckLinkVideoConversion* BMD_PUBLIC CreateVideoConversionInstance (void);
|
|
IDeckLinkVideoFrameAncillaryPackets* BMD_PUBLIC CreateVideoFrameAncillaryPacketsInstance (void); // For use when creating a custom IDeckLinkVideoFrame without wrapping IDeckLinkOutput::CreateVideoFrame
|
|
|
|
}
|
|
|
|
|
|
#endif // defined(__cplusplus)
|
|
#endif /* defined(BMD_DECKLINKAPI_H) */
|