NEWS

   1 Clutter 0.9.8 (17/07/2009)
   2 ===============================================================================
   3
   4   * List of changes since 0.9.6
   5
   6     o Add more introspection annotations for language bindings.
   7
   8     o Fix a bug in clutter_animation_set_alpha(), which also broke the
   9       clutter_actor_animate_with_alpha() function.
  10
  11     o Check if the stage requires a relayout before showing it; this fixes
  12       a bug in the X11-based backends, especially under compositing window
  13       managers, where a 640x480 window would flicker before the default
  14       stage was shown for the first time.
  15
  16     o Performance fixes for Cogl.
  17
  18     o Sliced textures were broken by the COGL journalling.
  19
  20     o Use the redraw cycle when asynchronously loading textures from
  21       files.
  22
  23     o Miscellaneous compilation fixes for the OS X and Windows backends.
  24
  25     o Allow querying from within the paint function of an Actor whether
  26       the actor is currently being directly painted or by a Clone actor.
  27
  28     o In the GLX backend, when using the non-implicit sync-to-vblank inside
  29       glXSwapBuffers(), call glFinish() to avoid potential tearing.
  30
  31 Many thanks to:
  32
  33   Colin Walters
  34   Evan Martin
  35   Marcos
  36   Owen W. Taylor
  37   Xu Li
  38
  39 Clutter 0.9.6 (01/07/2009)
  40 ===============================================================================
  41
  42   * List of changes since 0.9.4:
  43
  44     o Allow the manipulation of the actor's transformation matrix, so that is
  45       is possible to apply additional transformations in a way that is
  46       compatible with the transformations already applied by the scene graph.
  47
  48     o Fix a race in the X11 backend that happened between resizing the stage
  49       drawable and the call to glViewport().
  50
  51     o Merge the cogl-journal-batching branch; this branch implements batching
  52       the geometry of the elements of the scene graph before sending it to
  53       OpenGL, thus minimizing the number of state changes and improving the
  54       overall performance of Clutter-based applications.
  55
  56     o Add more debugging states for Clutter and COGL, which allow the developer
  57       to track the state of the journal; to check the VBO fallback paths; to
  58       disable picking for reliable profiling; to disable software-side matrix
  59       transformations in favour of the driver/GPU ones.
  60
  61     o Improve the ability to "break out" of COGL by using gl_begin/gl_end
  62       semantics; applications that drop into raw GL are, though, ignoring all
  63       the caching performed by COGL and might incur in performance issues.
  64
  65     o Fixed the :load-async and :load-data-async properties of Texture by
  66       removing the unneeded G_PARAM_CONSTRUCT flag.
  67
  68     o Added an initial migration guide that shows the porting process from
  69       older releases of Clutter to the 1.0 API; the first chapter deals with
  70       the migration from ClutterEffect to the new implicit animations API.
  71
  72     o Fixed MT-safety for the master clock.
  73
  74 Many thanks to:
  75
  76   Ole André Vadla Ravnås
  77   Tim Horton
  78
  79 Clutter 0.9.4 (19/06/2009)
  80 ===============================================================================
  81
  82   * List of changes since 0.9.2:
  83
  84     o Set the layout height in ClutterText, so that wrapping and ellipsization
  85       work correctly to fill all the allocated area.
  86
  87     o Remove all the units-based API, and migrate all the positional and
  88       dimensional accessors to use floating point values when dealing with
  89       pixels. All the properties dealing with pixels now that a floating
  90       point value as well.
  91
  92     o Add the ability to track wether an actor is going to be painted or not,
  93       using the "mapped" flag. This also allows Clutter to be more strict
  94       in the handling of the scenegraph, ensuring correctness and avoiding
  95       wasting resources on nodes that won't be painted.
  96
  97     o Add debugging facilities for COGL, similar to those of Clutter; through
  98       them is also possible to have an on screen debugging mode that shows the
  99       boundaries of each rectangle sent to the GPU.
 100
 101     o Rework "units" into real logical distance units that can be converted
 102       between millimeters, typographic points and ems into pixels.
 103
 104     o Simplify the Animation class to avoid redundancy and the possibility
 105       of it going out of sync with the Timeline and Alpha instances it uses.
 106
 107     o Move every operation into a single "master clock" source that advances
 108       the timelines, dispatches events and redraws the stages in a predictable
 109       sequence, thus avoiding unneeded redraws. The default is to follow the
 110       sync-to-vblank cycle, if it is supported by the drivers.
 111
 112     o Cache the glyphs geometry into a vertex buffer object to avoid
 113       resubmitting too much information to the GPU.
 114
 115     o Rework the behaviour of ClutterModel when a filter is applied.
 116
 117     o Allow submitting premultiplied texture data; this removes the need
 118       for unpremultiplying data in CairoTexture.
 119
 120     o Add a simple API for submitting blending and texture combining modes
 121       through a string description.
 122
 123     o Move Timelines to pure time-based objects.
 124
 125     o Lots of performance improvements.
 126
 127     o Removal of all the deprecated API.
 128
 129     o Removal of all the fixed point entry points.
 130
 131     o Lots of documentation fixes - the coverage is now 99% of the exported
 132       1600 symbols for Clutter and 80%+ of the 300 exported symbols for COGL.
 133
 134     o Generate the GObject Introspection data for both Clutter and COGL
 135       at build time.
 136
 137     o Build environment fixes.
 138
 139 Many thanks to:
 140
 141     Owen W. Taylor <otaylor@fishsoup.net>
 142     Thomas Wood <thomas.wood@intel.com>
 143     Havoc Pennington <hp@pobox.com>
 144     Bastian Winkler <buz@netbuz.org>
 145     Chris Lord <chris@linux.intel.com>
 146     Garry Bodsworth <gjb@camvine.com>
 147     Rob Bradford <rob@linux.intel.com>
 148     Johan Bilien <jobi@litl.com>
 149     Jonas Bonn <jonas@southpole.se>
 150     Raymond Liu <raymond.liu@intel.com>
 151     Damien Lespiau <damien.lespiau@gmail.com>
 152     Dan Winship <danw@gnome.org>
 153     Marc-André Lureau <marcandre.lureau@gmail.com>
 154     Robert Staudinger <robsta@gnome.org>
 155     Tommi Komulainen <tko@litl.com>
 156
 157 Clutter 0.9.2 (16/03/2009)
 158 ===============================================================================
 159
 160 Bastian Winkler (2):
 161       [media] Fix the interface cast macro
 162       Remove redundant declaration in clutter-text.h
 163
 164 Chris Lord (1):
 165       [actor] Force a relayout on set_parent()
 166
 167 Christian Persch (1):
 168       Bug 1429 - Redundant declaration in clutter-x11.h
 169
 170 Colin Walters (3):
 171       Bug 1491 - Fix hardcoded lib path in .pc files
 172       Typo in clutter-win32.pc.in introduced by commit 24ce19383
 173       [animation] Enhance the bind API
 174
 175 Damien Lespiau (6):
 176       [gitignore] update gitignore files for tests/
 177       [build] Beautify autotools' output
 178       [build] Add dolt
 179       [build] Fix interaction between shave, gtk-doc and libtool 1.x
 180       [build] Fix dist for the newly introduced m4 macro directory
 181       Update shave
 182
 183 Emmanuele Bassi (111):
 184       Post-release bump to 0.9.1
 185       [text] Merge the attributes with markup enabled
 186       [tests] Update the text-field interactive test
 187       Add Actor::create_pango_layout()
 188       [docs] Add clutter_text_set_markup()
 189       [clone] Allow cloning unparented actors
 190       [text] Use create_pango_layout()
 191       [text] Rename :alignment to :line-alignment
 192       [texture] Consolidate the quality to filter conversions
 193       [texture] Check if the material is valid
 194       [event] Extend KeyEvent for multi-input support
 195       [actor] Check out parameters before setting them
 196       [list-model] Make ClutterListModel subclassable
 197       Bug 1440 - Add clutter_get_current_event_time()
 198       [tests] Add TEST_CONFORM_SKIP() macro
 199       [tests] Add conformance tests for ClutterModel
 200       [ignore] Add the newly created conformance units
 201       [actor] Revert part of commit 402e022c
 202       [animation] Do not bind construct-only properties
 203       [x11] Add backend-specific get_current_event_time()
 204       Initialize a variable to avoid warnings
 205       [cogl] Add cogl_is_material to cogl-material.h
 206       [cogl] Provide GTypes for COGL types
 207       [texture] Use COGL_TYPE_HANDLE for the handle properties
 208       [docs] Clarify the set_cogl_texture() documentation
 209       Merge branch 'build-enhancements'
 210       [docs] Add a missing "return" annotation
 211       [build] Pass the -s switch to cmp
 212       Remove type functions for removed types
 213       [docs] Update the sections file
 214       [tests] Add TEST_CONFORM_TODO macro
 215       [build] Show pkg-config file being generated
 216       [build] Reference the headers with their full path
 217       [docs] Update build for COGL API reference
 218       [build] Update the EXTRA_DIST list
 219       [build] Fix the ChangeLog generation rule
 220       [build] Do not overwrite BUILT_SOURCES
 221       [behaviour] Do not notify empty behaviours
 222       [path] Do not accept NULL descriptions
 223       [timeline] Set the n_markers out paramater
 224       Do not use GL types in Clutter headers
 225       [docs] Require gtk-doc 1.11
 226       [docs] Use the --name-space option
 227       [docs] Add the 1.0 symbols index
 228       [docs] Rename cogl-docs from sgml to xml
 229       Add build machinery for gobject-introspection data
 230       [backend] Update the viewport when updating the GL context
 231       [build] Move all the compiler flags to AM_CFLAGS
 232       [ignore] Update with the introspection files
 233       Add runtime debug messages for COGL
 234       [actor] Remove usage of ClutterFixed
 235       Make disable text mipmapping a command line switch
 236       Make fuzzy picking a command line switch
 237       [docs] Document envvars and command line switches
 238       Remove stray fixed point macro usage
 239       Use a dynamic array for the actors when delivering events
 240       [media] Add sub-second resolution for the duration
 241       [build] Put the X11 pc dependencies in another variable
 242       [build] Do not shave typelib generation
 243       Intern the ClutterScriptable type name
 244       [backend] Constify font options
 245       [cogl] Add a PANGO debug flag for CoglPango use
 246       Clean up of the ClutterColor API
 247       [shader] Unify code paths
 248       Add pkg-config file for COGL
 249       [build] Various fixes for distcheck
 250       [docs] Clarify clutter_actor_animate() behaviour
 251       [docs] Note that grabs are evil
 252       [cogl-fixed] Add a double-to-fixed conversion macro
 253       Move BehaviourScale to CoglFixed
 254       Move ClutterBehaviourEllipse to CoglFixed
 255       Move ClutterBehaviourRotate to CoglFixed
 256       Move ClutterTimeline to CoglFixed
 257       [cogl-fixed] Implement the CoglFixed fundamental GType
 258       [tests] Test CoglFixed, not ClutterFixed
 259       [interval] Update fixed-point handling
 260       [stage] Coalesce fog and perspective API
 261       [texture] Fix ClutterFixed usage
 262       [text] Convert units to the right type
 263       [tests] Use floats, not ClutterFixed
 264       [units] Add more conversion functions
 265       [fixed] Remove ClutterFixed API
 266       [cogl] Fix hardcoded paths in the pc file
 267       [docs] Remove ClutterFixed from the documentation
 268       [docs] Update API reference
 269       [animation] Add vector variants for ::animate()
 270       [cogl] Initialize boolean flag in CoglContext
 271       [cogl] Initialize all members of CoglContext
 272       [color] Fixed HLS to RGB conversion
 273       [docs] Calling g_object_ref() will not dispose an object
 274       [docs] Document the commit message format
 275       [tests] Animate the color during easing
 276       [docs] Reword some of the coding practices
 277       [docs] Add a bindings coding practices
 278       Add more deprecation notices
 279       [deprecated] Add Effect deprecation
 280       Do not cause more size requisitions than necessary
 281       [cogl] Avoid shadowing math.h symbols
 282       [docs] Clarify Animation memory management
 283       [animation] Add an emitter for ::completed
 284       [animation] Add Animation getter
 285       [tests] Remove unused variables
 286       [docs] Add description of queue_redraw
 287       [docs] Update after Animation API changes
 288       [animation] Enhance consistency of the Animation API
 289       [docs] Bring down the undocumented symbols to 2%
 290       Fix release date of 0.9.0
 291       Update release notes
 292       [docs] Fix naming of the interval parameter
 293       [docs] Ignore the TimeoutInterval internal API
 294       Update release notes
 295
 296 Geoff Gustafson (1):
 297       [animation] Broken fixed:: properties
 298
 299 Gordon Williams (1):
 300       [group] Output the group name when debugging paint
 301
 302 Havoc Pennington (4):
 303       Virtualize GL matrix operations and use a client-side matrix when GL is indirect
 304       [actor] Add :clip-to-allocation property
 305       [actor] Add ::queue-redraw signal
 306       [cogl] Flush matrix before clip planes
 307
 308 Jonathan Matthew (1):
 309       Declare the EnumValues for PixelFormat static
 310
 311 Neil Roberts (36):
 312       [cogl-material] Always bind the new texture handle
 313       Fix building GLES 2 after the material branch merge
 314       [cogl-texture] Fix the count for the number of enabled arrays
 315       [cogl-gles2-wrapper] Remove the FIXME to adjust the fragment color
 316       [clutter-clone] Override the parent opacity to self not self->parent
 317       [clutter-texture] Release the temporary ref taken when setting a texture
 318       [clutter-texture] Unref the Cogl material on dispose
 319       [clutter-texture] Fix the no_slice property
 320       [cogl-texture] Fix offset to next quad when flushing the log
 321       [cogl-texture] Move the destruction of the material to _finalize
 322       [cogl-texture] Fix uninitialised priv var in texture_finalize
 323       Added a test for non-power-of-two sized textures
 324       Emit CLUTTER_LEAVE events when the pointer leaves the stage
 325       Call glActiveTexture and glClientActiveTexture through cogl_get_proc_address
 326       [win32] Track mouse leave messages
 327       [clutter-main] Fix the input device passed to set_motion_last_actor
 328       Override the opacity when painting a clone instead of combining
 329       Allow rotation angle properties to be negative
 330       [ClutterBehaviourRotate] Fix up some breakage from the cogl-float branch merge
 331       [tests/conform] Copy in redhand.png
 332       Replaced ClutterFixed constants in color_{darken,lighten} with float
 333       [cogl-gles2-wrapper] Convert texture unit settings to be a static sized array
 334       [cogl-gles2-wrapper] Actually call glActiveTexture
 335       Add an environment variable to disable mipmapped text
 336       [tests/tools] Don't install libdisable-npots.so
 337       [clutter-texture] Use a GThreadPool for loading async textures
 338       [cogl-pango-glyph-cache] Fix compiler warning on 64-bit
 339       Fix warning in clutter-backend-sdl
 340       [eglnative] Add -I flags for the clutter dir in the src and build dirs
 341       Set the mapped flag on the stage in the SDL and eglnative backends
 342       Fix out of tree builds
 343       Remove use of $(builddir)
 344       [README] Small typo fix
 345       Change cogl_path_rectangle and cogl_path_round_rectangle to take x1,y1,x2,y2
 346       [cogl-path] Minor fix to gtk-doc
 347       Count timeline frames using the FPS instead of an integer interval
 348
 349 Owen W. Taylor (7):
 350       Honor ACLOCAL_FLAGS in autogen.sh
 351       Add gobject-introspection annotations
 352       Fix x/y confusion for GL_TEXTURE_RECTANGLE_ARB
 353       Use COGL to establish GL state for ClutterGLXTexturePixmap
 354       Add (out) annotations for ClutterActor
 355       Allow NULL for clutter_text_set_text()
 356       Avoid drawing twice if relayout queues a draw
 357
 358 Raymond Liu (2):
 359       [text] Crash when multi-byte utf8 text exceeds max_length
 360       [text] Insertion of multi-byte characters broken
 361
 362 Robert Bragg (28):
 363       [Cogl] Renames cogl_fog_set to cogl_set_fog for consistency
 364       [cogl-material] Fixes some dirty flag checks
 365       [cogl-vertex-buffer] Some fixes for texturing and color arrays
 366       [docs] Various gtk-doc updates for Cogl
 367       [tests] Some improvements for test-pixmap
 368       [Cogl] cogl_clip_{set*,unset} renamed to cogl_clip_{push*,pop}
 369       [Cogl] Renames cogl_paint_init to cogl_clear and adds a cogl_disable_fog function
 370       [cogl-color.c] #include fix for the cogl_set_source_color prototype
 371       [Cogl] the cogl_get_*_matrix functions now work with CoglMatrix types
 372       [Cogl] Fixes automatic handling of the GL blend enable state.
 373       [cogl-material] Always glBindTexture when flushing material state
 374       [Cogl] Remove a debugging assert that was triggering on false positives
 375       [test-vertex-buffer-contiguous] Improves the texturing test
 376       [cogl-matrix] Adds padding to CoglMatrix
 377       [cogl-matrix] Documents that CoglMatrix members should be considered read only
 378       Removes need for casting (const float *) to (GLfloat *) in _cogl_set_clip_planes
 379       80 char fix
 380       Avoid casting CoglMatrix to a GLfloat * when calling glGetFloatv
 381       Explicitly make the modelview-matrix current in cogl_{rotate,transform,etc}
 382       Use Cogl enum when making modelview-matrix current in cogl_{rotate,transform,etc}
 383       Finish GLES{1,2} support for client side matrix stacks
 384       Maintain the Cogl assumption that the modelview matrix is normally current
 385       Merge branch 'cogl-client-matrix-stacks'
 386       [cogl-vertex-buffer] Add a flush of attribute changes in the *_draw() functions
 387       [cogl-vertex-buffer] Allow querying back the number of vertices a buffer represents
 388       [cogl-vertex-buffer] fix cogl_vertex_buffer_draw_elements prototype
 389       [tests] Adds an interactive cogl vertex buffer unit test
 390       [cogl] Don't endlessly print the same warning regarding layer fallbacks
 391
 392 Robert Staudinger (1):
 393       [build] Add cogl.h to the built sources list
 394
 395 Shane Bryan (1):
 396       Bug 1434 - _NET_WM_NAME not set before realize
 397
 398 Tomas Frydrych (3):
 399       Fixed handling of enter and leave events in clutter_x11_handle_event()
 400       Fix clutter_x11_texture_pixmap_get/set_property() following change of PROP_WINDOW type
 401       [x11] Only update cached last event time if we have a real timestamp.
 402
 403 Øyvind Kolås (11):
 404       Added a mutex for clutter asynchronous textures threads.
 405       Bail early in clutter_texture_paint if opacity == 0
 406       Add a warning for recursive emit_event
 407       Change the default size of thread pool from 3 to 1
 408       [tests] Added test-texture-async
 409       [clutter-texture] add option to not block on size for loaded images
 410       [clutter-texture] remove load-size-async property
 411       Merge commit 'origin/async-texture-thread-pool' into async-size
 412       [clutter-texture] updated documentation.
 413       [clutter-texture] fixed gtk-doc formatting, and init threads in test.
 414       Merge branch 'async-texture-thread-pool'
 415
 416 Clutter 0.9.0 (30/01/2009)
 417 ===============================================================================
 418
 419  * List of changes between 0.8.6 and 0.9.0
 420
 421    o ClutterText is a new actor allowing text display, text editing
 422      both in multi-line and single-line modes, and text selection using
 423      the pointer devices and the keyboard. ClutterText supercedes both
 424      ClutterLabel and ClutterEntry.
 425    o ClutterClone is a new actor that allows cloning of other actors,
 426      both simple and composite. ClutterClone supercedes ClutterCloneTexture.
 427    o ClutterBindingPool is a new API that allows to easily add key bindings
 428      to an actor.
 429    o ClutterAnimation is a new API for implicit animations, similar to
 430      the tweening API used in toolkits like jQuery, Tween and Flash. This
 431      new API supercedes the ClutterEffect API.
 432    o ClutterAlpha uses "animation modes" instead of raw function
 433      pointers; it is still possible to pass alpha functions. The alpha
 434      functions provided by Clutter have been removed from the public
 435      API. It is possible to register global alpha functions and use
 436      them though a logical id.
 437    o The interval of the ClutterAlpha:alpha property has been changed
 438      to a floating point value in the [ -1.0, 2.0 ] range; this allowed
 439      the addition of "overshooting" easing modes.
 440    o COGL now supports backface culling.
 441    o The COGL-based Pango renderer is public API and it is accessible
 442      to developers. It is also possible to access the PangoContext used
 443      by Clutter in order to create PangoLayouts to render text.
 444    o The ClutterFixed API has been moved to COGL.
 445    o COGL does not depend on Clutter data types anymore.
 446    o The ClutterMedia interface has been overhauled: implementations
 447      now must only override the interface properties. The ranges of
 448      some properties have been changed to normalized values.
 449    o COGL now exposes only floating point entry points, and reserves
 450      the eventual conversion to fixed point only when needed. The
 451      fixed point type and macros are publicly available for developers
 452      concerned about floating point operations.
 453    o COGL has a new Vertex Attribues API that allows submitting an
 454      extensible number of vertex attributes to OpenGL in a way that
 455      does not require format conversions and allows fast re-use.
 456    o COGL has a new Material API that decouples paths from fills; it
 457      is possible to create an arbitrary path and fill it with a COGL
 458      texture. The Material API also allows setting multiple texture
 459      layers and defining the blend modes and colors.
 460    o ClutterTexture has the ability to use a worker thread to asynchronously
 461      load an image from a file, as long as the GLib threading support has
 462      been enabled prior to calling clutter_init().
 463    o Clutter now supports localization of the help output, and it
 464      also supports globally setting the text direction for non left to
 465      right locales.
 466    o ClutterCairoTexture is a new actor that allows using Cairo
 467      to draw on a ClutterTexture; since Cairo does not have an OpenGL
 468      backend, the drawing is not hardware accelerated.
 469    o Clutter has a unit testing suite, based on the GLib unit test
 470      framework, which can be used to track regressions.
 471    o A ClutterPath object has been added, and it is used by the
 472      BehaviourPath. The Path object allows defining paths using a set
 473      of coordinates and operations. A Path can be "painted" either using
 474      COGL primitives or using Cairo primitives, allowing an easier way
 475      to paint non-rectangular shaped actors.
 476    o ClutterInterval is a simple object, used by ClutterAnimation, that
 477      describes an interval between two values, and interpolates between
 478      the initial and final values of the interval.
 479
 480  * List of bugs fixed since 0.8.6
 481
 482    o #835 - Optimize clutter_actor_real_pick()
 483    o #851 - setting anchor point causes picking problem
 484    o #883 - Outstanding COGL merge issues
 485    o #1003 - Add clutter_actor_take_key_focus
 486    o #1014 - Clutter Animation API Improvements.
 487    o #1049 - Clutter doesn't support most GLSL uniforms
 488    o #1051 - WebKit/Clutter product/component?
 489    o #1058 - Build clutter-box2d with Clutter 0.8
 490    o #1066 - Clipping regression in 0.8
 491    o #1086 - virtualize stage_queue_redraw
 492    o #1105 - low level access to PangoClutter
 493    o #1106 - ClutterText instead of ClutterLabel and ClutterEntry
 494    o #1108 - Enter/Leave events logics wrt. skipped motion events
 495    o #1109 - clutter-0.8.0 fails to compile
 496    o #1123 - Crash when FBO actor is used and the stage is MINIMIZED
 497    o #1144 - Provide an option to load images asynchronously in ClutterTexture
 498    o #1162 - Add unit testing for Clutter
 499    o #1164 - Mesh API
 500    o #1172 - Disjoint paths and clip to path
 501    o #1189 - Backface culling
 502    o #1209 - Move fixed point API in COGL
 503    o #1210 - Add CoglColor API
 504    o #1211 - Drop ClutterFeatureFlags usage from COGL
 505    o #1212 - Allow only a single include file for Clutter
 506    o #1215 - Move the Pango renderer to the public API
 507    o #1219 - Clean up cogl.h
 508    o #1231 - Build fails in gles flavour in revision 3442
 509    o #1233 - CLUTTER_ALPHA_SINE_INC is broken in trunk
 510    o #1251 - Merge the Cairo texture actor in core
 511    o #1252 - Merge ClutterBehaviourPath and ClutterBehaviourBspline
 512    o #1261 - [patch] Minimize differences between gl/cogl-texture.c and
 513      gles/cogl-texture.c
 514    o #1269 - mingw32 building failed at clutter-media.c
 515    o #1270 - Update to mingw-cross-compile.sh
 516    o #1271 - mingw compiling failed:  undefined reference to
 517      `_glDrawRangeElements@24'
 518    o #1284 - Return something reasonable from clutter_x11_handle_event()
 519    o #1300 - clutter_score_remove and clutter_score_remove_all  are different
 520      in object remove
 521    o #1310 - font rendering problem
 522    o #1313 - Fix computation of camera distance
 523    o #1314 - clutter_sinx() is more inaccurate than it needs to be
 524    o #1321 - Get Matrix in float
 525    o #1323 - ClutterBehaviorDepth conflicts with other behaviors
 526    o #1325 - ClutterPath to cairo_path_t conversion functions
 527    o #1330 - We should not queue redraw for non-visible actors
 528    o #1334 - Default value for ClutterLabel::text should be "" instead of NULL
 529    o #1344 - clutter_actor_transform_stage_point gives invalid coordinates
 530      for big actors
 531    o #1352 - Weird cogl-pango.h includes in clutter-[entry|label].c
 532    o #1354 - Floating point exception when set fps>1000 and start timeline
 533    o #1361 - Unused ClutterStage::get_resolution() methods
 534    o #1365 - ClutterEntry doesn't get the cursor when it should
 535    o #1366 - disable-npots fails to build on mac
 536    o #1380 - Return booleans from CLUTTER_ACTOR_IS_* macros
 537    o #1386 - Wrong clipping dimensions for larger actors
 538    o #1387 - Clarify new-frame signal emission with advance()
 539    o #1388 - Clarify signal emission for advance_to_marker()
 540    o #1395 - behaviour_apply and behaviour_get_nth_actor are opposite on
 541      actors sequence
 542    o #1397 - clutter command line is not localized.
 543    o #1402 - Change default tile-waste from 64 to 63
 544    o #1403 - ClutterMedia::get_uri() should return allocated string
 545    o #1404 - ClutterMedia issues
 546    o #1405 - Fix properties that have X11 types to be 'long'
 547    o #1409 - Use G_SIGNAL_RUN_LAST with ::queue-redraw signal
 548    o #1410 - [patch] Implements a generic ClutterActorClone class without fbos
 549    o #1414 - avoid relayout of ClutterTexture if not syncing size
 550    o #1415 - short-circuit setting same clip again
 551
 552 Clutter 0.8.2 (25/09/2008)
 553 ===============================================================================
 554
 555  * List of changes between 0.8.0 and 0.8.2
 556
 557    o Add constructor-only properties for the :container and :actor
 558      properties of ClutterChildMeta
 559    o Resync the Clutter keysyms with X.org ones.
 560    o Documentation fixes and improvements
 561    o Allow defining ClutterColor as an object or an array inside
 562      ClutterScript UI definitions
 563    o Added the missing :perspective property to ClutterStage
 564    o Fixed the upper and lower boundaries for ClutterUnit and
 565      ClutterFixed properties
 566    o Fix a bug that prevented disabling sorting on ClutterModel
 567    o Fix a bug in clutter_timeline_list_markers()
 568    o Queue a redraw when the clip is changed
 569    o Optimize calls to push and pop the matrix when painting
 570    o Add a variable to the pkgconfig file for extracting the
 571      COGL backend, for configure-time checks
 572    o Fix a typo in cogl_path_rel_curve_to()
 573    o Fix showing the cursor after it being hidden once
 574    o Add a function for obtaining Clutter's option group without
 575      initializing Clutter
 576
 577  * List of bugs fixed since 0.8.0
 578
 579    o #856 - Teardown sequence is borked
 580    o #945 - Clipping+fbo cloning bugs
 581    o #1010 - ClutterLabel does not update the layout (again)
 582    o #1020 - TFP resyncing on MapNotify/ConfigureNotify [Andy Wingo]
 583    o #1033 - Manually parsing command line options prevents
 584      initializing clutter
 585    o #1034 - Picking doesn't work on Eee PC
 586    o #1038 - Clutter 0.8 won't build due to redefined functions
 587    o #1044 - cogl_get_viewport error
 588    o #1047 - API documentation from release tarball is not
 589      installed by "make install" [Mirco Müller]
 590    o #1048 - SIGFPE in cogl_texture_set_region() with
 591      nvidia [Gwenole Beauchesne]
 592    o #1062 - clutter_actor_query_coords() replacement in
 593      0.8 [Gwenole Beauchesne]
 594    o #1069 - Warnings with ClutterScore
 595    o #1071 - clutter_timeline_get_duration doesn't always work
 596    o #1075 - Difficult to bind clutter_stage_new
 597    o #1080 - clutter_stage_read_pixels has upside-down y coordinate
 598    o #1082 - Texture bitmap is destroyed in wrong way
 599    o #1085 - Cursor is in wrong position on ClutterEntry if set
 600      x-align property
 601    o #1090 - Label somtimes returns natural_width < min_width [Johan Bilien]
 602    o #1091 - WM_MOUSEWHEEL (scroll-event) not handled
 603      correctly [Roman Yazmin]
 604    o #1099 - No ClutterScript API to get a list of IDs in a given
 605      file [Noah Gibbs]
 606    o #1100 - WM_SIZE not handled correctly, user_resize and
 607      window_style correction
 608    o #1103 - Two typos in clutter documentation
 609    o #1121 - Setting anchor point doesn't work if set too early
 610    o #1124 - Clutter causes an additional size request in each
 611      allocation [Johan Bilien]
 612    o #1125 - Save an extra pango_layout_get_size in many
 613      cases [Johan Bilien]
 614    o #1130 - CLUTTER_MOTION is not emitted when time goes
 615      backwards. [Pierce Liu]
 616    o #1137 - Setting the anchor point does not trigger a re-paint
 617    o #1145 - Flicker on resize the window
 618    o #1154 - clutter_timeout_pool_new() documentation doesn't say
 619      how to free [Murray Cumming]
 620
 621 Clutter 0.8.0 (10/07/2008)
 622 ===============================================================================
 623
 624  * List of changes between 0.7.6 and 0.8.0
 625
 626    o Assume that non-power-of-two sized textures are always supported
 627      if texture-from-pixmap support is present.
 628
 629    o Increase documentation coverage.
 630
 631    o Disable the XINPUT support by default.
 632
 633    o Improve the behaviour of clutter_actor_get_transformed_size().
 634
 635    o Fix a copy-and-paste bug which broke the vertex shaders.
 636
 637  * List of bugs fixed since 0.7.6
 638
 639    o #983 - cogl-bitmap-fallback.c compiler error/warning due to cast issue
 640    o #985 - MSC math.h / M_PI issue
 641    o #998 - clutter always captures X input events
 642    o #1000 - clutter-x11 should define gtypes for its enumerations
 643    o #1004 - Fix "edge-detect" shader
 644    o #1007 - Fix TFP fallback mechanism
 645    o #1008 - tfp still a bit borked
 646    o #1010 - ClutterLabel does not update the layout
 647    o #1011 - Fix TFP fallback mechanism (take 2)
 648    o #1012 - clutter_stage_read_pixels() has incorrect alpha data
 649              on some (most?) cards"
 650    o #1013 - Per device grabs are not obeyed in pointer device propagation.
 651    o #1015 - Cloning unparented actors with FBOs doesn't work with new
 652              layout code
 653    o #1016 - Changing window-redirect-automatic property after creating
 654              ClutterX11TexturePixmap doesn't work
 655    o #1019 - clutter-frame-source.h not included by clutter.h
 656    o #1022 - extern inline functions in clutter-fixed.h
 657    o #1033 - Manually parsing command line options prevents initializing
 658              Clutter
 659
 660 Clutter 0.7.6 (27/06/2008)
 661 ===============================================================================
 662
 663  * List of changes between 0.7.4 and 0.7.6
 664
 665    o Removed the ClutterBackend::get_display_size() and wrappers.
 666
 667    o Verify that the vertex shaders are successfully compiled when binding
 668      them.
 669
 670    o Increase safety of the ClutterGLXTexturePixmap
 671
 672  * List of bugs fixed since 0.7.4
 673
 674    o #993 - Underline colors are sometimes wrong
 675
 676 Clutter 0.7.4 (25/06/2008), "Killer Koi"
 677 ===============================================================================
 678
 679  * List of changes between 0.7.2 and 0.7.4
 680
 681    o Fix the ClutterEntry actor after the clip API changes in COGL.
 682
 683    o Update the shaders generated for GLES 2.0.
 684
 685    o Add the ability to add search paths and look up files from
 686      ClutterScript. This allows defining directories to store the
 687      images to be loaded by a ClutterTexture.
 688
 689    o Fix the GLES 1.1 support.
 690
 691    o Warn if no usable pointer device are available on X11 backends.
 692
 693    o Improve the request for the best pixel format on win32.
 694
 695    o Fix a regression when sizing the ClutterStage on backends that
 696      only support fixed size stages; now setting any size will result
 697      in Clutter ignoring the request, like it happened in Clutter 0.6.
 698
 699    o Add a method to ClutterBackend to retrieve the display size.
 700
 701    o Fix clutter_sinx() for angles > CFX_2PI - CFX_ONE.
 702
 703  * List of bugs fixed
 704
 705    o #833 - ClutterEntry should clip glyphs rather than itself
 706    o #858 - Support for multiple devices (using XINPUT)
 707    o #879 - sampler2DRect used by test-shader.c doen't work with non-rect textures
 708    o #979 - Wrong call convension for SwapIntervalProc in win32 backend
 709    o #987 - clutter-event.c c99 variable declaration
 710    o #988 - cursor position wrong with multibyte invisible char
 711    o #989 - Add a search path for clutter script assets
 712
 713 Clutter 0.7.2 (23/06/2008), "Kedoke"
 714 ===============================================================================
 715
 716  * List of changes between 0.7.0 and 0.7.2
 717
 718    o ClutterTexture has a new :keep-aspect-ratio property; when it is set
 719      to TRUE the texture will return a preferred width maintaining the
 720      aspect ratio with the given height and a preferred height maintaining
 721      the aspect ratio with the given width. This allows to set the width or
 722      the height and have the texture automatically request the height or the
 723      width respectively while maintaining the aspect ratio of the original
 724      image.
 725
 726    o Added XINPUT support on the X11 backends; this provides an initial
 727      support for multiple input devices. The API is X11-specific, and
 728      provides support for querying at run-time support for XINPUT, for
 729      getting a list of input devices and for getting the type of each
 730      input device.
 731
 732    o The 'fruity' backend also features multiple device support.
 733
 734  * List of bugs fixed
 735
 736    o #816 - clutter_actor_request_coords() should take a const box.
 737    o #836 - Optimize clutter_label_query_coords()
 738    o #905 - Paint cursor directly
 739    o #918 - Group doesn't clip if it's children are clipped
 740    o #953 - Actors are not hidden before unrealized or disposed
 741    o #960 - PangoContext creation code should not be duplicated
 742    o #970 - clutter_actor_get_paint_area confusion
 743    o #971 - Minor ClutterActor cleanups
 744    o #972 - Better parenting
 745    o #973 - unreffing ClutterScore may segfault
 746    o #981 - clutter_stage_read_pixels temprow fix
 747    o #982 - __COGL_GET_CONTEXT MS compiler issue
 748    o #984 - pango_clutter_render_layout() declared void
 749
 750 Clutter 0.7.0 (13/06/2008), "Booska"
 751 ===============================================================================
 752
 753  * List of changes between 0.6 and 0.7.0
 754
 755    o COGL, the underlying GL abstraction layer in Clutter, has been
 756      completely rewritten from the ground up. Its no longer a conceptual
 757      hack but a documented, fully featured library pretty much in its
 758      own right. COGL abstracts over Open GL, Open GL ES 1.1 and now
 759      OpenGL ES 2.0, providing a smart uniform API over these libraries
 760      with various utility features such as texture tiling abstractions,
 761      paths and primitive rendering, FBO, shaders, etc.
 762
 763    o Clutter now provides an experimental backend for the Apple(tm)
 764      iPhone and iPod Touch families of products.
 765
 766    o The Windows platform is now natively supported instead of
 767      relying on the SDL libraries. The win32 backend is still
 768      experimental.
 769
 770    o The X11 based backends now feature support for Actors that wrap
 771      external X drawables (i.e the texture-from-pixmap extension and
 772      fallbacks)
 773
 774    o Clutter now seamlessly supports multiple stages on the backends
 775      that allow this feature.
 776
 777    o The custom Pango renderer has been completely rewritten, now using
 778      the more modern and maintained PangoCairo (instead of FT2), and avoids
 779      nasty subclassing hacks, supports smooth fast scaling of text, has
 780      many edge case issues fixed and it still is very efficient (using
 781      a texture glyph cache). It is even a little bit faster.
 782
 783    o Better texture support, timeline improvements, ClutterLabel and
 784      ClutterEntry improvements, and container child properties are among
 785      the new features - too many to fit in the NEWS file.
 786
 787  * List of bug fixes
 788
 789    o #358 - "window resizing doesn't show scaled stage"
 790    o #425 - "COGL enhancements"
 791    o #439 - "timing related pong lockup due to timeline_rewind somtimes
 792             being ignored by timeline_timeout_func"
 793    o #450 - "ClutterScore API enhancements"
 794    o #641 - "add markers to timelines"
 795    o #666 - "Large font size leads to missing ""W"" and wrong ""J"" character"
 796    o #713 - "texture from pixmap"
 797    o #791 - "default actors to visible"
 798    o #800 - "CLUTTER_ALPHA_EXP_INC overflows"
 799    o #804 - "clutter_actor_get_opacity returns composited alpha"
 800    o #810 - "100 % CPU load with clutter_main()"
 801    o #815 - "Split up request
 802    o #816 - "clutter_actor_request_coords() should take a const box."
 803    o #822 - "Fix clutter_actor_lower()"
 804    o #823 - "Clean-up GLism's in clutter-core (below cogl)"
 805    o #824 - "ClutterEntry should handle its own key events"
 806    o #825 - "Removes GLisms from clutter-main.c"
 807    o #831 - "configure.ac missing osx flavour help"
 808    o #834 - "add ability to set anchor in json"
 809    o #836 - "Optimize clutter_label_query_coords()"
 810    o #839 - "Crash if put cursor over topmost pixel"
 811    o #840 - "Implement prepare-paint and finish-paint signals."
 812    o #848 - "Events dispatch doesn't work in GLX Xephyr"
 813    o #850 - "Impossible to set ClutterRectangle border opacity to a value
 814             different from the surface opacity"
 815    o #857 - "cogl_color doesn't work in PowerVR PC Viewer"
 816    o #860 - "ClutterAlpha leaks"
 817    o #864 - "Allow instantiating and subclassing of ClutterStage"
 818    o #871 - "Two problems with closing stages"
 819    o #873 - "clutter_x11/glx_texture_pixmap issues"
 820    o #874 - "Clipping on GL ES"
 821    o #875 - "Clutter Label Issues"
 822    o #881 - "Timelines require precise system timing"
 823    o #882 - "Allow child properties for containers implementing the
 824             ClutterContainer interface"
 825    o #884 - "Add clutter_alpha_set_closure"
 826    o #889 - "Error when building clutter-ivan with eglx"
 827    o #891 - "assertion failed when test-behave exits"
 828    o #892 - "Incorrect results using  rotation-[center|angle] properties"
 829    o #894 - "Artifacts with the pango renderer"
 830    o #900 - "clutter_actor_lower() and friends do not queue redraw"
 831    o #906 - "Implement timing of the events"
 832    o #908 - "Support transform from G_TYPE_INT to ClutterUnit"
 833    o #909 - "OSX: missing NULL pointer handling"
 834    o #910 - "OSX: missing memory pool"
 835    o #911 - "OSX: add multistage support"
 836    o #912 - "Invalid use of int* as parameter for glGetIntegerv"
 837    o #913 - "cogl fails to build on OSX"
 838    o #914 - "ClutterEntry is confused about characters vs. bytes"
 839    o #915 - "clutter_entry_set_max_length(-1) misbehaves"
 840    o #916 - "ClutterKeyEvent:unicode_value is ignored"
 841    o #919 - "Replacement pango renderer"
 842    o #927 - "Created ports for clutter
 843    o #928 - "Reparenting a child that itself is a container doesn't work"
 844    o #930 - "add support for quartz imagebackend"
 845    o #931 - "suspicious size allocation for pixel data"
 846    o #933 - ""X Error of failed request" when attempting to call
 847             clutter_actor_request_coords()"
 848    o #934 - "Update clutter-tutorial to build with clutter from svn trunk."
 849    o #947 - "Destroying a stage is messy"
 850    o #948 - "Remove texture rectangle support"
 851    o #950 - "AltGr not handled"
 852    o #951 - "Fix clutter_entry_init() in trunk"
 853    o #952 - "Fix test-textures in trunk"
 854    o #953 - "Actors are not hidden before unrealized or disposed"
 855    o #955 - "ClutterLabel is missing fallback resolution handling"
 856    o #959 - "Multiple minor improvements"
 857    o #960 - "PangoContext creation code should not be duplicated"
 858    o #961 - "Fails to build on OSX (query/request_coords is gone)"
 859    o #964 - """unrealized"" signal of ClutterActor wrongly named"
 860
 861 Clutter 0.6.0 (18/02/2008)
 862 ==========================
 863
 864  * List of changes between 0.5.6 and 0.6.0
 865
 866    o New documentation sections inside the API reference, describing
 867      the animation framework.
 868
 869    o New API in ClutterActor for computing the actor's vertices in
 870      the plane of a given ancestor and accessors to query whether an
 871      actor is scaled or rotated
 872
 873  * List of bug fixed
 874
 875    o #613 - Extend point transformation API
 876    o #779 - Rounding error in ClutterBehaviourScale [Havoc Pennington]
 877    o #787 - tiled textures are broken
 878    o #796 - segmentation fault when setting label text
 879
 880 Clutter 0.5.6 (11/02/2008)
 881 ==========================
 882
 883  * List of changes between 0.5.4 and 0.5.6
 884
 885    o Reverted a last minute change in the depth sorting function of
 886      ClutterGroup.
 887
 888    o Added the clutter_actor_move_anchor_point() family of functions,
 889      which will set the anchor point at the given coordinates while
 890      adjusting the actor postion so that the relative position of the
 891      actor toward its parent remains the same.
 892
 893    o Provide a fallback for finding the Clutter alpha functions inside
 894      a UI definition for ClutterScript in case g_module_open() fails.
 895
 896    o Add initial Frame Buffer Objects support in ClutterTexture; using
 897      FBOs, where supported by the hardware and drivers, it's possible to
 898      create a ClutterTexture from any actor.
 899
 900  * List of bugs fixed
 901
 902    o #386 - Stage is white unless a timeline is present
 903    o #439 - timing related pong lockup due to timeline rewind...
 904    o #440 - 1 pixel line flickering
 905    o #442 - Shader support
 906    o #451 - Improve font rendering quality (Pango)
 907    o #452 - Textures are shown with distortion on Solaris/SPARC
 908    o #526 - OSX backend
 909    o #533 - Clutter stage is not shown under some conditions
 910    o #540 - ClutterStage isn't always respecting requests to change size
 911    o #549 - Backend offscreen API is broken
 912    o #613 - Extend point transformation API
 913    o #635 - Fix buffer overflow in clutter_texture_get_pixbuf() [Gwenole
 914      Beauchesne]
 915    o #643 - Superfluous "filter-quality" setting in texture_upload_data()?
 916      [Gwenole Beauchesne]
 917    o #689 - Rotating actor through layers does not handle opacity
 918      correctly [Josh Stewart]
 919    o #710 - Make "box-blur" test shader work in some way [Gwenole Beauchesne]
 920    o #719 - X11 backend does not check window field in events [Havoc
 921      Pennington]
 922    o #724 - ClutterLabel reports wrong height when lines > 1
 923    o #749 - "reactive" property does not change
 924    o #751 - missing XSync in clutter-event-x11.c:xembed_set_info() [Havoc
 925      Pennington]
 926    o #756 - clutter_actor_get_abs_size returns bogus values
 927    o #769 - OSX backend fails to build
 928    o #770 - OSX: passing incompatible pointer type
 929
 930 Clutter 0.5.4 (25/01/2008)
 931 ==========================
 932
 933  * List of changes between 0.5.2 and 0.5.4
 934
 935    o A clutter-x11-<major>.<minor> pkg-config file is installed along
 936      with the clutter-<major>.<minor> and clutter-<backend>-<major>.<minor>
 937      ones, for libraries and applications depending on the X11-based
 938      backends (GLX and EGLX).
 939
 940    o Textures are correctly unrealized before changing and freeing the
 941      main GL context.
 942
 943    o It is now possible to block the automatic call to clutter_main_quit()
 944      when closing the stage window using the frame controls by connecting
 945      an handler for the ::event signal on the Clutter stage and checking
 946      for the CLUTTER_DELETE event type and returning TRUE. This allows
 947      the usage of other main loops with GLib reactors (like Python's twisted)
 948      with Clutter without triggering assertions by closing the stage window.
 949
 950  * List of bugs fixed
 951
 952    o #564 - Add more precise clutter_qdivx() [Gwenole Beauchesne]
 953    o #614 - ClutterActor API inconsistencies
 954    o #640 - ClutterTexture unrealized with no GL context
 955    o #654 - Under heavy load clutter sometimes drops the last frame of
 956      a timeline [Johan Bilien]
 957    o #672 - Event handling in osx backend is broken [Tommi Komulainen]
 958    o #684 - Improve test-scale by also using anchor point [Jaap A. Haitsma]
 959    o #695 - clutter-shader: Invalid format string for
 960      gssize [Tommi Komulainen]
 961    o #696 - cogl_get_proc_address requires GLX [Tommi Komulainen]
 962    o #709 - clutter_effect_scale inconsistent with clutter_actor_set_scale
 963    o #714 - clutter_event_copy for enter/leave event generates
 964      extra unref [Neil Roberts]
 965    o #715 - Type errors in test-shader
 966    o #720 - BehaviourScale not working in python after recent
 967      API change [Josh Stewart]
 968
 969 Clutter 0.5.2 (14/01/2008)
 970 ==========================
 971
 972  * List of changes between 0.5.0 and 0.5.2
 973
 974    o ClutterModelDefault has been renamed to ClutterListModel
 975
 976    o ClutterModel now has vector-based variants for append, prepend and
 977      insert methods; these methods are useful for bindings
 978
 979    o Add units-based variant for clutter_actor_move_by()
 980
 981  * List of bugs fixed
 982
 983    o #694 - Handle GLhandleARB on OS X [Tommi Komulainen]
 984    o #700 - Fix for clutter_effect_rotate() [Neil Roberts]
 985
 986 Clutter 0.5.0 (02/01/2008)
 987 ==========================
 988
 989  * List of changes between 0.4.2 and 0.5.0
 990
 991    o New event handling system: every actor with the CLUTTER_ACTOR_REACTIVE
 992      flag set will receive events from the underlying backend; the event
 993      propagation chain will be walked in two directions (from the actor to
 994      the top-level container and back) with the ability to block it in
 995      both phases.
 996
 997    o ClutterShader, an abstraction over the programmable OpenGL pipeline.
 998
 999    o ClutterScore, an object for controlling timelines; using a score
1000      instance is possible to start multiple timelines at once, or start
1001      a timeline after another has emitted the ::complete signal.
1002
1003    o ClutterScript, an object for parsing a scene from an external file or
1004      a buffer; the scene is described using JSON (JavaScript Object Notation):
1005      every object is defined using its class and properties, and container
1006      objects can have their children defined as well. It is also possible
1007      do describe top-level objects such as timelines and behaviours, and to
1008      automatically connect signal handlers to signal names.
1009
1010    o ClutterTimelines duration can now be set in milliseconds using the
1011      :duration property; the default framerate will be used to compute the
1012      actual duration in frames. The default framerate will be set by the
1013      backend, and can be overridden by the application.
1014
1015    o ClutterTimelines direction can now be set using the :direction
1016      property; a timeline can be set to proceed forward or backward,
1017      and the direction can also be change while the timeline is still
1018      running.
1019
1020    o New, experimental OSX backend.
1021
1022    o Build environment for MS VisualStudio 2005.
1023
1024    o ClutterModel, a generic list-based model object that can be used to
1025      implement actors following the Model-Viewer-Controller design pattern.
1026      Clutter provides a default implementation of ClutterModel, called
1027      ClutterModelDefault and using the GSequence data structure from GLib
1028      to optimize insertion and look up.
1029
1030    o Add the ability to grab pointer and keyboard events: if an actor
1031      is set to have a grab it'll be the only one receiving events until
1032      it releases the grab.
1033
1034    o Add the ability for an actor to receive the key focus; an actor
1035      with key focus will always receive the key events, even if it did
1036      not acquire the keyboard grab.
1037
1038    o It is now possible to set the GL "fog" (also known as "depth cueing")
1039      effect on the ClutterStage; if the fog is enabled, actors farther
1040      away from the view point will fade into the stage background color.
1041
1042    o Each actor now has an "anchor point", a point defined in the actor's
1043      coordinate space that will be used as the origin when scaling and
1044      rotation transformations.
1045
1046    o Every pixel-based API has been doubled with a corresponding
1047      ClutterUnits-based function (postfixed with a '-u'), for instance:
1048
1049        clutter_actor_set_position() - clutter_actor_set_positionu()
1050        clutter_actor_set_size()     - clutter_actor_set_sizeu()
1051        clutter_actor_set_depth()    - clutter_actor_set_depthu()
1052
1053      This allows sub-pixel precision and device independence.
1054
1055    o The ClutterLabel actor now tries very hard to provide a sane
1056      default size, if no bounding box has been requested; this fixes
1057      the :alignment property and allows the addition of the :justify
1058      property.
1059
1060    o The SDL backend can now be compiled under win32 with MingW; this
1061      backend is still marked as experimental.
1062
1063    o The OSX backend allows the compilation of Clutter under OS X; this
1064      backend is experimental.
1065
1066  * List of bugs fixed
1067
1068    o #423 - All actors should emit events rather than just the stage
1069    o #424 - Interface definition files
1070    o #443 - ClutterModel implementation
1071    o #480 - Uninitialized variable in
1072      path_alpha_to_position() [Gwenole Beauchesne]
1073    o #511 - clutter_stage_get_actor_at_pos problem
1074    o #512 - clutter window moves when stage actor is scaled
1075    o #518 - XEMBED not supported in eglx backend
1076    o #519 - Should have an Atom cache initialized on start up
1077    o #520 - Delete after multibyte unicode chars in
1078      ClutterEntry [Tommi Komulainen]
1079    o #522 - Array out of bounds indexing [Tommi Komulainen]
1080    o #523 - cogl portability fixes [Tommi Komulainen]
1081    o #524 - missing config.h includes [Tommi Komulainen]
1082    o #525 - Redundant include in cogl/gl [Tommi Komulainen]
1083    o #531 - Extraneous "new-frame" signal generated
1084    o #532 - clutter_actor_set_scale_with_gravityx()
1085      precision [Gwenole Beauchesne]
1086    o #544 - clutter_color_to_hlsx is broken [Neil Roberts]
1087    o #546 - ClutterStageState doesn't make sense
1088    o #550 - Wanted: Set Actor's position based on center or other
1089      edges/corners of quadrangle
1090    o #557 - ClutterScript should support complex properties for third
1091      party classes
1092    o #558 - Unmerge UI definitions
1093    o #566 - ClutterEntry does not scroll the text to the
1094      right [Gwenole Beauchesne]
1095    o #577 - Inconsistent naming of behaviour properties
1096    o #580 - Fix call to cogl_enable() [Gwenole Beauchesne]
1097    o #582 - api naming inconsistence between
1098             clutter_behaviour_path_append_knots and
1099             clutter_behaviour_bspline_append
1100    o #584 - Typo on clutter_effect_rotate_x documentation page
1101    o #592 - Fix build on trunk [Gwenole Beauchesne]
1102    o #596 - ClutterTexture tileing logic is a little borked
1103    o #597 - ClutterGroups not pickable
1104    o #600 - fix ClutterLabel layout computing when no box has been set
1105    o #604 - Color param for Label constructor should be
1106      const [Jonathon Jongsma]
1107    o #606 - enable depth test in GL
1108    o #608 - Control motion events frequency
1109    o #614 - ClutterActor API inconsistencies
1110    o #616 - ClutterTexture doesn't respect width set from clutterscript
1111    o #617 - ClutterEffect Improvements
1112    o #618 - ClutterScript name/id confusion
1113    o #619 - clutter_behavior_rotate angle properties should accept
1114      negative values
1115    o #628 - clutter_actor_rotate_x() is a setter, not a modifier
1116    o #629 - There is no clutter_actor_get_position()
1117    o #634 - clutter_behaviour_path_new() documentation unclear
1118    o #637 - add depth cueing support to the stage
1119    o #645 - Fix crash in clutter_label_new_full() [Gwenole Beauchesne]
1120    o #647 - Cannot hide the stage
1121    o #648 - Hidden fullscreen stage doesn't come back as fullscreen
1122    o #652 - reference needed on actor being source of last motion_event
1123    o #661 - clutter_actor_set_width() documentation is vague
1124    o #662 - clutter_actor_set_opacity() documentation doesn't describe values
1125    o #665 - ClutterBehaviourEllipse tilts are broken
1126    o #670 - Fix clutter_container_lower_child() [Gwenole Beauchesne]
1127    o #673 - ClutterActor "captured-events" signal documentation wrong
1128    o #674 - ClutterActor::get_depth() and set_depth() vfuncs not
1129      used [Murray Cumming]
1130    o #675 - update subregions of cluttertextures
1131    o #678 - ClutterLabel size allocation still bogus
1132
1133 Clutter 0.4.0 (07/08/2007)
1134 ========================
1135
1136  * List of changes between 0.3.1 and 0.4.0
1137
1138    o Many documentation additions and improvements.
1139
1140    o Display DPI now honours on backends its can be queried.
1141
1142    o Various big endian related fixes.
1143
1144    o ClutterBehaviourEllipse and ClutterBehaviourRotate API and
1145    internals improvements.
1146
1147    o Add basic tslib support to eglnative backend (for touchscreen events)
1148
1149    o clutter_stage_get_actor_at_pos should now work on 16bpp displays.
1150
1151    o New ClutterEffect rotation calls.
1152
1153    o Allowing user resizing of the stage now optional.
1154     (implemented by glx backend only currently)
1155
1156    o ClutterEntry UTF8 fixes and improved automatic initial sizing.
1157
1158    o Make ClutterActor GInitiallyUnowned.
1159
1160    o New ClutterBox API: each box has now a colour and a margin (distance
1161      between the inner-border and the children); plus, each packed child
1162      has a padding. Margins and paddings are expressed in ClutterUnits,
1163      to ease the transition to the device independent units. You can use
1164      clutter_box_set_default_padding() if you want the same padding for
1165      each child.
1166
1167  * List of bug fixed
1168    o #390 - clutter_stage_get_actor_at_pos broken on 16bpp displays.
1169    o #398 - inconsistent type for return value of clutter_event_get_state
1170    o #403 - Critical error when removing texture actor
1171    o #404 - Solaris build error with OpenGL, missing
1172             GL_MAX_RECTANGLE_TEXTURE_SIZE_ARB and GL_TEXTURE_RECTANGLE_ARB
1173    o #409 - depth mismatch between visual (32) and window (24)
1174    o #407 - metadata-available signal #ifdef'ed out
1175    o #413 - Clutter compile error with Sun Studio C compiler
1176    o #426 - typo in sdl_backend
1177    o #414 - ClutterEntry invisible if size not set
1178    o #434 - clutter_color_from_pixel incorrectly interprets alpha value
1179    o #435 - clutter_color_subtract does the opposite of its documentation
1180    o #436 - clutter-behaviour-depth always perform "from deep to shallow"
1181
1182 Clutter 0.3.1 (06/07/2007)
1183 ========================
1184
1185  * List of changes between 0.3 and 0.3.1
1186    o EGL. There are now 2 experimental EGL backends;
1187      - 'eglx', the former EGL on X11 implementation (now renamed)
1188      - 'eglnative', a new EGL 'native' backend which supporting non
1189        X11 EGL implementations (i.e framebuffer).
1190
1191    o ClutterGroup now returns correct size when a child is removed.
1192
1193    o Missing redhand.png added to distro tarball (fixing tests that require
1194      it)
1195
1196    o Fix picking in ClutterBox
1197
1198    o Rectangle border creation fixed.
1199
1200    o Fix overflow in Exponential Alpha funcs.
1201
1202    o Many API documentation fixes and improvements.
1203
1204    o ClutterEffect cleanups.
1205
1206    o ClutterEntry cleanups.
1207
1208    o Check for versioned XFixes library (GLX backend).
1209
1210    o More X error traps in GLX backend.
1211
1212 Clutter 0.3 (29/06/2007)
1213 ========================
1214
1215  * List of changes between 0.2.3 and 0.3
1216    o Clutter now supports both switchable windowing system and GL backends.
1217      Window systems supported include GLX, EGL and SDL.
1218
1219      GL support includes OpenGL 1.2+ and OpenGL ES 1.1. This is
1220      provided by a small basic abstraction layer 'cogl.h'. Cogl is not
1221      yet documented - usage external to Clutter is not yet advised.
1222
1223      Backends may provide specific command line options.
1224
1225      Notes;
1226
1227      GLX
1228      ---
1229      The GLX backend is built by default and is currently the most
1230      developed, supported and featured windowing system backend. Only
1231      OpenGL is supported via GLX.
1232
1233      SDL
1234      ---
1235      Clutter has experimental support for using SDL. Open GL is supported as
1236      is OpenGL ES via Dogles (very experimental).
1237
1238      EGL
1239      ---
1240      Clutter has experimental support for using EGL. Only Open GL ES
1241      is supported by EGL.
1242
1243      EGL support assumes an EGL implementation running atop X Windows.
1244
1245      Open GL ES.
1246      -----------
1247
1248      Clutter now has experimental support for Open GL ES.
1249      Current known issues;
1250
1251      + Unrealising a ClutterTexture will not move pixel data from video
1252        into system memory but simply destroy it.
1253      + BGRA, YUV Texture data not currently supported.
1254
1255      (Use the clutter_feature API to probe for above at runtime)
1256
1257      Open Source ES implementations this has been tested against
1258      include `Vincent' and `dgles'.  Support for commerical
1259      implementations may require modifications to the configure.ac
1260      script.
1261
1262      vincent: http://ogl-es.sourceforge.net/
1263               (Also see: http://svn.o-hand.com/repos/misc/trunk/ogles/ )
1264
1265      dgles: http://developer.hybrid.fi/dgles/index.html
1266
1267    o New ClutterEffect class provides a simplified (and thus less flexible)
1268      API wrapping around behaviours, alphas and timelines.
1269    o New Behaviours - bspline, ellipsis, rotation.
1270    o New built in Alpha functions;
1271       CLUTTER_ALPHA_SINE_INC
1272       CLUTTER_ALPHA_SINE_DEC
1273       CLUTTER_ALPHA_SINE_HALF
1274       CLUTTER_ALPHA_SQUARE
1275       CLUTTER_ALPHA_SMOOTHSTEP_INC
1276       CLUTTER_ALPHA_SMOOTHSTEP_DEC
1277       CLUTTER_ALPHA_EXP_INC
1278       CLUTTER_ALPHA_EXP_DEC
1279    o New Actors and interfaces
1280      + ClutterLayout, for writing extended layout support in actors
1281      + ClutterContainer, for generic container actors
1282      + ClutterBox, ClutterVBox and ClutterHBox layout actors.
1283      + ClutterEntry, text entry actor
1284    o ClutterTexture now handles BGRA, YUV and premultiplied alpha data.
1285    o All internal math now fixed point based.
1286    o Clutter now has it own internal event queue.
1287    o ClutterStage new features;
1288      + Title property for naming in window decorations.
1289      + Perspective setting - The stages perspective can now be modified.
1290    o New Clutter_actor *project API calls allow for querying of tranformed
1291      actor vertices and points.
1292    o New Clutter Feature checks.
1293    o Initial ClutterUnit implementation for device independant positioning.
1294  * List of Bugs fixed
1295    o Various issues with very poor performance and Intel drivers.
1296    o #138 Fix typo in x rotation transform.
1297
1298 Clutter 0.2.3 (2007-04-11)
1299 ==========================
1300
1301  * List of changed between 0.2.2 and 0.2.3
1302    o Fixes to tile based textures and again clutter_texture_get_pixbuf(). [Matthew]
1303    o Implement Gravity for ClutterScaleBehaviour. [Matthew, Rob]
1304
1305 Clutter 0.2.2 (2007-03-22)
1306 ==========================
1307
1308  * List of changed between 0.2.1 and 0.2.2
1309    o Addition of basic XEMBED support for clutter stage. [Matthew]
1310    o Fixes to clutter_texture_get_pixbuf(). [Matthew]
1311    o Export clutter_group_remove_all and add associated fixes. [Matthew]
1312
1313 Clutter 0.2.1 (2007-02-07)
1314 ==========================
1315
1316  * List of changed between 0.2.0 and 0.2.1
1317    o Add even faster double to integer (and back) conversion
1318      functions. [Tomas]
1319    o Fix some errors in the fixed point sine waveform
1320      function. [Tomas]
1321    o Use fixed point math in the Pango renderer. [Tomas]
1322    o Improve the GL version check. [Matthew]
1323    o Add a square waveform function. [Emmanuele]
1324  * List of bugs fixed
1325    o #215 - macro CLUTTER_MARK() not disabled for non-debug builds
1326
1327 Clutter 0.2 (18-01-2007)
1328 ========================
1329
1330  * List of changes between 0.2 and 0.1
1331    o Bindings, GStreamer and GTK+ dependencies moved out of tree:
1332      now Clutter strictly depends on Xlibs, OpenGL and GdkPixbuf only.
1333    o Actors now have an initial floating reference; this means you
1334      don't have to explicitely unref them: every memory an actor
1335      allocates will be freed when the group containing the actor will
1336      be destroyed.
1337    o Add basic run-time detection of GL features.
1338      + Use GL_TEXTURE_RECTANGLE_ARB if available.
1339      + Attempt to set up sync to vblank (set CLUTTER_VBLANK=none to disable)
1340    o Add API for behaviours. A ClutterBehaviour is an object which
1341      drives a set of actors using one or more properties depending
1342      on the value of an "alpha" function.
1343      + Provide simple behaviours: ClutterBehaviourOpacity,
1344        ClutterBehaviourPath and ClutterBehaviourScale.
1345      + Provide simple alpha functions for ramps and sine waveforms.
1346    o Add fixed point API for embedded platforms with no FPU.
1347    o Add support for command line switches to Clutter, like debug
1348      flags and abort on warnings; also allow application to hook up
1349      into the initialisation sequence to add their own command line
1350      switches.
1351    o Add Pango GL renderer for Clutter, and use it to render text
1352      inside the ClutterLabel actor; this decrease texture memory
1353      usage.
1354    o Redo Clutter Label widget, using the new Pango renderer.
1355    o Clutter Textures do not store local pixbuf copy (of texture).
1356    o Redo group and actor scale/sizing API and functionality.
1357    o Add memory management API for ClutterColor, and string parsing.
1358  * List of bug fixed
1359    o #199 - Little group handling fix?
1360    o #198 - Detect NPOT support on more systems
1361    o #197 - Tiled textures are broken
1362    o #196 - Rebuild the examples when the library changes
1363    o #156 - clutter_actor_set_position not using the absolute size
1364    o #155 - Don't test for XInitThreads [Bastien Nocera]
1365    o #154 - Key presses not working in super-oh example [Bastien Nocera]
1366    o #152 - Misc fixes [Bastien Nocera]
1367    o #143 - Faulty ref-counting in clutter_group_remove [Frederic Riss]
1368    o #141 - Copy-pasto in clutter_media_set_volume [Frederic Riss]
1369    o #101 - No package 'x11' found -- wrong configure [Tomasz Torcz]
1370    o  #98 - Enabling trails in super-oh crashes
1371
1372 Clutter 0.1 (22/06/2006)
1373 ========================
1374
1375  * First 'official' release, expect bugs aplenty.
1376  * Contains:
1377    o Hopefully enough functionality to build things.
1378    o Basic gstreamer 0.10 video playback support.
1379    o Fairly stable API, though in no way totally stable.
1380      Expect CHANGES in future versions.
1381    o Some simple examples ( also see OPT ).
1382    o An experimental GTK-Clutter widget.
1383    o Fairly complete Python bindings.
1384    o Non complete but hopefully useful API documentation.
1385  * If you want to help out see the TODO file.