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. |
| " statistics.extended " | " " | Sets a prefix for gathering statistics of an MFile object after all the conversion and changes. |
| " external_access " | " true " | Once enabled, you can use MFile objects in external applications through mp:// links and IMSenders. |
| " 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 " | " direct3d " | 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 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 |
| " audio_channels " | " " | Default audio channels configuration. |
| " audio_gain " | " " | Default audio gain configuration. |
| " 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 " | "10000" | Sets maximal wait time for a watchdog object to control framerate. |
| " watch_dog.check_time " | "100" | Sets time period in msec to check time for a watchdog object. |
| " watch_dog.frameget_maxtime " | "5000" | 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. |
| " ts_program " | " -1 " | Sets default transport stream program. |
| " afilter " | "" | Sets an audio filter |
| " 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. |
| " overlay_rms.ch " | " false " (hidden) | Shows channels numbers in RMS |
| " 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 " | "10" | Sets number of cycles before preview is disconnected. |
| " pull_mode.wait_till_get " | "200" | 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.gain_normalization " | " false " | Enables audio gain normalization |
| " gain_normalization.target_i " | " -23.0 " | Target gain level for audio normalization. |
| " gain_normalization.skip_frames " | " 20.0 " | Set a duration in frames for the gain normalization buffering. |
| " timecode.time_sync" | " 0 " | Possible values: 0 - uses an original timecode (even if it is overriden); 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" |
| " 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"). |