Medialooks Knowledge Base Support Center

Contact Us

MPlaylist object properties

The properties are stored in the system registry:

[HKEY_CURRENT_USER\SOFTWARE\Medialooks\MPlatform\MPlaylist]

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. If disabled ("false") then you can manage audio only through properties.
" audio_channels "
" "
Default audio channels configuration. See audio management for details.
" audio_gain "
" "
Default audio gain configuration. See audio management for details.
" statistics.extended "
" stat "
Sets a prefix for gathering statistics of an MPlaylist object after all the conversion and changes.
" active_frc "
"1"
Sets active frame rate converter mode. Read about Active FRC more.
" 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_access "
" true "
Once enabled, you can use MPlaylist objects in external applications through mp:// links and IMSenders.
" default_name "
" MPlaylist "
Default name of the object. Call ObjectNameSet method before you start the object to change the name from code.
" preview.type "
" direct3d "
Type of preview.
Possible values:
  • "dshow" - uses DirectShow-based preview
  • "direct3d" - uses DirectX-based preview. Requires DirectX to be installed on a system.
" deinterlace "
" true "
Enables deinterlacing mode.
" 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.audio_channels "
" "
Default audio channels configuration for preview.
" preview.pull "
" false "
Enables pull-mode for preview.
" default_tracks "
"1"
Default amount of audio tracks.
" default_channels "
"0"
Default amount of audio channels (means use original)
" channels_per_track "
"0"
Default amount of channels per track.
" pause.fields "
"2"
Sets a mode for pause.
Possible values:
  • 0 - pause on top-field only
  • 1 - pause on bottom-field only
  • 2 - pause on each field
" pause.use_reference "
" false "
Sets usage of a reference frame to be used on pause
" 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).
" reverse.init_next "
" true "
Initializes the next item at reverse playback for smooth switching.
" playlist.init_next "
"1"
Specifies mode of initialization of next items.
Possible values:
  • 0 - do not initialize next items (leads to lower CPU usage, but for heavy files, there could be a delay the moment of switching)
  • 1 - initialize the next item only (slightly higher CPU usage, but switching between playlist items is smooth in case of simple playback, but seeking to different items can lead to drops)
  • 2 - initialize all the items in a playlist (high CPU usage but smooth switching to any playlist items).
" playlist.eol_rewind "
" true "
Once enabled, playlist rewinds to the beginning when it is over.
" plugins.optimization "
" true "
Enables extra optimization for plugins.
" playlist.override_timecode "
" false "
Once enabled, overrides timecode of playlist items with its own timecode (specified with "playlist.start_timecode" property).
" playlist.start_timecode "
" 00:00:00:00 "
Sets start timecode of a playlist. Works only if "playlist.override_timecode" is enabled.
" file.check_at_add "
" true "
Once enabled, MPlaylist checks file properties the moment you add it to the playlist.
" dynamic "
" false "
Enables dynamic playlist mode. In this mode, a playlist item, once over, is removed from the playlist.
" playlist.on_next "
" "
Specifies behavior of a playlist on switching to the next item.
Possible values:
  • "stop" - stop after each file;
  • "pause_in" - pause after each file on the first frame of the next item;
  • "pause_out" - pause after each file on the last frame of the current item;
  • "" - default behavior (continue playback).
" loop "
" true "
Sets playlist in loop mode.
" background_rewind "
" false "
Sets background behavior. When playback is stopped the background is resumed from start ("true") of from the last background frame ("false").
" background_transition "
" true "
Enables a possibility to use transitions for backgrounds.
" setpos_transition "
" false "
Once enabled, you can switch between playlist items using the PlaylistPosSet method with transitions (transitions specified for playlist items separately).
" background "
" colorbars-ntsc "
Sets default background.
Possible values:
  • a path to a local file (still image or a video)
  • hex-code of a color
" schedule_waitstart "
" stop "
Specifies behavior of a playlist for scheduled items.
Possible values:
  • "stop" - then playlist is stopped and the background is displayed shown until the scheduled time.
  • "pause-in" - then playlist is paused on the first frame of next file until the scheduled time.
  • "pause-out" - then playlist is paused on the last frame of the previous file until the scheduled time.
  • "skip" - then the next file with specified start time is skipped and the next available file without specified start time is played. If there are no files without specified start time in the whole playlist then playlist is stopped.
" scaling_quality "
" auto "
Sets scaling quality for video.
Possible values:
  • auto - automatically detects the best suitable quality
  • 2 - poor scaling but low performance
  • 8 - good scaling and acceptable performance
  • 18 - best scaling and high performance
" overlay_timecode "
" false "
Overlays video with timecode. Debug property.
" 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_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.
" 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.
" 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).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).