- 09 Sep 2024
- 2 Minutes to read
- Print
- DarkLight
- PDF
BlackMagic Decklink Capture
- Updated on 09 Sep 2024
- 2 Minutes to read
- Print
- DarkLight
- PDF
Device capture/BlackMagic Decklink Capture
For capturing external live video sources, Composer provides a BlackMagic Decklink Capture input.
Blackmagic Decklink Capture v3 - Supports both Windows and Linux OS. Support for multiple Decklink capture cards.
The two alternatives Blackmagic Decklink Capture v2, Blackmagic Decklink Capture (Windows Only) have been deprecated. However, if you have old projects using these versions of the Decklink input, they will still work and also show up in the list of added inputs. We recommend upgrading them to Blackmagic Decklink Capture version 3.
Input channel - selected input channel
Device name - the name of the selected device
Start playing on startup - check this option to enable capture at application launch. For autostart of inputs, the Autostart inputs options also must be activated on the application level (See the chapter Runtime Performance)
Use host pinned memory - Used pinned memory will speed up the capture performance.
Black video detector:
Warn on black video input - Checkbox for enable/disable Black video detector. Will generate a warning if the below criteria are fulfilled.
Black video ratio warning threshold (%) - Input field 90-100%. Generates a warning if black pixels ratio in video is above configured value.
BlackVideoFrameCountThreshold - Number of frames for detecting black video.
Commands:
Start capture - starts the capture
Stop capture - stops capture
Pause/Unpause - Pause/Unpause capture
Playback state - current playback state
Performance and properties:
Number of captured frames - the total number of captured frames
Number of frames played back - current played frames
Last autodetect format change - if the component can detect the incoming video format, the name of the video format will be displayed
Number of automatic restarts performed - the total number of automatic restarts
Number of black pixels last frame - the total number of black pixels found in the last frame captured.
Number of black pixels (%) last frame - the percentage of black pixels found in the last frame captured.
Last black pixel event - displays information on the last black pixel event. Example:
Optional TAGS (space separated)
TAGS - Add a "tag" that can be used in the input smart search function. It is possible to add several tags by separating them by a SPACE char.
Resolution:
Width - captured video width (pixels)
Height - captured video height (pixels)
* Debug properties. Only visible if "Show debug properties" are enabled in Settings.
Product Compatibility
The following capture cards are currently supported:
BlackMagicDesign Decklink Duo 2
BlackMagicDesign Decklink Quad 2
BlackMagicDesign DeckLink Quad HDMI Recorder (Capture v3)
BlackMagicDesign DeckLink 8K (Capture v3)
Other Decklink versions might work but are not tested or officially supported.
Using multiple capture cards is only supported by the input "Blackmagic Decklink Capture v3".
Important!
The input frame rate from your camera should be the same as your project frame rate. Otherwise, there is a risk of audio not being in sync.
Recommendation!
Using too many Blackmagic Decklink inputs simultaneously can impact the performance of Composer.
Hint!
If you are uncertain about the incoming video format, use the Blackmagic Media Express to detect the video format.
For more information and driver updates, please visit https://www.blackmagicdesign.com/support/.