The Virtual Framebuffer

Running Applications Using the Virtual Framebuffer

Once the virtual framebuffer (the qvfb application) is running, it is ready for use: Start a Qtopia Core master application (i.e. construct a QApplication object with the QApplication::GuiServer flag or use the -qws command line parameter. See the Running Applications documentation for details). For example:

    cd path/to/Qtopia/Core/examples/widgets/analogclock
    make
    ./analogclock -qws

Note that as long as the virtual framebuffer is running and the Qtopia Core library supports qvfb, Qtopia Core will automatically detect it and use it by default. Alternatively, the -display option can be used to specify the virtual framebuffer driver. For example:

    cd path/to/Qtopia/Core/examples/widgets/analogclock
    make
    ./analogclock -qws -display QVFb:0

Warning: If qvfb is not running (or the current Qtopia Core library doesn't support it) and the driver is not explicitly specified, Qtopia Core will write to the real framebuffer and the X11 display will be corrupted.

The File Menu

The File menu allows the user to configure the virtual framebuffer display (File|Configure...), save a snapshot of the framebuffer contents (File|Save Image...) and record the movements in the framebuffer (File|Animation...).

When choosing the File|Configure menu item, the qvfb tool provides a configuration dialog allowing the user to customize the display of the virtual framebuffer. The user can modify the size and depth as weel as the Gamma values, and also select the preferred skin (i.e. making the virtual framebuffer simulate the target device environment). In addition, it is possible to emulate a touch screen and a LCD screen.

Target Device Environment The qvfb tool provides various skins for the virtual framebuffer allowing the user to view their application in an environment similar to their target device. The provided skins are: ClamshellPhone pda PDAPhone QtopiaPDA QtopiaPhone-Advanced QtopiaPhone-Simple SmartPhone SmartPhone2 SmartPhoneWithButtons TouchscreenPhone Trolltech-Keypad Trolltech-Touchscreen

Note that when configuring (except when changing the Gamma values only), any applications using the virtual framebuffer will be terminated.

The View Menu

The View menu allows the user to modify the target's refresh rate (View|Refresh Rate...), making qvfb check for updated regions more or less frequently.

The regions of the display that have changed are updated periodically, i.e. the virtual framebuffer is displaying discrete snapshots of the framebuffer rather than each individual drawing operation. For this reason drawing problems such as flickering may not be apparent until the program is run using a real framebuffer. If little drawing is being done, the framebuffer will not show any updates between drawing events. If an application is displaying an animation, the updates will be frequent, and the application and qvfb will compete for processor time.

The View menu also allows the user to zoom the view of the application (View|Zoom *).

[Contents]