layout-manager: Add a new animation API

It's similar to to the implicit animation API of ClutterActor and
compatible to deprecated API of ClutterBoxLayout and
ClutterTableLayout.

It adds :use-animations, :easing-mode, :easing-duration and
:easing-delay properties to control animations when allocation of a
child has changed. Layout manager implementers should call

use_animations = clutter_layout_manager_get_easing_state (manager,
                                                          &mode,
                                                          &duration,
                                                          &delay);

from the allocate() virtual function to access these values.

https://bugzilla.gnome.org/show_bug.cgi?id=676827

layout-manager: Add a private struct to hold future properties

In order to allow the abstract ClutterLayoutManager class to have own
GObject properties we'll need a private structure.

https://bugzilla.gnome.org/show_bug.cgi?id=676827

build: Move test-unit-names.h out of the dist

Let it be generated at build time, as it should.

https://bugzilla.gnome.org/show_bug.cgi?id=674365

paint-volume: Use the correct coordinate for axis alignment

The z coordinate of the origin should be checked against the same
coordinate of the vertex behind it. Given that most actors are flat
surfaces, this check should always succeed.

https://bugzilla.gnome.org/show_bug.cgi?id=675396

text: Enable implicit color animations

Implement the ClutterAnimatable interface to enable implicit animations
for :color, :cursor-color, :selected-text-color and :selection-color.

https://bugzilla.gnome.org/show_bug.cgi?id=676963

event: Add convenience functions for Shift and Ctrl modifiers

Instead of going through clutter_event_get_state() and checking if the
modifier mask is set, we can provide simple convenience functions to do
it for us.

Visual C++ support: Copy clutter-gdk.h as well

... when the GDK backend is also built

Visual C++ 2010: Fix x64 Release_GDK configs

examples: Update drag and drop action code

Use modern API and show idiomatic behaviour.

Update French translation

flow-layout: Check for all positive values

When creating a FlowLayout container, setting a specific size on it, and
adding a child to it, as per the attached testcase, it crashes. The line
on the backtrace doesn't really make sense, but from looking over it, it
appears that it's probably because priv->line_natural is NULL. The
attached patch makes it so in this case, priv->line_natural is
allocated.

https://bugzilla.gnome.org/show_bug.cgi?id=676068

Signed-off-by: Emmanuele Bassi <ebassi@linux.intel.com>

modules: Use 0.10 branch for GStreamer packages

vs9/clutter.sln: Fix missing build item

Bug 676150 GDK: Fix build on Windows

-Don't include unistd.h and stdint.h unconditionally as not all Windows
 compilers have them around.
-Only include cogl/cogl-xlib.h when it is really supported by Cogl and GDK.
-sys/ioctl.h is not available on Windows (MinGW/MSVC).
-Correct the call to cogl_renderer_set_winsys_id:
 (backend_cogl->cogl_renderer, COGL_WINSYS_ID_WGL) ->
 (renderer, COGL_WINSYS_ID_WGL)

actor: Add a custom scriptable "margin" property

The property uses an array with the following CSS style syntax

 [ top, right, bottom, left ] or
 [ top, left/right, bottom ] or
 [ top/bottom, left/right ] or
 [ top/right/bottom/left ]

https://bugzilla.gnome.org/show_bug.cgi?id=676367

ClutterText: Cannot pass NULL string to clutter_text_set_text()

Passing a NULL buffer to clutter_text_set_text() does not behave the same
way as passing an empty string "" (as specified in the documentation).
This was working as expected previously, but somehow the behaviour changed
at some point and created 2 new issues:
- Passing a NULL pointer will not reset the string
- If the ClutterText is editable, it will segfault in strcmp

Validations have been added to prevent this.

https://bugzilla.gnome.org/show_bug.cgi?id=675890

ClutterDropAction: Avoid accessing priv->stage is not yet resolved.

This fixes drop_action_unregister() to not call g_object_get_data()
on priv->stage if not yet resolved. This can happen if the action's
actor was destroyed before ever being mapped.

