The properties are stored in the system registry:
[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MPreview]
and can be set with the PropsSet method. Please refer to this article about prefixes for properties.
Name | Default value | Description |
---|---|---|
pull_mode | false | Enables pull-mode for preview |
rate_control | false | Makes the MPreview object to control the playback rate |
preview.type | dx9 | Type of preview. Possible values:
|
statistics.extended | stat | Sets a prefix for gathering statistics of an MPreview object after all the conversion and changes. |
preview.background | checker | Sets default background for preview. Possible values:
|
preview.alpha_channel | gpu |
Add a possibility to use alpha channel. Content with transparency is displayed with a checkerboard background on a preview. Possible values:
|
preview.skip_fields | 0 | Sets a mode for skipping fields (for interlaced video only). Possible values:
it is not only for the interlaced video. For progressive, it skips full frames (counts as 2). For 30p input, the skip_fields = 15 gives you the resulting fps at about 4 (3.8), and if you set skip_fields to 30, it results in 2 fps.
|
preview.title | MFPreview | Changes the title of the window if the preview is opened in windowed mode or full-screen mode |
preview.external_process | false | Makes preview to work in an external MServer.exe process |
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.buffers | 1 | Sets a buffer size of frames. |
preview.crop | 0.0%,0.0%,0.0%,0.0% | Default preview crop configuration. |
gpu.rgb_transform_matrix | Default color transformation matrix for the GPU mode. | |
audio_channels | Default audio channels configuration. | |
audio_gain | Default audio gain configuration. | |
deinterlace | true | Enables deinterlacing mode. |
maintain_ar | true | Makes MPreview object to maintain 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 | 2 | Sets scale filter for Direct3D-based preview. |
direct3d.scale_backbuffer | true | Enables scaling for a back buffer for Direct3D-based preview. |
audio.buffer_size_msec | 100 | Sets a buffer size for audio data in msec. |
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) |
video_renderer | Sets video renderer that is used for preview. The empty string means the default video device. | |
audio_renderer | Sets audio renderer that is used for preview. The empty string means the default audio device. | |
debug.test_tone | Sets a test tone in Hz. Debug-only property. | |
audio.direct_sound | false | Enables direct sound mode. |
wpf_preview | false | Enables WPF preview. See more for details. |
wpf_preview.sync_texture | false | Synchronizes D3DTexture objects in case of multiple preview instances are used. |
wpf_preview.downscale | dword:00000000 | Sets downscale parameter for WPF preview. See more for details. |
wpf_preview.update | dword:0000001e | Sets update period for WPF preview. See more for details. |
wpf_preview.cpu_dx11 | false | Forces DX11 preview in CPU mode. |
register_object | true | Once enabled, the MPreview object is registered to the system to gather statistics. |
object_name | MPreview |
Default name of the object. If you need to change it, use the following approach: m_objPreview.PropsSet("object_name", "new_name"); m_objPreview.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. |
overlay_rms | false | Enables RMS overlay. |
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.color | green |
Specifies RMS overlay color. Possible values:
|
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. |