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