scroll-actor: Check for point equality in the internal setter

The public API should just accept any valid value; it's up to the
internal setter to check if we're getting the same value as the one
currently set.

scroll-actor: Fix ->transition not being reset

When the transition was removed from the scroll-actor manually,
to cancel a not-finished animation, the transition struct member
wasn't reset to NULL.

This fixes this problem, and removes the need for the struct member
to be reset manually when animation has completed.

https://bugzilla.gnome.org/show_bug.cgi?id=676334

Move scroll actor test to the examples

Nothing specific to test, and the code is idiomatic enough to be used as
an example.

table-layout: Remove unused animation helpers

They aren't used since ClutterTableLayout switched to the implicit
animations API.

https://bugzilla.gnome.org/show_bug.cgi?id=676158

VS property sheets: Correct "install" process

Fix the location where clutter-win32.h is "installed".

Visual C++ support: Fix clutter.def generation

I forgot about the Visual C++ 2010 files... :|

Visual C++ support: Fix clutter.def generation

Some Windows-specific functions were not exported due to this problem.

Visual C++ support: Avoid redefinition warnings

CLUTTER_WINDOWING_GDK is defined in the (pre-configured) clutter-config.h,
so don't define that in the Projects again.

text: Add missing introspection annotations

Add allow-none annotations where appropriate

keyframe-transition: Create a new interval if necessary

When setting up the transition manually by calling

  clutter_keyframe_transition_set_key_frame (transition, n, keys);
  clutter_keyframe_transition_set_values (transition, n, values);
  clutter_keyframe_transition_set_modes (transition, n, modes);

the frame doesn't have a valid interval when calling set_keys(), so we
need to check its existence and create it if necessary.

https://bugzilla.gnome.org/show_bug.cgi?id=676031

keyframe-transition: Documentation fixes

Update the documentation to use the right symbols

https://bugzilla.gnome.org/show_bug.cgi?id=676032

scroll-actor: Paint children in pick mode

Chaining up to the parent's implementation of pick() is not enough: we
need to paint our children explicitly because of the compatibility mode
checks we use to avoid breaking custom containers.

https://bugzilla.gnome.org/show_bug.cgi?id=676088

scroll-actor: Implement pick()

We need to clip the children during picking as well as we do when
painting, to avoid reactive children outside of the visible area
receiving events.

This also allows us to refactor some common code into proper functions.

Visual C++ support: Add support to build GDK backend

-Add configuration in Clutter projects to add option to build Clutter with
 the GDK3 backend in addition to the Win32 backend
-Add another preconfigured clutter-config.h.win32_GDK which contains
 backend configs for both GDK3 and Win32 windowing and input.

examples/canvas: Resize the canvas on allocation changes

This should show how to make a Canvas resize whenever the actor that
uses it as content changes size. For good measure, it also shows how to
coalesce multiple allocations into one Canvas resize through a timeout
source.

build: Drop version check on auto*

Just use autoreconf, to avoid having to deal with changes in the version
of autotools.

If somebody has more recent autotools but the symbolic links used by
autoreconf are still pointing to an old version then they can also fix
their own installation, or get a better distribution.

modules: Point to the correct branch of Cogl

Clutter requires the cogl-1.10 branch of Cogl.

actor: Include margin in explicit sizes for all cases

When asking for the preferred width and height of an actor, in case
only one of either the minimum or the natural width is set, the margin
offsets should also be applied.

Put bind-constraint back into the interactive tests

The bind-constraint.c example still uses clutter_actor_animate(), and
it'd require some serious reworking to move it to
ClutterPropertyTransition or to implicit animations.

score: Add deprecation annotations to all docs

A single deprecation to the long-desc is not enough.

score: Fix version of the deprecation annotations

ClutterScore was deprecated in Clutter 1.8, not 1.10.

examples: Add an example of layout manager

