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 |
|---|---|---|
| rate_control | true | Makes the MFPreview object to control the playback rate |
| preview.downscale | dword:00000001 | Downscales preview video to optimize performance. Possible values:
|
| preview.drop_frames | false | Once enabled, an MPreview object can drop frames in case frame processing takes a long time. |
| preview.crop | 0.0%,0.0%,0.0%,0.0% | Default preview crop configuration. |
| preview.buffers | dword:00000001 | Sets a buffer size of frames. |
| preview.type | dx9 | 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. |
| wpf_preview | false | Enables 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. |
| wpf_preview.downscale | dword:00000000 | Sets downscale parameter for WPF preview. |
| wpf_preview.cpu_dx11 | false | Forces DX11 preview in CPU mode. |
| deinterlace | true | Enables deinterlacing mode. |
| maintain_ar | true | Makes MPreview object to maintain the source aspect ratio. If disabled, the preview video stretches to the control size. |
| direct3d.pixel_format | auto | Sets pixel format for Direct3D-based preview. |
| direct3d.scale_filter | dword:00000002 | Sets scale filter for Direct3D-based preview. |
| direct3d.scale_backbuffer | true | Enables scaling for a back buffer for Direct3D-based preview. |
| preview.background | checker | Sets default background for preview. Possible values:
|
| 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:
|
| preview.skip_fields | dword:00000000 | Sets a mode for skipping fields (for interlaced video only). Possible values:
|
| preview.title | MFPreview | Changes the title of the window if the preview is opened in windowed mode or full-screen mode |
| audio.buffer_size_msec | dword:00000064 | Sets a buffer size for audio data in msec. |
| audio.correct_rate | true | |
| audio.enabled | true | Enables audio preview by default. |
| video.enabled | true | Enabled video preview by default. |
| 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_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) |
| 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. | |
| audio.direct_sound | false | Enables direct sound mode. |
| 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). |
| object_name | MFPreview | The default name of the object. |
| overlay_rms | false | Enables RMS overlay. |
| overlay_rms.vertical | false | Makes the RMS overlay bars vertical. |
| 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_waveform | false | Enables waveform overlay. |
| overlay_waveform.pos | 0.3 | Specifies the waveform overlay position relative to the center. |
| overlay_waveform.color | Specifies the waveform overlay color. | |
| dx11.swap_chain_latency_wait | true | Sets DX11 preview to wait until the swap operation is complete. |
| dx11.swap_chain_scale | 1.5 | Sets DX11 preview scaling quality. |
| dx11.windowless | false | For DX11 mode only. Use preview in a windowless mode. |
| dx11.use_vsync | false | Enables VSync use for DX11 preview. |
| dx11.swap_chain_resize | true | For DX11 mode only. Swap DirectX chain on preview resize. |
| dx11.field_only | For DX11 mode only. Preview a single field only. |