The properties are stored in the system registry:
[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MMixer]
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. | |
| audio_gain | Default audio gain configuration. | |
| audio.lufs | false | Enables LUFS audio measurement. |
| audio.lufs_state | Change the current state of the lufs. Possible values: reset, pause, continue. | |
| audio.lufs_channels | Add the lufs only for required channels. | |
| audio.gain_normalization | false | Enables audio gain normalization |
| gain_normalization.target_i | -23.0 | Target gain level for audio normalization. |
| 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" |
| gpu.rgb_transform_matrix | Default color transform matrix for the GPU-pipeline. | |
| imaudio.enabled | true | Enables IMAudio interface for the object. |
| statistics.extended | stat | Sets a prefix for gathering statistics of an MMixer object after all the conversion and changes. |
| elements.show_last_frame | true | Once enabled, MMixer shows the last frame on scene elements which streams are over. |
| background.direct_out | false |
Enables a specific mode for an MMixer background, in which it outputs without any conversion. (We should set this property first and only after that change the Mixer's background, otherwise, we will get an exception). |
| 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 the 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 MMixer objects in external applications through mp:// links and IMSenders. |
| default_name | MMixer |
Default name of the object. If you need to change it, use the following approach: m_objMixer.PropsSet("default_name", "new_name"); m_objMixer.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. |
| deinterlace | true | Enables deinterlacing mode. |
| preview.audio_channels | Default audio channels configuration for preview. | |
| 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.crop | 0.0%,0.0%,0.0%,0.0% | Default crop configuration for preview only. |
| preview.type | dx9 | Type of preview. Possible values:
|
| default_tracks | dword:00000001 | Default amount of audio tracks. |
| channels_per_track | dword:00000000 | Default amount of channels per track. |
| last_scene.path | ..\\..\\Resources\\last-scene-cpu.xml | A path to the last scene configuration. |
| last_scene.load | dword:00000000 | Once set to "1", MMixer loads the last scene configuration (from "last_scene.path" file) on initialization. |
| last_scene.save | dword:00000000 | Once set to "1", MMixer saves the last scene configuration (to "last_scene.path" file) when you close the object. |
| auto_start | true | Once enabled, MMixer starts automatically the moment you create an instance of the object. |
| sync_mode | true | Enables synchronization mode for streams. |
| sync_mode.async_get | true | Makes frame grabbing for sources asynchronous (for "sync_mode=true" only). |
| sync_mode.direct_mp_links | true | Enables direct access to objects behind mp:// links (for "sync_mode=true" only). |
| sync_mode.fixed_buffers | dword:00000000 | Sets fixed buffer duration in frames for frame processing (for "sync_mode=true" only). |
| sync_mode.external_exclusive | false | Once enabled, makes external sources exclusively used by the MMixer only (for "sync_mode=true" only). |
| sync_mode.external_keepres | false | Once enabled, external sources keep their video formats in MMixer. |
| sync_mode.mute_seek | true | Mutes audio on seeking in "sync_mode = true" mode. |
| sync_mode.input_buffers | 0 | A number of input buffers for synchronization of sources |
| external.autostart | true | Once enabled, external objects start automatically when you add them to an MMixer. |
| external.loop | false | Sets loop property for external sources |
| cut_offscreen | true | Don't process video that is out of a screen. Recommended for performance optimization. |
| items.external_access | true | Once enabled, you can use streams of the MMixer in external applications through mp:// links and IMSenders. |
| bg.external_access | false | Once enabled, you can access the background stream in external applications through mp:// links and IMSenders. |
| pause_changes | dword:00000001 | Sets a mode for pause. Possible values:
|
| output.max_buffers | dword:00000000 | Maximal size of frame buffers for output (could be used for stable output) |
| output.min_buffers | dword:00000000 | Minimal size of frame buffers for output (could be used for stable output) |
| output.gpu_sync | false | waits GPU execution before send a frame to output |
| cut_overlapped | true | Cuts overlapped video to optimize performance. |
| live.fixed_wait_div | 0.0 | Sets time period of waiting for frames from live sources in seconds. |
| live.wait_all | true | Once enabled, an MMixer waits for frames from all live sources for better synchronization. |
| in_preroll | 1.0 | Default preroll value for streams seeking. |
| tc_preroll | 1.0 | Default timecode preroll value for streams seeking. |
| loop | true | Sets the MMixer object to be in loop state. |
| file.loop | true | Sets default loop behavior of file sources. |
| scaling_quality | auto | Sets scaling quality for video. Possible values:
|
| scaling_quality.blocks | dword:00000002 | Sets scaling quality for video elements of MMixer scene. Possible values:
|
| output.skip_if_not_ready | false | Once enabled, MMixer skips an output frame if it isn't ready. |
| timecode.source_idx | dword:00000000 | Sets default index of a stream that is used as a source for MMixer timecode. |
| transitions.scale_to_output | false | Scales streams to output format during transitions. |
| threads.priority_on | false | Enables priority for mixing threads. If disabled, all the threads have the same priority. |
| threads.priority_min | -2 | Sets the minimal priority of mixing threads. |
| threads.priority_max | dword:0000000f | Sets the maximal priority of mixing threads. |
| background | black | Default background source. Possible values:
|
| locked.force_master | false | Forces a master stream to control mixing times. So the MMixer output is synchronized with the master stream. |
| mfconverter.enabled | false | enables internal conversion mechanism (not recommended to change) |
| format.set_default_pixelformat | true | use the original pixel format for video conversion |
| 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"). |