Platforms to show: All Mac Windows Linux Cross-Platform
Back to VLCMediaPlayerMBS class.
VLCMediaPlayerMBS.Constructor(media as VLCMediaMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
On success handle is not nil.
See also:
VLCMediaPlayerMBS.Constructor(VLCInstance as VLCInstanceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
On success handle is not nil.
See also:
VLCMediaPlayerMBS.CopyCGImage as Variant
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 19.0 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This method set HasNewFrame to false.
VLCMediaPlayerMBS.CopyMemory as memoryblock
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This method set HasNewFrame to false.
The format depends on what you passed to VideoSetFormat.
Byte order usually is BGRA.
VLCMediaPlayerMBS.CopyPicture as Picture
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This method set HasNewFrame to false.
If using CGContext, this returns a CGImageMBS. Else a Picture.
With version 19.0, this returns always a picture.
VLCMediaPlayerMBS.CopyToMemory(dest as Ptr, offset as Integer, RowBytes as Integer) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 13.4 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Offset: Position of first byte in memoryblock.
RowBytes: The row size in bytes of your memoryblock.
This way you can have your frame go into a buffer of bigger width/height representing an OpenGL texture for example.
Byte order usually is BGRA.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
VLCMediaPlayerMBS.GetChapterCountForTitle(title as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Return number of chapters in title, or -1.
VLCMediaPlayerMBS.GetChapterDescription(index as Integer) as VLCTrackDescriptionMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Return list containing description of available chapter for title with index.
VLCMediaPlayerMBS.GetMemory as Ptr
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 13.4 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This method set HasNewFrame to false.
The format depends on what you passed to VideoSetFormat.
VLCMediaPlayerMBS.Navigate(Navigate as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
See also:
VLCMediaPlayerMBS.Pause(pause as boolean)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
pause: play/resume if false, pause if true.
See also:
VLCMediaPlayerMBS.Play as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Return true if playback started (and was already started), or false on error.
VLCMediaPlayerMBS.PreviousChapter
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
VLCMediaPlayerMBS.SetAudioOutput(AudioOutputName as string) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Change will be applied after stop and play.
Name: name of audio output.
Return true on success.
VLCMediaPlayerMBS.SetAudioOutputDevice(AudioOutputName as string, deviceID as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
AudioOutputName: name of audio output.
deviceID: device ID.
VLCMediaPlayerMBS.SetEqualizer(Equalizer as VLCEqualizerMBS = nil)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 15.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
It is possible to apply new equalizer settings to a media player whether the media player is currently playing media or not.
Invoking this method will immediately apply the new equalizer settings to the audio output of the currently playing media if there is any.
If there is no currently playing media, the new equalizer settings will be applied later if and when new media is played.
Equalizer settings will automatically be applied to subsequently played media.
To disable the equalizer for a media player invoke this method passing nil for the equalizer parameter.
The media player does not keep a reference to the supplied equalizer so it is safe for an application to release the equalizer reference any time after this method returns.
Requires VLC 2.2.
VLCMediaPlayerMBS.SetSubtitleFile(filename as string) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
filename: new video subtitle file
Returns the success status.
VLCMediaPlayerMBS.SetVideoTitleDisplay(position as Integer, timeout as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 15.3 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
position: position at which to display the title, or kVideoTitleDisplayPositionDisable to prevent the title from being displayed.
timeout: title display timeout in milliseconds (ignored if libvlc_position_disable)
Requires VLC 2.1.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
VLCMediaPlayerMBS.ToggleFullScreen
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
See also Fullscreen property.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
VLCMediaPlayerMBS.ToggleTeletext
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
VLCMediaPlayerMBS.VideoAdjust(option as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
option: See kAdjust* constants.
Options that take a different type value are ignored.
Using kAdjustEnable with value 0 stops adjust filter. With other values you start adjust filter.
(Read and Write computed property)
VLCMediaPlayerMBS.VideoAdjustFloat(option as Integer) as single
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
option: See kAdjust* constants.
Options that take a different type value are ignored.
(Read and Write computed property)
VLCMediaPlayerMBS.VideoGetCursor(num as Integer, byref px as Integer, byref py as Integer) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Coordinates are expressed in terms of the decoded video resolution, not in terms of pixels on the screen/viewport (to get the latter, you can query your windowing system directly).
Either of the coordinates may be negative or larger than the corresponding dimension of the video, if the cursor is outside the rendering area.
The coordinates may be out-of-date if the pointer is not located on the video rendering area. LibVLC does not track the pointer if it is outside of the video widget.
LibVLC does not support multiple pointers (it does of course support multiple input devices sharing the same pointer) at the moment.
num: number of the video (starting from, and most commonly 0)
px: get the abscissa.
py: get the ordinate.
Returns true on success, false if the specified video does not exist
VLCMediaPlayerMBS.VideoGetSize(num as Integer, byref px as UInt32, byref py as UInt32) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
num: number of the video (starting from, and most commonly 0)
px: get the pixel width [OUT]
py: get the pixel height [OUT]
Return true on success, false if the specified video does not exist.
VLCMediaPlayerMBS.VideoLogo(option as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Options that take a different type value are ignored.
Passing kLogoEnable as option value has the side effect of starting (arg not 0) or stopping (arg 0) the logo filter.
(Read and Write computed property)
VLCMediaPlayerMBS.VideoMarquee(option as Integer) as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Setting kMarqueeEnable has the side effect of enabling (arg not 0) or disabling (arg 0) the marq filter.
(Read and Write computed property)
VLCMediaPlayerMBS.VideoMarqueeString(option as Integer) as String
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
(Read and Write computed property)
VLCMediaPlayerMBS.VideoSetCallback(width as integer, height as integer, CGContextHandle as integer = 0)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
You can use CopyPicture and CopyMemory methods to query new frame content.
The hasNewFrame property tells you whether a new frame is available.
The plugin will optionally draw the frames into the CGContext you provide.
Please use CopyCGImage to get a CGImage from image buffer.
Some examples using this method:
VLCMediaPlayerMBS.VideoSetDeinterlace(Mode as string)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Mode: Type of deinterlace filter, "" to disable.
VLCMediaPlayerMBS.VideoSetFormat(chroma as string, width as UInt32, height as UInt32, pitch as UInt32)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
This only works in combination with SetVideoCallbacks().
chroma: a four-characters string identifying the chroma (e.g. "RV32" or "YUYV")
width: pixel width
height: pixel height
pitch: line pitch (in bytes)
All pixel planes are expected to have the same pitch.
VLCMediaPlayerMBS.VideoSetKeyInput(on as boolean)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
By default and for historical reasons, keyboard events are handled by the LibVLC video widget.
On X11, there can be only one subscriber for key press and mouse click events per window. If your application has subscribed to those events for the X window ID of the video widget, then LibVLC will not be able to handle key presses and mouse clicks in any case.
This function is only implemented for X11 and Win32 at the moment.
on: true to handle key press events, false to ignore them.
VLCMediaPlayerMBS.VideoSetLogoString(option as Integer, logo as String)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
Options that take a different type value are ignored.
VLCMediaPlayerMBS.VideoSetMouseInput(on as boolean)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
By default, those events are handled. This is needed for DVD menus to work, as well as a few video filters such as "puzzle".
This function is only implemented for X11 and Win32 at the moment.
on: true to handle mouse click events, false to ignore them.
VLCMediaPlayerMBS.VideoTakeSnapshot(num as Integer, path as string, width as Integer, height as Integer) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | VLC | MBS VLC Plugin | 12.2 | ✅ Yes | ✅ Yes | ✅ Yes | ❌ No | Desktop, Console & Web |
If width AND height is 0, original size is used.
If width XOR height is 0, original aspect-ratio is preserved. (e.g. width = 0 and height = -1)
num: number of video output (typically 0 for the first/only one)
Path: the path where to save the screenshot to
Width: the snapshot's width
Height: the snapshot's height
Returns true on success, false if the video was not found
Some examples using this method:
The items on this page are in the following plugins: MBS VLC Plugin.