The properties are stored in the system registry:
[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MFile\MFileFFM]
and can be set with the PropsSet method. Please refer to this article about prefixes for properties.
| Name | Default value | Description |
|---|---|---|
| anc_file.async_open | false | Sets asynchronous way to open external ANC file with closed captions data. |
| audio.max_wait | -1 | Max time (ms) to wait for incoming audio packets before proceeding—helps smooth DVB/network timestamp jumps and avoid A/V desync. |
| audio.merge_mono_track | true | Once enabled, mono audio tracks are merged into a single audio track (the default behavior for MXF files with 8 mono audio tracks). |
| audio.pts_sync_msec | 0 | Sets a limit of asynchronization in milliseconds before force synchronization of video and audio is enabled. |
| audio.rms_forward_time | 0.0 | Forward pre-cache duration for audio normalization |
| decoder.amd | false | Enables GPU-accelerated decoding using AMD hardware. |
| decoder.attempts_limit | 500 |
Max number of consecutive decode retries before failing. Set |
|
decoder.cc |
true | Enables ATSC closed captions track. |
| decoder.convert_planar | false | Controls whether the SDK converts planar YUV formats (like YUV420P) to a packed format (HDYC). Disabling it can improve performance in workflows that support planar data. |
| decoder.force_gpu | (empty) | Selects a specific GPU device to use for decoding. Useful for systems with multiple GPUs to avoid conflicts or load imbalances. |
| decoder.mjpeg_threads | 6 | Sets a number of threads to decode MJPEG video. |
| decoder.mldv | true | Enables Medialooks DV Decoder. |
| decoder.nvidia | false | Enables NVIDIA GPU-powered decoding. |
| decoder.quicksync | 0 | Enables Intel Quick Sync decoding. |
| decoder.yuv_transform_matrix | (empty) |
Posible values:
Defines the matrix used for YUV-to-RGB conversion. If any unknown value is provided, it defaults to YUV_RGB_709. |
| duration.recalc_on_open | false | Once enabled, file duration is recalculated once it is opened. It gets more accurate duration but slightly increases performance and time to open a file. |
| experimental.mfcodecs | true | Enables an experimental mode for video decoding |
| experimental.nvidia.async_copy | false | Enables an asynchronous way of video data copy for GPU-pipeline. |
| experimental.optimize_cpu | true | Optimizes CPU usage for decoding. Experimental parameter. |
| experimental.out_audio_packets | 0 | Enables experimental mode to output original (non-decoded) audio packets. |
|
experimental.out_subtitle_packets |
0 | Enables experimental mode to output original (non-decoded) subtitle packets. |
| experimental.out_video_packets | 0 | Enables experimental mode to output original (non-decoded) video packets. |
| experimental.rev_max_cpu_memory | 3G | The maximal amount of dedicated CPU memory for reverse playback |
| experimental.rev_max_gpu_memory | 1G | The maximal amount of dedicated GPU memory for reverse playback |
| experimental.rev_max_step_msec | 300 | Maximal interval for reverse playback |
| experimental.rev_min_step_msec | 0 | Minimal interval for reverse playback |
| fill_time_gaps | false | Enables automatic duplication of the last available frame to fill timecode gaps in the source. Useful when source files contain irregular timestamps (e.g., jumps or pauses). |
| forward.cache | 3 | Sets buffer size of decoded frames in a forward direction. |
| forward.direct | false | Sets direct forward playback. |
| forward.min_seek | 5 | Sets interval of frames for seeking. |
| frameget.disabled | false | Disables FileFrameGet and ObjectFrameGet method for an MFile object. |
| h264_timecode.every_frame_update | ||
| h264_timecode.force | ||
| idx.force_remove | true | Sets a force mode to delete IDX files for the play-while-rec feature. |
| img.open_file_flags | -1 | Sets additional flags for still images opening |
| mfcodecs.drop_packets | false | Enables dropping packets for mfcodecs. Not recommended to enable. |
| mxf.force_ffmpeg | true | Forces to use FFmpeg MXF decoding instead of Medialooks MXF Reader. |
| mxf.fp500_offset | true | Enables use FP500 offset data for MXF files. |
| mxf.hidden_index | true | Once enabled, a hidden index file is created for big MXF files. When the index is created the next time you open this MXF file, it is opened much faster than the 1st time. |
| mxf.index_path | Specifies the exact folder where the index files should be stored. Please note that this prop is hidden up to version 2.8.1.13852 of the SDKs inclusive. In a case you don't see it in your registry, just create it manually. | |
| mxf.open_file_flags |
Sets additional flags for MXF files opening https://msdn.microsoft.com/en-us/library/windows/desktop/aa363858(v=vs.85).aspx Where valid flags are listed in dwFlagsAndAttributes parameter. |
|
| mxf.s377_metadata | false | Enables to use of S377 metadata for MXF files. |
| mxf.source_package_tc | false | false - MaterialPackage TC true (or 1) - SourcePackage TC from the 1st source TC track 2,3,... - an index of a source TC track to use (starts with 1). |
| network.low_delay | false | Once enabled, tries to open a network source without extra buffering. Reduces the overall delay for RTSP streams, but might affect the stability of streams for other protocols. |
| network.open_async | false | Sets asynchronous way to open a network stream. |
| network.open_image | Sets a path to a custom image for reconnection. | |
| network.reconnect | true | Once enabled, tries to reconnect a network stream when its signal is lost. |
| network.reconnect.max_wait | 0 | The maximal amount of time to wait for the reconnect of a stream. 0 means "wait forever". |
| network.show_attempts | true | Shows attempts of reconnection for network streams. |
|
nvidia.num_decode_surfaces |
8 | Number of surfaces that the Nvidia driver will internally allocate for storing the decoded frames. Using a higher number ensures better pipelining but increases GPU memory consumption. Minimum recommended value: 2. |
|
nvidia.num_output_surfaces |
4 | Maximum number of output surfaces that the Nvidia driver will simultaneously map to decode surfaces for further processing. Minimum recommended value: 2. |
| play_while_rec.update_len | true | Once enabled, MFile updates the duration of a recording file. |
| reverse.direct | false | Sets direct reverse playback mode. |
| reverse.step | 25 | Sets the duration of a step to switch to reverse playback |
| srt.force_ffmpeg | true | Initializes FFmpeg to read input SRT streams. if false Medialooks' internal splitter is used. |
|
teletext.force_ffmpeg |
false | Enables teletext decoding using FFmpeg |
| yt-dlp.path | (empty) | Specifies the exact path to yt-dlp.exe when handling YouTube sources. If empty, it searches next to the DLL location. |
Still have questions?
Tell us what didn’t work or what you’d like clarified.