The MultiLayout shows how to write a layout manager with two policies,
and to use the easing state of a child to interpolate the allocation.

Add rounded corners rectangle example using Canvas

An old request: how to create a rectangle with rounded corners with
Clutter; we use ClutterCanvas and Cairo because we want anti-aliased
edges.

x11/device-manager-xi2: Fix assertions with touch

When getting touch events, the device manager would try
to pass an invalid device to translate_axes().

clutter_event_set_device() will only update event->touch.device
for touch events, not event->motion.device, as used.

Fixes Totem crashing on mouse motion/button press when using
a touchpad.

https://bugzilla.gnome.org/show_bug.cgi?id=675371

event: Fix copying touch events

We were trying to copy motion axes instead of touch ones.

https://bugzilla.gnome.org/show_bug.cgi?id=675371

docs: Update the configure switches in the README

Annotate deprecated get_type() functions

Even if their usage is limited, it's good to consistently deprecate
functions.

cally: Disable deprecation warnings

For ClutterGroup and ClutterRectangle.

docs: Disable deprecations when building the object scanner

We know it's going to be using deprecated symbols, since it has to
introspect all the GObject classes we expose.

docs: Add annotation for ClutterEventSequence

The last remaining undocumented symbol in the API reference according to
gtk-doc.

ClutterDropAction: Added "drop-cancel" signal.

The drop-cancel signal allows the drop action to cleanup its
state if the can-drop signal is refused. This is especially
useful if the drop action (or its target actor) is managing
any drop target animations.

https://bugzilla.gnome.org/show_bug.cgi?id=675336

docs: Move the easing modes graphs to the AnimationMode docs

docs: Move ClutterAnimationMode's documentation

Given that ClutterAnimation is going to be deprecated, we should move
the ClutterAnimationMode enumeration to the ClutterTimeline section.

Move the easing modes test into the examples

It's a pretty simple, self-contained example of how to use different
easing modes, as well as the implicit animations API.

interactive/transitions: Modernize

Drop deprecated API.

interactive/binding-pool: Modernize

Drop deprecated API.

Move FlowLayout test into examples

There's nothing really test-worthy in the ClutterFlowLayout interactive
test; it can be lifted pretty much as is, and placed into the examples.

interactive/flow-layout: Modernize code

Drop deprecated API usage.

build: Fix BUILD_TESTS condition check

build: Allow disabling all tests and examples

This should allow nicer build automation and cross-compilation support.

The former --disable-conformance configure switch has been deprecated by
the --disable-tests one, which is more encompassing as it disables the
whole test suite.

Move examples from tests/interactive to a new top-level

The example code that is meant to be XIncluded into the API reference
should not be part of the interactive test suite: it's code that it is
meant to be used as a reference implementation - whereas the interactive
test suite should be allowed to be lean and test behaviour even in nasty
ways. In short: the test suite should not be the place where we show off
idiomatic code for educational purposes.

Post-release version bump to 1.11.3

Release Clutter 1.11.2

conform/actor-graph: Add missing NULL terminator

[l10n] Updated German translation

Add missing symbols

docs: Replace unknown <envvar> tag with <varname>

docs: Fix typo in the <structname> tag

docs: Annotation fixes

The introspection scanner has become slightly more annoying, in the hope
that people start fixing their annotations. As it turns out, it was the
right move.

Updated Brazilian Portuguese translation

Updated Galician translations

Updated Spanish translation

animatable: Disable deprecation warnings

We are using deprecated API internally.

Updated POTFILES.in

Disable deprecation warnings in deprecated classes

We know we're using deprecated symbols.

docs: Mention that patches must pass the conformance tests

People submitting patches should do a conformance test suite run, until
we have a buildbot and a way of running the conformance tests on a
headless setup.

docs: Add missing symbols to the sections file

docs: Specify scroll_to_point() coordinate space

Deprecate ClutterAlpha

It's time. Now that we have clutter_actor_allocate() respecting the
easing state of an actor, and that the LayoutManager animation virtual
functions have been deprecated, we can put ClutterAlpha on the chopping
block, and be done with it, once and for all.

