Medialooks Knowledge Base Support Center

Contact Us

MMixer object properties

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
" 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 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.
" 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 MMixer objects in external applications through mp:// links and IMSenders.
" default_name "
" MMixer "
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.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 "
" direct3d "
Type of preview.
Possible values:
  • "dshow" - uses DirectShow-based preview
  • "direct3d" - uses DirectX-based preview. Requires DirectX to be installed on a system.
" default_tracks "
"1"
Default amount of audio tracks.
" channels_per_track "
"0"
Default amount of channels per track.
" audio_channels "
" "
Default audio channels configuration. See audio management for details.
" audio_gain "
" "
Default audio gain configuration. See audio management for details.
" last_scene.path "
" ..\\..\\Resources\\last-scene-cpu.xml "
A path to the last scene configuration.
" last_scene.load "
"0"
Once set to "1", MMixer loads the last scene configuration (from "last_scene.path" file) on initialization.
" last_scene.save "
"0"
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 "
"0"
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.
" 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 to the background stream in external applications through mp:// links and IMSenders.
" pause_changes "
"1"
Sets a mode for pause.
Possible values:
  • 0 - pause on top-field only
  • 1 - pause on bottom-field only
  • 2 - pause on each field
" output.max_buffers "
"0"
Maximal size of frame buffers for output (could be used for stable output)
" output.min_buffers "
"0"
Minimal size of frame buffers for output (could be used for stable 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:
  • 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
" scaling_quality.blocks "
"2"
Sets scaling quality for video elements of MMixer scene.
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.skip_if_not_ready "
" false "
Once enabled, MMixer skips an output frame if it isn't ready.
" timecode.source_idx "
"0"
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 minimal priority of mixing threads.
" threads.priority_max "
"15"
Sets maximal priority of mixing threads.
" background "
" black "
Default background source.
Possible values:
  • a path to a local video file or a static image
  • hex-code of a color
" locked.force_master "
" false "
Forces a master stream to control mixing times. So the MMixer output is synchronized with the master stream.
" 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").