The properties are stored in the system registry:
[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MFormats\MFPreview]
and can be set with the PropsSet method.
| Name | Default value | Description |
|---|---|---|
| audio.buffer_size_msec | dword:00000064 | Sets a buffer size for audio data in msec. |
| audio.correct_rate | true | Audio preview buffer size in seconds. Playback starts only after 3/4 of this buffer is filled. Larger values increase the startup delay and memory usage. |
| audio.direct_sound | false | Enables direct sound mode. |
| audio.enabled | true | Enables audio preview by default. |
| audio_play.device_buffer_duration | ||
| audio_renderer | Sets audio renderer that is used for preview. The empty string means default audio device. | |
| debug.test_tone | Sets a test tone in Hz. Debug-only property. | |
| deinterlace | true | Enables deinterlacing mode. |
| direct3d.pixel_format | auto | Sets pixel format for Direct3D-based preview. |
| direct3d.scale_backbuffer | true | Enables scaling for a back buffer for Direct3D-based preview. |
| direct3d.scale_filter | dword:00000002 | Sets scale filter for Direct3D-based preview. |
| dx11.field_only | For DX11 mode only. Preview a single field only. | |
| dx11.swap_chain_latency_wait | true | Sets DX11 preview to wait until the swap operation is complete. |
| dx11.swap_chain_resize | true | For DX11 mode only. Swap DirectX chain on preview resize. |
| dx11.swap_chain_scale | 1.5 | Sets DX11 preview scaling quality. |
| dx11.use_vsync | false | Enables VSync use for DX11 preview. |
| dx11.windowless | false | Use preview in a windowless mode. |
| dx9.windowless | false | Use preview in a windowless mode. |
| 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_preview.height | 549 | Initial height of external preview (in pixels) |
| external_preview.width | 720 | Initial width of external preview (in pixels) |
| external_preview.x | 64 | Initial X-coordinate of the external preview (in pixels) |
| external_preview.y | 64 | Initial Y-coordinate of the external preview (in pixels) |
| maintain_ar | true | Makes MPreview object to maintain the source aspect ratio. If disabled, the preview video stretches to the control size. |
| object_name | MFPreview | The default name of the object. |
| 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 | green |
Specifies default RMS overlay color. Possible values:
|
| overlay_rms.color_error | 0xFFA20F0F | The color of the RMS bars when the volume level is above -7 dB. |
| overlay_rms.color_nominal | 0xFF00A000 | The color of the RMS bars when the volume level is below -20 dB. |
| overlay_rms.color_warning | 0xFFB4B40D | The color of the RMS bars when the volume level is above -20 dB but below -7 dB. |
| overlay_rms.level_check | false | Makes the overlay RMS bars three-color depending on the volume level. |
| overlay_rms.pos | 0.05 | Specifies the relative vertical position of the RMS overlay. Available values are from 0.00 to 1.00. |
| overlay_rms.vertical | false | Makes the RMS overlay bars vertical. |
| overlay_waveform | false | Enables waveform overlay. |
| overlay_waveform.color | Specifies the waveform overlay color. | |
| overlay_waveform.pos | 0.3 | Specifies the waveform overlay position relative to the center. |
| preview.alpha_channel | gpu |
Add a possibility to use the alpha channel. Content with transparency is displayed with a checkerboard background on a preview. Possible values: "gpu" - the alpha channel is processed only if gpu_pipeline = true; "true" - alpha channel processed with CPU and GPU; "false" - alpha channel won't process. |
| preview.background | checker |
Sets default background for preview.
|
| preview.buffers | dword:00000001 | Sets a buffer size of frames. |
| preview.crop | 0.0%,0.0%,0.0%,0.0% | Default preview crop configuration. |
| preview.downscale | dword:00000001 |
Downscales preview video to optimize performance.
|
| preview.drop_frames | false | Once enabled, an MPreview object can drop frames in case frame processing takes a long time. |
| preview.external_process | false | Once "true", MFPreview is processed in a separated MServer.exe process to increase the overall stability (if preview fails the whole app stays alive - the only thing that fails is the MServer.exe process that is related to the MFPreview object). |
| preview.fullscreen.close_on_click | false | Enables closing fullscreen preview on mouse click. When disabled, fullscreen preview does not close on click (default behavior). Useful in WPF, where mouse click events on external preview windows cannot be intercepted. |
|
preview.gpu_cc |
true | Enables pixel format conversion on the GPU |
| preview.skip_fields | dword:00000000 |
Sets a mode for skipping fields (for interlaced video only).
|
| preview.title | MFPreview | Changes the title of the window if the preview is opened in windowed mode or full-screen mode |
| preview.type | dx11 | Type of preview. Possible values: "dshow" - uses DirectShow-based preview "dx11" - uses DirectX11-based preview. Requires DirectX11 to be installed on a system. "dx9" - uses DirectX9-based preview. Requires DirectX9 to be installed on a system. |
| rate_control | true | Makes the MFPreview object to control the playback rate |
| video.enabled | true | Enabled video preview by default. |
| wpf_preview | false | Enables WPF preview. |
| wpf_preview.cpu_dx11 | false | Forces DX11 preview in CPU mode. |
| wpf_preview.downscale | dword:00000000 | Sets downscale parameter for WPF preview. |
| wpf_preview.sync_texture | false | Synchronizes D3DTexture objects in case of multiple preview instances are used. |
| wpf_preview.update | dword:0000001e | Sets update period for WPF preview. |
Still have questions?
Tell us what didn’t work or what you’d like clarified.