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