2008-06-27 Emmanuele Bassi <ebassi@openedhand.com>
[profile/ivi/clutter.git] / NEWS
1 Clutter 0.7.6 (27/06/2008)
2 ===============================================================================
3
4  * List of changes between 0.7.4 and 0.7.6
5
6    o Removed the ClutterBackend::get_display_size() and wrappers.
7
8    o Verify that the vertex shaders are successfully compiled when binding
9      them.
10
11    o Increase safety of the ClutterGLXTexturePixmap
12
13  * List of bugs fixed since 0.7.4
14
15    o #993 - Underline colors are sometimes wrong
16
17 Clutter 0.7.4 (25/06/2008), "Killer Koi"
18 ===============================================================================
19
20  * List of changes between 0.7.2 and 0.7.4
21
22    o Fix the ClutterEntry actor after the clip API changes in COGL.
23
24    o Update the shaders generated for GLES 2.0.
25
26    o Add the ability to add search paths and look up files from
27      ClutterScript. This allows defining directories to store the
28      images to be loaded by a ClutterTexture.
29
30    o Fix the GLES 1.1 support.
31
32    o Warn if no usable pointer device are available on X11 backends.
33
34    o Improve the request for the best pixel format on win32.
35
36    o Fix a regression when sizing the ClutterStage on backends that
37      only support fixed size stages; now setting any size will result
38      in Clutter ignoring the request, like it happened in Clutter 0.6.
39
40    o Add a method to ClutterBackend to retrieve the display size.
41
42    o Fix clutter_sinx() for angles > CFX_2PI - CFX_ONE.
43
44  * List of bugs fixed
45
46    o #833 - ClutterEntry should clip glyphs rather than itself
47    o #858 - Support for multiple devices (using XINPUT)
48    o #879 - sampler2DRect used by test-shader.c doen't work with non-rect textures
49    o #979 - Wrong call convension for SwapIntervalProc in win32 backend
50    o #987 - clutter-event.c c99 variable declaration
51    o #988 - cursor position wrong with multibyte invisible char
52    o #989 - Add a search path for clutter script assets
53
54 Clutter 0.7.2 (23/06/2008), "Kedoke"
55 ===============================================================================
56
57  * List of changes between 0.7.0 and 0.7.2
58
59    o ClutterTexture has a new :keep-aspect-ratio property; when it is set
60      to TRUE the texture will return a preferred width maintaining the
61      aspect ratio with the given height and a preferred height maintaining
62      the aspect ratio with the given width. This allows to set the width or
63      the height and have the texture automatically request the height or the
64      width respectively while maintaining the aspect ratio of the original
65      image.
66
67    o Added XINPUT support on the X11 backends; this provides an initial
68      support for multiple input devices. The API is X11-specific, and
69      provides support for querying at run-time support for XINPUT, for
70      getting a list of input devices and for getting the type of each
71      input device. 
72  
73    o The 'fruity' backend also features multiple device support.
74
75  * List of bugs fixed
76
77    o #816 - clutter_actor_request_coords() should take a const box.
78    o #836 - Optimize clutter_label_query_coords()
79    o #905 - Paint cursor directly
80    o #918 - Group doesn't clip if it's children are clipped
81    o #953 - Actors are not hidden before unrealized or disposed
82    o #960 - PangoContext creation code should not be duplicated
83    o #970 - clutter_actor_get_paint_area confusion
84    o #971 - Minor ClutterActor cleanups
85    o #972 - Better parenting
86    o #973 - unreffing ClutterScore may segfault
87    o #981 - clutter_stage_read_pixels temprow fix
88    o #982 - __COGL_GET_CONTEXT MS compiler issue
89    o #984 - pango_clutter_render_layout() declared void
90
91 Clutter 0.7.0 (13/06/2008), "Booska"
92 ===============================================================================
93
94  * List of changes between 0.6 and 0.7.0
95
96    o COGL, the underlying GL abstraction layer in Clutter, has been
97      completely rewritten from the ground up. Its no longer a conceptual
98      hack but a documented, fully featured library pretty much in its
99      own right. COGL abstracts over Open GL, Open GL ES 1.1 and now
100      OpenGL ES 2.0, providing a smart uniform API over these libraries
101      with various utility features such as texture tiling abstractions,
102      paths and primitive rendering, FBO, shaders, etc.
103
104    o Clutter now provides an experimental backend for the Apple(tm)
105      iPhone and iPod Touch families of products.
106
107    o The Windows platform is now natively supported instead of
108      relying on the SDL libraries. The win32 backend is still
109      experimental.
110
111    o The X11 based backends now feature support for Actors that wrap
112      external X drawables (i.e the texture-from-pixmap extension and
113      fallbacks)
114
115    o Clutter now seamlessly supports multiple stages on the backends
116      that allow this feature.
117
118    o The custom Pango renderer has been completely rewritten, now using
119      the more modern and maintained PangoCairo (instead of FT2), and avoids
120      nasty subclassing hacks, supports smooth fast scaling of text, has
121      many edge case issues fixed and it still is very efficient (using
122      a texture glyph cache). It is even a little bit faster.
123
124    o Better texture support, timeline improvements, ClutterLabel and
125      ClutterEntry improvements, and container child properties are among
126      the new features - too many to fit in the NEWS file.
127
128  * List of bug fixes
129
130    o #358 - "window resizing doesn't show scaled stage"
131    o #425 - "COGL enhancements"
132    o #439 - "timing related pong lockup due to timeline_rewind somtimes
133             being ignored by timeline_timeout_func"
134    o #450 - "ClutterScore API enhancements"
135    o #641 - "add markers to timelines"
136    o #666 - "Large font size leads to missing ""W"" and wrong ""J"" character"
137    o #713 - "texture from pixmap"
138    o #791 - "default actors to visible"
139    o #800 - "CLUTTER_ALPHA_EXP_INC overflows"
140    o #804 - "clutter_actor_get_opacity returns composited alpha"
141    o #810 - "100 % CPU load with clutter_main()"
142    o #815 - "Split up request
143    o #816 - "clutter_actor_request_coords() should take a const box."
144    o #822 - "Fix clutter_actor_lower()"
145    o #823 - "Clean-up GLism's in clutter-core (below cogl)"
146    o #824 - "ClutterEntry should handle its own key events"
147    o #825 - "Removes GLisms from clutter-main.c"
148    o #831 - "configure.ac missing osx flavour help"
149    o #834 - "add ability to set anchor in json"
150    o #836 - "Optimize clutter_label_query_coords()"
151    o #839 - "Crash if put cursor over topmost pixel"
152    o #840 - "Implement prepare-paint and finish-paint signals."
153    o #848 - "Events dispatch doesn't work in GLX Xephyr"
154    o #850 - "Impossible to set ClutterRectangle border opacity to a value
155             different from the surface opacity"
156    o #857 - "cogl_color doesn't work in PowerVR PC Viewer"
157    o #860 - "ClutterAlpha leaks"
158    o #864 - "Allow instantiating and subclassing of ClutterStage"
159    o #871 - "Two problems with closing stages"
160    o #873 - "clutter_x11/glx_texture_pixmap issues"
161    o #874 - "Clipping on GL ES"
162    o #875 - "Clutter Label Issues"
163    o #881 - "Timelines require precise system timing"
164    o #882 - "Allow child properties for containers implementing the
165             ClutterContainer interface"
166    o #884 - "Add clutter_alpha_set_closure"
167    o #889 - "Error when building clutter-ivan with eglx"
168    o #891 - "assertion failed when test-behave exits"
169    o #892 - "Incorrect results using  rotation-[center|angle] properties"
170    o #894 - "Artifacts with the pango renderer"
171    o #900 - "clutter_actor_lower() and friends do not queue redraw"
172    o #906 - "Implement timing of the events"
173    o #908 - "Support transform from G_TYPE_INT to ClutterUnit"
174    o #909 - "OSX: missing NULL pointer handling"
175    o #910 - "OSX: missing memory pool"
176    o #911 - "OSX: add multistage support"
177    o #912 - "Invalid use of int* as parameter for glGetIntegerv"
178    o #913 - "cogl fails to build on OSX"
179    o #914 - "ClutterEntry is confused about characters vs. bytes"
180    o #915 - "clutter_entry_set_max_length(-1) misbehaves"
181    o #916 - "ClutterKeyEvent:unicode_value is ignored"
182    o #919 - "Replacement pango renderer"
183    o #927 - "Created ports for clutter
184    o #928 - "Reparenting a child that itself is a container doesn't work"
185    o #930 - "add support for quartz imagebackend"
186    o #931 - "suspicious size allocation for pixel data"
187    o #933 - ""X Error of failed request" when attempting to call
188             clutter_actor_request_coords()"
189    o #934 - "Update clutter-tutorial to build with clutter from svn trunk."
190    o #947 - "Destroying a stage is messy"
191    o #948 - "Remove texture rectangle support"
192    o #950 - "AltGr not handled"
193    o #951 - "Fix clutter_entry_init() in trunk"
194    o #952 - "Fix test-textures in trunk"
195    o #953 - "Actors are not hidden before unrealized or disposed"
196    o #955 - "ClutterLabel is missing fallback resolution handling"
197    o #959 - "Multiple minor improvements"
198    o #960 - "PangoContext creation code should not be duplicated"
199    o #961 - "Fails to build on OSX (query/request_coords is gone)"
200    o #964 - """unrealized"" signal of ClutterActor wrongly named"
201
202 Clutter 0.6.0 (18/02/2008)
203 ==========================
204
205  * List of changes between 0.5.6 and 0.6.0
206
207    o New documentation sections inside the API reference, describing
208      the animation framework.
209
210    o New API in ClutterActor for computing the actor's vertices in
211      the plane of a given ancestor and accessors to query whether an
212      actor is scaled or rotated
213
214  * List of bug fixed
215
216    o #613 - Extend point transformation API
217    o #779 - Rounding error in ClutterBehaviourScale [Havoc Pennington]
218    o #787 - tiled textures are broken
219    o #796 - segmentation fault when setting label text
220
221 Clutter 0.5.6 (11/02/2008)
222 ==========================
223
224  * List of changes between 0.5.4 and 0.5.6
225
226    o Reverted a last minute change in the depth sorting function of
227      ClutterGroup.
228
229    o Added the clutter_actor_move_anchor_point() family of functions,
230      which will set the anchor point at the given coordinates while
231      adjusting the actor postion so that the relative position of the
232      actor toward its parent remains the same.
233
234    o Provide a fallback for finding the Clutter alpha functions inside
235      a UI definition for ClutterScript in case g_module_open() fails.
236
237    o Add initial Frame Buffer Objects support in ClutterTexture; using
238      FBOs, where supported by the hardware and drivers, it's possible to
239      create a ClutterTexture from any actor.
240
241  * List of bugs fixed
242
243    o #386 - Stage is white unless a timeline is present
244    o #439 - timing related pong lockup due to timeline rewind...
245    o #440 - 1 pixel line flickering
246    o #442 - Shader support
247    o #451 - Improve font rendering quality (Pango)
248    o #452 - Textures are shown with distortion on Solaris/SPARC
249    o #526 - OSX backend
250    o #533 - Clutter stage is not shown under some conditions
251    o #540 - ClutterStage isn't always respecting requests to change size
252    o #549 - Backend offscreen API is broken
253    o #613 - Extend point transformation API
254    o #635 - Fix buffer overflow in clutter_texture_get_pixbuf() [Gwenole
255      Beauchesne]
256    o #643 - Superfluous "filter-quality" setting in texture_upload_data()?
257      [Gwenole Beauchesne]
258    o #689 - Rotating actor through layers does not handle opacity
259      correctly [Josh Stewart]
260    o #710 - Make "box-blur" test shader work in some way [Gwenole Beauchesne]
261    o #719 - X11 backend does not check window field in events [Havoc
262      Pennington]
263    o #724 - ClutterLabel reports wrong height when lines > 1
264    o #749 - "reactive" property does not change
265    o #751 - missing XSync in clutter-event-x11.c:xembed_set_info() [Havoc
266      Pennington]
267    o #756 - clutter_actor_get_abs_size returns bogus values
268    o #769 - OSX backend fails to build
269    o #770 - OSX: passing incompatible pointer type
270
271 Clutter 0.5.4 (25/01/2008)
272 ==========================
273
274  * List of changes between 0.5.2 and 0.5.4
275
276    o A clutter-x11-<major>.<minor> pkg-config file is installed along
277      with the clutter-<major>.<minor> and clutter-<backend>-<major>.<minor>
278      ones, for libraries and applications depending on the X11-based
279      backends (GLX and EGLX).
280
281    o Textures are correctly unrealized before changing and freeing the
282      main GL context.
283
284    o It is now possible to block the automatic call to clutter_main_quit()
285      when closing the stage window using the frame controls by connecting
286      an handler for the ::event signal on the Clutter stage and checking
287      for the CLUTTER_DELETE event type and returning TRUE. This allows
288      the usage of other main loops with GLib reactors (like Python's twisted)
289      with Clutter without triggering assertions by closing the stage window.
290
291  * List of bugs fixed
292
293    o #564 - Add more precise clutter_qdivx() [Gwenole Beauchesne]
294    o #614 - ClutterActor API inconsistencies
295    o #640 - ClutterTexture unrealized with no GL context
296    o #654 - Under heavy load clutter sometimes drops the last frame of
297      a timeline [Johan Bilien]
298    o #672 - Event handling in osx backend is broken [Tommi Komulainen]
299    o #684 - Improve test-scale by also using anchor point [Jaap A. Haitsma]
300    o #695 - clutter-shader: Invalid format string for
301      gssize [Tommi Komulainen]
302    o #696 - cogl_get_proc_address requires GLX [Tommi Komulainen]
303    o #709 - clutter_effect_scale inconsistent with clutter_actor_set_scale
304    o #714 - clutter_event_copy for enter/leave event generates
305      extra unref [Neil Roberts]
306    o #715 - Type errors in test-shader
307    o #720 - BehaviourScale not working in python after recent
308      API change [Josh Stewart]
309
310 Clutter 0.5.2 (14/01/2008)
311 ==========================
312
313  * List of changes between 0.5.0 and 0.5.2
314
315    o ClutterModelDefault has been renamed to ClutterListModel
316
317    o ClutterModel now has vector-based variants for append, prepend and
318      insert methods; these methods are useful for bindings
319
320    o Add units-based variant for clutter_actor_move_by()
321
322  * List of bugs fixed
323
324    o #694 - Handle GLhandleARB on OS X [Tommi Komulainen]
325    o #700 - Fix for clutter_effect_rotate() [Neil Roberts]
326
327 Clutter 0.5.0 (02/01/2008)
328 ==========================
329
330  * List of changes between 0.4.2 and 0.5.0
331
332    o New event handling system: every actor with the CLUTTER_ACTOR_REACTIVE
333      flag set will receive events from the underlying backend; the event
334      propagation chain will be walked in two directions (from the actor to
335      the top-level container and back) with the ability to block it in
336      both phases.
337
338    o ClutterShader, an abstraction over the programmable OpenGL pipeline.
339
340    o ClutterScore, an object for controlling timelines; using a score
341      instance is possible to start multiple timelines at once, or start
342      a timeline after another has emitted the ::complete signal.
343
344    o ClutterScript, an object for parsing a scene from an external file or
345      a buffer; the scene is described using JSON (JavaScript Object Notation):
346      every object is defined using its class and properties, and container
347      objects can have their children defined as well. It is also possible
348      do describe top-level objects such as timelines and behaviours, and to
349      automatically connect signal handlers to signal names.
350
351    o ClutterTimelines duration can now be set in milliseconds using the
352      :duration property; the default framerate will be used to compute the
353      actual duration in frames. The default framerate will be set by the
354      backend, and can be overridden by the application.
355
356    o ClutterTimelines direction can now be set using the :direction
357      property; a timeline can be set to proceed forward or backward,
358      and the direction can also be change while the timeline is still
359      running.
360
361    o New, experimental OSX backend.
362
363    o Build environment for MS VisualStudio 2005.
364
365    o ClutterModel, a generic list-based model object that can be used to
366      implement actors following the Model-Viewer-Controller design pattern.
367      Clutter provides a default implementation of ClutterModel, called
368      ClutterModelDefault and using the GSequence data structure from GLib
369      to optimize insertion and look up.
370
371    o Add the ability to grab pointer and keyboard events: if an actor
372      is set to have a grab it'll be the only one receiving events until
373      it releases the grab.
374
375    o Add the ability for an actor to receive the key focus; an actor
376      with key focus will always receive the key events, even if it did
377      not acquire the keyboard grab.
378
379    o It is now possible to set the GL "fog" (also known as "depth cueing")
380      effect on the ClutterStage; if the fog is enabled, actors farther
381      away from the view point will fade into the stage background color.
382
383    o Each actor now has an "anchor point", a point defined in the actor's
384      coordinate space that will be used as the origin when scaling and
385      rotation transformations.
386
387    o Every pixel-based API has been doubled with a corresponding
388      ClutterUnits-based function (postfixed with a '-u'), for instance:
389
390        clutter_actor_set_position() - clutter_actor_set_positionu()
391        clutter_actor_set_size()     - clutter_actor_set_sizeu()
392        clutter_actor_set_depth()    - clutter_actor_set_depthu()
393
394      This allows sub-pixel precision and device independence.
395
396    o The ClutterLabel actor now tries very hard to provide a sane
397      default size, if no bounding box has been requested; this fixes
398      the :alignment property and allows the addition of the :justify
399      property.
400
401    o The SDL backend can now be compiled under win32 with MingW; this
402      backend is still marked as experimental.
403
404    o The OSX backend allows the compilation of Clutter under OS X; this
405      backend is experimental.
406
407  * List of bugs fixed
408
409    o #423 - All actors should emit events rather than just the stage
410    o #424 - Interface definition files
411    o #443 - ClutterModel implementation
412    o #480 - Uninitialized variable in
413      path_alpha_to_position() [Gwenole Beauchesne]
414    o #511 - clutter_stage_get_actor_at_pos problem
415    o #512 - clutter window moves when stage actor is scaled
416    o #518 - XEMBED not supported in eglx backend
417    o #519 - Should have an Atom cache initialized on start up
418    o #520 - Delete after multibyte unicode chars in
419      ClutterEntry [Tommi Komulainen]
420    o #522 - Array out of bounds indexing [Tommi Komulainen]
421    o #523 - cogl portability fixes [Tommi Komulainen]
422    o #524 - missing config.h includes [Tommi Komulainen]
423    o #525 - Redundant include in cogl/gl [Tommi Komulainen]
424    o #531 - Extraneous "new-frame" signal generated
425    o #532 - clutter_actor_set_scale_with_gravityx()
426      precision [Gwenole Beauchesne]
427    o #544 - clutter_color_to_hlsx is broken [Neil Roberts]
428    o #546 - ClutterStageState doesn't make sense
429    o #550 - Wanted: Set Actor's position based on center or other
430      edges/corners of quadrangle
431    o #557 - ClutterScript should support complex properties for third
432      party classes
433    o #558 - Unmerge UI definitions
434    o #566 - ClutterEntry does not scroll the text to the
435      right [Gwenole Beauchesne]
436    o #577 - Inconsistent naming of behaviour properties
437    o #580 - Fix call to cogl_enable() [Gwenole Beauchesne]
438    o #582 - api naming inconsistence between
439             clutter_behaviour_path_append_knots and
440             clutter_behaviour_bspline_append
441    o #584 - Typo on clutter_effect_rotate_x documentation page
442    o #592 - Fix build on trunk [Gwenole Beauchesne]
443    o #596 - ClutterTexture tileing logic is a little borked 
444    o #597 - ClutterGroups not pickable
445    o #600 - fix ClutterLabel layout computing when no box has been set
446    o #604 - Color param for Label constructor should be
447      const [Jonathon Jongsma]
448    o #606 - enable depth test in GL
449    o #608 - Control motion events frequency
450    o #614 - ClutterActor API inconsistencies
451    o #616 - ClutterTexture doesn't respect width set from clutterscript
452    o #617 - ClutterEffect Improvements
453    o #618 - ClutterScript name/id confusion
454    o #619 - clutter_behavior_rotate angle properties should accept
455      negative values
456    o #628 - clutter_actor_rotate_x() is a setter, not a modifier
457    o #629 - There is no clutter_actor_get_position()
458    o #634 - clutter_behaviour_path_new() documentation unclear
459    o #637 - add depth cueing support to the stage
460    o #645 - Fix crash in clutter_label_new_full() [Gwenole Beauchesne]
461    o #647 - Cannot hide the stage
462    o #648 - Hidden fullscreen stage doesn't come back as fullscreen
463    o #652 - reference needed on actor being source of last motion_event
464    o #661 - clutter_actor_set_width() documentation is vague
465    o #662 - clutter_actor_set_opacity() documentation doesn't describe values
466    o #665 - ClutterBehaviourEllipse tilts are broken
467    o #670 - Fix clutter_container_lower_child() [Gwenole Beauchesne]
468    o #673 - ClutterActor "captured-events" signal documentation wrong
469    o #674 - ClutterActor::get_depth() and set_depth() vfuncs not
470      used [Murray Cumming]
471    o #675 - update subregions of cluttertextures
472    o #678 - ClutterLabel size allocation still bogus
473
474 Clutter 0.4.0 (07/08/2007)
475 ========================
476
477  * List of changes between 0.3.1 and 0.4.0
478
479    o Many documentation additions and improvements.
480
481    o Display DPI now honours on backends its can be queried.
482
483    o Various big endian related fixes.
484
485    o ClutterBehaviourEllipse and ClutterBehaviourRotate API and
486    internals improvements.
487
488    o Add basic tslib support to eglnative backend (for touchscreen events)
489
490    o clutter_stage_get_actor_at_pos should now work on 16bpp displays.
491
492    o New ClutterEffect rotation calls.
493
494    o Allowing user resizing of the stage now optional.
495     (implemented by glx backend only currently)
496
497    o ClutterEntry UTF8 fixes and improved automatic initial sizing.
498
499    o Make ClutterActor GInitiallyUnowned.
500
501    o New ClutterBox API: each box has now a colour and a margin (distance
502      between the inner-border and the children); plus, each packed child
503      has a padding. Margins and paddings are expressed in ClutterUnits,
504      to ease the transition to the device independent units. You can use
505      clutter_box_set_default_padding() if you want the same padding for
506      each child.
507
508  * List of bug fixed
509    o #390 - clutter_stage_get_actor_at_pos broken on 16bpp displays.
510    o #398 - inconsistent type for return value of clutter_event_get_state
511    o #403 - Critical error when removing texture actor
512    o #404 - Solaris build error with OpenGL, missing
513             GL_MAX_RECTANGLE_TEXTURE_SIZE_ARB and GL_TEXTURE_RECTANGLE_ARB
514    o #409 - depth mismatch between visual (32) and window (24)
515    o #407 - metadata-available signal #ifdef'ed out
516    o #413 - Clutter compile error with Sun Studio C compiler
517    o #426 - typo in sdl_backend
518    o #414 - ClutterEntry invisible if size not set
519    o #434 - clutter_color_from_pixel incorrectly interprets alpha value
520    o #435 - clutter_color_subtract does the opposite of its documentation
521    o #436 - clutter-behaviour-depth always perform "from deep to shallow"
522
523 Clutter 0.3.1 (06/07/2007)
524 ========================
525
526  * List of changes between 0.3 and 0.3.1
527    o EGL. There are now 2 experimental EGL backends;
528      - 'eglx', the former EGL on X11 implementation (now renamed)
529      - 'eglnative', a new EGL 'native' backend which supporting non
530        X11 EGL implementations (i.e framebuffer).
531
532    o ClutterGroup now returns correct size when a child is removed.
533
534    o Missing redhand.png added to distro tarball (fixing tests that require
535      it)
536
537    o Fix picking in ClutterBox
538
539    o Rectangle border creation fixed.
540
541    o Fix overflow in Exponential Alpha funcs.
542
543    o Many API documentation fixes and improvements.
544
545    o ClutterEffect cleanups.
546
547    o ClutterEntry cleanups.
548
549    o Check for versioned XFixes library (GLX backend).
550
551    o More X error traps in GLX backend.
552
553 Clutter 0.3 (29/06/2007)
554 ========================
555
556  * List of changes between 0.2.3 and 0.3
557    o Clutter now supports both switchable windowing system and GL backends.
558      Window systems supported include GLX, EGL and SDL.
559
560      GL support includes OpenGL 1.2+ and OpenGL ES 1.1. This is
561      provided by a small basic abstraction layer 'cogl.h'. Cogl is not
562      yet documented - usage external to Clutter is not yet advised.
563
564      Backends may provide specific command line options.
565
566      Notes;
567
568      GLX
569      ---
570      The GLX backend is built by default and is currently the most
571      developed, supported and featured windowing system backend. Only
572      OpenGL is supported via GLX.
573
574      SDL
575      ---
576      Clutter has experimental support for using SDL. Open GL is supported as
577      is OpenGL ES via Dogles (very experimental).
578
579      EGL
580      ---
581      Clutter has experimental support for using EGL. Only Open GL ES
582      is supported by EGL.
583
584      EGL support assumes an EGL implementation running atop X Windows.
585
586      Open GL ES.
587      -----------
588
589      Clutter now has experimental support for Open GL ES.
590      Current known issues;
591
592      + Unrealising a ClutterTexture will not move pixel data from video
593        into system memory but simply destroy it.
594      + BGRA, YUV Texture data not currently supported.
595
596      (Use the clutter_feature API to probe for above at runtime)
597
598      Open Source ES implementations this has been tested against
599      include `Vincent' and `dgles'.  Support for commerical
600      implementations may require modifications to the configure.ac
601      script.
602
603      vincent: http://ogl-es.sourceforge.net/
604               (Also see: http://svn.o-hand.com/repos/misc/trunk/ogles/ )
605
606      dgles: http://developer.hybrid.fi/dgles/index.html
607
608    o New ClutterEffect class provides a simplified (and thus less flexible)
609      API wrapping around behaviours, alphas and timelines.
610    o New Behaviours - bspline, ellipsis, rotation.
611    o New built in Alpha functions;
612       CLUTTER_ALPHA_SINE_INC
613       CLUTTER_ALPHA_SINE_DEC
614       CLUTTER_ALPHA_SINE_HALF
615       CLUTTER_ALPHA_SQUARE
616       CLUTTER_ALPHA_SMOOTHSTEP_INC
617       CLUTTER_ALPHA_SMOOTHSTEP_DEC
618       CLUTTER_ALPHA_EXP_INC
619       CLUTTER_ALPHA_EXP_DEC
620    o New Actors and interfaces
621      + ClutterLayout, for writing extended layout support in actors
622      + ClutterContainer, for generic container actors
623      + ClutterBox, ClutterVBox and ClutterHBox layout actors.
624      + ClutterEntry, text entry actor
625    o ClutterTexture now handles BGRA, YUV and premultiplied alpha data.
626    o All internal math now fixed point based.
627    o Clutter now has it own internal event queue.
628    o ClutterStage new features;
629      + Title property for naming in window decorations.
630      + Perspective setting - The stages perspective can now be modified.
631    o New Clutter_actor *project API calls allow for querying of tranformed
632      actor vertices and points.
633    o New Clutter Feature checks.
634    o Initial ClutterUnit implementation for device independant positioning.
635  * List of Bugs fixed
636    o Various issues with very poor performance and Intel drivers.
637    o #138 Fix typo in x rotation transform.
638
639 Clutter 0.2.3 (2007-04-11)
640 ==========================
641
642  * List of changed between 0.2.2 and 0.2.3
643    o Fixes to tile based textures and again clutter_texture_get_pixbuf(). [Matthew]
644    o Implement Gravity for ClutterScaleBehaviour. [Matthew, Rob]
645
646 Clutter 0.2.2 (2007-03-22)
647 ==========================
648
649  * List of changed between 0.2.1 and 0.2.2
650    o Addition of basic XEMBED support for clutter stage. [Matthew]
651    o Fixes to clutter_texture_get_pixbuf(). [Matthew]
652    o Export clutter_group_remove_all and add associated fixes. [Matthew]
653
654 Clutter 0.2.1 (2007-02-07)
655 ==========================
656
657  * List of changed between 0.2.0 and 0.2.1
658    o Add even faster double to integer (and back) conversion
659      functions. [Tomas]
660    o Fix some errors in the fixed point sine waveform
661      function. [Tomas]
662    o Use fixed point math in the Pango renderer. [Tomas]
663    o Improve the GL version check. [Matthew]
664    o Add a square waveform function. [Emmanuele]
665  * List of bugs fixed
666    o #215 - macro CLUTTER_MARK() not disabled for non-debug builds
667
668 Clutter 0.2 (18-01-2007)
669 ========================
670
671  * List of changes between 0.2 and 0.1
672    o Bindings, GStreamer and GTK+ dependencies moved out of tree:
673      now Clutter strictly depends on Xlibs, OpenGL and GdkPixbuf only.
674    o Actors now have an initial floating reference; this means you
675      don't have to explicitely unref them: every memory an actor
676      allocates will be freed when the group containing the actor will
677      be destroyed.
678    o Add basic run-time detection of GL features.
679      + Use GL_TEXTURE_RECTANGLE_ARB if available.
680      + Attempt to set up sync to vblank (set CLUTTER_VBLANK=none to disable)
681    o Add API for behaviours. A ClutterBehaviour is an object which
682      drives a set of actors using one or more properties depending
683      on the value of an "alpha" function.
684      + Provide simple behaviours: ClutterBehaviourOpacity,
685        ClutterBehaviourPath and ClutterBehaviourScale.
686      + Provide simple alpha functions for ramps and sine waveforms.
687    o Add fixed point API for embedded platforms with no FPU.
688    o Add support for command line switches to Clutter, like debug
689      flags and abort on warnings; also allow application to hook up
690      into the initialisation sequence to add their own command line
691      switches.
692    o Add Pango GL renderer for Clutter, and use it to render text
693      inside the ClutterLabel actor; this decrease texture memory
694      usage.
695    o Redo Clutter Label widget, using the new Pango renderer.
696    o Clutter Textures do not store local pixbuf copy (of texture).
697    o Redo group and actor scale/sizing API and functionality.
698    o Add memory management API for ClutterColor, and string parsing.
699  * List of bug fixed
700    o #199 - Little group handling fix?
701    o #198 - Detect NPOT support on more systems
702    o #197 - Tiled textures are broken
703    o #196 - Rebuild the examples when the library changes
704    o #156 - clutter_actor_set_position not using the absolute size
705    o #155 - Don't test for XInitThreads [Bastien Nocera]
706    o #154 - Key presses not working in super-oh example [Bastien Nocera]
707    o #152 - Misc fixes [Bastien Nocera]
708    o #143 - Faulty ref-counting in clutter_group_remove [Frederic Riss]
709    o #141 - Copy-pasto in clutter_media_set_volume [Frederic Riss]
710    o #101 - No package 'x11' found -- wrong configure [Tomasz Torcz]
711    o  #98 - Enabling trails in super-oh crashes
712
713 Clutter 0.1 (22/06/2006)
714 ========================
715
716  * First 'official' release, expect bugs aplenty.
717  * Contains:
718    o Hopefully enough functionality to build things.
719    o Basic gstreamer 0.10 video playback support.
720    o Fairly stable API, though in no way totally stable.
721      Expect CHANGES in future versions.
722    o Some simple examples ( also see OPT ).
723    o An experimental GTK-Clutter widget.
724    o Fairly complete Python bindings.
725    o Non complete but hopefully useful API documentation.
726  * If you want to help out see the TODO file.