Platforms to show: All Mac Windows Linux Cross-Platform
Back to DirectShowVideoWindowMBS class.
DirectShowVideoWindowMBS.AutoShow as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
By default, when the filter graph changes state to paused or running, the video renderer shows the video window and moves it to the foreground. If the user closes the window, it will not automatically reappear.
(Read and Write computed property)
DirectShowVideoWindowMBS.BackgroundPalette as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
If BackgroundPalette is true and the video image requires a palette, the video renderer will realize that palette in the background. Any colors that the palette uses will change to their closest match in the display palette prior to drawing. This ensures that an application will not have its palette disturbed. However, it imposes severe performance penalties on the video.
(Read and Write computed property)
DirectShowVideoWindowMBS.BorderColor as color
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
If the destination rectangle is smaller than the client area of the video window, a border is exposed around the edges of the video. The default color is black. Use this method to override the default color. If a palette is in use, a nonsystem color is converted to its closest match.
(Read and Write computed property)
DirectShowVideoWindowMBS.Caption as string
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
(Read and Write computed property)
DirectShowVideoWindowMBS.Constructor Private
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
DirectShowVideoWindowMBS.FullScreenMode as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Set to true to switch to full-screen mode. Set to false to disable full-screen mode. (Default.)
Lasterror is set.
Depending on the video renderer, the switch to full-screen mode may not be visible until the application runs or pauses the graph. In full-screen mode, if the user switches away from the application (for example, using ALT + TAB), the Filter Graph Manager sends an EC_FULLSCREEN_LOST event.
The following remarks describe how the Filter Graph Manager implements full-screen mode. Application developers can probably ignore this information, but it may be useful if you are writing a custom video renderer.
When an application switches to full-screen mode, the Filter Graph Manager searches for a video renderer that will function most efficiently. In order of preference, these are:
- Any video renderer in the filter graph that natively supports full-screen mode.
- Any video renderer in the filter graph that can stretch the video to full-screen without a significant performance cost.
- The Full Screen Renderer filter.
- Any video renderer in the filter graph that supports DirectShowVideoWindowMBS.
For the first option, the Filter Graph Manager sets FullScreenMode on every video renderer in the graph. Most renderers return E_NOTIMPL, indicating the filter does not natively support full-screen mode. If any renderer returns a value not equal to E_NOTIMPL, the Filter Graph Manager uses that one.
For the second option, the Filter Graph Manager calls GetMaxIdealImageSize and GetMinIdealImageSize on every video renderer in the graph. If the size of the display falls within the filter's reported range, it indicates that the filter can stretch the video without a significant performance cost.
Note If the graph is stopped, the Filter Graph Manager pauses each renderer before calling these methods. This gives the renderer an opportunity to initialize any resources it needs, because many renderers cannot determine these values while they are stopped.
Except on older hardware, the second option will generally succeed. The third option is to use the Full Screen Renderer filter, adding it to the graph if necessary. The fourth option is simply to find the first renderer in the graph that supports DirectShowVideoWindowMBS, and stretch the video regardless of performance.
(Read and Write computed property)
DirectShowVideoWindowMBS.GetMaxIdealImageSize(byref width as Integer, byref height as Integer)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Width: Receives the maximum ideal width, in pixels.
Height: Receives the maximum ideal height, in pixels.
Lasterror is set.
The maximum ideal size may differ from the native video size, because the video hardware might have specific stretching requirements.
DirectShowVideoWindowMBS.GetMinIdealImageSize(byref width as Integer, byref height as Integer)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Width: Receives the minimum ideal width, in pixels.
Height: Receives the minimum ideal height, in pixels.
Lasterror is set.
The maximum ideal size may differ from the native video size, because the video hardware might have specific stretching requirements.
DirectShowVideoWindowMBS.GetRestorePosition(byref left as Integer, byref top as Integer, byref width as Integer, byref height as Integer)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Left: Receives the x-coordinate, in pixels.
Top: Receives the y-coordinate, in pixels.
Width: Receives the width of the window, in pixels.
Height: Receives the height of the window, in pixels.
Lasterror is set.
If the video window is minimized or maximized, you can use this method to get the window's restored position.
DirectShowVideoWindowMBS.GetWindowPosition(byref left as Integer, byref top as Integer, byref width as Integer, byref height as Integer)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Left: Receives the x-coordinate, in pixels.
Top: Receives the y-coordinate, in pixels.
Width: Receives the width of the window, in pixels.
Height: Receives the height of the window, in pixels.
Lasterror is set.
This method has the same effect as querying left, top, width and height methods.
DirectShowVideoWindowMBS.Height as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
(Read and Write computed property)
DirectShowVideoWindowMBS.HideCursor(hide as boolean)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Hide: Whether to hide or show the cursor.
Lasterror is set.
DirectShowVideoWindowMBS.IsCursorHidden as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
DirectShowVideoWindowMBS.Left as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
(Read and Write computed property)
DirectShowVideoWindowMBS.SetWindowForeground(Focus as Boolean)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Focus: whether to give the window focus.
Lasterror is set.
DirectShowVideoWindowMBS.SetWindowPosition(left as Integer, top as Integer, width as Integer, height as Integer)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| method | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Left: The x-coordinate, in pixels.
Top: The y-coordinate, in pixels.
Width: The width, in pixels.
Height: The height, in pixels.
Lasterror is set.
This method has the same effect as setting the Left, Top, Width, and Height methods.
If resizing the window to the specified dimensions is impossible, this method modifies the window's size and location to make the window fit. Call the GetWindowPosition method to determine the result.
DirectShowVideoWindowMBS.Top as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
(Read and Write computed property)
DirectShowVideoWindowMBS.Visible as Boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Set to true to show the window or set to false to hide the window.
Lasterror is set.
(Read and Write computed property)
DirectShowVideoWindowMBS.Width as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
(Read and Write computed property)
DirectShowVideoWindowMBS.WindowState as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
See MSDN page for ShowWindow for SW_* constants:
http://msdn.microsoft.com/en-us/library/windows/desktop/ms633548(v=vs.85).aspx
(Read and Write computed property)
DirectShowVideoWindowMBS.WindowStyle as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
See MSDN for SetWindowLong for details on the WS_* constants.
(Read and Write computed property)
Some examples using this property:
DirectShowVideoWindowMBS.WindowStyleEx as Integer
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | DirectShow | MBS Win Plugin | 12.1 | ❌ No | ✅ Yes | ❌ No | ❌ No | Desktop, Console & Web |
Lasterror is set.
See MSDN for SetWindowLong for details on the WS_EX_* constants.
(Read and Write computed property)
The items on this page are in the following plugins: MBS Win Plugin.
