NEWS

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