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 |
|---|---|---|
| active_frc | dword:00000002 | Sets active frame rate converter mode. |
| audio.gain_normalization | false | Enables audio gain normalization |
| audio.lufs | false | Enables LUFS audio measurement |
| audio.lufs_channels | Sets audio channels for LUFS | |
| audio.lufs_state | Sets a state of LUFS measurements | |
| audio_channels | Default audio channels configuration. | |
| audio_gain | Default audio gain configuration. | |
| bmd.enabled | true | Enables Blackmagic Design devices |
| bmd.h264recorder | false | Enables Blackmagic Design H.264 ProRecorder device to be supported. |
| bmd.new_api | false | Enables a new (11.x) implementation of Decklink API. |
| channels_per_track | dword:00000000 | Default amount of channels per track. |
| crop | Default crop configuration. | |
| debug.overlay_tc | false | Overlays input timecode. Debug-only property. |
| debug.overlay_time | false | Overlays system time. Debug-only property. |
| default_name | MLive |
Default name of the object. If you need to change it, use the following approach: m_objLive.PropsSet("default_name", "new_name"); m_objLive.ObjectNameSet("new_name"); Note, that it's possible to change the name only before the object is started. If the object is running, stop it, and only then rename the object. |
| default_tracks | dword:00000004 | Default amount of audio tracks. |
| deinterlace | true | Enables deinterlacing mode. |
| deltacast.enabled | true | Enables Deltacast devices |
| device.set_first | false | Once enabled, the 1st available device is set the moment you create an MLive object. |
| 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.start_at_deviceset | false | Once enabled, a device is started the moment you set it with the DeviceSet method. |
| device_sharing | true | Enables Device Sharing feature with which you can use the same device multiple times in different applications at the same time. |
| directshow.supported | true | Once enabled, DirectShow sources are available in MLive object. |
| 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. |
| ext_audio.audio_only_msec | dword:0000000f | Sets duration of an audio chunk for audio-only signal (so you use None as a video source) |
| ext_audio.enabled | true | Enables external audio sources usage. |
| ext_audio.insert_to_channels | Default external audio channels configuration. | |
| ext_audio.master | false | Sets external audio sources in "master" mode so times of external audio sources are used for synchronization. |
| ext_audio.show_all_loopback | false | Once enabled, all the possible Loopback sources are available. Once disabled, it uses only the default sound card for PC Loopback mode. |
| ext_audio.wasapi_buffer_msec | dword:00000000 | Sets WASAPI buffer size in msec. |
| external_access | true | Once enabled, you can use MLive objects in external applications through mp:// links and IMSenders. |
| external_process | false | Process the instance of the object in a separated MServer.exe process |
| extra_devices.clsids | CLSID of external devices. | |
| force_conversion | false | Force video conversion, even if the selected format is the same as the original format |
| format.set_default_pixelformat | true | use the original pixel format for video conversion |
| gain_normalization.gating | -100.0 | the gating parameter for audio normalization |
| gain_normalization.loudness_type | rms | Type of audio normalization. Possible values: "rms", "m", "s", "i" |
| gain_normalization.target_i | -23.0 | Target gain level for audio normalization. |
| gpu.rgb_transform_matrix | The default color transformation matrix for the GPU mode | |
| imaudio.enabled | true | Enables IMAudio interface for the object. |
| input.buffers | dword:00000003 | Duration of the input buffer in frames. |
| 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). |
| ltc.audio_device | Sets default LTC timecode device. | |
| ltc.enabled | false | Enables LTC timecode by default. |
| ltc.sync | false | Synchronizes LTC timecode with timecode from the source. |
| mask.argb32_output | true | ARGB32 output for fill+mask mode |
| mdelay.enabled | false | Enables the MDelay feature by default. |
| mdelay.live_preview | false | Specifies whether the live video is used for preview ("true") or the delayed one ("false"). |
| mfconverter.enabled | true | enables internal conversion mechanism (not recommended to change) |
| mirror | Default mirror configuration. | |
| 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.force_animation |
false | Animation of a moving vertical bar is turned off by default |
| no_signal.max_wait_msec | dword:000000a0 | Sets maximal wait time in msec for "No Video Signal". |
| no_signal.picture |
Specifies a custom image for "No Video Signal" video.
|
|
| no_signal.send_for_none | false | Once enabled, MLive sends "No Video Signal" video for audio-only sources. |
| no_signal.thread | true | Makes "No Video Signal" video be processed in a separated thread. |
| object.hook_quit | true |
Enables a Windows hook for WM_QUIT to automatically call ObjectClose for MRenderer / MFRenderer when the application window is closing. Useful for apps with a window loop — ensures proper cleanup on exit. |
| on_event.sync | false | Makes OnEvent and OnEventSafe 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_frame.sync | false | Makes OnFrame and OnFrameSafe events synchronous, so frame grabbing process won't continue until OnFrame event isn't over. |
| overlay_rms | false | Enables RMS overlay. |
| overlay_rms.color | blue |
Specifies RMS overlay color. Possible values:
|
| overlay_rms.color_error | ||
| overlay_rms.color_nominal | ||
| overlay_rms.color_warning | ||
| overlay_rms.level_check | ||
| overlay_rms.pos | 0.07 | Specifies the relative vertical position of the RMS overlay. Available values are from 0.00 to 1.00. |
| overlay_waveform | false | Enables waveform overlay. |
| overlay_waveform.color | Specifies the waveform overlay color. | |
| overlay_waveform.pos | -0.25 | Specifies the waveform overlay position relative to the center. |
| preview.audio_channels | Default audio channels configuration for preview. | |
| preview.crop | ||
| preview.drop_frames | false | Enables a mode in which frames can be dropped by preview object. |
| preview.pull | false | Enables pull-mode for preview. |
| preview.show_cc | true | |
| preview.title | Changes the title of the window if the preview is opened in windowed mode or full-screen mode | |
| preview.type | dx11 |
Type of preview.
|
| pull_mode.cycles_before_disconnect | dword:0000000a | Sets number of cycles before the preview is disconnected |
| pull_mode.output_type | dword:00000002 | Specifies output type for enabled pull mode. |
| pull_mode.wait_till_get | dword:000000c8 | Sets duration in msec for a preview to wait till it gets a frame. |
| rotate | Default rotate configuration. | |
| scaling_deinterlace_first | false |
If enabled, the frame is deinterlaced before scaling. Useful when working with interlaced sources (50i/60i): enabling this option improves text and line clarity in both playback and pause modes. |
| scaling_quality | auto | Video scaling quality |
| stabilize_fps | false | Once enabled, stabilized the incoming frame rate according to the specified video format (duplicates frames if some are missed on the input, or drops frames if the object receives more than expected). |
| 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. |
| streamlabs.enabled | true | Enables Stream Labs devices |
| timecode.drop_frame | true | Sets drop-frame mode for input timecode |
| timecode.offset | Sets timecode offset | |
| timecode.time_sync | dword:00000000 | If "1", Overrides a source timecode with the system time |
| webcapture.enabled | true | Enables WebCapture source |
Still have questions?
Tell us what didn’t work or what you’d like clarified.