Commit 3e3cc022 authored by Alexander Larsson's avatar Alexander Larsson Committed by Alexander Larsson
Browse files

Docs, docs, anyone want docs!

2000-12-06  Alexander Larsson  <alexl@redhat.com>

	* docs/README.linux-fb:
	* docs/Makefile.am:
	Initial GtkFB docs.

	* gdk/linux-fb/Makefile.am:
	Define GDK_DATA_PREFIX.

	* gdk/linux-fb/gdkmain-fb.c:
	Fix typo.
	Change default display to /dev/fb0.

	* gdk/linux-fb/gdkpango-fb.c:
	Add $(prefix)/share/fonts/ to font path.
parent 6d0c6b79
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
2000-12-08 Alexander Larsson <alexl@redhat.com>
* docs/README.linux-fb:
* docs/Makefile.am:
Initial GtkFB docs.
* gdk/linux-fb/Makefile.am:
Define GDK_DATA_PREFIX.
* gdk/linux-fb/gdkmain-fb.c:
Fix typo.
Change default display to /dev/fb0.
* gdk/linux-fb/gdkpango-fb.c:
Add $(prefix)/share/fonts/ to font path.
2000-12-08 Alexander Larsson <alla@lysator.liu.se> 2000-12-08 Alexander Larsson <alla@lysator.liu.se>
* gdk/linux-fb/gdkkeyboard-fb.c: * gdk/linux-fb/gdkkeyboard-fb.c:
......
...@@ -17,6 +17,7 @@ EXTRA_DIST += \ ...@@ -17,6 +17,7 @@ EXTRA_DIST += \
text_widget.txt \ text_widget.txt \
widget_system.txt \ widget_system.txt \
generation.txt \ generation.txt \
README.linux-fb \
gtk-config.txt \ gtk-config.txt \
gtk-config.1.in \ gtk-config.1.in \
gtkdocs_fix gtkdocs_fix
......
About GtkFB:
------------
The linux-fb port of Gtk+, also known as GtkFB is an implementation of
gdk (and therefor 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.
Build requirements:
-------------------
To run GtkFB programs you will need glib, pango and gtk from cvs
HEAD. Make sure you update these at the same time, since changes to
glib and pango often forces changes in gtk+. Pango optionally depends
on libfribidi, but for normal GtkFB usage that can be ignored.
You also need freetype 2, I recommend that you use freetype 2.0.1 or
later, as there was some problems with freetype-config in 2.0.
Freetype can be found at ftp://ftp.freetype.org
Hardware requirements:
----------------------
You need a graphics card with an availible framebuffer driver that can
run in 8, 16, 24 or 32 bpp. I use the matroxfb driver, but i.e. vesafb
should work too. You also need a supported mouse. Currently supported
is ps2 mouse, ms serial mouse and fidmour touchscreen.
Building and installing:
------------------------
First build and install glib and pango as usual, in that order.
Then configure Gtk by running configure (or autogen.sh if running from
cvs) with --with-gdktarget=linux-fb.
Make sure that pango and gtk+ are installed in the same prefix, as
gtk+ installs a new pango module that pango must be able to find.
Then compile as ususal: make; make install
This installs a new pango module that pango must be instructed to
find. This is done by running something like:
pango-querymodules > /your_prefix/etc/pango/pango.modules
(look at this file and make sure it contains a row with fb-basic.so.
Fonts:
------
Since GtkFB uses freetype 2 to render fonts it can render truetype and
postscript type 1 antialiased fonts. At startup it scans these
directories looking for any fonts:
/usr/share/fonts/default/TrueType
/usr/share/fonts/default/Type1
/usr/lib/X11/fonts/TrueType
/usr/lib/X11/fonts/Type1
$(prefix)/share/fonts
It also has a hardcoded font alias handling. This is important because
most program refers to the standard fonts by the names "Sans", "Serif"
and "Monotype". The default aliases in GtkFB maps these to the
M$ truetype fonts: Arial, Times New Roman, and Courier New (you need
to own a copy of Windows to use these) and the type1 fonts URW Gothic,
URW Bookman and Courier. You will need to have at least Arial or URW
Gothic installed, because the "Sans" font is used as a last case font.
Running:
--------
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 testgtk distributed with gtk+ to test
if things work.
If you use a ps2 mouse, make sure that /dev/psaux is readable and
writable.
Make sure gpm is not running.
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:
GDK_VT:
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.
GDK_DISPLAY_MODE:
Specifies the name of a mode in /etc/fb.modes that you want to use.
GDK_DISPLAY_DEPTH:
Specify the desired bit depth of the framebuffer.
GDK_DISPLAY_WIDTH:
Specify the desired width of the framebuffer.
GDK_DISPLAY_HEIGHT:
Specify the desired height of the framebuffer.
GDK_DISPLAY:
Specify the framebuffer device to use. Default is /dev/fb0
GDK_MOUSE_TYPE:
Specify mouse type. Currently supported is:
ps2 - PS/2 mouse
ms - Microsoft serial mouse
fidmour - touch screen
Default is ps2.
GDK_KEYBOARD_TYPE:
Specify keyboard type. Currently suppored is
xlate - normal tty mode keyboard. Somewhat limited.
raw - read from the tty in RAW mode.
Warning, can cause problems if the GtkFB program crashes
and the mode is not restored. You must run as root to use
this.
Default is xlate.
HACKING:
--------
To be written.
- Alexander Larsson <alexl@redhat.com>
2000/12/06
...@@ -5,6 +5,7 @@ libgdkfbincludedir = $(includedir)/gtk-2.0/gdk/linux-fb ...@@ -5,6 +5,7 @@ libgdkfbincludedir = $(includedir)/gtk-2.0/gdk/linux-fb
INCLUDES = @STRIP_BEGIN@ \ INCLUDES = @STRIP_BEGIN@ \
-DG_LOG_DOMAIN=\"Gdk\" \ -DG_LOG_DOMAIN=\"Gdk\" \
-DGDK_DATA_PREFIX=\"$(prefix)\" \
-I$(top_srcdir) \ -I$(top_srcdir) \
-I$(top_srcdir)/gdk \ -I$(top_srcdir)/gdk \
-I$(top_builddir)/gdk \ -I$(top_builddir)/gdk \
......
...@@ -521,7 +521,7 @@ gdk_fb_display_new () ...@@ -521,7 +521,7 @@ gdk_fb_display_new ()
vt = strtol (s, &send, 10); vt = strtol (s, &send, 10);
if (s==send) if (s==send)
{ {
g_warning ("Cannot parse GDK_TTY"); g_warning ("Cannot parse GDK_VT");
vt = display->start_vt; vt = display->start_vt;
} }
} }
...@@ -1035,7 +1035,7 @@ gdk_get_display(void) ...@@ -1035,7 +1035,7 @@ gdk_get_display(void)
s = getenv ("GDK_DISPLAY"); s = getenv ("GDK_DISPLAY");
if (s==0) if (s==0)
s = "/dev/fb"; s = "/dev/fb0";
return g_strdup (s); return g_strdup (s);
} }
......
...@@ -408,6 +408,7 @@ pango_fb_font_map_init (PangoFBFontMap *fontmap) ...@@ -408,6 +408,7 @@ pango_fb_font_map_init (PangoFBFontMap *fontmap)
"/usr/share/fonts/default/Type1", "/usr/share/fonts/default/Type1",
"/usr/lib/X11/fonts/TrueType", "/usr/lib/X11/fonts/TrueType",
"/usr/lib/X11/fonts/Type1", "/usr/lib/X11/fonts/Type1",
GDK_DATA_PREFIX "/share/fonts",
NULL NULL
}; };
int i; int i;
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment