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