Capabilities output format - CESNET/UltraGrid GitHub Wiki

Output of --capabilities parameter to command line has following syntax (stdout). Not tagged lines must be ignored.

New

The format will gradually change for all devices. However, the bellow applies now only for video capture, which has now format eg.:

[capability][capture][v1] {"device": "screen", "name": "Screen capture", "modes": {}}
[capability][capture][v1] {"device": "testcard", "name": "Testing signal", "modes": {"1920:1080:30:UYVY": "1080@30p YCbCr 4:2:2 8-bit", "1920:1080:30:v210": "1080@30p YCbCr 4:2:2 10-bit", "1920:1080:60i:UYVY": "1080@60i YCbCr 4:2:2 8-bit", "1920:1080:25:UYVY": "1080@25p YCbCr 4:2:2 8-bit", "1920:1080:50i:UYVY": "1080@50i YCbCr 4:2:2 8-bit", "1280:720:60:UYVY": "720@60p YCbCr 4:2:2 8-bit", "1280:720:60:RGB": "720@60p RGB 4:4:4 8-bit", "3840:2160:24:UYVY": "3840@24p YCbCr 4:2:2 8-bit", "3840:2160:60:RGB": "3840@60p RGB 4:4:4 8-bit", "640:480:15:RGB": "VGA - 15 FPS RGB"}}

After the tags, the record is a valid JSON with attributes: device, name and modes. The attribute modes is further an object with keys with format string and values with the format name.

Other modules use now the old syntax.

Old

Older format of output is:

 <UltraGrid headers>
 Compressions:
 (...)
 Capturers:
 (...)
 Exit

If -t parameter provided, UltraGrid tries to detect video signal and adjusts compress bitrates. otherwise, bitrate is set to zero. Syntax of tuples is following:

Compression:

 (config_string; visual_quality[0-100]; bitrate[bps]; enc_latency[ms]; enc_cpu_cores[units], encs_gpu[gflops]; dec_latency[ms], dec_cpu_cores[units], dec_gpu[gflops])

Capturer:

(config_string:user_name)