4K Video Settings - CESNET/UltraGrid GitHub Wiki

Note: Following text applies mostly to tiles 4K video (except the Quicktime part). Untiled 4K doesn't require any special handling and thus is not described in details.

You can use tiled video in following drivers with appropriate card:

• decklink (eg. DeckLink Quad)
• quad (Linsys Quad, no longer present)
• quicktime (eg. AJA Kona 3G, Decklink Quad) - for DeckLinks it is recommended to use decklink driver instead
• aggregate - can aggregate arbitrary capture card

Sending tiled 4K video (quad) - use -t quad:<card_indices>:<mode> with input taken from left-top to right-bottom edge in increasing order:

uv -t quad:0,1,2,3:10 -m 8500 <receiver>

Note: Display is not implemented for Linsys.

General usage

-t decklink:<device_index(indices)>:<mode>:<colorspace>

or (newer UG)

-t decklink:devices=<indices> (all devices must be however in the same mode)

Sending tiled 4K (or more exactly SuperHD) with all inputs in mode "6", 8-bit YCbCr:

uv -t decklink:0,1,3,4:6:UYVY -m 8500 <receiverIP>

• for receiving 4 tile arranged in 2x2 grid, you will use:

uv -d decklink:0,1,2,3 -M tiled-4K <senderIP>

• Receiving native (non-tiled) 4K frames (aka captured with AJA Kona 3G) with DeckLink Quad

uv -d decklink:0,1,2,3 -p split:2:2 <senderIP> # and no '-M tiled-4K' (!)

Please note that the -M (mode) option needs to be entered solely on receiver. The rule of thumb is that that option simply says which arrangement is send by sender (thus tiled 4K send by DeckLink Quad needs this argument). On the other hand, video send by AJA Kona 3G is monolite 4K frame, so receiving DeckLink Quad takes '-p split:2:2'.

• native display using DeckLink 4K Extreme

uv -d decklink:single-link

Note that quite unintuitively, the DeckLink 4K Extreme does NOT output 6G-SDI by default and requires specifying 3G option in order to do that.

QuickTime driver allows receiving of tiled/untiled 4K. For 4K capture capabilities, please use DeckLink Driver.

(see '-t qucktime:help' for details) AJA Kona 3G - exactly as with normal video, only select 4K/SuperHD mode:

uv -t quicktime:<card>:<mode>:<"compression"> -m 8500 <senderIP>

eg.

uv -t quicktime:1:1:13 -m 8500 <senderIP>

• receiving non-tiled 4K video (AJA Kona 3G - make sure you have 4K firmware loaded):

uv -d quicktime:65549 <senderIP>

• receiving tiled 4K video with AJA Kona 3G

uv -M tiled-4K -d quicktime:65549 <senderIP>

where 65549 is QT's card index obeyed by calling uv -d quicktime:help

Note: For DeckLink card we recommend to use DeckLink API instead of QuickTime, although both work (QuickTime capture doesn't currently support tiled video).

uv -d sdl -M tiled-4K

uv -d gl -M tiled-4K

uv -d sage -M tiled-4K

If using SDL under Mac OS X, it is recommended to run binary from application bundle. This way of running UltraGrid is recommended to use everytime:

./uv.app/Contents/MacOS/uv -d sdl -M tiled-4K