Go to file
Emmanuele Bassi e4b9a507e3 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com>
* configure.ac: Enable debug messages also when
	--enable-debug is set to "minimum".

	* clutter/Makefile.am:
	* clutter/clutter-debug.h: Move all debugging macros inside
	this private header; make all debug macros depend on the
	CLUTTER_ENABLE_DEBUG compile time define, controlled by
	the --enable-debug configure switch; add G_LOG_DOMAIN define.

	* clutter/clutter-main.c: Clean up the debug stuff; add
	command line argument parsing using GOption; the debug
	messages now are triggered like this:

	  CLUTTER_DEBUG=section:section:... clutter-app
	
	or like this:

	  clutter-app --clutter-debug=section:section:...
	
	where "section" is one of the sections listed in clutter-main.c,
	or "all", for all sections; each section is bound to a flag,
	which can be used to define a domain when adding a debug note
	using the CLUTTER_NOTE() macro; the old CLUTTER_DBG() macro is
	just a wrapper around that, under the CLUTTER_DEBUG_MISC domain;
	CLUTTER_NOTE() is used like this:

	  CLUTTER_NOTE (DOMAIN, log-function);
	
	where log function is g_printerr(), g_message(), g_warning(),
	g_critical() or directly g_log() - for instance:

	  CLUTTER_NOTE (PANGO, g_warning ("Cache miss: %d", glyph));

	will print the warning only if the "pango" flag has been
	set to the CLUTTER_DEBUG envvar or passed to the --clutter-debug
	command line argument.

	similar to CLUTTER_SHOW_FPS, there's also the --clutter-show-fps
	command line switch; also, the --display and --screen command
	line switches have been added: the first overrides the DISPLAY
	envvar and the second controls the X screen used by Clutter to
	get the root window on the display.

	* clutter/clutter-main.h:
	* clutter/clutter-main.c: Add extended support for GOption
	in Clutter; use clutter_init_with_args() to let Clutter
	parse your own command line arguments; use instead
	clutter_get_option_group() to get the GOptionGroup used by
	Clutter if you want to do the parsing yourself with
	g_option_context_parse(). The init sequence has been verified,
	updated and moved into common functions where possible.

	* clutter/pango/pangoclutter-render.c:
	* clutter/*.c: Include "clutter-debug.h" where needed; use
	CLUTTER_NOTE() instead of CLUTTER_DBG().

	* examples/super-oh.c: Use the new clutter_init_with_args()
	function, and add a --num-hands command line switch to
	the SuperOH example code controlling the number of hands at
	runtime.
2006-11-21 21:27:53 +00:00
clutter 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com> 2006-11-21 21:27:53 +00:00
doc 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com> 2006-11-21 21:27:53 +00:00
examples 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com> 2006-11-21 21:27:53 +00:00
gtk 2006-09-14 Matthew Allum <mallum@openedhand.com> 2006-09-14 17:18:54 +00:00
AUTHORS 2006-06-14 Matthew Allum <mallum@openedhand.com> 2006-06-13 22:29:51 +00:00
autogen.sh Merge gobject-branch into trunk 2006-05-29 08:59:36 +00:00
ChangeLog 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com> 2006-11-21 21:27:53 +00:00
clutter.doap 2006-11-20 Matthew Allum <mallum@openedhand.com> 2006-11-20 20:29:57 +00:00
clutter.pc.in 2006-08-30 Jorn Baayen <jorn@openedhand.com> 2006-08-30 13:57:03 +00:00
configure.ac 2006-11-21 Emmanuele Bassi <ebassi@openedhand.com> 2006-11-21 21:27:53 +00:00
COPYING Merge gobject-branch into trunk 2006-05-29 08:59:36 +00:00
Makefile.am 2006-06-23 Ross Burton <ross@openedhand.com> 2006-06-23 11:36:54 +00:00
NEWS 2006-06-22 Matthew Allum <mallum@openedhand.com> 2006-06-22 14:57:25 +00:00
README 2006-08-30 Jorn Baayen <jorn@openedhand.com> 2006-08-30 13:48:48 +00:00
TODO 2006-06-20 Matthew Allum <mallum@openedhand.com> 2006-06-20 20:29:45 +00:00

Clutter README.
===============

Clutter aims to give a nice easy GObject based API for creating fast,
mainly 2D single window stylalised applications such as media box
UI's, presentaions, kiosk style apps etc. It uses OpenGL for rendering.

Its not meant to be a full featured GUI toolkit for regular desktop
apps nor provide a general interface to *all* openGL functionality.

It currently uses fairly low end GL functionality with an aim to still
work well on open source graphics drivers as well as possibly making
an eventual GL ES port feasable.

Clutter currently requires GLib >= 2.8, GdkPixbuf and OpenGL >= 1.2.
Its also recommended you have some kind of working hardware OpenGL on
your target system.

Clutter is LGPL licensed.

If you want to hack on and improve clutter check the TODO file.