<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /tmp/qt-3.0-reggie-28534/qt-x11-free-3.0.2/doc/qvfb.doc:36 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Qt/Embedded Virtual Framebuffer</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">Home</font></a>
| <a href="classes.html">
<font color="#004faf">All Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>Qt/Embedded Virtual Framebuffer</h1>
<p> The virtual framebuffer allows Qt/Embedded programs to be developed on your
desktop machine, without switching between consoles and X11.
<p> The virtual framebuffer is located in <tt>$QTDIR/tools/qvfb</tt>.
<p> <h2> Using the Virtual Framebuffer
</h2>
<a name="1"></a><p> <ol type=1>
<li> Make sure QT_NO_QWS_VFB in <tt>$QTDIR/src/tools/qconfig.h</tt> is <em>not</em> defined
and compile the Qt/Embedded library.
<li> Compile <tt>qvfb</tt> as a normal Qt/X11 application and run it. Do <em>not</em>
compile it as a Qt/Embedded application.
<li> Start a Qt/Embedded master application (i.e., construct <a href="qapplication.html">QApplication</a> with
QApplication::GuiServer flag or use the -qws command line parameter).
You will need to specify to the server that you wish to use the virtual
framebuffer driver, e.g.:
<pre>
widgets -qws -display QVFb:0
</pre>
<li> You may prefer to set the <tt>QWS_DISPLAY</tt> environment variable to
be <tt>QVFb:0</tt>.
</ol>
<p> <tt>qvfb</tt> supports the following command line options:
<p> <ul>
<li> <tt>-width width</tt>
<p> the width of the virtual framebuffer (default: 240).
<p> <li> <tt>-height height</tt>
<p> the height of the virtual framebuffer (default: 320).
<p> <li> <tt>-depth depth</tt>
<p> the depth of the virtual framebuffer (1, 8 or 32; default: 8).
<p> <li> <tt>-nocursor</tt>
<p> do not display the X11 cursor in the framebuffer window.
<p> <li> <tt>-qwsdisplay :id</tt>
<p> the Qt/Embedded display id to provide (default: 0).
<p> </ul>
<p> <h2> Virtual Framebuffer Design
</h2>
<a name="2"></a><p> The virtual framebuffer emulates a framebuffer using a shared memory region
(the virtual frame buffer) and a utility to display the framebuffer in a
window (<tt>qvfb</tt>). The regions of the display that have changed are updated
periodically, so you will see 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.
<p> The target refresh rate can be set via the <b>View|Refresh Rate</b>
menu item. This will cause <tt>qvfb</tt> to check for updated regions more
frequently. The rate is a target only. 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 <tt>qvfb</tt> will compete for processor
time.
<p> Mouse and keyboard events are passed to the Qt/Embedded master process via
named pipes.
<p> The virtual framebuffer is a development tool only. No security issues have
been considered in the virtual framebuffer design. It should be avoided
in a production environment; QT_NO_QWS_VFB should always be defined
in production libraries.
<p>
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright © 2001
<a href="http://www.trolltech.com">Trolltech</a><td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td align=right><div align=right>Qt version 3.0.2</div>
</table></div></address></body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
112b0974ad288f6cd55bf971ee6026a9
>
files
>
704
