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.

Deprecate ClutterCairoTexture

The ClutterCanvas content implementation should be used instead, to
avoid stringing along the ClutterTexture API and implementation.

This change requires some minor surgery, as the deprecated section
already contains an header for the previously deprecated methods; plus,
we don't want to deprecate clutter_cairo_set_source_color(). This means
creating a new header to be used for Cairo-related API.

path: Avoid integer overflow in get_distance()

The get_distance() API uses machine integers to compute the distance;
this means that on 32bit we can overflow the integer size. This gets
hidden by the fact that get_distance() returns an unsigned integer as
well.

In reality, ClutterPath is an unmitigated mess, and the only way to
actually fix it is to break API.

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

a11y: stop to use text as the default accessible-name for ClutterText

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

media: Define CLUTTER_DISABLE_DEPRECATION_WARNINGS

We know we're building deprecated API.

macros: Define MIN_REQUIRED as the current version

Otherwise we'll not warn on deprecations introduced in the current
development cycle.

actor: Call show() on set parent conditionally

This commit adds a further conditional check for calling
clutter_actor_show() when adding a child to an actor. We cannot
unconditionally change the value of the show-on-set-parent property like
the original solution of commit 81b19a78f5e02ae8ffd9235054d80b172496415b
as that breaks the document invariant that show-on-set-parent will be
changed iff an actor is without a parent.

The new ADD_CHILD_SHOW_ON_SET_PARENT flag is part of the default and
legacy flags, thus retaining the default behaviour when adding a child;
the flag is not passed when reordering the list of children, which means
we ignore the state of the show-on-set-parent property.

The conformance test suite fully passes, including the newly added test
to verify that changing the paint order does not trigger visibility.

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

Revert "actor: Unconditionally set show_on_set_parent"

This reverts commit 81b19a78f5e02ae8ffd9235054d80b172496415b.

The commit breaks the conformance test unit for the invariants we
guarantee for the 1.x API:

ERROR:actor-invariants.c:307:actor_show_on_set_parent: assertion failed: (show_on_set_parent)

docs: Add the 1.12 symbols index to the API reference

Be resilient in case there is no device manager

It's possible to run Clutter with the 'null' input backend, which means
that clutter_device_manager_get_default() may return NULL. In the future
we may add a default dummy device manager, but right now it's safer to
just add a simple NULL check in the places where we ask for the device
manager.

Remove calls to cogl_disable_fog

I can't think of any reason why it would do this and there's no
comment explaining it so let's just remove it. The global fog state
has been removed in Cogl 2.0 so it will cause problems later.

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

clutter-stage-cogl: Use CoglPrimitive for the debug redraw code

CoglVertexBuffer is deprecated so here is a fairly simple replacement
to use the experimental CoglPrimitive API.

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

device-manager: select/unselect device events as device change

When a device is added or changes, select/unselect events from X
accordingly.

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

device-manager: don't select events for disabled devices

I.e. only select events for core devices or devices explicitly enabled
by clients.

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

conform: Make sure that raising/lowering children doesn't change state

Namely, visibility and show-on-set-parent.

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

actor: Unconditionally set show_on_set_parent

Otherwise, doing something like adjusting the child's position
on a hidden actor will re-show it, which is not what we want.

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

actor: Not-actors don't have metas