|
Server : Apache/2.2.17 (Unix) mod_ssl/2.2.17 OpenSSL/0.9.8e-fips-rhel5 DAV/2 PHP/5.2.17 System : Linux localhost 2.6.18-419.el5 #1 SMP Fri Feb 24 22:47:42 UTC 2017 x86_64 User : nobody ( 99) PHP Version : 5.2.17 Disable Function : NONE Directory : /usr/share/gtk-doc/html/gtk/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Using GTK+ on the Framebuffer</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.69.1">
<link rel="start" href="index.html" title="GTK+ Reference Manual">
<link rel="up" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="prev" href="gtk-directfb.html" title="Using GTK+ on DirectFB">
<link rel="next" href="gtk-resources.html" title="Mailing lists and bug reports">
<meta name="generator" content="GTK-Doc V1.6 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
<link rel="part" href="gtk.html" title="Part I. GTK+ Overview">
<link rel="part" href="gtkbase.html" title="Part II. GTK+ Core Reference">
<link rel="part" href="gtkobjects.html" title="Part III. GTK+ Widgets and Objects">
<link rel="chapter" href="ch01.html" title="Object Hierarchy">
<link rel="chapter" href="ch02.html" title="Widget Gallery">
<link rel="chapter" href="WindowWidgets.html" title="Windows">
<link rel="chapter" href="DisplayWidgets.html" title="Display Widgets">
<link rel="chapter" href="ButtonWidgets.html" title="Buttons and Toggles">
<link rel="chapter" href="NumericEntry.html" title="Numeric/Text Data Entry">
<link rel="chapter" href="TextWidgetObjects.html" title="Multiline Text Editor">
<link rel="chapter" href="TreeWidgetObjects.html" title="Tree, List and Icon Grid Widgets">
<link rel="chapter" href="MenusAndCombos.html" title="Menus, Combo Box, Toolbar">
<link rel="chapter" href="Actions.html" title="Action-based menus and toolbars">
<link rel="chapter" href="SelectorWidgets.html" title="Selectors (File/Font/Color/Input Devices)">
<link rel="chapter" href="LayoutContainers.html" title="Layout Containers">
<link rel="chapter" href="Ornaments.html" title="Ornaments">
<link rel="chapter" href="ScrollingWidgets.html" title="Scrolling">
<link rel="chapter" href="Printing.html" title="Printing">
<link rel="chapter" href="MiscObjects.html" title="Miscellaneous">
<link rel="chapter" href="AbstractObjects.html" title="Abstract Base Classes">
<link rel="chapter" href="PlugSocket.html" title="Cross-process Embedding">
<link rel="chapter" href="SpecialObjects.html" title="Special-purpose features">
<link rel="chapter" href="RecentDocuments.html" title="Recently Used Documents">
<link rel="chapter" href="DeprecatedObjects.html" title="Deprecated">
<link rel="part" href="migrating.html" title="Part IV. Migrating from Previous Versions of GTK+">
<link rel="chapter" href="gtk-migrating-checklist.html" title="Migration Checklist">
<link rel="chapter" href="gtk-migrating-GtkFileChooser.html" title="Migrating from GtkFileSelection to GtkFileChooser">
<link rel="chapter" href="gtk-migrating-GtkAction.html" title="Migrating from old menu and toolbar systems to GtkAction">
<link rel="chapter" href="gtk-migrating-GtkComboBox.html" title="Migrating from GtkOptionMenu and GtkCombo to GtkComboBox and
GtkComboBoxEntry">
<link rel="chapter" href="gtk-migrating-GtkIconView.html" title="Migrating from GnomeIconList to GtkIconView">
<link rel="chapter" href="gtk-migrating-GtkAboutDialog.html" title="Migrating from GnomeAbout to GtkAboutDialog">
<link rel="chapter" href="gtk-migrating-GtkColorButton.html" title="Migrating from GnomeColorPicker to GtkColorButton">
<link rel="chapter" href="gtk-migrating-GtkAssistant.html" title="Migrating from GnomeDruid to GtkAssistant">
<link rel="chapter" href="gtk-migrating-GtkRecentChooser.html" title="Migrating from EggRecent to GtkRecentChooser">
<link rel="chapter" href="gtk-migrating-GtkLinkButton.html" title="Migrating from GnomeHRef to GtkLinkButton">
<link rel="part" href="pt05.html" title="Part V. GTK+ Tools">
<link rel="glossary" href="glossary.html" title="Glossary">
<link rel="index" href="ix01.html" title="Index">
<link rel="index" href="ix02.html" title="Index of deprecated symbols">
<link rel="index" href="ix03.html" title="Index of new symbols in 2.2">
<link rel="index" href="ix04.html" title="Index of new symbols in 2.4">
<link rel="index" href="ix05.html" title="Index of new symbols in 2.6">
<link rel="index" href="ix06.html" title="Index of new symbols in 2.8">
<link rel="index" href="ix07.html" title="Index of new symbols in 2.10">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle">
<td><a accesskey="p" href="gtk-directfb.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="gtk.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ Reference Manual</th>
<td><a accesskey="n" href="gtk-resources.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry" lang="en">
<a name="gtk-framebuffer"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle">Using GTK+ on the Framebuffer</span></h2>
<p>Using GTK+ on the Framebuffer —
Linux framebuffer aspects of using GTK+
</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1" lang="en">
<a name="id2557953"></a><h2>GTK+ for the Linux Framebuffer</h2>
<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
<h3 class="title">Note</h3>
<p>
The linux-fb GDK target is unmaintained and may not work or even
compile. The information below may still be helpful; also there are
several patches in bugzilla which may help with making the linux-fb
code compilable.
</p>
</div>
<p>
The linux-fb port of GTK+, also known as GtkFB is an implementation of
GDK (and therefore GTK+) that runs on the Linux framebuffer. It runs in
a single process that doesn't need X. It should run most GTK+ programs
without any changes to the source.
</p>
<div class="refsect2" lang="en">
<a name="id2557874"></a><h3>Build requirements</h3>
<p>
You need GTK+ 2.0; the 1.2.x series does not have framebuffer support.
To compile GTK+ with framebuffer support you will need FreeType 2; we
recommend FreeType 2.0.1 or later, as there was some problems with
<span><strong class="command">freetype-config</strong></span> in 2.0. Make sure that you install
FreeType before Pango, since Pango also needs it. FreeType can be found at
<a href="ftp://ftp.freetype.org" target="_top">ftp://ftp.freetype.org</a>. You also
need fontconfig in order to properly use the FreeType 2 backend in Pango.
Fontconfig depends on FreeType as well. Fontconfig can be found at
<a href="http://fontconfig.org" target="_top">http://fontconfig.org</a>.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2558774"></a><h3>Hardware requirements</h3>
<p>
You need a graphics card with an available framebuffer driver that can
run in 8, 16, 24 or 32 bpp, such as matroxfb or vesafb. You also need
a supported mouse. GTK+ currently supports the ps2 mouse, ms serial
mouse and fidmour touchscreen. Additional hardware support should
be simple to add.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2558788"></a><h3>Building and installing</h3>
<p>
First build and install GLib, ATK and Pango as usual, in that order.
Then configure GTK+ by running <span><strong class="command">configure</strong></span> (or
<span><strong class="command">autogen.sh</strong></span> if running from
CVS) with <code class="option">--with-gdktarget=linux-fb</code>.
</p>
<p>Then compile as usual: <span><strong class="command">make; make install</strong></span></p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2558823"></a><h3>Fonts</h3>
<p>
Since GtkFB uses FreeType 2 to render fonts it can render TrueType and
Postscript type 1 antialiased fonts.
</p>
<p>
GtkFB uses fontconfig for configuration of font information, including
directories and aliases. Make sure that you have your fonts.conf file
configured with where your TrueType and Type1 fonts are. Please refer to the
fontconfig documentation for more information.
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2558842"></a><h3>Running</h3>
<p>
To run a program you should only need to start it, but there are some
things that can cause problems, and some things that can be controlled
by environment variables. Try <span class="application">gtk-demo</span> distributed
with GTK+ to test if things work.
</p>
<p>
If you use a ps2 mouse, make sure that <code class="filename">/dev/psaux</code> is
readable and writable.
</p>
<p>Make sure <span><strong class="command">gpm</strong></span> is not running.</p>
<p>If you don't specify anything GtkFB will start up in the current
virtual console in the current resolution and bit-depth. This can be
changed by specifying environment variables:
</p>
<p><a name="fb-envar"></a>
</p>
<pre class="programlisting">
<code class="envar">GDK_VT</code>:
unset means open on the current VT.
0-9: open on the specified VT. Make sure you have read/write rights
there.
new: Allocate a new VT after the last currently used one.
<code class="envar">GDK_DISPLAY_MODE</code>:
Specifies the name of a mode in <code class="filename">/etc/fb.modes</code> that you
want to use.
<code class="envar">GDK_DISPLAY_DEPTH</code>:
Specify the desired bit depth of the framebuffer.
<code class="envar">GDK_DISPLAY_WIDTH</code>:
Specify the desired width of the framebuffer.
<code class="envar">GDK_DISPLAY_HEIGHT</code>:
Specify the desired height of the framebuffer.
<code class="envar">GDK_DISPLAY</code>:
Specify the framebuffer device to use. Default is <code class="filename">/dev/fb0</code>.
<code class="envar">GDK_MOUSE_TYPE</code>:
Specify mouse type. Currently supported is:
ps2 - PS/2 mouse
imps2 - PS/2 intellimouse (wheelmouse)
ms - Microsoft serial mouse
fidmour - touch screen
Default is ps2.
<code class="envar">GDK_KEYBOARD_TYPE</code>:
Specify keyboard type. Currently supported is
xlate - normal tty mode keyboard.
Quite limited, cannot detect key up/key down events. Doesn't
handle ctrl/alt/shift for all keys. This is the default driver,
but should not be used in "production" use.
raw - read from the tty in RAW mode.
Sets the keyboard in RAW mode and handles all the keycodes. This
gives correct handling of modifiers and key up/down events. You
must be root to use this. If you use this for development or
debugging it is recommended to enable magic sysrq handling in the
kernel. Then you can use ALT-SysRQ-r to turn the keyboard back to
normal mode.
Default is xlate.
</pre>
<p>
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id2558962"></a><h3>Debug features</h3>
<p>Pressing Ctrl-Alt-Return repaints the whole screen.
Unfortunately this cannot be pressed when using the xlate keyboard
driver, so instead you can use shift-F1 instead when using this
driver.
</p>
<p>Pressing Ctrl-Alt-BackSpace kills the GtkFB program. (This can't be
pressed in the xlate driver, so instead you can use shift-F8.)</p>
</div>
</div>
</div>
</body>
</html>