1 Clutter 0.9.0 (xx/01/2009)
2 ===============================================================================
4 * List of changes between 0.8.6 and 0.9.0
6 o ClutterText is a new actor allowing text display, text editing
7 both in multi-line and single-line modes, and text selection using
8 the pointer devices and the keyboard. ClutterText supercedes both
9 ClutterLabel and ClutterEntry.
10 o ClutterClone is a new actor that allows cloning of other actors,
11 both simple and composite. ClutterClone supercedes ClutterCloneTexture.
12 o ClutterBindingPool is a new API that allows to easily add key bindings
14 o ClutterAnimation is a new API for implicit animations, similar to
15 the tweening API used in toolkits like jQuery, Tween and Flash. This
16 new API supercedes the ClutterEffect API.
17 o ClutterAlpha uses "animation modes" instead of raw function
18 pointers; it is still possible to pass alpha functions. The alpha
19 functions provided by Clutter have been removed from the public
20 API. It is possible to register global alpha functions and use
21 them though a logical id.
22 o The interval of the ClutterAlpha:alpha property has been changed
23 to a floating point value in the [ -1.0, 2.0 ] range; this allowed
24 the addition of "overshooting" easing modes.
25 o COGL now supports backface culling.
26 o The COGL-based Pango renderer is public API and it is accessible
27 to developers. It is also possible to access the PangoContext used
28 by Clutter in order to create PangoLayouts to render text.
29 o The ClutterFixed API has been moved to COGL.
30 o COGL does not depend on Clutter data types anymore.
31 o The ClutterMedia interface has been overhauled: implementations
32 now must only override the interface properties. The ranges of
33 some properties have been changed to normalized values.
34 o COGL now exposes only floating point entry points, and reserves
35 the eventual conversion to fixed point only when needed. The
36 fixed point type and macros are publicly available for developers
37 concerned about floating point operations.
38 o COGL has a new Vertex Attribues API that allows submitting an
39 extensible number of vertex attributes to OpenGL in a way that
40 does not require format conversions and allows fast re-use.
41 o COGL has a new Material API that decouples paths from fills; it
42 is possible to create an arbitrary path and fill it with a COGL
43 texture. The Material API also allows setting multiple texture
44 layers and defining the blend modes and colors.
45 o ClutterTexture has the ability to use a worker thread to asynchronously
46 load an image from a file, as long as the GLib threading support has
47 been enabled prior to calling clutter_init().
48 o Clutter now supports localization of the help output, and it
49 also supports globally setting the text direction for non left to
51 o ClutterCairoTexture is a new actor that allows using Cairo
52 to draw on a ClutterTexture; since Cairo does not have an OpenGL
53 backend, the drawing is not hardware accelerated.
54 o Clutter has a unit testing suite, based on the GLib unit test
55 framework, which can be used to track regressions.
56 o A ClutterPath object has been added, and it is used by the
57 BehaviourPath. The Path object allows defining paths using a set
58 of coordinates and operations. A Path can be "painted" either using
59 COGL primitives or using Cairo primitives, allowing an easier way
60 to paint non-rectangular shaped actors.
61 o ClutterInterval is a simple object, used by ClutterAnimation, that
62 describes an interval between two values, and interpolates between
63 the initial and final values of the interval.
65 * List of bugs fixed since 0.8.6
67 o #835 - Optimize clutter_actor_real_pick()
68 o #851 - setting anchor point causes picking problem
69 o #883 - Outstanding COGL merge issues
70 o #1003 - Add clutter_actor_take_key_focus
71 o #1014 - Clutter Animation API Improvements.
72 o #1049 - Clutter doesn't support most GLSL uniforms
73 o #1051 - WebKit/Clutter product/component?
74 o #1058 - Build clutter-box2d with Clutter 0.8
75 o #1066 - Clipping regression in 0.8
76 o #1086 - virtualize stage_queue_redraw
77 o #1105 - low level access to PangoClutter
78 o #1106 - ClutterText instead of ClutterLabel and ClutterEntry
79 o #1108 - Enter/Leave events logics wrt. skipped motion events
80 o #1109 - clutter-0.8.0 fails to compile
81 o #1123 - Crash when FBO actor is used and the stage is MINIMIZED
82 o #1144 - Provide an option to load images asynchronously in ClutterTexture
83 o #1162 - Add unit testing for Clutter
85 o #1172 - Disjoint paths and clip to path
86 o #1189 - Backface culling
87 o #1209 - Move fixed point API in COGL
88 o #1210 - Add CoglColor API
89 o #1211 - Drop ClutterFeatureFlags usage from COGL
90 o #1212 - Allow only a single include file for Clutter
91 o #1215 - Move the Pango renderer to the public API
92 o #1219 - Clean up cogl.h
93 o #1231 - Build fails in gles flavour in revision 3442
94 o #1233 - CLUTTER_ALPHA_SINE_INC is broken in trunk
95 o #1251 - Merge the Cairo texture actor in core
96 o #1252 - Merge ClutterBehaviourPath and ClutterBehaviourBspline
97 o #1261 - [patch] Minimize differences between gl/cogl-texture.c and
99 o #1269 - mingw32 building failed at clutter-media.c
100 o #1270 - Update to mingw-cross-compile.sh
101 o #1271 - mingw compiling failed: undefined reference to
102 `_glDrawRangeElements@24'
103 o #1284 - Return something reasonable from clutter_x11_handle_event()
104 o #1300 - clutter_score_remove and clutter_score_remove_all are different
106 o #1310 - font rendering problem
107 o #1313 - Fix computation of camera distance
108 o #1314 - clutter_sinx() is more inaccurate than it needs to be
109 o #1321 - Get Matrix in float
110 o #1323 - ClutterBehaviorDepth conflicts with other behaviors
111 o #1325 - ClutterPath to cairo_path_t conversion functions
112 o #1330 - We should not queue redraw for non-visible actors
113 o #1334 - Default value for ClutterLabel::text should be "" instead of NULL
114 o #1344 - clutter_actor_transform_stage_point gives invalid coordinates
116 o #1352 - Weird cogl-pango.h includes in clutter-[entry|label].c
117 o #1354 - Floating point exception when set fps>1000 and start timeline
118 o #1361 - Unused ClutterStage::get_resolution() methods
119 o #1365 - ClutterEntry doesn't get the cursor when it should
120 o #1366 - disable-npots fails to build on mac
121 o #1380 - Return booleans from CLUTTER_ACTOR_IS_* macros
122 o #1386 - Wrong clipping dimensions for larger actors
123 o #1387 - Clarify new-frame signal emission with advance()
124 o #1388 - Clarify signal emission for advance_to_marker()
125 o #1395 - behaviour_apply and behaviour_get_nth_actor are opposite on
127 o #1397 - clutter command line is not localized.
128 o #1402 - Change default tile-waste from 64 to 63
129 o #1403 - ClutterMedia::get_uri() should return allocated string
130 o #1404 - ClutterMedia issues
131 o #1405 - Fix properties that have X11 types to be 'long'
132 o #1409 - Use G_SIGNAL_RUN_LAST with ::queue-redraw signal
133 o #1410 - [patch] Implements a generic ClutterActorClone class without fbos
134 o #1414 - avoid relayout of ClutterTexture if not syncing size
135 o #1415 - short-circuit setting same clip again
137 Clutter 0.8.2 (25/09/2008)
138 ===============================================================================
140 * List of changes between 0.8.0 and 0.8.2
142 o Add constructor-only properties for the :container and :actor
143 properties of ClutterChildMeta
144 o Resync the Clutter keysyms with X.org ones.
145 o Documentation fixes and improvements
146 o Allow defining ClutterColor as an object or an array inside
147 ClutterScript UI definitions
148 o Added the missing :perspective property to ClutterStage
149 o Fixed the upper and lower boundaries for ClutterUnit and
150 ClutterFixed properties
151 o Fix a bug that prevented disabling sorting on ClutterModel
152 o Fix a bug in clutter_timeline_list_markers()
153 o Queue a redraw when the clip is changed
154 o Optimize calls to push and pop the matrix when painting
155 o Add a variable to the pkgconfig file for extracting the
156 COGL backend, for configure-time checks
157 o Fix a typo in cogl_path_rel_curve_to()
158 o Fix showing the cursor after it being hidden once
159 o Add a function for obtaining Clutter's option group without
162 * List of bugs fixed since 0.8.0
164 o #856 - Teardown sequence is borked
165 o #945 - Clipping+fbo cloning bugs
166 o #1010 - ClutterLabel does not update the layout (again)
167 o #1020 - TFP resyncing on MapNotify/ConfigureNotify [Andy Wingo]
168 o #1033 - Manually parsing command line options prevents
170 o #1034 - Picking doesn't work on Eee PC
171 o #1038 - Clutter 0.8 won't build due to redefined functions
172 o #1044 - cogl_get_viewport error
173 o #1047 - API documentation from release tarball is not
174 installed by "make install" [Mirco Müller]
175 o #1048 - SIGFPE in cogl_texture_set_region() with
176 nvidia [Gwenole Beauchesne]
177 o #1062 - clutter_actor_query_coords() replacement in
178 0.8 [Gwenole Beauchesne]
179 o #1069 - Warnings with ClutterScore
180 o #1071 - clutter_timeline_get_duration doesn't always work
181 o #1075 - Difficult to bind clutter_stage_new
182 o #1080 - clutter_stage_read_pixels has upside-down y coordinate
183 o #1082 - Texture bitmap is destroyed in wrong way
184 o #1085 - Cursor is in wrong position on ClutterEntry if set
186 o #1090 - Label somtimes returns natural_width < min_width [Johan Bilien]
187 o #1091 - WM_MOUSEWHEEL (scroll-event) not handled
188 correctly [Roman Yazmin]
189 o #1099 - No ClutterScript API to get a list of IDs in a given
191 o #1100 - WM_SIZE not handled correctly, user_resize and
192 window_style correction
193 o #1103 - Two typos in clutter documentation
194 o #1121 - Setting anchor point doesn't work if set too early
195 o #1124 - Clutter causes an additional size request in each
196 allocation [Johan Bilien]
197 o #1125 - Save an extra pango_layout_get_size in many
199 o #1130 - CLUTTER_MOTION is not emitted when time goes
200 backwards. [Pierce Liu]
201 o #1137 - Setting the anchor point does not trigger a re-paint
202 o #1145 - Flicker on resize the window
203 o #1154 - clutter_timeout_pool_new() documentation doesn't say
204 how to free [Murray Cumming]
206 Clutter 0.8.0 (10/07/2008)
207 ===============================================================================
209 * List of changes between 0.7.6 and 0.8.0
211 o Assume that non-power-of-two sized textures are always supported
212 if texture-from-pixmap support is present.
214 o Increase documentation coverage.
216 o Disable the XINPUT support by default.
218 o Improve the behaviour of clutter_actor_get_transformed_size().
220 o Fix a copy-and-paste bug which broke the vertex shaders.
222 * List of bugs fixed since 0.7.6
224 o #983 - cogl-bitmap-fallback.c compiler error/warning due to cast issue
225 o #985 - MSC math.h / M_PI issue
226 o #998 - clutter always captures X input events
227 o #1000 - clutter-x11 should define gtypes for its enumerations
228 o #1004 - Fix "edge-detect" shader
229 o #1007 - Fix TFP fallback mechanism
230 o #1008 - tfp still a bit borked
231 o #1010 - ClutterLabel does not update the layout
232 o #1011 - Fix TFP fallback mechanism (take 2)
233 o #1012 - clutter_stage_read_pixels() has incorrect alpha data
234 on some (most?) cards"
235 o #1013 - Per device grabs are not obeyed in pointer device propagation.
236 o #1015 - Cloning unparented actors with FBOs doesn't work with new
238 o #1016 - Changing window-redirect-automatic property after creating
239 ClutterX11TexturePixmap doesn't work
240 o #1019 - clutter-frame-source.h not included by clutter.h
241 o #1022 - extern inline functions in clutter-fixed.h
242 o #1033 - Manually parsing command line options prevents initializing
245 Clutter 0.7.6 (27/06/2008)
246 ===============================================================================
248 * List of changes between 0.7.4 and 0.7.6
250 o Removed the ClutterBackend::get_display_size() and wrappers.
252 o Verify that the vertex shaders are successfully compiled when binding
255 o Increase safety of the ClutterGLXTexturePixmap
257 * List of bugs fixed since 0.7.4
259 o #993 - Underline colors are sometimes wrong
261 Clutter 0.7.4 (25/06/2008), "Killer Koi"
262 ===============================================================================
264 * List of changes between 0.7.2 and 0.7.4
266 o Fix the ClutterEntry actor after the clip API changes in COGL.
268 o Update the shaders generated for GLES 2.0.
270 o Add the ability to add search paths and look up files from
271 ClutterScript. This allows defining directories to store the
272 images to be loaded by a ClutterTexture.
274 o Fix the GLES 1.1 support.
276 o Warn if no usable pointer device are available on X11 backends.
278 o Improve the request for the best pixel format on win32.
280 o Fix a regression when sizing the ClutterStage on backends that
281 only support fixed size stages; now setting any size will result
282 in Clutter ignoring the request, like it happened in Clutter 0.6.
284 o Add a method to ClutterBackend to retrieve the display size.
286 o Fix clutter_sinx() for angles > CFX_2PI - CFX_ONE.
290 o #833 - ClutterEntry should clip glyphs rather than itself
291 o #858 - Support for multiple devices (using XINPUT)
292 o #879 - sampler2DRect used by test-shader.c doen't work with non-rect textures
293 o #979 - Wrong call convension for SwapIntervalProc in win32 backend
294 o #987 - clutter-event.c c99 variable declaration
295 o #988 - cursor position wrong with multibyte invisible char
296 o #989 - Add a search path for clutter script assets
298 Clutter 0.7.2 (23/06/2008), "Kedoke"
299 ===============================================================================
301 * List of changes between 0.7.0 and 0.7.2
303 o ClutterTexture has a new :keep-aspect-ratio property; when it is set
304 to TRUE the texture will return a preferred width maintaining the
305 aspect ratio with the given height and a preferred height maintaining
306 the aspect ratio with the given width. This allows to set the width or
307 the height and have the texture automatically request the height or the
308 width respectively while maintaining the aspect ratio of the original
311 o Added XINPUT support on the X11 backends; this provides an initial
312 support for multiple input devices. The API is X11-specific, and
313 provides support for querying at run-time support for XINPUT, for
314 getting a list of input devices and for getting the type of each
317 o The 'fruity' backend also features multiple device support.
321 o #816 - clutter_actor_request_coords() should take a const box.
322 o #836 - Optimize clutter_label_query_coords()
323 o #905 - Paint cursor directly
324 o #918 - Group doesn't clip if it's children are clipped
325 o #953 - Actors are not hidden before unrealized or disposed
326 o #960 - PangoContext creation code should not be duplicated
327 o #970 - clutter_actor_get_paint_area confusion
328 o #971 - Minor ClutterActor cleanups
329 o #972 - Better parenting
330 o #973 - unreffing ClutterScore may segfault
331 o #981 - clutter_stage_read_pixels temprow fix
332 o #982 - __COGL_GET_CONTEXT MS compiler issue
333 o #984 - pango_clutter_render_layout() declared void
335 Clutter 0.7.0 (13/06/2008), "Booska"
336 ===============================================================================
338 * List of changes between 0.6 and 0.7.0
340 o COGL, the underlying GL abstraction layer in Clutter, has been
341 completely rewritten from the ground up. Its no longer a conceptual
342 hack but a documented, fully featured library pretty much in its
343 own right. COGL abstracts over Open GL, Open GL ES 1.1 and now
344 OpenGL ES 2.0, providing a smart uniform API over these libraries
345 with various utility features such as texture tiling abstractions,
346 paths and primitive rendering, FBO, shaders, etc.
348 o Clutter now provides an experimental backend for the Apple(tm)
349 iPhone and iPod Touch families of products.
351 o The Windows platform is now natively supported instead of
352 relying on the SDL libraries. The win32 backend is still
355 o The X11 based backends now feature support for Actors that wrap
356 external X drawables (i.e the texture-from-pixmap extension and
359 o Clutter now seamlessly supports multiple stages on the backends
360 that allow this feature.
362 o The custom Pango renderer has been completely rewritten, now using
363 the more modern and maintained PangoCairo (instead of FT2), and avoids
364 nasty subclassing hacks, supports smooth fast scaling of text, has
365 many edge case issues fixed and it still is very efficient (using
366 a texture glyph cache). It is even a little bit faster.
368 o Better texture support, timeline improvements, ClutterLabel and
369 ClutterEntry improvements, and container child properties are among
370 the new features - too many to fit in the NEWS file.
374 o #358 - "window resizing doesn't show scaled stage"
375 o #425 - "COGL enhancements"
376 o #439 - "timing related pong lockup due to timeline_rewind somtimes
377 being ignored by timeline_timeout_func"
378 o #450 - "ClutterScore API enhancements"
379 o #641 - "add markers to timelines"
380 o #666 - "Large font size leads to missing ""W"" and wrong ""J"" character"
381 o #713 - "texture from pixmap"
382 o #791 - "default actors to visible"
383 o #800 - "CLUTTER_ALPHA_EXP_INC overflows"
384 o #804 - "clutter_actor_get_opacity returns composited alpha"
385 o #810 - "100 % CPU load with clutter_main()"
386 o #815 - "Split up request
387 o #816 - "clutter_actor_request_coords() should take a const box."
388 o #822 - "Fix clutter_actor_lower()"
389 o #823 - "Clean-up GLism's in clutter-core (below cogl)"
390 o #824 - "ClutterEntry should handle its own key events"
391 o #825 - "Removes GLisms from clutter-main.c"
392 o #831 - "configure.ac missing osx flavour help"
393 o #834 - "add ability to set anchor in json"
394 o #836 - "Optimize clutter_label_query_coords()"
395 o #839 - "Crash if put cursor over topmost pixel"
396 o #840 - "Implement prepare-paint and finish-paint signals."
397 o #848 - "Events dispatch doesn't work in GLX Xephyr"
398 o #850 - "Impossible to set ClutterRectangle border opacity to a value
399 different from the surface opacity"
400 o #857 - "cogl_color doesn't work in PowerVR PC Viewer"
401 o #860 - "ClutterAlpha leaks"
402 o #864 - "Allow instantiating and subclassing of ClutterStage"
403 o #871 - "Two problems with closing stages"
404 o #873 - "clutter_x11/glx_texture_pixmap issues"
405 o #874 - "Clipping on GL ES"
406 o #875 - "Clutter Label Issues"
407 o #881 - "Timelines require precise system timing"
408 o #882 - "Allow child properties for containers implementing the
409 ClutterContainer interface"
410 o #884 - "Add clutter_alpha_set_closure"
411 o #889 - "Error when building clutter-ivan with eglx"
412 o #891 - "assertion failed when test-behave exits"
413 o #892 - "Incorrect results using rotation-[center|angle] properties"
414 o #894 - "Artifacts with the pango renderer"
415 o #900 - "clutter_actor_lower() and friends do not queue redraw"
416 o #906 - "Implement timing of the events"
417 o #908 - "Support transform from G_TYPE_INT to ClutterUnit"
418 o #909 - "OSX: missing NULL pointer handling"
419 o #910 - "OSX: missing memory pool"
420 o #911 - "OSX: add multistage support"
421 o #912 - "Invalid use of int* as parameter for glGetIntegerv"
422 o #913 - "cogl fails to build on OSX"
423 o #914 - "ClutterEntry is confused about characters vs. bytes"
424 o #915 - "clutter_entry_set_max_length(-1) misbehaves"
425 o #916 - "ClutterKeyEvent:unicode_value is ignored"
426 o #919 - "Replacement pango renderer"
427 o #927 - "Created ports for clutter
428 o #928 - "Reparenting a child that itself is a container doesn't work"
429 o #930 - "add support for quartz imagebackend"
430 o #931 - "suspicious size allocation for pixel data"
431 o #933 - ""X Error of failed request" when attempting to call
432 clutter_actor_request_coords()"
433 o #934 - "Update clutter-tutorial to build with clutter from svn trunk."
434 o #947 - "Destroying a stage is messy"
435 o #948 - "Remove texture rectangle support"
436 o #950 - "AltGr not handled"
437 o #951 - "Fix clutter_entry_init() in trunk"
438 o #952 - "Fix test-textures in trunk"
439 o #953 - "Actors are not hidden before unrealized or disposed"
440 o #955 - "ClutterLabel is missing fallback resolution handling"
441 o #959 - "Multiple minor improvements"
442 o #960 - "PangoContext creation code should not be duplicated"
443 o #961 - "Fails to build on OSX (query/request_coords is gone)"
444 o #964 - """unrealized"" signal of ClutterActor wrongly named"
446 Clutter 0.6.0 (18/02/2008)
447 ==========================
449 * List of changes between 0.5.6 and 0.6.0
451 o New documentation sections inside the API reference, describing
452 the animation framework.
454 o New API in ClutterActor for computing the actor's vertices in
455 the plane of a given ancestor and accessors to query whether an
456 actor is scaled or rotated
460 o #613 - Extend point transformation API
461 o #779 - Rounding error in ClutterBehaviourScale [Havoc Pennington]
462 o #787 - tiled textures are broken
463 o #796 - segmentation fault when setting label text
465 Clutter 0.5.6 (11/02/2008)
466 ==========================
468 * List of changes between 0.5.4 and 0.5.6
470 o Reverted a last minute change in the depth sorting function of
473 o Added the clutter_actor_move_anchor_point() family of functions,
474 which will set the anchor point at the given coordinates while
475 adjusting the actor postion so that the relative position of the
476 actor toward its parent remains the same.
478 o Provide a fallback for finding the Clutter alpha functions inside
479 a UI definition for ClutterScript in case g_module_open() fails.
481 o Add initial Frame Buffer Objects support in ClutterTexture; using
482 FBOs, where supported by the hardware and drivers, it's possible to
483 create a ClutterTexture from any actor.
487 o #386 - Stage is white unless a timeline is present
488 o #439 - timing related pong lockup due to timeline rewind...
489 o #440 - 1 pixel line flickering
490 o #442 - Shader support
491 o #451 - Improve font rendering quality (Pango)
492 o #452 - Textures are shown with distortion on Solaris/SPARC
494 o #533 - Clutter stage is not shown under some conditions
495 o #540 - ClutterStage isn't always respecting requests to change size
496 o #549 - Backend offscreen API is broken
497 o #613 - Extend point transformation API
498 o #635 - Fix buffer overflow in clutter_texture_get_pixbuf() [Gwenole
500 o #643 - Superfluous "filter-quality" setting in texture_upload_data()?
502 o #689 - Rotating actor through layers does not handle opacity
503 correctly [Josh Stewart]
504 o #710 - Make "box-blur" test shader work in some way [Gwenole Beauchesne]
505 o #719 - X11 backend does not check window field in events [Havoc
507 o #724 - ClutterLabel reports wrong height when lines > 1
508 o #749 - "reactive" property does not change
509 o #751 - missing XSync in clutter-event-x11.c:xembed_set_info() [Havoc
511 o #756 - clutter_actor_get_abs_size returns bogus values
512 o #769 - OSX backend fails to build
513 o #770 - OSX: passing incompatible pointer type
515 Clutter 0.5.4 (25/01/2008)
516 ==========================
518 * List of changes between 0.5.2 and 0.5.4
520 o A clutter-x11-<major>.<minor> pkg-config file is installed along
521 with the clutter-<major>.<minor> and clutter-<backend>-<major>.<minor>
522 ones, for libraries and applications depending on the X11-based
523 backends (GLX and EGLX).
525 o Textures are correctly unrealized before changing and freeing the
528 o It is now possible to block the automatic call to clutter_main_quit()
529 when closing the stage window using the frame controls by connecting
530 an handler for the ::event signal on the Clutter stage and checking
531 for the CLUTTER_DELETE event type and returning TRUE. This allows
532 the usage of other main loops with GLib reactors (like Python's twisted)
533 with Clutter without triggering assertions by closing the stage window.
537 o #564 - Add more precise clutter_qdivx() [Gwenole Beauchesne]
538 o #614 - ClutterActor API inconsistencies
539 o #640 - ClutterTexture unrealized with no GL context
540 o #654 - Under heavy load clutter sometimes drops the last frame of
541 a timeline [Johan Bilien]
542 o #672 - Event handling in osx backend is broken [Tommi Komulainen]
543 o #684 - Improve test-scale by also using anchor point [Jaap A. Haitsma]
544 o #695 - clutter-shader: Invalid format string for
545 gssize [Tommi Komulainen]
546 o #696 - cogl_get_proc_address requires GLX [Tommi Komulainen]
547 o #709 - clutter_effect_scale inconsistent with clutter_actor_set_scale
548 o #714 - clutter_event_copy for enter/leave event generates
549 extra unref [Neil Roberts]
550 o #715 - Type errors in test-shader
551 o #720 - BehaviourScale not working in python after recent
552 API change [Josh Stewart]
554 Clutter 0.5.2 (14/01/2008)
555 ==========================
557 * List of changes between 0.5.0 and 0.5.2
559 o ClutterModelDefault has been renamed to ClutterListModel
561 o ClutterModel now has vector-based variants for append, prepend and
562 insert methods; these methods are useful for bindings
564 o Add units-based variant for clutter_actor_move_by()
568 o #694 - Handle GLhandleARB on OS X [Tommi Komulainen]
569 o #700 - Fix for clutter_effect_rotate() [Neil Roberts]
571 Clutter 0.5.0 (02/01/2008)
572 ==========================
574 * List of changes between 0.4.2 and 0.5.0
576 o New event handling system: every actor with the CLUTTER_ACTOR_REACTIVE
577 flag set will receive events from the underlying backend; the event
578 propagation chain will be walked in two directions (from the actor to
579 the top-level container and back) with the ability to block it in
582 o ClutterShader, an abstraction over the programmable OpenGL pipeline.
584 o ClutterScore, an object for controlling timelines; using a score
585 instance is possible to start multiple timelines at once, or start
586 a timeline after another has emitted the ::complete signal.
588 o ClutterScript, an object for parsing a scene from an external file or
589 a buffer; the scene is described using JSON (JavaScript Object Notation):
590 every object is defined using its class and properties, and container
591 objects can have their children defined as well. It is also possible
592 do describe top-level objects such as timelines and behaviours, and to
593 automatically connect signal handlers to signal names.
595 o ClutterTimelines duration can now be set in milliseconds using the
596 :duration property; the default framerate will be used to compute the
597 actual duration in frames. The default framerate will be set by the
598 backend, and can be overridden by the application.
600 o ClutterTimelines direction can now be set using the :direction
601 property; a timeline can be set to proceed forward or backward,
602 and the direction can also be change while the timeline is still
605 o New, experimental OSX backend.
607 o Build environment for MS VisualStudio 2005.
609 o ClutterModel, a generic list-based model object that can be used to
610 implement actors following the Model-Viewer-Controller design pattern.
611 Clutter provides a default implementation of ClutterModel, called
612 ClutterModelDefault and using the GSequence data structure from GLib
613 to optimize insertion and look up.
615 o Add the ability to grab pointer and keyboard events: if an actor
616 is set to have a grab it'll be the only one receiving events until
617 it releases the grab.
619 o Add the ability for an actor to receive the key focus; an actor
620 with key focus will always receive the key events, even if it did
621 not acquire the keyboard grab.
623 o It is now possible to set the GL "fog" (also known as "depth cueing")
624 effect on the ClutterStage; if the fog is enabled, actors farther
625 away from the view point will fade into the stage background color.
627 o Each actor now has an "anchor point", a point defined in the actor's
628 coordinate space that will be used as the origin when scaling and
629 rotation transformations.
631 o Every pixel-based API has been doubled with a corresponding
632 ClutterUnits-based function (postfixed with a '-u'), for instance:
634 clutter_actor_set_position() - clutter_actor_set_positionu()
635 clutter_actor_set_size() - clutter_actor_set_sizeu()
636 clutter_actor_set_depth() - clutter_actor_set_depthu()
638 This allows sub-pixel precision and device independence.
640 o The ClutterLabel actor now tries very hard to provide a sane
641 default size, if no bounding box has been requested; this fixes
642 the :alignment property and allows the addition of the :justify
645 o The SDL backend can now be compiled under win32 with MingW; this
646 backend is still marked as experimental.
648 o The OSX backend allows the compilation of Clutter under OS X; this
649 backend is experimental.
653 o #423 - All actors should emit events rather than just the stage
654 o #424 - Interface definition files
655 o #443 - ClutterModel implementation
656 o #480 - Uninitialized variable in
657 path_alpha_to_position() [Gwenole Beauchesne]
658 o #511 - clutter_stage_get_actor_at_pos problem
659 o #512 - clutter window moves when stage actor is scaled
660 o #518 - XEMBED not supported in eglx backend
661 o #519 - Should have an Atom cache initialized on start up
662 o #520 - Delete after multibyte unicode chars in
663 ClutterEntry [Tommi Komulainen]
664 o #522 - Array out of bounds indexing [Tommi Komulainen]
665 o #523 - cogl portability fixes [Tommi Komulainen]
666 o #524 - missing config.h includes [Tommi Komulainen]
667 o #525 - Redundant include in cogl/gl [Tommi Komulainen]
668 o #531 - Extraneous "new-frame" signal generated
669 o #532 - clutter_actor_set_scale_with_gravityx()
670 precision [Gwenole Beauchesne]
671 o #544 - clutter_color_to_hlsx is broken [Neil Roberts]
672 o #546 - ClutterStageState doesn't make sense
673 o #550 - Wanted: Set Actor's position based on center or other
674 edges/corners of quadrangle
675 o #557 - ClutterScript should support complex properties for third
677 o #558 - Unmerge UI definitions
678 o #566 - ClutterEntry does not scroll the text to the
679 right [Gwenole Beauchesne]
680 o #577 - Inconsistent naming of behaviour properties
681 o #580 - Fix call to cogl_enable() [Gwenole Beauchesne]
682 o #582 - api naming inconsistence between
683 clutter_behaviour_path_append_knots and
684 clutter_behaviour_bspline_append
685 o #584 - Typo on clutter_effect_rotate_x documentation page
686 o #592 - Fix build on trunk [Gwenole Beauchesne]
687 o #596 - ClutterTexture tileing logic is a little borked
688 o #597 - ClutterGroups not pickable
689 o #600 - fix ClutterLabel layout computing when no box has been set
690 o #604 - Color param for Label constructor should be
691 const [Jonathon Jongsma]
692 o #606 - enable depth test in GL
693 o #608 - Control motion events frequency
694 o #614 - ClutterActor API inconsistencies
695 o #616 - ClutterTexture doesn't respect width set from clutterscript
696 o #617 - ClutterEffect Improvements
697 o #618 - ClutterScript name/id confusion
698 o #619 - clutter_behavior_rotate angle properties should accept
700 o #628 - clutter_actor_rotate_x() is a setter, not a modifier
701 o #629 - There is no clutter_actor_get_position()
702 o #634 - clutter_behaviour_path_new() documentation unclear
703 o #637 - add depth cueing support to the stage
704 o #645 - Fix crash in clutter_label_new_full() [Gwenole Beauchesne]
705 o #647 - Cannot hide the stage
706 o #648 - Hidden fullscreen stage doesn't come back as fullscreen
707 o #652 - reference needed on actor being source of last motion_event
708 o #661 - clutter_actor_set_width() documentation is vague
709 o #662 - clutter_actor_set_opacity() documentation doesn't describe values
710 o #665 - ClutterBehaviourEllipse tilts are broken
711 o #670 - Fix clutter_container_lower_child() [Gwenole Beauchesne]
712 o #673 - ClutterActor "captured-events" signal documentation wrong
713 o #674 - ClutterActor::get_depth() and set_depth() vfuncs not
714 used [Murray Cumming]
715 o #675 - update subregions of cluttertextures
716 o #678 - ClutterLabel size allocation still bogus
718 Clutter 0.4.0 (07/08/2007)
719 ========================
721 * List of changes between 0.3.1 and 0.4.0
723 o Many documentation additions and improvements.
725 o Display DPI now honours on backends its can be queried.
727 o Various big endian related fixes.
729 o ClutterBehaviourEllipse and ClutterBehaviourRotate API and
730 internals improvements.
732 o Add basic tslib support to eglnative backend (for touchscreen events)
734 o clutter_stage_get_actor_at_pos should now work on 16bpp displays.
736 o New ClutterEffect rotation calls.
738 o Allowing user resizing of the stage now optional.
739 (implemented by glx backend only currently)
741 o ClutterEntry UTF8 fixes and improved automatic initial sizing.
743 o Make ClutterActor GInitiallyUnowned.
745 o New ClutterBox API: each box has now a colour and a margin (distance
746 between the inner-border and the children); plus, each packed child
747 has a padding. Margins and paddings are expressed in ClutterUnits,
748 to ease the transition to the device independent units. You can use
749 clutter_box_set_default_padding() if you want the same padding for
753 o #390 - clutter_stage_get_actor_at_pos broken on 16bpp displays.
754 o #398 - inconsistent type for return value of clutter_event_get_state
755 o #403 - Critical error when removing texture actor
756 o #404 - Solaris build error with OpenGL, missing
757 GL_MAX_RECTANGLE_TEXTURE_SIZE_ARB and GL_TEXTURE_RECTANGLE_ARB
758 o #409 - depth mismatch between visual (32) and window (24)
759 o #407 - metadata-available signal #ifdef'ed out
760 o #413 - Clutter compile error with Sun Studio C compiler
761 o #426 - typo in sdl_backend
762 o #414 - ClutterEntry invisible if size not set
763 o #434 - clutter_color_from_pixel incorrectly interprets alpha value
764 o #435 - clutter_color_subtract does the opposite of its documentation
765 o #436 - clutter-behaviour-depth always perform "from deep to shallow"
767 Clutter 0.3.1 (06/07/2007)
768 ========================
770 * List of changes between 0.3 and 0.3.1
771 o EGL. There are now 2 experimental EGL backends;
772 - 'eglx', the former EGL on X11 implementation (now renamed)
773 - 'eglnative', a new EGL 'native' backend which supporting non
774 X11 EGL implementations (i.e framebuffer).
776 o ClutterGroup now returns correct size when a child is removed.
778 o Missing redhand.png added to distro tarball (fixing tests that require
781 o Fix picking in ClutterBox
783 o Rectangle border creation fixed.
785 o Fix overflow in Exponential Alpha funcs.
787 o Many API documentation fixes and improvements.
789 o ClutterEffect cleanups.
791 o ClutterEntry cleanups.
793 o Check for versioned XFixes library (GLX backend).
795 o More X error traps in GLX backend.
797 Clutter 0.3 (29/06/2007)
798 ========================
800 * List of changes between 0.2.3 and 0.3
801 o Clutter now supports both switchable windowing system and GL backends.
802 Window systems supported include GLX, EGL and SDL.
804 GL support includes OpenGL 1.2+ and OpenGL ES 1.1. This is
805 provided by a small basic abstraction layer 'cogl.h'. Cogl is not
806 yet documented - usage external to Clutter is not yet advised.
808 Backends may provide specific command line options.
814 The GLX backend is built by default and is currently the most
815 developed, supported and featured windowing system backend. Only
816 OpenGL is supported via GLX.
820 Clutter has experimental support for using SDL. Open GL is supported as
821 is OpenGL ES via Dogles (very experimental).
825 Clutter has experimental support for using EGL. Only Open GL ES
828 EGL support assumes an EGL implementation running atop X Windows.
833 Clutter now has experimental support for Open GL ES.
834 Current known issues;
836 + Unrealising a ClutterTexture will not move pixel data from video
837 into system memory but simply destroy it.
838 + BGRA, YUV Texture data not currently supported.
840 (Use the clutter_feature API to probe for above at runtime)
842 Open Source ES implementations this has been tested against
843 include `Vincent' and `dgles'. Support for commerical
844 implementations may require modifications to the configure.ac
847 vincent: http://ogl-es.sourceforge.net/
848 (Also see: http://svn.o-hand.com/repos/misc/trunk/ogles/ )
850 dgles: http://developer.hybrid.fi/dgles/index.html
852 o New ClutterEffect class provides a simplified (and thus less flexible)
853 API wrapping around behaviours, alphas and timelines.
854 o New Behaviours - bspline, ellipsis, rotation.
855 o New built in Alpha functions;
856 CLUTTER_ALPHA_SINE_INC
857 CLUTTER_ALPHA_SINE_DEC
858 CLUTTER_ALPHA_SINE_HALF
860 CLUTTER_ALPHA_SMOOTHSTEP_INC
861 CLUTTER_ALPHA_SMOOTHSTEP_DEC
862 CLUTTER_ALPHA_EXP_INC
863 CLUTTER_ALPHA_EXP_DEC
864 o New Actors and interfaces
865 + ClutterLayout, for writing extended layout support in actors
866 + ClutterContainer, for generic container actors
867 + ClutterBox, ClutterVBox and ClutterHBox layout actors.
868 + ClutterEntry, text entry actor
869 o ClutterTexture now handles BGRA, YUV and premultiplied alpha data.
870 o All internal math now fixed point based.
871 o Clutter now has it own internal event queue.
872 o ClutterStage new features;
873 + Title property for naming in window decorations.
874 + Perspective setting - The stages perspective can now be modified.
875 o New Clutter_actor *project API calls allow for querying of tranformed
876 actor vertices and points.
877 o New Clutter Feature checks.
878 o Initial ClutterUnit implementation for device independant positioning.
880 o Various issues with very poor performance and Intel drivers.
881 o #138 Fix typo in x rotation transform.
883 Clutter 0.2.3 (2007-04-11)
884 ==========================
886 * List of changed between 0.2.2 and 0.2.3
887 o Fixes to tile based textures and again clutter_texture_get_pixbuf(). [Matthew]
888 o Implement Gravity for ClutterScaleBehaviour. [Matthew, Rob]
890 Clutter 0.2.2 (2007-03-22)
891 ==========================
893 * List of changed between 0.2.1 and 0.2.2
894 o Addition of basic XEMBED support for clutter stage. [Matthew]
895 o Fixes to clutter_texture_get_pixbuf(). [Matthew]
896 o Export clutter_group_remove_all and add associated fixes. [Matthew]
898 Clutter 0.2.1 (2007-02-07)
899 ==========================
901 * List of changed between 0.2.0 and 0.2.1
902 o Add even faster double to integer (and back) conversion
904 o Fix some errors in the fixed point sine waveform
906 o Use fixed point math in the Pango renderer. [Tomas]
907 o Improve the GL version check. [Matthew]
908 o Add a square waveform function. [Emmanuele]
910 o #215 - macro CLUTTER_MARK() not disabled for non-debug builds
912 Clutter 0.2 (18-01-2007)
913 ========================
915 * List of changes between 0.2 and 0.1
916 o Bindings, GStreamer and GTK+ dependencies moved out of tree:
917 now Clutter strictly depends on Xlibs, OpenGL and GdkPixbuf only.
918 o Actors now have an initial floating reference; this means you
919 don't have to explicitely unref them: every memory an actor
920 allocates will be freed when the group containing the actor will
922 o Add basic run-time detection of GL features.
923 + Use GL_TEXTURE_RECTANGLE_ARB if available.
924 + Attempt to set up sync to vblank (set CLUTTER_VBLANK=none to disable)
925 o Add API for behaviours. A ClutterBehaviour is an object which
926 drives a set of actors using one or more properties depending
927 on the value of an "alpha" function.
928 + Provide simple behaviours: ClutterBehaviourOpacity,
929 ClutterBehaviourPath and ClutterBehaviourScale.
930 + Provide simple alpha functions for ramps and sine waveforms.
931 o Add fixed point API for embedded platforms with no FPU.
932 o Add support for command line switches to Clutter, like debug
933 flags and abort on warnings; also allow application to hook up
934 into the initialisation sequence to add their own command line
936 o Add Pango GL renderer for Clutter, and use it to render text
937 inside the ClutterLabel actor; this decrease texture memory
939 o Redo Clutter Label widget, using the new Pango renderer.
940 o Clutter Textures do not store local pixbuf copy (of texture).
941 o Redo group and actor scale/sizing API and functionality.
942 o Add memory management API for ClutterColor, and string parsing.
944 o #199 - Little group handling fix?
945 o #198 - Detect NPOT support on more systems
946 o #197 - Tiled textures are broken
947 o #196 - Rebuild the examples when the library changes
948 o #156 - clutter_actor_set_position not using the absolute size
949 o #155 - Don't test for XInitThreads [Bastien Nocera]
950 o #154 - Key presses not working in super-oh example [Bastien Nocera]
951 o #152 - Misc fixes [Bastien Nocera]
952 o #143 - Faulty ref-counting in clutter_group_remove [Frederic Riss]
953 o #141 - Copy-pasto in clutter_media_set_volume [Frederic Riss]
954 o #101 - No package 'x11' found -- wrong configure [Tomasz Torcz]
955 o #98 - Enabling trails in super-oh crashes
957 Clutter 0.1 (22/06/2006)
958 ========================
960 * First 'official' release, expect bugs aplenty.
962 o Hopefully enough functionality to build things.
963 o Basic gstreamer 0.10 video playback support.
964 o Fairly stable API, though in no way totally stable.
965 Expect CHANGES in future versions.
966 o Some simple examples ( also see OPT ).
967 o An experimental GTK-Clutter widget.
968 o Fairly complete Python bindings.
969 o Non complete but hopefully useful API documentation.
970 * If you want to help out see the TODO file.