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.
Other properties, related to the decoding, are described here.
| Name | Default value | Description |
|---|---|---|
| active_frc | 1 | Sets active frame rate converter mode. |
| afilter | Sets an audio filter | |
| audio.gain_normalization | false | Enables audio gain normalization |
| audio.lufs | false | Enables LUFS audio measurement |
| audio.lufs_channels | Sets the channels for LUFS measurements | |
| audio.lufs_state | Sets LUFS measurement state. Possible values:"" (continue the calculation), "reset", "pause" | |
| 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_channels | Default audio channels configuration. | |
| audio_gain | Default audio gain configuration. | |
| audio_track | 0 | Sets default audio track. |
| auto_start | false | Makes the object to start automatically the moment you set its name with the FileNameSet method. |
| channels_per_track | 0 | Default amount of channels per track. |
| crop | Default crop configuration. | |
| 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). |
| default_name | MFile |
Default name of the object. If you need to change it, use the following approach: m_objFile.PropsSet("default_name", "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. |
| default_tracks | 0 | Default amount of audio tracks. |
| deinterlace | true |
Enables deinterlacing mode. |
| deinterlace_fields |
2 |
Determines which frame fields are used for generating new frames when an up rate control conversion is applied. Possible values:
|
| eof_stop | false | Once enabled, MFile sends EOF events continuously once it reaches its end. |
| 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. |
| experimental.buffers | 0 | Buffer duration. Experimental property. |
| external_access | true | Once enabled, you can use MFile objects in external applications through mp:// links and IMSenders. |
| external_process | true | Makes decoding in an external MServer.exe process. |
| file.buffer_max | 2.0 | Sets maximal buffer duration for video files. |
| file.buffer_min | 0.0 | Sets minimal buffer duration for video files. |
| file.max_forward_rate | 4.0 | Sets maximal forward playback rate. |
| file.max_reverse_rate | 2.0 | Sets maximal reverse playback rate. |
| force_conversion | false | Force video conversion, even if the selected format is the same as the original format |
| force_mpeg_tc | false | Forces MFile object to use MPEG timecode. |
| format.set_default_pixelformat | true | use the original pixel format for video conversion |
| 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" |
| gain_normalization.target_i | -23.0 | Target gain level for audio normalization. |
| gpu.rgb_transform_matrix | Default color transform matrix for the GPU-pipeline. | |
| imaudio.enabled | true | Enables IMAudio interface for the object. |
| img.default_duration | 3600.0 | Default duration of a still image |
| img.full_transparent |
false | Allows you to work with full transparent images |
| img.tone | Sound tone in Hz for still images. | |
| img_stub | Image for audio-only files. | |
| 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). |
| loop | false | Sets default loop mode. |
| 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"). |
| mfconverter.enabled | true | enables internal conversion mechanism (not recommended to change) |
| mfreader.convert_format | true | Converts a video format if the object is used by a playlist or a mixer. |
| mirror | Default mirror configuration. | |
| mxf.use_track_origin | false | If true, honor MXF TrackOrigin and skip the initial offset frames when reading MXF files. |
| network.buffer_max | 10.0 | Sets maximal buffer duration for network streams. |
| network.buffer_min | 1.0 | Sets minimal 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. |
| no_breaks | false | For "loop=true" only. Don't send a "break" frame when a file switches to the beginning. |
| 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. |
| 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. |
| out_point.mode | wait | Controls out-point handling. wait (default): play until the configured out-point regardless of file duration. Any other value (e.g., switch) disables waiting. |
| output.10bit | false | Enables 10bits output from the decoder (for HDR support) |
| overlay_rms | false | Enables RMS overlay. |
| overlay_rms.color | green |
Specifies 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.1 | Specifies the relative vertical position of the RMS overlay. Available values are from 0.00 to 1.00. |
| overlay_waveform.color | Specifies the waveform overlay color. | |
| overlay_waveform.pos | -0.3 | Specifies the waveform overlay position relative to the center. |
| pause.fields | 2 | Sets a mode for pause. Possible values:
|
| pause.mute_audio | true | Mute audio on pause |
| pause.use_reference | false | Sets usage of a reference frame to be used on pause |
| preview.audio_channels | Default audio channels configuration for preview. | |
| preview.crop | 0.0%,0.0%,0.0%,0.0% | Default crop configuration for preview only. |
| preview.drop_frames | false | Enables a mode in which frames can be dropped by preview object. |
| preview.pull | false | Enables pull-mode for preview. |
| preview.show_cc |
true | |
| preview.title |
MPlatform Window | |
| preview.type | dx9 | Type of preview. Possible values:
|
| 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. |
| read_file.max_wait | 3000 | Sets maximal time period to get a frame from a local file in msec. |
| read_url.max_wait | 3000 | Sets maximal time period to get a frame from a network stream in msec. |
| rotate | Default rotate configuration. | |
| scale_type | default | Default scaling type. Possible values: crop, letter-box, none, no-scale, default. |
| scaling_deinterlace_first | false | If true, deinterlace frames before scaling (deinterlace → scale) to prevent combing/striping on interlaced sources. |
| scaling_quality | auto | Sets scaling quality for video. Possible values:
|
| subtitle_track | -1 | Sets default subtitle track. |
| timecode.offset | Sets an offset to a timecode, e.g. "o1:23:45:21" | |
| 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) |
| ts_program | 0 | Sets default transport stream program. For example, the quality level of the youtube stream. |
| video_track | 0 | Sets default video track. |
| 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. |
| watch_dog.lock_maxtime | 3000 | Sets maximal wait time for a watchdog object to control framerate. |