The properties are stored in the system registry:
[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MFile]
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. |
audio_channels | Default audio channels configuration. | |
audio_gain | Default audio gain configuration. | |
gpu.rgb_transform_matrix | Default color transform matrix for the GPU-pipeline. | |
active_frc | 1 | Sets active frame rate converter mode. |
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. |
default_name | MFile | 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.type | dx9 | Type of preview. Possible values:
|
preview.drop_frames | false | Enables a mode in which frames can be dropped by preview object. |
preview.crop | 0.0%,0.0%,0.0%,0.0% | Default crop configuration for preview only. |
preview.pull | false | Enables pull-mode for preview. |
default_tracks | 0 | Default amount of audio tracks. |
channels_per_track | 0 | Default amount of channels per track. |
internal.convert_frame | false | Enables the possibility to convert frames internally before the object is used in MPlaylist or MMixer (if disabled, it converts video to a format of the top object, e.g. MMixer). |
experimental.buffers | 0 | Buffer duration. Experimental property. |
img_stub | Image for audio-only files. | |
img.default_duration | 3600.0 | Default duration of a still image |
img.tone | Sound tone in Hz for still images. | |
pause.fields | 2 | Sets a mode for pause. Possible values:
|
pause.use_reference | false | Sets usage of a reference frame to be used on pause |
external_access | true | Once enabled, you can use MFile objects in external applications through mp:// links and IMSenders. |
loop | false | Sets default loop mode. |
no_breaks | false | For "loop=true" only. Don't send a "break" frame when a file switches to the beginning. |
auto_start | false | Makes the object to start automatically the moment you set its name with the FileNameSet method. |
watch_dog.lock_maxtime | 3000 | Sets maximal wait time for a watchdog object to control framerate. |
watch_dog.check_time | 1000 | Sets time period in msec to check time for a watchdog object. |
watch_dog.frameget_maxtime | 10000 | Sets maxima time for grabbing a frame for a watchdog object. |
external_process | true | Makes decoding in an external MServer.exe process. |
eof_stop | false | Once enabled, MFile sends EOF events continuously once it reaches its end. |
open_file.max_wait | 10000 | Sets maximal time period to open a local file in msec. |
open_url.max_wait | 10000 | Sets maximal time period to open a network stream in msec. |
read_url.max_wait | 3000 | Sets maximal time period to get a frame from a network stream in msec. |
read_file.max_wait | 3000 | Sets maximal time period to get a frame from a local file in msec. |
force_mpeg_tc | false | Forces MFile object to use MPEG timecode. |
audio_track | 0 | Sets default audio track. |
video_track | 0 | Sets default video track. |
subtitle_track | -1 | Sets default subtitle track. |
afilter | Sets an audio filter | |
ts_program | 0 | Sets default transport stream program. For example, the quality level of the youtube stream. |
network.buffer_min | 1.0 | Sets minimal buffer duration for network streams. |
network.buffer_max | 10.0 | Sets maximal buffer duration for network streams. |
network.rate_control | true | Enables additional control over buffers for network streams playback. Makes network playback more stable in most cases. |
file.buffer_min | 0.0 | Sets minimal buffer duration for video files. |
file.buffer_max | 2.0 | Sets maximal buffer duration for video files. |
decode | auto | Sets decoding mode. Possible values:
|
decode.fallback | false | If a file can't be decoded properly with Decoder Lib components, it falls back to available DirectShow filters (deprecated). |
scaling_quality | auto | Sets scaling quality for video. Possible values:
|
file.max_forward_rate | 4.0 | Sets maximal forward playback rate. |
file.max_reverse_rate | 2.0 | Sets maximal reverse playback rate. |
crop | Default crop configuration. | |
mirror | Default mirror configuration. | |
rotate | Default rotate configuration. | |
overlay_rms | false | Enables RMS overlay. |
overlay_rms.pos | 0.1 | Specifies RMS overlay position relative to the left side. |
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. | |
scale_type | default | Default scaling type. Possible values: crop, letter-box, none, no-scale, default. |
pull_mode.cycles_before_disconnect | dword:0000000a | Sets number of cycles before preview is disconnected. |
pull_mode.wait_till_get | dword:000000c8 | Sets duration in msec for a preview to wait till it gets a frame. |
out_point.mode | wait | Manages the behavior of a file playback for out-point when its value is longer than a file duration. Possible values:
|
audio.variable_rate | true | Once enabled, the audio is adapted to playback rate (e.g. if you play a video at 0.5 speed the audio is also sloooow). Once disabled, audio is played at normal speed (e.g. if you play a video at 0.5 speed, the audio sounds like chunks). |
audio.lufs | false | Enables LUFS audio measurement |
audio.lufs_state | Sets LUFS measurement state. Possible values:"" (continue the calculation), "reset", "pause" | |
audio.lufs_channels | Sets the channels for LUFS measurements | |
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" |
timecode.time_sync | 0 | Possible values: 0 - uses an original timecode (even if it is overridden); 1 - uses a local machine time (is set just once and increases timecode on each next frame); 2 - uses a local machine time (is set and is updated periodically to keep synchronization) |
timecode.offset | Sets an offset to a timecode, e.g. "o1:23:45:21" | |
mfreader.convert_format | true | Converts a video format if the object is used by a playlist or a mixer. |
mfconverter.enabled | true | enables internal conversion mechanism (not recommended to change) |
format.set_default_pixelformat | true | use the original pixel format for video conversion |
output.10bit | false | Enables 10bits output from the decoder (for HDR support) |
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"). |
interlace | Sets default interlacing type. Possible values:
|