VirtualBox Main API
Public Member Functions | Public Attributes | List of all members
IFramebufferOverlay Interface Reference

The IFramebufferOverlay interface represents an alpha blended overlay for displaying status icons above an IFramebuffer. More...

Inheritance diagram for IFramebufferOverlay:
IFramebuffer

Public Member Functions

void move (in unsigned long x, in unsigned long y)
 Changes the overlay's position relative to the IFramebuffer.
- Public Member Functions inherited from IFramebuffer
void lock ()
 Locks the frame buffer.
void unlock ()
 Unlocks the frame buffer.
void notifyUpdate (in unsigned long x, in unsigned long y, in unsigned long width, in unsigned long height)
 Informs about an update.
void requestResize (in unsigned long screenId, in unsigned long pixelFormat, in octetPtr VRAM, in unsigned long bitsPerPixel, in unsigned long bytesPerLine, in unsigned long width, in unsigned long height,[retval] out boolean finished)
 Requests a size and pixel format change.
void videoModeSupported (in unsigned long width, in unsigned long height, in unsigned long bpp,[retval] out boolean supported)
 Returns whether the frame buffer implementation is willing to support a given video mode.
void getVisibleRegion (in octetPtr rectangles, in unsigned long count,[retval] out unsigned long countCopied)
 Returns the visible region of this frame buffer.
void setVisibleRegion (in octetPtr rectangles, in unsigned long count)
 Suggests a new visible region to this frame buffer.
void processVHWACommand (in octetPtr command)
 Posts a Video HW Acceleration Command to the frame buffer for processing.
void notify3DEvent (in unsigned long type, in octetPtr data)
 Notifies framebuffer about 3D backend event.

Public Attributes

readonly attribute unsigned long x
 X position of the overlay, relative to the frame buffer.
readonly attribute unsigned long y
 Y position of the overlay, relative to the frame buffer.
attribute boolean visible
 Whether the overlay is currently visible.
attribute unsigned long alpha
 The global alpha value for the overlay.
- Public Attributes inherited from IFramebuffer
readonly attribute octetPtr address
 Address of the start byte of the frame buffer.
readonly attribute unsigned long width
 Frame buffer width, in pixels.
readonly attribute unsigned long height
 Frame buffer height, in pixels.
readonly attribute unsigned long bitsPerPixel
 Color depth, in bits per pixel.
readonly attribute unsigned long bytesPerLine
 Scan line size, in bytes.
readonly attribute unsigned long pixelFormat
 Frame buffer pixel format.
readonly attribute boolean usesGuestVRAM
 Defines whether this frame buffer uses the virtual video card's memory buffer (guest VRAM) directly or not.
readonly attribute unsigned long heightReduction
 Hint from the frame buffer about how much of the standard screen height it wants to use for itself.
readonly attribute
IFramebufferOverlay 
overlay
 An alpha-blended overlay which is superposed over the frame buffer.
readonly attribute long long winId
 Platform-dependent identifier of the window where context of this frame buffer is drawn, or zero if there's no such window.

Detailed Description

The IFramebufferOverlay interface represents an alpha blended overlay for displaying status icons above an IFramebuffer.

It is always created not visible, so that it must be explicitly shown. It only covers a portion of the IFramebuffer, determined by its width, height and co-ordinates. It is always in packed pixel little-endian 32bit ARGB (in that order) format, and may be written to directly. Do re-read the width though, after setting it, as it may be adjusted (increased) to make it more suitable for the front end.

Interface ID:
{0BCC1C7E-E415-47D2-BFDB-E4C705FB0F47}

Member Function Documentation

void IFramebufferOverlay::move ( in unsigned long  x,
in unsigned long  y 
)

Changes the overlay's position relative to the IFramebuffer.

Member Data Documentation

readonly attribute unsigned long IFramebufferOverlay::x

X position of the overlay, relative to the frame buffer.

readonly attribute unsigned long IFramebufferOverlay::y

Y position of the overlay, relative to the frame buffer.

attribute boolean IFramebufferOverlay::visible

Whether the overlay is currently visible.

attribute unsigned long IFramebufferOverlay::alpha

The global alpha value for the overlay.

This may or may not be supported by a given front end.