63 lines
2.6 KiB
Plaintext
63 lines
2.6 KiB
Plaintext
|
|
INTRODUCTION
|
|
============
|
|
Clutter is an open source software library for creating fast, visually rich and animated
|
|
graphical user interfaces. For more information see http://clutter-project.org
|
|
|
|
|
|
BUILDING CLUTTER
|
|
================
|
|
Currently only building with MSVC is supported (please feel free to contribute a different
|
|
build system.
|
|
|
|
To build clutter, you will need runtime + dev libraries and headers for:
|
|
|
|
glib & co.
|
|
----------
|
|
glib, gobject, gmodule, gdk pixbuf, freetype, fontconfig, pango, pangoft2, gettext, iconv,
|
|
expat, these can be found at Tor Lillqvist's site, http://www.gimp.org/~tml/gimp/win32/.
|
|
The simplest way to install the runtimes is probably to install Gimp (http://gimp.org), but
|
|
the dev packages you will need to install by hand (not forgetting to tell your MSVC where
|
|
to look for the includes and libs).
|
|
|
|
In addition to the libs, you will also need glib-genmarshal and glib-mkenums programs,
|
|
both of which come with the glib developement packages, but make sure that the releveant
|
|
bin directory is added to your MSVC path; glib-mkenums is a perl script, so you will also
|
|
need perl installed in MSVC path. Unfortunately, due to the severe limitations of the
|
|
cmd.exe shell, I have ended up hardcoding the location of glib-mkmenus to the custom build
|
|
rules for clutter-enum-types.c.in and clutter-enum-types.h.in, so you will need to edit
|
|
those to match your install (if you can come up with a better way of doing this, patches
|
|
are, of course, welcome).
|
|
|
|
SDL
|
|
---
|
|
The windows port uses sdl backend; you can get the necessary files from http://libsdl.org/
|
|
(or feel free to write a different backend).
|
|
|
|
GLee
|
|
----
|
|
Believe it or not, windows in 2007 only supports OpenGL 1.1 specification (which is a
|
|
decade old). Glee is a library by Ben Woodhouse, which wraps the OpenGL extension API
|
|
and eliminates the need to load any post 1.1 OpenGL functions (up to standard 2.2) as
|
|
extensions; you can get it from http://elf-stone.com/glee.php.
|
|
|
|
Known Issues
|
|
============
|
|
|
|
* Could not include clutter-marshal.h: no such a file or directory -- this sometimes happens
|
|
for reasons unknown. clutter-marshal.h is generated from the clutter-marshal.list; compiling
|
|
clutter-marshal.list twice in succession usually fixes this.
|
|
|
|
* test-perspective:
|
|
There are some issues with the SDL backend running in fullscreen mode (it does not work).
|
|
|
|
* test-offscreen:
|
|
Offscreen rendering is currently not supported by the SDL backend; feel free to fix this.
|
|
|
|
* test-textures:
|
|
Does not work; unsure of the causes.
|
|
|
|
Bugs
|
|
====
|
|
Please report bugs, submit patches, etc., to http://bugzilla.o-hand.com/
|