Medialooks Knowledge Base Support Center

Contact Us

MLive object properties

The properties are stored in the system registry:

[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MLive]

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

 Name
 Default value
 Description
" 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
" imaudio.enabled "
" true "
Enables IMAudio interface for the object. If disabled ("false") then you can manage audio only through properties.
" statistics.extended "
" stat "
Sets a prefix for gathering statistics of an MLive object after all the conversion and changes.
" statistics.input "
" stat_in "
Sets a prefix for gathering statistics of the input signal itself.
" audio_channels "
" "
Default audio channels configuration. See audio management for details.
" audio_gain "
" "
Default audio gain configuration. See audio management for details.
" device.update_count "
" false "
Once enabled, a list of available devices is updated each time you call the DeviceGetCount method. It is useful when you work with devices that can be plugged in and out the system, for example, web cameras.
" device.set_first "
" false "
Once enabled, the 1st available device is set the moment you create an MLive object.
" directshow.supported "
"true"
Once enabled, DirectShow sources are available in MLive object.
" active_frc "
"2"
Sets active frame rate converter mode. Read about Active FRC more.
" on_frame.sync "
" false "
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.
" external_access "
" true "
Once enabled, you can use MLive objects in external applications through mp:// links and IMSenders.
" default_name "
" MLive "
Default name of the object. Call ObjectNameSet method before you start the object to change the name from code.
" deinterlace "
" true "
Enables deinterlacing mode.
" preview.audio_channels "
" "
Default audio channels configuration for preview.
" preview.type "
" direct3d "
Type of preview.
Possible values:
  • "dshow" - uses DirectShow-based preview
  • "direct3d" - uses DirectX-based preview. Requires DirectX to be installed on a system.
" preview.drop_frames "
" false "
Enables a mode in which frames can be dropped by preview object.
" preview.crop "
" 0.0%,0.0%,0.0%,0.0% "
Default crop configuration for preview only.
" preview.pull "
" false "
Enables pull-mode for preview.
" default_tracks "
"4"
Default amount of audio tracks.
" channels_per_track "
"0"
Default amount of channels per track.
" device_sharing "
" true "
Enables Device Sharing feature with which you can use the same device multiple times in different applications at the same time.
" no_signal.send_for_none "
" false "
Once enabled, MLive sends "No Video Signal" video for audio-only sources.
" no_signal.enabled "
" true "
Enables MLive to send "No Video Signal" video in case there is no signal (neither audio nor video) on a device.
" no_signal.picture "
" "
Specifies a custom image for "No Video Signal" video. You can use a path to a static image or a color in hex.
" no_signal.thread "
" true "
Makes "No Video Signal" video be processed in a separated thread.
" no_signal.max_wait_msec "
"160"
Sets maximal wait time in msec for "No Video Signal".
" internal.convert_frame "
" false "
Enables possibility to convert frames internally before the object is used in MPlaylist or MMixer (if disabled, it converts video to a format of the top object, e.g. MMixer).
" bmd.enabled "
" true "
Enables Blackmagic Design devices support.
" bmd.h264recorder "
" false "
Enables Blackmagic Design H.264 ProRecorder device to be supported.
" deltacast.enabled "
" true "
Enables Deltacast devices support.
" streamlabs.enabled "
" true "
Enables Stream Labs devices support.
" crop "
" "
Default crop configuration.
" mirror "
" "
Default mirror configuration.
" rotate "
" "
Default rotate configuration.
" overlay_rms "
" false "
Enables RMS overlay.
" overlay_rms.pos "
" 0.07 "
Specifies RMS overlay position relative to the left side.
" overlay_rms.color "
" blue "
Specifies RMS overlay color.
" overlay_waveform "
" false "
Enables waveform overlay.
" overlay_waveform.pos "
" -0.25 "
Specifies the waveform overlay position relative to the center.
" overlay_waveform.color "
" "
Specifies the waveform overlay color.
" ltc.enabled "
" false "
Enables LTC timecode by default.
" ltc.audio_device "
" "
Sets default LTC timecode device.
" ltc.sync "
" false "
Synchronizes LTC timecode with a timecode from the source.
" ext_audio.insert_to_channels "
" "
Default external audio channels configuration.
" ext_audio.enabled "
" true "
Enables externa audio sources usage.
" ext_audio.show_all_loopback "
" false "
Once enabled, all the possible Loopback sources are available. Once disabled, it uses only default sound card for PC Loopback mode.
" ext_audio.audio_only_msec "
"40"
Sets duration of an audio chunk for audio-only signal (so you use None as a video source)
" ext_audio.wasapi_buffer_msec "
"0"
Sets WASAPI buffer size in msec.
" ext_audio.master "
" false "
Sets external audio sources in "master" mode so times of external audio sources are used for synchronization.
" input.buffers "
"3"
Duration of the input buffer in frames.
" timecode.drop_frame "
" true "
Sets drop-frame mode for input timecode
" timecode.time_sync "
"0"
Synchronizea source timecode with the sytem time
" timecode.offset "
" "
Sets timecode offset, so the object calculates timecode from this point.
" debug.overlay_tc "
" false "
Overlays input timecode. Debug-only property.
" debug.overlay_time "
" false "
Overlays system time. Debug-only property.
" extra_devices.clsids "
" "
CLSID of external devices.
" pull_mode.output_type "
"2"
Specifies output type for enabled pull mode. 
" pull_mode.cycles_before_disconnect "
"10"
Sets number of cycles before preview is disconnected
" pull_mode.wait_till_get "
"200"
Sets duration in msec for a preview to wait till it gets a frame.
" mdelay.enabled "
" false "
Enables MDelay feature by default.
" mdelay.live_preview "
" false "
Specifies whether the live video is used for preview ("true") or the delayed one ("false").