Medialooks Knowledge Base Support Center

Contact Us

MRenderer object properties

The properties are stored in the system registry:

[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MRenderer]

and can be set with the PropsSet method. Please refer to this article about prefixes for properties.

 Name
 Default value
 Description
" audio_channels "
" "
Default audio channels configuration. See audio management for details.
" audio_gain "
" "
Default audio gain configuration. See audio management for details.
" imaudio.enabled "
" false "
Enables IMAudio interface for the object. If disabled ("false") then you can manage audio only through properties.
" aja.new_api "
" true "
Enables a new API mode for AJA boards. It requires a new drivers version for AJA devices that are located by default at:
c:\Program Files (x86)\Medialooks\MPlatform SDK\Bin\x86\AJA\Driver\dpinst.exe
" statistics.extended "
" stat "
Sets a prefix for gathering statistics of an MRenderer object after all the conversion and changes.
" statistics.output "
" stat_out "
Sets a prefix for gathering statistics of the output signal itself.
" rate_control "
"1"
Once set to "1", the MRenderer object controls playback rate (playback doesn't continue until the MRenderer doesn't return an event that a frame is sent to an output).
" experimental.external_process "
" false "
Makes output happen in a separated MServer.exe process. Experimental property.
" experimental.low_delay "
" true "
Enables a low delay mode to reduce overall delay. Experimental property.
" experimental.direct_out "
" true "
Enables direct out mode in which a frame sends to an output without any extra processing.
" optimization.no_copy "
" true "
Once enabled, an MRenderer object doesn't copy a frame before output it to a device.
" optimization.own_buffer "
" true "
Once enabled, an MRenderer 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.
" 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
" max_buffers "
"4"
Sets the maximal amount of buffered frames.
" output.time_sync "
" false "
Enables time synchronization for output video.
" 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.
" 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.
" timecode_format "
" auto "
Sets timecode format.
Possible values:
  • "auto"
  • "rp188-vitc"
  • "rp188-vitc2"
  • "rp188-ltc"
  • "vitc"
  • "vitc-2"
  • "serial"
  • "disabled"
" on_frame.sync "
" true "
Makes OnFrame and OnFrameSafe events synchronous, so frame grabbing process won't continue until OnFrame event isn't over.
" on_frame.data "
" false "
Enables objects of OnFrame and OnFrameSafe events to contain MFrame data.
" on_event.sync "
" false "
Makes OnEvent and OnEventSafe events synchronous, so frame grabbing process won't continue until OnFrame event isn't over.
" events.use_window "
" true "
Use events (OnFrame, OnEvent, OnEventSafe and OnFrameSafe) in the thread of your application. If you use a service or an application without windows, then disable this mode.
" keying.clamp_16_235 "
" false "
Enables conversion of 0-255 colors into 16-235 range for external keying.
" extra_devices.clsids "
" "
CLSID of external devices.
" overlay_rms "
" false "
Enables RMS overlay.
" overlay_rms.pos "
" 0.12 "
Specifies RMS overlay position relative to the left side.
" overlay_rms.color "
" yellow "
Specifies RMS overlay color.
" overlay_waveform "
" false "
Enables waveform overlay.
" crop "
" "
Sets default crop configuration.
" mirror "
" "
Sets default mirror parameter.