So long, ClutterAlpha; and thanks for all the fish.

docs: Clean up index

Move CairoTexture to the deprecated section.

docs: Add ScrollActor to the API reference

Add ClutterScrollActor

ClutterScrollActor is an actor that allows showing a portion of its
contents.

interactive/table-layout: Enable animations

layout-manager: Deprecate the layout animation

This semi-aborted API was broken for various reasons:

  - it strongly depended on ClutterAlpha, a class we're trying to
    deprecate;
  - it requires a lot of boilerplate and copy-and-paste code;
  - it requires a full relayout of the actor tree for something
    that ought to be automatically handled by ClutterActor.

Now that clutter_actor_allocate() handles transitions using the easing
state of the actor, we can deprecate the LayoutManager API for the 1.x
series, and remove it for the 2.x series.

table-layout: Deprecate the animation API

Similar to what we did for ClutterBoxLayout.

box-layout: Deprecate the animation API

BoxLayout will use the easing state of the children it's allocating; the
current API is re-implemented in terms of an implicit easing state
forced on each child prior to allocating it.

actor: Make :allocation animatable

Calling clutter_actor_allocate() should transition between the current
allocation and the new allocation, by using the defined implementation
of the easing state.

This means that:

  clutter_actor_save_easing_state (actor);
  clutter_actor_allocate (actor, &new_alloc, flags);
  clutter_actor_restore_easing_state (actor);

will cause "actor" to transition between the current allocation and the
desired new allocation.

The trick is to ensure that this happens without invalidating the
entire actor tree, but only the portion of the tree that has the
transitioned actor as the local root. For this reason, we just call the
allocate() implementation from within the transition frame advancement,
without invalidating flags: the actor, after all, *has* a valid
allocation for the duration of the transition.

actor: Ignore allocation flags

Allocation flags are informative, and are only meant to be used to
communicate additional information about the allocation process to
an actor.

actor: Coalesce needs_[xy]_expand() into one method

Use the orientation enumeration instead of a per-axis method.

box-layout: Add the :orientation property

And deprecate the :vertical property.

An enumeration is clearer, and we can use it elsewhere in the API.

bin-layout: Deprecate BinLayout alignments

We should use the ClutterActor's API for this.

docs: XInclude the bin layout example

interactive/bin-layout: Improve the example code

Use modern API; clean up the code, and document it so that it's possible
to XInclude it into the API reference.

bin-layout: Use the actor align/expand flags

If an actor is set to expand, we use the actor's horizontal and vertical
alignment values instead of the BinLayout's.

actor: Add private get_effective_x_align() method

A method to retrieve the effective horizontal alignment of the actor,
taking into consideration the text direction.

actor: Add basic automatic expand flags

The :x-expand and :y-expand flags on ClutterActor are used to signal
that an actor should expand horizontally and/or vertically - i.e. that
its parent's layout management policy should try to assign extra space
to the actor when allocating it.

The expand flags are automatic: when set on a leaf node in the actor
tree, they will bubble up through the parent and grandparents up to the
top level actor; during allocation, the actors with children will lazily
compute whether their children needs to expand.

actor: Remove automatic transition init from add_transition()

Adding an explicit transition overrides any consideration of the easing
state of an actor.

Fixes for the API reference

Typos, missing symbols, and missing documentation.

docs: Clean up the animation section

Add deprecation annotations

Deprecate ClutterAnimation, as well as clutter_actor_animate()

ClutterPropertyTransition, and the implicit animation API based on
ClutterTransition and ClutterAnimatable, are enough to replace this
whole API.

Deprecate State and Animator

The PropertyTransition, KeyframeTransition, and TransitionGroup classes
can effectively replace Animator and State in their common usage.

keyframe-transition: Add direct accessors for key frames

This should allow modifying key frame details without requiring a full
reset of the KeyframeTransition instance.