| Microsoft DirectX 9.0 |
The IBasicVideo interface enables applications to set video properties such as the destination and source rectangles. This interface is implemented on the Video Renderer filter, but is exposed to applications through the Filter Graph Manager. Applications should always retrieve this interface from the Filter Graph Manager.
The methods on this interface require that the Video Renderer be connected. Otherwise, all methods return VFW_E_NOT_CONNECTED. Properties set on the Video Renderer persist between successive connections and disconnections.
The IBasicVideo interface manipulates the following rectangles associated with the video image:
The source rectangle is the portion of the original image that gets displayed.
The destination rectangle is the portion of the video window the receives the source rectangle.
The video rectangle is the original video image.
In other words, the video renderer crops the image to the source rectangle, and then stretches or shrinks the cropped image to the destination rectangle. All rectangle dimensions are given in pixels.
In addition to the methods inherited from IDispatch, the IBasicVideo interface exposes the following methods.
| Method | Description |
| get_AvgTimePerFrame | Retrieves the average time between successive frames. |
| get_BitErrorRate | Retrieves the approximate bit error rate of the video stream. |
| get_BitRate | Retrieves the approximate bit rate of the video stream. |
| get_DestinationHeight | Retrieves the height of the destination rectangle. |
| get_DestinationLeft | Retrieves the x-coordinate of the destination rectangle. |
| get_DestinationTop | Retrieves the y-coordinate of the destination rectangle. |
| get_DestinationWidth | Retrieves the width of the destination rectangle. |
| get_SourceHeight | Retrieves the height of the source rectangle. |
| get_SourceLeft | Retrieves the x-coordinate of the source rectangle. |
| get_SourceTop | Retrieves the y-coordinate of the source rectangle. |
| get_SourceWidth | Retrieves the width of the source rectangle. |
| get_VideoHeight | Retrieves the video height. |
| get_VideoWidth | Retrieves the video width. |
| GetCurrentImage | Returns a copy of the current image that is waiting at the renderer. |
| GetDestinationPosition | Retrieves the destination rectangle. |
| GetSourcePosition | Retrieves the source rectangle. |
| GetVideoPaletteEntries | Retrieves the color palette entries required by the video. |
| GetVideoSize | Retrieves the native video dimensions. |
| IsUsingDefaultDestination | Queries whether the renderer is using the default destination rectangle. |
| IsUsingDefaultSource | Queries whether the renderer is using the default source rectangle. |
| put_DestinationHeight | Sets the height of the destination rectangle. |
| put_DestinationLeft | Sets the x-coordinate of the destination rectangle. |
| put_DestinationTop | Sets the y-coordinate of the destination rectangle. |
| put_DestinationWidth | Sets the width of the destination rectangle. |
| put_SourceHeight | Sets the height of the video rectangle. |
| put_SourceLeft | Sets the x-coordinate of the source rectangle. |
| put_SourceTop | Sets the y-coordinate of the source rectangle. |
| put_SourceWidth | Sets the width of the source rectangle. |
| SetDefaultDestinationPosition | Reverts to the default destination rectangle. |
| SetDefaultSourcePosition | Reverts to the default source rectangle. |
| SetDestinationPosition | Sets the destination rectangle. |
| SetSourcePosition | Sets the source rectangle. |