Medialooks Knowledge Base Support Center

Contact Us

Blackmagic Design devices properties

Input properties

The properties are specific for MLive and MFLive objects.

 Name
 Default value
 Description
" bmd.locked_video "
" true "
Once enabled, source video is locked while it is processed. Required for input stability.
" bmd.hw_time "
" false "
Once enabled, uses hardware timer to calculate frame times. If disabled, frame time is calculated based on input audio samples.
" bmd.10bit "
" false "
Enables 10bit video input.
" bmd.444 "
" false "
Once enabled, 10bit video is processed in RGB32 color space. Otherwise, UYVY is used for SD format and HDYC is used for HD format.
" bmd.no_copy "
" true "
Once enabled, source frames themselves are allocated. If disabled, source frames are copied before allocation.
" bmd.persist_config "
" false "
Once enabled, the settings of a device are used as default preferences.
" bmd.max_allocated_frames "
"64"
Sets the maximal amount of allocated frames.
" bmd.duplex_mode "
" custom "
Specifies duplex mode for BMD devices.
Possible values:
  • "custom"
  • "full"
  • "half"
" vanc.capture "
" false "
Enables capturing VANC data with an input signal.
" vanc.capture_cc "
" false "
Enables capturing Closed Captions data.
" vanc.capture_anc "
" false "
Enables capturing ANC data.
" vanc.lines "
" "
Specifies lines to read VANC data from.

Output properties

The properties are specific for MRenderer and MFRenderer objects

 Name
 Default value
 Description
" experimental.low_delay "
" true "
Enables low delay mode. Experimental property.
" experimental.direct_out "
" true "
Once enabled, a device sends a frame to output without any processing.
" experimental.direct_audio_thread "
" false "
Once enabled, audio data is sent to output in a separated thread.
" optimization.no_copy "
" true "
Once enabled, output frames themselves are allocated. If disabled, source frames are copied before allocation.
" optimization.own_buffer "
" true "
Once enabled, the object uses its own buffer for frame processing.
" cc_output "
"7"
Sets default mode for Closed Captions output.
Possible values:
  • 1 - only Line 21 data is used. Works for NTSC format only. "output.10bit" should be set to "false".
  • 2 - only SDI 608 ANC data. Works for any video formats. "output.10bit" should be set to "true".
  • 3 - only 608 CDP data (Line 21 and 608 ANC). Works for any video formats.
  • 4 - only SDI 708 and 608 CDP data. Works for any video formats. "output.10bit" should be set to "true".
  • 5 - only SDI 708 data. Works for any video formats. "output.10bit" should be set to "true".
  • 7 - default - output all types of closed captions data.
  • 15 - always display VBI data (even if there is no such data).
" bypass.wait_frames "
"30"
Sets a number of frames for Bypass Relay feature.
" output.timecode "
" true "
Once enabled, sends timecode with output frames
" cc_line_sdi "
"9"
Sets a line for SDI Closed Captions output.
" cc_offset_dword "
"0"
Sets a dword offset for Closed Captions output.
" output.10bit "
" false "
Enables 10bit conversion for output video.
" file.buffers "
"1"
Sets amount of buffered frames for output from file sources. By setting it to 0 you reduce overall delay.
" live.buffers_min "
"1"
Sets a minimal number of buffered frames for output from live sources.
" live.buffers_max "
"3"
Sets a maximal number of buffered frames for output from live sources.
" device.init_first "
" true "
Once enabled, the 1st available output device is initialized the moment you create an instance of an object.
" output.priority "
"15"
Sets priority of output thread. Possible values: range between -2 and 15.
" scaling_quality "
" auto "
Sets scaling quality for video.
Possible values:
  • auto - automatically detects the best suitable quality
  • 2 - poor scaling but low performance
  • 8 - good scaling and acceptable performance
  • 18 - best scaling and high performance
" output.copy_vanc "
"2"
Sets a mode to copy VANC data.
Possible values:
  • 0 - don't copy the data
  • 1 - copy VANC data before closed captions data's been processed
  • 2 - copy VANC data after closed captions data's been processed
" output.anc_packets "
" true "
Once enabled, an MRenderer object uses packets with ANC data for output.
" timecode_format "
" auto "
Sets timecode format.
Possible values:
  • "auto"
  • "rp188-vitc"
  • "rp188-vitc2"
  • "rp188-ltc"
  • "vitc"
  • "vitc-2"
  • "serial"
  • "disabled"
" bmd.persist_config "
" false "
Once enabled, the settings of a device are used as default preferences.
" crop "
" "
Sets default crop configuration.
" mirror "
" "
Sets default mirror configuration.
" rotate "
" "
Sets default rotate configuration.