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