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