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.

Add ClutterTransitionGroup

The TransitionGroup class is a logical container for running multiple
transitions.

TransitionGroup is not a Score: it is a Transition that advances each
Transition it contains using the delta between frames, and ensures that
all transitions are in a consistent state; these transitions are not
advanced by the master clock.

timeline: Add an internal function for advancing a timeline

There are cases when we want to advance a timeline from another time
source. We cannot use _clutter_timeline_do_tick() directly, as that
assumes that the timeline is already playing, so we'll need to create a
wrapper that toggles the playing flag around it.

Add ClutterKeyframeTransition

A simple transition class that interpolates a property between key
frames.

interval: Allow passing NULL values to the constructor

Given that we can create a ClutterInterval without an initial and final
values using g_object_new(), it stands to reason that we ought to be
able to create an instance when passing NULL GValue pointers to the
new_with_values() constructor as well.

easing: Add utility functions

We end up copying the same array-of-modes-and-functions code in various
places, so it's better to factor it out.

actor: Make add_transition() work regardless of easing state

We can add transitions to an actor even if the easing state hasn't been
set beforehand.

docs: Use the Transition convenience API

transition: Add interval convenience API

This should cut down the lines and number of objects we have to care
about when dealing with explicit transitions.

docs: Add a reference section for geometric types

Add version annotation for newly added functions

Add a rect-contains-rect function

Similar to the contains-point one.

Use an epsilon for float comparison

We tend to use float comparison for structured data types like Vertex,
Point, and Size; we should take into consideration fluctuations in the
floating point representation as well.

event: Add distance and angle accessors

Let's start using ClutterPoint in the API.

Add a function to compute the distance between points

Move towards an alloc/init pair for base types

Instead of a single new() constructor that both allocates and
initializes, split the allocation and initialization into two separate
functions for types that are typically used on the stack, and rarely
allocated on the heap, like ClutterPoint and friends.

This is also applied retroactively to ClutterActorBox and ClutterVertex,
given that the same considerations on usage apply to them as well; we
can add a return value to clutter_actor_box_init() and
clutter_vertex_init() in an ABI-compatible way, so that
clutter_actor_box_new() and clutter_vertex_new() can be effectively
reimplemented as "init (alloc ())".

color: Add initializers for ClutterColor

Similar to the ones we have for the other boxed types in Clutter.

script: Support ClutterPoint and ClutterSize

Point and Size can be described both as an array of values or as an
object.

actor: Add position and size animatable properties

Using a compound type property for position and size has various
advantages: it reduces the amount of checks; it reduces the amount
of notify signals to connect to; it reduces the amount of transitions
generated.

actor: Use ClutterSize for minimum and natural fixed sizes

actor: Use ClutterPoint for the fixed position

Add base geometric types

Clutter should provide some more basic geometric types - Point, Size,
Rect - so that we can use them in properties and accessors.

Move the progress function registration to clutter-types.h

Near the definition of ClutterProgressFunc.