Release Clutter 1.7.4 (snapshot)
[profile/ivi/clutter.git] / NEWS
1 Clutter 1.7.4                                                        2011-07-04
2 ===============================================================================
3
4   • List of changes since Clutter 1.7.2
5
6     - Unify the GLX and EGL backends to be a single code base
7     The GLX and EGL backends shared most of their code, and with the split
8     out Cogl, we can unify the code base into a single backend. The API as
9     well as the ABI are preserved.
10
11     - Restore a wider range of Z values for actors
12     The computation for the near and far planes given the perspective
13     transformation used to set up the viewport was broken in 1.7.2, and
14     the distance from the focal point was greatly reduced. This has now
15     been fixed.
16
17     - Bump up the dependency of Cogl
18     New windowing system API in Cogl required bumping the minimum version
19     to the latest development snapshot, 1.7.2.
20
21     - Add ClutterDropAction
22     The ClutterDropAction is an action for allowing ClutterActors to react
23     when an actor being dragged through ClutterDragAction crosses, or is
24     dropped over, them.
25
26     - Add a performance test suite
27     This suite is an addition to our conformance and interactive test
28     suites; the infrastructure can be used by buildbots and report tools
29     to track performance regressions across various commits.
30
31     - Documentation and annotation fixes
32
33     - Build fixes
34
35   • List of bug fixes since Clutter 1.7.2
36
37     [bugzilla.gnome.org]
38
39     #650329 - ClutterModifierType: Port fix from GDK to clutter's GDK copy
40     #652566 - Clutter-CRITICAL **: _clutter_stage_get_window: assertion
41               `CLUTTER_IS_STAGE (stage)' failed
42     #651784 - transition=spin / transition=spin-text is broken in pinpoint
43               with Clutter master
44     #652842 - Add a Drop action
45     #653066 - ClutterDragAction does not support multiple pointers
46     #653307 - Change the signature of ClutterTexture::load-finished to give
47               a GError, instead of a gpointer
48     #653607 - Arrays not annotated as such for introspection bindings
49     #651079 - ClutterText "blinks" when deleting text after going out of
50               bounds
51     #650675 - clutter-media: mention the asynchronous behavior of
52               set_playing()
53
54     [buzgilla.clutter-project.org]
55
56     #2625 - The furthest visible z value is really low
57
58 Many thanks to:
59
60   Robert Bragg, Neil Roberts, Peter Ward, Colin Walters, Daniel Mustieles,
61   Jasper St. Pierre, Samuel Degrande, Øyvind Kolås
62
63 Clutter 1.7.2                                                        2011-06-13
64 ===============================================================================
65
66   • List of changes since Clutter 1.6.0
67
68     - Cogl moved out of tree
69     The Clutter OpenGL abstraction library has been moved to a separate
70     repository and can be used as a stand-alone shared library. Clutter
71     has been modified to depend on Cogl's experimental API.
72
73     - Correctly composite non fully opaque children
74     Non fully opauqe actors with non fully opaque children will automatically
75     redirect children paint operations to offscreen buffers, which allow
76     correct composition taking into account the overall opacity of the scene's
77     sub-graph. The same mechanism can be used to create a paint cache, and
78     paint that cache when the actor or its children do not change, instead of
79     painting the whole sub-graph again.
80
81     - Allow connecting signals to ClutterState states in ClutterScript
82     When defining a scene using ClutterScript it's possible to directly
83     connect a state inside a ClutterState object (both defined in
84     ClutterScript or in code) to an object's signal, without using an
85     explicit signal handler in the code.
86
87     - Long-press handling in ClutterClickAction
88     ClutterClickAction will detect a long-press gesture and emit signals
89     to query, activation and cancellation.
90
91     - Added ClutterGestureAction and ClutterSwipeAction
92     ClutterGestureAction is a generic "pointer gesture" action; it doesn't
93     provide an implementation: it's up to the developer to add the gesture
94     recognition code. ClutterSwipeAction is a GestureAction sub-class that
95     implement the "swipe" gesture. The GestureAction API is already future
96     proof for multi-device/multi-touch, even though the multi-touch isn't
97     currently implemented.
98
99     - Allow Effects to influence picking
100     Effects that change the geometry of a ClutterActor should also be
101     allowed to change the picking code to make sure that event handling
102     keeps working. ClutterEffect has a new pick() virtual function for
103     these cases.
104
105   • List of bugs fixes since Clutter 1.6.0
106
107     [bugzilla.clutter-project.org]
108     #2257 - clutter fails to link on OS X (10.6)
109     #2447 - atkevents example crashes is the accessibility is disabled
110     #2482 - Cally should avoid to provide a default name and description
111     #2484 - It would be nice to have the old cally Changelog
112     #2553 - new ClutterText API to access the Pango layout offsets
113     #2555 - Per-framebuffer journal causes corruptions
114     #2562 - Crash upon running Clutter-based programs
115     #2585 - add ClutterAction for slide gestures
116     #2588 - Assertion failure in _cogl_pipeline_set_layer_texture_target
117     #2595 - clutter-text: Add a selected-text-color
118     #2597 - CallyStage doesn't have a proper parent
119     #2599 - The paint volume for ClutterText is wrong
120     #2602 - Expose events ignored when doing clipped redraws
121     #2610 - Add recipe about implementing a ClutterEffect
122     #2619 - Removes the addition of the .exe extension to unit-test scripts,
123             on win32.
124     #2620 - _cogl_offscreen_new_to_texture_full() leaks reference when failing
125     #2621 - Clutter segfaults if you queue a redraw of an unmapped actor inside
126             the notify::mapped callback
127     #2631 - [PATCH] Enable evdev ClutterInputDevice objects on creation, as the
128             other backends do
129     #2632 - [PATCH] GL_IMG_TEXTURE_NPOT enables non-power-of-two features
130     #2633 - Make the pick id pool a per-Stage resource
131     #2640 - [patch] allow single-bit imprecision in some conformance tests
132     #2644 - Quartz backend: "Bare" modifier keypresses not generating events
133     #2652 - clutter_actor_queue_redraw() on destroyed stage
134     #2655 - segfault when disposing a slave device without a master
135     #2656 - Clutter can crash when destroying a stage from an event
136     #2667 - git head won't build under Win32
137
138     [bugzilla.gnome.org]
139     #650665 - CallyActor shouldn't add by default "press", "release"
140               and "click"
141     #647875 - Use Cairo to dump the pick buffers
142     #647876 - Make the pick if pool a per-Stage resource
143     #650487 - Sync allocation in ClutterBoxLayout with the one in GtkBox
144     #650597 - clutter-id-pool: fix warning on bad pick
145     #650650 - clutter-offscreen-effect: use target size when setting up
146               the viewport
147     #651700 - Give a chance to effects for running when picking
148     #652129 - Use "const" instead of G_CONST_RETURN
149
150 Many thanks to:
151
152   Neil Roberts, Robert Bragg, nobled, Daniel Mustieles, Elliot Smith,
153   Matej Urbančič, Alejandro Piñeiro, Chris Lord, Marek Černocký,
154   Tomeu Vizoso, Jasper St. Pierre, James Athey, Piotr Drąg, Øyvind Kolås,
155   Adam Jackson, Andrej Žnidaršič, Kjartan Maraas, Adel Gadllah,
156   Alexandre Franke, Christian Kirbach, Craig R. Hughes, Dan Winship,
157   Dioselin, Kristjan SCHMIDT, Mario Blättermann, Miguel Bouzada, Peter Ward,
158   Philippe Normand, Samuel Degrande, Viatcheslav Gachkaylo
159
160 Clutter 1.6.6                                                        2011-02-21
161 ===============================================================================
162
163   • List of changes since Clutter 1.6.4
164
165     » Add four mechanisms for migrating textures inside a Cogl atlas; it
166       is possible to change the default by using the environment variable
167       COGL_ATLAS_DEFAULT_BLIT_MODE.
168
169     » Use the offscreen buffer size to compute the vertices of
170       ClutterDeformEffect.
171
172     » Make the FPS counter displayed using CLUTTER_SHOW_FPS per-stage.
173
174     » Documentation fixes.
175
176     » Annotation fixes for introspection.
177
178   • List of bugs fixes since Clutter 1.6.4
179
180     #2538 - crash in gnome-shell
181     #2558 - backend-glx: Remove redundant glFlush()
182     #2561 - Updates to COGL sources regarding non-standard code usage
183     #2571 - DeformEffect should use the FBO size
184
185 Many thanks to:
186
187   Neil Roberts
188
189 Clutter 1.6.4                                                        2011-02-14
190 ===============================================================================
191
192   • List of changes since Clutter 1.6.2
193
194     » Fix handling of opacity in ClutterOffscreenEffect.
195
196     » Fix partially off-stage actors in ClutterOffscreenEffect.
197
198     » Add a recipe in the Cookbook for animating an actor on a path.
199
200     » Refresh key mapping when notified by X11.
201
202     » Clean up the ClutterStageWindow redraw implementations.
203
204     » Update the Wayland backend to match upstream API changes:
205       • allow using shared buffers if DRM fails;
206       • improve checks for the required extensions.
207
208     » Documentation fixes.
209
210     » Introspection annotations fixes.
211
212     » Fix setting the matrix for a pipeline layer.
213
214     » Fix flushing the framebuffer when switching to it.
215
216     » Make sure to call glFlush when blitting a stage region to the
217       front buffer, to avoid the driver batching the command for an
218       undefined amount of time.
219
220     » Fix the windowing system defines for non-X11 platforms.
221
222     » Fix the location of the shared objects in the Cally pkg-config
223       file.
224
225   • List of bugs fixed since Clutter 1.6.2
226
227     #1024 - test-multistage.c assertion failure
228     #1025 - test-paint-wrapper.c assertion failure
229     #1028 - test-random-text.c hangs with spinning beach ball
230     #1029 - test-cogl-primitives.c hangs with spinning beach ball
231     #1358 - scroll events not handled
232     #2373 - OSX Backend fix
233     #2525 - [PATCH] x11: Handle key map changes
234     #2541 - ClutterOffscreenEffect with multiply the actor's opacity
235     #2546 - [PATCH, git branch] update wayland backend
236     #2549 - Fix lib locations in *.pc.in
237     #2550 - offscreen effects are always clipped to stage boundaries
238     #2551 - Slight drawing lag with larger windows on Intel x3100 (i965)
239     #2554 - Add recipe per animating an actor on a curved path
240     #2555 - Per-framebuffer journal causes corruptions
241     #2558 - backend-glx: Remove redundant glFlush()
242     #2559 - x11: segfault on closing non-default stage window
243
244 Many thanks to:
245
246   nobled, Chris Lord, Neil Roberts, Robert Bragg, Adel Gadllah, Elliot Smith
247
248 Clutter 1.6.2                                                        2011-02-07
249 ===============================================================================
250
251   • List of changes since Clutter 1.6.0
252
253     » Fix building the Clutter Cookbook from the released tarballs.
254
255     » Set the input device field in ClutterEvent even when they
256       have been allocated by Clutter.
257
258     » Fix the color comparison when setting the layer combine constant.
259
260     » Fix memory corruption when removing the last reference on a
261       Cogl vertex buffer object.
262
263     » Fixes for the OSX backend.
264
265   • List of bugs fixed since Clutter 1.6.0
266
267     #2540 - coobook examples do not build from tarball
268     #2544 - Using vertex buffers causes memory corruption when you unref
269             the CoglHandle
270     #2545 - Broken event handling in OS X backend
271     #2549 - Fix lib locations in *.pc.in
272
273 Many thanks to:
274
275   Neil Roberts, Viatcheslav Gachkaylo
276
277 Clutter 1.6.0                                                        2011-01-31
278 ===============================================================================
279
280   • List of changes since Clutter 1.5.14
281
282     » Remove more private symbols from the X11 backend.
283
284     » Add CLUTTER_BIND_POSITION and CLUTTER_BIND_SIZE values to the
285       ClutterBindCoordinate enumeration; these are short-hand values
286       for binding both X and Y, or width and height, instead of
287       requiring two ClutterBindConstraint instances.
288
289     » Clean up in the X11 backend to reduce indirection.
290
291     » Small clean ups in the Win32 backend.
292
293     » Make Shift+Backspace behave like Backspace in ClutterText.
294
295     » Emit the ::new-frame signal even on the first frame of
296       ClutterTimeline, to allow setting up the initial state of an
297       animation.
298
299     » Fix an invalid memory access in ClutterAnimator.
300
301     » Flush the per-framebuffer journal when switching between
302       framebuffers.
303
304     » Generalize updating GLES2 uniforms.
305
306     » Add debug code for tracing clipping in Cogl.
307
308     » Improve the OSX event loop, re-using the same implementation
309       as GDK. Also, provide simple, core-like device support.
310
311   • Bugs fixed since Clutter 1.5.14
312
313     #2490 - OS X backend event loop improved
314     #2530 - animator: Animator uses key after freeing it
315     #2534 - Incorrect description of function 'clutter_actor_pop_internal'
316     #2535 - Add recipe about creating a composite actor
317
318 Many thanks to:
319
320   Neil Roberts, Robert Bragg, Elliot Smith, Rob Bradford,
321   Viatcheslav Gachkaylo
322
323 Clutter 1.5.14                                                       2011-01-24
324 ===============================================================================
325
326   • List of changes since Clutter 1.5.12
327
328     » Allow getting the state modifiers from a ClutterClickAction.
329
330     » Fix ClutterDragAction to never leave the event delivery in
331       an unwanted state.
332
333     » Optimize state changes for texture and data states.
334
335     » Enable VBO support in Cogl for GLES2.
336
337     » Fix compilation on GLES1.1.
338
339     » Documentation fixes.
340
341     » ClutterGLXTexturePixmap has been deprecated; its parent class
342       ClutterX11TexturePixmap and the low level CoglTexturePixmapX11
343       API provide access to the same features.
344
345     » Be more resilient against timelines controlling the state of
346       other timelines during the clock tick.
347
348     » Provide defines for the windowing platforms, to allow portable
349       applications to include the correct header and select the
350       correct API depending on the target.
351
352     » Introduce a fast path for cogl_read_pixels() that uses the journal
353       to determine the position of a single pixel on the stage; this
354       fast path gracefully degrades to the usual render-based approach,
355       and should speed up picking considerably in the case of opaque
356       quads batched together.
357
358     » Support XInput axis data on valuator devices, and introduce XInput2
359       support for event translation and device hotplugging. The support
360       for XI and XI2 must still be explicitly enabled by the developer,
361       but it is now compiled in by default. It can be disabled at compile
362       time by passing --disable-xinput to the configure script.
363
364     » Clean up the unintentionally leaked internal symbols in the X11
365       and GLX backends.
366
367     » Allow defining the contents of the rows of a ListModel using
368       ClutterScript. This completes the ability to fully define a
369       ClutterListModel inside a UI definition file.
370
371   • Bugs fixed since Clutter 1.5.12
372
373     #1422, key input handler for eglnative
374     #1456, Hinting mishandling
375     #1721, XInput2 support
376     #2268, EGL backend dependent on X11 headers
377     #2400, Don't enable GL_POINT_SPRITE on GLES
378     #2497, should not throw away a program when just the texture
379            object has changed
380     #2512, shader: Don't notify properties when finalizing shaders
381     #2513, script-parser: Also honor properties of type GType
382     #2516, [PATCH] Fails to compile with --with-gles=1.1
383     #2518, introspection: Add missing (out) annotations for get_color()
384     #2520, Add API to get modifier type in ClutterClickAction
385     #2522, ClutterDragAction might indefinitely disable motion events
386     #2524, It's possible to receive a new-frame signal after stopping
387            a timeline
388     #2526, model: Fix some GObject-Introspection annotations
389     #2527, model: Change the column argument type to gint for
390            clutter_model_set_sort
391     #2528, model: Add support to define rows in ClutterScript
392
393 Many thanks to:
394
395   Robert Bragg, Neil Roberts, Bastian Winkler, Lucas Rocha, Adel Gadllah,
396   Chris Lord, Damien Lespiau
397
398 Clutter 1.5.12                                                       2011-01-11
399 ===============================================================================
400
401   • List of changes since Clutter 1.5.10
402
403     » Allow disabling the focus when showing a ClutterStage; this also
404       makes Clutter more compliant to the X11 window manager
405       specifications.
406
407     » Avoid state corruption in relayout cycles.
408
409     » Do not crash when destroying actors during CLUTTER_LEAVE events.
410
411     » Remove signal handlers when disposing constraints.
412
413     » Keep the pixel alignment for ClutterAlignConstraint.
414
415     » Do not release compiled ClutterShader during their finalization to
416       avoid a warning.
417
418     » Revert an ABI break on the ClutterContainer pre-requisites.
419
420     » Fix the name of the cogl_normal_in attribute.
421
422     » Do not assume CoglBitmaps are allocated to height * rowstride.
423
424     » Fix the core device list creation on X11.
425
426     » Avoid enabling blending in the Cogl journal, if possible.
427
428     » Documentation fixes.
429
430     » Build fixes for mixed autotools version environment.
431
432     » Improve the performance of getting the number of rows of a
433       ClutterListModel.
434
435     » Don't use obsolete API internally.
436
437     » Build fix for compiling EGL backend with OpenGL under X11.
438
439     » Parse GType object properties in ClutterScript.
440
441 Many thanks to:
442
443   Neil Roberts, Johan Bilien, nobled, Adel Gadllah, Damien Lespiau,
444   Kristian Høgsberg, Nguyễn Thái Ngọc Duy, Tomeu Vizoso, Bastian Winkler
445
446 Clutter 1.5.10                                                       2010-12-17
447 ===============================================================================
448
449   • List of changes since Clutter 1.5.8
450
451     » Add an evdev input backend; this adds support for input devices
452       on Linux when using the EGL-based backends.
453
454     » Update the build scripts for compiling the Windows backend.
455
456     » Updates for the Cookbook and the API references.
457
458     » Fix ClutterModel::get_iter_at_row() for filtered ClutterListModels.
459
460     » Scores of fixes to the pipeline state object for GLES2.
461
462     » Add code that tries to perform manual clipping to avoid breaking
463       up batches of primitives.
464
465     » Keep a cache of ARBfp programs indexed by the pipeline state that
466       led to their generation.
467
468     » Accept G_TYPE_DOUBLE values in ClutterShaderEffect uniforms.
469
470     » Update the Wayland client backend.
471
472     » Update the build for Windows.
473
474     » Rename the ClutterTimeline:reverse property introduced in
475       Clutter 1.5.6 to ClutterTimeline:auto-reverse.
476
477     » Clean up the interactive tests suite.
478
479 Many thanks to:
480
481   Neil Roberts, Damien Lespiau, Robert Bragg, Elliot Smith,
482   Jussi Kukkonen, nobled, Alexandre Quessy, Mike Owens,
483   Tomeu Vizoso
484
485 Clutter 1.5.8                                                        2010-11-29
486 ===============================================================================
487
488   • List of changes since Clutter 1.5.6
489
490     » Add a migration guide for code using Behaviours.
491
492     » Allow parsing rgb(), rgba(), hls() and hlsa() color definitions.
493
494     » Performance improvements for the ClutterX11TexturePixmap.
495
496     » For caching purposes, do not discard the Material or the compiled
497       shaders for Offscreen and Shader effects.
498
499     » Fix image height in 3D Cogl textures.
500
501     » Create a GLSL generation backend for materials, similar to the
502       ARBfp one; this backend is the default for GLES2.
503
504     » Use FBOs and cogl_read_pixels() to efficiently read back partial
505       texture data.
506
507     » Various fixes in paint volumes computation and caching.
508
509     » Use the internal scene graph walk API to remove the map/unmap
510       implementation requirement for composite actors and for
511       containers with internal children.
512
513     » Simplify the backend notification of layer changes.
514
515     » Queue clipped redraws for Expose events on X11.
516
517     » Plug leaks.
518
519     » Include a porting guide from Behaviours.
520
521     » Add a recipe on scaling animations in the Cookbook.
522
523 Many thanks to:
524
525   Neil Roberts, Robert Bragg, Owen W. Taylor, Tomeu Vizoso, Chris Lord,
526   Alexandre Quessy, Evan Nemerson, Elliot Smith
527
528 Clutter 1.5.6                                                        2010-11-19
529 ===============================================================================
530
531   • List of changes since Clutter 1.5.4
532
533     » Deprecate ClutterBehaviour and its sub-classes: the same functionality
534       is available using the animation framework.
535
536     » Add ClutterSnapConstraint, a constraint implementation that snaps
537       together the edges of two actors.
538
539     » Add ClutterPathConstraint::node-reached.
540
541     » Deprecate ClutterTimeoutPool and ClutterFrameSource: this API is
542       not used internally any more, and since it's not integrated with
543       the master clock it's of relative use.
544
545     » Add a named, global color palette.
546
547     » Add the ClutterTimeline:reverse property, for automatically
548       reversing the direction of a timeline after the emission of
549       the ::completed signal.
550
551     » Performance improvements in the clip stack.
552
553     » Do not use pointer grabs in ClutterClickAction.
554
555     » Improve the internally used Cogl API for primitives, paths and
556       buffers; this is the first step towards Cogl 2.0.
557
558     » Allow using the COGL_DEBUG environment variable to disable the
559       NPOTs support.
560
561     » Plug a nasty infinite loop in the XSETTINGS implementation.
562
563     » Internally rename CoglMaterial to CoglPipeline; this should make
564       it clearer that the API refers to the state of the GPU pipeline.
565
566     » Add support for clipped redraws on EGL using the NOK_swap_region
567       extension.
568
569     » Build fixes.
570
571     » Use the monotonic clock API if compiling against GLib ≥ 2.27.3.
572
573     » Update examples in the Cookbook.
574
575     » Add a Cookbook recipe for looping animations.
576
577     » Add more documentation on Constraints.
578
579     » Documentation fixes.
580
581 Translation updates:
582
583   Italian, Polish
584
585 Many thanks to:
586
587   Robert Bragg, Neil Roberts, Elliot Smith, Owen W. Taylor,
588   Damien Lespiau, Lucas Rocha, Maxim Ermilov, Piotr Drąg,
589   Tomeu Vizoso, muflone
590
591 Clutter 1.5.4
592 ===============================================================================
593
594   • List of changes since Clutter 1.5.2
595
596     » Add a backend for Wayland.
597
598     » Depend on GLib ≥ 2.26, Cairo ≥ 1.10.
599
600     » Do not generate the conformance tests list using the test-conformance
601       binary.
602
603     » Implement interval progress functions for ActorBox, Vertex, Geometry,
604       Color and Units.
605
606     » Allow overriding the surface creation in Clutter.CairoTexture.
607
608     » Add interpolate() method to Clutter.Color.
609
610     » Add ClutterPathConstraint, a simple constraint that sets the origin
611       of an actor's allocation to follow a ClutterPath.
612
613     » Plug some memory leaks.
614
615     » Fix build of the CEx100 and EGL backends.
616
617     » Fixes for the OSX backend.
618
619     » Documentation consistency and spell checking fixes.
620
621     » Build fixes.
622
623 Translation updates:
624
625   Andika Triwidada (id), Damien Lespiau (fr), Piotr Drąg (po)
626
627 Many thanks to:
628
629   Damien Lespiau, Neil Roberts, Kristian Høgsberg, Andika Triwidada,
630   Ole André Vadla Ravnås, Robert Bragg, Owen W. Taylor, Piotr Drąg,
631   Roland Peffer
632
633 Clutter 1.5.2  (04/10/2010)
634 ===============================================================================
635
636   • List of changes since Clutter 1.4.0
637
638     » Add API to ClutterActor to allow any actor to define its 3D paint
639       volume and its stage-relative 2D bounding box; the paint volume is
640       the 3D space occupied by an actor during the paint sequence. This
641       allows better sizing of the FBOs, and opens the door to scenegraph
642       culling and accurate clipped redraws. The mechanism is opt-in: actors
643       have to implement the get_paint_volume() virtual function. Callbacks
644       attached to the ::paint signal will also disable any culling and
645       clipped redraw in place internally.
646
647     » Plug a leak in ClutterActor by disposing all constraints.
648
649     » Rework the build system to be as non-recursive as possible; this should
650       speed up the build of Clutter, and makes the build layout easier to
651       understand and update.
652
653     » Remove the internal copy of JSON-GLib; the internal copy was falling
654       behind at a spectacular level, and it was actually making the build
655       rather complicated - also by adding an unwanted, but needed,
656       introspection data generation. The required JSON-GLib has also been
657       bumped to the new stable release, 0.12.0.
658
659     » Use g_object_install_properties() with GLib 2.26.
660
661     » Implement ClutterContainer::child-notify, which slipped through the
662       cracks of many development cycles without anyone noticing.
663
664     » Document and test clutter_actor_contains(), especially the corner
665       cases.
666
667     » Plug a leak in CoglTexture2DSliced.
668
669     » Plug a leak in ClutterAnimator's handling of timelines.
670
671     » Trap glXDestroyPixmap() in CoglTexturePixmapX11 to avoid BadDrawable
672       errors when the GLX pixmap is destroyed behind Cogl's back.
673
674 Many thanks to:
675
676   Robert Bragg
677   Neil Roberts
678   Elliot Smith
679   Alejandro Piñeiro
680   Aron Xu
681   Colin Walters
682   Ray Strode
683   Stephen Kennedy
684
685 Clutter 1.4.0  (24/09/2010)
686 ===============================================================================
687
688   • List of changes since Clutter 1.3.14
689
690     » Add support for describing ClutterState states using ClutterAnimators
691       in ClutterScript.
692
693     » Build fixes
694
695     » Include ClutterConstraints into the allocation phase, to avoid layout
696       cycles and improve the performance.
697
698     » Add new recipes to the Cookbook to illustrate constraints-based
699       layouts.
700
701     » Fix the request mode of ClutterBoxLayout.
702
703     » Fix the handling of transformations in ClutterOffscreenEffect.
704
705     » Documentation and introspection fixes.
706
707 Many thanks to:
708
709   Elliot Smith
710   Robert Bragg
711   Neil Roberts
712   Bastian Winkler
713   Dominique Leuenberger
714   Frederik Hahne
715   Jammy Zhou
716   Øyvind Kolås
717
718 Clutter 1.3.14 (15/09/2010)
719 ===============================================================================
720
721   • List of changes since Clutter 1.3.12
722
723     » Fix applying layout properties from ClutterScript definitions in case
724       of multiple children.
725
726     » Add a Clutter EGL backend for Intel CEx100 platforms.
727
728     » Add new recipes in the Cookbook:
729       - texture cross-fading
730       - ClutterScript definitions
731       - event handling
732       - ClutterAnimator
733       - reusing complex animations
734
735     » Add methods to retrieve the clicked button and to force a release
736       in ClickAction.
737
738     » Documentation fixes in the API reference.
739
740     » Cache a full pick buffer and re-use it in case the scene does not change
741       between events.
742
743     » Fix a Valgrind report of memory corruption in ClutterState.remove_key().
744
745     » Allow detaching animations created with clutter_actor_animate().
746
747     » Depend on GObject-Introspection >= 0.9.5.
748
749     » Provide introspection data for the X11-specific API, like
750       ClutterX11TexturePixmap
751
752     » Use a template material for ClutterTexture to minimize the creation of
753       new materials.
754
755     » Split ClutterDragAction:drag-threshold into two, per-axis properties:
756       :x-drag-threshold and :y-drag-threshold.
757
758     » Allow disabling the -Bsymbolic flag when linking.
759
760     » Use gettext >= 0.17 to handle the localization.
761
762     » Flush the framebuffer earlier when drawing the vertex buffers, to fix
763       a crash when dealing with clip stacks.
764
765     » Make sure ClutterX11TexturePixmap removes the Cogl texture handle before
766       freeing the X11 Pixmap to avoid an error.
767
768     » Avoid regenerating the CoglMaterial programs too many times.
769
770 Many thanks to:
771
772   Elliot Smith
773   Robert Bragg
774   Damien Lespiau
775   Neil Roberts
776   Colin Walters
777   Owen W. Taylor
778   Bastian Winkler
779   Alejandro Piñeiro
780   Alexandros Frantzis
781   Chris Kühl
782   Luca Invernizzi
783   Henrik Hedberg
784   Javier Jardón
785   Lucas Rocha
786   Murray Cumming
787   Øyvind Kolås
788
789 Clutter 1.3.12 (16/08/2010)
790 ===============================================================================
791
792   • List of changes since Clutter 1.3.10
793
794     » New recipes in the Cookbook:
795       - create and animate sub-textures
796       - layout managers
797       - scroll events
798
799     » Set the ClutterTexture:filename property to also be readable.
800
801     » Avoid layout cycles when creating ClutterLayoutMeta objects
802       during the ::allocate implementation
803
804     » Add a ClutterTableLayout, a layout manager for tabular layouts.
805
806     » Capture ENTER and LEAVE events on the stage within the DragAction.
807
808     » Plug memory leaks.
809
810     » Use g_object_notify_by_pspec(), if available, to speed up the
811       emission of the ::notify signal on property changes.
812
813     » Re-use the Cogl texture atlas for the CoglPango glyphs cache,
814       and improve the performance with large font sizes.
815
816     » Various fixes in the Materials comparison and inheritance.
817
818     » Add the ability to associate a user program to a material.
819
820 Many thanks to:
821
822   Neil Roberts
823   Elliot Smith
824   Robert Bragg
825   Damien Lespiau
826   José Dapena Paz
827   Owen W. Taylor
828
829 Clutter 1.3.10 (04/08/2010)
830 ===============================================================================
831
832   • List of changes since Clutter 1.3.8
833
834     » Fix a locale-dependent conversion from double to string when
835       generating ARBfp programs for the materials.
836
837     » Use the XKB extension on X11 platforms to convert between hardware
838       keys to key symbols.
839
840     » Documentation fixes in the API reference.
841
842     » More recipes, with videos and full examples, in the Cookbook.
843
844     » Add localization support and initial translations of error messages
845       that might be visualized in a user interface.
846
847     » Improve debugging output.
848
849     » Fix build of the GLX backend on OSX.
850
851     » Multiple fixes to the native OSX backend.
852
853     » Add support for 3D textures in Cogl.
854
855     » Fix shader-related issues and leaks in the new Material code.
856
857     » Unify GLSL support in the GL and GLES 2.0 drivers.
858
859     » Allow specifying an hint to disable clearing the stage before each
860       paint cycle.
861
862 Many thanks to:
863
864   Neil Roberts
865   Roman Kudiyarov
866   Elliot Smith
867   Robert Bragg
868   Chris Kühl
869   Chris Leick
870   Nate Stedman
871   happyaron
872   raven
873   Øyvind Kolås
874
875 Clutter 1.3.8 (12/07/2010)
876 ===============================================================================
877
878   • List of changes since Clutter 1.3.6
879
880     » Merge Cally, the Clutter Accessibility Library, in the Clutter tree.
881
882     » Take into consideration the source actor's position in the
883       AlignConstraint logic.
884
885     » Update the internal COGL tesselator with the latest GLU code.
886
887     » Fix CoglTexture data readback.
888
889     » Use GL_MAX_TEXTURE_SIZE on GLES when checking the supported texture size.
890
891     » Add missing public functions from COGL headers.
892
893     » Fix GLES build after the Cogl material changes.
894
895     » Rename the experimental CoglPixelBuffer API to CoglPixelArray.
896
897     » Split the clutter_state_change() method into two:
898     clutter_state_set_state(), for animated state changes; and
899     clutter_state_warp_to_state() for immediate state changes.
900
901     » Documentation and introspection fixes.
902
903     » Build fixes
904
905 Many thanks to:
906
907   Robert Bragg
908   Neil Roberts
909   Elliot Smith
910   Alejandro Piñeiro
911   Øyvind Kolås
912   Damien Lespiau
913   Alexandros Frantzis
914
915 Clutter 1.3.6 (30/06/2010)
916 ===============================================================================
917
918   • List of changes since Clutter 1.3.4
919
920     » Provide a fallback on GLX if the MESA_copy_sub_buffer extension is not
921       available, by using EXT_framebuffer_blit. Both mechanisms are also
922       throttled to avoid taking all resources when using them in a compositor
923       like Mutter.
924
925     » Use (and cache) fragment shaders instead of texture combiners inside
926       Cogl materials. Cogl will automatically fall back from GLSL to ARBfp
927       to fixed functions depending on the level of support of the underlying
928       GL implementation.
929
930     » Implement a new design for materials; this allows scaling up the
931       number of materials in a scene, and also makes copying materials
932       less expensive.
933
934     » Make Cogl materials responsible for depth testing, and add new
935       experimental API.
936
937     » Use the (modified) GLU tesselator to draw paths to a vertex buffer
938       object instead of using the stencil buffer, or the scanline rasterizer
939       on platforms without a stencil buffer.
940
941     » Add ClutterDeformEffect, a base class for effects that deform an
942       actor's geometry when painting it; ClutterPageTurnEffect is an
943       implementation of a "page curl" deformation using the DeformEffect
944       API.
945
946     » Always use scissoring when clipping, to reduce the amount of buffer
947       that has to be cleared.
948
949     » Allow ClutterShaderEffect sub-classes to use vertex shaders by setting
950       a constructor property; the default remains fragment shader.
951
952     » Remove the button of the press event from the DragAction::drag-begin
953       and DragAction::drag-end signals. This is an API break from 1.3.4.
954
955     » Do not promote clipped redraws to full redraws.
956
957     » Improve the consistency of the default state name in ClutterState,
958       both in the API and in the serialization format.
959
960     » Fix a rounding error with the Text layout size.
961
962     » Add utility functions for CoglMatrix and CoglColor.
963
964     » Avoid a re-allocation cycle warning when resizing the surface of
965       a CairoTexture actor from within the allocate() implementation.
966
967     » Do not add the GL libraries for the EGL X11 backend.
968
969     » Add more checks for size of data passed to the shader types GValue
970       functions.
971
972     » Add width and height to the BindConstraint.
973
974     » Parse actions, constraints and effects inside an actor definition
975       for ClutterScript.
976
977     » Merge the code of native and x11 backends for EGL into a single
978       backend; also allow creating GL context with the EGL backend.
979
980     » Use XSETTINGS to set up the backend configuration options, like
981       the font name, resolution, font options and double click options,
982       on X11; this also allows ClutterText actors created using the
983       default font name to be updated when the font name and options
984       change; similarly, this allows ClutterUnits to be updated when
985       the screen resolution changes.
986
987     » Implement the texture_from_pixmap extension support inside Cogl
988       itself, and unify ClutterX11TexturePixmap and ClutterGLXTexturePixmap.
989
990     » Documentation improvements in the API reference and in the cookbook.
991
992     » Use the -Bsymbolic-functions linker option on supported platforms
993       to avoid intra-library PLT jumps.
994
995     » Fix painting transparent stages on X11 using the :use-alpha property
996       of ClutterStage.
997
998     » Fix emission of scroll events on Windows.
999
1000 Many thanks to:
1001
1002   Robert Bragg
1003   Neil Roberts
1004   Øyvind Kolås
1005   Damien Lespiau
1006   Elliot Smith
1007   Chris Lord
1008   Johan Bilien
1009   Richard Hughes
1010   Adel Gadllah
1011   Alejandro Piñeiro
1012   Colin Walters
1013   Dan Winship
1014   Kristian Høgsberg
1015   Sunil Sadasivan
1016
1017 Clutter 1.3.4 (07/06/2010)
1018 ===============================================================================
1019
1020   • List of changes since Clutter 1.3.2
1021
1022     » Add ClutterEffect, a ClutterActorMeta sub-class that affects the
1023       way an actor paints itself.
1024
1025         » Clutter provides a base class for effects painting to an
1026           offscreen buffer, and a base class for effects using the
1027           GL programmable pipeline (through the GLSL shader language).
1028
1029         » Clutter also provides some simple, shader-based effects:
1030           ClutterBlurEffect, ClutterColorizeEffect and
1031           ClutterDesaturateEffect.
1032
1033         » Effects can be applied to any actor, and can also be stacked.
1034
1035     » Add ClutterClickAction, an action that provides "button-like"
1036       semantics for any ClutterActor.
1037
1038     » ClutterDragAction now moves the actor to which it has been applied
1039       by default, using a class handler for the ::drag-motion signal.
1040
1041     » Add the :pick-with-alpha property to ClutterTexture; this property
1042       allows using the alpha channel of a texture when picking it.
1043
1044     » Regenerate the mipmaps on COGL textures when a texture is modified.
1045
1046     » Documentation and build fixes.
1047
1048 Many thanks to:
1049
1050   Robert Bragg
1051   Damien Lespiau
1052   Neil Roberts
1053   Colin Walters
1054
1055 Clutter 1.3.2 (24/05/2010)
1056 ===============================================================================
1057
1058   • List of changes since Clutter 1.2
1059
1060     » Add ActorMeta, a class for run-time composition of actions and
1061       constraints on a ClutterActor:
1062
1063         » Add ClutterAction, a class for implementing business logic
1064           related to event handling.
1065
1066         » Add ClutterConstraint, a class for implementing business
1067           logic related to sizing and positioning.
1068
1069         » ClutterDragAction is an Action sub-class that implements
1070           signals and properties for dragging actors.
1071
1072         » ClutterAlignConstraint and ClutterBindConstraint are two
1073           Constraint sub-classes that allow relative positioning
1074           with fixed layout managers.
1075
1076     » Add ClutterState, an object for defining state transitions.
1077
1078     » Add ClutterBoxLayout:homogeneous property.
1079
1080     » Implement retained clip stacks.
1081
1082     » Support retained paths.
1083
1084     » Add an experimental vector3 API.
1085
1086     » Require GLib >= 2.18.
1087
1088     » Require Atk >= 1.7.
1089
1090     » Make ClutterActor implement AtkImplementor, and allow retrieving
1091       an AtkObject from a ClutterActor.
1092
1093     » Improve ClutterText's Pango layout caching mechanism.
1094
1095     » Fix set up of the GLX_SGI_swap_control extension.
1096
1097     » Fix EGLX backend.
1098
1099     » Documentation fixes for Clutter and COGL.
1100
1101     » Fix the conformance test suite by executing every test unit in
1102       a separate process.
1103
1104     » Add platform-dependent defines for Cogl.
1105
1106     » Update the MingW cross-compilation script.
1107
1108     » New recipe in the Cookbook.
1109
1110 Many thanks to:
1111
1112   Neil Roberts
1113   Robert Bragg
1114   Øyvind Kolås
1115   Owen W. Taylor
1116   Brian Tarricone
1117   Damien Lespiau
1118   Adel Gadllah
1119   Chris Lord
1120   Fridrich Strba
1121   José Dapena Paz
1122   Jussi Kukkonen
1123   Rob Bradford
1124
1125 Clutter 1.2.2 (15/03/2010)
1126 ===============================================================================
1127
1128   • List of changes since Clutter 1.2.0
1129
1130     » Fix introspection annotations for ClutterBox
1131
1132     » Compilation fixes for the EGL native backend
1133
1134     » Fix ClutterX11TexturePixmap ::queue-damage-redraw default handler
1135       registration to avoid a run-time warning
1136
1137     » Handle TEXTURE_RECTANGLE_ARB in the 2D sliced textures, and add
1138       a test case for that extension to avoid regressions
1139
1140     » Improve the strictness of the JSON parser in the internal copy
1141       of JSON-GLib to which we fall back in the absence of the system
1142       one
1143
1144     » Fix a crasher on NVidia drivers when enabling the ARGB visuals
1145       by default on GLX.
1146
1147 Many thanks to:
1148
1149   José Dapena Paz
1150   Neil Roberts
1151   Owen W. Taylor
1152   Øyvind Kolås
1153
1154 Clutter 1.2.0 (02/03/2010)
1155 ===============================================================================
1156
1157   • List of changes since Clutter 1.1.14
1158
1159     » Improve the Animator API for consistency, and the implementation
1160       to match the intended behaviour, as documented
1161
1162     » Add initial (and internal) support for queueing clipped region updates
1163       and let the GLX texture-from-pixmap actor take advantage of it
1164
1165     » Support any pixel format in cogl_read_pixels()
1166
1167     » Conditionally use G_VALUE_COLLECT_INIT() in functions using variadic
1168       arguments lists
1169
1170     » Consistently use :min-width and :min-height inside the Stage to define
1171       the minimum size of the Stage window
1172
1173     » Implement the Scriptable interface for ClutterModel sub-classes; this
1174       allows setting ClutterModel columns (both types and names) in
1175       ClutterScript definitions
1176
1177     » Add support for unsigned integer indices in the VertexBuffer API
1178
1179     » Documentation fixes for Clutter: the coverage is now 100%
1180
1181     » Fixes for the EGL native backend
1182
1183     » Require libtool >= 2.2.6
1184
1185     » Improve tests coverage
1186
1187 Many thanks to:
1188
1189   Neil Roberts
1190   Øyvind Kolås
1191   Robert Bragg
1192   Bastian Winkler
1193   Chris Lord
1194   Owen W. Taylor
1195
1196 Clutter 1.1.14 (24/02/2010)
1197 ===============================================================================
1198
1199   • List of changes since Clutter 1.1.12
1200
1201     » Fix interaction between user resizable Stages and fullscreen on X11
1202
1203     » Define the semantics of ENTER and LEAVE events when actors are on the
1204       border of the Stage window
1205
1206     » Take the InputDevice of an event into consideration when throttling
1207       MOTION events
1208
1209     » Round the coordinates when clipping to a rectangle in window coordinates
1210
1211     » Always trust the user-provided coordinates when creating a CoglTexture
1212       from a foreign GL texture
1213
1214     » Split Clutter's debug annotations from the pick and paint mode
1215       behavioural modifiers
1216
1217     » Improve the usage of the CLUTTER_ACTOR_NO_LAYOUT flag so that every
1218       actor using a ClutterFixedLayout manager will automatically benefit
1219       from it
1220
1221     » Fix the packing order of ClutterBox so that the convention of
1222       first-in-first-painted is maintained
1223
1224     » Documentation fixes
1225
1226 Many thanks to:
1227
1228   Robert Bragg
1229   Chris Lord
1230   Neil Roberts
1231
1232 Clutter 1.1.12 (16/02/2010)
1233 ===============================================================================
1234
1235   • List of changes since Clutter 1.1.10
1236
1237     » Fix compilation on 64bit platforms
1238
1239     » Fix some races of the Stage resizing on X11
1240
1241     » Documentation fixes for Cogl: the coverage is now 100%
1242
1243     » Fix rounding errors in the preferred height of the ClutterText
1244       actor
1245
1246     » Remove redundant type checks in clutter_actor_get_paint_opacity()
1247
1248     » Add support for the GLX_INTEL_swap_event extension; when using this
1249       extension on GLX the glXSwapBuffers() call becomes non-blocking and
1250       Clutter will use an event to control the master clock.
1251
1252     » Improve consistency between ClutterBox and ClutterGroup.
1253
1254     » On X11, do not set the _NET_WM_PID and WM_TITLE properties on a
1255       Stage X window if the window was not created by Clutter itself
1256
1257     » Improve caching of GL constant values
1258
1259     » Optimize creating sub-textures of sub-textures
1260
1261     » Various fixes for the atlas and the journal
1262
1263     » Disable the atlas if FBOs are not supported
1264
1265 Many thanks to:
1266
1267   Robert Bragg
1268   Neil Roberts
1269   Damien Lespiau
1270   Bastian Winkler
1271   Chris Lord
1272
1273 Clutter 1.1.10 (09/02/2010)
1274 ===============================================================================
1275
1276   • List of changes since Clutter 1.1.8
1277
1278     » Fixed a regression in textures that caused all the textures to be
1279       drawn as white rectangles.
1280
1281     » Fixed compilation with the Sun C compiler.
1282
1283     » Use SSE2 instructions to premultiply RGBA images, if available.
1284
1285     » Improve readability of ClutterActor::raise/::lower warnings.
1286
1287 Many thanks to:
1288
1289   Neil Roberts
1290   Halton Huo
1291
1292 Clutter 1.1.8 (08/02/2010)
1293 ===============================================================================
1294
1295   • List of changes since Clutter 1.1.6
1296
1297     » Added ClutterAnimator, a class that allows defining complex
1298       implicit animations involving multiple actors and states; this
1299       class is mostly meant to be used through the ClutterScript
1300       definition format, but it provides a convenience C API for
1301       easily building animations.
1302
1303     » New experimental COGL API to expose "hardware" buffers such as PBOs or
1304       drm surfaces. This API can be used, for instance, to make texture
1305       uploading faster.
1306
1307     » Fixed the issues with resizable stages getting a 1x1 window with
1308       the X11 backends
1309
1310     » Expose input devices for every event; by default, X11 and Windows
1311       backends expose the core devices only.
1312
1313     » Add the ClutterStage:key-focus property, for key focus tracking.
1314
1315     » Allow setting transformable value types in ClutterAnimation when
1316       calling clutter_animation_bind() and clutter_animation_update().
1317
1318     » Delay the creation of the default Stage until clutter_stage_get_default()
1319       is actually called; this reduces the work of clutter_init().
1320
1321     » Implement Ctrl+Delete and Ctrl+Backspace in ClutterText
1322
1323     » Improve the extendability of CoglTexture with internal backends.
1324
1325     » Add implicit texture atlasing; Cogl will try to put every texture
1326       inside the same texture atlas by default, to avoid state changes
1327       in the driver and (hopefully) improve performance.
1328
1329     » Fix notification of the cursor and selection changes in ClutterText;
1330       this improves the usage of Clutter from A11Y toolkits.
1331
1332     » Do not wait for a frame if the system clock goes backwards.
1333
1334     » Fix the dirtying of the clip state; this unbreaks cogl_path_fill().
1335
1336     » Documentation and build fixes.
1337
1338 Many thanks to:
1339
1340   Neil Roberts
1341   Chris Lord
1342   Damien Lespiau
1343   Alejandro Piñeiro
1344   Jussi Kukkonen
1345   Kristian Høgsberg
1346   Robert Bragg
1347   Øyvind Kolås
1348
1349 Clutter 1.1.6 (18/01/2010)
1350 ===============================================================================
1351
1352   • List of changes since Clutter 1.1.4
1353
1354     » Some fixes for the Win32 backend (bug #1905).
1355
1356     » Profiling support via the UProf library. Configure with
1357       --enable-profile to get a report after each Clutter application is
1358       run.
1359
1360     » Improved conformance tests with coverage reports via gcov.
1361
1362     » ClutterTexture no longer tries to read back texture data into
1363       g_malloc'd memory on unrealize (bug #1842).
1364
1365     » The CGL_• defines from cogl-defines.h have been removed. These
1366       should not have been used by any applications, but if they were
1367       being used then please replace them either with the Cogl enums or
1368       with the appropriate GL_• enum if you are using GL directly.
1369
1370     » Added a delete-event signal to the stage.
1371
1372     » Fix for using cogl_rectangle with different texture coordinates
1373       for multiple layers (bug #1937).
1374
1375     » Fix for using stencil and depth buffers in FBOs on Intel drivers
1376       in Mesa (bug #1873).
1377
1378     » Support for subtitles in ClutterMedia.
1379
1380     » ClutterGLX will now use an RGB visual by default. For
1381       applications (and toolkit integration libraries) that want to
1382       enable the ClutterStage:use-alpha property there is a new
1383       function: clutter_x11_set_use_argb_visual().
1384
1385     » Fix ClutterText to allow using Pango markup and attributes in
1386       the same actor (bug #1940).
1387
1388 Many thanks to:
1389
1390      Alejandro Piñeiro
1391      Damien Lespiau
1392      Emmanuele Bassi
1393      Gord Allot
1394      Halton Huo
1395      Robert Bragg
1396      Samuel Degrande
1397
1398 Clutter 1.1.4 (03/01/2010)
1399 ===============================================================================
1400
1401   • List of changes since Clutter 1.1.2
1402
1403     » Update the ClutterScript parser to be more resilient, and support
1404       constructor and ChildMeta properties. The parser also respects the
1405       order of the properties in the UI definitions when applying them,
1406       and will apply the properties of an Actor after building the scene
1407       graph.
1408
1409     » Simplified the implementation of LayoutManager sub-classes, and added
1410       support for animating a layout manager.
1411
1412     » Allow short-circuiting some layout operations by setting a specific
1413       flag on ClutterActor.
1414
1415     » Improve caching of the preferred size of a ClutterActor.
1416
1417     » Allow declaring "internal children" for a ClutterContainer
1418       implementation: the memory management of these actors will be deferred
1419       entirely to the Container.
1420
1421     » Let the ClutterStage honour the :opacity property and the alpha component
1422       of the stage color. This requires support in the Clutter backend used.
1423
1424     » Improve Windows and OSX backends.
1425
1426     » Simplify the feature detection code for OpenGL; this also reduced the
1427       required OpenGL version to 1.2.
1428
1429     » Improve the matrix stack handling code. The matrices can be debugged by
1430       using the COGL_DEBUG environment variable, assuming that Clutter was
1431       compiled with the right configure-time switch.
1432
1433     » Improve COGL API for draw buffers, and for offscreen buffer support.
1434
1435     » Add support for text direction to ClutterActor.
1436
1437     » Documentation, introspection and build fixes.
1438
1439 Many thanks to:
1440
1441   Robert Bragg
1442   Neil Roberts
1443   Damien Lespiau
1444   Joshua Lock
1445   Bastian Winkler
1446   Rob Bradford
1447   Samuel Degrande
1448   Christian Persch
1449   Colin Walters
1450   Johan Bilien
1451   Raymond Liu
1452   Tim Horton
1453
1454 Clutter 1.1.2 (23/10/2009)
1455 ===============================================================================
1456
1457   • List of changes since Clutter 1.0
1458
1459     » Add ClutterLayoutManager, an abstract proxy class for easily
1460       writing layout management policies; also add ClutterLayoutMeta,
1461       a class for storing layout properties.
1462
1463     » Add ClutterBox, a generic container actor that relies on a
1464       ClutterLayoutManager instance to manage the layout of its
1465       children.
1466
1467     » Add the following layout managers:
1468
1469       - ClutterFixedLayout - a layout manager implementing the
1470         policy used by ClutterGroup
1471
1472       - ClutterBinLayout - a layout manager for packing actors
1473         as layers inside the same area, with per-actor alignment
1474
1475       - ClutterFlowLayout - a layout manager arranging actors as
1476         a reflowing grid
1477
1478       - ClutterBoxLayout - a layout manager arranging actors as
1479         a single line
1480
1481     » Remove the requirement for the backend-specific implementation
1482       of ClutterStage to be a ClutterActor: a Stage implementation must
1483       only implement the ClutterStageWindow interface. This cleans up
1484       the backend code.
1485
1486     » COGL source tree clean up and rationalization; COGL now
1487       knows the platform, and not only the driver (GL or GLES) so
1488       we can migrate part of the low-level backend code from Clutter
1489       to COGL where it makes sense.
1490
1491     » Remove code duplication across whole COGL.
1492
1493     » The GLES 2.0 driver for COGL, and the EGLX backend for Clutter
1494       have been fixed and confirmed working.
1495
1496     » Add "dump-pick-buffer" to CLUTTER_DEBUG: this debug options
1497       dumps the contents of each pick() buffer into a PNG file, for
1498       debugging purposes.
1499
1500     » Allow interpolating intervals of ClutterUnits for animating
1501       unit-based properties.
1502
1503     » Increase strictness and correctness of the ClutterUnits
1504       grammar parser.
1505
1506     » Add GValue transformation functions for ClutterPath to and
1507       from a string.
1508
1509     » Fix word movement in ClutterText; implement GObject getter for
1510       :use-markup; emit notification for :position; decouple the
1511       :text property from the :use-markup property.
1512
1513     » Do not queue redraws or relayouts on actors currently being
1514       destroyed. 
1515
1516     » Support #rrggbb and #rgb notations for ClutterColor.
1517
1518     » Multiple bug fixes.
1519
1520     » Provide _NET_WM_PID on the X11 stage implementation.
1521
1522     » Documentation and Introspection annotation fixes.
1523
1524     » Add test units for the ClutterActor size requesition.
1525
1526     » Build fixes.
1527
1528     » Use AM_SILENT_RULES if Automake 1.11 is detected, and fall
1529       back to Shave on older Automake versions.
1530
1531 Many thanks to:
1532
1533   Robert Bragg
1534   Damien Lespiau
1535   Neil Roberts
1536   Thomas Wood
1537   Owen W. Taylor
1538   Øyvind Kolås
1539   Götz Waschk
1540   Zhou Jiangwei
1541   Colin Walters
1542   Jonas Bonn
1543   Joshua Lock
1544   Jussi Kukkonen
1545   Samuel Degrande
1546   Vladimir Nadvornik
1547   Xu Li
1548
1549 Clutter 1.0.0 (28/07/2009)
1550 ===============================================================================
1551
1552   • List of changes since 0.9.8
1553
1554     » Allow per-stage disabling of motion event throttling; this should allow
1555       platforms or applications that require all the motion events not for
1556       drawing purposes to get them exactly like Clutter gets them from the
1557       windowing system.
1558
1559     » Various documentation fixes.
1560
1561     » Add per-word key navigation inside ClutterText.
1562
1563     » Fix the RGB<->HLS conversion.
1564
1565     » Various fixes for the OSX backend.
1566
1567     » Various build-related fixes.
1568
1569 Many thanks to:
1570
1571   Geoff Gustafson
1572   Michael Mortensen
1573   Owen W. Taylor
1574
1575 Clutter 0.9.8 (17/07/2009)
1576 ===============================================================================
1577
1578   • List of changes since 0.9.6
1579
1580     » Add more introspection annotations for language bindings.
1581
1582     » Fix a bug in clutter_animation_set_alpha(), which also broke the
1583       clutter_actor_animate_with_alpha() function.
1584
1585     » Check if the stage requires a relayout before showing it; this fixes
1586       a bug in the X11-based backends, especially under compositing window
1587       managers, where a 640x480 window would flicker before the default
1588       stage was shown for the first time.
1589
1590     » Performance fixes for Cogl.
1591
1592     » Sliced textures were broken by the COGL journalling.
1593
1594     » Use the redraw cycle when asynchronously loading textures from
1595       files.
1596
1597     » Miscellaneous compilation fixes for the OS X and Windows backends.
1598
1599     » Allow querying from within the paint function of an Actor whether
1600       the actor is currently being directly painted or by a Clone actor.
1601
1602     » In the GLX backend, when using the non-implicit sync-to-vblank inside
1603       glXSwapBuffers(), call glFinish() to avoid potential tearing.
1604
1605 Many thanks to:
1606
1607   Colin Walters
1608   Evan Martin
1609   Marcos
1610   Owen W. Taylor
1611   Xu Li
1612
1613 Clutter 0.9.6 (01/07/2009)
1614 ===============================================================================
1615
1616   • List of changes since 0.9.4:
1617
1618     » Allow the manipulation of the actor's transformation matrix, so that is
1619       is possible to apply additional transformations in a way that is
1620       compatible with the transformations already applied by the scene graph.
1621
1622     » Fix a race in the X11 backend that happened between resizing the stage
1623       drawable and the call to glViewport().
1624
1625     » Merge the cogl-journal-batching branch; this branch implements batching
1626       the geometry of the elements of the scene graph before sending it to
1627       OpenGL, thus minimizing the number of state changes and improving the
1628       overall performance of Clutter-based applications.
1629
1630     » Add more debugging states for Clutter and COGL, which allow the developer
1631       to track the state of the journal; to check the VBO fallback paths; to
1632       disable picking for reliable profiling; to disable software-side matrix
1633       transformations in favour of the driver/GPU ones.
1634
1635     » Improve the ability to "break out" of COGL by using gl_begin/gl_end
1636       semantics; applications that drop into raw GL are, though, ignoring all
1637       the caching performed by COGL and might incur in performance issues.
1638
1639     » Fixed the :load-async and :load-data-async properties of Texture by
1640       removing the unneeded G_PARAM_CONSTRUCT flag.
1641
1642     » Added an initial migration guide that shows the porting process from
1643       older releases of Clutter to the 1.0 API; the first chapter deals with
1644       the migration from ClutterEffect to the new implicit animations API.
1645
1646     » Fixed MT-safety for the master clock.
1647
1648 Many thanks to:
1649
1650   Ole André Vadla Ravnås
1651   Tim Horton
1652
1653 Clutter 0.9.4 (19/06/2009)
1654 ===============================================================================
1655
1656   • List of changes since 0.9.2:
1657
1658     » Set the layout height in ClutterText, so that wrapping and ellipsization
1659       work correctly to fill all the allocated area.
1660
1661     » Remove all the units-based API, and migrate all the positional and
1662       dimensional accessors to use floating point values when dealing with
1663       pixels. All the properties dealing with pixels now that a floating
1664       point value as well.
1665
1666     » Add the ability to track wether an actor is going to be painted or not,
1667       using the "mapped" flag. This also allows Clutter to be more strict
1668       in the handling of the scenegraph, ensuring correctness and avoiding
1669       wasting resources on nodes that won't be painted.
1670
1671     » Add debugging facilities for COGL, similar to those of Clutter; through
1672       them is also possible to have an on screen debugging mode that shows the
1673       boundaries of each rectangle sent to the GPU.
1674
1675     » Rework "units" into real logical distance units that can be converted
1676       between millimeters, typographic points and ems into pixels.
1677
1678     » Simplify the Animation class to avoid redundancy and the possibility
1679       of it going out of sync with the Timeline and Alpha instances it uses.
1680
1681     » Move every operation into a single "master clock" source that advances
1682       the timelines, dispatches events and redraws the stages in a predictable
1683       sequence, thus avoiding unneeded redraws. The default is to follow the
1684       sync-to-vblank cycle, if it is supported by the drivers.
1685
1686     » Cache the glyphs geometry into a vertex buffer object to avoid
1687       resubmitting too much information to the GPU.
1688
1689     » Rework the behaviour of ClutterModel when a filter is applied.
1690
1691     » Allow submitting premultiplied texture data; this removes the need
1692       for unpremultiplying data in CairoTexture.
1693
1694     » Add a simple API for submitting blending and texture combining modes
1695       through a string description.
1696
1697     » Move Timelines to pure time-based objects.
1698
1699     » Lots of performance improvements.
1700
1701     » Removal of all the deprecated API.
1702
1703     » Removal of all the fixed point entry points.
1704
1705     » Lots of documentation fixes - the coverage is now 99% of the exported
1706       1600 symbols for Clutter and 80%+ of the 300 exported symbols for COGL.
1707
1708     » Generate the GObject Introspection data for both Clutter and COGL
1709       at build time.
1710
1711     » Build environment fixes.
1712
1713 Many thanks to:
1714
1715     Owen W. Taylor <otaylor@fishsoup.net>
1716     Thomas Wood <thomas.wood@intel.com>
1717     Havoc Pennington <hp@pobox.com>
1718     Bastian Winkler <buz@netbuz.org>
1719     Chris Lord <chris@linux.intel.com>
1720     Garry Bodsworth <gjb@camvine.com>
1721     Rob Bradford <rob@linux.intel.com>
1722     Johan Bilien <jobi@litl.com>
1723     Jonas Bonn <jonas@southpole.se>
1724     Raymond Liu <raymond.liu@intel.com>
1725     Damien Lespiau <damien.lespiau@gmail.com>
1726     Dan Winship <danw@gnome.org>
1727     Marc-André Lureau <marcandre.lureau@gmail.com>
1728     Robert Staudinger <robsta@gnome.org>
1729     Tommi Komulainen <tko@litl.com>
1730
1731 Clutter 0.9.2 (16/03/2009)
1732 ===============================================================================
1733
1734 Bastian Winkler (2):
1735       [media] Fix the interface cast macro
1736       Remove redundant declaration in clutter-text.h
1737
1738 Chris Lord (1):
1739       [actor] Force a relayout on set_parent()
1740
1741 Christian Persch (1):
1742       Bug 1429 - Redundant declaration in clutter-x11.h
1743
1744 Colin Walters (3):
1745       Bug 1491 - Fix hardcoded lib path in .pc files
1746       Typo in clutter-win32.pc.in introduced by commit 24ce19383
1747       [animation] Enhance the bind API
1748
1749 Damien Lespiau (6):
1750       [gitignore] update gitignore files for tests/
1751       [build] Beautify autotools' output
1752       [build] Add dolt
1753       [build] Fix interaction between shave, gtk-doc and libtool 1.x
1754       [build] Fix dist for the newly introduced m4 macro directory
1755       Update shave
1756
1757 Emmanuele Bassi (111):
1758       Post-release bump to 0.9.1
1759       [text] Merge the attributes with markup enabled
1760       [tests] Update the text-field interactive test
1761       Add Actor::create_pango_layout()
1762       [docs] Add clutter_text_set_markup()
1763       [clone] Allow cloning unparented actors
1764       [text] Use create_pango_layout()
1765       [text] Rename :alignment to :line-alignment
1766       [texture] Consolidate the quality to filter conversions
1767       [texture] Check if the material is valid
1768       [event] Extend KeyEvent for multi-input support
1769       [actor] Check out parameters before setting them
1770       [list-model] Make ClutterListModel subclassable
1771       Bug 1440 - Add clutter_get_current_event_time()
1772       [tests] Add TEST_CONFORM_SKIP() macro
1773       [tests] Add conformance tests for ClutterModel
1774       [ignore] Add the newly created conformance units
1775       [actor] Revert part of commit 402e022c
1776       [animation] Do not bind construct-only properties
1777       [x11] Add backend-specific get_current_event_time()
1778       Initialize a variable to avoid warnings
1779       [cogl] Add cogl_is_material to cogl-material.h
1780       [cogl] Provide GTypes for COGL types
1781       [texture] Use COGL_TYPE_HANDLE for the handle properties
1782       [docs] Clarify the set_cogl_texture() documentation
1783       Merge branch 'build-enhancements'
1784       [docs] Add a missing "return" annotation
1785       [build] Pass the -s switch to cmp
1786       Remove type functions for removed types
1787       [docs] Update the sections file
1788       [tests] Add TEST_CONFORM_TODO macro
1789       [build] Show pkg-config file being generated
1790       [build] Reference the headers with their full path
1791       [docs] Update build for COGL API reference
1792       [build] Update the EXTRA_DIST list
1793       [build] Fix the ChangeLog generation rule
1794       [build] Do not overwrite BUILT_SOURCES
1795       [behaviour] Do not notify empty behaviours
1796       [path] Do not accept NULL descriptions
1797       [timeline] Set the n_markers out paramater
1798       Do not use GL types in Clutter headers
1799       [docs] Require gtk-doc 1.11
1800       [docs] Use the --name-space option
1801       [docs] Add the 1.0 symbols index
1802       [docs] Rename cogl-docs from sgml to xml
1803       Add build machinery for gobject-introspection data
1804       [backend] Update the viewport when updating the GL context
1805       [build] Move all the compiler flags to AM_CFLAGS
1806       [ignore] Update with the introspection files
1807       Add runtime debug messages for COGL
1808       [actor] Remove usage of ClutterFixed
1809       Make disable text mipmapping a command line switch
1810       Make fuzzy picking a command line switch
1811       [docs] Document envvars and command line switches
1812       Remove stray fixed point macro usage
1813       Use a dynamic array for the actors when delivering events
1814       [media] Add sub-second resolution for the duration
1815       [build] Put the X11 pc dependencies in another variable
1816       [build] Do not shave typelib generation
1817       Intern the ClutterScriptable type name
1818       [backend] Constify font options
1819       [cogl] Add a PANGO debug flag for CoglPango use
1820       Clean up of the ClutterColor API
1821       [shader] Unify code paths
1822       Add pkg-config file for COGL
1823       [build] Various fixes for distcheck
1824       [docs] Clarify clutter_actor_animate() behaviour
1825       [docs] Note that grabs are evil
1826       [cogl-fixed] Add a double-to-fixed conversion macro
1827       Move BehaviourScale to CoglFixed
1828       Move ClutterBehaviourEllipse to CoglFixed
1829       Move ClutterBehaviourRotate to CoglFixed
1830       Move ClutterTimeline to CoglFixed
1831       [cogl-fixed] Implement the CoglFixed fundamental GType
1832       [tests] Test CoglFixed, not ClutterFixed
1833       [interval] Update fixed-point handling
1834       [stage] Coalesce fog and perspective API
1835       [texture] Fix ClutterFixed usage
1836       [text] Convert units to the right type
1837       [tests] Use floats, not ClutterFixed
1838       [units] Add more conversion functions
1839       [fixed] Remove ClutterFixed API
1840       [cogl] Fix hardcoded paths in the pc file
1841       [docs] Remove ClutterFixed from the documentation
1842       [docs] Update API reference
1843       [animation] Add vector variants for ::animate()
1844       [cogl] Initialize boolean flag in CoglContext
1845       [cogl] Initialize all members of CoglContext
1846       [color] Fixed HLS to RGB conversion
1847       [docs] Calling g_object_ref() will not dispose an object
1848       [docs] Document the commit message format
1849       [tests] Animate the color during easing
1850       [docs] Reword some of the coding practices
1851       [docs] Add a bindings coding practices
1852       Add more deprecation notices
1853       [deprecated] Add Effect deprecation
1854       Do not cause more size requisitions than necessary
1855       [cogl] Avoid shadowing math.h symbols
1856       [docs] Clarify Animation memory management
1857       [animation] Add an emitter for ::completed
1858       [animation] Add Animation getter
1859       [tests] Remove unused variables
1860       [docs] Add description of queue_redraw
1861       [docs] Update after Animation API changes
1862       [animation] Enhance consistency of the Animation API
1863       [docs] Bring down the undocumented symbols to 2%
1864       Fix release date of 0.9.0
1865       Update release notes
1866       [docs] Fix naming of the interval parameter
1867       [docs] Ignore the TimeoutInterval internal API
1868       Update release notes
1869
1870 Geoff Gustafson (1):
1871       [animation] Broken fixed:: properties
1872
1873 Gordon Williams (1):
1874       [group] Output the group name when debugging paint
1875
1876 Havoc Pennington (4):
1877       Virtualize GL matrix operations and use a client-side matrix when GL is indirect
1878       [actor] Add :clip-to-allocation property
1879       [actor] Add ::queue-redraw signal
1880       [cogl] Flush matrix before clip planes
1881
1882 Jonathan Matthew (1):
1883       Declare the EnumValues for PixelFormat static
1884
1885 Neil Roberts (36):
1886       [cogl-material] Always bind the new texture handle
1887       Fix building GLES 2 after the material branch merge
1888       [cogl-texture] Fix the count for the number of enabled arrays
1889       [cogl-gles2-wrapper] Remove the FIXME to adjust the fragment color
1890       [clutter-clone] Override the parent opacity to self not self->parent
1891       [clutter-texture] Release the temporary ref taken when setting a texture
1892       [clutter-texture] Unref the Cogl material on dispose
1893       [clutter-texture] Fix the no_slice property
1894       [cogl-texture] Fix offset to next quad when flushing the log
1895       [cogl-texture] Move the destruction of the material to _finalize
1896       [cogl-texture] Fix uninitialised priv var in texture_finalize
1897       Added a test for non-power-of-two sized textures
1898       Emit CLUTTER_LEAVE events when the pointer leaves the stage
1899       Call glActiveTexture and glClientActiveTexture through cogl_get_proc_address
1900       [win32] Track mouse leave messages
1901       [clutter-main] Fix the input device passed to set_motion_last_actor
1902       Override the opacity when painting a clone instead of combining
1903       Allow rotation angle properties to be negative
1904       [ClutterBehaviourRotate] Fix up some breakage from the cogl-float branch merge
1905       [tests/conform] Copy in redhand.png
1906       Replaced ClutterFixed constants in color_{darken,lighten} with float
1907       [cogl-gles2-wrapper] Convert texture unit settings to be a static sized array
1908       [cogl-gles2-wrapper] Actually call glActiveTexture
1909       Add an environment variable to disable mipmapped text
1910       [tests/tools] Don't install libdisable-npots.so
1911       [clutter-texture] Use a GThreadPool for loading async textures
1912       [cogl-pango-glyph-cache] Fix compiler warning on 64-bit
1913       Fix warning in clutter-backend-sdl
1914       [eglnative] Add -I flags for the clutter dir in the src and build dirs
1915       Set the mapped flag on the stage in the SDL and eglnative backends
1916       Fix out of tree builds
1917       Remove use of $(builddir)
1918       [README] Small typo fix
1919       Change cogl_path_rectangle and cogl_path_round_rectangle to take x1,y1,x2,y2
1920       [cogl-path] Minor fix to gtk-doc
1921       Count timeline frames using the FPS instead of an integer interval
1922
1923 Owen W. Taylor (7):
1924       Honor ACLOCAL_FLAGS in autogen.sh
1925       Add gobject-introspection annotations
1926       Fix x/y confusion for GL_TEXTURE_RECTANGLE_ARB
1927       Use COGL to establish GL state for ClutterGLXTexturePixmap
1928       Add (out) annotations for ClutterActor
1929       Allow NULL for clutter_text_set_text()
1930       Avoid drawing twice if relayout queues a draw
1931
1932 Raymond Liu (2):
1933       [text] Crash when multi-byte utf8 text exceeds max_length
1934       [text] Insertion of multi-byte characters broken
1935
1936 Robert Bragg (28):
1937       [Cogl] Renames cogl_fog_set to cogl_set_fog for consistency
1938       [cogl-material] Fixes some dirty flag checks
1939       [cogl-vertex-buffer] Some fixes for texturing and color arrays
1940       [docs] Various gtk-doc updates for Cogl
1941       [tests] Some improvements for test-pixmap
1942       [Cogl] cogl_clip_{set•,unset} renamed to cogl_clip_{push*,pop}
1943       [Cogl] Renames cogl_paint_init to cogl_clear and adds a cogl_disable_fog function
1944       [cogl-color.c] #include fix for the cogl_set_source_color prototype
1945       [Cogl] the cogl_get_•_matrix functions now work with CoglMatrix types
1946       [Cogl] Fixes automatic handling of the GL blend enable state.
1947       [cogl-material] Always glBindTexture when flushing material state
1948       [Cogl] Remove a debugging assert that was triggering on false positives
1949       [test-vertex-buffer-contiguous] Improves the texturing test
1950       [cogl-matrix] Adds padding to CoglMatrix
1951       [cogl-matrix] Documents that CoglMatrix members should be considered read only
1952       Removes need for casting (const float •) to (GLfloat *) in _cogl_set_clip_planes
1953       80 char fix
1954       Avoid casting CoglMatrix to a GLfloat • when calling glGetFloatv
1955       Explicitly make the modelview-matrix current in cogl_{rotate,transform,etc}
1956       Use Cogl enum when making modelview-matrix current in cogl_{rotate,transform,etc}
1957       Finish GLES{1,2} support for client side matrix stacks
1958       Maintain the Cogl assumption that the modelview matrix is normally current
1959       Merge branch 'cogl-client-matrix-stacks'
1960       [cogl-vertex-buffer] Add a flush of attribute changes in the •_draw() functions
1961       [cogl-vertex-buffer] Allow querying back the number of vertices a buffer represents
1962       [cogl-vertex-buffer] fix cogl_vertex_buffer_draw_elements prototype
1963       [tests] Adds an interactive cogl vertex buffer unit test
1964       [cogl] Don't endlessly print the same warning regarding layer fallbacks
1965
1966 Robert Staudinger (1):
1967       [build] Add cogl.h to the built sources list
1968
1969 Shane Bryan (1):
1970       Bug 1434 - _NET_WM_NAME not set before realize
1971
1972 Tomas Frydrych (3):
1973       Fixed handling of enter and leave events in clutter_x11_handle_event()
1974       Fix clutter_x11_texture_pixmap_get/set_property() following change of PROP_WINDOW type
1975       [x11] Only update cached last event time if we have a real timestamp.
1976
1977 Øyvind Kolås (11):
1978       Added a mutex for clutter asynchronous textures threads.
1979       Bail early in clutter_texture_paint if opacity == 0
1980       Add a warning for recursive emit_event
1981       Change the default size of thread pool from 3 to 1
1982       [tests] Added test-texture-async
1983       [clutter-texture] add option to not block on size for loaded images
1984       [clutter-texture] remove load-size-async property
1985       Merge commit 'origin/async-texture-thread-pool' into async-size
1986       [clutter-texture] updated documentation.
1987       [clutter-texture] fixed gtk-doc formatting, and init threads in test.
1988       Merge branch 'async-texture-thread-pool'
1989
1990 Clutter 0.9.0 (30/01/2009)
1991 ===============================================================================
1992
1993  • List of changes between 0.8.6 and 0.9.0
1994
1995    » ClutterText is a new actor allowing text display, text editing
1996      both in multi-line and single-line modes, and text selection using
1997      the pointer devices and the keyboard. ClutterText supercedes both
1998      ClutterLabel and ClutterEntry.
1999    » ClutterClone is a new actor that allows cloning of other actors,
2000      both simple and composite. ClutterClone supercedes ClutterCloneTexture.
2001    » ClutterBindingPool is a new API that allows to easily add key bindings
2002      to an actor.
2003    » ClutterAnimation is a new API for implicit animations, similar to
2004      the tweening API used in toolkits like jQuery, Tween and Flash. This
2005      new API supercedes the ClutterEffect API.
2006    » ClutterAlpha uses "animation modes" instead of raw function
2007      pointers; it is still possible to pass alpha functions. The alpha
2008      functions provided by Clutter have been removed from the public
2009      API. It is possible to register global alpha functions and use
2010      them though a logical id.
2011    » The interval of the ClutterAlpha:alpha property has been changed
2012      to a floating point value in the [ -1.0, 2.0 ] range; this allowed
2013      the addition of "overshooting" easing modes.
2014    » COGL now supports backface culling.
2015    » The COGL-based Pango renderer is public API and it is accessible
2016      to developers. It is also possible to access the PangoContext used
2017      by Clutter in order to create PangoLayouts to render text.
2018    » The ClutterFixed API has been moved to COGL.
2019    » COGL does not depend on Clutter data types anymore.
2020    » The ClutterMedia interface has been overhauled: implementations
2021      now must only override the interface properties. The ranges of
2022      some properties have been changed to normalized values.
2023    » COGL now exposes only floating point entry points, and reserves
2024      the eventual conversion to fixed point only when needed. The
2025      fixed point type and macros are publicly available for developers
2026      concerned about floating point operations.
2027    » COGL has a new Vertex Attribues API that allows submitting an
2028      extensible number of vertex attributes to OpenGL in a way that
2029      does not require format conversions and allows fast re-use.
2030    » COGL has a new Material API that decouples paths from fills; it
2031      is possible to create an arbitrary path and fill it with a COGL
2032      texture. The Material API also allows setting multiple texture
2033      layers and defining the blend modes and colors.
2034    » ClutterTexture has the ability to use a worker thread to asynchronously
2035      load an image from a file, as long as the GLib threading support has
2036      been enabled prior to calling clutter_init().
2037    » Clutter now supports localization of the help output, and it
2038      also supports globally setting the text direction for non left to
2039      right locales.
2040    » ClutterCairoTexture is a new actor that allows using Cairo
2041      to draw on a ClutterTexture; since Cairo does not have an OpenGL
2042      backend, the drawing is not hardware accelerated.
2043    » Clutter has a unit testing suite, based on the GLib unit test
2044      framework, which can be used to track regressions.
2045    » A ClutterPath object has been added, and it is used by the
2046      BehaviourPath. The Path object allows defining paths using a set
2047      of coordinates and operations. A Path can be "painted" either using
2048      COGL primitives or using Cairo primitives, allowing an easier way
2049      to paint non-rectangular shaped actors.
2050    » ClutterInterval is a simple object, used by ClutterAnimation, that
2051      describes an interval between two values, and interpolates between
2052      the initial and final values of the interval.
2053
2054  • List of bugs fixed since 0.8.6
2055
2056    » #835 - Optimize clutter_actor_real_pick()
2057    » #851 - setting anchor point causes picking problem
2058    » #883 - Outstanding COGL merge issues
2059    » #1003 - Add clutter_actor_take_key_focus
2060    » #1014 - Clutter Animation API Improvements.
2061    » #1049 - Clutter doesn't support most GLSL uniforms
2062    » #1051 - WebKit/Clutter product/component?
2063    » #1058 - Build clutter-box2d with Clutter 0.8
2064    » #1066 - Clipping regression in 0.8
2065    » #1086 - virtualize stage_queue_redraw
2066    » #1105 - low level access to PangoClutter
2067    » #1106 - ClutterText instead of ClutterLabel and ClutterEntry
2068    » #1108 - Enter/Leave events logics wrt. skipped motion events
2069    » #1109 - clutter-0.8.0 fails to compile
2070    » #1123 - Crash when FBO actor is used and the stage is MINIMIZED
2071    » #1144 - Provide an option to load images asynchronously in ClutterTexture
2072    » #1162 - Add unit testing for Clutter
2073    » #1164 - Mesh API
2074    » #1172 - Disjoint paths and clip to path
2075    » #1189 - Backface culling
2076    » #1209 - Move fixed point API in COGL
2077    » #1210 - Add CoglColor API
2078    » #1211 - Drop ClutterFeatureFlags usage from COGL
2079    » #1212 - Allow only a single include file for Clutter
2080    » #1215 - Move the Pango renderer to the public API
2081    » #1219 - Clean up cogl.h
2082    » #1231 - Build fails in gles flavour in revision 3442
2083    » #1233 - CLUTTER_ALPHA_SINE_INC is broken in trunk
2084    » #1251 - Merge the Cairo texture actor in core
2085    » #1252 - Merge ClutterBehaviourPath and ClutterBehaviourBspline
2086    » #1261 - [patch] Minimize differences between gl/cogl-texture.c and
2087      gles/cogl-texture.c
2088    » #1269 - mingw32 building failed at clutter-media.c
2089    » #1270 - Update to mingw-cross-compile.sh
2090    » #1271 - mingw compiling failed:  undefined reference to
2091      `_glDrawRangeElements@24'
2092    » #1284 - Return something reasonable from clutter_x11_handle_event()
2093    » #1300 - clutter_score_remove and clutter_score_remove_all  are different
2094      in object remove
2095    » #1310 - font rendering problem
2096    » #1313 - Fix computation of camera distance
2097    » #1314 - clutter_sinx() is more inaccurate than it needs to be
2098    » #1321 - Get Matrix in float
2099    » #1323 - ClutterBehaviorDepth conflicts with other behaviors
2100    » #1325 - ClutterPath to cairo_path_t conversion functions
2101    » #1330 - We should not queue redraw for non-visible actors
2102    » #1334 - Default value for ClutterLabel::text should be "" instead of NULL
2103    » #1344 - clutter_actor_transform_stage_point gives invalid coordinates
2104      for big actors
2105    » #1352 - Weird cogl-pango.h includes in clutter-[entry|label].c
2106    » #1354 - Floating point exception when set fps>1000 and start timeline
2107    » #1361 - Unused ClutterStage::get_resolution() methods
2108    » #1365 - ClutterEntry doesn't get the cursor when it should
2109    » #1366 - disable-npots fails to build on mac
2110    » #1380 - Return booleans from CLUTTER_ACTOR_IS_• macros
2111    » #1386 - Wrong clipping dimensions for larger actors
2112    » #1387 - Clarify new-frame signal emission with advance()
2113    » #1388 - Clarify signal emission for advance_to_marker()
2114    » #1395 - behaviour_apply and behaviour_get_nth_actor are opposite on
2115      actors sequence
2116    » #1397 - clutter command line is not localized.
2117    » #1402 - Change default tile-waste from 64 to 63
2118    » #1403 - ClutterMedia::get_uri() should return allocated string
2119    » #1404 - ClutterMedia issues
2120    » #1405 - Fix properties that have X11 types to be 'long'
2121    » #1409 - Use G_SIGNAL_RUN_LAST with ::queue-redraw signal
2122    » #1410 - [patch] Implements a generic ClutterActorClone class without fbos
2123    » #1414 - avoid relayout of ClutterTexture if not syncing size
2124    » #1415 - short-circuit setting same clip again
2125
2126 Clutter 0.8.2 (25/09/2008)
2127 ===============================================================================
2128
2129  • List of changes between 0.8.0 and 0.8.2
2130
2131    » Add constructor-only properties for the :container and :actor
2132      properties of ClutterChildMeta
2133    » Resync the Clutter keysyms with X.org ones.
2134    » Documentation fixes and improvements
2135    » Allow defining ClutterColor as an object or an array inside
2136      ClutterScript UI definitions
2137    » Added the missing :perspective property to ClutterStage
2138    » Fixed the upper and lower boundaries for ClutterUnit and
2139      ClutterFixed properties
2140    » Fix a bug that prevented disabling sorting on ClutterModel
2141    » Fix a bug in clutter_timeline_list_markers()
2142    » Queue a redraw when the clip is changed
2143    » Optimize calls to push and pop the matrix when painting
2144    » Add a variable to the pkgconfig file for extracting the
2145      COGL backend, for configure-time checks
2146    » Fix a typo in cogl_path_rel_curve_to()
2147    » Fix showing the cursor after it being hidden once
2148    » Add a function for obtaining Clutter's option group without
2149      initializing Clutter
2150
2151  • List of bugs fixed since 0.8.0
2152
2153    » #856 - Teardown sequence is borked
2154    » #945 - Clipping+fbo cloning bugs
2155    » #1010 - ClutterLabel does not update the layout (again)
2156    » #1020 - TFP resyncing on MapNotify/ConfigureNotify [Andy Wingo]
2157    » #1033 - Manually parsing command line options prevents
2158      initializing clutter
2159    » #1034 - Picking doesn't work on Eee PC
2160    » #1038 - Clutter 0.8 won't build due to redefined functions
2161    » #1044 - cogl_get_viewport error
2162    » #1047 - API documentation from release tarball is not
2163      installed by "make install" [Mirco Müller]
2164    » #1048 - SIGFPE in cogl_texture_set_region() with
2165      nvidia [Gwenole Beauchesne]
2166    » #1062 - clutter_actor_query_coords() replacement in
2167      0.8 [Gwenole Beauchesne]
2168    » #1069 - Warnings with ClutterScore
2169    » #1071 - clutter_timeline_get_duration doesn't always work
2170    » #1075 - Difficult to bind clutter_stage_new
2171    » #1080 - clutter_stage_read_pixels has upside-down y coordinate
2172    » #1082 - Texture bitmap is destroyed in wrong way
2173    » #1085 - Cursor is in wrong position on ClutterEntry if set
2174      x-align property
2175    » #1090 - Label somtimes returns natural_width < min_width [Johan Bilien]
2176    » #1091 - WM_MOUSEWHEEL (scroll-event) not handled
2177      correctly [Roman Yazmin]
2178    » #1099 - No ClutterScript API to get a list of IDs in a given
2179      file [Noah Gibbs]
2180    » #1100 - WM_SIZE not handled correctly, user_resize and
2181      window_style correction
2182    » #1103 - Two typos in clutter documentation
2183    » #1121 - Setting anchor point doesn't work if set too early
2184    » #1124 - Clutter causes an additional size request in each
2185      allocation [Johan Bilien]
2186    » #1125 - Save an extra pango_layout_get_size in many
2187      cases [Johan Bilien]
2188    » #1130 - CLUTTER_MOTION is not emitted when time goes
2189      backwards. [Pierce Liu]
2190    » #1137 - Setting the anchor point does not trigger a re-paint
2191    » #1145 - Flicker on resize the window
2192    » #1154 - clutter_timeout_pool_new() documentation doesn't say
2193      how to free [Murray Cumming]
2194
2195 Clutter 0.8.0 (10/07/2008)
2196 ===============================================================================
2197
2198  • List of changes between 0.7.6 and 0.8.0
2199
2200    » Assume that non-power-of-two sized textures are always supported
2201      if texture-from-pixmap support is present.
2202
2203    » Increase documentation coverage.
2204
2205    » Disable the XINPUT support by default.
2206
2207    » Improve the behaviour of clutter_actor_get_transformed_size().
2208
2209    » Fix a copy-and-paste bug which broke the vertex shaders.
2210
2211  • List of bugs fixed since 0.7.6
2212
2213    » #983 - cogl-bitmap-fallback.c compiler error/warning due to cast issue
2214    » #985 - MSC math.h / M_PI issue
2215    » #998 - clutter always captures X input events
2216    » #1000 - clutter-x11 should define gtypes for its enumerations
2217    » #1004 - Fix "edge-detect" shader
2218    » #1007 - Fix TFP fallback mechanism
2219    » #1008 - tfp still a bit borked
2220    » #1010 - ClutterLabel does not update the layout
2221    » #1011 - Fix TFP fallback mechanism (take 2)
2222    » #1012 - clutter_stage_read_pixels() has incorrect alpha data
2223              on some (most?) cards"
2224    » #1013 - Per device grabs are not obeyed in pointer device propagation.
2225    » #1015 - Cloning unparented actors with FBOs doesn't work with new
2226              layout code
2227    » #1016 - Changing window-redirect-automatic property after creating
2228              ClutterX11TexturePixmap doesn't work
2229    » #1019 - clutter-frame-source.h not included by clutter.h
2230    » #1022 - extern inline functions in clutter-fixed.h
2231    » #1033 - Manually parsing command line options prevents initializing
2232              Clutter
2233
2234 Clutter 0.7.6 (27/06/2008)
2235 ===============================================================================
2236
2237  • List of changes between 0.7.4 and 0.7.6
2238
2239    » Removed the ClutterBackend::get_display_size() and wrappers.
2240
2241    » Verify that the vertex shaders are successfully compiled when binding
2242      them.
2243
2244    » Increase safety of the ClutterGLXTexturePixmap
2245
2246  • List of bugs fixed since 0.7.4
2247
2248    » #993 - Underline colors are sometimes wrong
2249
2250 Clutter 0.7.4 (25/06/2008), "Killer Koi"
2251 ===============================================================================
2252
2253  • List of changes between 0.7.2 and 0.7.4
2254
2255    » Fix the ClutterEntry actor after the clip API changes in COGL.
2256
2257    » Update the shaders generated for GLES 2.0.
2258
2259    » Add the ability to add search paths and look up files from
2260      ClutterScript. This allows defining directories to store the
2261      images to be loaded by a ClutterTexture.
2262
2263    » Fix the GLES 1.1 support.
2264
2265    » Warn if no usable pointer device are available on X11 backends.
2266
2267    » Improve the request for the best pixel format on win32.
2268
2269    » Fix a regression when sizing the ClutterStage on backends that
2270      only support fixed size stages; now setting any size will result
2271      in Clutter ignoring the request, like it happened in Clutter 0.6.
2272
2273    » Add a method to ClutterBackend to retrieve the display size.
2274
2275    » Fix clutter_sinx() for angles > CFX_2PI - CFX_ONE.
2276
2277  • List of bugs fixed
2278
2279    » #833 - ClutterEntry should clip glyphs rather than itself
2280    » #858 - Support for multiple devices (using XINPUT)
2281    » #879 - sampler2DRect used by test-shader.c doen't work with non-rect textures
2282    » #979 - Wrong call convension for SwapIntervalProc in win32 backend
2283    » #987 - clutter-event.c c99 variable declaration
2284    » #988 - cursor position wrong with multibyte invisible char
2285    » #989 - Add a search path for clutter script assets
2286
2287 Clutter 0.7.2 (23/06/2008), "Kedoke"
2288 ===============================================================================
2289
2290  • List of changes between 0.7.0 and 0.7.2
2291
2292    » ClutterTexture has a new :keep-aspect-ratio property; when it is set
2293      to TRUE the texture will return a preferred width maintaining the
2294      aspect ratio with the given height and a preferred height maintaining
2295      the aspect ratio with the given width. This allows to set the width or
2296      the height and have the texture automatically request the height or the
2297      width respectively while maintaining the aspect ratio of the original
2298      image.
2299
2300    » Added XINPUT support on the X11 backends; this provides an initial
2301      support for multiple input devices. The API is X11-specific, and
2302      provides support for querying at run-time support for XINPUT, for
2303      getting a list of input devices and for getting the type of each
2304      input device. 
2305  
2306    » The 'fruity' backend also features multiple device support.
2307
2308  • List of bugs fixed
2309
2310    » #816 - clutter_actor_request_coords() should take a const box.
2311    » #836 - Optimize clutter_label_query_coords()
2312    » #905 - Paint cursor directly
2313    » #918 - Group doesn't clip if it's children are clipped
2314    » #953 - Actors are not hidden before unrealized or disposed
2315    » #960 - PangoContext creation code should not be duplicated
2316    » #970 - clutter_actor_get_paint_area confusion
2317    » #971 - Minor ClutterActor cleanups
2318    » #972 - Better parenting
2319    » #973 - unreffing ClutterScore may segfault
2320    » #981 - clutter_stage_read_pixels temprow fix
2321    » #982 - __COGL_GET_CONTEXT MS compiler issue
2322    » #984 - pango_clutter_render_layout() declared void
2323
2324 Clutter 0.7.0 (13/06/2008), "Booska"
2325 ===============================================================================
2326
2327  • List of changes between 0.6 and 0.7.0
2328
2329    » COGL, the underlying GL abstraction layer in Clutter, has been
2330      completely rewritten from the ground up. Its no longer a conceptual
2331      hack but a documented, fully featured library pretty much in its
2332      own right. COGL abstracts over Open GL, Open GL ES 1.1 and now
2333      OpenGL ES 2.0, providing a smart uniform API over these libraries
2334      with various utility features such as texture tiling abstractions,
2335      paths and primitive rendering, FBO, shaders, etc.
2336
2337    » Clutter now provides an experimental backend for the Apple(tm)
2338      iPhone and iPod Touch families of products.
2339
2340    » The Windows platform is now natively supported instead of
2341      relying on the SDL libraries. The win32 backend is still
2342      experimental.
2343
2344    » The X11 based backends now feature support for Actors that wrap
2345      external X drawables (i.e the texture-from-pixmap extension and
2346      fallbacks)
2347
2348    » Clutter now seamlessly supports multiple stages on the backends
2349      that allow this feature.
2350
2351    » The custom Pango renderer has been completely rewritten, now using
2352      the more modern and maintained PangoCairo (instead of FT2), and avoids
2353      nasty subclassing hacks, supports smooth fast scaling of text, has
2354      many edge case issues fixed and it still is very efficient (using
2355      a texture glyph cache). It is even a little bit faster.
2356
2357    » Better texture support, timeline improvements, ClutterLabel and
2358      ClutterEntry improvements, and container child properties are among
2359      the new features - too many to fit in the NEWS file.
2360
2361  • List of bug fixes
2362
2363    » #358 - "window resizing doesn't show scaled stage"
2364    » #425 - "COGL enhancements"
2365    » #439 - "timing related pong lockup due to timeline_rewind somtimes
2366             being ignored by timeline_timeout_func"
2367    » #450 - "ClutterScore API enhancements"
2368    » #641 - "add markers to timelines"
2369    » #666 - "Large font size leads to missing ""W"" and wrong ""J"" character"
2370    » #713 - "texture from pixmap"
2371    » #791 - "default actors to visible"
2372    » #800 - "CLUTTER_ALPHA_EXP_INC overflows"
2373    » #804 - "clutter_actor_get_opacity returns composited alpha"
2374    » #810 - "100 % CPU load with clutter_main()"
2375    » #815 - "Split up request
2376    » #816 - "clutter_actor_request_coords() should take a const box."
2377    » #822 - "Fix clutter_actor_lower()"
2378    » #823 - "Clean-up GLism's in clutter-core (below cogl)"
2379    » #824 - "ClutterEntry should handle its own key events"
2380    » #825 - "Removes GLisms from clutter-main.c"
2381    » #831 - "configure.ac missing osx flavour help"
2382    » #834 - "add ability to set anchor in json"
2383    » #836 - "Optimize clutter_label_query_coords()"
2384    » #839 - "Crash if put cursor over topmost pixel"
2385    » #840 - "Implement prepare-paint and finish-paint signals."
2386    » #848 - "Events dispatch doesn't work in GLX Xephyr"
2387    » #850 - "Impossible to set ClutterRectangle border opacity to a value
2388             different from the surface opacity"
2389    » #857 - "cogl_color doesn't work in PowerVR PC Viewer"
2390    » #860 - "ClutterAlpha leaks"
2391    » #864 - "Allow instantiating and subclassing of ClutterStage"
2392    » #871 - "Two problems with closing stages"
2393    » #873 - "clutter_x11/glx_texture_pixmap issues"
2394    » #874 - "Clipping on GL ES"
2395    » #875 - "Clutter Label Issues"
2396    » #881 - "Timelines require precise system timing"
2397    » #882 - "Allow child properties for containers implementing the
2398             ClutterContainer interface"
2399    » #884 - "Add clutter_alpha_set_closure"
2400    » #889 - "Error when building clutter-ivan with eglx"
2401    » #891 - "assertion failed when test-behave exits"
2402    » #892 - "Incorrect results using  rotation-[center|angle] properties"
2403    » #894 - "Artifacts with the pango renderer"
2404    » #900 - "clutter_actor_lower() and friends do not queue redraw"
2405    » #906 - "Implement timing of the events"
2406    » #908 - "Support transform from G_TYPE_INT to ClutterUnit"
2407    » #909 - "OSX: missing NULL pointer handling"
2408    » #910 - "OSX: missing memory pool"
2409    » #911 - "OSX: add multistage support"
2410    » #912 - "Invalid use of int• as parameter for glGetIntegerv"
2411    » #913 - "cogl fails to build on OSX"
2412    » #914 - "ClutterEntry is confused about characters vs. bytes"
2413    » #915 - "clutter_entry_set_max_length(-1) misbehaves"
2414    » #916 - "ClutterKeyEvent:unicode_value is ignored"
2415    » #919 - "Replacement pango renderer"
2416    » #927 - "Created ports for clutter
2417    » #928 - "Reparenting a child that itself is a container doesn't work"
2418    » #930 - "add support for quartz imagebackend"
2419    » #931 - "suspicious size allocation for pixel data"
2420    » #933 - ""X Error of failed request" when attempting to call
2421             clutter_actor_request_coords()"
2422    » #934 - "Update clutter-tutorial to build with clutter from svn trunk."
2423    » #947 - "Destroying a stage is messy"
2424    » #948 - "Remove texture rectangle support"
2425    » #950 - "AltGr not handled"
2426    » #951 - "Fix clutter_entry_init() in trunk"
2427    » #952 - "Fix test-textures in trunk"
2428    » #953 - "Actors are not hidden before unrealized or disposed"
2429    » #955 - "ClutterLabel is missing fallback resolution handling"
2430    » #959 - "Multiple minor improvements"
2431    » #960 - "PangoContext creation code should not be duplicated"
2432    » #961 - "Fails to build on OSX (query/request_coords is gone)"
2433    » #964 - """unrealized"" signal of ClutterActor wrongly named"
2434
2435 Clutter 0.6.0 (18/02/2008)
2436 ==========================
2437
2438  • List of changes between 0.5.6 and 0.6.0
2439
2440    » New documentation sections inside the API reference, describing
2441      the animation framework.
2442
2443    » New API in ClutterActor for computing the actor's vertices in
2444      the plane of a given ancestor and accessors to query whether an
2445      actor is scaled or rotated
2446
2447  • List of bug fixed
2448
2449    » #613 - Extend point transformation API
2450    » #779 - Rounding error in ClutterBehaviourScale [Havoc Pennington]
2451    » #787 - tiled textures are broken
2452    » #796 - segmentation fault when setting label text
2453
2454 Clutter 0.5.6 (11/02/2008)
2455 ==========================
2456
2457  • List of changes between 0.5.4 and 0.5.6
2458
2459    » Reverted a last minute change in the depth sorting function of
2460      ClutterGroup.
2461
2462    » Added the clutter_actor_move_anchor_point() family of functions,
2463      which will set the anchor point at the given coordinates while
2464      adjusting the actor postion so that the relative position of the
2465      actor toward its parent remains the same.
2466
2467    » Provide a fallback for finding the Clutter alpha functions inside
2468      a UI definition for ClutterScript in case g_module_open() fails.
2469
2470    » Add initial Frame Buffer Objects support in ClutterTexture; using
2471      FBOs, where supported by the hardware and drivers, it's possible to
2472      create a ClutterTexture from any actor.
2473
2474  • List of bugs fixed
2475
2476    » #386 - Stage is white unless a timeline is present
2477    » #439 - timing related pong lockup due to timeline rewind...
2478    » #440 - 1 pixel line flickering
2479    » #442 - Shader support
2480    » #451 - Improve font rendering quality (Pango)
2481    » #452 - Textures are shown with distortion on Solaris/SPARC
2482    » #526 - OSX backend
2483    » #533 - Clutter stage is not shown under some conditions
2484    » #540 - ClutterStage isn't always respecting requests to change size
2485    » #549 - Backend offscreen API is broken
2486    » #613 - Extend point transformation API
2487    » #635 - Fix buffer overflow in clutter_texture_get_pixbuf() [Gwenole
2488      Beauchesne]
2489    » #643 - Superfluous "filter-quality" setting in texture_upload_data()?
2490      [Gwenole Beauchesne]
2491    » #689 - Rotating actor through layers does not handle opacity
2492      correctly [Josh Stewart]
2493    » #710 - Make "box-blur" test shader work in some way [Gwenole Beauchesne]
2494    » #719 - X11 backend does not check window field in events [Havoc
2495      Pennington]
2496    » #724 - ClutterLabel reports wrong height when lines > 1
2497    » #749 - "reactive" property does not change
2498    » #751 - missing XSync in clutter-event-x11.c:xembed_set_info() [Havoc
2499      Pennington]
2500    » #756 - clutter_actor_get_abs_size returns bogus values
2501    » #769 - OSX backend fails to build
2502    » #770 - OSX: passing incompatible pointer type
2503
2504 Clutter 0.5.4 (25/01/2008)
2505 ==========================
2506
2507  • List of changes between 0.5.2 and 0.5.4
2508
2509    » A clutter-x11-<major>.<minor> pkg-config file is installed along
2510      with the clutter-<major>.<minor> and clutter-<backend>-<major>.<minor>
2511      ones, for libraries and applications depending on the X11-based
2512      backends (GLX and EGLX).
2513
2514    » Textures are correctly unrealized before changing and freeing the
2515      main GL context.
2516
2517    » It is now possible to block the automatic call to clutter_main_quit()
2518      when closing the stage window using the frame controls by connecting
2519      an handler for the ::event signal on the Clutter stage and checking
2520      for the CLUTTER_DELETE event type and returning TRUE. This allows
2521      the usage of other main loops with GLib reactors (like Python's twisted)
2522      with Clutter without triggering assertions by closing the stage window.
2523
2524  • List of bugs fixed
2525
2526    » #564 - Add more precise clutter_qdivx() [Gwenole Beauchesne]
2527    » #614 - ClutterActor API inconsistencies
2528    » #640 - ClutterTexture unrealized with no GL context
2529    » #654 - Under heavy load clutter sometimes drops the last frame of
2530      a timeline [Johan Bilien]
2531    » #672 - Event handling in osx backend is broken [Tommi Komulainen]
2532    » #684 - Improve test-scale by also using anchor point [Jaap A. Haitsma]
2533    » #695 - clutter-shader: Invalid format string for
2534      gssize [Tommi Komulainen]
2535    » #696 - cogl_get_proc_address requires GLX [Tommi Komulainen]
2536    » #709 - clutter_effect_scale inconsistent with clutter_actor_set_scale
2537    » #714 - clutter_event_copy for enter/leave event generates
2538      extra unref [Neil Roberts]
2539    » #715 - Type errors in test-shader
2540    » #720 - BehaviourScale not working in python after recent
2541      API change [Josh Stewart]
2542
2543 Clutter 0.5.2 (14/01/2008)
2544 ==========================
2545
2546  • List of changes between 0.5.0 and 0.5.2
2547
2548    » ClutterModelDefault has been renamed to ClutterListModel
2549
2550    » ClutterModel now has vector-based variants for append, prepend and
2551      insert methods; these methods are useful for bindings
2552
2553    » Add units-based variant for clutter_actor_move_by()
2554
2555  • List of bugs fixed
2556
2557    » #694 - Handle GLhandleARB on OS X [Tommi Komulainen]
2558    » #700 - Fix for clutter_effect_rotate() [Neil Roberts]
2559
2560 Clutter 0.5.0 (02/01/2008)
2561 ==========================
2562
2563  • List of changes between 0.4.2 and 0.5.0
2564
2565    » New event handling system: every actor with the CLUTTER_ACTOR_REACTIVE
2566      flag set will receive events from the underlying backend; the event
2567      propagation chain will be walked in two directions (from the actor to
2568      the top-level container and back) with the ability to block it in
2569      both phases.
2570
2571    » ClutterShader, an abstraction over the programmable OpenGL pipeline.
2572
2573    » ClutterScore, an object for controlling timelines; using a score
2574      instance is possible to start multiple timelines at once, or start
2575      a timeline after another has emitted the ::complete signal.
2576
2577    » ClutterScript, an object for parsing a scene from an external file or
2578      a buffer; the scene is described using JSON (JavaScript Object Notation):
2579      every object is defined using its class and properties, and container
2580      objects can have their children defined as well. It is also possible
2581      do describe top-level objects such as timelines and behaviours, and to
2582      automatically connect signal handlers to signal names.
2583
2584    » ClutterTimelines duration can now be set in milliseconds using the
2585      :duration property; the default framerate will be used to compute the
2586      actual duration in frames. The default framerate will be set by the
2587      backend, and can be overridden by the application.
2588
2589    » ClutterTimelines direction can now be set using the :direction
2590      property; a timeline can be set to proceed forward or backward,
2591      and the direction can also be change while the timeline is still
2592      running.
2593
2594    » New, experimental OSX backend.
2595
2596    » Build environment for MS VisualStudio 2005.
2597
2598    » ClutterModel, a generic list-based model object that can be used to
2599      implement actors following the Model-Viewer-Controller design pattern.
2600      Clutter provides a default implementation of ClutterModel, called
2601      ClutterModelDefault and using the GSequence data structure from GLib
2602      to optimize insertion and look up.
2603
2604    » Add the ability to grab pointer and keyboard events: if an actor
2605      is set to have a grab it'll be the only one receiving events until
2606      it releases the grab.
2607
2608    » Add the ability for an actor to receive the key focus; an actor
2609      with key focus will always receive the key events, even if it did
2610      not acquire the keyboard grab.
2611
2612    » It is now possible to set the GL "fog" (also known as "depth cueing")
2613      effect on the ClutterStage; if the fog is enabled, actors farther
2614      away from the view point will fade into the stage background color.
2615
2616    » Each actor now has an "anchor point", a point defined in the actor's
2617      coordinate space that will be used as the origin when scaling and
2618      rotation transformations.
2619
2620    » Every pixel-based API has been doubled with a corresponding
2621      ClutterUnits-based function (postfixed with a '-u'), for instance:
2622
2623        clutter_actor_set_position() - clutter_actor_set_positionu()
2624        clutter_actor_set_size()     - clutter_actor_set_sizeu()
2625        clutter_actor_set_depth()    - clutter_actor_set_depthu()
2626
2627      This allows sub-pixel precision and device independence.
2628
2629    » The ClutterLabel actor now tries very hard to provide a sane
2630      default size, if no bounding box has been requested; this fixes
2631      the :alignment property and allows the addition of the :justify
2632      property.
2633
2634    » The SDL backend can now be compiled under win32 with MingW; this
2635      backend is still marked as experimental.
2636
2637    » The OSX backend allows the compilation of Clutter under OS X; this
2638      backend is experimental.
2639
2640  • List of bugs fixed
2641
2642    » #423 - All actors should emit events rather than just the stage
2643    » #424 - Interface definition files
2644    » #443 - ClutterModel implementation
2645    » #480 - Uninitialized variable in
2646      path_alpha_to_position() [Gwenole Beauchesne]
2647    » #511 - clutter_stage_get_actor_at_pos problem
2648    » #512 - clutter window moves when stage actor is scaled
2649    » #518 - XEMBED not supported in eglx backend
2650    » #519 - Should have an Atom cache initialized on start up
2651    » #520 - Delete after multibyte unicode chars in
2652      ClutterEntry [Tommi Komulainen]
2653    » #522 - Array out of bounds indexing [Tommi Komulainen]
2654    » #523 - cogl portability fixes [Tommi Komulainen]
2655    » #524 - missing config.h includes [Tommi Komulainen]
2656    » #525 - Redundant include in cogl/gl [Tommi Komulainen]
2657    » #531 - Extraneous "new-frame" signal generated
2658    » #532 - clutter_actor_set_scale_with_gravityx()
2659      precision [Gwenole Beauchesne]
2660    » #544 - clutter_color_to_hlsx is broken [Neil Roberts]
2661    » #546 - ClutterStageState doesn't make sense
2662    » #550 - Wanted: Set Actor's position based on center or other
2663      edges/corners of quadrangle
2664    » #557 - ClutterScript should support complex properties for third
2665      party classes
2666    » #558 - Unmerge UI definitions
2667    » #566 - ClutterEntry does not scroll the text to the
2668      right [Gwenole Beauchesne]
2669    » #577 - Inconsistent naming of behaviour properties
2670    » #580 - Fix call to cogl_enable() [Gwenole Beauchesne]
2671    » #582 - api naming inconsistence between
2672             clutter_behaviour_path_append_knots and
2673             clutter_behaviour_bspline_append
2674    » #584 - Typo on clutter_effect_rotate_x documentation page
2675    » #592 - Fix build on trunk [Gwenole Beauchesne]
2676    » #596 - ClutterTexture tileing logic is a little borked
2677    » #597 - ClutterGroups not pickable
2678    » #600 - fix ClutterLabel layout computing when no box has been set
2679    » #604 - Color param for Label constructor should be
2680      const [Jonathon Jongsma]
2681    » #606 - enable depth test in GL
2682    » #608 - Control motion events frequency
2683    » #614 - ClutterActor API inconsistencies
2684    » #616 - ClutterTexture doesn't respect width set from clutterscript
2685    » #617 - ClutterEffect Improvements
2686    » #618 - ClutterScript name/id confusion
2687    » #619 - clutter_behavior_rotate angle properties should accept
2688      negative values
2689    » #628 - clutter_actor_rotate_x() is a setter, not a modifier
2690    » #629 - There is no clutter_actor_get_position()
2691    » #634 - clutter_behaviour_path_new() documentation unclear
2692    » #637 - add depth cueing support to the stage
2693    » #645 - Fix crash in clutter_label_new_full() [Gwenole Beauchesne]
2694    » #647 - Cannot hide the stage
2695    » #648 - Hidden fullscreen stage doesn't come back as fullscreen
2696    » #652 - reference needed on actor being source of last motion_event
2697    » #661 - clutter_actor_set_width() documentation is vague
2698    » #662 - clutter_actor_set_opacity() documentation doesn't describe values
2699    » #665 - ClutterBehaviourEllipse tilts are broken
2700    » #670 - Fix clutter_container_lower_child() [Gwenole Beauchesne]
2701    » #673 - ClutterActor "captured-events" signal documentation wrong
2702    » #674 - ClutterActor::get_depth() and set_depth() vfuncs not
2703      used [Murray Cumming]
2704    » #675 - update subregions of cluttertextures
2705    » #678 - ClutterLabel size allocation still bogus
2706
2707 Clutter 0.4.0 (07/08/2007)
2708 ========================
2709
2710  • List of changes between 0.3.1 and 0.4.0
2711
2712    » Many documentation additions and improvements.
2713
2714    » Display DPI now honours on backends its can be queried.
2715
2716    » Various big endian related fixes.
2717
2718    » ClutterBehaviourEllipse and ClutterBehaviourRotate API and
2719    internals improvements.
2720
2721    » Add basic tslib support to eglnative backend (for touchscreen events)
2722
2723    » clutter_stage_get_actor_at_pos should now work on 16bpp displays.
2724
2725    » New ClutterEffect rotation calls.
2726
2727    » Allowing user resizing of the stage now optional.
2728     (implemented by glx backend only currently)
2729
2730    » ClutterEntry UTF8 fixes and improved automatic initial sizing.
2731
2732    » Make ClutterActor GInitiallyUnowned.
2733
2734    » New ClutterBox API: each box has now a colour and a margin (distance
2735      between the inner-border and the children); plus, each packed child
2736      has a padding. Margins and paddings are expressed in ClutterUnits,
2737      to ease the transition to the device independent units. You can use
2738      clutter_box_set_default_padding() if you want the same padding for
2739      each child.
2740
2741  • List of bug fixed
2742    » #390 - clutter_stage_get_actor_at_pos broken on 16bpp displays.
2743    » #398 - inconsistent type for return value of clutter_event_get_state
2744    » #403 - Critical error when removing texture actor
2745    » #404 - Solaris build error with OpenGL, missing
2746             GL_MAX_RECTANGLE_TEXTURE_SIZE_ARB and GL_TEXTURE_RECTANGLE_ARB
2747    » #409 - depth mismatch between visual (32) and window (24)
2748    » #407 - metadata-available signal #ifdef'ed out
2749    » #413 - Clutter compile error with Sun Studio C compiler
2750    » #426 - typo in sdl_backend
2751    » #414 - ClutterEntry invisible if size not set
2752    » #434 - clutter_color_from_pixel incorrectly interprets alpha value
2753    » #435 - clutter_color_subtract does the opposite of its documentation
2754    » #436 - clutter-behaviour-depth always perform "from deep to shallow"
2755
2756 Clutter 0.3.1 (06/07/2007)
2757 ========================
2758
2759  • List of changes between 0.3 and 0.3.1
2760    » EGL. There are now 2 experimental EGL backends;
2761      - 'eglx', the former EGL on X11 implementation (now renamed)
2762      - 'eglnative', a new EGL 'native' backend which supporting non
2763        X11 EGL implementations (i.e framebuffer).
2764
2765    » ClutterGroup now returns correct size when a child is removed.
2766
2767    » Missing redhand.png added to distro tarball (fixing tests that require
2768      it)
2769
2770    » Fix picking in ClutterBox
2771
2772    » Rectangle border creation fixed.
2773
2774    » Fix overflow in Exponential Alpha funcs.
2775
2776    » Many API documentation fixes and improvements.
2777
2778    » ClutterEffect cleanups.
2779
2780    » ClutterEntry cleanups.
2781
2782    » Check for versioned XFixes library (GLX backend).
2783
2784    » More X error traps in GLX backend.
2785
2786 Clutter 0.3 (29/06/2007)
2787 ========================
2788
2789  • List of changes between 0.2.3 and 0.3
2790    » Clutter now supports both switchable windowing system and GL backends.
2791      Window systems supported include GLX, EGL and SDL.
2792
2793      GL support includes OpenGL 1.2+ and OpenGL ES 1.1. This is
2794      provided by a small basic abstraction layer 'cogl.h'. Cogl is not
2795      yet documented - usage external to Clutter is not yet advised.
2796
2797      Backends may provide specific command line options.
2798
2799      Notes;
2800
2801      GLX
2802      ---
2803      The GLX backend is built by default and is currently the most
2804      developed, supported and featured windowing system backend. Only
2805      OpenGL is supported via GLX.
2806
2807      SDL
2808      ---
2809      Clutter has experimental support for using SDL. Open GL is supported as
2810      is OpenGL ES via Dogles (very experimental).
2811
2812      EGL
2813      ---
2814      Clutter has experimental support for using EGL. Only Open GL ES
2815      is supported by EGL.
2816
2817      EGL support assumes an EGL implementation running atop X Windows.
2818
2819      Open GL ES.
2820      -----------
2821
2822      Clutter now has experimental support for Open GL ES.
2823      Current known issues;
2824
2825      + Unrealising a ClutterTexture will not move pixel data from video
2826        into system memory but simply destroy it.
2827      + BGRA, YUV Texture data not currently supported.
2828
2829      (Use the clutter_feature API to probe for above at runtime)
2830
2831      Open Source ES implementations this has been tested against
2832      include `Vincent' and `dgles'.  Support for commerical
2833      implementations may require modifications to the configure.ac
2834      script.
2835
2836      vincent: http://ogl-es.sourceforge.net/
2837               (Also see: http://svn.o-hand.com/repos/misc/trunk/ogles/ )
2838
2839      dgles: http://developer.hybrid.fi/dgles/index.html
2840
2841    » New ClutterEffect class provides a simplified (and thus less flexible)
2842      API wrapping around behaviours, alphas and timelines.
2843    » New Behaviours - bspline, ellipsis, rotation.
2844    » New built in Alpha functions;
2845       CLUTTER_ALPHA_SINE_INC
2846       CLUTTER_ALPHA_SINE_DEC
2847       CLUTTER_ALPHA_SINE_HALF
2848       CLUTTER_ALPHA_SQUARE
2849       CLUTTER_ALPHA_SMOOTHSTEP_INC
2850       CLUTTER_ALPHA_SMOOTHSTEP_DEC
2851       CLUTTER_ALPHA_EXP_INC
2852       CLUTTER_ALPHA_EXP_DEC
2853    » New Actors and interfaces
2854      + ClutterLayout, for writing extended layout support in actors
2855      + ClutterContainer, for generic container actors
2856      + ClutterBox, ClutterVBox and ClutterHBox layout actors.
2857      + ClutterEntry, text entry actor
2858    » ClutterTexture now handles BGRA, YUV and premultiplied alpha data.
2859    » All internal math now fixed point based.
2860    » Clutter now has it own internal event queue.
2861    » ClutterStage new features;
2862      + Title property for naming in window decorations.
2863      + Perspective setting - The stages perspective can now be modified.
2864    » New Clutter_actor •project API calls allow for querying of tranformed
2865      actor vertices and points.
2866    » New Clutter Feature checks.
2867    » Initial ClutterUnit implementation for device independant positioning.
2868  • List of Bugs fixed
2869    » Various issues with very poor performance and Intel drivers.
2870    » #138 Fix typo in x rotation transform.
2871
2872 Clutter 0.2.3 (2007-04-11)
2873 ==========================
2874
2875  • List of changed between 0.2.2 and 0.2.3
2876    » Fixes to tile based textures and again clutter_texture_get_pixbuf(). [Matthew]
2877    » Implement Gravity for ClutterScaleBehaviour. [Matthew, Rob]
2878
2879 Clutter 0.2.2 (2007-03-22)
2880 ==========================
2881
2882  • List of changed between 0.2.1 and 0.2.2
2883    » Addition of basic XEMBED support for clutter stage. [Matthew]
2884    » Fixes to clutter_texture_get_pixbuf(). [Matthew]
2885    » Export clutter_group_remove_all and add associated fixes. [Matthew]
2886
2887 Clutter 0.2.1 (2007-02-07)
2888 ==========================
2889
2890  • List of changed between 0.2.0 and 0.2.1
2891    » Add even faster double to integer (and back) conversion
2892      functions. [Tomas]
2893    » Fix some errors in the fixed point sine waveform
2894      function. [Tomas]
2895    » Use fixed point math in the Pango renderer. [Tomas]
2896    » Improve the GL version check. [Matthew]
2897    » Add a square waveform function. [Emmanuele]
2898  • List of bugs fixed
2899    » #215 - macro CLUTTER_MARK() not disabled for non-debug builds
2900
2901 Clutter 0.2 (18-01-2007)
2902 ========================
2903
2904  • List of changes between 0.2 and 0.1
2905    » Bindings, GStreamer and GTK+ dependencies moved out of tree:
2906      now Clutter strictly depends on Xlibs, OpenGL and GdkPixbuf only.
2907    » Actors now have an initial floating reference; this means you
2908      don't have to explicitely unref them: every memory an actor
2909      allocates will be freed when the group containing the actor will
2910      be destroyed.
2911    » Add basic run-time detection of GL features.
2912      + Use GL_TEXTURE_RECTANGLE_ARB if available.
2913      + Attempt to set up sync to vblank (set CLUTTER_VBLANK=none to disable)
2914    » Add API for behaviours. A ClutterBehaviour is an object which
2915      drives a set of actors using one or more properties depending
2916      on the value of an "alpha" function.
2917      + Provide simple behaviours: ClutterBehaviourOpacity,
2918        ClutterBehaviourPath and ClutterBehaviourScale.
2919      + Provide simple alpha functions for ramps and sine waveforms.
2920    » Add fixed point API for embedded platforms with no FPU.
2921    » Add support for command line switches to Clutter, like debug
2922      flags and abort on warnings; also allow application to hook up
2923      into the initialisation sequence to add their own command line
2924      switches.
2925    » Add Pango GL renderer for Clutter, and use it to render text
2926      inside the ClutterLabel actor; this decrease texture memory
2927      usage.
2928    » Redo Clutter Label widget, using the new Pango renderer.
2929    » Clutter Textures do not store local pixbuf copy (of texture).
2930    » Redo group and actor scale/sizing API and functionality.
2931    » Add memory management API for ClutterColor, and string parsing.
2932  • List of bug fixed
2933    » #199 - Little group handling fix?
2934    » #198 - Detect NPOT support on more systems
2935    » #197 - Tiled textures are broken
2936    » #196 - Rebuild the examples when the library changes
2937    » #156 - clutter_actor_set_position not using the absolute size
2938    » #155 - Don't test for XInitThreads [Bastien Nocera]
2939    » #154 - Key presses not working in super-oh example [Bastien Nocera]
2940    » #152 - Misc fixes [Bastien Nocera]
2941    » #143 - Faulty ref-counting in clutter_group_remove [Frederic Riss]
2942    » #141 - Copy-pasto in clutter_media_set_volume [Frederic Riss]
2943    » #101 - No package 'x11' found -- wrong configure [Tomasz Torcz]
2944    »  #98 - Enabling trails in super-oh crashes
2945
2946 Clutter 0.1 (22/06/2006)
2947 ========================
2948
2949  • First 'official' release, expect bugs aplenty.
2950  • Contains:
2951    » Hopefully enough functionality to build things.
2952    » Basic gstreamer 0.10 video playback support.
2953    » Fairly stable API, though in no way totally stable.
2954      Expect CHANGES in future versions.
2955    » Some simple examples ( also see OPT ).
2956    » An experimental GTK-Clutter widget.
2957    » Fairly complete Python bindings.
2958    » Non complete but hopefully useful API documentation.
2959  • If you want to help out see the TODO file.